@growthub/cli 0.5.1 → 0.6.1

package/dist/kits/contract.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Kit Contract Type System
+ *
+ * Canonical types for the Growthub Agent Worker Kit capability packaging system.
+ *
+ * A kit is a versioned capability bundle — a portable, deployable artifact that
+ * owns its agent contract, workflow contract, assets, and execution assumptions.
+ *
+ * Schema versions:
+ *   v1 — Original worker kit export schema (list, inspect, download, path)
+ *   v2 — Capability packaging schema (adds type, execution mode, compatibility,
+ *         install metadata, activation modes)
+ */
+export type KitCapabilityType = "worker" | "workflow" | "output" | "ui";
+export type KitExecutionMode = "export" | "install" | "mount" | "run";
+export type KitActivationMode = "export" | "install" | "mount" | "run";
+export interface KitCompatibility {
+    cliMinVersion?: string;
+    platformMinVersion?: string;
+    requiredCapabilities?: string[];
+}
+export interface KitInstallMetadata {
+    installable: boolean;
+    scopeDefault?: "user" | "project";
+    postInstallHint?: string;
+}
+export interface KitUIMetadata {
+    icon?: string;
+    color?: string;
+    category?: string;
+    tags?: string[];
+}
+export interface KitProvenance {
+    sourceRepo?: string;
+    frozenAt?: string;
+    frozenBy?: string;
+    checksum?: string;
+}
+export type KitFamily = "studio" | "workflow" | "operator" | "ops";
+export declare const KIT_FAMILIES: KitFamily[];
+export interface KitIdentity {
+    id: string;
+    version: string;
+    name: string;
+    description: string;
+    type: KitCapabilityType;
+    family?: KitFamily;
+    visibility?: string;
+    sourceRepo?: string;
+}
+export interface KitEntrypoint {
+    workerId: string;
+    path: string;
+}
+export interface KitBundleRef {
+    id: string;
+    version: string;
+    path: string;
+}
+export interface KitOutputStandard {
+    type: string;
+    description?: string;
+    requiredPaths: string[];
+}
+export interface KitManifestV2 {
+    schemaVersion: 2;
+    kit: KitIdentity;
+    entrypoint: KitEntrypoint;
+    workerIds: string[];
+    agentContractPath: string;
+    brandTemplatePath: string;
+    publicExampleBrandPaths?: string[];
+    frozenAssetPaths: string[];
+    outputStandard: KitOutputStandard;
+    bundles: KitBundleRef[];
+    executionMode: KitExecutionMode;
+    activationModes: KitActivationMode[];
+    compatibility: KitCompatibility;
+    install?: KitInstallMetadata;
+    ui?: KitUIMetadata;
+    provenance?: KitProvenance;
+}
+export interface KitManifestV1 {
+    schemaVersion: 1;
+    kit: {
+        id: string;
+        version: string;
+        name: string;
+        description: string;
+        visibility?: string;
+        sourceRepo?: string;
+    };
+    entrypoint: KitEntrypoint;
+    workerIds: string[];
+    agentContractPath: string;
+    brandTemplatePath: string;
+    publicExampleBrandPaths?: string[];
+    frozenAssetPaths: string[];
+    outputStandard: KitOutputStandard;
+    bundles: KitBundleRef[];
+}
+export type KitManifest = KitManifestV1 | KitManifestV2;
+export interface BundleIdentity {
+    id: string;
+    version: string;
+    kitId: string;
+    workerId: string;
+}
+export interface BundleExportSpec {
+    folderName: string;
+    zipFileName: string;
+}
+export interface BundleManifestV2 {
+    schemaVersion: 2;
+    bundle: BundleIdentity;
+    briefType: string;
+    publicExampleBrandPaths?: string[];
+    requiredFrozenAssets: string[];
+    optionalPresets: string[];
+    export: BundleExportSpec;
+    activationModes?: KitActivationMode[];
+}
+export interface BundleManifestV1 {
+    schemaVersion: 1;
+    bundle: BundleIdentity;
+    briefType: string;
+    publicExampleBrandPaths?: string[];
+    requiredFrozenAssets: string[];
+    optionalPresets: string[];
+    export: BundleExportSpec;
+}
+export type BundleManifest = BundleManifestV1 | BundleManifestV2;
+export declare function isManifestV2(manifest: KitManifest): manifest is KitManifestV2;
+export declare function isManifestV1(manifest: KitManifest): manifest is KitManifestV1;
+export declare function isBundleManifestV2(manifest: BundleManifest): manifest is BundleManifestV2;
+export declare function normalizeManifest(manifest: KitManifest): KitManifestV2;
+export declare function normalizeBundleManifest(manifest: BundleManifest): BundleManifestV2;
+export interface KitValidationError {
+    field: string;
+    message: string;
+}
+export interface KitValidationResult {
+    valid: boolean;
+    schemaVersion: number;
+    kitId: string;
+    errors: KitValidationError[];
+    warnings: KitValidationError[];
+}
+export declare const SUPPORTED_SCHEMA_VERSIONS: readonly [1, 2];
+export declare const KIT_CAPABILITY_TYPES: readonly KitCapabilityType[];
+export declare const KIT_EXECUTION_MODES: readonly KitExecutionMode[];
+export declare const KIT_ACTIVATION_MODES: readonly KitActivationMode[];
+//# sourceMappingURL=contract.d.ts.map

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

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

