@tacuchi/agent-workflow-cli 21.10.1 → 21.11.0

package/dist/application/workspace-migrate/plan.js

@@ -0,0 +1,171 @@
+/**
+ * What a hub with a legacy session series needs before it can be operated with
+ * the same commands as a new one — derived without writing a byte.
+ *
+ * Three things are broken in such a hub, and none of them announces itself:
+ * the project block wears markers of an older namespace and the CLI silently
+ * reads a second, empty one it appended itself; the sessions the record calls
+ * closed have no `.closed` sentinel on disk, so they show up as active forever;
+ * and the numbers of the legacy series live only in folder names, so they
+ * vanish from the record the day somebody archives the folders.
+ *
+ * This is a PUNCTUAL, explicit operation and not a reconciliation some other
+ * command performs on the side: it decides what to do by comparing two sources
+ * that may disagree, and a disagreement is answered by refusing to touch that
+ * session — never by picking the more convenient of the two.
+ */
+import { join } from "node:path";
+import { readHistoryRows } from "../history-table.js";
+import { resolveWorkspaceRootFrom } from "../paths-service.js";
+import { CLOSED_MARKER, buildSessionEntry, listSessionFolders, nextSessionCorrelative, parseSessionFolder, sessionNumericCode, sessionsSharingNumber, } from "../session-resolver.js";
+import { planHubMarkers, readHubFiles, } from "./markers.js";
+/** How many writes the plan holds. Zero means the workspace is already current. */
+export function pendingChanges(plan) {
+    return plan.markers.length + plan.sentinels.length + plan.rows.length;
+}
+export async function planWorkspaceMigration(fs, paths) {
+    const workspace = await resolveWorkspaceRootFrom(fs, paths);
+    const markers = planMarkers(await readHubFiles(fs, workspace), paths.blockMarkers());
+    const recorded = await readRecord(fs, paths);
+    const sentinels = [];
+    const rows = [];
+    const conflicts = [...markers.conflicts];
+    const legacy = [];
+    for (const folder of await listSessionFolders(fs, paths.cwdSessionsDir())) {
+        const number = legacyNumber(folder.name);
+        if (number === null)
+            continue; // current-model folder: nothing legacy about it
+        legacy.push(folder.name);
+        const outcome = await planSession(fs, paths, folder, number, recorded.get(number));
+        if (outcome.kind === "sentinel")
+            sentinels.push(outcome.seed);
+        if (outcome.kind === "row")
+            rows.push(outcome.seed);
+        if (outcome.kind === "conflict")
+            conflicts.push(outcome.conflict);
+    }
+    return {
+        workspace,
+        markers: markers.rewrites,
+        sentinels,
+        rows,
+        conflicts,
+        legacy,
+        next_correlative: await nextSessionCorrelative(fs, paths),
+    };
+}
+function planMarkers(hubs, current) {
+    const rewrites = [];
+    const conflicts = [];
+    for (const hub of hubs) {
+        const outcome = planHubMarkers(hub.path, hub.text, current);
+        if (outcome.kind === "rewrite")
+            rewrites.push(outcome.rewrite);
+        if (outcome.kind === "refused") {
+            conflicts.push({
+                subject: hub.path,
+                reason: outcome.refusal.reason,
+                detail: outcome.refusal.detail,
+            });
+        }
+    }
+    return { rewrites, conflicts };
+}
+/**
+ * What one legacy session needs, given what the record says about its number.
+ *
+ * The rule that makes seeding a sentinel safe is the LAYOUT: a `sessionNNN-`
+ * folder predates the sentinel model entirely, so the file's absence there is
+ * the absence of the model and not a statement about the session. In a
+ * current-model folder that same absence MEANS active — `session-resume
+ * --reopen` produces exactly it, on purpose — and writing the sentinel back
+ * would re-close a session somebody had just reopened. That is why this walks
+ * the legacy series and nothing else.
+ */
+async function planSession(fs, paths, folder, number, row) {
+    // The record is indexed by number, so a number two folders answer to has ONE
+    // row for TWO sessions: whichever we wrote, we would be writing about the
+    // other one too.
+    const sharing = await sessionsSharingNumber(fs, paths, folder.name);
+    if (sharing.length > 1) {
+        const folders = sharing.map((candidate) => candidate.folder).join(", ");
+        return conflictOf(folder.name, "numero_compartido", `el número ${number} lo comparten ${sharing.length} carpetas (${folders}) y el registro se indexa por número: renombrá la legacy al modelo actual (\`NNN-<slug>\`) y reintentá`);
+    }
+    const entry = await buildSessionEntry(fs, folder.path, folder.name);
+    if (row === undefined) {
+        return {
+            kind: "row",
+            seed: {
+                folder: folder.name,
+                code: entry.code ?? folder.name,
+                name: entry.name,
+                state: entry.state,
+                date: entry.date ?? null,
+            },
+        };
+    }
+    const recorded = recordedState(row.state);
+    if (recorded === null) {
+        return conflictOf(folder.name, "estado_ilegible", `la fila del histórico dice '${row.state}', que no es ni 'active' ni 'closed': corregila a mano y reintentá`);
+    }
+    if (recorded === entry.state)
+        return { kind: "coherente" };
+    if (recorded === "active") {
+        return conflictOf(folder.name, "estado_divergente", "el histórico la da por activa y la carpeta ya tiene su centinela `.closed`: cuál de las dos quedó atrás no se adivina");
+    }
+    return {
+        kind: "sentinel",
+        seed: { folder: folder.name, path: folder.path, date: row.date },
+    };
+}
+function conflictOf(subject, reason, detail) {
+    return { kind: "conflict", conflict: { subject, reason, detail } };
+}
+/** Where the sentinel of a session goes. */
+export function sentinelPath(seed) {
+    return join(seed.path, CLOSED_MARKER);
+}
+/**
+ * The record, indexed by NUMBER — the key it is actually written with.
+ *
+ * Compared as numbers and not as strings for the same reason the upsert does
+ * it: `47` and `047` are one session, and `100` is not `1000`.
+ */
+async function readRecord(fs, paths) {
+    const path = paths.cwdHistoryFile();
+    const byNumber = new Map();
+    if (!(await fs.exists(path)))
+        return byNumber;
+    for (const row of readHistoryRows(await fs.readText(path))) {
+        // The SAME reading of "what number does this carry" the resolver and the
+        // correlative use: `session047-x`, `047-x` and a bare `047` are one session.
+        const digits = sessionNumericCode(row.key);
+        if (digits !== null)
+            byNumber.set(Number.parseInt(digits, 10), row);
+    }
+    return byNumber;
+}
+/**
+ * The number a LEGACY folder carries, or `null` when the folder is not one.
+ *
+ * `parseSessionFolder` is the canonical reading of a folder's identity and it
+ * answers this without another regex: for the current model it hands back the
+ * WHOLE folder name as the code, and only the `sessionNNN-<slug>` layout splits
+ * a number off.
+ */
+function legacyNumber(folder) {
+    const { code } = parseSessionFolder(folder);
+    if (code === null || code === folder)
+        return null;
+    const parsed = Number.parseInt(code, 10);
+    return Number.isNaN(parsed) ? null : parsed;
+}
+function recordedState(cell) {
+    const value = cell.trim().toLowerCase();
+    if (value === "closed")
+        return "closed";
+    if (value === "active")
+        return "active";
+    return null;
+}
+//# sourceMappingURL=plan.js.map

