@tacuchi/agent-workflow-cli 20.26.0 → 21.1.0

package/dist/domain/design/capability.js

@@ -0,0 +1,310 @@
+import { CAPABILITY_CONTRACT_VERSION } from "../capability/descriptor.js";
+/**
+ * What the `design` capability IS, said once.
+ *
+ * The public identity is `design` and nothing else. `ui-design` — the role this
+ * replaces — and `ui-spec` — the skill that used to fill it — are not aliases,
+ * not alternative implementations and not accepted names (S013/AC-CAP-01). A
+ * second name for one capability is a second contract wearing a disguise: the
+ * day they disagree, there is no way to say which one the package obeys.
+ *
+ * Typed as `SkillRole` on purpose: if `design` ever left the role catalog this
+ * stops compiling, so the identity cannot rot into a string that means nothing.
+ */
+export const DESIGN_CAPABILITY = "design";
+/**
+ * The five semantic operations, all over the SAME package (S013/AC-CAP-02).
+ *
+ * - `create` — the first revision of a package.
+ * - `update` — the next revision of one that exists.
+ * - `validate` — judge without writing: schemas, naming, references, maturity.
+ * - `render` — regenerate the projections; never normative, never sealed.
+ * - `record` — seal a governance decision about a revision that exists.
+ *
+ * `create` and `update` are one route with a different compare-and-swap base,
+ * not two formats. `render` and `record` write files a baseline never selects.
+ * None of them may invent a layout or a schema of its own — that is the whole
+ * content of «no parallel format».
+ */
+export const DESIGN_OPERATIONS = ["create", "update", "validate", "render", "record"];
+/**
+ * Every format this capability produces, and the only ones it accepts.
+ *
+ * The validators read their id from here rather than repeating a literal, so
+ * the registry is load-bearing instead of documentation: a new format cannot
+ * appear in code without appearing here, and `design-schema-guard` proves this
+ * table and the published JSON Schemas under `skills/w/schemas/design/` name
+ * the same things.
+ *
+ * This is the canonical authority (S013/AC-CAP-03). The built-in floor and any
+ * third-party improvement bound to the role write these and are validated by
+ * the same code; a contributor extends the domain by adding fields to a schema,
+ * never by declaring a format of their own.
+ */
+export const CANONICAL_SCHEMAS = {
+    manifest: "workline.design-manifest/v1",
+    baseline: "workline.design-baseline/v1",
+    flow: "workline.ui-flow/v1",
+    screen: "workline.ui-screen/v1",
+    review: "workline.design-review/v1",
+    revocation: "workline.design-revocation/v1",
+    rendition: "workline.design-rendition/v1",
+    renderBundle: "workline.design-render-bundle/v1",
+};
+/**
+ * `design` as a capability descriptor — the v1 conformant instance.
+ *
+ * This is the same capability the table above describes, restated in the ONE
+ * form every consumer reads: the wrapper installed into a host, the dispatcher,
+ * discovery, the generated help and any flow that composes an operation all
+ * derive from this object rather than re-describing it. Two descriptions of one
+ * contract is the failure mode the whole layer exists to prevent.
+ *
+ * The typing is load-bearing twice over. `CapabilityDescriptor` keeps the shape
+ * honest, and `name: SkillRole` proves at COMPILE TIME that the capability's
+ * public identity and the `skills.toml` binding slot are the same string. The
+ * day someone names a capability differently from its role, the parallel public
+ * identity `S014/AC-ID-01` forbids reappears — and this annotation is the only
+ * barrier against it.
+ *
+ * The `schema` fields point at formats already published under
+ * `skills/w/schemas/design/`; the descriptor references them and does not become
+ * another one. That is why it lives here and the CONTRACT lives in
+ * `domain/capability` — a design format never has to know a capability exists.
+ */
+export const DESIGN_DESCRIPTOR = {
+    contract_version: CAPABILITY_CONTRACT_VERSION,
+    name: DESIGN_CAPABILITY,
+    purpose: "producir, actualizar, juzgar, proyectar y sellar un UI Design Package v1 sobre un contrato único",
+    exposure: ["direct", "compose"],
+    default_operation: null,
+    operations: [
+        {
+            name: "create",
+            summary: "primera revisión de un package a partir de fuentes declaradas",
+            exposure: ["direct", "compose"],
+            // `optional`, not `required`: inside a workspace the package defaults to
+            // `docs/designs/`, and OUTSIDE one an explicit root still produces a
+            // portable package (`AC-DIR-04`). Refusing outside a workspace would turn
+            // "design something on a machine with no Workline project" into an error
+            // instead of an answer — and `resolveOutputRoot` is what keeps the other
+            // half of `AC-REQ-03` intact: no root declared, no writing, and never an
+            // invented one.
+            workspace: "optional",
+            interaction: "needs_input",
+            inputs: [
+                { name: "title", kind: "text", required: true, sensitivity: "public", schema: null },
+                { name: "sources", kind: "reference", required: true, sensitivity: "public", schema: null },
+                { name: "target", kind: "text", required: true, sensitivity: "public", schema: null },
+                {
+                    name: "profile",
+                    kind: "selection",
+                    required: false,
+                    sensitivity: "public",
+                    schema: null,
+                },
+                { name: "context", kind: "text", required: false, sensitivity: "public", schema: null },
+                // The maturity the caller ASKS FOR. Declared as an input because the
+                // answer "you got `outline`, not `handoff`" only means something
+                // against something that was requested.
+                {
+                    name: "maturity",
+                    kind: "selection",
+                    required: false,
+                    sensitivity: "public",
+                    schema: null,
+                },
+            ],
+            output: {
+                kind: "value_and_reference",
+                schema: CANONICAL_SCHEMAS.baseline,
+                completeness: ["complete", "partial"],
+            },
+            effects: [
+                { class: "read_only", idempotent: true, authorization: "invocation", approval: "none" },
+                {
+                    class: "local_additive",
+                    idempotent: false,
+                    authorization: "invocation",
+                    approval: "none",
+                },
+            ],
+            off: "blocked",
+        },
+        {
+            name: "update",
+            summary: "revisión siguiente de un package existente, con base de compare-and-swap",
+            exposure: ["direct", "compose"],
+            workspace: "optional",
+            interaction: "needs_input",
+            inputs: [
+                { name: "package", kind: "reference", required: true, sensitivity: "public", schema: null },
+                { name: "base", kind: "reference", required: true, sensitivity: "public", schema: null },
+                {
+                    name: "sources",
+                    kind: "reference",
+                    required: false,
+                    sensitivity: "public",
+                    schema: null,
+                },
+                { name: "context", kind: "text", required: false, sensitivity: "public", schema: null },
+                {
+                    name: "maturity",
+                    kind: "selection",
+                    required: false,
+                    sensitivity: "public",
+                    schema: null,
+                },
+            ],
+            output: {
+                kind: "value_and_reference",
+                schema: CANONICAL_SCHEMAS.baseline,
+                completeness: ["complete", "partial"],
+            },
+            effects: [
+                { class: "read_only", idempotent: true, authorization: "invocation", approval: "none" },
+                {
+                    class: "local_additive",
+                    idempotent: false,
+                    authorization: "invocation",
+                    approval: "none",
+                },
+                // Publishing a revision moves the manifest's current baseline: an
+                // existing file says something else afterwards, so a human sees it first.
+                {
+                    class: "mutate_overwrite",
+                    idempotent: false,
+                    authorization: "preflight",
+                    approval: "visible",
+                },
+            ],
+            off: "blocked",
+        },
+        {
+            name: "validate",
+            summary: "juzgar un package sin escribir: schemas, naming, referencias y madurez",
+            exposure: ["direct", "compose"],
+            // The one operation a flow can reach with `design` off, so it must not
+            // depend on workspace state it might not have.
+            workspace: "optional",
+            interaction: "single_pass",
+            inputs: [
+                { name: "package", kind: "reference", required: true, sensitivity: "public", schema: null },
+                {
+                    name: "profile",
+                    kind: "selection",
+                    required: false,
+                    sensitivity: "public",
+                    schema: null,
+                },
+            ],
+            output: { kind: "value", schema: null, completeness: ["complete"] },
+            effects: [
+                { class: "read_only", idempotent: true, authorization: "invocation", approval: "none" },
+            ],
+            // Survives `off` on purpose: a package that already exists stays
+            // consultable and consumable, or turning the capability off would
+            // retroactively invalidate work nobody asked to discard.
+            off: "allowed",
+        },
+        {
+            name: "render",
+            summary: "regenerar las proyecciones de una revisión y preparar el handoff a un proveedor",
+            exposure: ["direct", "compose"],
+            workspace: "optional",
+            interaction: "single_pass",
+            inputs: [
+                { name: "package", kind: "reference", required: true, sensitivity: "public", schema: null },
+                { name: "profile", kind: "selection", required: true, sensitivity: "public", schema: null },
+            ],
+            output: {
+                kind: "reference",
+                schema: CANONICAL_SCHEMAS.renderBundle,
+                completeness: ["complete", "partial"],
+            },
+            effects: [
+                { class: "read_only", idempotent: true, authorization: "invocation", approval: "none" },
+                {
+                    class: "local_additive",
+                    idempotent: true,
+                    authorization: "invocation",
+                    approval: "none",
+                },
+                // A provider profile can leave the machine. Declared here rather than
+                // decided at call time: the preflight is what makes the destination and
+                // the payload visible before anything is sent.
+                {
+                    class: "network_external",
+                    idempotent: false,
+                    authorization: "preflight",
+                    approval: "visible",
+                },
+            ],
+            off: "blocked",
+        },
+        {
+            name: "record",
+            summary: "sellar una decisión de gobierno sobre una revisión existente",
+            exposure: ["direct", "compose"],
+            workspace: "optional",
+            interaction: "single_pass",
+            inputs: [
+                { name: "package", kind: "reference", required: true, sensitivity: "public", schema: null },
+                {
+                    name: "revision",
+                    kind: "reference",
+                    required: true,
+                    sensitivity: "public",
+                    schema: null,
+                },
+                { name: "decision", kind: "text", required: true, sensitivity: "public", schema: null },
+            ],
+            output: {
+                kind: "reference",
+                schema: CANONICAL_SCHEMAS.review,
+                completeness: ["complete"],
+            },
+            effects: [
+                { class: "read_only", idempotent: true, authorization: "invocation", approval: "none" },
+                {
+                    class: "local_additive",
+                    idempotent: false,
+                    authorization: "invocation",
+                    approval: "none",
+                },
+                // A revocation changes what a published revision means downstream.
+                {
+                    class: "mutate_overwrite",
+                    idempotent: false,
+                    authorization: "preflight",
+                    approval: "visible",
+                },
+            ],
+            off: "blocked",
+        },
+    ],
+    // Core with a built-in floor: the PLAN and SPEC gates that consume a package
+    // must keep working on a machine where nothing extra is installed.
+    floor: { builtin: true, kind: "core", improvements: "host_selected" },
+    degradations: [
+        { cause: "opaque_selection", action: "floor" },
+        { cause: "incompatible_improvement", action: "floor" },
+        { cause: "invalid_binding", action: "floor" },
+        { cause: "digest_changed", action: "floor" },
+    ],
+    compatibility: {
+        status: "active",
+        minimum_contract_version: CAPABILITY_CONTRACT_VERSION,
+        // This descriptor IS the capability, not an improvement to one.
+        improves: null,
+        // Not aliases. Listed so every entry surface can refuse them by NAME with a
+        // corrective action instead of failing with "unknown skill".
+        retired_names: ["ui-design", "ui-spec"],
+        retired_formats: [
+            "spec-section:## UI spec",
+            "session-design-spec:NNN-SPEC-<SLUG>.md",
+            "ui-spec-generator:output",
+        ],
+    },
+};
+//# sourceMappingURL=capability.js.map

