@tacuchi/agent-workflow-cli 20.22.0 → 20.23.0

package/dist/application/resume-service.js

@@ -0,0 +1,184 @@
+import { firstNonEmptyLine, parseMdSectionBilingual } from "./markdown.js";
+import { findArtifact } from "./session-artifacts.js";
+import { resolveSessionTarget } from "./session-resolver.js";
+import { buildWorklineIndex, } from "./workline-index-service.js";
+export async function runResume(fs, env, paths, input = {}) {
+    const index = await buildWorklineIndex(fs, env, paths, {
+        ...(input.now !== undefined ? { now: input.now } : {}),
+    });
+    if (input.code !== undefined)
+        return await resumeSession(fs, paths, index, input);
+    if (input.target !== undefined)
+        return resumeTarget(index, input.target);
+    return await resumePipeline(fs, index);
+}
+// ── explicit target ──────────────────────────────────────────────────────────
+/**
+ * An explicit target wins over the pipeline, and matches by exact path or by
+ * document number — **never by slug**, which is how the old survey attached a
+ * session to the wrong plan. A number that names both a spec and a plan is a
+ * genuine tie, so it comes back as candidates, the same answer the pipeline
+ * gives for any other tie.
+ */
+function resumeTarget(index, target) {
+    const specs = index.specs.filter((s) => s.file === target || s.number === target);
+    const plans = index.plans.filter((p) => p.file === target || p.number === target);
+    const matches = [
+        ...specs.map((s) => specProposal(s, index)),
+        ...plans.map(planProposal),
+    ];
+    const [first] = matches;
+    if (first === undefined) {
+        return {
+            status: "invalid_target",
+            target,
+            action: `ningún documento coincide con '${target}': pasá una ruta docs/specs|docs/plans o el número, o usá --code para una sesión`,
+        };
+    }
+    if (matches.length > 1) {
+        return {
+            status: "candidates",
+            candidates: matches,
+            action: `'${target}' identifica ${matches.length} documentos: repetí con la ruta completa`,
+        };
+    }
+    return { status: "proposal", via: "explicit", proposal: first };
+}
+async function resumeSession(fs, paths, index, input) {
+    // `bind: false` on purpose: this is a read. `sessionReadRequest` would record
+    // the conversation→session association, and `resume` must not write.
+    const resolution = await resolveSessionTarget(fs, paths, {
+        ...(input.code !== undefined ? { code: input.code } : {}),
+        ...(input.contextId !== undefined ? { contextId: input.contextId } : {}),
+        allowClosed: true,
+        bind: false,
+    });
+    if (resolution.outcome !== "resolved") {
+        return {
+            status: "invalid_target",
+            target: input.code ?? "",
+            action: resolution.action,
+        };
+    }
+    const folder = resolution.session.folder;
+    const session = index.sessions.find((s) => s.folder === folder);
+    const path = session?.path ?? resolution.session.path;
+    return {
+        status: "proposal",
+        via: "explicit",
+        proposal: await sessionProposal(fs, folder, path, session),
+    };
+}
+// ── no target: the documental pipeline ───────────────────────────────────────
+async function resumePipeline(fs, index) {
+    const [head] = index.pipeline;
+    if (head === undefined) {
+        return { status: "idle", action: "no hay trabajo pendiente: el pipeline está vacío" };
+    }
+    // A tie is priority + progress, never date. Two items that reach here are
+    // equally next, and picking one for the user is what this replaces.
+    const tied = index.pipeline.filter((item) => item.priority === head.priority && (item.started ?? false) === (head.started ?? false));
+    if (tied.length > 1) {
+        const candidates = await Promise.all(tied.map((item) => pipelineProposal(fs, index, item)));
+        return {
+            status: "candidates",
+            candidates,
+            action: `${tied.length} candidatos con la misma prioridad: elegí uno y volvé a invocar con su ruta`,
+        };
+    }
+    return { status: "proposal", via: "pipeline", proposal: await pipelineProposal(fs, index, head) };
+}
+async function pipelineProposal(fs, index, item) {
+    if (item.kind === "plan-open") {
+        const plan = index.plans.find((p) => p.file === item.file);
+        if (plan !== undefined)
+            return planProposal(plan);
+    }
+    if (item.kind === "checkpoint-orphan") {
+        const session = index.sessions.find((s) => s.folder === item.file);
+        if (session !== undefined) {
+            return await sessionProposal(fs, session.folder, session.path, session);
+        }
+    }
+    const spec = index.specs.find((s) => s.file === item.file);
+    if (spec !== undefined)
+        return specProposal(spec, index);
+    return {
+        kind: item.kind,
+        file: item.file,
+        number: item.number,
+        objective: item.summary,
+        progress: "—",
+        next: item.summary,
+        command: item.command,
+    };
+}
+// ── proposals ────────────────────────────────────────────────────────────────
+function specProposal(spec, index) {
+    const planned = index.plans.some((p) => p.spec.status === "resolved" && p.spec.number === spec.number);
+    const refine = spec.status !== "ready-for-plan";
+    return {
+        kind: refine ? "spec-unrefined" : "spec-unplanned",
+        file: spec.file,
+        number: spec.number,
+        objective: `spec ${spec.number}${spec.slug ? ` — ${spec.slug}` : ""}`,
+        progress: `status ${spec.status}, ${spec.open_questions} pregunta(s) abierta(s)`,
+        next: refine
+            ? "refinar hasta ready-for-plan"
+            : planned
+                ? "ya tiene plan derivado"
+                : "generar su plan",
+        command: refine ? `/w:spec-refine ${spec.file}` : `/w:plan-new ${spec.file}`,
+    };
+}
+function planProposal(plan) {
+    const [blocked] = plan.blocked_phases;
+    const phases = plan.phases_total > 0 ? ` · fases ${plan.phases_validated}/${plan.phases_total}` : "";
+    return {
+        kind: "plan-open",
+        file: plan.file,
+        number: plan.number,
+        objective: `plan ${plan.number}${plan.slug ? ` — ${plan.slug}` : ""}`,
+        progress: `${plan.tasks_done}/${plan.tasks_total} tareas (${plan.progress_pct}%)${phases}`,
+        next: describePlanNext(plan, blocked),
+        command: `/w:plan-exec ${plan.file}`,
+    };
+}
+function describePlanNext(plan, blocked) {
+    if (blocked !== undefined) {
+        return `BLOQUEADA F${blocked.number} — ${blocked.blocker ?? "sin motivo declarado"}`;
+    }
+    if (plan.plan_state === "inconsistent") {
+        return "el plan se declara done pero sus contadores no lo respaldan: repararlo a mano";
+    }
+    if (plan.final_validation_pending)
+        return "todo ejecutado: falta la validación final y el cierre";
+    return "continuar por la primera fase no validada";
+}
+async function sessionProposal(fs, folder, path, session) {
+    const objective = (await readSection(fs, path, "session", "Objective")) ?? session?.summary ?? folder;
+    const pending = await readSection(fs, path, "checkpoint", "Pending / Next");
+    const completed = await readSection(fs, path, "checkpoint", "Completed");
+    return {
+        kind: "session",
+        file: folder,
+        number: session?.code ?? null,
+        objective,
+        progress: completed === undefined ? "sin checkpoint" : `checkpoint presente: ${completed}`,
+        next: pending ?? "el checkpoint no declara trabajo pendiente",
+        command: `aw session-resume --code ${folder} --reopen`,
+    };
+}
+async function readSection(fs, sessionPath, artifact, heading) {
+    try {
+        const file = await findArtifact(sessionPath, artifact, fs);
+        if (!file)
+            return undefined;
+        const section = parseMdSectionBilingual(await fs.readText(file), heading);
+        return section === undefined ? undefined : firstNonEmptyLine(section);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=resume-service.js.map

package/dist/application/resume-service.js.map

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

package/dist/application/semantic-operation/protocol.js

@@ -0,0 +1,247 @@
+import { createHash } from "node:crypto";
+/**
+ * The bounded CLI↔AI handshake shared by every hybrid command.
+ *
+ * The split is the whole point: the CLI owns inventory, numbering, validation,
+ * authorization and writing; the AI owns exactly one semantic step —
+ * classification, synthesis or intent — and its answer is data to be validated,
+ * never an instruction to be trusted.
+ *
+ * Three stages, and only the third can touch the filesystem:
+ *
+ * - `prepare` builds a {@link SemanticRequest}: what was read, where writing is
+ *   allowed, the limits, and an `input_digest` sealing the state it saw.
+ * - `validate` parses the answer against that request and, if it survives,
+ *   returns a preview plus an `approval_digest` over the exact bytes proposed.
+ * - `apply` recomputes the input digest, checks the approval still matches, and
+ *   only then publishes.
+ *
+ * Validation is manual (DEC-001: no Zod) and **fail-closed**: anything absent,
+ * malformed, stale, oversized or outside the allowlist stops before the first
+ * write and comes back with a next action.
+ */
+export const SEMANTIC_PROTOCOL_VERSION = 1;
+/** Stable SHA-256 of a value: object keys sorted so equal state digests equally. */
+export function semanticDigest(value) {
+    return createHash("sha256").update(canonicalJson(value), "utf8").digest("hex");
+}
+function canonicalJson(value) {
+    if (value === null || typeof value !== "object")
+        return JSON.stringify(value) ?? "null";
+    if (Array.isArray(value))
+        return `[${value.map(canonicalJson).join(",")}]`;
+    const entries = Object.entries(value)
+        .filter(([, v]) => v !== undefined)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([k, v]) => `${JSON.stringify(k)}:${canonicalJson(v)}`);
+    return `{${entries.join(",")}}`;
+}
+export function buildSemanticRequest(input) {
+    const request = {
+        version: SEMANTIC_PROTOCOL_VERSION,
+        operation: input.operation,
+        input_digest: semanticDigest(input.inputs),
+        contract: input.contract,
+        inventory: input.inventory,
+        allowed_destinations: input.allowedDestinations,
+        limits: input.limits,
+        read_set: input.readSet,
+        metrics: { request_bytes: 0, read_set_bytes: input.readSetBytes },
+    };
+    // Measured after the shape is final, then written back: the number describes
+    // the payload actually sent, which is what the spec 009 budgets will consume.
+    request.metrics.request_bytes = Buffer.byteLength(JSON.stringify(request), "utf8");
+    return request;
+}
+/**
+ * Parse and validate an answer against the request that produced it. Every
+ * rejection names the problem and a next action; none of them writes.
+ */
+export function parseSemanticResponse(raw, request) {
+    const parsed = parseJson(raw);
+    if (!parsed.ok)
+        return parsed;
+    const envelope = parsed.value;
+    const header = checkHeader(envelope, request);
+    if (header !== null)
+        return { ok: false, failure: header };
+    const state = envelope.state;
+    if (state === "ambiguous" || state === "unsupported") {
+        return {
+            ok: false,
+            failure: {
+                code: state === "ambiguous" ? "SEMANTIC_AMBIGUOUS" : "SEMANTIC_UNSUPPORTED",
+                message: envelope.reason ?? `la respuesta se declaró '${state}' sin explicar por qué`,
+                action: state === "ambiguous"
+                    ? "resolvé la ambigüedad y volvé a responder, o acotá la operación"
+                    : "la operación no aplica a este contenido: no hay nada que escribir",
+            },
+        };
+    }
+    const artifacts = checkArtifacts(envelope.artifacts, request);
+    if (!artifacts.ok)
+        return artifacts;
+    return {
+        ok: true,
+        value: {
+            version: SEMANTIC_PROTOCOL_VERSION,
+            operation: request.operation,
+            input_digest: request.input_digest,
+            state: "proposed",
+            ...(isRecord(envelope.decisions) ? { decisions: envelope.decisions } : {}),
+            artifacts: artifacts.value,
+        },
+    };
+}
+function parseJson(raw) {
+    if (raw.trim().length === 0) {
+        return {
+            ok: false,
+            failure: {
+                code: "SEMANTIC_RESPONSE_MISSING",
+                message: "no llegó respuesta semántica por stdin",
+                action: "volvé a invocar pasando el JSON de respuesta por stdin",
+            },
+        };
+    }
+    try {
+        return { ok: true, value: JSON.parse(raw) };
+    }
+    catch {
+        return {
+            ok: false,
+            failure: {
+                code: "SEMANTIC_RESPONSE_INVALID",
+                message: "la respuesta semántica no es JSON válido",
+                action: "reenviá la respuesta como un único objeto JSON completo",
+            },
+        };
+    }
+}
+function checkHeader(envelope, request) {
+    if (!isRecord(envelope)) {
+        return invalid("la respuesta no es un objeto JSON");
+    }
+    if (envelope.version !== SEMANTIC_PROTOCOL_VERSION) {
+        return invalid(`versión de protocolo no soportada: ${String(envelope.version)}`);
+    }
+    if (envelope.operation !== request.operation) {
+        return invalid(`la respuesta dice operación '${String(envelope.operation)}' y esta es '${request.operation}'`);
+    }
+    // The staleness seal: the world moved between prepare and this answer, so the
+    // inventory, the numbering and the duplicate check it reasoned over are gone.
+    if (envelope.input_digest !== request.input_digest) {
+        return {
+            code: "SEMANTIC_STALE",
+            message: "la respuesta responde a un estado anterior del workspace",
+            action: "volvé a correr prepare y respondé sobre el request nuevo",
+        };
+    }
+    const state = envelope.state;
+    if (state !== "proposed" && state !== "ambiguous" && state !== "unsupported") {
+        return invalid(`estado desconocido: ${String(state)}`);
+    }
+    return null;
+}
+function checkArtifacts(raw, request) {
+    if (!Array.isArray(raw) || raw.length === 0) {
+        return { ok: false, failure: invalid("una respuesta 'proposed' debe traer artifacts") };
+    }
+    if (raw.length > request.limits.max_artifacts) {
+        return {
+            ok: false,
+            failure: invalid(`${raw.length} artefactos exceden el máximo de ${request.limits.max_artifacts}`),
+        };
+    }
+    const seen = new Set();
+    const out = [];
+    for (const entry of raw) {
+        if (!isRecord(entry) || typeof entry.path !== "string" || typeof entry.content !== "string") {
+            return { ok: false, failure: invalid("cada artefacto necesita 'path' y 'content' de texto") };
+        }
+        const path = checkPath(entry.path, request.allowed_destinations);
+        if (!path.ok)
+            return path;
+        if (seen.has(path.value)) {
+            return { ok: false, failure: invalid(`el artefacto '${path.value}' viene repetido`) };
+        }
+        const bytes = Buffer.byteLength(entry.content, "utf8");
+        if (bytes > request.limits.max_artifact_bytes) {
+            return {
+                ok: false,
+                failure: invalid(`'${path.value}' pesa ${bytes} B y el máximo es ${request.limits.max_artifact_bytes} B`),
+            };
+        }
+        seen.add(path.value);
+        out.push({ path: path.value, content: entry.content });
+    }
+    return { ok: true, value: out };
+}
+/**
+ * A destination is only legal if it is workspace-relative and lands INSIDE one
+ * of the declared directories. Absolute paths, `..`, backslashes and bare
+ * prefix matches (`docs/specs-evil`) are all rejected — the allowlist is the
+ * write boundary, so it is checked on normalized segments, never on a string
+ * `startsWith`.
+ */
+function checkPath(raw, allowed) {
+    const path = raw.trim();
+    const reject = (why) => ({
+        ok: false,
+        failure: {
+            code: "SEMANTIC_PATH_REJECTED",
+            message: `destino no permitido ('${raw}'): ${why}`,
+            action: `escribí solo dentro de: ${allowed.join(", ")}`,
+        },
+    });
+    if (path.length === 0)
+        return reject("está vacío");
+    if (path.includes("\\"))
+        return reject("usa separador de Windows");
+    if (path.startsWith("/") || /^[A-Za-z]:/.test(path))
+        return reject("es absoluto");
+    const segments = path.split("/");
+    if (segments.some((s) => s === ".." || s === "." || s.length === 0)) {
+        return reject("contiene segmentos relativos o vacíos");
+    }
+    // A destination is either a directory to write INSIDE (persist, exports) or an
+    // exact file already identified as writable (fix-git's conflict set). Both are
+    // compared on segments, so `docs/research-evil` never passes as `docs/research`.
+    const inside = allowed.some((dest) => {
+        const destSegments = dest.split("/").filter((s) => s.length > 0);
+        if (segments.length < destSegments.length)
+            return false;
+        if (!destSegments.every((segment, i) => segments[i] === segment))
+            return false;
+        return segments.length > destSegments.length || path === dest;
+    });
+    if (!inside)
+        return reject("cae fuera de los destinos declarados");
+    return { ok: true, value: path };
+}
+/**
+ * Seal over the exact artifacts shown to the human. `apply` refuses anything
+ * whose digest differs, so what gets approved is what gets written — not a
+ * later edit of the same proposal.
+ */
+export function approvalDigest(response) {
+    return semanticDigest({
+        operation: response.operation,
+        input_digest: response.input_digest,
+        artifacts: (response.artifacts ?? []).map((a) => ({
+            path: a.path,
+            content_digest: semanticDigest(a.content),
+        })),
+    });
+}
+function invalid(message) {
+    return {
+        code: "SEMANTIC_RESPONSE_INVALID",
+        message,
+        action: "corregí la respuesta según el 'contract' del request y reenviala",
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=protocol.js.map

package/dist/application/semantic-operation/protocol.js.map

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

package/dist/application/semantic-operation/publish.js

@@ -0,0 +1,80 @@
+import { dirname, join } from "node:path";
+export async function publishArtifacts(fs, root, artifacts, options = {}) {
+    const done = [];
+    for (const artifact of artifacts) {
+        const absolute = join(root, artifact.path);
+        const failure = await writeOne(fs, absolute, artifact, options, done);
+        if (failure !== null) {
+            await rollback(fs, done);
+            return { ok: false, failure };
+        }
+    }
+    return { ok: true, value: { written: artifacts.map((a) => a.path) } };
+}
+async function writeOne(fs, absolute, artifact, options, done) {
+    try {
+        await fs.mkdirp(dirname(absolute));
+        const previous = await readPrevious(fs, absolute);
+        if (previous !== null && options.overwrite !== true) {
+            return {
+                code: "PUBLISH_TARGET_EXISTS",
+                message: `'${artifact.path}' ya existe y no se autorizó sobrescribir`,
+                action: "confirmá la sobrescritura explícitamente, o publicá en otro destino",
+            };
+        }
+        if (previous === null) {
+            // Exclusive create closes the check-then-write window: a concurrent run
+            // that got there first loses here, not silently.
+            const { created } = await fs.writeTextExclusive(absolute, artifact.content);
+            if (!created) {
+                return {
+                    code: "PUBLISH_TARGET_EXISTS",
+                    message: `'${artifact.path}' fue creado por otro proceso durante la publicación`,
+                    action: "volvé a correr prepare: el inventario y la numeración cambiaron",
+                };
+            }
+        }
+        else {
+            await fs.writeText(absolute, artifact.content);
+        }
+        done.push({ absolute, previous });
+        return null;
+    }
+    catch (err) {
+        return {
+            code: "PUBLISH_FAILED",
+            message: `no se pudo escribir '${artifact.path}': ${errorText(err)}`,
+            action: "revisá permisos y espacio en disco, y volvé a intentar",
+        };
+    }
+}
+async function readPrevious(fs, absolute) {
+    if (!(await fs.exists(absolute)))
+        return null;
+    try {
+        return await fs.readText(absolute);
+    }
+    catch {
+        // Unreadable but present: treat it as existing so we never clobber blindly,
+        // and as unrestorable so a rollback leaves it exactly as it was found.
+        return "";
+    }
+}
+/** Undo in reverse order, best effort — a failed undo must not mask the cause. */
+async function rollback(fs, done) {
+    for (const entry of [...done].reverse()) {
+        try {
+            if (entry.previous === null)
+                await fs.remove(entry.absolute);
+            else
+                await fs.writeText(entry.absolute, entry.previous);
+        }
+        catch {
+            // ignore; the original failure is what the caller reports
+        }
+    }
+}
+function errorText(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=publish.js.map

package/dist/application/semantic-operation/publish.js.map

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