package/dist/application/workspace-migrate/plan.js.map

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

package/dist/application/workspace-migrate/preview.js

@@ -0,0 +1,111 @@
+/**
+ * The projection of the plan a caller gets to see — and the same one, in prose,
+ * that a person reads before approving it.
+ *
+ * The rewritten bytes of each hub file stay OUT of it: the payload is what the
+ * migration will do, not the file it will produce, and a JSON consumer that had
+ * to diff two whole documents to learn "the markers get renamed" would be
+ * reading an implementation detail as if it were the answer.
+ */
+import { relpath } from "../paths.js";
+import { pendingChanges } from "./plan.js";
+export function migrationPreview(plan) {
+    return {
+        workspace: plan.workspace,
+        markers: plan.markers.map((hub) => ({
+            file: relpath(hub.path, plan.workspace),
+            from: hub.from,
+            to: hub.to,
+            drops_duplicate: hub.drops_duplicate,
+        })),
+        sentinels: plan.sentinels.map((seed) => ({ folder: seed.folder, date: seed.date })),
+        rows: plan.rows.map((seed) => ({
+            folder: seed.folder,
+            state: seed.state,
+            date: seed.date,
+        })),
+        conflicts: plan.conflicts.map((conflict) => ({
+            ...conflict,
+            subject: relpath(conflict.subject, plan.workspace),
+        })),
+        legacy: plan.legacy,
+        next_correlative: plan.next_correlative,
+        pending: pendingChanges(plan),
+    };
+}
+export function renderMigrationPreview(preview) {
+    const lines = [
+        `Workspace: ${preview.workspace}`,
+        `Serie legacy: ${countOf(preview.legacy.length, "carpeta", "carpetas")} · próximo correlativo: ${preview.next_correlative}`,
+    ];
+    if (preview.markers.length > 0) {
+        lines.push("", "Marcadores del bloque de proyecto:");
+        for (const marker of preview.markers) {
+            const duplicate = marker.drops_duplicate
+                ? " (y elimina el bloque vacío que el CLI había agregado aparte)"
+                : "";
+            lines.push(`  ${marker.file} — ${marker.from} → ${marker.to}${duplicate}`);
+        }
+    }
+    if (preview.sentinels.length > 0) {
+        lines.push("", "Centinelas de cierre a sembrar, con la fecha del histórico:");
+        for (const sentinel of preview.sentinels) {
+            lines.push(`  ${sentinel.folder} — cerrada el ${sentinel.date || "(fila sin fecha)"}`);
+        }
+    }
+    if (preview.rows.length > 0) {
+        lines.push("", "Filas a reservar en el histórico, para que el número no se reasigne:");
+        for (const row of preview.rows) {
+            lines.push(`  ${row.folder} — ${row.state}, ${dateNote(row.date)}`);
+        }
+    }
+    if (preview.pending === 0) {
+        lines.push("", "Nada que migrar: el workspace ya opera con el modelo actual.");
+    }
+    lines.push(...conflictLines(preview.conflicts));
+    if (preview.pending > 0) {
+        lines.push("", "Para aplicarlo:", "  aw workspace-migrate --apply");
+    }
+    return lines.join("\n");
+}
+export function renderMigrationApplied(applied) {
+    const lines = [`Workspace migrado: ${applied.workspace}`];
+    if (applied.markers_renamed.length > 0) {
+        const files = applied.markers_renamed.map((path) => relpath(path, applied.workspace));
+        lines.push(`Marcadores renombrados: ${files.join(", ")}`);
+    }
+    if (applied.duplicates_dropped.length > 0) {
+        const files = applied.duplicates_dropped.map((path) => relpath(path, applied.workspace));
+        lines.push(`Bloques duplicados eliminados: ${files.join(", ")}`);
+    }
+    if (applied.sentinels_seeded.length > 0) {
+        lines.push(`Centinelas sembrados: ${applied.sentinels_seeded.join(", ")}`);
+    }
+    if (applied.rows_seeded.length > 0) {
+        lines.push(`Filas reservadas: ${applied.rows_seeded.join(", ")}`);
+    }
+    if (applied.rows_dated_today.length > 0) {
+        lines.push(`Sin fecha declarada — su fila nació con la de hoy: ${applied.rows_dated_today.join(", ")}`);
+    }
+    if (lines.length === 1)
+        lines.push("No había nada que migrar.");
+    lines.push(`Próximo correlativo: ${applied.next_correlative}`);
+    lines.push(...conflictLines(applied.conflicts));
+    return lines.join("\n");
+}
+function conflictLines(conflicts) {
+    if (conflicts.length === 0)
+        return [];
+    const lines = ["", "Sin tocar, porque el histórico y el disco no dicen lo mismo:"];
+    for (const conflict of conflicts) {
+        lines.push(`  ${conflict.subject} [${conflict.reason}] — ${conflict.detail}`);
+    }
+    return lines;
+}
+function dateNote(date) {
+    return date === null ? "sin fecha declarada: la fila nace con la de hoy" : date;
+}
+function countOf(total, singular, plural) {
+    return `${total} ${total === 1 ? singular : plural}`;
+}
+//# sourceMappingURL=preview.js.map

