@chiralkit/cli 0.1.0-alpha.0

package/dist/pm/plan.js

@@ -0,0 +1,151 @@
+import { join } from "node:path";
+const CMD_PATTERN = /`(?:chiralkit|ck) ([a-z][a-z0-9-]*(?: [a-z][a-z0-9-]*)?)(?:[^a-z0-9-][^`]*)?`/;
+function backlogSource(task) {
+    return task.kit ? `kits/${task.kit}/BACKLOG.md` : "BACKLOG.md";
+}
+function selectReadyItems(snapshot, priorityFilter) {
+    const items = [];
+    for (const task of snapshot.backlog.orderedTasks) {
+        if (task.checked || task.status !== "ready")
+            continue;
+        if (!priorityFilter.has(task.priority))
+            continue;
+        items.push({ source: backlogSource(task), line: task.line, priority: task.priority, title: task.text, kit: task.kit });
+    }
+    return items;
+}
+async function listWorktrees(deps) {
+    try {
+        const output = await deps.git(deps.cwd, ["worktree", "list", "--porcelain"]);
+        return output.trim().split(/\r?\n\r?\n/).map((record) => {
+            const lines = record.split(/\r?\n/);
+            if (lines.some((line) => line.startsWith("prunable")))
+                return undefined;
+            const path = lines.find((line) => line.startsWith("worktree "))?.slice(9);
+            if (!path)
+                return undefined;
+            const branch = lines.find((line) => line.startsWith("branch "))?.slice(7).replace(/^refs\/heads\//, "") ?? "detached";
+            return { path, branch, current: false, dirty: false };
+        }).filter((worktree) => worktree !== undefined);
+    }
+    catch {
+        return [];
+    }
+}
+async function findActiveWorktrees(deps, worktrees, activeDays, mainBranch, now) {
+    const active = [];
+    for (const worktree of worktrees) {
+        if (worktree.branch === mainBranch)
+            continue;
+        try {
+            const isoRaw = (await deps.git(worktree.path, ["log", "-1", "--format=%cI", "HEAD"])).trim();
+            if (!isoRaw)
+                continue;
+            const lastCommit = new Date(isoRaw);
+            const daysSince = Math.floor((now.getTime() - lastCommit.getTime()) / 86_400_000);
+            if (daysSince <= activeDays)
+                active.push({ path: worktree.path, branch: worktree.branch, lastCommitISO: isoRaw, daysSince });
+        }
+        catch { /* worktree unreadable — skip */ }
+    }
+    return active;
+}
+function extractCommand(item) {
+    const source = `${item.title} ${item.description}`;
+    const match = CMD_PATTERN.exec(source);
+    return match?.[1];
+}
+async function findRoadmapGaps(deps, snapshot) {
+    const errors = [];
+    const cliIndex = join(deps.cwd, "packages/cli/src/index.ts");
+    let indexText = "";
+    try {
+        indexText = await deps.readText(cliIndex);
+    }
+    catch (error) {
+        errors.push(`plan: read ${cliIndex}: ${error.message}`);
+    }
+    const gaps = [];
+    for (const horizon of snapshot.roadmap.horizons) {
+        for (const item of horizon.items) {
+            if (item.checked)
+                continue;
+            if (item.area !== "CLI")
+                continue;
+            const command = extractCommand(item);
+            if (!command)
+                continue;
+            const top = command.split(" ")[0];
+            const caseNeedle = `case "${top}":`;
+            const wired = indexText.includes(caseNeedle);
+            const primary = join(deps.cwd, `packages/cli/src/${top}.ts`);
+            const hasPrimary = await deps.fileExists(primary);
+            if (!wired && !hasPrimary)
+                gaps.push({ line: item.line, title: item.title, area: item.area, command });
+        }
+    }
+    return { gaps, errors };
+}
+async function fetchOpenPullRequests(deps, now) {
+    const errors = [];
+    if (!deps.listOpenPullRequests)
+        return { prs: [], errors };
+    try {
+        const raw = await deps.listOpenPullRequests();
+        const prs = raw.map((pr) => {
+            const updated = new Date(pr.updatedAt);
+            const daysSince = Math.floor((now.getTime() - updated.getTime()) / 86_400_000);
+            return { number: pr.number, title: pr.title, branch: pr.headRefName, updatedISO: pr.updatedAt, daysSince };
+        });
+        return { prs, errors };
+    }
+    catch (error) {
+        errors.push(`plan: list PRs: ${error.message}`);
+        return { prs: [], errors };
+    }
+}
+export async function runPlan(deps, snapshot) {
+    const now = (deps.now ?? (() => new Date()))();
+    const activeDays = deps.activeDays ?? 3;
+    const mainBranch = deps.mainBranch ?? "main";
+    const priorityFilter = deps.priorityFilter ?? new Set(["P0", "P1", "P2"]);
+    const errors = [];
+    const readyItems = selectReadyItems(snapshot, priorityFilter);
+    const worktrees = snapshot.git.available ? snapshot.git.worktrees : await listWorktrees(deps);
+    const activeWorktrees = await findActiveWorktrees(deps, worktrees, activeDays, mainBranch, now);
+    const roadmap = await findRoadmapGaps(deps, snapshot);
+    errors.push(...roadmap.errors);
+    const pullRequests = await fetchOpenPullRequests(deps, now);
+    errors.push(...pullRequests.errors);
+    return { readyItems, activeWorktrees, openPullRequests: pullRequests.prs, roadmapGaps: roadmap.gaps, errors };
+}
+export function renderPlanReport(report) {
+    const lines = ["", "PLAN — work ready today"];
+    lines.push("  ready P0/P1/P2 backlog items:");
+    if (report.readyItems.length === 0)
+        lines.push("    none");
+    for (const item of report.readyItems)
+        lines.push(`    - ${item.source}:${item.line}  [${item.priority}] ${item.title}`);
+    lines.push("  active worktrees (recent commits):");
+    if (report.activeWorktrees.length === 0)
+        lines.push("    none");
+    for (const worktree of report.activeWorktrees)
+        lines.push(`    - ${worktree.branch}  ${worktree.daysSince}d ago  ${worktree.path}`);
+    lines.push("  open pull requests:");
+    if (report.openPullRequests.length === 0)
+        lines.push("    none");
+    for (const pr of report.openPullRequests)
+        lines.push(`    - #${pr.number}  ${pr.title}  (${pr.branch}, updated ${pr.daysSince}d ago)`);
+    lines.push("  roadmap items with no implementation yet:");
+    if (report.roadmapGaps.length === 0)
+        lines.push("    none");
+    for (const gap of report.roadmapGaps)
+        lines.push(`    - ROADMAP.md:${gap.line}  ck ${gap.command}  — ${gap.title}`);
+    if (report.errors.length > 0) {
+        lines.push("  plan errors:");
+        for (const error of report.errors)
+            lines.push(`    ! ${error}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+//# sourceMappingURL=plan.js.map

package/dist/pm/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/pm/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AA8BjC,MAAM,WAAW,GAAG,+EAA+E,CAAC;AAEpG,SAAS,aAAa,CAAC,IAAiB;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC;AACjE,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAyB,EAAE,cAAmC;IACtF,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QACjD,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,KAAK,OAAO;YAAE,SAAS;QACtD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,SAAS;QACjD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACzH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,IAAsB;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;QAC7E,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACtD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACpC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;gBAAE,OAAO,SAAS,CAAC;YACxE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;YAC1E,IAAI,CAAC,IAAI;gBAAE,OAAO,SAAS,CAAC;YAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC;YACtH,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACxD,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,EAA2B,EAAE,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC;IAAC,CAAC;AACxB,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,IAAsB,EAAE,SAAwB,EAAE,UAAkB,EAAE,UAAkB,EAAE,GAAS;IACpI,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,QAAQ,CAAC,MAAM,KAAK,UAAU;YAAE,SAAS;QAC7C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7F,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC;YACpC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC;YAClF,IAAI,SAAS,IAAI,UAAU;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/H,CAAC;QAAC,MAAM,CAAC,CAAC,gCAAgC,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,IAAiB;IACvC,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;IACnD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAsB,EAAE,QAAyB;IAC9E,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,2BAA2B,CAAC,CAAC;IAC7D,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,IAAI,CAAC;QAAC,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAAC,CAAC;IAClD,OAAO,KAAK,EAAE,CAAC;QAAC,MAAM,CAAC,IAAI,CAAC,cAAc,QAAQ,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;IAAC,CAAC;IAErF,MAAM,IAAI,GAAiB,EAAE,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QAChD,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,OAAO;gBAAE,SAAS;YAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;gBAAE,SAAS;YAClC,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;YACnC,MAAM,UAAU,GAAG,SAAS,GAAG,IAAI,CAAC;YACpC,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,oBAAoB,GAAG,KAAK,CAAC,CAAC;YAC7D,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YAClD,IAAI,CAAC,KAAK,IAAI,CAAC,UAAU;gBAAE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACzG,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1B,CAAC;AAED,KAAK,UAAU,qBAAqB,CAAC,IAAsB,EAAE,GAAS;IACpE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,IAAI,CAAC,oBAAoB;QAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IAC3D,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC9C,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YACzB,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;YACvC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC;YAC/E,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC;QAC7G,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,mBAAoB,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3D,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAsB,EAAE,QAAyB;IAC7E,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;IAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC;IAC7C,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,IAAI,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1E,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,UAAU,GAAG,gBAAgB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;IAC9F,MAAM,eAAe,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;IAChG,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACtD,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,MAAM,YAAY,GAAG,MAAM,qBAAqB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC5D,MAAM,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IACpC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;AAChH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAkB;IACjD,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,yBAAyB,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3D,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACxH,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACnD,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAChE,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,eAAe;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,SAAS,UAAU,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACpI,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,IAAI,MAAM,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjE,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,gBAAgB;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC,KAAK,MAAM,EAAE,CAAC,MAAM,aAAa,EAAE,CAAC,SAAS,QAAQ,CAAC,CAAC;IACvI,KAAK,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,WAAW;QAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,GAAG,CAAC,IAAI,QAAQ,GAAG,CAAC,OAAO,OAAO,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IACpH,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC"}

package/dist/pm/refinement-worktree.d.ts

@@ -0,0 +1,31 @@
+import type { GitExec } from "./git.js";
+import type { MutationRecord } from "./refinement.js";
+export declare const REFINEMENT_BRANCH = "automations/pm-refinement";
+export declare const REFINEMENT_WORKTREE_REL_PATH = ".worktrees/pm-refinement";
+export interface EnsureWorktreeDeps {
+    repoRoot: string;
+    git: GitExec;
+    mainBranch?: string;
+    originName?: string;
+}
+export interface EnsureWorktreeResult {
+    path: string;
+    branch: string;
+    created: boolean;
+    syncedFrom: string;
+    warnings: string[];
+}
+export interface CommitDeps {
+    worktreePath: string;
+    git: GitExec;
+    now?: () => Date;
+}
+export interface CommitResult {
+    committed: boolean;
+    sha: string | null;
+    message: string;
+    reason?: string;
+}
+export declare function ensureRefinementWorktree(deps: EnsureWorktreeDeps): Promise<EnsureWorktreeResult>;
+export declare function commitRefinementMutations(deps: CommitDeps, mutations: readonly MutationRecord[]): Promise<CommitResult>;
+export declare function relativeToRepo(repoRoot: string, absPath: string): string;

package/dist/pm/refinement-worktree.js

@@ -0,0 +1,160 @@
+import { join, relative } from "node:path";
+export const REFINEMENT_BRANCH = "automations/pm-refinement";
+export const REFINEMENT_WORKTREE_REL_PATH = ".worktrees/pm-refinement";
+function porcelainWorktreeIsRegistered(output, worktreePath) {
+    const target = worktreePath.endsWith("/") ? worktreePath.slice(0, -1) : worktreePath;
+    return output.split(/\r?\n/).some((line) => {
+        if (!line.startsWith("worktree "))
+            return false;
+        const registered = line.slice(9).trim();
+        const normalized = registered.endsWith("/") ? registered.slice(0, -1) : registered;
+        return normalized === target;
+    });
+}
+async function tryGit(git, cwd, args) {
+    try {
+        const stdout = await git(cwd, args);
+        return { ok: true, stdout };
+    }
+    catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+// Idempotent. Guarantees a git worktree exists at `.worktrees/pm-refinement/`
+// tracking the `automations/pm-refinement` branch, reset hard to origin/main
+// (or local main) so refinement always runs against the latest committed state.
+//
+// Design tradeoff: `git reset --hard` discards any un-merged content on the
+// refinement branch (e.g. a previous cron commit not yet pulled into main).
+// This is safe because refinement is idempotent: re-running against the current
+// Inbox produces the same output. The previous commit's content is not lost —
+// it can be re-derived from the same source.
+export async function ensureRefinementWorktree(deps) {
+    const mainBranch = deps.mainBranch ?? "main";
+    const originName = deps.originName ?? "origin";
+    const worktreeAbsPath = join(deps.repoRoot, REFINEMENT_WORKTREE_REL_PATH);
+    const warnings = [];
+    const listResult = await tryGit(deps.git, deps.repoRoot, ["worktree", "list", "--porcelain"]);
+    if (!listResult.ok) {
+        throw new Error(`worktree: cannot list worktrees at ${deps.repoRoot}: ${listResult.error}`);
+    }
+    const fetchResult = await tryGit(deps.git, deps.repoRoot, ["fetch", originName, mainBranch]);
+    const originAvailable = fetchResult.ok;
+    if (!originAvailable) {
+        warnings.push(`worktree: fetch ${originName} ${mainBranch} failed, falling back to local ${mainBranch}: ${fetchResult.error}`);
+    }
+    // Sync-ref policy: prefer whichever of local `main` or `origin/main` is
+    // *ahead*, so refinement always sees the freshest committed inbox state.
+    //   - remote unreachable → local `main`
+    //   - local ahead, remote not → local `main`
+    //   - remote ahead, local not → `origin/main`
+    //   - same → `origin/main` (canonical when they match)
+    //   - diverged → `origin/main` + a warning; local-only commits are dropped
+    //     but refinement is idempotent, so nothing is lost from the inbox.
+    const originRef = `${originName}/${mainBranch}`;
+    let syncRef = mainBranch;
+    if (originAvailable) {
+        const cmp = await tryGit(deps.git, deps.repoRoot, [
+            "rev-list", "--left-right", "--count", `${mainBranch}...${originRef}`,
+        ]);
+        if (cmp.ok) {
+            const [aheadRaw, behindRaw] = cmp.stdout.trim().split(/\s+/);
+            const localAhead = Number(aheadRaw ?? 0);
+            const remoteAhead = Number(behindRaw ?? 0);
+            if (localAhead > 0 && remoteAhead > 0) {
+                syncRef = originRef;
+                warnings.push(`worktree: local ${mainBranch} diverged from ${originRef} (local +${localAhead}, remote +${remoteAhead}); syncing to ${originRef}`);
+            }
+            else if (localAhead > 0) {
+                syncRef = mainBranch;
+            }
+            else {
+                syncRef = originRef;
+            }
+        }
+        else {
+            syncRef = originRef;
+            warnings.push(`worktree: rev-list compare failed, using ${originRef}: ${cmp.error}`);
+        }
+    }
+    const alreadyRegistered = porcelainWorktreeIsRegistered(listResult.stdout, worktreeAbsPath);
+    if (!alreadyRegistered) {
+        const addResult = await tryGit(deps.git, deps.repoRoot, [
+            "worktree", "add", "-B", REFINEMENT_BRANCH, worktreeAbsPath, syncRef,
+        ]);
+        if (!addResult.ok) {
+            throw new Error(`worktree: cannot create ${REFINEMENT_WORKTREE_REL_PATH} on ${REFINEMENT_BRANCH} from ${syncRef}: ${addResult.error}`);
+        }
+        return {
+            path: worktreeAbsPath,
+            branch: REFINEMENT_BRANCH,
+            created: true,
+            syncedFrom: syncRef,
+            warnings,
+        };
+    }
+    const resetResult = await tryGit(deps.git, worktreeAbsPath, ["reset", "--hard", syncRef]);
+    if (!resetResult.ok) {
+        throw new Error(`worktree: cannot reset ${worktreeAbsPath} to ${syncRef}: ${resetResult.error}`);
+    }
+    const cleanResult = await tryGit(deps.git, worktreeAbsPath, ["clean", "-fd"]);
+    if (!cleanResult.ok) {
+        warnings.push(`worktree: clean failed (untracked leftovers may remain): ${cleanResult.error}`);
+    }
+    return {
+        path: worktreeAbsPath,
+        branch: REFINEMENT_BRANCH,
+        created: false,
+        syncedFrom: syncRef,
+        warnings,
+    };
+}
+export async function commitRefinementMutations(deps, mutations) {
+    if (mutations.length === 0) {
+        return { committed: false, sha: null, message: "", reason: "no mutations to commit" };
+    }
+    const kitsAffected = Array.from(new Set(mutations.map((m) => m.kit))).sort();
+    const message = buildCommitMessage(mutations);
+    // Stage every kits/*/BACKLOG.md that got mutated. Explicit paths only — never
+    // `git add -A` — so any unrelated leftover in the worktree stays out of the
+    // refinement commit.
+    const paths = kitsAffected.map((kit) => `kits/${kit}/BACKLOG.md`);
+    const addResult = await tryGit(deps.git, deps.worktreePath, ["add", "--", ...paths]);
+    if (!addResult.ok) {
+        return { committed: false, sha: null, message, reason: `git add failed: ${addResult.error}` };
+    }
+    const statusResult = await tryGit(deps.git, deps.worktreePath, ["diff", "--cached", "--name-only"]);
+    if (!statusResult.ok) {
+        return { committed: false, sha: null, message, reason: `git diff --cached failed: ${statusResult.error}` };
+    }
+    if (statusResult.stdout.trim() === "") {
+        return { committed: false, sha: null, message, reason: "no staged changes after add (mutation was a no-op)" };
+    }
+    const commitResult = await tryGit(deps.git, deps.worktreePath, ["commit", "-m", message]);
+    if (!commitResult.ok) {
+        return { committed: false, sha: null, message, reason: `git commit failed: ${commitResult.error}` };
+    }
+    const shaResult = await tryGit(deps.git, deps.worktreePath, ["rev-parse", "HEAD"]);
+    const sha = shaResult.ok ? shaResult.stdout.trim() : null;
+    return { committed: true, sha, message, reason: undefined };
+}
+function buildCommitMessage(mutations) {
+    const kitsAffected = Array.from(new Set(mutations.map((m) => m.kit))).sort();
+    const subject = `chore(refinement): route ${mutations.length} inbox ${mutations.length === 1 ? "item" : "items"} to Refined (${kitsAffected.join(", ")})`;
+    const bodyLines = mutations
+        .slice(0, 20)
+        .map((m) => `- kits/${m.kit}/BACKLOG.md:${m.oldLine} → ${truncate(m.newLineText, 96)}`);
+    if (mutations.length > 20)
+        bodyLines.push(`- … +${mutations.length - 20} more`);
+    return `${subject}\n\n${bodyLines.join("\n")}\n`;
+}
+function truncate(s, max) {
+    return s.length <= max ? s : `${s.slice(0, max - 1)}…`;
+}
+// Compute a repo-relative path from an absolute path anchored at `repoRoot`.
+// Used by callers that need to render human-friendly locations in the report.
+export function relativeToRepo(repoRoot, absPath) {
+    const rel = relative(repoRoot, absPath);
+    return rel === "" ? "." : rel;
+}
+//# sourceMappingURL=refinement-worktree.js.map

package/dist/pm/refinement-worktree.js.map

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

package/dist/pm/refinement.d.ts

@@ -0,0 +1,79 @@
+import { type KitName } from "@chiralkit/kits";
+import type { Priority } from "./types.js";
+export interface InboxItem {
+    kit: KitName;
+    line: number;
+    capturedDate: string;
+    source: string;
+    text: string;
+}
+export interface RefinementProposal {
+    kit: KitName;
+    line: number;
+    text: string;
+    priority: Priority;
+    time: 0 | 1 | 2 | 3 | 5 | 8 | 13;
+    difficulty: 0 | 1 | 2 | 3 | 5 | 8 | 13;
+    rationale: string;
+}
+export interface RefinementViolation {
+    kit: KitName;
+    line: number;
+    text: string;
+    reason: string;
+}
+export interface MutationRecord {
+    kit: KitName;
+    oldLine: number;
+    newLineText: string;
+    createdRefinedSection: boolean;
+}
+export interface SkippedMutation {
+    kit: KitName;
+    line: number;
+    reason: string;
+}
+export interface AppliedMutations {
+    mutated: MutationRecord[];
+    skipped: SkippedMutation[];
+}
+export interface WorktreeReport {
+    path: string;
+    branch: string;
+    created: boolean;
+    syncedFrom: string;
+    commit: {
+        committed: boolean;
+        sha: string | null;
+        subject: string;
+        reason?: string;
+    };
+    warnings: string[];
+}
+export interface RefinementReport {
+    proposals: RefinementProposal[];
+    violations: RefinementViolation[];
+    window: {
+        auditRuns: number;
+        planRuns: number;
+    };
+    applied: AppliedMutations | null;
+    worktree: WorktreeReport | null;
+    errors: string[];
+}
+export interface RefinementDependencies {
+    cwd: string;
+    kitsRoot?: string;
+    readText: (path: string) => Promise<string>;
+    writeText?: (path: string, content: string) => Promise<void>;
+    now?: () => Date;
+    windowDays?: number;
+    dryRun?: boolean;
+}
+export declare function applyMutationsToFile(md: string, proposals: readonly RefinementProposal[]): {
+    newMd: string;
+    mutated: MutationRecord[];
+    skipped: SkippedMutation[];
+};
+export declare function runRefinement(deps: RefinementDependencies): Promise<RefinementReport>;
+export declare function renderRefinementReport(report: RefinementReport): string;