@growthub/cli 0.6.0 → 0.6.2

package/dist/kits/core/validation/index.js

@@ -0,0 +1,128 @@
+/**
+ * Fork Adapter Core — Shared Validation Runner
+ *
+ * Runs all adapter-core validators against a ForkAdapterCoreConfig.
+ * Used by:
+ *   - CLI kit validate command (authoring time)
+ *   - Export QA scripts (packaging time)
+ *   - Agent session init (runtime time, via CLAUDE.md Step 0)
+ *
+ * Aggregates results from:
+ *   - env-gate
+ *   - setup-validation
+ *   - fork-inspector
+ *   - provider-adapter
+ *   - runtime-surface
+ *   - output-contract
+ */
+import { runEnvGate } from "../adapter-core/env-gate.js";
+import { validateSetup } from "../adapter-core/setup-validation.js";
+import { inspectFork } from "../adapter-core/fork-inspector.js";
+import { validateProviderContract } from "../adapter-core/provider-adapter.js";
+import { validateRuntimeSurfaceContract } from "../adapter-core/runtime-surface.js";
+import { validateOutputContract } from "../adapter-core/output-contract.js";
+// ---------------------------------------------------------------------------
+// Run full validation
+// ---------------------------------------------------------------------------
+export function runAdapterValidation(kitRoot, config, options = {}) {
+    const sections = [];
+    // Provider contract
+    const providerResult = validateProviderContract(kitRoot, config.provider);
+    sections.push({
+        name: "provider-contract",
+        valid: providerResult.valid,
+        issues: providerResult.issues,
+        passedChecks: providerResult.passedChecks,
+    });
+    // Setup validation
+    const setupResult = validateSetup(kitRoot, config.setup);
+    sections.push({
+        name: "setup-validation",
+        valid: setupResult.valid,
+        issues: setupResult.issues,
+        passedChecks: setupResult.passedChecks,
+    });
+    // Env gate (optional skip for pure authoring/packaging contexts)
+    if (!options.skipEnvGate) {
+        const envResult = runEnvGate(kitRoot, config.envGate);
+        sections.push({
+            name: "env-gate",
+            valid: envResult.valid,
+            issues: envResult.issues,
+            passedChecks: envResult.passedChecks,
+        });
+    }
+    // Fork inspection (optional skip)
+    if (!options.skipForkInspection) {
+        const forkResult = inspectFork(config.forkInspection, {
+            includeHashes: options.includeFileHashes,
+        });
+        sections.push({
+            name: "fork-inspection",
+            valid: forkResult.valid,
+            issues: forkResult.issues,
+            passedChecks: forkResult.passedChecks,
+        });
+    }
+    // Runtime surface
+    const surfaceResult = validateRuntimeSurfaceContract(config.runtimeSurface);
+    sections.push({
+        name: "runtime-surface",
+        valid: surfaceResult.valid,
+        issues: surfaceResult.issues,
+        passedChecks: surfaceResult.passedChecks,
+    });
+    // Output contract
+    const outputResult = validateOutputContract(kitRoot, config.output);
+    sections.push({
+        name: "output-contract",
+        valid: outputResult.valid,
+        issues: outputResult.issues,
+        passedChecks: outputResult.passedChecks,
+    });
+    // Aggregate
+    const allIssues = sections.flatMap((s) => s.issues);
+    const allPassedChecks = sections.flatMap((s) => s.passedChecks);
+    const totalErrors = countBySeverity(allIssues, "error");
+    const totalWarnings = countBySeverity(allIssues, "warning");
+    const totalInfos = countBySeverity(allIssues, "info");
+    return {
+        kitId: config.kitId,
+        family: config.family,
+        overallValid: sections.every((s) => s.valid),
+        sections,
+        totalErrors,
+        totalWarnings,
+        totalInfos,
+        passedChecks: allPassedChecks,
+    };
+}
+// ---------------------------------------------------------------------------
+// Format report for CLI output
+// ---------------------------------------------------------------------------
+export function formatAdapterValidationReport(report) {
+    const lines = [
+        `=== Adapter Validation Report ===`,
+        `Kit: ${report.kitId}  Family: ${report.family}`,
+        `Result: ${report.overallValid ? "PASSED" : "FAILED"}  Errors: ${report.totalErrors}  Warnings: ${report.totalWarnings}`,
+        "",
+    ];
+    for (const section of report.sections) {
+        lines.push(`[${section.valid ? "OK" : "FAIL"}] ${section.name}`);
+        for (const issue of section.issues) {
+            const prefix = issue.severity === "error" ? "  ERROR" : issue.severity === "warning" ? "  WARN " : "  INFO ";
+            lines.push(`${prefix}  ${issue.message}`);
+        }
+        if (section.passedChecks.length > 0) {
+            lines.push(`  Passed: ${section.passedChecks.join(", ")}`);
+        }
+    }
+    return lines.join("\n");
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function countBySeverity(issues, severity) {
+    return issues.filter((i) => i.severity === severity).length;
+}
+//# sourceMappingURL=index.js.map

package/dist/kits/core/validation/index.js.map

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

package/dist/kits/fork-policy.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Kit Fork Policy
+ *
+ * Per-fork user preferences that drive the Self-Healing agent's behaviour.
+ *
+ * Canonical location (in-fork, kernel-packet-style):
+ *   <forkPath>/.growthub-fork/policy.json
+ *
+ * Every agent action — drift detection, heal plan build, remote push — reads
+ * this policy and MUST honour it. The policy is authoritative. If the file is
+ * absent a conservative default is used (require confirmation for every
+ * non-additive change).
+ */
+export type PolicyAutoApprove = "none" | "additive" | "all";
+export interface KitForkPolicy {
+    version: 1;
+    /**
+     * Paths (glob-lite — leading/trailing slashes ignored) the agent is never
+     * allowed to touch. Stronger than USER_PROTECTED_PATTERNS: this is the
+     * user's personal invariant list.
+     */
+    untouchablePaths: string[];
+    /**
+     * Paths the agent may only modify after explicit user confirmation per run.
+     * The CLI prompts interactively; async jobs pause and surface a "needs
+     * confirmation" state.
+     */
+    confirmBeforeChange: string[];
+    /**
+     * How aggressively to auto-approve heal actions.
+     *   - "none":     every action requires confirmation (safest)
+     *   - "additive": adding files and additive dep merges auto-approve;
+     *                 modifications still require confirmation (default)
+     *   - "all":      all safe actions auto-approve (still honours
+     *                 untouchablePaths + skip_user_modified)
+     */
+    autoApprove: PolicyAutoApprove;
+    /**
+     * Controls dependency update confirmation specifically.
+     *   - "none":     never auto-approve dep changes
+     *   - "additive": new dep additions auto-approve, upgrades need confirm
+     *   - "all":      even upgrades auto-approve (still additive-only, never
+     *                 removes user deps)
+     */
+    autoApproveDepUpdates: PolicyAutoApprove;
+    /**
+     * Remote sync behaviour.
+     *   - "off":    purely local fork, no remote interaction
+     *   - "branch": push heal commits to a dedicated branch on the remote
+     *   - "pr":     push branch + open a pull request via the GitHub client
+     */
+    remoteSyncMode: "off" | "branch" | "pr";
+    /**
+     * When true, conflicts during remote sync pause the job and surface to the
+     * user for negotiation; otherwise the job fails fast and leaves local work
+     * intact.
+     */
+    interactiveConflicts: boolean;
+    /**
+     * User-declared local scripts that the agent may run during a heal. Each
+     * entry is a path INSIDE the fork. Nothing outside this list is ever
+     * executed.
+     */
+    allowedScripts: string[];
+    /** ISO timestamp of last policy write. */
+    updatedAt: string;
+}
+export declare function makeDefaultKitForkPolicy(): KitForkPolicy;
+export declare function readKitForkPolicy(forkPath: string): KitForkPolicy;
+export declare function writeKitForkPolicy(forkPath: string, policy: KitForkPolicy): void;
+export declare function updateKitForkPolicy(forkPath: string, patch: Partial<KitForkPolicy>): KitForkPolicy;
+export declare function isUntouchable(policy: KitForkPolicy, relativePath: string): boolean;
+export declare function requiresConfirmation(policy: KitForkPolicy, relativePath: string): boolean;
+export declare function canAutoApplyAddition(policy: KitForkPolicy): boolean;
+export declare function canAutoApplyModification(policy: KitForkPolicy): boolean;
+export declare function canAutoApplyDepAddition(policy: KitForkPolicy): boolean;
+export declare function canAutoApplyDepUpgrade(policy: KitForkPolicy): boolean;
+//# sourceMappingURL=fork-policy.d.ts.map

package/dist/kits/fork-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork-policy.d.ts","sourceRoot":"","sources":["../../src/kits/fork-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,CAAC,CAAC;IAEX;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAE3B;;;;OAIG;IACH,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAE9B;;;;;;;OAOG;IACH,WAAW,EAAE,iBAAiB,CAAC;IAE/B;;;;;;OAMG;IACH,qBAAqB,EAAE,iBAAiB,CAAC;IAEzC;;;;;OAKG;IACH,cAAc,EAAE,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;IAExC;;;;OAIG;IACH,oBAAoB,EAAE,OAAO,CAAC;IAE9B;;;;OAIG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,wBAAgB,wBAAwB,IAAI,aAAa,CAYxD;AAMD,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CASjE;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAKhF;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,GAC5B,aAAa,CAKf;AAgBD,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAElF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAEzF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAEnE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAEvE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAEtE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAErE"}

package/dist/kits/fork-policy.js

@@ -0,0 +1,92 @@
+/**
+ * Kit Fork Policy
+ *
+ * Per-fork user preferences that drive the Self-Healing agent's behaviour.
+ *
+ * Canonical location (in-fork, kernel-packet-style):
+ *   <forkPath>/.growthub-fork/policy.json
+ *
+ * Every agent action — drift detection, heal plan build, remote push — reads
+ * this policy and MUST honour it. The policy is authoritative. If the file is
+ * absent a conservative default is used (require confirmation for every
+ * non-additive change).
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { resolveInForkStateDir } from "../config/kit-forks-home.js";
+// ---------------------------------------------------------------------------
+// Defaults — conservative: confirm everything, local-only
+// ---------------------------------------------------------------------------
+export function makeDefaultKitForkPolicy() {
+    return {
+        version: 1,
+        untouchablePaths: [],
+        confirmBeforeChange: ["package.json", "kit.json"],
+        autoApprove: "additive",
+        autoApproveDepUpdates: "additive",
+        remoteSyncMode: "off",
+        interactiveConflicts: true,
+        allowedScripts: [],
+        updatedAt: new Date().toISOString(),
+    };
+}
+function resolvePolicyPath(forkPath) {
+    return path.resolve(resolveInForkStateDir(forkPath), "policy.json");
+}
+export function readKitForkPolicy(forkPath) {
+    const p = resolvePolicyPath(forkPath);
+    if (!fs.existsSync(p))
+        return makeDefaultKitForkPolicy();
+    try {
+        const parsed = JSON.parse(fs.readFileSync(p, "utf8"));
+        return { ...makeDefaultKitForkPolicy(), ...parsed, version: 1 };
+    }
+    catch {
+        return makeDefaultKitForkPolicy();
+    }
+}
+export function writeKitForkPolicy(forkPath, policy) {
+    const p = resolvePolicyPath(forkPath);
+    fs.mkdirSync(path.dirname(p), { recursive: true });
+    const body = { ...policy, version: 1, updatedAt: new Date().toISOString() };
+    fs.writeFileSync(p, JSON.stringify(body, null, 2) + "\n", "utf8");
+}
+export function updateKitForkPolicy(forkPath, patch) {
+    const current = readKitForkPolicy(forkPath);
+    const next = { ...current, ...patch, version: 1 };
+    writeKitForkPolicy(forkPath, next);
+    return next;
+}
+// ---------------------------------------------------------------------------
+// Policy evaluation helpers (pure — no I/O)
+// ---------------------------------------------------------------------------
+function matchesAnyPrefix(targetPath, patterns) {
+    const normalized = targetPath.replace(/^\/+|\/+$/g, "");
+    return patterns.some((pat) => {
+        const normPat = pat.replace(/^\/+|\/+$/g, "");
+        if (!normPat)
+            return false;
+        if (normalized === normPat)
+            return true;
+        return normalized.startsWith(`${normPat}/`);
+    });
+}
+export function isUntouchable(policy, relativePath) {
+    return matchesAnyPrefix(relativePath, policy.untouchablePaths);
+}
+export function requiresConfirmation(policy, relativePath) {
+    return matchesAnyPrefix(relativePath, policy.confirmBeforeChange);
+}
+export function canAutoApplyAddition(policy) {
+    return policy.autoApprove === "additive" || policy.autoApprove === "all";
+}
+export function canAutoApplyModification(policy) {
+    return policy.autoApprove === "all";
+}
+export function canAutoApplyDepAddition(policy) {
+    return policy.autoApproveDepUpdates === "additive" || policy.autoApproveDepUpdates === "all";
+}
+export function canAutoApplyDepUpgrade(policy) {
+    return policy.autoApproveDepUpdates === "all";
+}
+//# sourceMappingURL=fork-policy.js.map

package/dist/kits/fork-policy.js.map

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

package/dist/kits/fork-registry.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Kit Fork Registry
+ *
+ * Canonical fork state lives INSIDE the fork itself at:
+ *   <forkPath>/.growthub-fork/fork.json
+ *
+ * The fork directory is therefore self-describing — move the fork, its
+ * kernel-packet-style registration moves with it. No Paperclip harness
+ * coupling, no external home directory required for correctness.
+ *
+ * A thin CLI-owned discovery index at:
+ *   GROWTHUB_KIT_FORKS_HOME/index.json   (default: ~/.growthub/kit-forks/index.json)
+ *
+ * lets `list` / `status` commands enumerate registered forks without scanning
+ * the filesystem. The index is rebuildable from the in-fork files and is
+ * authoritative only for discovery — never for canonical registration fields.
+ */
+import type { KitForkRegistration, RegisterKitForkOptions } from "./fork-types.js";
+/**
+ * Root CLI-owned directory for kit-forks operational state.
+ * Kept for test/gate compatibility; does NOT hold canonical registration
+ * content (that lives inside each fork).
+ */
+export declare function resolveKitForksRoot(): string;
+/**
+ * Register a new fork directory.
+ * Writes <forkPath>/.growthub-fork/fork.json and adds an index entry.
+ * Throws if forkPath does not exist on disk.
+ */
+export declare function registerKitFork(opts: RegisterKitForkOptions): KitForkRegistration;
+/** Persist an updated registration (e.g. after a successful sync). */
+export declare function updateKitForkRegistration(reg: KitForkRegistration): void;
+/** Load a specific fork by kitId + forkId. Resolves via the discovery index. */
+export declare function loadKitForkRegistration(kitId: string, forkId: string): KitForkRegistration | null;
+/**
+ * List all registered forks.
+ * Pass filterKitId to restrict results to a single kit.
+ * Stale index entries (forkPath no longer exists) are silently skipped.
+ */
+export declare function listKitForkRegistrations(filterKitId?: string): KitForkRegistration[];
+/**
+ * Remove a fork registration.  Deletes the in-fork .growthub-fork/ state
+ * directory and drops the index entry.  Does NOT touch any of the user's
+ * content files outside .growthub-fork/.
+ * Returns true if the registration was found and removed.
+ */
+export declare function deregisterKitFork(kitId: string, forkId: string): boolean;
+/**
+ * Look up the canonical forkPath for a (kitId, forkId) pair via the index.
+ * Returns null when no entry exists. Used by the job agent to route job state
+ * into the fork's own `.growthub-fork/jobs/` directory when possible.
+ */
+export declare function lookupKitForkPath(kitId: string, forkId: string): string | null;
+//# sourceMappingURL=fork-registry.d.ts.map

package/dist/kits/fork-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork-registry.d.ts","sourceRoot":"","sources":["../../src/kits/fork-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAUH,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAwDnF;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAiDD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,mBAAmB,CAyBjF;AAED,sEAAsE;AACtE,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,CAQxE;AAED,gFAAgF;AAChF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAKjG;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAYpF;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAUxE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK9E"}

package/dist/kits/fork-registry.js

@@ -0,0 +1,201 @@
+/**
+ * Kit Fork Registry
+ *
+ * Canonical fork state lives INSIDE the fork itself at:
+ *   <forkPath>/.growthub-fork/fork.json
+ *
+ * The fork directory is therefore self-describing — move the fork, its
+ * kernel-packet-style registration moves with it. No Paperclip harness
+ * coupling, no external home directory required for correctness.
+ *
+ * A thin CLI-owned discovery index at:
+ *   GROWTHUB_KIT_FORKS_HOME/index.json   (default: ~/.growthub/kit-forks/index.json)
+ *
+ * lets `list` / `status` commands enumerate registered forks without scanning
+ * the filesystem. The index is rebuildable from the in-fork files and is
+ * authoritative only for discovery — never for canonical registration fields.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { resolveKitForksHomeDir, resolveKitForksIndexPath, resolveInForkStateDir, resolveInForkRegistrationPath, } from "../config/kit-forks-home.js";
+function readIndex() {
+    const p = resolveKitForksIndexPath();
+    if (!fs.existsSync(p))
+        return { version: 1, entries: [] };
+    try {
+        const parsed = JSON.parse(fs.readFileSync(p, "utf8"));
+        if (!parsed || !Array.isArray(parsed.entries))
+            return { version: 1, entries: [] };
+        return parsed;
+    }
+    catch {
+        return { version: 1, entries: [] };
+    }
+}
+function writeIndex(index) {
+    const p = resolveKitForksIndexPath();
+    fs.mkdirSync(path.dirname(p), { recursive: true });
+    fs.writeFileSync(p, JSON.stringify(index, null, 2) + "\n", "utf8");
+}
+function upsertIndexEntry(entry) {
+    const index = readIndex();
+    const idx = index.entries.findIndex((e) => e.forkId === entry.forkId && e.kitId === entry.kitId);
+    if (idx >= 0)
+        index.entries[idx] = entry;
+    else
+        index.entries.push(entry);
+    writeIndex(index);
+}
+function removeIndexEntry(kitId, forkId) {
+    const index = readIndex();
+    const next = index.entries.filter((e) => !(e.kitId === kitId && e.forkId === forkId));
+    if (next.length !== index.entries.length)
+        writeIndex({ ...index, entries: next });
+}
+// ---------------------------------------------------------------------------
+// Public path helpers (preserved names for stable external API)
+// ---------------------------------------------------------------------------
+/**
+ * Root CLI-owned directory for kit-forks operational state.
+ * Kept for test/gate compatibility; does NOT hold canonical registration
+ * content (that lives inside each fork).
+ */
+export function resolveKitForksRoot() {
+    return resolveKitForksHomeDir();
+}
+// ---------------------------------------------------------------------------
+// ID generation
+// ---------------------------------------------------------------------------
+function sanitizeForkId(raw) {
+    return raw
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, "-")
+        .replace(/-+/g, "-")
+        .slice(0, 56);
+}
+function generateForkId(forkPath, kitId) {
+    const dirName = path.basename(forkPath);
+    const base = sanitizeForkId(`${kitId}-${dirName}`);
+    const suffix = Date.now().toString(36).slice(-4);
+    return `${base}-${suffix}`;
+}
+// ---------------------------------------------------------------------------
+// Low-level in-fork read / write
+// ---------------------------------------------------------------------------
+function readForkJson(forkPath) {
+    const p = resolveInForkRegistrationPath(forkPath);
+    if (!fs.existsSync(p))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(p, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+function writeForkJson(reg) {
+    const stateDir = resolveInForkStateDir(reg.forkPath);
+    fs.mkdirSync(stateDir, { recursive: true });
+    fs.writeFileSync(resolveInForkRegistrationPath(reg.forkPath), JSON.stringify(reg, null, 2) + "\n", "utf8");
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Register a new fork directory.
+ * Writes <forkPath>/.growthub-fork/fork.json and adds an index entry.
+ * Throws if forkPath does not exist on disk.
+ */
+export function registerKitFork(opts) {
+    const resolvedPath = path.resolve(opts.forkPath);
+    if (!fs.existsSync(resolvedPath)) {
+        throw new Error(`Fork path does not exist: ${resolvedPath}`);
+    }
+    const forkId = generateForkId(resolvedPath, opts.kitId);
+    const reg = {
+        forkId,
+        kitId: opts.kitId,
+        baseVersion: opts.baseVersion,
+        forkPath: resolvedPath,
+        registeredAt: new Date().toISOString(),
+        label: opts.label,
+        customSkills: opts.customSkills ?? [],
+    };
+    writeForkJson(reg);
+    upsertIndexEntry({
+        forkId: reg.forkId,
+        kitId: reg.kitId,
+        forkPath: reg.forkPath,
+        registeredAt: reg.registeredAt,
+    });
+    return reg;
+}
+/** Persist an updated registration (e.g. after a successful sync). */
+export function updateKitForkRegistration(reg) {
+    writeForkJson(reg);
+    upsertIndexEntry({
+        forkId: reg.forkId,
+        kitId: reg.kitId,
+        forkPath: reg.forkPath,
+        registeredAt: reg.registeredAt,
+    });
+}
+/** Load a specific fork by kitId + forkId. Resolves via the discovery index. */
+export function loadKitForkRegistration(kitId, forkId) {
+    const entry = readIndex().entries.find((e) => e.kitId === kitId && e.forkId === forkId);
+    if (!entry)
+        return null;
+    if (!fs.existsSync(entry.forkPath))
+        return null;
+    return readForkJson(entry.forkPath);
+}
+/**
+ * List all registered forks.
+ * Pass filterKitId to restrict results to a single kit.
+ * Stale index entries (forkPath no longer exists) are silently skipped.
+ */
+export function listKitForkRegistrations(filterKitId) {
+    const index = readIndex();
+    const results = [];
+    for (const entry of index.entries) {
+        if (filterKitId && entry.kitId !== filterKitId)
+            continue;
+        if (!fs.existsSync(entry.forkPath))
+            continue;
+        const reg = readForkJson(entry.forkPath);
+        if (reg)
+            results.push(reg);
+    }
+    return results.sort((a, b) => a.registeredAt.localeCompare(b.registeredAt));
+}
+/**
+ * Remove a fork registration.  Deletes the in-fork .growthub-fork/ state
+ * directory and drops the index entry.  Does NOT touch any of the user's
+ * content files outside .growthub-fork/.
+ * Returns true if the registration was found and removed.
+ */
+export function deregisterKitFork(kitId, forkId) {
+    const entry = readIndex().entries.find((e) => e.kitId === kitId && e.forkId === forkId);
+    if (!entry)
+        return false;
+    if (fs.existsSync(entry.forkPath)) {
+        const stateDir = resolveInForkStateDir(entry.forkPath);
+        fs.rmSync(stateDir, { recursive: true, force: true });
+    }
+    removeIndexEntry(kitId, forkId);
+    return true;
+}
+/**
+ * Look up the canonical forkPath for a (kitId, forkId) pair via the index.
+ * Returns null when no entry exists. Used by the job agent to route job state
+ * into the fork's own `.growthub-fork/jobs/` directory when possible.
+ */
+export function lookupKitForkPath(kitId, forkId) {
+    const entry = readIndex().entries.find((e) => e.kitId === kitId && e.forkId === forkId);
+    if (!entry)
+        return null;
+    if (!fs.existsSync(entry.forkPath))
+        return null;
+    return entry.forkPath;
+}
+//# sourceMappingURL=fork-registry.js.map

package/dist/kits/fork-registry.js.map

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

package/dist/kits/fork-remote.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Kit Fork Remote Git Operations
+ *
+ * Thin shell around `git` (child_process) for the operations fork-sync needs:
+ *   - detect whether a fork directory is a git repo
+ *   - read/write the `origin` remote URL
+ *   - create a branch, commit, push
+ *   - fetch + diff against origin
+ *
+ * All operations are scoped to the fork directory — no global git config
+ * mutation, no interactive credential prompts (callers pass an access token
+ * for HTTPS auth via the URL).
+ */
+import type { GithubRepoRef } from "../github/types.js";
+export interface GitOpResult {
+    ok: boolean;
+    stdout: string;
+    stderr: string;
+    code: number;
+}
+export declare function isGitRepo(forkPath: string): boolean;
+export declare function initGitRepo(forkPath: string): GitOpResult;
+export declare function getOriginUrl(forkPath: string): string | null;
+export declare function setOrigin(forkPath: string, cloneUrl: string): GitOpResult;
+export declare function currentBranch(forkPath: string): string | null;
+export declare function createBranch(forkPath: string, branchName: string, from?: string): GitOpResult;
+export declare function stageAll(forkPath: string): GitOpResult;
+export declare function commit(forkPath: string, message: string): GitOpResult;
+export declare function fetchOrigin(forkPath: string): GitOpResult;
+export declare function pushBranch(forkPath: string, branchName: string): GitOpResult;
+/**
+ * Build an HTTPS clone URL that embeds a token for push auth.
+ * Token is passed once at invocation time; never stored in the repo config.
+ */
+export declare function buildTokenCloneUrl(repo: GithubRepoRef, token: string): string;
+/**
+ * One-shot: switch to / create a heal branch, stage, commit, push.
+ * Returns the pushed branch name on success.
+ */
+export declare function pushHealCommit(opts: {
+    forkPath: string;
+    branchName: string;
+    commitMessage: string;
+    baseBranch?: string;
+}): {
+    branch: string;
+    pushed: boolean;
+    detail: string;
+};
+/** Quick sanity: `git --version` is callable on this system. */
+export declare function gitAvailable(): boolean;
+//# sourceMappingURL=fork-remote.d.ts.map

package/dist/kits/fork-remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork-remote.d.ts","sourceRoot":"","sources":["../../src/kits/fork-remote.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAiBD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAInD;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAEzD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK5D;AAED,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CAIzE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK7D;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAG7F;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAEtD;AAED,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAErE;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAEzD;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAE5E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAgBtD;AAED,gEAAgE;AAChE,wBAAgB,YAAY,IAAI,OAAO,CAOtC"}