waterplane 0.0.1 → 0.1.6

package/packages/host/dist/extensions/requirements/host/list.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.mjs","sourceRoot":"","sources":["../../../../../extensions/requirements/host/list.mts"],"names":[],"mappings":"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"}

package/packages/host/dist/extensions/requirements/host/requirements.d.mts

@@ -0,0 +1,31 @@
+import type { ComplianceCheck, RequirementsState } from "@waterplane/shared";
+/**
+ * The build script, resolved from this module. Two layouts reach it, at two
+ * depths: the source (`packages/extensions/requirements/host/`, tsx dev) and
+ * the build (`packages/host/dist/extensions/requirements/host/`, see
+ * `packages/host/tsconfig.extensions.json`). The first that exists wins; with
+ * neither, the source layout's path, so the row can name where it looked.
+ * Pinned from both by `packages/host/test/requirementsscript.test.mjs`.
+ */
+export declare const UPDATE_SCRIPT_CANDIDATES: string[];
+export declare const UPDATE_SCRIPT: string;
+/** How the row and the preset spell the run. `.` because the agent runs it from the repo root. */
+export declare const UPDATE_CMD: string;
+/** The person's prompts in this directory's transcripts after `since` (ISO), deduped as the build dedupes. */
+export declare function promptsSince(worktree: string, since: string | null | undefined): number | null;
+/** `promptsSince` off the event loop — the sheet's path. The setup row keeps the sync one (its output is pinned). */
+export declare function promptsSinceAsync(worktree: string, since: string | null | undefined): Promise<number | null>;
+export declare function commitsSince(worktree: string, sha: string | null | undefined): number | null;
+export declare function commitsSinceAsync(worktree: string, sha: string | null | undefined): Promise<number | null>;
+export declare function readState(worktree: string): RequirementsState | null;
+export declare function readStateAsync(worktree: string): Promise<RequirementsState | null>;
+/** The row's own "is it set up" rule — the skill file or a state file. */
+export declare const isSetUp: (worktree: string) => boolean;
+/** The row, or `null` where the list is not set up (the offer is an opt-in, not a row). */
+export declare function requirementsCheck(worktree: string): ComplianceCheck | null;
+/**
+ * The `requirements` fix: the preset and an index stub, each only when absent.
+ * No model call, no `.state.json` — the first build writes that, and its
+ * absence is how the row tells "set up" from "built".
+ */
+export declare function scaffoldRequirements(worktree: string): string[];

package/packages/host/dist/extensions/requirements/host/requirements.mjs

