@chiralkit/cli 0.1.0-alpha.0

package/dist/pm/grid.d.ts

@@ -0,0 +1,8 @@
+import type { BacklogTask } from "./types.js";
+export declare const FIB_GRID_VALUES: readonly [1, 2, 3, 5, 8, 13];
+export type FibGridValue = (typeof FIB_GRID_VALUES)[number];
+export declare function sidebarRing(task: BacklogTask): 0 | FibGridValue;
+export declare function gridCell(task: BacklogTask): {
+    row: number;
+    col: number;
+} | null;

package/dist/pm/grid.js

@@ -0,0 +1,16 @@
+export const FIB_GRID_VALUES = [1, 2, 3, 5, 8, 13];
+export function sidebarRing(task) {
+    if (task.time === 0 || task.difficulty === 0)
+        return 0;
+    return Math.max(task.time, task.difficulty);
+}
+export function gridCell(task) {
+    if (task.time === 0 || task.difficulty === 0)
+        return null;
+    const row = FIB_GRID_VALUES.indexOf(task.time);
+    const col = FIB_GRID_VALUES.indexOf(task.difficulty);
+    if (row === -1 || col === -1)
+        return null;
+    return { row, col };
+}
+//# sourceMappingURL=grid.js.map

package/dist/pm/grid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grid.js","sourceRoot":"","sources":["../../src/pm/grid.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAU,CAAC;AAG5D,MAAM,UAAU,WAAW,CAAC,IAAiB;IAC3C,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACvD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAiB,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAiB;IACxC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1D,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,IAAoB,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,UAA0B,CAAC,CAAC;IACrE,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACtB,CAAC"}

package/dist/pm/index.d.ts

@@ -0,0 +1,25 @@
+import { buildProjectSnapshot, hasSnapshotErrors } from "./snapshot.js";
+import type { ObserverRunRecord } from "./observe.js";
+import type { ProjectSnapshot } from "./types.js";
+export { buildProjectSnapshot, hasSnapshotErrors };
+export type { ProjectSnapshot };
+export { FIB_GRID_VALUES, gridCell, sidebarRing, type FibGridValue } from "./grid.js";
+export { parseRoadmap } from "./roadmap.js";
+export { ROADMAP_RINGS, roadmapRing, type RoadmapRing } from "./roadmap-rings.js";
+export { ROADMAP_STATUS_VALUES } from "./types.js";
+export type { BacklogTask, InvalidBacklogTask, InvalidRoadmapItem, RoadmapHorizon, RoadmapItem, RoadmapParseResult, RoadmapStatus, Priority, } from "./types.js";
+export interface PmDependencies {
+    buildSnapshot: () => Promise<ProjectSnapshot>;
+    render: (snapshot: ProjectSnapshot) => string;
+    brief: (snapshot: ProjectSnapshot) => Promise<string>;
+    audit: (snapshot: ProjectSnapshot) => Promise<string>;
+    plan: (snapshot: ProjectSnapshot) => Promise<string>;
+    refinement: (opts: {
+        dryRun: boolean;
+        worktree: boolean;
+    }) => Promise<string>;
+    observe: () => Promise<ObserverRunRecord>;
+    stdout: (value: string) => void;
+    stderr: (value: string) => void;
+}
+export declare function runPm(argv: string[], dependencies?: Partial<PmDependencies>): Promise<number>;

package/dist/pm/index.js