package/dist/application/workspace-migrate/preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../../../src/application/workspace-migrate/preview.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAuD,cAAc,EAAE,MAAM,WAAW,CAAC;AAkChG,MAAM,UAAU,gBAAgB,CAAC,IAA4B;IAC3D,OAAO;QACL,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAClC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;YACvC,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,eAAe,EAAE,GAAG,CAAC,eAAe;SACrC,CAAC,CAAC;QACH,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACnF,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;QACH,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC3C,GAAG,QAAQ;YACX,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;SACnD,CAAC,CAAC;QACH,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,OAAO,EAAE,cAAc,CAAC,IAAI,CAAC;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAkC;IACvE,MAAM,KAAK,GAAG;QACZ,cAAc,OAAO,CAAC,SAAS,EAAE;QACjC,iBAAiB,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,2BAA2B,OAAO,CAAC,gBAAgB,EAAE;KAC5H,CAAC;IAEF,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,oCAAoC,CAAC,CAAC;QACrD,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACrC,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe;gBACtC,CAAC,CAAC,+DAA+D;gBACjE,CAAC,CAAC,EAAE,CAAC;YACP,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,IAAI,MAAM,MAAM,CAAC,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,6DAA6D,CAAC,CAAC;QAC9E,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,MAAM,iBAAiB,QAAQ,CAAC,IAAI,IAAI,kBAAkB,EAAE,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,sEAAsE,CAAC,CAAC;QACvF,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,MAAM,MAAM,GAAG,CAAC,KAAK,KAAK,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,8DAA8D,CAAC,CAAC;IACjF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAChD,IAAI,OAAO,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,iBAAiB,EAAE,gCAAgC,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAkC;IACvE,MAAM,KAAK,GAAG,CAAC,sBAAsB,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC1D,IAAI,OAAO,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QACtF,KAAK,CAAC,IAAI,CAAC,2BAA2B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,OAAO,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;QACzF,KAAK,CAAC,IAAI,CAAC,kCAAkC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,OAAO,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CAAC,yBAAyB,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,qBAAqB,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,OAAO,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,KAAK,CAAC,IAAI,CACR,sDAAsD,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5F,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAChE,KAAK,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC/D,KAAK,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,aAAa,CAAC,SAAuC;IAC5D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,8DAA8D,CAAC,CAAC;IACnF,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,QAAQ,CAAC,IAAmB;IACnC,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,iDAAiD,CAAC,CAAC,CAAC,IAAI,CAAC;AAClF,CAAC;AAED,SAAS,OAAO,CAAC,KAAa,EAAE,QAAgB,EAAE,MAAc;IAC9D,OAAO,GAAG,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;AACvD,CAAC"}