package/dist/domain/design/capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.js","sourceRoot":"","sources":["../../../src/domain/design/capability.ts"],"names":[],"mappings":"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"}

package/dist/domain/design/closure.js

@@ -0,0 +1,161 @@
+import { parseArtifactRef } from "./identity.js";
+const KIND_OF_PREFIX = {
+    FLW: "flow",
+    SCR: "screen",
+    RUL: "rule",
+    TOK: "token",
+    VIS: "rendition",
+};
+export function computeClosure(manifest, roots, read) {
+    const members = new Map();
+    const assets = new Set();
+    const failures = [];
+    const queue = roots.map((ref) => ({
+        ref,
+        via: null,
+    }));
+    while (queue.length > 0) {
+        const next = queue.shift();
+        if (next === undefined)
+            break;
+        const reached = visit(manifest, next, members, read);
+        if ("failure" in reached) {
+            failures.push(reached.failure);
+            continue;
+        }
+        for (const ref of reached.refs)
+            queue.push({ ref, via: reached.via });
+        for (const digest of reached.assets) {
+            // Un asset se alcanza solo si el package lo CUSTODIA: afirmar haber
+            // llegado a bytes que no están es la clausura mintiendo sobre su alcance.
+            if (manifest.catalog.assets.some((a) => a.digest === digest))
+                assets.add(digest);
+            else
+                failures.push(uncustodied(digest, manifest.id));
+        }
+    }
+    return { members: [...members.values()], assets: [...assets], failures };
+}
+/**
+ * Reaching the same revision twice can only WIDEN what is required.
+ *
+ * `states: []` means the whole revision, not "no states": a root written
+ * without an anchor asked for all of it. So an anchor never narrows a member
+ * that was already whole, and a whole reference swallows the anchors collected
+ * so far — otherwise adding a MORE specific root would shrink the closure.
+ */
+function widen(member, anchor) {
+    if (member.states.length === 0)
+        return;
+    if (anchor === null) {
+        member.states.length = 0;
+        return;
+    }
+    if (!member.states.includes(anchor))
+        member.states.push(anchor);
+}
+/** One step of the walk: admit the reference, or say why it does not resolve. */
+function visit(manifest, next, members, read) {
+    const nothing = { refs: [], assets: [], via: null };
+    const parsed = parseArtifactRef(next.ref);
+    if (parsed === null || parsed.package !== manifest.id) {
+        return { failure: foreignRoot(next.ref, manifest.id) };
+    }
+    const key = `${parsed.package}/${parsed.artifact}@r${parsed.revision}`;
+    const anchor = parsed.state ?? null;
+    const already = members.get(key);
+    if (already !== undefined) {
+        widen(already, anchor);
+        return nothing;
+    }
+    const entry = findEntry(manifest, parsed.artifact, parsed.revision);
+    const kind = KIND_OF_PREFIX[parsed.artifact.slice(0, 3)];
+    if (entry === null || kind === undefined) {
+        return { failure: unresolvable(next.ref, manifest.id) };
+    }
+    members.set(key, { ref: key, kind, states: anchor === null ? [] : [anchor], via: next.via });
+    if (kind !== "flow" && kind !== "screen")
+        return nothing;
+    const document = read(entry.path);
+    if (document === null)
+        return { failure: unreadable(entry.path, key) };
+    return { refs: reachableFrom(document), assets: assetsOf(document), via: key };
+}
+/**
+ * Everything a document DEPENDS ON, in the closure's terms.
+ *
+ * `flow_refs` is deliberately absent. It records which flows visit a screen —
+ * the INVERSE of `flow.nodes`, the screen's membership, not its needs. Walking
+ * both directions turns the closure into the connected component of the graph:
+ * one screen would drag in every flow that mentions it and every screen those
+ * flows touch, and a task would be blocked by designs it never consumes.
+ */
+function reachableFrom(document) {
+    if (document.kind === "flow") {
+        return [document.entry, ...document.nodes, ...document.dependencies];
+    }
+    return [...document.dependencies.rules, ...document.dependencies.tokens];
+}
+function assetsOf(document) {
+    return document.kind === "flow" ? [] : document.dependencies.assets;
+}
+function findEntry(manifest, id, revision) {
+    for (const key of ["flows", "screens", "rules", "tokens", "renditions"]) {
+        const hit = manifest.catalog[key].find((e) => e.id === id && e.revision === revision);
+        if (hit !== undefined)
+            return hit;
+    }
+    return null;
+}
+function foreignRoot(ref, packageId) {
+    return {
+        code: "DESIGN_REFERENCE_MISSING",
+        artifact: ref,
+        message: `'${ref}' no es una referencia resoluble dentro de ${packageId}`,
+        action: "una clausura se calcula dentro de un package: usá DES-NNN/XXX-NNN@rN",
+    };
+}
+function unresolvable(ref, packageId) {
+    return {
+        code: "DESIGN_REFERENCE_MISSING",
+        artifact: ref,
+        message: `${packageId} no cataloga '${ref}'`,
+        action: "revisá la revisión exacta: la clausura no adivina la vigente",
+    };
+}
+function uncustodied(digest, packageId) {
+    return {
+        code: "DESIGN_REFERENCE_MISSING",
+        artifact: digest,
+        message: `${packageId} no custodia el asset ${digest}`,
+        action: "publicá el asset dentro del package: una clausura no alcanza bytes que no están",
+    };
+}
+function unreadable(path, ref) {
+    return {
+        code: "DESIGN_REFERENCE_FILE_MISSING",
+        artifact: path,
+        message: `'${path}' no se pudo leer para expandir ${ref}`,
+        action: "el catálogo promete ese archivo: restauralo o corregí su ruta",
+    };
+}
+/**
+ * The maturity a set of roots demands.
+ *
+ * Consuming an `outline` revision is not an error in itself — a task may
+ * legitimately reference a design that is still being shaped. What fails closed
+ * is IMPLEMENTING against it, which is the question this answers: which members
+ * of the closure are not yet `handoff`.
+ */
+export function notReadyForHandoff(manifest, closure) {
+    return closure.members.filter((member) => {
+        if (member.kind !== "flow" && member.kind !== "screen")
+            return false;
+        const key = member.kind === "flow" ? "flows" : "screens";
+        const id = member.ref.split("/")[1]?.split("@")[0];
+        const revision = Number(member.ref.split("@r")[1]);
+        const entry = manifest.catalog[key].find((e) => e.id === id && e.revision === revision);
+        return entry?.maturity !== "handoff";
+    });
+}
+//# sourceMappingURL=closure.js.map

