feat(studio): deliver asset authoring and automation workflows
Add shared human/task asset batches with reviewed atomic publication, explicit reference rebinds, ownership inspection and qualified glyph/scene budgets. Expose the same authoring and capacity results through Assets and MCP. Deliver isolated guest test targets, retained visual evidence and immutable runtime lifecycle/control observations. Preserve provider qualification and installed authoring examples alongside the completed discussion lessons. Close AGD-106 coordination and the delivered discussion workflows through housekeeping, updating lesson references and preserving qualification limits. Sound remains outside the asset delivery wave. Validation: 579 module tests and 31 additional desktop, process and installed checks passed; native glyph/scene 16/17 boundaries qualified. Discussion validation passed after housekeeping.
This commit is contained in:
@@ -167,3 +167,26 @@ This specification is complete enough when:
|
||||
Expose the effective selected glyph layout through Packer API: asset UUID and stable artifact ID to glyph ID/fingerprint mapping from the same composition used for pack. Exclude `animations.studio.json` from glyph candidates and binary payload. The sidecar references existing identities and does not create an asset type, header or animation binary format. Reorder/removal/content drift requires explicit revision-checked rebind by authoring services; never retarget by path/order.
|
||||
|
||||
See the [complete animation contract](../studio/12.%20Animation%20Authoring%20Specification.md).
|
||||
|
||||
## Revision-checked authoring batches
|
||||
|
||||
The packer project write lane MUST support previewed atomic batches spanning
|
||||
declared asset bytes, manifests, registry and related Studio metadata. Preview
|
||||
leaves published state unchanged. Revalidate the complete input revision and
|
||||
relevant source hashes immediately before commit. Shared reads/builds/writes
|
||||
MUST observe the old complete batch or the new complete batch, with durable
|
||||
journal recovery before admission after interruption.
|
||||
|
||||
Registration continues to allocate identity through this registry. An
|
||||
uncommitted staged allocation is not an issued published identity. Identical
|
||||
reimport MUST preserve UUID/AssetId, stable artifact IDs, selected order, output
|
||||
hashes and references; append MUST NOT renumber existing glyphs/artifacts.
|
||||
Incompatible replacement, removal or size/order/layout change requires complete
|
||||
affected-reference analysis and explicit rebind in the same batch.
|
||||
|
||||
Cancellation/failure before commit leaves the old published state. After the
|
||||
commit point, retained result/recovery reports the applied state rather than
|
||||
claiming rollback. Request/batch correlation supports response-loss recovery
|
||||
without acting as authority. The write lane coordinates participating services;
|
||||
external writers that ignore it are detected by revision revalidation rather
|
||||
than claimed to be serialized.
|
||||
|
||||
@@ -257,3 +257,22 @@ This specification is complete enough when:
|
||||
Expose the effective selected glyph layout through Packer API: asset UUID and stable artifact ID to glyph ID/fingerprint mapping from the same composition used for pack. Exclude `animations.studio.json` from glyph candidates and binary payload. The sidecar references existing identities and does not create an asset type, header or animation binary format. Reorder/removal/content drift requires explicit revision-checked rebind by authoring services; never retarget by path/order.
|
||||
|
||||
See the [complete animation contract](../studio/12.%20Animation%20Authoring%20Specification.md).
|
||||
|
||||
## Batch composition, ownership and dependency boundaries
|
||||
|
||||
Authorized PNG import, bank creation/registration, ordered composition,
|
||||
build-inclusion and preload/contract changes MUST reuse existing declaration,
|
||||
registry and canonical scene-request rules through the shared batch service.
|
||||
No agent-specific manifest/index writer or second packer is introduced. External
|
||||
source grants and expected hashes are validated before publication.
|
||||
|
||||
Generated-output ownership and dependency metadata MUST be declared and
|
||||
queryable by asset/batch. It describes producer, output path, input asset edges
|
||||
and stale dependent state without replacing registry identity. Only explicitly
|
||||
requested internal batch operations execute. Metadata MUST NOT invoke shell,
|
||||
external generators, ROM importers or automatic transitive regeneration.
|
||||
|
||||
Composition changes MUST preserve no-op/append identities and expose affected
|
||||
animation/scene/metadata references for explicit incompatible rebind. Canonical
|
||||
scene layers retain cold glyph AssetIds; a batch MUST NOT reinterpret them as
|
||||
runtime slot numbers or synthesize hidden helper exports.
|
||||
|
||||
@@ -314,3 +314,42 @@ This specification is complete enough when:
|
||||
Expose the effective selected glyph layout through Packer API: asset UUID and stable artifact ID to glyph ID/fingerprint mapping from the same composition used for pack. Exclude `animations.studio.json` from glyph candidates and binary payload. The sidecar references existing identities and does not create an asset type, header or animation binary format. Reorder/removal/content drift requires explicit revision-checked rebind by authoring services; never retarget by path/order.
|
||||
|
||||
See the [complete animation contract](../studio/12.%20Animation%20Authoring%20Specification.md).
|
||||
|
||||
## Qualified global bank budgets and publication
|
||||
|
||||
Bank-content format limits and global residency limits are separate checks.
|
||||
The final deterministic packer preload list is the authority for effective
|
||||
slots per bank type; individual glyphs, logical scenes and stages do not add
|
||||
bank slots. Report existing, build-included, effective-preload and potential
|
||||
dynamic views separately. Cold scene dependencies follow the existing runtime
|
||||
residency contract, preserving AssetId identity rather than converting it into
|
||||
a slot. Potential dynamic excess is a warning about possible loads, not proof
|
||||
of simultaneous residency.
|
||||
|
||||
Global limits MUST come from a distributed versioned profile qualified against
|
||||
the exact selected installed executable. The profile includes contract/runtime
|
||||
versions, executable digest, per-type limits and retained positive/boundary
|
||||
evidence. Publish the initial 16-slot profile only after the selected executable
|
||||
passes 16/17 qualification for glyph and scene. Sound is outside this wave;
|
||||
profiles MUST contain only bank types with actual boundary evidence. An absent/incompatible
|
||||
profile is unknown, never unlimited or a silent constant/family fallback.
|
||||
|
||||
With a known profile, validate effective preloads before final cartridge
|
||||
publication. Excess MUST retain the previous valid output and report the type,
|
||||
limit, responsible slots/AssetIds/paths and profile. A build without a selected
|
||||
compatible profile may publish with explicit unknown qualification, but MUST
|
||||
NOT claim qualified capacity. Managed execution requires a matching profile and
|
||||
valid budget through the same shared preflight. Runtime selection or effective
|
||||
input changes invalidate the previous check. Record the checked profile and
|
||||
input revision in build provenance; ordinary builds MUST NOT inspect runtime
|
||||
checkout sources to obtain limits.
|
||||
|
||||
|
||||
The bundled macOS arm64 profile `macos-arm64-cli-0.1.0-18423f7-glyph-scene-v1`
|
||||
is qualified for glyph=16 and scene=16 against exact dispatcher, headless and
|
||||
desktop component hashes. Runtime version `0.1.0` alone does not select it.
|
||||
The distributed catalog includes hashed boundary evidence. Managed start and each
|
||||
headless BOOT MUST recheck the selected component fingerprints, the complete
|
||||
profile/evidence identity, and hashes of actual cartridge files. Admission reads
|
||||
the serialized `assets.pa` table/preload; auxiliary JSON never replaces it.
|
||||
A changed executable, evidence or build requires a new qualified build.
|
||||
|
||||
@@ -300,3 +300,26 @@ This specification is complete enough when:
|
||||
- Studio-facing operational semantics are explicit;
|
||||
- safety/preview/apply behavior is clear;
|
||||
- event/reporting integration has a stable baseline.
|
||||
|
||||
## Asset batch outcomes and lossless diagnostics
|
||||
|
||||
Batch preview/result values MUST distinguish ready, no-op, stale conflict,
|
||||
rejected rebind, cancelled before commit, committed and recovered outcomes.
|
||||
Preview lists all affected assets/files, expected revision, proposed actions,
|
||||
reference/ownership changes and available producer diagnostics. Durable staging
|
||||
and journal recovery precede publication; shared readers do not observe partial
|
||||
batches. A query after commit/response loss returns applied truth, even when
|
||||
cancellation arrives later.
|
||||
|
||||
Preserve producer and code, assetRoot/path, bank type, missing/duplicate indices,
|
||||
affected references and available used/required/limit facts through packer,
|
||||
Studio shipper, MCP and FE. Do not discard structured detail and later parse
|
||||
prose to recreate it. Unavailable producer facts remain unavailable. Diagnostic
|
||||
identity and budget results MUST agree across adapters.
|
||||
|
||||
The shared budget projection separates per-bank content from existing,
|
||||
build-included, final-preload and potential dynamic residency. Known overflow
|
||||
diagnostics identify responsible slots/AssetIds/paths and qualified profile;
|
||||
unknown qualification has an explicit reason. Service and actual Assets UI
|
||||
qualification are separate gates, alongside recovery, no-op/append identity,
|
||||
explicit rebind and installed positive/negative capacity checks.
|
||||
|
||||
Reference in New Issue
Block a user