package/dist/cli/commands/unknown-flags.js

@@ -0,0 +1,51 @@
+/**
+ * Flags every command tolerates because the RUNTIME reads them, not the
+ * command: namespace resolution, output projection and help. `-h` never gets
+ * this far (main.ts prints help before dispatching) and is listed anyway, so
+ * the set answers for itself instead of relying on the caller's order.
+ */
+const RUNTIME_FLAGS = new Set([
+    "namespace",
+    "format",
+    "json",
+    "detail",
+    "help",
+    "version",
+    "h",
+]);
+/**
+ * Every flag the invocation carried, whichever map the parser routed it to.
+ *
+ * A flag with a value lands in `values` (or `valuesMulti`), a bare one in
+ * `flags` as `--name`; reading only one of the three is how an unknown flag
+ * stays invisible depending on whether the caller gave it a value.
+ */
+function passedFlags(args) {
+    const names = new Set();
+    for (const name of args.values.keys())
+        names.add(name);
+    for (const name of args.valuesMulti.keys())
+        names.add(name);
+    for (const token of args.flags)
+        names.add(token.replace(/^--?/, ""));
+    return [...names];
+}
+export function reviewFlags(args, contract) {
+    const known = new Set(contract.known);
+    const retired = new Set(contract.retired ?? []);
+    const review = { unknown: [], retired: [] };
+    for (const name of passedFlags(args)) {
+        if (known.has(name) || RUNTIME_FLAGS.has(name))
+            continue;
+        (retired.has(name) ? review.retired : review.unknown).push(`--${name}`);
+    }
+    review.unknown.sort();
+    review.retired.sort();
+    return review;
+}
+/** The refusal message, naming what the command does accept. */
+export function unknownFlagMessage(review, contract) {
+    const accepted = [...contract.known].sort().map((name) => `--${name}`);
+    return `${review.unknown.join(", ")} no ${review.unknown.length === 1 ? "es un flag" : "son flags"} de este comando; acepta ${accepted.join(", ")}`;
+}
+//# sourceMappingURL=unknown-flags.js.map

