@growthub/cli 0.6.0 → 0.6.2

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

@@ -0,0 +1,29 @@
+/**
+ * Kit Fork Trace Log
+ *
+ * Append-only JSONL event stream per fork. Gives the agent a durable trace
+ * across long-running and cross-session work — every drift scan, every heal
+ * plan, every remote operation, every conflict is recorded.
+ *
+ * Canonical location (in-fork):
+ *   <forkPath>/.growthub-fork/trace.jsonl
+ *
+ * Never truncated by the agent. Users can manually rotate if file size grows.
+ */
+export type KitForkTraceEventType = "registered" | "deregistered" | "policy_updated" | "status_ran" | "heal_proposed" | "heal_confirmed" | "heal_applied" | "heal_skipped" | "heal_failed" | "remote_connected" | "remote_pushed" | "remote_pr_opened" | "conflict_encountered" | "conflict_resolved" | "conflict_aborted" | "script_executed" | "agent_checkpoint";
+export interface KitForkTraceEvent {
+    timestamp: string;
+    forkId: string;
+    kitId: string;
+    jobId?: string;
+    type: KitForkTraceEventType;
+    summary: string;
+    /** Free-form structured detail; kept small (<2 KB) per event. */
+    detail?: Record<string, unknown>;
+}
+export declare function appendKitForkTraceEvent(forkPath: string, event: Omit<KitForkTraceEvent, "timestamp"> & {
+    timestamp?: string;
+}): KitForkTraceEvent;
+export declare function readKitForkTrace(forkPath: string): KitForkTraceEvent[];
+export declare function tailKitForkTrace(forkPath: string, n: number): KitForkTraceEvent[];
+//# sourceMappingURL=fork-trace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fork-trace.d.ts","sourceRoot":"","sources":["../../src/kits/fork-trace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,MAAM,qBAAqB,GAC7B,YAAY,GACZ,cAAc,GACd,gBAAgB,GAChB,YAAY,GACZ,eAAe,GACf,gBAAgB,GAChB,cAAc,GACd,cAAc,GACd,aAAa,GACb,kBAAkB,GAClB,eAAe,GACf,kBAAkB,GAClB,sBAAsB,GACtB,mBAAmB,GACnB,kBAAkB,GAClB,iBAAiB,GACjB,kBAAkB,CAAC;AAEvB,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAMD,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,GAAG;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACnE,iBAAiB,CASnB;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAgBtE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAGjF"}

package/dist/kits/fork-trace.js

@@ -0,0 +1,54 @@
+/**
+ * Kit Fork Trace Log
+ *
+ * Append-only JSONL event stream per fork. Gives the agent a durable trace
+ * across long-running and cross-session work — every drift scan, every heal
+ * plan, every remote operation, every conflict is recorded.
+ *
+ * Canonical location (in-fork):
+ *   <forkPath>/.growthub-fork/trace.jsonl
+ *
+ * Never truncated by the agent. Users can manually rotate if file size grows.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { resolveInForkStateDir } from "../config/kit-forks-home.js";
+function resolveTracePath(forkPath) {
+    return path.resolve(resolveInForkStateDir(forkPath), "trace.jsonl");
+}
+export function appendKitForkTraceEvent(forkPath, event) {
+    const full = {
+        ...event,
+        timestamp: event.timestamp ?? new Date().toISOString(),
+    };
+    const p = resolveTracePath(forkPath);
+    fs.mkdirSync(path.dirname(p), { recursive: true });
+    fs.appendFileSync(p, JSON.stringify(full) + "\n", "utf8");
+    return full;
+}
+export function readKitForkTrace(forkPath) {
+    const p = resolveTracePath(forkPath);
+    if (!fs.existsSync(p))
+        return [];
+    const raw = fs.readFileSync(p, "utf8").trim();
+    if (!raw)
+        return [];
+    const events = [];
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            events.push(JSON.parse(trimmed));
+        }
+        catch {
+            /* tolerate malformed lines — never crash the agent */
+        }
+    }
+    return events;
+}
+export function tailKitForkTrace(forkPath, n) {
+    const events = readKitForkTrace(forkPath);
+    return events.slice(Math.max(0, events.length - n));
+}
+//# sourceMappingURL=fork-trace.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fork-trace.js","sourceRoot":"","sources":["../../src/kits/fork-trace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAgCpE,SAAS,gBAAgB,CAAC,QAAgB;IACxC,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,QAAgB,EAChB,KAAoE;IAEpE,MAAM,IAAI,GAAsB;QAC9B,GAAG,KAAK;QACR,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACvD,CAAC;IACF,MAAM,CAAC,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACrC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,CAAC,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAsB,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,sDAAsD;QACxD,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB,EAAE,CAAS;IAC1D,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC"}

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