@@ -0,0 +1,318 @@
+/**
+ * The requirements list as a setup row: is it set up in this repo, and how far
+ * behind the person's prompts is it?
+ *
+ * The list itself is built by `scripts/requirements/update.mjs` (a cheap-model
+ * extract, a stronger merge, applied as ops, left as an uncommitted diff). This
+ * module never runs it and never spends a token: the row SAYS the command, and
+ * the phone hands it to that repo's agent as a prompt a person reads first —
+ * nothing applies itself. The format, the prompt filter and the preset text are
+ * `@waterplane/shared`'s `requirements.mts`, so what this counts is what the build
+ * reads.
+ *
+ * An in-repo extension (`packages/extensions/requirements/`): `index.mts`
+ * contributes this row and its fix through `api.setupCheck`/`api.setupFix`;
+ * it imports `@waterplane/shared` and node only, never a host module.
+ *
+ * Opt-in by construction. Not set up is NO ROW at all: the offer lives on the
+ * Opt-ins region (`shared/optins.ts`, which runs this extension's `requirements`
+ * fix), and a second copy of it here was the same offer twice. Once set up,
+ * falling `REQ_STALE_PROMPTS` behind is a warn: the person asked for this list.
+ */
+import { execFile, execFileSync } from "node:child_process";
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync, readSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { open as openAsync, readFile as readFileAsync, readdir as readdirAsync, stat as statAsync } from "node:fs/promises";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { promisify } from "node:util";
+import { BRAND, REQ_DIR_REL, claudeConfigDirFromEnv, REQ_SKILL_REL, REQ_STALE_PROMPTS, REQ_STATE_REL, countRequirements, promptSeen, requirementsSkillText, transcriptDirName, transcriptPrompt, } from "@waterplane/shared";
+/**
+ * The build script, resolved from this module. Two layouts reach it, at two
+ * depths: the source (`packages/extensions/requirements/host/`, tsx dev) and
+ * the build (`packages/host/dist/extensions/requirements/host/`, see
+ * `packages/host/tsconfig.extensions.json`). The first that exists wins; with
+ * neither, the source layout's path, so the row can name where it looked.
+ * Pinned from both by `packages/host/test/requirementsscript.test.mjs`.
+ */
+export const UPDATE_SCRIPT_CANDIDATES = [
+    "../../../../scripts/requirements/update.mjs",
+    "../../../../../../scripts/requirements/update.mjs",
+].map((rel) => fileURLToPath(new URL(rel, import.meta.url)));
+export const UPDATE_SCRIPT = UPDATE_SCRIPT_CANDIDATES.find((p) => existsSync(p)) ?? UPDATE_SCRIPT_CANDIDATES[0];
+/** How the row and the preset spell the run. `.` because the agent runs it from the repo root. */
+export const UPDATE_CMD = `node ${UPDATE_SCRIPT} .`;
+const scans = new Map();
+function scanFile(path, session) {
+    let size;
+    try {
+        size = statSync(path).size;
+    }
+    catch {
+        return [];
+    }
+    let s = scans.get(path);
+    if (!s || size < s.size)
+        s = { size: 0, tail: "", prompts: [] };
+    if (size > s.size) {
+        const buf = Buffer.alloc(size - s.size);
+        const fd = openSync(path, "r");
+        try {
+            readSync(fd, buf, 0, buf.length, s.size);
+        }
+        finally {
+            closeSync(fd);
+        }
+        ingest(s, buf, size, session);
+    }
+    scans.set(path, s);
+    return s.prompts;
+}
+/** The appended bytes, folded into the file's scan (shared by the sync and async readers). */
+function ingest(s, buf, size, session) {
+    const lines = (s.tail + buf.toString("utf8")).split("\n");
+    s.tail = lines.pop() ?? ""; // a line still being written
+    for (const line of lines) {
+        if (!line)
+            continue;
+        try {
+            const p = transcriptPrompt(JSON.parse(line), session);
+            if (p)
+                s.prompts.push(p);
+        }
+        catch { /* torn line */ }
+    }
+    s.size = size;
+}
+/** `scanFile` off the event loop: same state, same result, `fs.promises`. Two overlapping scans of one file
+ *  are harmless (the second finds `s.size` already moved, or re-reads and the size guard below drops it). */
+async function scanFileAsync(path, session) {
+    let size;
+    try {
+        size = (await statAsync(path)).size;
+    }
+    catch {
+        return [];
+    }
+    let s = scans.get(path);
+    if (!s || size < s.size)
+        s = { size: 0, tail: "", prompts: [] };
+    if (size > s.size) {
+        const from = s.size;
+        const buf = Buffer.alloc(size - from);
+        const fh = await openAsync(path, "r");
+        try {
+            await fh.read(buf, 0, buf.length, from);
+        }
+        finally {
+            await fh.close();
+        }
+        const cur = scans.get(path);
+        if (cur && cur !== s && cur.size > from)
+            return cur.prompts; // a concurrent scan got there first
+        ingest(s, buf, size, session);
+    }
+    scans.set(path, s);
+    return s.prompts;
+}
+/** The person's prompts in this directory's transcripts after `since` (ISO), deduped as the build dedupes. */
+export function promptsSince(worktree, since) {
+    const dir = join(claudeConfigDirFromEnv(process.env, homedir()), "projects", transcriptDirName(worktree));
+    let files;
+    try {
+        files = readdirSync(dir).filter((f) => f.endsWith(".jsonl"));
+    }
+    catch {
+        return null;
+    }
+    const seen = new Set();
+    let n = 0;
+    for (const f of files) {
+        const path = join(dir, f);
+        // A file untouched since the mark cannot hold a newer prompt.
+        if (since) {
+            try {
+                if (statSync(path).mtime.toISOString() <= since)
+                    continue;
+            }
+            catch {
+                continue;
+            }
+        }
+        for (const p of scanFile(path, f.replace(/\.jsonl$/, ""))) {
+            if (since && p.ts <= since)
+                continue;
+            if (!promptSeen(seen, p))
+                n++;
+        }
+    }
+    return n;
+}
+/** `promptsSince` off the event loop — the sheet's path. The setup row keeps the sync one (its output is pinned). */
+export async function promptsSinceAsync(worktree, since) {
+    const dir = join(claudeConfigDirFromEnv(process.env, homedir()), "projects", transcriptDirName(worktree));
+    let files;
+    try {
+        files = (await readdirAsync(dir)).filter((f) => f.endsWith(".jsonl"));
+    }
+    catch {
+        return null;
+    }
+    const seen = new Set();
+    let n = 0;
+    for (const f of files) {
+        const path = join(dir, f);
+        if (since) {
+            try {
+                if ((await statAsync(path)).mtime.toISOString() <= since)
+                    continue;
+            }
+            catch {
+                continue;
+            }
+        }
+        for (const p of await scanFileAsync(path, f.replace(/\.jsonl$/, ""))) {
+            if (since && p.ts <= since)
+                continue;
+            if (!promptSeen(seen, p))
+                n++;
+        }
+    }
+    return n;
+}
+const GIT_MS = 5000;
+const execFileP = promisify(execFile);
+/** `commitsThrough` comes from the repo's committed `.state.json`: only a hex sha
+ *  reaches git's argv (a `--flag` there would be read as an option), and a value
+ *  that is not one answers null — never a count from the wrong anchor. */
+const SHA_RE = /^[0-9a-f]{7,40}$/;
+const revListArgs = (worktree, sha) => {
+    if (sha && !SHA_RE.test(sha))
+        return null;
+    return ["-C", worktree, "rev-list", "--count", sha ? `${sha}..HEAD` : "HEAD"];
+};
+export function commitsSince(worktree, sha) {
+    const args = revListArgs(worktree, sha);
+    if (!args)
+        return null;
+    try {
+        const n = Number(execFileSync("git", args, { encoding: "utf8", timeout: GIT_MS, stdio: ["ignore", "pipe", "ignore"] }).trim());
+        return Number.isFinite(n) ? n : null;
+    }
+    catch {
+        return null;
+    }
+}
+export async function commitsSinceAsync(worktree, sha) {
+    const args = revListArgs(worktree, sha);
+    if (!args)
+        return null;
+    try {
+        const n = Number((await execFileP("git", args, { encoding: "utf8", timeout: GIT_MS })).stdout.trim());
+        return Number.isFinite(n) ? n : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function readState(worktree) {
+    try {
+        return JSON.parse(readFileSync(join(worktree, REQ_STATE_REL), "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+export async function readStateAsync(worktree) {
+    try {
+        return JSON.parse(await readFileAsync(join(worktree, REQ_STATE_REL), "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * How long the CLI keeps transcripts (`cleanupPeriodDays`, default 30). The list
+ * is built FROM them, so a prompt older than this that no run read is gone.
+ */
+function retentionDays() {
+    try {
+        const v = JSON.parse(readFileSync(join(claudeConfigDirFromEnv(process.env, homedir()), "settings.json"), "utf8")).cleanupPeriodDays;
+        return typeof v === "number" && v > 0 ? v : 30;
+    }
+    catch {
+        return 30;
+    }
+}
+/** The row's own "is it set up" rule — the skill file or a state file. */
+export const isSetUp = (worktree) => existsSync(join(worktree, REQ_SKILL_REL)) || readState(worktree) != null;
+const plural = (n, w) => `${n} ${w}${n === 1 ? "" : "s"}`;
+// ── the row ────────────────────────────────────────────────────────────────
+/** The row, or `null` where the list is not set up (the offer is an opt-in, not a row). */
+export function requirementsCheck(worktree) {
+    const id = "requirements";
+    const label = "Requirements list";
+    const skill = existsSync(join(worktree, REQ_SKILL_REL));
+    const state = readState(worktree);
+    if (!skill && !state)
+        return null;
+    if (!existsSync(UPDATE_SCRIPT)) {
+        return { id, label, status: "warn", fix: null,
+            detail: `Set up, but this host cannot find its build script at ${UPDATE_SCRIPT}.` };
+    }
+    const keep = retentionDays();
+    const retention = keep <= 30
+        ? ` The CLI deletes transcripts after ${keep} days (cleanupPeriodDays in ~/.claude/settings.json), and this list is built from them — raise it, or build at least that often.`
+        : "";
+    const built = !!state?.lastRun;
+    const prompts = promptsSince(worktree, built ? state?.promptsThrough : null);
+    const commits = commitsSince(worktree, built ? state?.commitsThrough : null);
+    const since = [prompts == null ? null : plural(prompts, "prompt"), commits == null ? null : plural(commits, "commit")]
+        .filter(Boolean).join(" and ");
+    if (!built) {
+        return { id, label, status: "warn", fix: null,
+            detail: `Set up, never built${since ? ` — ${since} to read` : ""}. Build it from the repo root: ${UPDATE_CMD}${retention}` };
+    }
+    let items = { requested: 0, shipped: 0, superseded: 0, dropped: 0 };
+    try {
+        const dir = join(worktree, REQ_DIR_REL);
+        for (const f of readdirSync(dir).filter((f) => f.endsWith(".md") && f !== "README.md")) {
+            const c = countRequirements(readFileSync(join(dir, f), "utf8"));
+            items = { requested: items.requested + c.requested, shipped: items.shipped + c.shipped,
+                superseded: items.superseded + c.superseded, dropped: items.dropped + c.dropped };
+        }
+    }
+    catch { /* no area files yet */ }
+    const total = items.requested + items.shipped + items.superseded + items.dropped;
+    const cost = typeof state.lastCostUsd === "number" ? ` for $${state.lastCostUsd.toFixed(2)}` : "";
+    const head = `${plural(total, "item")} — ${items.requested} requested, ${items.shipped} shipped, ` +
+        `${items.superseded + items.dropped} superseded or dropped. Built ${state.lastRun.slice(0, 10)}${cost}` +
+        `${since ? `; ${since} since` : ""}.`;
+    const behind = (prompts ?? 0) >= REQ_STALE_PROMPTS;
+    return behind
+        ? { id, label, status: "warn", fix: null, detail: `${head} Update it from the repo root: ${UPDATE_CMD}${retention}` }
+        : { id, label, status: "pass", fix: null, detail: head + retention };
+}
+/**
+ * The `requirements` fix: the preset and an index stub, each only when absent.
+ * No model call, no `.state.json` — the first build writes that, and its
+ * absence is how the row tells "set up" from "built".
+ */
+export function scaffoldRequirements(worktree) {
+    const wrote = [];
+    const skill = join(worktree, REQ_SKILL_REL);
+    if (!existsSync(skill)) {
+        mkdirSync(dirname(skill), { recursive: true });
+        writeFileSync(skill, requirementsSkillText(UPDATE_CMD));
+        wrote.push(REQ_SKILL_REL);
+    }
+    const readme = join(worktree, REQ_DIR_REL, "README.md");
+    if (!existsSync(readme)) {
+        mkdirSync(dirname(readme), { recursive: true });
+        writeFileSync(readme, `# Requirements\n\nNot built yet. ${BRAND.name}'s setup checklist says how to build it; the format is in ` +
+            `\`${REQ_SKILL_REL}\`.\n`);
+        wrote.push(`${REQ_DIR_REL}/README.md`);
+    }
+    return wrote;
+}
+//# sourceMappingURL=requirements.mjs.map

package/packages/host/dist/extensions/requirements/host/requirements.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirements.mjs","sourceRoot":"","sources":["../../../../../extensions/requirements/host/requirements.mts"],"names":[],"mappings":"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"}

package/packages/host/dist/extensions/requirements/shared/methods.d.mts

@@ -0,0 +1,88 @@
+/**
+ * The requirements extension's wire: what the phone may ask its host half, typed once for both ends,
+ * and the two pure strings both ends must word the same way (the update brief, the once-per-build key).
+ * Pure, no node imports — the host compiles it (`tsconfig.extensions.json`), the phone bundles it.
+ */
+import type { RequirementItem } from "@waterplane/shared";
+export type ReqItem = RequirementItem;
+/** One shipped commit, resolved on the host: the phone has no git of its own. */
+export interface ReqCommit {
+    sha: string;
+    date: string;
+    subject: string;
+}
+/** What the launcher chip needs: no transcript scan, area files only. */
+export interface ReqSummary {
+    setUp: boolean;
+    built: boolean;
+    requested: number;
+    total: number;
+}
+export interface ReqList {
+    repoName: string;
+    setUp: boolean;
+    /** False when this host cannot find the build script — the sheet says where it looked. */
+    scriptFound: boolean;
+    lastRun: string | null;
+    lastCostUsd: number | null;
+    /** Prompts since the last build, null = could not be counted (never 0). */
+    promptsBehind: number | null;
+    commitsBehind: number | null;
+    /** The threshold at which the setup row turns to a warning. */
+    stalePrompts: number;
+    items: ReqItem[];
+    areas: string[];
+    /** Keyed by the sha as written in the item; a sha this repo does not know is absent. */
+    commits: Record<string, ReqCommit>;
+}
+export type ReqMethods = {
+    summary: {
+        args: {
+            repo: string;
+        };
+        result: ReqSummary;
+    };
+    list: {
+        args: {
+            repo: string;
+        };
+        result: ReqList;
+    };
+    update: {
+        args: {
+            repo: string;
+        };
+        result: {
+            intentId: string;
+            existing: boolean;
+        };
+    };
+    setup: {
+        args: {
+            repo: string;
+        };
+        result: {
+            applied: boolean;
+            note: string;
+        };
+    };
+};
+/** What the agent is told about the update — also the setup row's guidance (`web/setupRow.ts`). */
+export declare const REQ_UPDATE_GUIDANCE: string;
+/** The prompt that waits in the backlog for a tap. `detail` is the setup row's own sentence. */
+export declare function updateBrief(p: {
+    repoName: string;
+    detail: string;
+    cmd: string;
+}): string;
+/**
+ * The once-per-build key `handToAgent` dedupes on: one waiting update per repo per build state, so a
+ * second tap finds the first, and a new build frees the next. Fits pluginapi's 44 chars.
+ */
+export declare function updateKey(repoId: string, lastRun: string | null): string;
+/**
+ * The key for the n-th update of one build state (n ≥ 1 after the first finished): `updateKey` plus `.<n>`.
+ * A build that never wrote `.state.json` keeps the same base key forever, so a row that is over must be
+ * followed by a NEW key, not answered with the dead one. Stays within pluginapi's 44 chars.
+ */
+export declare function updateKeyNth(repoId: string, lastRun: string | null, n: number): string;

package/packages/host/dist/extensions/requirements/shared/methods.mjs

@@ -0,0 +1,36 @@
+/** What the agent is told about the update — also the setup row's guidance (`web/setupRow.ts`). */
+export const REQ_UPDATE_GUIDANCE = "Run the command quoted above from the repo root; it spends a few cents of model calls and leaves an " +
+    "uncommitted diff under `docs/requirements/`. Do not commit it. Then check the diff the way the run cannot: " +
+    "for each item still marked `requested`, look in the code — if it is clearly there, change its status line " +
+    "to `shipped` and add the commit that brought it (`git log -S`/`git blame`). Flag duplicates, items that " +
+    "describe a change rather than an end state, and anything that contradicts another item. Touch nothing else " +
+    "in the list, and end with a short summary of the diff for me to review.";
+/** The prompt that waits in the backlog for a tap. `detail` is the setup row's own sentence. */
+export function updateBrief(p) {
+    return `Update the requirements list in ${p.repoName}.\n\nWhere it stands: ${p.detail}\n\nThe command: ${p.cmd}\n\n${REQ_UPDATE_GUIDANCE}`;
+}
+function fnv8(s) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, 0x01000193) >>> 0;
+    }
+    return h.toString(16).padStart(8, "0");
+}
+/**
+ * The once-per-build key `handToAgent` dedupes on: one waiting update per repo per build state, so a
+ * second tap finds the first, and a new build frees the next. Fits pluginapi's 44 chars.
+ */
+export function updateKey(repoId, lastRun) {
+    return `u.${fnv8(repoId)}.${(lastRun ?? "").replace(/\D/g, "").slice(0, 14) || "never"}`;
+}
+/**
+ * The key for the n-th update of one build state (n ≥ 1 after the first finished): `updateKey` plus `.<n>`.
+ * A build that never wrote `.state.json` keeps the same base key forever, so a row that is over must be
+ * followed by a NEW key, not answered with the dead one. Stays within pluginapi's 44 chars.
+ */
+export function updateKeyNth(repoId, lastRun, n) {
+    const base = updateKey(repoId, lastRun);
+    return n <= 0 ? base : `${base}.${n}`.slice(0, 44);
+}
+//# sourceMappingURL=methods.mjs.map

package/packages/host/dist/extensions/requirements/shared/methods.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.mjs","sourceRoot":"","sources":["../../../../../extensions/requirements/shared/methods.mts"],"names":[],"mappings":"AAyCA,mGAAmG;AACnG,MAAM,CAAC,MAAM,mBAAmB,GAC9B,sGAAsG;IACtG,6GAA6G;IAC7G,4GAA4G;IAC5G,0GAA0G;IAC1G,6GAA6G;IAC7G,yEAAyE,CAAC;AAE5E,gGAAgG;AAChG,MAAM,UAAU,WAAW,CAAC,CAAoD;IAC9E,OAAO,mCAAmC,CAAC,CAAC,QAAQ,yBAAyB,CAAC,CAAC,MAAM,oBAAoB,CAAC,CAAC,GAAG,OAAO,mBAAmB,EAAE,CAAC;AAC7I,CAAC;AAED,SAAS,IAAI,CAAC,CAAS;IACrB,IAAI,CAAC,GAAG,UAAU,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAAC,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;IAAC,CAAC;IAChG,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,OAAsB;IAC9D,OAAO,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC;AAC3F,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,OAAsB,EAAE,CAAS;IAC5E,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACrD,CAAC"}

package/packages/host/dist/fanout.d.ts

@@ -0,0 +1,89 @@
+import type { FanoutRun, Intent, LaunchOpts, SessionBudget } from "@waterplane/shared";
+import type { SessionManager } from "./sessions.js";
+import type { ExecutorResult, IntentManager } from "./intents/manager.js";
+/** How many repos are spawned+fed concurrently. Each target is a real `claude`
+ *  process, so a 20-repo fan-out fired in one go would stampede the machine.
+ *  Enforced by the store, per `groupId` — see `IntentDeps.groupConcurrency`. */
+export declare const FANOUT_CONCURRENCY: number;
+export declare class FanoutManager {
+    private root;
+    private sessions;
+    private intents;
+    constructor(root: string, sessions: SessionManager, intents: IntentManager);
+    /** The runs, rebuilt from the rows that ARE them. */
+    list(): FanoutRun[];
+    /**
+     * The dirs a sweep may legally name, with the labels its rows are titled by.
+     *
+     * The gate: `dirs` are worktree paths from a phone, so they are matched
+     * against the DISCOVERED repo list and anything else is dropped. An arbitrary
+     * path can never become a session cwd here.
+     */
+    validate(dirs: string[]): Promise<{
+        dir: string;
+        title: string;
+    }[]>;
+    /**
+     * Start a run: validate, then post the sweep as one durable row.
+     *
+     * Returns as soon as the row is on disk. The children are posted by the
+     * store when it fires the parent, each progresses on its own, and every
+     * transition is broadcast by the store's `onChange` — the same shape the
+     * in-memory version had, with the ring replaced by rows.
+     */
+    start(dirs: string[], text: string, opts?: {
+        launch?: LaunchOpts;
+        budget?: SessionBudget;
+        flagWhenDone?: boolean;
+        cols?: number;
+        rows?: number;
+        id?: string;
+    }): Promise<FanoutRun | {
+        error: string;
+    }>;
+    /**
+     * The sweep executor: one child intent per repo.
+     *
+     * Posting rather than spawning is what makes each target independently
+     * durable, independently retryable and independently visible — and it is what
+     * puts the concurrency bound in one place. The parent settles as soon as the
+     * children exist, because "started" is all a sweep's own row ever claimed.
+     */
+    sweep(i: Intent, dirs: string[]): Promise<ExecutorResult>;
+    /**
+     * One repo: a fresh session, then the prompt typed into it.
+     *
+     * `deliverToNewSession` is shared with `session.create`'s own `prompt`, so the
+     * "a just-spawned session may still be booting" retry cannot drift between
+     * the two. The row then waits in `running` for a HOOK — never for silence: a
+     * sweep's whole output is the claim that N repos did the work, and a guess is
+     * not that claim.
+     */
+    runTarget(i: Intent): Promise<ExecutorResult>;
+    /**
+     * Send ANOTHER instruction into the sessions this run already spawned — the
+     * "…and now commit that" second step of a sweep, without reopening N sessions
+     * by hand.
+     *
+     * `dirs` narrows it to a subset (omitted = every target with a live session).
+     * Nothing is ever spawned: a target whose session died is left out and said
+     * so, because silently starting a fresh session would run the follow-up
+     * against a repo that never did step one.
+     *
+     * One child intent per session rather than one for the batch, so a follow-up
+     * that lands in three repos and fails in the fourth says exactly that. They
+     * share a batch id, which is how the run records the subset one tap addressed.
+     */
+    followUp(runId: string, text: string, dirs?: string[]): Promise<FanoutRun | {
+        error: string;
+    }>;
+    /**
+     * A follow-up's delivery: type into a session that already exists.
+     *
+     * Same at-most-once contract as `runTarget`: only `retry` (nothing typed) is
+     * re-attempted, once — a session mid-turn is exactly the case that needs the
+     * second look, and `unconfirmed` must never be re-sent.
+     */
+    followUpTarget(i: Intent, sessionId: string): Promise<ExecutorResult>;
+    private run;
+}