@@ -0,0 +1,199 @@
+import { access } from "node:fs/promises";
+import { readFile, writeFile } from "node:fs/promises";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { renderAuditReport, runAudit } from "./audit.js";
+import { renderPlanReport, runPlan } from "./plan.js";
+import { runPmBrief } from "./brief.js";
+import { renderProjectSnapshot } from "./render.js";
+import { buildProjectSnapshot, hasSnapshotErrors } from "./snapshot.js";
+import { emitObserverSnapshot } from "./observe.js";
+import { renderRefinementReport, runRefinement } from "./refinement.js";
+import { commitRefinementMutations, ensureRefinementWorktree, REFINEMENT_BRANCH, } from "./refinement-worktree.js";
+export { buildProjectSnapshot, hasSnapshotErrors };
+export { FIB_GRID_VALUES, gridCell, sidebarRing } from "./grid.js";
+export { parseRoadmap } from "./roadmap.js";
+export { ROADMAP_RINGS, roadmapRing } from "./roadmap-rings.js";
+export { ROADMAP_STATUS_VALUES } from "./types.js";
+const execFileAsync = promisify(execFile);
+const KNOWN_FLAGS = new Set([
+    "--brief", "--audit", "--plan", "--refinement", "--dry-run", "--worktree", "--observe",
+]);
+async function defaultAudit(snapshot) {
+    const cwd = process.cwd();
+    const report = await runAudit({
+        cwd,
+        git: async (gitCwd, args) => (await execFileAsync("git", args, { cwd: gitCwd })).stdout,
+        readText: (path) => readFile(path, "utf8"),
+        fileExists: async (path) => { try {
+            await access(path);
+            return true;
+        }
+        catch {
+            return false;
+        } },
+    }, snapshot);
+    return renderAuditReport(report, "main");
+}
+async function defaultRefinement(opts) {
+    const repoRoot = process.cwd();
+    const git = async (gitCwd, args) => (await execFileAsync("git", args, { cwd: gitCwd })).stdout;
+    if (!opts.worktree) {
+        const report = await runRefinement({
+            cwd: repoRoot,
+            readText: (path) => readFile(path, "utf8"),
+            writeText: (path, content) => writeFile(path, content, "utf8"),
+            dryRun: opts.dryRun,
+        });
+        return renderRefinementReport(report);
+    }
+    // Worktree mode: the cron ceremony surface. Mutations land in a dedicated
+    // .worktrees/pm-refinement/ (branch automations/pm-refinement) instead of the
+    // developer's working tree, and are auto-committed there so `git status` on
+    // the developer's branch stays clean between refinement runs.
+    const ensured = await ensureRefinementWorktree({ repoRoot, git });
+    const report = await runRefinement({
+        cwd: ensured.path,
+        kitsRoot: `${ensured.path}/kits`,
+        readText: (path) => readFile(path, "utf8"),
+        writeText: (path, content) => writeFile(path, content, "utf8"),
+        dryRun: opts.dryRun,
+    });
+    let commitReport = { committed: false, sha: null, subject: "" };
+    if (!opts.dryRun && report.applied !== null && report.applied.mutated.length > 0) {
+        const commit = await commitRefinementMutations({ worktreePath: ensured.path, git }, report.applied.mutated);
+        commitReport = {
+            committed: commit.committed,
+            sha: commit.sha,
+            subject: commit.message.split("\n")[0] ?? "",
+            reason: commit.reason,
+        };
+    }
+    else if (opts.dryRun) {
+        commitReport = { committed: false, sha: null, subject: "", reason: "dry-run: no commit attempted" };
+    }
+    else {
+        commitReport = { committed: false, sha: null, subject: "", reason: "no mutations to commit" };
+    }
+    report.worktree = {
+        path: ensured.path,
+        branch: REFINEMENT_BRANCH,
+        created: ensured.created,
+        syncedFrom: ensured.syncedFrom,
+        commit: commitReport,
+        warnings: ensured.warnings,
+    };
+    return renderRefinementReport(report);
+}
+async function defaultPlan(snapshot) {
+    const cwd = process.cwd();
+    const report = await runPlan({
+        cwd,
+        git: async (gitCwd, args) => (await execFileAsync("git", args, { cwd: gitCwd })).stdout,
+        readText: (path) => readFile(path, "utf8"),
+        fileExists: async (path) => { try {
+            await access(path);
+            return true;
+        }
+        catch {
+            return false;
+        } },
+        listOpenPullRequests: async () => {
+            const { stdout } = await execFileAsync("gh", ["pr", "list", "--state", "open", "--json", "number,title,headRefName,updatedAt"], { cwd });
+            return JSON.parse(stdout);
+        },
+    }, snapshot);
+    return renderPlanReport(report);
+}
+const defaults = {
+    buildSnapshot: () => buildProjectSnapshot({ cwd: process.cwd() }),
+    render: renderProjectSnapshot,
+    brief: runPmBrief,
+    audit: defaultAudit,
+    plan: defaultPlan,
+    refinement: defaultRefinement,
+    observe: () => emitObserverSnapshot({ cwd: process.cwd() }),
+    stdout: (value) => process.stdout.write(value),
+    stderr: (value) => process.stderr.write(value),
+};
+export async function runPm(argv, dependencies = {}) {
+    const deps = { ...defaults, ...dependencies };
+    const unknown = argv.find((arg) => !KNOWN_FLAGS.has(arg));
+    if (unknown) {
+        deps.stderr(`pm: unknown flag '${unknown}'\n`);
+        return 1;
+    }
+    if (argv.includes("--observe")) {
+        try {
+            const record = await deps.observe();
+            deps.stdout(JSON.stringify(record) + "\n");
+            return record.drift ? 1 : 0;
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const fallback = {
+                ts: new Date().toISOString(),
+                exit: 1,
+                duration_ms: 0,
+                parsed: null,
+                drift: true,
+                summary: `observe failed: ${message}`,
+            };
+            deps.stdout(JSON.stringify(fallback) + "\n");
+            return 1;
+        }
+    }
+    const snapshot = await deps.buildSnapshot();
+    deps.stdout(deps.render(snapshot));
+    let code = hasSnapshotErrors(snapshot) ? 1 : 0;
+    if (argv.includes("--plan")) {
+        try {
+            deps.stdout(await deps.plan(snapshot));
+        }
+        catch (error) {
+            deps.stderr(`pm: plan failed: ${error.message}\n`);
+            code = 1;
+        }
+    }
+    if (argv.includes("--audit")) {
+        try {
+            deps.stdout(await deps.audit(snapshot));
+        }
+        catch (error) {
+            deps.stderr(`pm: audit failed: ${error.message}\n`);
+            code = 1;
+        }
+    }
+    if (argv.includes("--refinement")) {
+        const dryRun = argv.includes("--dry-run");
+        const worktree = argv.includes("--worktree");
+        try {
+            deps.stdout(await deps.refinement({ dryRun, worktree }));
+        }
+        catch (error) {
+            deps.stderr(`pm: refinement failed: ${error.message}\n`);
+            code = 1;
+        }
+    }
+    else {
+        if (argv.includes("--dry-run")) {
+            deps.stderr("pm: --dry-run requires --refinement\n");
+            code = 1;
+        }
+        if (argv.includes("--worktree")) {
+            deps.stderr("pm: --worktree requires --refinement\n");
+            code = 1;
+        }
+    }
+    if (argv.includes("--brief")) {
+        try {
+            deps.stdout(`${await deps.brief(snapshot)}\n`);
+        }
+        catch (error) {
+            deps.stderr(`pm: brief failed: ${error.message}\n`);
+            code = 1;
+        }
+    }
+    return code;
+}
+//# sourceMappingURL=index.js.map