@@ -0,0 +1,198 @@
+/**
+ * Kit Fork Types
+ *
+ * Canonical type system for the worker kit fork & self-healing sync subsystem.
+ * Lives co-located in cli/src/kits/ alongside the existing kit contract types.
+ *
+ * A "kit fork" is a directory that was originally exported from a bundled
+ * worker kit and may contain user-authored customisations (custom skills,
+ * env overrides, modified workers, etc.).  The fork-sync engine tracks drift
+ * between the fork and the latest bundled upstream, produces a structured
+ * report, and applies a safe non-destructive heal that preserves every user
+ * modification while bringing the fork's scaffold and package dependencies
+ * up to date.
+ */
+/**
+ * A registered fork entry. Canonical state lives inside the fork at:
+ *   <forkPath>/.growthub-fork/fork.json
+ *
+ * A thin CLI-owned discovery index at GROWTHUB_KIT_FORKS_HOME/index.json
+ * (default ~/.growthub/kit-forks/index.json) enumerates registered forks
+ * without filesystem scans. The in-fork file is authoritative; the index
+ * is rebuildable.
+ */
+export interface KitForkRegistration {
+    /** Stable unique ID generated at registration time */
+    forkId: string;
+    /** Canonical bundled kit ID (matches BUNDLED_KIT_CATALOG entry) */
+    kitId: string;
+    /** Kit version the fork was based on at registration time */
+    baseVersion: string;
+    /** Absolute path to the user's fork directory */
+    forkPath: string;
+    /** ISO-8601 timestamp of registration */
+    registeredAt: string;
+    /** ISO-8601 timestamp of last successful upstream sync */
+    lastSyncedAt?: string;
+    /** User-provided label for this fork */
+    label?: string;
+    /**
+     * Relative paths inside forkPath that the user has explicitly declared as
+     * custom skills.  The sync engine always preserves these.
+     */
+    customSkills?: string[];
+    /**
+     * GitHub remote binding, when the fork is hosted on GitHub. Populated by
+     * `growthub kit fork create` (one-click fork) or `growthub kit fork connect`.
+     */
+    remote?: KitForkRemoteBinding;
+}
+export interface KitForkRemoteBinding {
+    provider: "github";
+    /** GitHub owner (user or org) the fork lives under. */
+    owner: string;
+    /** Repository name on GitHub. */
+    repo: string;
+    /** Default branch on the remote (e.g. "main"). */
+    defaultBranch: string;
+    /** HTTPS clone URL. */
+    cloneUrl: string;
+    /** Browser URL for the fork. */
+    htmlUrl: string;
+    /** ISO timestamp of last successful remote push. */
+    lastPushedAt?: string;
+    /** Branch name used for the most recent heal push. */
+    lastHealBranch?: string;
+    /** PR number + URL opened by the most recent heal, when applicable. */
+    lastHealPr?: {
+        number: number;
+        htmlUrl: string;
+    };
+}
+export type KitDriftSeverity = "none" | "info" | "warning" | "critical";
+export interface KitFileDrift {
+    /** Relative path inside the kit directory */
+    relativePath: string;
+    /**
+     * added    — upstream has this file; fork does not
+     * modified — both have the file but content differs
+     * deleted  — fork has this file; upstream no longer ships it
+     */
+    changeType: "added" | "modified" | "deleted";
+    severity: KitDriftSeverity;
+    description: string;
+}
+export interface KitPackageDrift {
+    packageName: string;
+    /** null when the package is new in upstream and absent from fork */
+    forkVersion: string | null;
+    upstreamVersion: string;
+    changeType: "added" | "updated" | "removed";
+}
+export interface KitForkDriftReport {
+    forkId: string;
+    kitId: string;
+    /** Version the fork is currently at */
+    forkVersion: string;
+    /** Latest version in the bundled catalog */
+    upstreamVersion: string;
+    /** true when upstream is strictly newer than forkVersion */
+    hasUpstreamUpdate: boolean;
+    overallSeverity: KitDriftSeverity;
+    fileDrifts: KitFileDrift[];
+    packageDrifts: KitPackageDrift[];
+    /** Relative paths of user-authored files detected in the fork */
+    customSkillsDetected: string[];
+    generatedAt: string;
+}
+export type KitHealActionType = "add_file" | "update_package_json_deps" | "patch_manifest" | "add_custom_skill" | "skip_user_modified";
+export interface KitHealAction {
+    actionType: KitHealActionType;
+    /** Relative path inside the fork directory */
+    targetPath: string;
+    description: string;
+    /** true = zero risk of overwriting user content */
+    safe: boolean;
+    /** Action-specific detail payload */
+    payload?: Record<string, unknown>;
+    /**
+     * Set when the user's fork policy demands explicit confirmation before this
+     * action can be applied. The agent surfaces these to the user (interactive)
+     * or parks them in `requires_confirmation` state (background jobs).
+     */
+    needsConfirmation?: boolean;
+    /** Why confirmation is required — referenced in CLI prompts and trace. */
+    confirmationReason?: string;
+}
+export interface KitForkHealPlan {
+    forkId: string;
+    kitId: string;
+    fromVersion: string;
+    toVersion: string;
+    actions: KitHealAction[];
+    /** Paths the agent deliberately skips because the user modified them */
+    preservedPaths: string[];
+    estimatedRisk: KitDriftSeverity;
+    generatedAt: string;
+}
+export interface KitHealActionResult {
+    action: KitHealAction;
+    status: "applied" | "skipped" | "error";
+    detail?: string;
+}
+export interface KitForkHealResult {
+    forkId: string;
+    kitId: string;
+    fromVersion: string;
+    toVersion: string;
+    actionResults: KitHealActionResult[];
+    appliedCount: number;
+    skippedCount: number;
+    errorCount: number;
+    completedAt: string;
+    /** Updated registration written to disk after a clean sync */
+    updatedRegistration?: KitForkRegistration;
+}
+export type KitForkSyncJobStatus = "pending" | "running" | "awaiting_confirmation" | "completed" | "failed" | "cancelled";
+export interface KitForkSyncJob {
+    jobId: string;
+    forkId: string;
+    kitId: string;
+    status: KitForkSyncJobStatus;
+    createdAt: string;
+    startedAt?: string;
+    completedAt?: string;
+    driftReport?: KitForkDriftReport;
+    healPlan?: KitForkHealPlan;
+    healResult?: KitForkHealResult;
+    /** Action targetPaths still awaiting user confirmation. */
+    pendingConfirmations?: string[];
+    /** Remote push summary (if policy.remoteSyncMode !== "off"). */
+    remotePushSummary?: {
+        pushed: boolean;
+        branch?: string;
+        detail?: string;
+        prNumber?: number;
+        prUrl?: string;
+    };
+    error?: string;
+}
+export interface RegisterKitForkOptions {
+    forkPath: string;
+    kitId: string;
+    baseVersion: string;
+    label?: string;
+    customSkills?: string[];
+}
+export interface KitForkHealOptions {
+    dryRun?: boolean;
+    skipFiles?: string[];
+    onProgress?: (step: string) => void;
+    /**
+     * Explicit confirmations supplied by the caller for actions that the policy
+     * flags as `needsConfirmation`. Each entry is an action targetPath that the
+     * user has explicitly approved for this run.
+     */
+    confirmations?: string[];
+}
+//# sourceMappingURL=fork-types.d.ts.map

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

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