package/dist/kits/contract.js

@@ -0,0 +1,89 @@
+/**
+ * Kit Contract Type System
+ *
+ * Canonical types for the Growthub Agent Worker Kit capability packaging system.
+ *
+ * A kit is a versioned capability bundle — a portable, deployable artifact that
+ * owns its agent contract, workflow contract, assets, and execution assumptions.
+ *
+ * Schema versions:
+ *   v1 — Original worker kit export schema (list, inspect, download, path)
+ *   v2 — Capability packaging schema (adds type, execution mode, compatibility,
+ *         install metadata, activation modes)
+ */
+export const KIT_FAMILIES = ["studio", "workflow", "operator", "ops"];
+// ---------------------------------------------------------------------------
+// Type guards
+// ---------------------------------------------------------------------------
+export function isManifestV2(manifest) {
+    return manifest.schemaVersion === 2;
+}
+export function isManifestV1(manifest) {
+    return manifest.schemaVersion === 1;
+}
+export function isBundleManifestV2(manifest) {
+    return manifest.schemaVersion === 2;
+}
+// ---------------------------------------------------------------------------
+// Normalization — lift v1 to v2 shape for uniform processing
+// ---------------------------------------------------------------------------
+export function normalizeManifest(manifest) {
+    if (isManifestV2(manifest))
+        return manifest;
+    return {
+        schemaVersion: 2,
+        kit: {
+            ...manifest.kit,
+            type: "worker",
+        },
+        entrypoint: manifest.entrypoint,
+        workerIds: manifest.workerIds,
+        agentContractPath: manifest.agentContractPath,
+        brandTemplatePath: manifest.brandTemplatePath,
+        publicExampleBrandPaths: manifest.publicExampleBrandPaths,
+        frozenAssetPaths: manifest.frozenAssetPaths,
+        outputStandard: manifest.outputStandard,
+        bundles: manifest.bundles,
+        executionMode: "export",
+        activationModes: ["export"],
+        compatibility: {},
+        provenance: manifest.kit.sourceRepo ? { sourceRepo: manifest.kit.sourceRepo } : undefined,
+    };
+}
+export function normalizeBundleManifest(manifest) {
+    if (isBundleManifestV2(manifest))
+        return manifest;
+    return {
+        schemaVersion: 2,
+        bundle: manifest.bundle,
+        briefType: manifest.briefType,
+        publicExampleBrandPaths: manifest.publicExampleBrandPaths,
+        requiredFrozenAssets: manifest.requiredFrozenAssets,
+        optionalPresets: manifest.optionalPresets,
+        export: manifest.export,
+        activationModes: ["export"],
+    };
+}
+// ---------------------------------------------------------------------------
+// Supported schema versions
+// ---------------------------------------------------------------------------
+export const SUPPORTED_SCHEMA_VERSIONS = [1, 2];
+export const KIT_CAPABILITY_TYPES = [
+    "worker",
+    "workflow",
+    "output",
+    "ui",
+];
+export const KIT_EXECUTION_MODES = [
+    "export",
+    "install",
+    "mount",
+    "run",
+];
+export const KIT_ACTIVATION_MODES = [
+    "export",
+    "install",
+    "mount",
+    "run",
+];
+//# sourceMappingURL=contract.js.map

