📋 Description
The Work Package Context epic delivers a persistent, versioned object that captures all relevant information needed for humans and AI agents to interpret inputs, plan work, produce content, and manage delivery within a work package. It ensures that context is shared, traceable, and kept up-to-date throughout the work package lifecycle, supporting both operational needs and compliance requirements.
✓ Merged to main
🕐 Development time: 2d-00h-54m⏱ Time to deployment: 0d-19h-22m
📋 Development Summary
Summary: This workpackage delivered substantial enhancements across work package lifecycle management, metadata handling, staged input/output workflows, and PDF publishing configuration. The branch also improved platform reliability through stronger validation, optimistic concurrency checks, standardized API error handling, and more robust Azure/DevOps automation. In addition, Knowledge Layer-backed metadata support and workflow run history capabilities expanded the platform’s integration and observability features.
Key Changes:
- Added work package lifecycle capabilities, including deprecation/close functionality, legacy status conversion, and related tests.
- Implemented staged input management endpoints, workflow run history with staged outputs, and orchestration metadata handling during file uploads.
- Expanded metadata capabilities with Knowledge Layer-backed metadata support, metadata value reference resolution, stricter derived entity validation, and enhanced metadata key/discovery services.
- Improved API and service robustness through structured ProblemDetails error handling, ETag mismatch validation for optimistic concurrency, stronger request validation, and test/code consistency updates.
- Enhanced infrastructure and delivery configuration with configurable PDF output container settings, translation/storage parameters, updated pipeline agent pools, improved Azure DevOps CLI authentication, Graph API lookup fixes, and dependency patch upgrades.
Impact: These changes strengthen the platform’s core workflow and metadata architecture, making it more reliable, extensible, and easier to integrate with downstream services. They also reduce operational risk by improving validation, error handling, deployment automation, and configuration flexibility for business-critical publishing and orchestration scenarios.
🔧 API Changes (28 files)
-
M
src/Aleido.Platform.API/Authorization/CapabilityAuthorizationResultHandler.cs
-
M
src/Aleido.Platform.API/Endpoints/ASTSearchEndpoints.cs
-
M
src/Aleido.Platform.API/Endpoints/AuditEndpoints.cs
-
M
src/Aleido.Platform.API/Endpoints/AzureDevOpsEndpoints.cs
-
M
src/Aleido.Platform.API/Endpoints/MetadataReadEndpoints.cs
-
M
src/Aleido.Platform.API/Endpoints/ObjectMetadataEndpoints.cs
-
M
src/Aleido.Platform.API/Endpoints/ObjectReferenceEndpoints.cs
-
M
src/Aleido.Platform.API/Endpoints/PdfPublishingEndpoints.cs
-
M
src/Aleido.Platform.API/Endpoints/StagingEndpoints.cs
-
M
src/Aleido.Platform.API/Endpoints/WorkPackageEndpoints.cs
-
M
src/Aleido.Platform.API/Extensions/AuthenticationConfigurationExtensions.cs
-
M
src/Aleido.Platform.API/Extensions/ServiceRegistrationExtensions.cs
-
M
src/Aleido.Platform.API/Helpers/AuthorizationProblemDetailsFactory.cs
-
A
src/Aleido.Platform.API/HttpFiles/pdf-publishing.http
-
M
src/Aleido.Platform.API/Models/Requests/WorkPackageRequests.cs
-
M
src/Aleido.Platform.API/Models/Responses/MetadataResponses.cs
-
M
src/Aleido.Platform.API/Models/Responses/WorkPackageResponses.cs
-
M
src/Aleido.Platform.API/Services/Hierarchy/HierarchyService.Version.cs
-
M
src/Aleido.Platform.API/Services/Hierarchy/HierarchyService.cs
-
M
src/Aleido.Platform.API/Services/IStagingFileService.cs
-
M
src/Aleido.Platform.API/Services/IWorkPackageService.cs
-
A
src/Aleido.Platform.API/Services/Metadata/MetadataGroundingService.cs
-
A
src/Aleido.Platform.API/Services/Metadata/MetadataValueReferenceResolver.cs
-
M
src/Aleido.Platform.API/Services/Metadata/MetadataValueValidator.cs
-
M
src/Aleido.Platform.API/Services/ObjectService.Operations.cs
-
M
src/Aleido.Platform.API/Services/ObjectService.cs
-
M
src/Aleido.Platform.API/Services/StagingFileService.cs
-
M
src/Aleido.Platform.API/Services/WorkPackageService.cs
📝 Commit Log
329f70c94 Merge branch 'main' of https://dev.azure.com/aleidotech/AleidoTechCore/_git/AleidoTechCore
dc950c549 refactor: Rename deprecate functionality to close and update related logic
c7272ca34 Merge branch 'main' of https://dev.azure.com/aleidotech/AleidoTechCore/_git/AleidoTechCore
6a886adc3 fix: Update Graph API service principal lookup URL to avoid parsing issues with az.cmd
85d3153f0 Merge branch 'main' of https://dev.azure.com/aleidotech/AleidoTechCore/_git/AleidoTechCore
2f66a69ea feat: Add workflow run history endpoint with staged outputs
6d698fe3d Update NuGet package versions to latest patches
cdc81ac0b Improve test cancellation and code consistency
6f2490c7e Defer Recipe-PDF Phase 2 planning; add gap analysis
0a57ee1a4 feat: Implement deprecation functionality for work packages and add corresponding tests
3ee5e80a1 feat: Add support for configurable PDF output container name
648e2ac88 feat: Add translation parameters and storage configurations
15e3a511b Add Knowledge Layer-backed metadata support & tests
9bb019456 Merge branch 'main' of https://dev.azure.com/aleidotech/AleidoTechCore/_git/AleidoTechCore
af9a1ee77 feat: Enhance validation for AddStagedInputRequest and add corresponding unit tests
a138fbab0 Merge branch 'main' of https://dev.azure.com/aleidotech/AleidoTechCore/_git/AleidoTechCore
ba9389647 feat: Update pool name from mdp-pool-platform-dev to Pine Agents across multiple pipeline configurations
75c1c34d7 Merge branch 'main' of https://dev.azure.com/aleidotech/AleidoTechCore/_git/AleidoTechCore
4c7e0f362 feat: Add staged input management endpoints and corresponding service logic
8587c1434 feat: Enhance Azure DevOps CLI authentication with PAT token handling and error checks
293dbcd8f feat: Implement WorkPackageStatusLegacyConverter for legacy status deserialization and update JSON defaults
6c91f519e feat: Introduce orchestration metadata handling in file upload process with StagingUploadContext
15f5322cb feat: Add ETag mismatch validation in UpdateVersionAsync to ensure optimistic concurrency
c6a29560b feat: Implement strict derived entity validation in metadata operations and service updates
3a4fc0601 feat: Enhance metadata validation by introducing strict derived entity checks
b5f6ae1ce feat: Implement Metadata Value Reference Resolver and enhance object metadata handling
ece4b1eab feat: Enhance Metadata Key Service and Delivery Discovery with Knowledge Layer Support
202c06627 Clarify PDF spec: update recipe contract alignment
d1d7ccb31 Archive specs 042 and 043
ed318cff4 Standardize API error handling with structured ProblemDetails
a0c7dbe6e Refactor tenant init script error handling/output
a1b5e1595 Improve DevOps project provisioning robustness
0bc89dfb6 Refactor ACR/AppConfig role assignment in env-chain.yml
e3de818b1 Refine updateAllCustomers handling in pipeline
b57d17c5d Refactor code structure for improved readability and maintainability
e784a1d54 Merge branch 'main' of https://dev.azure.com/aleidotech/AleidoTechCore/_git/AleidoTechCore
37b2dc5c7 Clarify "Wave" vs "Phase" in PDF publishing docs
5a81a4894 Complete Spec 038 Phase 1 PDF publishing
715959f6c Implement code changes to enhance functionality and improve performance