package/dist/kits/fork-types.js

@@ -0,0 +1,16 @@
+/**
+ * Kit Fork Types
+ *
+ * Canonical type system for the worker kit fork & self-healing sync subsystem.
+ * Lives co-located in cli/src/kits/ alongside the existing kit contract types.
+ *
+ * A "kit fork" is a directory that was originally exported from a bundled
+ * worker kit and may contain user-authored customisations (custom skills,
+ * env overrides, modified workers, etc.).  The fork-sync engine tracks drift
+ * between the fork and the latest bundled upstream, produces a structured
+ * report, and applies a safe non-destructive heal that preserves every user
+ * modification while bringing the fork's scaffold and package dependencies
+ * up to date.
+ */
+export {};
+//# sourceMappingURL=fork-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fork-types.js","sourceRoot":"","sources":["../../src/kits/fork-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/dist/kits/service.d.ts

@@ -0,0 +1,63 @@
+import { type KitValidationResult, type KitCapabilityType, type KitActivationMode, type KitFamily } from "./contract.js";
+export interface KitListItem {
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    type: KitCapabilityType;
+    family: KitFamily;
+    executionMode: string;
+    activationModes: KitActivationMode[];
+    bundleId: string;
+    bundleVersion: string;
+    briefType: string;
+}
+export interface KitInspectResult extends KitListItem {
+    entrypointPath: string;
+    agentContractPath: string;
+    brandTemplatePath: string;
+    publicExampleBrandPaths: string[];
+    frozenAssetCount: number;
+    requiredFrozenAssetCount: number;
+    outputRoot: string;
+    exportFolderName: string;
+    exportFolderPath: string;
+    exportZipName: string;
+    exportZipPath: string;
+    requiredPaths: string[];
+    compatibility: Record<string, unknown>;
+    schemaVersion: number;
+}
+export interface KitDownloadResult {
+    folderPath: string;
+    zipPath: string;
+}
+export interface KitDownloadProgress {
+    phase: "preparing" | "copying" | "zipping" | "writing_zip" | "done";
+    completed: number;
+    total: number;
+    percent: number;
+    detail: string;
+}
+export interface KitDownloadOptions {
+    onProgress?: (progress: KitDownloadProgress) => void;
+}
+export declare function validateKitDirectory(kitPath: string): KitValidationResult;
+export declare function validateBundledKitAssetRoot(assetRoot: string, input: {
+    kitId: string;
+    bundleId?: string;
+}): void;
+export declare function fuzzyResolveKitId(input: string): string | null;
+export declare function listBundledKits(): KitListItem[];
+export declare function inspectBundledKit(kitId: string, outDir?: string): KitInspectResult;
+export declare function resolveKitPath(kitId: string, outDir?: string): string;
+export interface BundledKitSourceInfo {
+    id: string;
+    version: string;
+    family: KitFamily;
+    assetRoot: string;
+}
+export declare function getBundledKitSourceInfo(kitId: string): BundledKitSourceInfo;
+export declare function copyBundledKitSource(kitId: string, destinationPath: string): BundledKitSourceInfo;
+export declare function downloadBundledKit(kitId: string, outDir?: string, options?: KitDownloadOptions): KitDownloadResult;
+//# sourceMappingURL=service.d.ts.map

package/dist/kits/service.d.ts.map

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