package/dist/kits/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/kits/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA2DH,MAAM,CAAC,MAAM,YAAY,GAAgB,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;AA0HnF,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E,MAAM,UAAU,YAAY,CAAC,QAAqB;IAChD,OAAO,QAAQ,CAAC,aAAa,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAqB;IAChD,OAAO,QAAQ,CAAC,aAAa,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAwB;IACzD,OAAO,QAAQ,CAAC,aAAa,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,8EAA8E;AAC9E,6DAA6D;AAC7D,8EAA8E;AAE9E,MAAM,UAAU,iBAAiB,CAAC,QAAqB;IACrD,IAAI,YAAY,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAE5C,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,GAAG,EAAE;YACH,GAAG,QAAQ,CAAC,GAAG;YACf,IAAI,EAAE,QAAQ;SACf;QACD,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;QAC7C,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;QAC7C,uBAAuB,EAAE,QAAQ,CAAC,uBAAuB;QACzD,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;QAC3C,cAAc,EAAE,QAAQ,CAAC,cAAc;QACvC,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,aAAa,EAAE,QAAQ;QACvB,eAAe,EAAE,CAAC,QAAQ,CAAC;QAC3B,aAAa,EAAE,EAAE;QACjB,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS;KAC1F,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAwB;IAC9D,IAAI,kBAAkB,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAElD,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,uBAAuB,EAAE,QAAQ,CAAC,uBAAuB;QACzD,oBAAoB,EAAE,QAAQ,CAAC,oBAAoB;QACnD,eAAe,EAAE,QAAQ,CAAC,eAAe;QACzC,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,eAAe,EAAE,CAAC,QAAQ,CAAC;KAC5B,CAAC;AACJ,CAAC;AAmBD,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAE9E,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,EAAE,CAAC,CAAU,CAAC;AAEzD,MAAM,CAAC,MAAM,oBAAoB,GAAiC;IAChE,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,IAAI;CACI,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAgC;IAC9D,QAAQ;IACR,SAAS;IACT,OAAO;IACP,KAAK;CACG,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAAiC;IAChE,QAAQ;IACR,SAAS;IACT,OAAO;IACP,KAAK;CACG,CAAC"}