package/dist/pm/index.js.map

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

package/dist/pm/observe.d.ts

@@ -0,0 +1,55 @@
+export interface ObserverParsed {
+    git: {
+        branch: string;
+        ahead_of_upstream: number;
+        behind_upstream: number;
+        dirty_files: number;
+        untracked_files: number;
+    };
+    doctor: {
+        exit: number;
+        warnings: number;
+        errors: number;
+        notes: string[];
+    };
+    prs: {
+        open: number;
+        draft: number;
+        list: Array<{
+            number: number;
+            title: string;
+            draft: boolean;
+            state: string;
+        }>;
+    } | null;
+    ceremonies: Array<{
+        name: string;
+        last_exit: number | null;
+        last_drift: boolean | null;
+        next_trigger: string | null;
+        status: string;
+    }>;
+    inbox: {
+        counts: Record<string, number>;
+        total_unrefined: number;
+    };
+}
+export declare function computeDrift(p: ObserverParsed, threshold: number): boolean;
+export declare function buildSummary(p: ObserverParsed): string;
+export declare function parseGitStatusPorcelainV2(stdout: string): ObserverParsed["git"];
+export declare function collectObserverParsed(opts: {
+    cwd: string;
+    kitsRoot: string;
+}): Promise<ObserverParsed>;
+export interface ObserverRunRecord {
+    ts: string;
+    exit: number;
+    duration_ms: number;
+    parsed: ObserverParsed;
+    drift: boolean;
+    summary: string;
+}
+export declare function emitObserverSnapshot(opts: {
+    cwd: string;
+    kitsRoot?: string;
+}): Promise<ObserverRunRecord>;