package/dist/cli/commands/unknown-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknown-flags.js","sourceRoot":"","sources":["../../../src/cli/commands/unknown-flags.ts"],"names":[],"mappings":"AA0BA;;;;;GAKG;AACH,MAAM,aAAa,GAAwB,IAAI,GAAG,CAAC;IACjD,WAAW;IACX,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,MAAM;IACN,SAAS;IACT,GAAG;CACJ,CAAC,CAAC;AASH;;;;;;GAMG;AACH,SAAS,WAAW,CAAC,IAAgB;IACnC,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5D,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK;QAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAgB,EAAE,QAAsB;IAClE,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,MAAM,GAAe,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACxD,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QACzD,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACtB,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACtB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,kBAAkB,CAAC,MAAkB,EAAE,QAAsB;IAC3E,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IACvE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,4BAA4B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACtJ,CAAC"}

package/dist/cli/commands/visibility.js

@@ -1,14 +1,26 @@
-import { runVisibilityDoctor } from "../../application/visibility-doctor-service.js";
+import { runVisibilityDoctor, } from "../../application/visibility-doctor-service.js";
 import { fail } from "../render.js";
 export const visibilityCommand = {
     name: "visibility",
-    describe: "Inspector de visibilidad multi-root del hub. Subcomandos: doctor [--workspace dir] [--global] [--json].",
+    describe: "Inspector de visibilidad multi-root del hub. Subcomandos: doctor [--workspace dir] [--global] " +
+        "[--format human|json] [--detail].",
     async execute(args, ctx) {
         const subcommand = args.rest[0];
         if (subcommand === "doctor")
             return runDoctorSub(args, ctx);
         return fail("INVALID_INPUT", "visibility requiere subcomando: doctor");
     },
+    /**
+     * The human projection of the SAME result the JSON carries: one line per host
+     * with its verdict and the file(s) the verdict was read from, plus the paths
+     * that are missing or left over. It re-derives nothing.
+     */
+    renderHuman(result, context) {
+        const data = result.data;
+        if (data === undefined)
+            return "";
+        return renderDoctor(data, context.detail);
+    },
 };
 async function runDoctorSub(args, ctx) {
     const workspace = args.values.get("workspace");
@@ -18,19 +30,96 @@ async function runDoctorSub(args, ctx) {
     });
     const totalReports = data.reports.length + data.global_reports.length;
     const okCount = data.summary.ok;
