fanout-cli 0.7.0

package/dist/unfinished.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unfinished.d.ts","sourceRoot":"","sources":["../src/unfinished.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,UAAU,EAAE,KAAK,WAAW,EAA+B,MAAM,aAAa,CAAC;AAc7G,oEAAoE;AACpE,MAAM,WAAW,OAAO;IACtB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,OAAO,EAAE,UAAU,GAAG,SAAS,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAuBjD;AAED,MAAM,WAAW,IAAI;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,GAAG,IAAI,EAAE,CA8BnE;AAOD,kGAAkG;AAClG,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,IAAI,EAAE,EAAE,GAAG,SAAK,GAAG,MAAM,CAcxE"}

package/dist/unfinished.js

@@ -0,0 +1,84 @@
+import { mergeReadiness } from "fanout-core";
+/**
+ * What to say about the lead's own changes.
+ *
+ * The runs a crew produced are the obvious thing to guard, and they are not where most of a session's code comes
+ * from: the lead writes it, and the lead is its only reader. A check nobody is reminded of is a check nobody runs,
+ * which is why this asks about the working tree and not only about the mission.
+ */
+export function ownWorkOwed(work) {
+    if (work.files === 0)
+        return "";
+    const changed = `${String(work.files)} changed file${work.files === 1 ? "" : "s"}`;
+    if (work.checked === undefined) {
+        return `  ${changed}, and nobody but you has read them. Try: fanout check "<something you believe>"`;
+    }
+    if (work.checked.revision !== work.revision) {
+        // A check of older bytes is not a check of these ones, and saying "checked" here would be the lie.
+        return `  ${changed}, and they have moved since the last check. Run it again.`;
+    }
+    if (!work.checked.ran) {
+        return `  ${changed}, and the last check could not run at all.`;
+    }
+    const refuted = work.checked.claims.filter((claim) => claim.verdict === "refuted");
+    if (refuted.length > 0) {
+        return [
+            `  ${String(refuted.length)} of your own claims was refuted and is not fixed:`,
+            ...refuted.map((claim) => `    ✗ ${claim.claim}\n      ${claim.evidence}`),
+        ].join("\n");
+    }
+    return "";
+}
+/**
+ * Every run that is waiting on the lead: finished agents nobody has reviewed, checks nobody has run, fixes with
+ * no proof, work reviewed at a revision that has since moved.
+ *
+ * Runs still working are deliberately not here. They are not owed by anyone; they are simply not done, and the
+ * mission view says so already.
+ */
+export function whatIsOwed(missions) {
+    const owed = [];
+    for (const mission of missions) {
+        const lines = new Map((mission.plan?.lines ?? []).map((line) => [line.id, line]));
+        for (const runId of mission.runOrder) {
+            const run = mission.runs[runId];
+            if (run === undefined || !waitingOnTheLead(run))
+                continue;
+            const line = lines.get(run.lineId);
+            if (line === undefined) {
+                owed.push({ missionId: mission.missionId, runId, what: "finished, but its plan line is missing" });
+                continue;
+            }
+            /*
+             * The run's own recorded revision is the best we can do from the ledger alone: a hook must not go and read
+             * the worktree, because it runs on every turn and must stay fast. Asking readiness about the revision the
+             * review saw answers "is anything missing", which is the hook's question — "has the work moved since" is
+             * the merge tool's, and it recollects the diff to find out.
+             */
+            const judged = run.review?.revision ?? run.checks?.revision ?? run.approval?.revision ?? "";
+            const { blockers } = mergeReadiness(run, line, judged);
+            const first = blockers[0];
+            if (first !== undefined)
+                owed.push({ missionId: mission.missionId, runId, what: first.message });
+        }
+    }
+    return owed;
+}
+/** A run the agent has finished with, that has not yet been merged, dropped or run into a conflict. */
+function waitingOnTheLead(run) {
+    return run.status === "done";
+}
+/** The hook's whole output. Empty string when nothing is owed, so a quiet session stays quiet. */
+export function unfinishedReport(owed, own = "") {
+    const parts = [];
+    if (owed.length > 0) {
+        const lines = owed.map((item) => `  ${item.missionId} · ${item.runId}: ${item.what}`);
+        const count = `${String(owed.length)} run${owed.length === 1 ? "" : "s"}`;
+        parts.push(`${count} still waiting on you before anything can merge.\n${lines.join("\n")}\n` +
+            `Nothing has been merged. Review them, or drop them on purpose.`);
+    }
+    if (own !== "")
+        parts.push(`Your own changes:\n${own}`);
+    return parts.length === 0 ? "" : `Fanout: ${parts.join("\n\n")}\n`;
+}
+//# sourceMappingURL=unfinished.js.map

package/dist/unfinished.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "fanout-cli",
+  "version": "0.7.0",
+  "description": "Let Claude Code lead the other coding-agent CLIs you already pay for.",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=22.18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/elberacasa/fanout.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/elberacasa/fanout#readme",
+  "bin": {
+    "fanout": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/main.d.ts",
+      "default": "./dist/main.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.30.0",
+    "fanout-adapter-claude": "0.7.0",
+    "fanout-adapter-codex": "0.7.0",
+    "fanout-core": "0.7.0",
+    "fanout-adapter-grok": "0.7.0",
+    "fanout-mcp": "0.7.0",
+    "fanout-adapter-fake": "0.7.0",
+    "fanout-daemon": "0.7.0"
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json",
+    "build": "tsc -p tsconfig.build.json"
+  }
+}