package/dist/pm/observe.js

@@ -0,0 +1,177 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { readFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { KIT_NAMES, resolveKitsRoot } from "@chiralkit/kits";
+const execFileAsync = promisify(execFile);
+export function computeDrift(p, threshold) {
+    if ((p.git?.dirty_files ?? 0) > 0)
+        return true;
+    if ((p.doctor?.errors ?? 0) > 0)
+        return true;
+    if ((p.ceremonies ?? []).some((c) => c.status === "drift"))
+        return true;
+    if ((p.inbox?.total_unrefined ?? 0) >= threshold)
+        return true;
+    return false;
+}
+export function buildSummary(p) {
+    const parts = [];
+    const openPrs = p.prs?.open ?? 0;
+    if (openPrs > 0)
+        parts.push(`${openPrs} PRs open`);
+    const dirty = p.git?.dirty_files ?? 0;
+    if (dirty > 0)
+        parts.push(`${dirty} dirty`);
+    const drifting = (p.ceremonies ?? []).filter((c) => c.status === "drift").map((c) => `${c.name} drift`);
+    parts.push(...drifting);
+    const unref = p.inbox?.total_unrefined ?? 0;
+    if (unref > 0)
+        parts.push(`${unref} unrefined`);
+    return parts.length > 0 ? parts.join(" · ") : "no signal";
+}
+export function parseGitStatusPorcelainV2(stdout) {
+    let branch = "";
+    let ahead = 0;
+    let behind = 0;
+    let dirty = 0;
+    let untracked = 0;
+    for (const line of stdout.split("\n")) {
+        if (line.startsWith("# branch.head ")) {
+            branch = line.slice("# branch.head ".length).trim();
+        }
+        else if (line.startsWith("# branch.ab ")) {
+            const match = line.match(/^# branch\.ab \+(\d+) -(\d+)/);
+            if (match) {
+                ahead = Number(match[1]);
+                behind = Number(match[2]);
+            }
+        }
+        else if (line.startsWith("1 ") || line.startsWith("2 ")) {
+            dirty += 1;
+        }
+        else if (line.startsWith("? ")) {
+            untracked += 1;
+        }
+    }
+    return { branch, ahead_of_upstream: ahead, behind_upstream: behind, dirty_files: dirty, untracked_files: untracked };
+}
+async function collectGit(cwd) {
+    const { stdout } = await execFileAsync("git", ["status", "--porcelain=v2", "--branch"], { cwd });
+    return parseGitStatusPorcelainV2(stdout);
+}
+async function collectDoctor(cwd) {
+    try {
+        const { stdout } = await execFileAsync("ck", ["doctor", "--json"], { cwd });
+        const out = JSON.parse(stdout);
+        return { exit: 0, warnings: out.warnings ?? 0, errors: out.errors ?? 0, notes: out.notes ?? [] };
+    }
+    catch {
+        // ck doctor may not support --json yet; fall back to plain invocation.
+        return { exit: -1, warnings: 0, errors: 0, notes: ["ck doctor --json unavailable; falling back to text parse"] };
+    }
+}
+async function collectPrs(cwd) {
+    try {
+        const { stdout } = await execFileAsync("gh", ["pr", "list", "--json", "number,title,isDraft,state", "--state", "open"], { cwd });
+        const list = JSON.parse(stdout);
+        return {
+            open: list.length,
+            draft: list.filter((p) => p.isDraft).length,
+            list: list.map((p) => ({ number: p.number, title: p.title, draft: p.isDraft, state: p.state })),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function collectCeremonies(cwd) {
+    const dir = join(cwd, "automations");
+    let entries = [];
+    try {
+        entries = await readdir(dir);
+    }
+    catch {
+        return [];
+    }
+    const results = [];
+    for (const name of entries) {
+        if (name === "observer")
+            continue; // don't include self
+        try {
+            const raw = await readFile(join(dir, name, "state.json"), "utf8");
+            const s = JSON.parse(raw);
+            results.push({
+                name,
+                last_exit: s.last_exit ?? null,
+                last_drift: s.last_drift ?? null,
+                next_trigger: s.next_trigger ?? null,
+                status: s.last_drift ? "drift" : s.last_exit === 0 ? "ok" : "failure",
+            });
+        }
+        catch {
+            /* skip malformed */
+        }
+    }
+    return results;
+}
+const INBOX_HEADER = "## Inbox (unrefined)";
+async function collectInbox(kitsRoot) {
+    const counts = {};
+    let total = 0;
+    for (const name of KIT_NAMES) {
+        try {
+            const md = await readFile(join(kitsRoot, name, "BACKLOG.md"), "utf8");
+            const idx = md.indexOf(INBOX_HEADER);
+            if (idx === -1) {
+                counts[name] = 0;
+                continue;
+            }
+            const after = md.slice(idx + INBOX_HEADER.length);
+            const nextH2 = after.search(/\n## /);
+            const section = nextH2 === -1 ? after : after.slice(0, nextH2);
+            const n = (section.match(/^\s*- \[ \] /gm) ?? []).length;
+            counts[name] = n;
+            total += n;
+        }
+        catch {
+            counts[name] = 0;
+        }
+    }
+    return { counts, total_unrefined: total };
+}
+export async function collectObserverParsed(opts) {
+    const [git, doctor, prs, ceremonies, inbox] = await Promise.all([
+        collectGit(opts.cwd),
+        collectDoctor(opts.cwd),
+        collectPrs(opts.cwd),
+        collectCeremonies(opts.cwd),
+        collectInbox(opts.kitsRoot),
+    ]);
+    return { git, doctor, prs, ceremonies, inbox };
+}
+export async function emitObserverSnapshot(opts) {
+    const kitsRoot = opts.kitsRoot ?? resolveKitsRoot();
+    const startedAt = Date.now();
+    const parsed = await collectObserverParsed({ cwd: opts.cwd, kitsRoot });
+    // Read inbox_drift_threshold from automation.json (default 10):
+    const configPath = join(opts.cwd, "automations", "observer", "automation.json");
+    let threshold = 10;
+    try {
+        const cfg = JSON.parse(await readFile(configPath, "utf8"));
+        if (typeof cfg.inbox_drift_threshold === "number")
+            threshold = cfg.inbox_drift_threshold;
+    }
+    catch {
+        /* keep default */
+    }
+    return {
+        ts: new Date().toISOString(),
+        exit: 0,
+        duration_ms: Date.now() - startedAt,
+        parsed,
+        drift: computeDrift(parsed, threshold),
+        summary: buildSummary(parsed),
+    };
+}
+//# sourceMappingURL=observe.js.map

package/dist/pm/observe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.js","sourceRoot":"","sources":["../../src/pm/observe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE7D,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAU1C,MAAM,UAAU,YAAY,CAAC,CAAiB,EAAE,SAAiB;IAC/D,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,WAAW,IAAI,CAAC,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACxE,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,eAAe,IAAI,CAAC,CAAC,IAAI,SAAS;QAAE,OAAO,IAAI,CAAC;IAC9D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAiB;IAC5C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,CAAC;IACjC,IAAI,OAAO,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,WAAW,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,EAAE,WAAW,IAAI,CAAC,CAAC;IACtC,IAAI,KAAK,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC;IACxG,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;IACxB,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,EAAE,eAAe,IAAI,CAAC,CAAC;IAC5C,IAAI,KAAK,GAAG,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,YAAY,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAc;IACtD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACtC,IAAI,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACtC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACtD,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;YACzD,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBACzB,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1D,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;aAAM,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,SAAS,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,CAAC;AACvH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,GAAW;IACnC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,UAAU,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IACjG,OAAO,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,GAAW;IACtC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QAC5E,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;IACnG,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;QACvE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,0DAA0D,CAAC,EAAE,CAAC;IACnH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,GAAW;IACnC,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CACpC,IAAI,EACJ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,4BAA4B,EAAE,SAAS,EAAE,MAAM,CAAC,EACzE,EAAE,GAAG,EAAE,CACR,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAA8E,CAAC;QAC7G,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,MAAM;YACjB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM;YAC3C,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;SAChG,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,GAAW;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IACrC,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,OAAO,GAAiC,EAAE,CAAC;IACjD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,IAAI,KAAK,UAAU;YAAE,SAAS,CAAC,qBAAqB;QACxD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;YAClE,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC1B,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI;gBACJ,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,IAAI;gBAC9B,UAAU,EAAE,CAAC,CAAC,UAAU,IAAI,IAAI;gBAChC,YAAY,EAAE,CAAC,CAAC,YAAY,IAAI,IAAI;gBACpC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;aACtE,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,oBAAoB;QACtB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,YAAY,GAAG,sBAAsB,CAAC;AAC5C,KAAK,UAAU,YAAY,CAAC,QAAgB;IAC1C,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;YACtE,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACrC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACjB,SAAS;YACX,CAAC;YACD,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;YAClD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YAC/D,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACzD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjB,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAuC;IACjF,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC9D,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;QACpB,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;QACvB,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;QACpB,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC;QAC3B,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC;KAC5B,CAAC,CAAC;IACH,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AACjD,CAAC;AAWD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAwC;IACjF,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,eAAe,EAAE,CAAC;IACpD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAG,MAAM,qBAAqB,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;IAExE,gEAAgE;IAChE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;IAChF,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QAC3D,IAAI,OAAO,GAAG,CAAC,qBAAqB,KAAK,QAAQ;YAAE,SAAS,GAAG,GAAG,CAAC,qBAAqB,CAAC;IAC3F,CAAC;IAAC,MAAM,CAAC;QACP,kBAAkB;IACpB,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,IAAI,EAAE,CAAC;QACP,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;QACnC,MAAM;QACN,KAAK,EAAE,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC;QACtC,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC;KAC9B,CAAC;AACJ,CAAC"}

package/dist/pm/plan.d.ts

@@ -0,0 +1,54 @@
+import type { GitExec } from "./git.js";
+import type { ProjectSnapshot } from "./types.js";
+export interface ReadyItem {
+    source: string;
+    line: number;
+    priority: string;
+    title: string;
+    kit?: string;
+}
+export interface ActiveWorktree {
+    path: string;
+    branch: string;
+    lastCommitISO: string;
+    daysSince: number;
+}
+export interface OpenPullRequest {
+    number: number;
+    title: string;
+    branch: string;
+    updatedISO: string;
+    daysSince: number;
+}
+export interface RoadmapGap {
+    line: number;
+    title: string;
+    area: string;
+    command: string;
+}
+export interface PlanReport {
+    readyItems: ReadyItem[];
+    activeWorktrees: ActiveWorktree[];
+    openPullRequests: OpenPullRequest[];
+    roadmapGaps: RoadmapGap[];
+    errors: string[];
+}
+export type GhListPullRequests = () => Promise<Array<{
+    number: number;
+    title: string;
+    headRefName: string;
+    updatedAt: string;
+}>>;
+export interface PlanDependencies {
+    cwd: string;
+    git: GitExec;
+    fileExists: (path: string) => Promise<boolean>;
+    readText: (path: string) => Promise<string>;
+    listOpenPullRequests?: GhListPullRequests;
+    now?: () => Date;
+    mainBranch?: string;
+    activeDays?: number;
+    priorityFilter?: ReadonlySet<string>;
+}
+export declare function runPlan(deps: PlanDependencies, snapshot: ProjectSnapshot): Promise<PlanReport>;
+export declare function renderPlanReport(report: PlanReport): string;