-    const allOk = okCount === totalReports;
-    return {
-        ok: allOk,
-        data,
-        ...(allOk
-            ? {}
-            : {
-                error: {
-                    code: "VISIBILITY_DRIFT",
-                    message: `${totalReports - okCount}/${totalReports} reports con drift (ver data.reports/global_reports)`,
-                },
-            }),
-        exitCode: allOk ? 0 : 1,
-    };
+    if (okCount === totalReports)
+        return { ok: true, data, exitCode: 0 };
+    // Drift stays `ok:false` (exit 1 is the contract scripts already gate on), and
+    // the host renders `ok:false` ONLY through the failure projection — so the
+    // report travels in `action`, or `--format human` would print a bare count in
+    // exactly the case the person needs the per-host diagnosis.
+    return fail("VISIBILITY_DRIFT", `${totalReports - okCount}/${totalReports} reports con drift (ver data.reports/global_reports)`, {
+        ...data,
+        // `--detail` is read HERE and not in the renderer because the failure
+        // projection never reaches `renderHuman` — and detail is precisely what
+        // the person asked for in the only case that prints this text.
+        action: `revisá el drift host por host:\n\n${renderDoctor(data, args.flags.has("--detail"))}`,
+    });
+}
+const STATUS_MARK = {
+    ok: "✓",
+    "missing-paths": "✗",
+    "extra-paths": "✗",
+    "no-settings": "✗",
+    "no-project-block": "✗",
+    "global-pollution": "✗",
+};
+/**
+ * Statuses whose `detail` only restates the line it would sit under: `ok` is the
+ * line itself, and missing/extra already print the paths one by one. Every other
+ * status prints no list, so its `detail` is the only thing that explains it.
+ */
+const REDUNDANT_DETAIL = new Set([
+    "ok",
+    "missing-paths",
+    "extra-paths",
+]);
+const STATUS_WIDTH = Math.max(...Object.keys(STATUS_MARK).map((s) => s.length));
+function renderDoctor(data, detail) {
+    const lines = [`Visibilidad multi-root · ${data.workspace_dir}`, ""];
+    lines.push(...renderScope("workspace", data.reports, detail));
+    if (data.global_reports.length > 0) {
+        lines.push("", ...renderScope("global", data.global_reports, detail));
+    }
+    const total = data.reports.length + data.global_reports.length;
+    lines.push("", `${data.summary.ok}/${total} host(s) sin drift`);
+    lines.push(...renderFixes([...data.reports, ...data.global_reports]));
+    return `${lines.join("\n").trimEnd()}\n`;
+}
+function renderScope(title, reports, detail) {
+    if (reports.length === 0)
+        return [];
+    const hostWidth = Math.max(...reports.map((r) => r.host.length));
+    const lines = [title];
+    for (const report of reports) {
+        const head = `${report.host.padEnd(hostWidth)}  ${report.status.padEnd(STATUS_WIDTH)}`;
+        // The file(s) the verdict was actually read from — never a hardcoded name.
+        lines.push(`  ${STATUS_MARK[report.status]} ${head}  ${report.targets.join(" + ")}`);
+        if (report.missing.length > 0)
+            lines.push(`      faltan: ${report.missing.join(", ")}`);
+        if (report.extra.length > 0)
+            lines.push(`      sobran: ${report.extra.join(", ")}`);
+        if (report.detail !== undefined && (detail || !REDUNDANT_DETAIL.has(report.status))) {
+            lines.push(`      ${report.detail}`);
+        }
+        if (detail && report.declared_paths.length > 0) {
+            lines.push(`      declarados: ${report.declared_paths.join(", ")}`);
+            lines.push(`      registrados: ${report.registered_paths.join(", ") || "(ninguno)"}`);
+        }
+    }
+    return lines;
+}
+/**
+ * One command per kind of drift present — never advice for drift nobody has.
+ *
+ * The trigger is the LIST, not the status: `status` reports only the most severe
+ * drift, so a host with paths missing AND left over would otherwise print
+ * `sobran:` above and no command to remove them.
+ */
+function renderFixes(reports) {
+    const fixes = [];
+    if (reports.some((r) => r.missing.length > 0)) {
+        fixes.push("  aw attach-multiroot --from-sources          registra las fuentes que faltan");
+    }
+    // Global leftovers are the hub's own sources leaking into ~/: a different
+    // command, and `--path` on the workspace scope would not touch them.
+    if (reports.some((r) => r.scope === "workspace" && r.extra.length > 0)) {
+        fixes.push("  aw detach-multiroot --path <dir>            quita las rutas que sobran");
+    }
+    if (reports.some((r) => r.status === "global-pollution")) {
+        fixes.push("  aw detach-multiroot --global --from-sources limpia el scope global");
+    }
+    if (reports.some((r) => r.status === "no-project-block")) {
+        fixes.push("  aw workspace-init --source <alias>:<path>   declara las fuentes del workspace");
+    }
+    return fixes.length === 0 ? [] : ["", "Para corregir:", ...fixes];
 }
 //# sourceMappingURL=visibility.js.map

package/dist/cli/commands/visibility.js.map

