@tacuchi/agent-workflow-cli 21.0.0 → 21.1.0

package/dist/domain/design/sources.js

@@ -0,0 +1,180 @@
+/**
+ * What `design` accepts as a source, and what happens to each one.
+ *
+ * The envelope already carries WHICH inputs an invocation declared and where
+ * they came from — that is the capability contract's job, and it is not redone
+ * here. What this module owns is the design domain's half: which KINDS of
+ * source v1 can actually read, what a reading produced, and what it costs when
+ * one of them could not be read.
+ *
+ * The disposition vocabulary is five values because the four ways a source can
+ * fail to contribute are not the same problem for whoever has to fix it:
+ * `skipped` is a decision, `unsupported` is a format nobody promised,
+ * `unavailable` is something that should have been there and was not, and
+ * `redacted` is a deliberate withholding. Collapsing them into "not used" would
+ * make the receipt say four different things with one word.
+ *
+ * The consequence is fail-closed on purpose: a source that did not contribute
+ * blocks `handoff` unless someone states, in writing, why the design does not
+ * need it. A design that silently dropped a requirements document and still
+ * declared itself ready for implementation is precisely the failure the
+ * provenance exists to prevent.
+ */
+/**
+ * The v1 source catalog. Binary documents are read by the HOST's multimodal
+ * capability — the CLI ships no PDF, DOCX or PPTX parser — so what this list
+ * declares is what the domain KNOWS HOW TO ACCOUNT FOR, not what the CLI can
+ * decode by itself.
+ */
+export const DESIGN_SOURCE_KINDS = [
+    "markdown",
+    "image",
+    "pdf",
+    "docx",
+    "pptx",
+    /** Conversation or attachments the host exposed, passed in explicitly. */
+    "host_context",
+    /** An existing UI Design Package, by identity. */
+    "package",
+    /** A provider reference (`file_key`, `project_id`, an artifact id…). */
+    "provider_locator",
+];
+export const SOURCE_DISPOSITIONS = [
+    /** Read, and its content reached the design. */
+    "used",
+    /** Deliberately not read. A decision, and it carries its reason. */
+    "skipped",
+    /** A format v1 does not accept — including every retired UI format. */
+    "unsupported",
+    /** It should have been readable and was not: missing, corrupt, unreachable. */
+    "unavailable",
+    /** Withheld on purpose: sensitive, and the invocation did not authorize it. */
+    "redacted",
+];
+/** Extension → kind, for the locators that carry one. */
+const BY_EXTENSION = new Map([
+    ["md", "markdown"],
+    ["markdown", "markdown"],
+    ["txt", "markdown"],
+    ["png", "image"],
+    ["jpg", "image"],
+    ["jpeg", "image"],
+    ["webp", "image"],
+    ["gif", "image"],
+    ["svg", "image"],
+    ["pdf", "pdf"],
+    ["docx", "docx"],
+    ["pptx", "pptx"],
+]);
+/**
+ * Classify a locator by what it looks like. Returns null when nothing in the
+ * catalog matches — which the caller reports as `unsupported`, never as a guess.
+ */
+export function classifySource(locator) {
+    const trimmed = locator.trim();
+    if (trimmed.length === 0)
+        return null;
+    if (/^DES-(?:[0-9]{3}|[1-9][0-9]{3,})(?:@r[1-9][0-9]{0,5})?$/.test(trimmed))
+        return "package";
+    if (/^[a-z][a-z0-9+.-]*:\/\//.test(trimmed))
+        return "provider_locator";
+    const extension = trimmed.split(".").pop()?.toLowerCase() ?? "";
+    return BY_EXTENSION.get(extension) ?? null;
+}
+/**
+ * Judge a set of sources: shape first, then consequence.
+ *
+ * A malformed record is a failure of the caller, not of the design — a source
+ * that says it was skipped and does not say why cannot be reported at all, so
+ * it is refused here rather than reaching a receipt that would read as if
+ * nothing had been dropped.
+ */
+export function reportSources(sources, artifact) {
+    const failures = [];
+    for (const source of sources) {
+        if (source.disposition !== "used" && (source.reason ?? "").trim().length === 0) {
+            failures.push({
+                code: "DESIGN_SOURCE_WITHOUT_REASON",
+                artifact,
+                message: `la fuente '${source.name}' quedó '${source.disposition}' y no dice por qué`,
+                action: "declará la causa: una fuente descartada en silencio es una decisión invisible",
+            });
+        }
+        if (!source.essential && (source.reason ?? "").trim().length === 0) {
+            failures.push({
+                code: "DESIGN_SOURCE_OPTIONAL_WITHOUT_REASON",
+                artifact,
+                message: `la fuente '${source.name}' se declara no esencial sin justificarlo`,
+                action: "explicá por qué el diseño se sostiene sin ella, o dejala como esencial",
+            });
+        }
+    }
+    const omitted = sources.filter((s) => s.disposition !== "used");
+    return {
+        sources: [...sources],
+        omitted,
+        blocksHandoff: omitted.some((s) => s.essential),
+        failures,
+    };
+}
+/**
+ * The gap an omission leaves behind.
+ *
+ * Actionable on purpose: it names the source, its disposition and its reason,
+ * so the person reading the receipt knows what to go get rather than that
+ * "something" was missing.
+ */
+export function handoffGapsFrom(report) {
+    return report.omitted
+        .filter((s) => s.essential)
+        .map((s) => 
+    // The LOCATOR, not just the input name: several sources arrive under one
+    // declared input, so "the essential source 'sources' is missing" tells
+    // nobody which file to go and get.
+    `la fuente esencial '${s.locator}' (${s.kind}, input '${s.name}') quedó '${s.disposition}': ${s.reason ?? "sin causa"} — conseguila o declarala no esencial con su razón`);
+}
+export function planOriginalCopy(sources, request, artifact) {
+    const byName = new Map(sources.map((s) => [s.name, s]));
+    const copy = [];
+    for (const name of request.approved) {
+        const source = byName.get(name);
+        if (source === undefined) {
+            return {
+                ok: false,
+                failure: {
+                    code: "DESIGN_SOURCE_COPY_UNKNOWN",
+                    artifact,
+                    message: `se autorizó copiar '${name}' y no hay ninguna fuente con ese nombre`,
+                    action: `nombrá una de: ${[...byName.keys()].join(", ") || "(ninguna)"}`,
+                },
+            };
+        }
+        // Copying a source the run never managed to read would put a file in the
+        // package that nothing in the design derives from.
+        if (source.disposition !== "used") {
+            return {
+                ok: false,
+                failure: {
+                    code: "DESIGN_SOURCE_COPY_UNUSED",
+                    artifact,
+                    message: `'${name}' quedó '${source.disposition}' y no se copia al package`,
+                    action: "copiá solo fuentes que el diseño usó de verdad",
+                },
+            };
+        }
+        if (source.sensitivity === "sensitive") {
+            return {
+                ok: false,
+                failure: {
+                    code: "DESIGN_SOURCE_COPY_SENSITIVE",
+                    artifact,
+                    message: `'${name}' está clasificada sensible: no entra al package`,
+                    action: "desclasificala explícitamente o dejá solo su proveniencia",
+                },
+            };
+        }
+        copy.push(source);
+    }
+    return { ok: true, copy };
+}
+//# sourceMappingURL=sources.js.map

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

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

package/dist/domain/design/validation.js

@@ -1,75 +1,19 @@
 /**
- * The shared machinery every design validator is built on.
+ * The design side of the shared contract machinery.
  *
- * Three properties hold across the manifest, the flow and the screen validators,
- * and they live here so no validator can quietly drop one:
- *
- * - **Every diagnostic names an artifact and a corrective action.** A rejection
- *   that only says "invalid" is a dead end for whoever has to fix it.
- * - **Objects are closed.** The published JSON Schemas declare
- *   `additionalProperties: false`, so a key the contract does not declare is a
- *   typo of a real one, never an extension.
- * - **Coverage is measured, not promised.** Every property read is recorded, and
- *   the drift guard compares that set against the published schema. A property
- *   declared in the schema and forgotten in the validator cannot ship.
+ * The reader, the closed-object rule and the coverage tracking are generic and
+ * live in `../contract-reader.js`; what is design-specific is the failure CODE
+ * prefix every diagnostic carries (`DESIGN_FIELD_INVALID`, `DESIGN_KEY_UNKNOWN`).
+ * Binding it once here is what lets every design validator keep importing
+ * `Reader` from this module unchanged while the capability descriptor — which
+ * must not depend on `domain/design` — builds on the same machinery under its
+ * own prefix.
  */
-export class Reader {
-    allowedKeys;
-    touched = new Set();
-    failures = [];
+import { ContractReader } from "../contract-reader.js";
+export { eachRecord, isNonEmptyString, isRecord } from "../contract-reader.js";
+export class Reader extends ContractReader {
     constructor(allowedKeys) {
-        this.allowedKeys = allowedKeys;
-    }
-    /** Read `path`'s last segment off `node`, recording the property as covered. */
-    read(node, path) {
-        this.touched.add(path);
-        const segments = path.split(".");
-        const key = segments[segments.length - 1].replace("[]", "");
-        return node[key];
-    }
-    fail(code, artifact, message, action) {
-        this.failures.push({ code, artifact, message, action });
-    }
-    invalid(artifact, message, action) {
-        this.fail("DESIGN_FIELD_INVALID", artifact, message, action);
-    }
-    /** Reject anything the contract does not declare at `path` (closed objects). */
-    closed(node, path, artifact) {
-        const allowed = this.allowedKeys[path];
-        if (allowed === undefined)
-            return;
-        for (const key of Object.keys(node)) {
-            if (allowed.includes(key))
-                continue;
-            this.fail("DESIGN_KEY_UNKNOWN", artifact, `${path === "" ? "el documento" : `'${path}'`} no admite la clave '${key}'`, `quitala o corregí el nombre; las claves válidas son: ${allowed.join(", ")}`);
-        }
-    }
-}
-/**
- * Walk an array-of-objects field. Every list in the contract shares the same
- * three failure modes — not an array, an item that is not an object, an item
- * carrying a key the schema does not declare — so they are stated once here and
- * each reader stays about ITS own fields.
- */
-export function* eachRecord(r, node, path, artifact, emptyMeans = "") {
-    const list = r.read(node, path);
-    if (!Array.isArray(list)) {
-        r.invalid(artifact, `'${path}' debe ser un array${emptyMeans}`, `escribí '${path}': []`);
-        return;
+        super("DESIGN", allowedKeys);
     }
-    for (const entry of list) {
-        if (!isRecord(entry)) {
-            r.invalid(artifact, `cada entrada de '${path}' debe ser un objeto`, `revisá el array '${path}'`);
-            continue;
-        }
-        r.closed(entry, `${path}[]`, artifact);
-        yield entry;
-    }
-}
-export function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-export function isNonEmptyString(value) {
-    return typeof value === "string" && value.trim().length > 0;
 }
 //# sourceMappingURL=validation.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/domain/design/validation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/domain/design/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIvD,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAI/E,MAAM,OAAO,MAAO,SAAQ,cAAc;IACxC,YAAY,WAAwB;QAClC,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/domain/design/visual-evidence.js

@@ -0,0 +1,155 @@
+/**
+ * The other half of the elevated `handoff` gate: does the evidence a screen
+ * CITES actually show what the screen says it shows?
+ *
+ * `maturity.ts` judges the document alone — every criterion classified, the base
+ * state enumerated with a rendition. That is all one file can prove. But a
+ * reference to `DES-001/VIS-003@r1` is a claim about another document, and the
+ * whole point of requiring visual evidence is defeated if the reference is enough
+ * on its own: a screen could cite a rendition of a different screen, of an older
+ * revision, or one that covers nothing at all, and pass.
+ *
+ * So this crosses the two directions of the same matrix. The screen says *this
+ * criterion is shown here*; the rendition says *I cover these criteria and these
+ * states, and I came out of these revisions*. Both have to agree, and the
+ * rendition is the one that has to back the claim up.
+ *
+ * It lives in the domain and takes a reader, so the caller decides how documents
+ * are loaded — and it is called from the publication path, where a revision is
+ * about to be sealed and there is still time to refuse.
+ */
+/** Formats a person can open with no provider, no account and no network. */
+const STATIC_PREVIEW_FORMATS = ["svg", "png", "jpeg", "webp", "pdf"];
+/**
+ * Cross the screen's classification matrix against the renditions it cites.
+ *
+ * Only for a screen claiming `handoff`: an `outline` may cite a rendition that is
+ * still being drawn, and refusing that would make the early profile unusable.
+ */
+export function crossVisualEvidence(catalog, screen, file, readRendition) {
+    if (screen.maturity !== "handoff")
+        return [];
+    const failures = [];
+    const loaded = new Map();
+    let cited = 0;
+    for (const entry of screen.trace) {
+        if (entry.classification === null || entry.classification === "not_visual")
+            continue;
+        for (const ref of entry.renditions) {
+            cited += 1;
+            const rendition = resolve(catalog, ref, file, readRendition, loaded, failures);
+            if (rendition === null)
+                continue;
+            failures.push(...checkBacksClaim(screen, entry, ref, rendition, file));
+        }
+        if (entry.classification === "interaction") {
+            failures.push(...checkInteractionEvidence(entry, loaded, file));
+        }
+    }
+    // Si NINGUNA cita se pudo cargar, la causa ya está dicha: agregar «no hay
+    // preview estática» sería un segundo diagnóstico del mismo problema, y el
+    // primero es el que se arregla.
+    if (cited > 0 && loaded.size === 0)
+        return failures;
+    failures.push(...checkStaticPreview(screen, loaded, file));
+    return failures;
+}
+/** Load a cited rendition once, reporting the two ways a citation can dangle. */
+function resolve(catalog, ref, file, readRendition, loaded, failures) {
+    const cached = loaded.get(ref);
+    if (cached !== undefined)
+        return cached;
+    const [, tail] = ref.split("/");
+    const [id, revision] = (tail ?? "").split("@r");
+    const entry = catalog.find((e) => e.id === id && e.revision === Number(revision));
+    if (entry === undefined) {
+        failures.push({
+            code: "DESIGN_REFERENCE_MISSING",
+            artifact: file,
+            message: `cita ${ref} como evidencia y el catálogo no la contiene`,
+            action: "publicá esa rendition dentro del package, o citá una que exista",
+        });
+        return null;
+    }
+    const rendition = readRendition(entry.path);
+    if (rendition === null) {
+        failures.push({
+            code: "DESIGN_REFERENCE_FILE_MISSING",
+            artifact: file,
+            message: `cita ${ref} y su '${entry.path}' no se pudo leer como una rendition válida`,
+            action: "reparalo: una evidencia que no se puede abrir no evidencia nada",
+        });
+        return null;
+    }
+    loaded.set(ref, rendition);
+    return rendition;
+}
+/** The three ways a cited rendition can fail to back the claim made about it. */
+function checkBacksClaim(screen, entry, ref, rendition, file) {
+    const insufficient = (message, action) => ({
+        code: "DESIGN_VISUAL_EVIDENCE_REQUIRED",
+        artifact: file,
+        message: `trace['${entry.criterion}'] cita ${ref}, que ${message}`,
+        action,
+    });
+    const failures = [];
+    // Que salió de ESTA revisión, no de otra que se le parece: una preview de r1
+    // presentada como evidencia de r2 es precisamente el snapshot confundido con
+    // algo más reciente que AC-REN-07 nombra.
+    const mine = `${screen.id}@r${screen.revision}`;
+    if (!rendition.sources.some((s) => s.ref === mine || s.ref.startsWith(`${mine}#`))) {
+        failures.push(insufficient(`no salió de ${mine} (declara ${rendition.sources.map((s) => s.ref).join(", ")})`, "regenerá la rendition sobre esta revisión, o citá la que sí salió de ella"));
+    }
+    if (!rendition.coverage.criteria.includes(entry.criterion)) {
+        failures.push(insufficient(`no declara cubrir '${entry.criterion}'`, "agregá el criterio a 'coverage.criteria' de la rendition, o citá otra que lo muestre"));
+    }
+    const uncovered = entry.states.filter((s) => !rendition.coverage.states.includes(s));
+    if (uncovered.length > 0 && rendition.coverage.states.length > 0) {
+        failures.push(insufficient(`no cubre ${uncovered.join(", ")}`, "cubrí esos estados en la rendition, o citá una adicional para ellos"));
+    }
+    return failures;
+}
+/**
+ * AC-REN-02, last clause: an `interaction` entry evidences trigger, transition
+ * and outcome. A picture of the end state is not that, so at least one of the
+ * renditions it cites has to be the prototype or storyboard that shows it.
+ */
+function checkInteractionEvidence(entry, loaded, file) {
+    const cited = entry.renditions.map((ref) => loaded.get(ref)).filter((r) => r !== undefined);
+    if (cited.length === 0)
+        return []; // ya reportado como cita colgante
+    if (cited.some((r) => r.interaction_evidence !== null))
+        return [];
+    return [
+        {
+            code: "DESIGN_VISUAL_EVIDENCE_REQUIRED",
+            artifact: file,
+            message: `trace['${entry.criterion}'] es 'interaction' y ninguna de sus renditions evidencia trigger, transición y outcome`,
+            action: "agregá un prototipo o un storyboard estático con 'interaction_evidence', o reclasificá el criterio como 'visual'",
+        },
+    ];
+}
+/**
+ * AC-REN-01: the base state survives without the provider.
+ *
+ * The document-level gate already demanded that some criterion enumerate
+ * `default_state` with a rendition. What it could not check is whether that
+ * rendition is one a person can OPEN — an `interactive_html` behind a private
+ * Figma link is a citation, not a preview.
+ */
+function checkStaticPreview(screen, loaded, file) {
+    const covering = [...loaded.values()].filter((r) => r.coverage.states.includes(screen.default_state) &&
+        STATIC_PREVIEW_FORMATS.includes(r.format) &&
+        r.files.length > 0);
+    if (covering.length > 0)
+        return [];
+    return [
+        {
+            code: "DESIGN_VISUAL_EVIDENCE_REQUIRED",
+            artifact: file,
+            message: `ninguna rendition citada conserva una preview estática local de '${screen.default_state}'`,
+            action: `el gate 'handoff' pasó a exigir evidencia visual local: publicá una preview en ${STATIC_PREVIEW_FORMATS.join(", ")} que cubra el estado base y citala, o bajá la screen a 'outline'`,
+        },
+    ];
+}
+//# sourceMappingURL=visual-evidence.js.map

package/dist/domain/design/visual-evidence.js.map

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