@growthub/cli 0.5.1 → 0.6.1

package/dist/config/store.d.ts

@@ -0,0 +1,6 @@
+import { type PaperclipConfig } from "./schema.js";
+export declare function resolveConfigPath(overridePath?: string): string;
+export declare function readConfig(configPath?: string): PaperclipConfig | null;
+export declare function writeConfig(config: PaperclipConfig, configPath?: string): void;
+export declare function configExists(configPath?: string): boolean;
+//# sourceMappingURL=store.d.ts.map

package/dist/config/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/config/store.ts"],"names":[],"mappings":"AAEA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AA0B1E,wBAAgB,iBAAiB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAI/D;AAqDD,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAUtE;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,eAAe,EACvB,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI,CAeN;AAED,wBAAgB,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/dist/config/store.js

@@ -0,0 +1,102 @@
+import fs from "node:fs";
+import path from "node:path";
+import { paperclipConfigSchema } from "./schema.js";
+import { resolveDefaultConfigPath, resolvePaperclipInstanceId, } from "./home.js";
+const DEFAULT_CONFIG_BASENAME = "config.json";
+function findConfigFileFromAncestors(startDir) {
+    const absoluteStartDir = path.resolve(startDir);
+    let currentDir = absoluteStartDir;
+    while (true) {
+        const candidate = path.resolve(currentDir, ".paperclip", DEFAULT_CONFIG_BASENAME);
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+        const nextDir = path.resolve(currentDir, "..");
+        if (nextDir === currentDir)
+            break;
+        currentDir = nextDir;
+    }
+    return null;
+}
+export function resolveConfigPath(overridePath) {
+    if (overridePath)
+        return path.resolve(overridePath);
+    if (process.env.PAPERCLIP_CONFIG)
+        return path.resolve(process.env.PAPERCLIP_CONFIG);
+    return findConfigFileFromAncestors(process.cwd()) ?? resolveDefaultConfigPath(resolvePaperclipInstanceId());
+}
+function parseJson(filePath) {
+    try {
+        return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+    }
+    catch (err) {
+        throw new Error(`Failed to parse JSON at ${filePath}: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+function migrateLegacyConfig(raw) {
+    if (typeof raw !== "object" || raw === null || Array.isArray(raw))
+        return raw;
+    const config = { ...raw };
+    const databaseRaw = config.database;
+    if (typeof databaseRaw !== "object" || databaseRaw === null || Array.isArray(databaseRaw)) {
+        return config;
+    }
+    const database = { ...databaseRaw };
+    if (database.mode === "pglite") {
+        database.mode = "embedded-postgres";
+        if (typeof database.embeddedPostgresDataDir !== "string" && typeof database.pgliteDataDir === "string") {
+            database.embeddedPostgresDataDir = database.pgliteDataDir;
+        }
+        if (typeof database.embeddedPostgresPort !== "number" &&
+            typeof database.pglitePort === "number" &&
+            Number.isFinite(database.pglitePort)) {
+            database.embeddedPostgresPort = database.pglitePort;
+        }
+    }
+    config.database = database;
+    return config;
+}
+function formatValidationError(err) {
+    const issues = err?.issues;
+    if (Array.isArray(issues) && issues.length > 0) {
+        return issues
+            .map((issue) => {
+            const pathParts = Array.isArray(issue.path) ? issue.path.map(String) : [];
+            const issuePath = pathParts.length > 0 ? pathParts.join(".") : "config";
+            const message = typeof issue.message === "string" ? issue.message : "Invalid value";
+            return `${issuePath}: ${message}`;
+        })
+            .join("; ");
+    }
+    return err instanceof Error ? err.message : String(err);
+}
+export function readConfig(configPath) {
+    const filePath = resolveConfigPath(configPath);
+    if (!fs.existsSync(filePath))
+        return null;
+    const raw = parseJson(filePath);
+    const migrated = migrateLegacyConfig(raw);
+    const parsed = paperclipConfigSchema.safeParse(migrated);
+    if (!parsed.success) {
+        throw new Error(`Invalid config at ${filePath}: ${formatValidationError(parsed.error)}`);
+    }
+    return parsed.data;
+}
+export function writeConfig(config, configPath) {
+    const filePath = resolveConfigPath(configPath);
+    const dir = path.dirname(filePath);
+    fs.mkdirSync(dir, { recursive: true });
+    // Backup existing config before overwriting
+    if (fs.existsSync(filePath)) {
+        const backupPath = filePath + ".backup";
+        fs.copyFileSync(filePath, backupPath);
+        fs.chmodSync(backupPath, 0o600);
+    }
+    fs.writeFileSync(filePath, JSON.stringify(config, null, 2) + "\n", {
+        mode: 0o600,
+    });
+}
+export function configExists(configPath) {
+    return fs.existsSync(resolveConfigPath(configPath));
+}
+//# sourceMappingURL=store.js.map

package/dist/config/store.js.map

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

package/dist/fleet/agent-plan.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Agent-led maintenance flow — draft heal plan document.
+ *
+ * Produces a durable, human-reviewable plan document for a specific fork.
+ * The document is:
+ *   1. Built from the already-shipping detector + plan builder.
+ *   2. Projected through the policy via buildDriftArtifactSummary.
+ *   3. Captured as a trace event ('agent_checkpoint') for durability.
+ *   4. NEVER auto-applied — the operator must explicitly run
+ *      `growthub kit fork heal <fork-id>` or `fleet heal` to act on it.
+ *
+ * This is the "agent inspects, drafts, waits, resumes, documents" flow the
+ * user asked for, built as a thin composition over the engine.
+ */
+import type { KitForkRegistration } from "../kits/fork-types.js";
+import type { AgentHealPlanDocument } from "./types.js";
+export declare function buildAgentHealPlanDocument(reg: KitForkRegistration, opts?: {
+    captureInTrace?: boolean;
+}): AgentHealPlanDocument;
+//# sourceMappingURL=agent-plan.d.ts.map

package/dist/fleet/agent-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-plan.d.ts","sourceRoot":"","sources":["../../src/fleet/agent-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,mBAAmB,EACxB,IAAI,GAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAO,GACtC,qBAAqB,CA6CvB"}

package/dist/fleet/agent-plan.js

@@ -0,0 +1,61 @@
+/**
+ * Agent-led maintenance flow — draft heal plan document.
+ *
+ * Produces a durable, human-reviewable plan document for a specific fork.
+ * The document is:
+ *   1. Built from the already-shipping detector + plan builder.
+ *   2. Projected through the policy via buildDriftArtifactSummary.
+ *   3. Captured as a trace event ('agent_checkpoint') for durability.
+ *   4. NEVER auto-applied — the operator must explicitly run
+ *      `growthub kit fork heal <fork-id>` or `fleet heal` to act on it.
+ *
+ * This is the "agent inspects, drafts, waits, resumes, documents" flow the
+ * user asked for, built as a thin composition over the engine.
+ */
+import { detectKitForkDrift, buildKitForkHealPlan } from "../kits/fork-sync.js";
+import { readKitForkPolicy } from "../kits/fork-policy.js";
+import { appendKitForkTraceEvent } from "../kits/fork-trace.js";
+import { buildDriftArtifactSummary, summariseArtifactSummaryAsNarrative } from "./drift-summary.js";
+export function buildAgentHealPlanDocument(reg, opts = {}) {
+    const policy = readKitForkPolicy(reg.forkPath);
+    const driftReport = detectKitForkDrift(reg);
+    const plan = buildKitForkHealPlan(driftReport, { policy });
+    const artifactBreakdown = buildDriftArtifactSummary(driftReport, plan, policy);
+    const narrative = summariseArtifactSummaryAsNarrative(artifactBreakdown);
+    const awaitsConfirmation = plan.actions
+        .filter((a) => a.needsConfirmation)
+        .map((a) => a.targetPath);
+    const doc = {
+        forkId: reg.forkId,
+        kitId: reg.kitId,
+        generatedAt: new Date().toISOString(),
+        summary: awaitsConfirmation.length > 0
+            ? `Plan drafted — ${awaitsConfirmation.length} action(s) await your confirmation before applying.`
+            : plan.actions.length === 0
+                ? "Fork is clean — no actionable plan."
+                : `Plan drafted — ${plan.actions.length} action(s) ready to apply.`,
+        driftReport,
+        plan,
+        artifactBreakdown,
+        policySnapshot: policy,
+        awaitsConfirmation,
+        narrative,
+        registrationAtDraftTime: reg,
+    };
+    if (opts.captureInTrace !== false) {
+        appendKitForkTraceEvent(reg.forkPath, {
+            forkId: reg.forkId,
+            kitId: reg.kitId,
+            type: "agent_checkpoint",
+            summary: `Agent drafted heal plan — awaits=${awaitsConfirmation.length}, actions=${plan.actions.length}`,
+            detail: {
+                severity: driftReport.overallSeverity,
+                fromVersion: plan.fromVersion,
+                toVersion: plan.toVersion,
+                awaitsConfirmation,
+            },
+        });
+    }
+    return doc;
+}
+//# sourceMappingURL=agent-plan.js.map

package/dist/fleet/agent-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-plan.js","sourceRoot":"","sources":["../../src/fleet/agent-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,mCAAmC,EAAE,MAAM,oBAAoB,CAAC;AAIpG,MAAM,UAAU,0BAA0B,CACxC,GAAwB,EACxB,OAAqC,EAAE;IAEvC,MAAM,MAAM,GAAG,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,oBAAoB,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3D,MAAM,iBAAiB,GAAG,yBAAyB,CAAC,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/E,MAAM,SAAS,GAAG,mCAAmC,CAAC,iBAAiB,CAAC,CAAC;IACzE,MAAM,kBAAkB,GAAG,IAAI,CAAC,OAAO;SACpC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC;SAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAE5B,MAAM,GAAG,GAA0B;QACjC,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACrC,OAAO,EACL,kBAAkB,CAAC,MAAM,GAAG,CAAC;YAC3B,CAAC,CAAC,kBAAkB,kBAAkB,CAAC,MAAM,qDAAqD;YAClG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;gBACzB,CAAC,CAAC,qCAAqC;gBACvC,CAAC,CAAC,kBAAkB,IAAI,CAAC,OAAO,CAAC,MAAM,4BAA4B;QACzE,WAAW;QACX,IAAI;QACJ,iBAAiB;QACjB,cAAc,EAAE,MAAM;QACtB,kBAAkB;QAClB,SAAS;QACT,uBAAuB,EAAE,GAAG;KAC7B,CAAC;IAEF,IAAI,IAAI,CAAC,cAAc,KAAK,KAAK,EAAE,CAAC;QAClC,uBAAuB,CAAC,GAAG,CAAC,QAAQ,EAAE;YACpC,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,IAAI,EAAE,kBAAkB;YACxB,OAAO,EAAE,oCAAoC,kBAAkB,CAAC,MAAM,aAAa,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YACxG,MAAM,EAAE;gBACN,QAAQ,EAAE,WAAW,CAAC,eAAe;gBACrC,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,kBAAkB;aACnB;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/fleet/approvals.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Approval queue builder — pure composition over fork-sync-agent state.
+ *
+ * Scans every registered fork's job log (via listKitForkSyncJobs under the
+ * hood) and surfaces jobs parked in `awaiting_confirmation`. No new storage
+ * — this is literally a view into existing durable state.
+ */
+import type { ApprovalQueueEntry } from "./types.js";
+export declare function buildApprovalQueue(): ApprovalQueueEntry[];
+//# sourceMappingURL=approvals.d.ts.map

package/dist/fleet/approvals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../../src/fleet/approvals.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,wBAAgB,kBAAkB,IAAI,kBAAkB,EAAE,CAsBzD"}

package/dist/fleet/approvals.js

@@ -0,0 +1,33 @@
+/**
+ * Approval queue builder — pure composition over fork-sync-agent state.
+ *
+ * Scans every registered fork's job log (via listKitForkSyncJobs under the
+ * hood) and surfaces jobs parked in `awaiting_confirmation`. No new storage
+ * — this is literally a view into existing durable state.
+ */
+import { listKitForkRegistrations } from "../kits/fork-registry.js";
+import { listKitForkSyncJobs } from "../kits/fork-sync-agent.js";
+export function buildApprovalQueue() {
+    const regs = listKitForkRegistrations();
+    const entries = [];
+    for (const reg of regs) {
+        const jobs = listKitForkSyncJobs({ forkId: reg.forkId });
+        for (const job of jobs) {
+            if (job.status !== "awaiting_confirmation")
+                continue;
+            if (!job.healPlan)
+                continue;
+            entries.push({
+                jobId: job.jobId,
+                forkId: reg.forkId,
+                kitId: reg.kitId,
+                forkLabel: reg.label,
+                createdAt: job.createdAt,
+                pendingPaths: job.pendingConfirmations ?? [],
+                plan: job.healPlan,
+            });
+        }
+    }
+    return entries.sort((a, b) => a.createdAt.localeCompare(b.createdAt));
+}
+//# sourceMappingURL=approvals.js.map

package/dist/fleet/approvals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvals.js","sourceRoot":"","sources":["../../src/fleet/approvals.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,MAAM,UAAU,kBAAkB;IAChC,MAAM,IAAI,GAAG,wBAAwB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAyB,EAAE,CAAC;IAEzC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,mBAAmB,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QACzD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,GAAG,CAAC,MAAM,KAAK,uBAAuB;gBAAE,SAAS;YACrD,IAAI,CAAC,GAAG,CAAC,QAAQ;gBAAE,SAAS;YAC5B,OAAO,CAAC,IAAI,CAAC;gBACX,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,KAAK,EAAE,GAAG,CAAC,KAAK;gBAChB,SAAS,EAAE,GAAG,CAAC,KAAK;gBACpB,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,YAAY,EAAE,GAAG,CAAC,oBAAoB,IAAI,EAAE;gBAC5C,IAAI,EAAE,GAAG,CAAC,QAAQ;aACnB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AACxE,CAAC"}

package/dist/fleet/drift-summary.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Artifact / path-level drift summary builder.
+ *
+ * Projects a KitForkDriftReport through the active KitForkPolicy to produce
+ * an operator-friendly breakdown of what an upcoming heal would do. Purely
+ * derivational — never mutates inputs, never touches disk.
+ */
+import type { KitForkPolicy } from "../kits/fork-policy.js";
+import type { KitForkDriftReport, KitForkHealPlan } from "../kits/fork-types.js";
+import type { DriftArtifactSummary } from "./types.js";
+export declare function buildDriftArtifactSummary(report: KitForkDriftReport, plan: KitForkHealPlan, policy: KitForkPolicy): DriftArtifactSummary;
+export declare function summariseArtifactSummaryAsNarrative(summary: DriftArtifactSummary): string[];
+//# sourceMappingURL=drift-summary.d.ts.map

package/dist/fleet/drift-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drift-summary.d.ts","sourceRoot":"","sources":["../../src/fleet/drift-summary.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,KAAK,EAAE,oBAAoB,EAAiC,MAAM,YAAY,CAAC;AAEtF,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,aAAa,GACpB,oBAAoB,CAsFtB;AAED,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,oBAAoB,GAC5B,MAAM,EAAE,CAkCV"}

package/dist/fleet/drift-summary.js

@@ -0,0 +1,120 @@
+/**
+ * Artifact / path-level drift summary builder.
+ *
+ * Projects a KitForkDriftReport through the active KitForkPolicy to produce
+ * an operator-friendly breakdown of what an upcoming heal would do. Purely
+ * derivational — never mutates inputs, never touches disk.
+ */
+import { isUntouchable } from "../kits/fork-policy.js";
+export function buildDriftArtifactSummary(report, plan, policy) {
+    const safeAdditions = [];
+    const safeUpdates = [];
+    const skippedUserModified = [];
+    const skippedUntouchable = [];
+    const needsConfirmation = [];
+    const customSkills = [];
+    const unresolvedUpstreamDeletion = [];
+    const packageAdditions = [];
+    const packageUpgrades = [];
+    // File-level drift projection — upstream deletions surface separately
+    for (const drift of report.fileDrifts) {
+        if (drift.changeType === "deleted") {
+            unresolvedUpstreamDeletion.push({
+                path: drift.relativePath,
+                note: "Upstream removed this file; the fork still has it — operator decides.",
+            });
+        }
+    }
+    // Plan-level projection (authoritative: what the agent would do)
+    for (const action of plan.actions) {
+        const p = action.targetPath;
+        if (isUntouchable(policy, p)) {
+            skippedUntouchable.push({ path: p, note: "Untouchable per policy.untouchablePaths." });
+            continue;
+        }
+        if (action.needsConfirmation) {
+            needsConfirmation.push({
+                path: p,
+                note: action.confirmationReason ?? "Policy requires explicit confirmation.",
+            });
+            continue;
+        }
+        switch (action.actionType) {
+            case "add_file":
+                safeAdditions.push({ path: p, note: "Upstream scaffold absent from fork — safe to add." });
+                break;
+            case "update_package_json_deps":
+                safeUpdates.push({ path: p, note: "Dependency merge (additive-only)." });
+                break;
+            case "patch_manifest":
+                safeUpdates.push({ path: p, note: "kit.json alignment field patch (safe allow-list)." });
+                break;
+            case "skip_user_modified":
+                skippedUserModified.push({ path: p, note: "Preserved — user has modified this file." });
+                break;
+            case "add_custom_skill":
+                customSkills.push({ path: p, note: "User-authored custom skill — preserved unchanged." });
+                break;
+        }
+    }
+    // Package-drift projection
+    for (const pd of report.packageDrifts) {
+        const entry = {
+            packageName: pd.packageName,
+            fromVersion: pd.forkVersion,
+            toVersion: pd.upstreamVersion,
+            changeType: pd.changeType,
+        };
+        if (pd.changeType === "added")
+            packageAdditions.push(entry);
+        else if (pd.changeType === "updated")
+            packageUpgrades.push(entry);
+    }
+    return {
+        forkId: report.forkId,
+        kitId: report.kitId,
+        fromVersion: report.forkVersion,
+        toVersion: report.upstreamVersion,
+        severity: report.overallSeverity,
+        buckets: {
+            safeAdditions,
+            safeUpdates,
+            skippedUserModified,
+            skippedUntouchable,
+            needsConfirmation,
+            customSkills,
+            unresolvedUpstreamDeletion,
+            packageAdditions,
+            packageUpgrades,
+        },
+        packageDriftCount: report.packageDrifts.length,
+        fileDriftCount: report.fileDrifts.length,
+    };
+}
+export function summariseArtifactSummaryAsNarrative(summary) {
+    const lines = [];
+    const b = summary.buckets;
+    lines.push(`Upstream moved from ${summary.fromVersion} to ${summary.toVersion} with overall severity ${summary.severity}.`);
+    if (b.safeAdditions.length)
+        lines.push(`I can add ${b.safeAdditions.length} new upstream scaffold file(s) safely.`);
+    if (b.safeUpdates.length)
+        lines.push(`I can apply ${b.safeUpdates.length} safe manifest/dependency alignment(s).`);
+    if (b.packageAdditions.length)
+        lines.push(`I can merge ${b.packageAdditions.length} upstream dependency addition(s).`);
+    if (b.packageUpgrades.length)
+        lines.push(`${b.packageUpgrades.length} dependency upgrade(s) need review — additive-only by default.`);
+    if (b.needsConfirmation.length)
+        lines.push(`${b.needsConfirmation.length} action(s) require your explicit confirmation before applying.`);
+    if (b.skippedUserModified.length)
+        lines.push(`${b.skippedUserModified.length} file(s) you modified are preserved and will not be touched.`);
+    if (b.skippedUntouchable.length)
+        lines.push(`${b.skippedUntouchable.length} file(s) flagged untouchable by policy remain locked.`);
+    if (b.customSkills.length)
+        lines.push(`${b.customSkills.length} custom skill(s) detected and preserved.`);
+    if (b.unresolvedUpstreamDeletion.length)
+        lines.push(`${b.unresolvedUpstreamDeletion.length} file(s) removed upstream remain in your fork — your call.`);
+    if (lines.length === 1)
+        lines.push("Fork is clean — no actionable changes.");
+    return lines;
+}
+//# sourceMappingURL=drift-summary.js.map

package/dist/fleet/drift-summary.js.map

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

package/dist/fleet/summary.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Fleet summary builder — pure composition over existing primitives.
+ * Never writes to disk. Never mutates the fork tree.
+ */
+import type { KitForkRegistration } from "../kits/fork-types.js";
+import type { ForkSummary, FleetSummary } from "./types.js";
+export declare function buildForkSummary(reg: KitForkRegistration): ForkSummary;
+export declare function buildFleetSummary(): FleetSummary;
+//# sourceMappingURL=summary.d.ts.map

package/dist/fleet/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../src/fleet/summary.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,KAAK,EACV,mBAAmB,EAGpB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAmB,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAwB7E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,mBAAmB,GAAG,WAAW,CAyFtE;AAED,wBAAgB,iBAAiB,IAAI,YAAY,CA2ChD"}

package/dist/fleet/summary.js

@@ -0,0 +1,161 @@
+/**
+ * Fleet summary builder — pure composition over existing primitives.
+ * Never writes to disk. Never mutates the fork tree.
+ */
+import fs from "node:fs";
+import { listKitForkRegistrations } from "../kits/fork-registry.js";
+import { detectKitForkDrift } from "../kits/fork-sync.js";
+import { readKitForkPolicy } from "../kits/fork-policy.js";
+import { listKitForkSyncJobs } from "../kits/fork-sync-agent.js";
+import { tailKitForkTrace } from "../kits/fork-trace.js";
+function classifyHealth(drift, pendingConfirmationJobs, lastJobStatus) {
+    if (!drift)
+        return "unknown";
+    if (pendingConfirmationJobs > 0)
+        return "awaiting-confirmation";
+    if (lastJobStatus === "failed")
+        return "error";
+    if (drift.overallSeverity === "critical" || drift.overallSeverity === "warning") {
+        return "drift-major";
+    }
+    if (drift.overallSeverity === "info" || drift.hasUpstreamUpdate)
+        return "drift-minor";
+    return "clean";
+}
+const REMOTE_EVENT_TYPES = new Set([
+    "remote_connected",
+    "remote_pushed",
+    "remote_pr_opened",
+    "conflict_encountered",
+]);
+export function buildForkSummary(reg) {
+    // Missing fork directory → unknown, short-circuit with minimal detail.
+    if (!fs.existsSync(reg.forkPath)) {
+        return {
+            forkId: reg.forkId,
+            kitId: reg.kitId,
+            label: reg.label,
+            forkPath: reg.forkPath,
+            baseVersion: reg.baseVersion,
+            driftSeverity: "none",
+            hasUpstreamUpdate: false,
+            fileDriftCount: 0,
+            packageDriftCount: 0,
+            customSkillCount: 0,
+            remoteSyncMode: "off",
+            autoApprove: "additive",
+            autoApproveDepUpdates: "additive",
+            untouchableCount: 0,
+            pendingConfirmationJobs: 0,
+            health: "unknown",
+        };
+    }
+    let drift = null;
+    try {
+        drift = detectKitForkDrift(reg);
+    }
+    catch {
+        drift = null;
+    }
+    const policy = readKitForkPolicy(reg.forkPath);
+    const jobs = listKitForkSyncJobs({ forkId: reg.forkId });
+    const pendingConfirmationJobs = jobs.filter((j) => j.status === "awaiting_confirmation").length;
+    const lastJob = jobs[jobs.length - 1];
+    let lastRemoteEvent = null;
+    let lastRemoteEventAt;
+    const traceTail = tailKitForkTrace(reg.forkPath, 200);
+    for (let i = traceTail.length - 1; i >= 0; i -= 1) {
+        const ev = traceTail[i];
+        if (REMOTE_EVENT_TYPES.has(ev.type)) {
+            lastRemoteEvent = ev.type;
+            lastRemoteEventAt = ev.timestamp;
+            break;
+        }
+    }
+    return {
+        forkId: reg.forkId,
+        kitId: reg.kitId,
+        label: reg.label,
+        forkPath: reg.forkPath,
+        baseVersion: reg.baseVersion,
+        upstreamVersion: drift?.upstreamVersion,
+        lastSyncedAt: reg.lastSyncedAt,
+        driftSeverity: (drift?.overallSeverity ?? "none"),
+        hasUpstreamUpdate: drift?.hasUpstreamUpdate ?? false,
+        fileDriftCount: drift?.fileDrifts.length ?? 0,
+        packageDriftCount: drift?.packageDrifts.length ?? 0,
+        customSkillCount: drift?.customSkillsDetected.length ?? 0,
+        remoteSyncMode: policy.remoteSyncMode,
+        autoApprove: policy.autoApprove,
+        autoApproveDepUpdates: policy.autoApproveDepUpdates,
+        untouchableCount: policy.untouchablePaths.length,
+        lastJob: lastJob
+            ? {
+                jobId: lastJob.jobId,
+                status: lastJob.status,
+                createdAt: lastJob.createdAt,
+                completedAt: lastJob.completedAt,
+                appliedCount: lastJob.healResult?.appliedCount,
+                skippedCount: lastJob.healResult?.skippedCount,
+                errorCount: lastJob.healResult?.errorCount,
+            }
+            : undefined,
+        pendingConfirmationJobs,
+        lastRemoteEvent,
+        lastRemoteEventAt,
+        remote: reg.remote
+            ? {
+                owner: reg.remote.owner,
+                repo: reg.remote.repo,
+                defaultBranch: reg.remote.defaultBranch,
+                lastPushedAt: reg.remote.lastPushedAt,
+                lastHealPr: reg.remote.lastHealPr,
+            }
+            : undefined,
+        health: classifyHealth(drift, pendingConfirmationJobs, lastJob?.status),
+    };
+}
+export function buildFleetSummary() {
+    const regs = listKitForkRegistrations();
+    const forks = regs.map((r) => buildForkSummary(r));
+    const byHealth = {
+        clean: 0,
+        "drift-minor": 0,
+        "drift-major": 0,
+        "awaiting-confirmation": 0,
+        error: 0,
+        unknown: 0,
+    };
+    const bySeverity = {
+        none: 0,
+        info: 0,
+        warning: 0,
+        critical: 0,
+    };
+    const byKit = {};
+    let forksWithRemote = 0;
+    let forksAwaitingConfirmation = 0;
+    let pendingApprovalCount = 0;
+    for (const f of forks) {
+        byHealth[f.health] += 1;
+        bySeverity[f.driftSeverity] += 1;
+        byKit[f.kitId] = (byKit[f.kitId] ?? 0) + 1;
+        if (f.remote)
+            forksWithRemote += 1;
+        if (f.pendingConfirmationJobs > 0)
+            forksAwaitingConfirmation += 1;
+        pendingApprovalCount += f.pendingConfirmationJobs;
+    }
+    return {
+        generatedAt: new Date().toISOString(),
+        totalForks: forks.length,
+        byHealth,
+        bySeverity,
+        byKit,
+        forksWithRemote,
+        forksAwaitingConfirmation,
+        pendingApprovalCount,
+        forks,
+    };
+}
+//# sourceMappingURL=summary.js.map

package/dist/fleet/summary.js.map

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