package/dist/kits/core/adapter-core/contracts.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Fork Adapter Core — Typed Contracts
+ *
+ * Defines the canonical interface contracts for any kit that wraps:
+ *   - a forked open-source repo
+ *   - a hosted/browser UI
+ *   - a desktop/local app
+ *   - a provider-backed execution flow
+ *
+ * These contracts are intentionally planning/authoring contracts —
+ * they are not provider client implementations. They express what a
+ * kit declares it supports so the agent and CLI can validate it.
+ *
+ * Shared across Studio, Workflow, Operator, and Ops kit families.
+ */
+import type { KitFamily, ProviderOperation, RuntimeSurfaceType, ReachabilityProbe, SetupFileDeclaration, RequiredBinaryDeclaration, ForkInspectionRule, OutputArtifactDeclaration } from "../types/index.js";
+export interface ProviderOperationContract {
+    /** Unique provider identifier (e.g. "muapi", "replicate", "fal") */
+    providerId: string;
+    /** Human-readable provider name */
+    providerName: string;
+    /** Operations this provider implements */
+    operations: ProviderOperation[];
+    /** Path to the provider adapter reference doc inside the kit (relative to kit root) */
+    referenceDocPath: string;
+    /** Auth mechanism used by the provider */
+    authMechanism: "api-key-header" | "bearer-token" | "oauth" | "custom";
+    /** Header or field name for the auth value */
+    authField: string;
+    /** Base URL assumption for the provider API */
+    baseUrl: string;
+}
+export interface EnvironmentGateContract {
+    /** Required env var keys the kit needs to operate */
+    requiredEnvVars: string[];
+    /** Env vars that must not be the placeholder value */
+    placeholderGuardedVars?: Array<{
+        key: string;
+        placeholder: string;
+    }>;
+    /** Optional verification command path (relative to kit root) */
+    verifyCommandPath?: string;
+    /** Optional reachability probes checked during the gate */
+    requiredReachableSurfaces?: ReachabilityProbe[];
+}
+export interface SetupPathContract {
+    /** Path to the QUICKSTART file (relative to kit root) */
+    quickstart: string;
+    /** Path to the .env.example file (relative to kit root) */
+    envExample: string;
+    /** Path to the setup scripts directory (relative to kit root) */
+    setupDir: string;
+    /** Path to the output directory (relative to kit root) */
+    outputDir: string;
+    /** Individual declared setup files */
+    files: SetupFileDeclaration[];
+    /** Required system binaries for local-fork or frame-analysis workflows */
+    requiredBinaries?: RequiredBinaryDeclaration[];
+}
+export interface ForkInspectionContract {
+    /** GitHub repo URL for the upstream fork */
+    upstreamRepoUrl: string;
+    /** Default local clone path (supports ~ prefix) */
+    defaultLocalPath: string;
+    /** Default dev server port for local-fork mode */
+    defaultDevPort?: number;
+    /** Inspection rules the agent must follow before planning */
+    inspectionRules: ForkInspectionRule;
+    /** Path to the fork integration doc inside the kit (relative to kit root) */
+    integrationDocPath: string;
+}
+export interface RuntimeSurfaceContract {
+    /** Declared surfaces this kit supports */
+    supportedSurfaces: RuntimeSurfaceType[];
+    /** Default surface if not specified by operator */
+    defaultSurface: RuntimeSurfaceType;
+    /** Per-surface reachability probes */
+    surfaceProbes: Record<RuntimeSurfaceType, ReachabilityProbe | null>;
+}
+export interface OutputContract {
+    /** Root output directory pattern (e.g. "output/<client-slug>/<project-slug>/") */
+    outputRootPattern: string;
+    /** Declared output artifacts in production order */
+    artifacts: OutputArtifactDeclaration[];
+    /** Whether outputs must be logged in the active brand kit */
+    requiresDeliverableLog: boolean;
+    /** Path to the output standards doc inside the kit (relative to kit root) */
+    outputStandardsDocPath: string;
+}
+export interface ForkAdapterCoreConfig {
+    /** Kit identifier (must match kit.json kit.id) */
+    kitId: string;
+    /** Kit family this config belongs to */
+    family: KitFamily;
+    /** Provider operation contract — what provider is declared and how */
+    provider: ProviderOperationContract;
+    /** Environment gate contract — what the env gate checks at session start */
+    envGate: EnvironmentGateContract;
+    /** Setup path contract — what setup files the kit declares */
+    setup: SetupPathContract;
+    /** Fork inspection contract — how the agent inspects the upstream fork */
+    forkInspection: ForkInspectionContract;
+    /** Runtime surface contract — which surfaces the kit supports */
+    runtimeSurface: RuntimeSurfaceContract;
+    /** Output contract — how outputs are structured and logged */
+    output: OutputContract;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/kits/core/adapter-core/contracts.d.ts.map

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

package/dist/kits/core/adapter-core/contracts.js

@@ -0,0 +1,17 @@
+/**
+ * Fork Adapter Core — Typed Contracts
+ *
+ * Defines the canonical interface contracts for any kit that wraps:
+ *   - a forked open-source repo
+ *   - a hosted/browser UI
+ *   - a desktop/local app
+ *   - a provider-backed execution flow
+ *
+ * These contracts are intentionally planning/authoring contracts —
+ * they are not provider client implementations. They express what a
+ * kit declares it supports so the agent and CLI can validate it.
+ *
+ * Shared across Studio, Workflow, Operator, and Ops kit families.
+ */
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/kits/core/adapter-core/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../../src/kits/core/adapter-core/contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/dist/kits/core/adapter-core/env-gate.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Fork Adapter Core — Environment Gate
+ *
+ * Reusable env gate runner that standardizes Step 0 behavior across all kit families.
+ *
+ * Checks (in order):
+ *   1. .env file exists at kit root
+ *   2. Required env vars are present and non-empty
+ *   3. Placeholder-guarded vars are not set to their placeholder value
+ *   4. Optional: verify command exists (does not run it — surfaced to operator)
+ *
+ * This module is side-effect free and path-based — it operates on resolved
+ * filesystem paths so it can be used by both the CLI validation layer and
+ * by agents reading kit documentation.
+ */
+import type { EnvironmentGateContract } from "./contracts.js";
+import type { CoreValidationResult } from "../types/index.js";
+export declare function parseEnvFile(filePath: string): Record<string, string>;
+export interface EnvGateResult extends CoreValidationResult {
+    envFilePath: string;
+    envFileExists: boolean;
+    presentVars: string[];
+    missingVars: string[];
+    placeholderVars: string[];
+    verifyCommandPath?: string;
+}
+export declare function runEnvGate(kitRoot: string, contract: EnvironmentGateContract): EnvGateResult;
+export declare function formatEnvGateResult(result: EnvGateResult): string;
+//# sourceMappingURL=env-gate.d.ts.map

package/dist/kits/core/adapter-core/env-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-gate.d.ts","sourceRoot":"","sources":["../../../../src/kits/core/adapter-core/env-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,oBAAoB,EAAmB,MAAM,mBAAmB,CAAC;AAO/E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAerE;AAMD,MAAM,WAAW,aAAc,SAAQ,oBAAoB;IACzD,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAMD,wBAAgB,UAAU,CACxB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,uBAAuB,GAChC,aAAa,CAkHf;AAMD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAuBjE"}

package/dist/kits/core/adapter-core/env-gate.js

@@ -0,0 +1,143 @@
+/**
+ * Fork Adapter Core — Environment Gate
+ *
+ * Reusable env gate runner that standardizes Step 0 behavior across all kit families.
+ *
+ * Checks (in order):
+ *   1. .env file exists at kit root
+ *   2. Required env vars are present and non-empty
+ *   3. Placeholder-guarded vars are not set to their placeholder value
+ *   4. Optional: verify command exists (does not run it — surfaced to operator)
+ *
+ * This module is side-effect free and path-based — it operates on resolved
+ * filesystem paths so it can be used by both the CLI validation layer and
+ * by agents reading kit documentation.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { makeError, makeWarning, makeInfo } from "../types/index.js";
+// ---------------------------------------------------------------------------
+// Env file parser (subset of dotenv — no dependency required)
+// ---------------------------------------------------------------------------
+export function parseEnvFile(filePath) {
+    const vars = {};
+    const lines = fs.readFileSync(filePath, "utf8").split("\n");
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const eqIndex = trimmed.indexOf("=");
+        if (eqIndex === -1)
+            continue;
+        const key = trimmed.slice(0, eqIndex).trim();
+        const value = trimmed.slice(eqIndex + 1).trim();
+        if (key)
+            vars[key] = value;
+    }
+    return vars;
+}
+// ---------------------------------------------------------------------------
+// Gate runner
+// ---------------------------------------------------------------------------
+export function runEnvGate(kitRoot, contract) {
+    const issues = [];
+    const passedChecks = [];
+    const envFilePath = path.resolve(kitRoot, ".env");
+    const envExamplePath = path.resolve(kitRoot, ".env.example");
+    const presentVars = [];
+    const missingVars = [];
+    const placeholderVars = [];
+    // Check 1 — .env exists
+    const envFileExists = fs.existsSync(envFilePath);
+    if (!envFileExists) {
+        issues.push(makeError("ENV_FILE_MISSING", `.env not found at ${envFilePath}. Run: cp .env.example .env then add your credentials.`, ".env"));
+        // Surface .env.example hint if it exists
+        if (fs.existsSync(envExamplePath)) {
+            issues.push(makeInfo("ENV_EXAMPLE_AVAILABLE", `.env.example is present — copy it to get started.`));
+        }
+        return {
+            valid: false,
+            issues,
+            passedChecks,
+            envFilePath,
+            envFileExists: false,
+            presentVars,
+            missingVars: contract.requiredEnvVars,
+            placeholderVars,
+            verifyCommandPath: contract.verifyCommandPath,
+        };
+    }
+    passedChecks.push("env-file-exists");
+    // Parse env file
+    const env = parseEnvFile(envFilePath);
+    // Check 2 — required vars present and non-empty
+    for (const key of contract.requiredEnvVars) {
+        const value = env[key];
+        if (!value || value.trim() === "") {
+            missingVars.push(key);
+            issues.push(makeError("ENV_VAR_MISSING", `Required env var ${key} is not set in .env.`, key));
+        }
+        else {
+            presentVars.push(key);
+        }
+    }
+    if (missingVars.length === 0) {
+        passedChecks.push("required-vars-present");
+    }
+    // Check 3 — placeholder guard
+    for (const guard of contract.placeholderGuardedVars ?? []) {
+        const value = env[guard.key];
+        if (value === guard.placeholder) {
+            placeholderVars.push(guard.key);
+            issues.push(makeError("ENV_VAR_IS_PLACEHOLDER", `${guard.key} is still set to the placeholder value "${guard.placeholder}". Replace it with your actual credential.`, guard.key));
+        }
+    }
+    if (placeholderVars.length === 0 && (contract.placeholderGuardedVars?.length ?? 0) > 0) {
+        passedChecks.push("placeholder-guard-passed");
+    }
+    // Check 4 — verify command path (existence only — does not execute)
+    if (contract.verifyCommandPath) {
+        const verifyPath = path.resolve(kitRoot, contract.verifyCommandPath);
+        if (!fs.existsSync(verifyPath)) {
+            issues.push(makeWarning("VERIFY_COMMAND_MISSING", `Verify command declared at ${contract.verifyCommandPath} does not exist.`, contract.verifyCommandPath));
+        }
+        else {
+            passedChecks.push("verify-command-available");
+        }
+    }
+    const valid = issues.filter((i) => i.severity === "error").length === 0;
+    return {
+        valid,
+        issues,
+        passedChecks,
+        envFilePath,
+        envFileExists: true,
+        presentVars,
+        missingVars,
+        placeholderVars,
+        verifyCommandPath: contract.verifyCommandPath,
+    };
+}
+// ---------------------------------------------------------------------------
+// Format gate result for CLI or agent output
+// ---------------------------------------------------------------------------
+export function formatEnvGateResult(result) {
+    const lines = ["=== Environment Gate ==="];
+    lines.push(`Env file: ${result.envFileExists ? "found" : "MISSING"} (${result.envFilePath})`);
+    if (result.presentVars.length > 0) {
+        lines.push(`Present: ${result.presentVars.join(", ")}`);
+    }
+    if (result.missingVars.length > 0) {
+        lines.push(`Missing: ${result.missingVars.join(", ")}`);
+    }
+    if (result.placeholderVars.length > 0) {
+        lines.push(`Placeholder (not set): ${result.placeholderVars.join(", ")}`);
+    }
+    for (const issue of result.issues) {
+        const prefix = issue.severity === "error" ? "ERROR" : issue.severity === "warning" ? "WARN" : "INFO";
+        lines.push(`[${prefix}] ${issue.message}`);
+    }
+    lines.push(result.valid ? "Gate: PASSED" : "Gate: FAILED — session blocked until resolved");
+    return lines.join("\n");
+}
+//# sourceMappingURL=env-gate.js.map

package/dist/kits/core/adapter-core/env-gate.js.map

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

package/dist/kits/core/adapter-core/fork-inspector.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Fork Adapter Core — Fork Inspector
+ *
+ * Reusable inspection primitives for any kit that wraps a forked open-source repo.
+ *
+ * The inspector does not run the fork — it validates that the declared inspection
+ * surface (required planning files, source-of-truth files) is present in the
+ * local checkout before the agent begins planning.
+ *
+ * This encodes the core rule: "inspect actual fork before planning".
+ * Agents that skip fork inspection must mark their output as `assumption-based`.
+ */
+import type { ForkInspectionContract } from "./contracts.js";
+import type { CoreValidationResult } from "../types/index.js";
+export type ForkVerificationStatus = "fork-verified" | "upstream-verified" | "assumption-based";
+export interface ForkInspectionResult extends CoreValidationResult {
+    forkRoot: string | null;
+    forkFound: boolean;
+    verificationStatus: ForkVerificationStatus;
+    presentPlanningFiles: string[];
+    missingPlanningFiles: string[];
+    presentSourceOfTruthFiles: string[];
+    missingSourceOfTruthFiles: string[];
+    fileMetadata: ForkFileMetadata[];
+}
+export interface ForkFileMetadata {
+    relativePath: string;
+    exists: boolean;
+    sizeBytes?: number;
+    sha256?: string;
+    mtimeMs?: number;
+}
+export declare function resolveForkRoot(contract: ForkInspectionContract, overridePath?: string): string | null;
+export declare function inspectFork(contract: ForkInspectionContract, options?: {
+    forkRootOverride?: string;
+    includeHashes?: boolean;
+}): ForkInspectionResult;
+export declare function assertForkFileExists(forkRoot: string, relativePath: string): {
+    exists: boolean;
+    fullPath: string;
+};
+//# sourceMappingURL=fork-inspector.d.ts.map

package/dist/kits/core/adapter-core/fork-inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fork-inspector.d.ts","sourceRoot":"","sources":["../../../../src/kits/core/adapter-core/fork-inspector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,oBAAoB,EAAmB,MAAM,mBAAmB,CAAC;AAO/E,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG,mBAAmB,GAAG,kBAAkB,CAAC;AAEhG,MAAM,WAAW,oBAAqB,SAAQ,oBAAoB;IAChE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,EAAE,sBAAsB,CAAC;IAC3C,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,yBAAyB,EAAE,MAAM,EAAE,CAAC;IACpC,yBAAyB,EAAE,MAAM,EAAE,CAAC;IACpC,YAAY,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,sBAAsB,EAChC,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,GAAG,IAAI,CAkBf;AAMD,wBAAgB,WAAW,CACzB,QAAQ,EAAE,sBAAsB,EAChC,OAAO,GAAE;IACP,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;CACpB,GACL,oBAAoB,CAsGtB;AAkCD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAGvC"}