feat(epic3): deliver the accepted Epic 3 scope through Story 3.17
CI / Rust Checks (pull_request) Failing after 13m41s
CI / UI Checks (pull_request) Skipped
CI / Frontend E2E (pull_request) Skipped
CI / Community Image Smoke (pull_request) Skipped
CI / Deploy (pull_request) Skipped
Community Release / release (push) Failing after 13m33s

Recovery delivery of the accumulated, TL-accepted Epic 3 work that had never been
committed to Git (stories 3.6-3.17, see the crank board). Story 3.18 is not accepted
yet and is deliberately excluded: its logging surface, its capability registration,
its oracle projections and its tests are not part of this tree.

Accepted scope
- 3.6 typed static Resource Drafts; 3.7 publication and exact binding of static
  Resource Versions; 3.8 MCP discovery/read and revocation of static Resources;
- 3.9 Resource import/export in API and UI plus TLS dependency maintenance;
  3.10 REST-backed Resource templates; 3.11 shared REST read runtime and the MCP
  revision/capability foundation;
- 3.12 parameterised Prompt Drafts with preview; 3.13 Prompt publication and exact
  version binding to Agents; 3.14 MCP prompts; 3.15 Prompt import/export;
- 3.16 composite Prompts with published Resources (dependency content scan plus
  dynamic read through the accepted 3.11 runtime, admin preview and MCP prompts/get);
- 3.17 bounded MCP completion suggestions from typed published schemas and the
  resources/list admission fix for bound template publications.

Accepted evidence being reused (unchanged code paths)
- 3.16 candidate: core 7, admin-api 22, registry 4, mcp-server 4, UI 6; one final
  `just verify` run 1651 passed / 0 failed / 2 ignored.
- 3.17 candidate: full run 1672 passed / 0 failed / 2 ignored, QA targeted reruns and
  a real MCP Inspector 2.12.0 client smoke.

Delivery engineering in this commit
- CI: one event per change (feature branches are gated by their pull request, push
  runs only on main), story events run the changed packages, the full workspace suite
  stays the feature/release gate; no cache/sharding without a measured runner check.
- Release: the packaged archives, checksums and SBOM are now uploaded to the Gitea
  release entry of the tag instead of dying with the runner workspace.

Not included on purpose: Story 3.18 work, build caches, runtime databases, local
credentials and scratch evidence.

Refs: crank kanban t_e39d7263; baseline 1b6db09bd1.
This commit is contained in:
bsodfather committed 2026-10-25 09:08:22 +00:00
1 parent 1b6db09bd1
commit 54ce770682
357 files changed
+117394 -5115

No files matched your search