@@ -1 +1 @@
-{"version":3,"file":"visibility.js","sourceRoot":"","sources":["../../../src/cli/commands/visibility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAIrF,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAGpC,MAAM,CAAC,MAAM,iBAAiB,GAAe;IAC3C,IAAI,EAAE,YAAY;IAClB,QAAQ,EACN,yGAAyG;IAC3G,KAAK,CAAC,OAAO,CAAC,IAAgB,EAAE,GAAe;QAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,UAAU,KAAK,QAAQ;YAAE,OAAO,YAAY,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC,eAAe,EAAE,wCAAwC,CAAC,CAAC;IACzE,CAAC;CACF,CAAC;AAEF,KAAK,UAAU,YAAY,CAAC,IAAgB,EAAE,GAAe;IAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE;QACjE,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;KACnC,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;IACtE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,OAAO,KAAK,YAAY,CAAC;IACvC,OAAO;QACL,EAAE,EAAE,KAAK;QACT,IAAI;QACJ,GAAG,CAAC,KAAK;YACP,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,KAAK,EAAE;oBACL,IAAI,EAAE,kBAAkB;oBACxB,OAAO,EAAE,GAAG,YAAY,GAAG,OAAO,IAAI,YAAY,sDAAsD;iBACzG;aACF,CAAC;QACN,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KACxB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"visibility.js","sourceRoot":"","sources":["../../../src/cli/commands/visibility.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/workspace-migrate.js

@@ -0,0 +1,70 @@
+/**
+ * `aw workspace-migrate`: bring a hub that carries a legacy session series up to
+ * the model the rest of the CLI operates.
+ *
+ * Read-only by default and explicit by design. It is a PUNCTUAL operation, not
+ * a reconciliation another command performs on the side: it decides by
+ * comparing the durable record against the disk, the two can disagree, and a
+ * disagreement is answered by leaving that session exactly as it was and saying
+ * so. Nothing is written until somebody types `--apply`, and what gets written
+ * is re-derived under the workspace lock at that moment.
+ */
+import { applyWorkspaceMigration, } from "../../application/workspace-migrate/apply.js";
+import { planWorkspaceMigration } from "../../application/workspace-migrate/plan.js";
+import { migrationPreview, renderMigrationApplied, renderMigrationPreview, } from "../../application/workspace-migrate/preview.js";
+import { failSemantic } from "../render.js";
+import { reviewFlags, unknownFlagMessage } from "./unknown-flags.js";
+// A command born today has no caller that ever passed it a flag of more, so
+// there is nothing to break by refusing one — which is why the rejection can be
+// total here and had to be scoped elsewhere.
+const FLAGS = { known: ["apply"] };
+export const workspaceMigrateCommand = {
+    name: "workspace-migrate",
+    describe: "Pone al día un workspace con serie legacy: renombra los marcadores del bloque de proyecto al namespace vigente, " +
+        "siembra los centinelas de cierre que el histórico ya declara y reserva los números legacy en el registro durable. " +
+        "Sin --apply no escribe nada: muestra qué va a pasar. Una sesión sobre la que el histórico y el disco se contradicen " +
+        "queda intacta y se reporta. Usage: aw workspace-migrate [--apply].",
+    async execute(args, ctx) {
+        const review = reviewFlags(args, FLAGS);
+        if (review.unknown.length > 0) {
+            return failSemantic({
+                code: "UNKNOWN_FLAG",
+                message: unknownFlagMessage(review, FLAGS),
+                action: "corregí el flag y reintentá: `aw workspace-migrate [--apply]`",
+            });
+        }
+        if (!args.flags.has("--apply")) {
+            const plan = await planWorkspaceMigration(ctx.fs, ctx.paths);
+            return {
+                ok: true,
+                data: {
+                    action: "preview",
+                    ...migrationPreview(plan),
+                    next: "aw workspace-migrate --apply",
+                },
+                exitCode: 0,
+            };
+        }
+        const applied = await applyWorkspaceMigration(ctx.fs, ctx.paths);
+        if ("error" in applied) {
+            return failSemantic({
+                code: "LOCK_BUSY",
+                message: applied.error,
+                action: "esperá a que termine la operación en curso y reintentá",
+            });
+        }
+        return { ok: true, data: { action: "apply", ...applied }, exitCode: 0 };
+    },
+    renderHuman(result, context) {
+        if (!result.ok || result.data === undefined)
+            return "";
+        const data = result.data;
+        const lines = data.action === "apply" ? [renderMigrationApplied(data)] : [renderMigrationPreview(data)];
+        if (context.detail && data.action === "preview") {
+            lines.push("", `Serie legacy: ${data.legacy.join(", ") || "(ninguna)"}`);
+        }
+        // The writer emits this verbatim, so the trailing newline belongs here.
+        return `${lines.join("\n").trimEnd()}\n`;
+    },
+};
+//# sourceMappingURL=workspace-migrate.js.map

package/dist/cli/commands/workspace-migrate.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tacuchi/agent-workflow-cli",
-  "version": "21.10.1",
+  "version": "21.11.0",
   "description": "Runtime CLI for Workline — the stages + loops + artifacts system for agent work. Bundles the universal `w` skill set under `skills/w/` (slash commands `/w:*`: spec-new/spec-refine, plan-new/plan-exec, quick, persist, workspace-init, export-*); `self install --target <host>` copies SKILL + commands + hooks into the host. Pluggable capability skills via `.workflow/skills.toml`. Multi-empresa parametrization via `profile.json` cascade. Namespace auto-detected from any `.<ns>/sessions/` dir in CWD; default `workflow`.",
   "type": "module",
   "bin": {