@tacuchi/agent-workflow-cli 25.1.2 → 25.2.0

package/dist/application/doctor/prepare.js

@@ -0,0 +1,262 @@
+/**
+ * `prepare`: el lote exacto que una persona va a aprobar, sellado y sin escribir.
+ *
+ * Sigue el molde que `discard`, `reset` y `reseal` ya comparten, y por las mismas
+ * razones. El sello cubre TODO lo material —qué acciones, sobre qué recursos, en
+ * qué orden, con qué clases de efecto y contra qué estado leído—, así que
+ * cualquier cambio produce otro digest y un reintento idéntico no vuelve a
+ * preguntar. Y la vista previa se DERIVA del objeto sellado en vez de guardarse
+ * al lado: lo que se muestra y lo que se aplica tienen que salir de los mismos
+ * bytes, o la vista previa es una segunda descripción del cambio que puede
+ * discrepar con él.
+ *
+ * El `read_set` es el compare-and-swap: los archivos que se leyeron para decidir,
+ * con su digest. `apply` los relee, y si alguno se movió entre la vista previa y
+ * la aprobación, no aplica — porque el lote se armó sobre un estado que ya no
+ * está.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { SELF_AUTHORIZABLE_CLASSES } from "../../domain/capability/effects.js";
+import { doctorOperation } from "../../domain/doctor/operations.js";
+import { semanticDigest } from "../semantic-operation/protocol.js";
+import { runDoctor } from "./report.js";
+export async function prepareDoctorBatch(ctx, input = {}, deps = {}) {
+    const report = await runDoctor(ctx, input, deps);
+    const actionable = actionableOf(report);
+    const select = [...(input.select ?? [])];
+    if (select.length === 0)
+        return { ok: true, kind: "listing", listing: { actionable, report } };
+    const rejection = rejectSelection(select, report, actionable);
+    if (rejection !== null)
+        return { ok: false, rejection };
+    const chosen = actionable.filter((action) => select.includes(action.finding_id));
+    const ordered = topological(chosen);
+    if (ordered === null) {
+        return {
+            ok: false,
+            rejection: {
+                code: "SELECTION_CYCLE",
+                message: "las acciones seleccionadas dependen unas de otras en círculo",
+                candidates: chosen.map((action) => action.finding_id),
+                action: "quitá una de las acciones del ciclo y volvé a preparar",
+            },
+        };
+    }
+    const effects = effectsOf(ordered);
+    const batch = {
+        actions: ordered,
+        effects,
+        requires_approval: effects.filter((effect) => !SELF_AUTHORIZABLE_CLASSES.includes(effect)),
+    };
+    const readSet = readSetFor(ctx, ordered);
+    // El sello cubre el lote Y el estado leído, y NADA que no sea material: sin
+    // versión de CLI, sin marcas de tiempo, sin el informe entero. Dos corridas
+    // sobre el mismo estado tienen que sellar igual, o «un reintento idéntico no
+    // vuelve a preguntar» deja de ser cierto.
+    const digest = semanticDigest({ batch, read_set: readSet });
+    return {
+        ok: true,
+        kind: "sealed",
+        report,
+        proposal: {
+            digest,
+            batch,
+            read_set: readSet,
+            preview: previewOf(batch, readSet, digest),
+            next: `aw doctor apply --approval ${digest}${ordered
+                .map((action) => ` --select ${action.finding_id}`)
+                .join("")}`,
+        },
+    };
+}
+/** Los hallazgos que el anotador dejó con acción, como acciones del lote. */
+export function actionableOf(report) {
+    const actions = [];
+    for (const finding of report.findings) {
+        const action = finding.remediation.action;
+        if (finding.remediation.kind !== "supported" || action === null)
+            continue;
+        actions.push(toBatchAction(finding, action));
+    }
+    return actions;
+}
+function toBatchAction(finding, action) {
+    const spec = doctorOperation(action.op);
+    return {
+        finding_id: finding.id,
+        host: finding.host,
+        resource: finding.resource.name,
+        op: action.op,
+        args: { ...action.args },
+        effects: [...action.effects],
+        depends_on: [...action.depends_on],
+        expected: action.expected,
+        verb: spec === null ? action.op : spec.verb(action.args),
+        summary: spec === null ? finding.summary : spec.summary,
+        locator: finding.resource.locator,
+        ...(action.argv === undefined ? {} : { argv: [...action.argv] }),
+    };
+}
+/**
+ * Un id que no se puede seleccionar se rechaza NOMBRÁNDOLO, y antes de sellar.
+ *
+ * Las dos razones son distintas y la persona necesita la suya: el id no existe
+ * en este informe (se escribió mal, o el estado cambió y el hallazgo ya no está)
+ * o existe y no es accionable (es un recurso ajeno, o su remedio es manual). Un
+ * rechazo que sólo dijera «selección inválida» obligaría a adivinar cuál de las
+ * dos.
+ */
+function rejectSelection(select, report, actionable) {
+    const known = new Set(report.findings.map((finding) => finding.id));
+    const withAction = new Set(actionable.map((action) => action.finding_id));
+    const unknown = select.filter((id) => !known.has(id));
+    if (unknown.length > 0) {
+        return {
+            code: "SELECTION_UNKNOWN",
+            message: `este informe no tiene ${unknown.length === 1 ? "el hallazgo" : "los hallazgos"} ${unknown.join(", ")}`,
+            candidates: unknown,
+            action: "corré `aw doctor` y elegí un id de los que ese informe lista",
+        };
+    }
+    const inert = select.filter((id) => !withAction.has(id));
+    if (inert.length > 0) {
+        return {
+            code: "SELECTION_NOT_ACTIONABLE",
+            message: `${inert.join(", ")} no tiene una reparación automatizable: su remedio es manual o el recurso no es de Workline`,
+            candidates: inert,
+            action: "leé la guía de ese hallazgo en `aw doctor`; seleccionalo sólo si propone una acción",
+        };
+    }
+    return null;
+}
+/**
+ * Orden topológico estable, y `null` ante un ciclo.
+ *
+ * Estable porque el orden es parte del sello: dos corridas sobre la misma
+ * selección tienen que producir la misma secuencia, o el digest cambiaría sin
+ * que nada material cambie. Se recorre en el orden en que el informe ya venía
+ * —host, categoría, recurso— y una acción entra recién cuando entraron todas las
+ * que nombra.
+ */
+function topological(actions) {
+    const selected = new Set(actions.map((action) => action.finding_id));
+    const placed = new Set();
+    const ordered = [];
+    let pending = [...actions];
+    while (pending.length > 0) {
+        // Sólo cuentan las dependencias que están EN el lote: una acción que depende
+        // de algo que nadie seleccionó no puede esperarlo para siempre.
+        const ready = pending.filter((action) => action.depends_on.every((id) => !selected.has(id) || placed.has(id)));
+        if (ready.length === 0)
+            return null;
+        for (const action of ready) {
+            ordered.push(action);
+            placed.add(action.finding_id);
+        }
+        pending = pending.filter((action) => !placed.has(action.finding_id));
+    }
+    return ordered;
+}
+function effectsOf(actions) {
+    const classes = new Set();
+    for (const action of actions)
+        for (const effect of action.effects)
+            classes.add(effect);
+    return [...classes].sort((left, right) => (left < right ? -1 : left > right ? 1 : 0));
+}
+/**
+ * Lo que se leyó para decidir, con su digest: el compare-and-swap del lote.
+ *
+ * Se lee por `node:fs` y no por el puerto a propósito: son archivos de los
+ * HOSTS, fuera del workspace, que es donde el puerto vive. Un archivo ausente
+ * entra igual con el digest `absent`, porque «no estaba» es un estado del que
+ * también depende la decisión: si aparece entre la vista previa y la aprobación,
+ * el lote se armó sobre otra realidad.
+ */
+function readSetFor(ctx, actions) {
+    const paths = new Set();
+    // Por el servicio de rutas y no por un `join` propio: una segunda forma de
+    // decir dónde vive el registro es una que puede quedar apuntando a otro lado.
+    paths.add(ctx.paths.userMcpConnectionsFile());
+    for (const action of actions) {
+        for (const target of targetsOf(ctx, action))
+            paths.add(target);
+    }
+    return [...paths]
+        .sort((left, right) => (left < right ? -1 : left > right ? 1 : 0))
+        .map((path) => ({ id: path, digest: digestOf(path) }));
+}
+function targetsOf(ctx, action) {
+    const home = ctx.env.homeDir();
+    const workspace = ctx.paths.workspaceDir();
+    const scope = action.args.scope === "global" ? home : workspace;
+    switch (action.op) {
+        case "mcp.setup":
+        case "mcp.remove":
+        case "mcp.migrate":
+            return [
+                join(scope, ".mcp.json"),
+                join(scope, ".claude.json"),
+                join(scope, ".codex", "config.toml"),
+            ];
+        case "skills.reinstall":
+            return [join(home, ".agents", "skills")];
+        // Lo que se leyó para decidir que falta autenticar es el archivo que el
+        // SUJETO declaró, no una ruta por operación: el proveedor de conexiones —el
+        // dueño de `dsn.env`— declara `flow: null`, así que ninguna acción de flujo
+        // puede ser suya y cablear su archivo acá sellaría bytes ajenos al recurso.
+        // Un sujeto que no declara archivo no aporta ninguno: la otra mitad de su
+        // estado es el entorno del proceso, que no tiene bytes que sellar — y por eso
+        // una variable exportada entre la vista previa y la aprobación NO invalida el
+        // digest; lo que la ataja es que el recurso pasa a reportar sano y `apply`
+        // responde `already` en vez de correr un flujo que ya no hace falta.
+        case "auth.flow":
+            return action.locator === null ? [] : [action.locator];
+        case "multiroot.attach":
+        case "multiroot.detach":
+            return [join(scope, ".claude", "settings.local.json"), join(scope, ".codex", "config.toml")];
+        default:
+            return [join(home, ".claude", "settings.json")];
+    }
+}
+function digestOf(path) {
+    try {
+        return semanticDigest(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return "absent";
+    }
+}
+/**
+ * La vista previa, derivada del objeto sellado.
+ *
+ * Cada línea sale del lote: si el lote cambia, la vista previa cambia con él, y
+ * no hay forma de mostrar una cosa y aplicar otra. El digest va abajo porque es
+ * lo que la persona aprueba.
+ */
+function previewOf(batch, readSet, digest) {
+    const lines = [`${batch.actions.length} acción(es), en este orden:`];
+    batch.actions.forEach((action, index) => {
+        lines.push(`  ${index + 1}. ${action.summary} — ${action.resource} (${action.host})`);
+        lines.push(`     comando equivalente: ${action.verb}`);
+        // Los tokens exactos, cuando la acción corre un programa: aprobar sin verlos
+        // sería aprobar «un flujo», no ESTE flujo.
+        if (action.argv !== undefined) {
+            lines.push(`     se ejecutará, tal cual: ${action.argv.join(" ")}`);
+        }
+        lines.push(`     efectos: ${action.effects.join(", ")}`);
+        if (action.depends_on.length > 0) {
+            lines.push(`     después de: ${action.depends_on.join(", ")}`);
+        }
+        lines.push(`     estado esperado: ${action.expected}`);
+    });
+    lines.push(`efectos del lote: ${batch.effects.join(", ")}`);
+    lines.push(batch.requires_approval.length === 0
+        ? "nada de esto exige tu aprobación: todas las clases se autorizan solas"
+        : `lo que tu aprobación habilita: ${batch.requires_approval.join(", ")}`);
+    lines.push(`estado leído para decidir: ${readSet.length} archivo(s)`);
+    lines.push(`digest: ${digest}`);
+    return lines;
+}
+//# sourceMappingURL=prepare.js.map

package/dist/application/doctor/prepare.js.map

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

package/dist/application/doctor/provider-installation.js

@@ -0,0 +1,124 @@
+import { doctorFindingId } from "../../domain/doctor/model.js";
+/**
+ * Installation and hosts — `selfDoctor` plus the catalog's own state report.
+ *
+ * Nothing is re-derived. `reportAllHostStates` already decides `ready` /
+ * `installable` / `residual-config` and already writes the exact next command
+ * into `advice`; this provider translates that into the common model and hands
+ * the advice over as guidance rather than inventing a second phrasing of it.
+ */
+import { selfDoctor } from "../self/doctor-self.js";
+import { coverage } from "./types.js";
+const CATEGORY = "installation-hosts";
+export const installationProvider = {
+    category: CATEGORY,
+    async run(input) {
+        const report = await selfDoctor(input.ctx);
+        const targets = report.data?.skill.targets ?? [];
+        const findings = [];
+        for (const host of input.hosts) {
+            const state = input.hostStates.find((candidate) => candidate.host === host.host);
+            findings.push(hostFinding(host, state?.advice ?? null));
+            const target = targets.find((candidate) => candidate.target === host.target);
+            if (target !== undefined)
+                findings.push(...targetFindings(host, target));
+        }
+        return {
+            coverage: input.hosts.map((host) => coverage(CATEGORY, host.host, "checked")),
+            findings,
+        };
+    },
+};
+function hostFinding(host, advice) {
+    const evidence = [
+        `estado del host: ${host.status}`,
+        `runtime: ${host.runtime.state}${host.runtime.version === null ? "" : ` ${host.runtime.version}`}`,
+        `Workline instalado: ${host.workline_installed ? "sí" : "no"}`,
+    ];
+    const base = {
+        id: doctorFindingId(host.host, CATEGORY, "workline"),
+        host: host.host,
+        category: CATEGORY,
+        resource: { kind: "host", name: host.label, locator: host.target },
+        evidence,
+        ownership: "ours",
+    };
+    if (host.status === "ready") {
+        return {
+            ...base,
+            state: "healthy",
+            summary: `Workline está instalado en ${host.label} y su runtime responde`,
+            impact: "las capacidades de Workline se pueden invocar desde este host",
+            remediation: { kind: "none", action: null, guidance: [] },
+        };
+    }
+    const guidance = advice === null ? [] : [advice];
+    if (host.status === "installable") {
+        return {
+            ...base,
+            proposal: { op: "self.install-skill", args: { target: host.target } },
+            state: "warning",
+            summary: `${host.label} está en esta máquina y Workline no está instalado ahí`,
+            impact: "los comandos de Workline no existen en ese host hasta instalarlo",
+            remediation: { kind: "manual", action: null, guidance },
+        };
+    }
+    return {
+        ...base,
+        // Retirar lo residual y instalar el bundle no pueden coexistir para un mismo
+        // host: el catálogo declara un host `installable` O `residual-config`, nunca
+        // los dos, así que la exclusión es del estado y no una regla que haya que
+        // recordar acá.
+        proposal: { op: "self.uninstall", args: { target: host.target } },
+        state: "warning",
+        summary: `${host.label} dejó configuración sin un runtime que la use`,
+        impact: "la configuración residual puede confundir a otras herramientas que la lean",
+        remediation: { kind: "manual", action: null, guidance },
+    };
+}
+/**
+ * The two things `selfDoctor` observes per destination that a host state cannot.
+ *
+ * Both are warnings and neither is inferred from a counter: a leftover reported
+ * without its path, or a lock warning folded into the host's own state, is a
+ * finding whose resource nobody can locate.
+ */
+function targetFindings(host, target) {
+    const findings = [];
+    if (target.legacy_leftover === true) {
+        findings.push({
+            id: doctorFindingId(host.host, CATEGORY, "resto-legacy"),
+            host: host.host,
+            category: CATEGORY,
+            resource: {
+                kind: "bundle",
+                name: "resto legacy",
+                locator: target.legacy_leftover_path ?? target.path,
+            },
+            proposal: { op: "self.clean-legacy", args: { target: host.target } },
+            state: "warning",
+            summary: target.legacy_leftover_warning ?? "quedó un bundle de una instalación anterior",
+            impact: "el host puede cargar documentos viejos junto a los vigentes",
+            evidence: [`ruta observada: ${target.legacy_leftover_path ?? target.path}`],
+            ownership: "ours",
+            remediation: { kind: "manual", action: null, guidance: ["aw self clean-legacy"] },
+        });
+    }
+    if (target.lock_warning !== undefined) {
+        findings.push({
+            id: doctorFindingId(host.host, CATEGORY, "lock"),
+            host: host.host,
+            category: CATEGORY,
+            resource: { kind: "lock", name: "lock de skills", locator: target.path },
+            proposal: { op: "self.install-skill", args: { target: host.target } },
+            state: "warning",
+            summary: target.lock_warning,
+            impact: "el registro compartido de skills no describe lo que está instalado",
+            evidence: [`destino: ${target.path}`],
+            ownership: "ours",
+            remediation: { kind: "manual", action: null, guidance: ["aw self install-skill"] },
+        });
+    }
+    return findings;
+}
+//# sourceMappingURL=provider-installation.js.map

package/dist/application/doctor/provider-installation.js.map

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