package/dist/domain/design/closure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"closure.js","sourceRoot":"","sources":["../../../src/domain/design/closure.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAwCjD,MAAM,cAAc,GAA0C;IAC5D,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,WAAW;CACjB,CAAC;AAEF,MAAM,UAAU,cAAc,CAC5B,QAAwB,EACxB,KAAe,EACf,IAAoB;IAEpB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IACjD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,MAAM,KAAK,GAA+C,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC5E,GAAG;QACH,GAAG,EAAE,IAAI;KACV,CAAC,CAAC,CAAC;IAEJ,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACrD,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC/B,SAAS;QACX,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACtE,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACpC,oEAAoE;YACpE,0EAA0E;YAC1E,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;;gBAC5E,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;AAC3E,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,KAAK,CAAC,MAAqB,EAAE,MAAqB;IACzD,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACvC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACzB,OAAO;IACT,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAClE,CAAC;AAED,iFAAiF;AACjF,SAAS,KAAK,CACZ,QAAwB,EACxB,IAAyC,EACzC,OAAmC,EACnC,IAAoB;IAEpB,MAAM,OAAO,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IACpD,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,EAAE,EAAE,CAAC;QACtD,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;IACzD,CAAC;IACD,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,EAAE,CAAC;IACvE,MAAM,MAAM,GAAkB,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC;IAEnD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACvB,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACzD,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACzC,OAAO,EAAE,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;IAC1D,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7F,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAEzD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,EAAE,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;IACvE,OAAO,EAAE,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACjF,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,aAAa,CAAC,QAAwB;IAC7C,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,QAAQ,CAAC,QAAwB;IACxC,OAAO,QAAQ,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC;AACtE,CAAC;AAED,SAAS,SAAS,CAAC,QAAwB,EAAE,EAAU,EAAE,QAAgB;IACvE,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,CAAU,EAAE,CAAC;QACjF,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QACtF,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,GAAW,EAAE,SAAiB;IACjD,OAAO;QACL,IAAI,EAAE,0BAA0B;QAChC,QAAQ,EAAE,GAAG;QACb,OAAO,EAAE,IAAI,GAAG,8CAA8C,SAAS,EAAE;QACzE,MAAM,EAAE,sEAAsE;KAC/E,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,GAAW,EAAE,SAAiB;IAClD,OAAO;QACL,IAAI,EAAE,0BAA0B;QAChC,QAAQ,EAAE,GAAG;QACb,OAAO,EAAE,GAAG,SAAS,iBAAiB,GAAG,GAAG;QAC5C,MAAM,EAAE,8DAA8D;KACvE,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,MAAc,EAAE,SAAiB;IACpD,OAAO;QACL,IAAI,EAAE,0BAA0B;QAChC,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,GAAG,SAAS,yBAAyB,MAAM,EAAE;QACtD,MAAM,EAAE,iFAAiF;KAC1F,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,GAAW;IAC3C,OAAO;QACL,IAAI,EAAE,+BAA+B;QACrC,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,IAAI,IAAI,mCAAmC,GAAG,EAAE;QACzD,MAAM,EAAE,+DAA+D;KACxE,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAwB,EACxB,OAAsB;IAEtB,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE;QACvC,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACrE,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACzD,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnD,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;QACxF,OAAO,KAAK,EAAE,QAAQ,KAAK,SAAS,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/domain/design/direct.js

@@ -0,0 +1,108 @@
+/**
+ * What the DIRECT route adds on top of the capability contract.
+ *
+ * The generic half — envelope, attempts, outcomes, receipt correlation, the
+ * rule that a direct invocation opens no flow session — is already delivered
+ * and tested by the capability layer. Three things are left, and all three are
+ * design-domain decisions:
+ *
+ * - **Where the output lands.** Inside a workspace it defaults to
+ *   `docs/designs/`; outside one it needs an explicit root and still produces
+ *   something portable. A capability that simply refused outside a workspace
+ *   would make "design something on a machine that has no Workline project" an
+ *   error instead of an answer.
+ * - **Which domain fields the receipt carries.** The canonical receipt already
+ *   says operation, validations, degradations, effects and next action; it
+ *   knows nothing about packages, baselines or maturity. Those are added here
+ *   and nowhere else — repeating the canonical ones would be a second receipt.
+ * - **What maturity the result may claim.** The one rule the whole ladder rests
+ *   on: an omission that could change behavior means the answer is `outline`
+ *   with a gap, never a `handoff` nobody can trace back.
+ */
+import { checkSafeRelativePath } from "../safe-path.js";
+import { handoffGapsFrom } from "./sources.js";
+/** The conventional home of packages inside a workspace. */
+export const DESIGNS_DIR = "docs/designs";
+/**
+ * Decide where a directly-invoked operation writes.
+ *
+ * Being outside a workspace is not an error — it is a different mode, and the
+ * only thing it costs is that the caller has to say where. What is refused is
+ * guessing: writing a package into whatever directory the process happened to
+ * start in is how a design ends up somewhere nobody looks again.
+ */
+export function resolveOutputRoot(workspace, target, artifact = "design") {
+    if (workspace === null) {
+        if (target === null || target.trim().length === 0) {
+            return {
+                ok: false,
+                failure: {
+                    code: "DESIGN_OUTPUT_ROOT_REQUIRED",
+                    artifact,
+                    message: "fuera de un workspace hace falta una raíz explícita para el package",
+                    action: "pasá 'target' con la ruta donde debe quedar el package",
+                },
+            };
+        }
+        // An explicit root outside a workspace is the caller's own path: it is not
+        // validated as workspace-relative, because it is not relative to one.
+        return { ok: true, value: { kind: "explicit", root: target.trim() } };
+    }
+    if (target === null || target.trim().length === 0) {
+        return { ok: true, value: { kind: "workspace", root: DESIGNS_DIR, declared: false } };
+    }
+    const safe = checkSafeRelativePath(target.trim());
+    if (!safe.ok) {
+        return {
+            ok: false,
+            failure: {
+                code: "DESIGN_OUTPUT_ROOT_UNSAFE",
+                artifact,
+                message: `'${target}' no es una ruta relativa válida dentro del workspace: ${safe.why}`,
+                action: `usá una ruta relativa dentro del workspace, por ejemplo '${DESIGNS_DIR}'`,
+            },
+        };
+    }
+    return { ok: true, value: { kind: "workspace", root: safe.path, declared: true } };
+}
+/**
+ * Whether a package written at this root is discoverable by the index.
+ *
+ * Only the ones under `docs/designs/` are. That is not a limitation of the
+ * index — it is what makes `AC-DIR-06` meaningful: a package created directly
+ * inside a workspace can be referenced later by a spec or a plan without ever
+ * having had a relationship with those flows, precisely because it landed where
+ * discovery looks.
+ */
+export function isIndexable(root) {
+    if (root.kind !== "workspace")
+        return false;
+    const segments = root.root.split("/").filter((s) => s.length > 0);
+    const expected = DESIGNS_DIR.split("/");
+    return expected.every((segment, i) => segments[i] === segment);
+}
+/**
+ * The maturity the result may honestly claim.
+ *
+ * Two independent reasons to fall back to `outline`, and both are ceilings
+ * rather than opinions: the document-level verdict the `012` gate already
+ * computes, and an essential source that did not contribute. Neither can be
+ * argued past — a floor and an improvement get the same answer here, which is
+ * what stops an improvement from "achieving" a `handoff` the evidence does not
+ * support.
+ */
+export function attainedMaturity(requested, gateVerdict, report) {
+    const gaps = handoffGapsFrom(report);
+    if (report.blocksHandoff)
+        return { attained: "outline", gaps };
+    if (requested === "handoff" && gateVerdict !== "handoff") {
+        return {
+            attained: gateVerdict,
+            gaps: [
+                `se pidió 'handoff' y la evidencia del package alcanza '${gateVerdict}': completá lo que el gate reclama`,
+            ],
+        };
+    }
+    return { attained: gateVerdict, gaps: [] };
+}
+//# sourceMappingURL=direct.js.map

package/dist/domain/design/direct.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct.js","sourceRoot":"","sources":["../../../src/domain/design/direct.ts"],"names":[],"mappings":"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"}