+92 -1
View File
@@ -62,6 +62,11 @@ pub enum ApiError {
context: Option<Value>,
},
#[error("{message}")]
ServiceUnavailable {
message: String,
context: Option<Value>,
},
#[error("{message}")]
Internal {
message: String,
context: Option<Value>,
@@ -202,6 +207,16 @@ impl ApiError {
}
}
pub(crate) fn service_unavailable_with_context(
message: impl Into<String>,
context: Value,
) -> Self {
Self::ServiceUnavailable {
message: message.into(),
context: Some(context),
}
}
pub(crate) fn validation_with_context(message: impl Into<String>, context: Value) -> Self {
Self::Validation {
message: message.into(),
@@ -261,6 +276,7 @@ impl ApiError {
Self::PayloadTooLarge { .. } => StatusCode::PAYLOAD_TOO_LARGE,
Self::PreconditionRequired { .. } => StatusCode::PRECONDITION_REQUIRED,
Self::RateLimited { .. } => StatusCode::TOO_MANY_REQUESTS,
Self::ServiceUnavailable { .. } => StatusCode::SERVICE_UNAVAILABLE,
Self::Internal { .. } => StatusCode::INTERNAL_SERVER_ERROR,
}
}
@@ -283,6 +299,7 @@ impl ApiError {
Self::PayloadTooLarge { .. } => "payload_too_large",
Self::PreconditionRequired { .. } => "precondition_required",
Self::RateLimited { .. } => "rate_limited",
Self::ServiceUnavailable { .. } => "service_unavailable",
Self::Internal { .. } => "internal_error",
}
}
@@ -306,7 +323,8 @@ impl IntoResponse for ApiError {
| Self::Conflict { .. }
| Self::PayloadTooLarge { .. }
| Self::PreconditionRequired { .. }
| Self::RateLimited { .. } => {
| Self::RateLimited { .. }
| Self::ServiceUnavailable { .. } => {
warn!(
name: "admin.response.rejected",
error_code = self.code(),
@@ -350,6 +368,7 @@ impl ApiError {
| Self::PayloadTooLarge { context, .. }
| Self::PreconditionRequired { context, .. }
| Self::RateLimited { context, .. }
| Self::ServiceUnavailable { context, .. }
| Self::Internal { context, .. } => context.as_ref(),
}
}
@@ -359,6 +378,15 @@ impl ApiError {
}
}
/// Стабильные коды/поля Resource (D-14) живут в `error/resource.rs`: `error.rs`
/// держим в пределах лимита размера файла.
mod prompt;
mod resource;
pub(crate) use prompt::{
dependency_finding, representation_unsupported, template_finding, unavailable, unused,
};
impl From<RegistryError> for ApiError {
fn from(value: RegistryError) -> Self {
match value {
@@ -467,6 +495,21 @@ impl From<RegistryError> for ApiError {
format!("operation {operation_id} is archived"),
json!({ "operation_id": operation_id, "error_code": "operation_archived" }),
),
RegistryError::ResourceArchived { resource_id } => Self::conflict_with_context(
format!("resource {resource_id} is archived"),
json!({
"resource_id": resource_id,
"error_code": "resource_archived",
"recovery": "reload"
}),
),
RegistryError::ResourceRevoked { resource_id } => Self::conflict_with_context(
format!("resource {resource_id} is revoked"),
json!({
"resource_id": resource_id,
"error_code": "resource_revoked"
}),
),
RegistryError::OperationStaleVersion {
operation_id,
expected,
@@ -798,6 +841,54 @@ impl From<RegistryError> for ApiError {
"repreview_required": true
}),
),
RegistryError::PromptNotFound { prompt_id } => Self::not_found_with_context(
format!("prompt {prompt_id} was not found"),
json!({ "prompt_id": prompt_id, "error_code": "prompt_not_found" }),
),
RegistryError::PromptNotDraft { prompt_id } => Self::conflict_with_context(
"only a Draft prompt can be edited",
json!({ "prompt_id": prompt_id, "error_code": "prompt_not_draft", "recovery": "reload" }),
),
RegistryError::PromptStaleRevision { prompt_id } => Self::conflict_with_context(
"prompt changed since it was loaded",
json!({ "prompt_id": prompt_id, "error_code": "prompt_stale_revision", "recovery": "reload" }),
),
RegistryError::PromptArchived { prompt_id } => Self::conflict_with_context(
"archived prompt cannot receive new Agent bindings",
json!({ "prompt_id": prompt_id, "error_code": "prompt_archived", "recovery": "reload" }),
),
RegistryError::PromptPublicationNotFound { prompt_id } => Self::not_found_with_context(
format!("published prompt version for {prompt_id} was not found"),
json!({ "prompt_id": prompt_id, "error_code": "prompt_publication_not_found" }),
),
RegistryError::PromptPublicationConflict { prompt_id } => Self::conflict_with_context(
"prompt version is already published",
json!({ "prompt_id": prompt_id, "error_code": "prompt_publication_conflict", "recovery": "reload" }),
),
RegistryError::PromptVersionOverflow { .. } | RegistryError::PromptCorrupt { .. } => {
Self::internal("registry operation failed")
}
RegistryError::PromptDependencyUnresolved {
position,
resource_id,
version,
..
} => prompt::unresolved(resource_id, version, position),
RegistryError::PromptDependencyRepresentationUnsupported {
position,
resource_id,
version,
..
} => prompt::representation_unsupported(resource_id, version, position),
RegistryError::PromptDependencyUnused {
position,
resource_id,
version,
..
} => prompt::unused(resource_id, version, position),
RegistryError::PromptDependencyUnavailable { position, .. } => {
prompt::unavailable(position)
}
RegistryError::SourceNotFound { .. } => Self::not_found_with_context(
"artifact source was not found",
json!({