@growthub/cli 0.5.1 → 0.6.1

package/dist/kits/core/adapter-core/runtime-surface.js.map

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

package/dist/kits/core/adapter-core/setup-validation.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Fork Adapter Core — Setup Validation
+ *
+ * Reusable helpers that validate the setup/ surface of any kit:
+ *   - QUICKSTART.md exists and is non-empty
+ *   - .env.example exists and declares required vars
+ *   - setup/ directory contains declared script files
+ *   - output/README.md exists
+ *   - required system binaries are declared (not executed — advisory only)
+ *
+ * Used by the core validation runner and the CLI kit validate command.
+ */
+import type { SetupPathContract } from "./contracts.js";
+import type { CoreValidationResult, ValidationIssue } from "../types/index.js";
+export interface SetupValidationResult extends CoreValidationResult {
+    quickstartExists: boolean;
+    envExampleExists: boolean;
+    outputReadmeExists: boolean;
+    missingFiles: string[];
+    missingBinaries: string[];
+}
+export declare function validateSetup(kitRoot: string, contract: SetupPathContract): SetupValidationResult;
+export declare function validateEnvExample(kitRoot: string, expectedKeys: string[]): {
+    valid: boolean;
+    issues: ValidationIssue[];
+    declaredKeys: string[];
+};
+//# sourceMappingURL=setup-validation.d.ts.map

package/dist/kits/core/adapter-core/setup-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-validation.d.ts","sourceRoot":"","sources":["../../../../src/kits/core/adapter-core/setup-validation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAO/E,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IACjE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAMD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,iBAAiB,GAC1B,qBAAqB,CAuFvB;AAmBD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EAAE,GACrB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAmCvE"}

package/dist/kits/core/adapter-core/setup-validation.js

@@ -0,0 +1,145 @@
+/**
+ * Fork Adapter Core — Setup Validation
+ *
+ * Reusable helpers that validate the setup/ surface of any kit:
+ *   - QUICKSTART.md exists and is non-empty
+ *   - .env.example exists and declares required vars
+ *   - setup/ directory contains declared script files
+ *   - output/README.md exists
+ *   - required system binaries are declared (not executed — advisory only)
+ *
+ * Used by the core validation runner and the CLI kit validate command.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { execSync } from "node:child_process";
+import { makeError, makeWarning } from "../types/index.js";
+// ---------------------------------------------------------------------------
+// Validate setup surface
+// ---------------------------------------------------------------------------
+export function validateSetup(kitRoot, contract) {
+    const issues = [];
+    const passedChecks = [];
+    const missingFiles = [];
+    const missingBinaries = [];
+    // Check QUICKSTART.md
+    const quickstartPath = path.resolve(kitRoot, contract.quickstart);
+    const quickstartExists = fs.existsSync(quickstartPath);
+    if (!quickstartExists) {
+        missingFiles.push(contract.quickstart);
+        issues.push(makeError("QUICKSTART_MISSING", `QUICKSTART.md not found at ${contract.quickstart}.`, contract.quickstart));
+    }
+    else {
+        const content = fs.readFileSync(quickstartPath, "utf8").trim();
+        if (content.length < 50) {
+            issues.push(makeWarning("QUICKSTART_EMPTY", `QUICKSTART.md appears to be empty or too short.`, contract.quickstart));
+        }
+        else {
+            passedChecks.push("quickstart-exists");
+        }
+    }
+    // Check .env.example
+    const envExamplePath = path.resolve(kitRoot, contract.envExample);
+    const envExampleExists = fs.existsSync(envExamplePath);
+    if (!envExampleExists) {
+        missingFiles.push(contract.envExample);
+        issues.push(makeError("ENV_EXAMPLE_MISSING", `.env.example not found at ${contract.envExample}.`, contract.envExample));
+    }
+    else {
+        passedChecks.push("env-example-exists");
+    }
+    // Check output/README.md
+    const outputReadmePath = path.resolve(kitRoot, contract.outputDir, "README.md");
+    const outputReadmeExists = fs.existsSync(outputReadmePath);
+    if (!outputReadmeExists) {
+        issues.push(makeWarning("OUTPUT_README_MISSING", `output/README.md not found. Recommend adding it to document the output structure.`));
+    }
+    else {
+        passedChecks.push("output-readme-exists");
+    }
+    // Check declared setup files
+    for (const file of contract.files) {
+        const filePath = path.resolve(kitRoot, file.relativePath);
+        const exists = fs.existsSync(filePath);
+        if (!exists && file.required) {
+            missingFiles.push(file.relativePath);
+            issues.push(makeError("SETUP_FILE_MISSING", `Required setup file missing: ${file.relativePath} — ${file.description}.`, file.relativePath));
+        }
+        else if (!exists) {
+            issues.push(makeWarning("SETUP_FILE_OPTIONAL_MISSING", `Optional setup file missing: ${file.relativePath} — ${file.description}.`, file.relativePath));
+        }
+        else {
+            passedChecks.push(`setup-file:${file.relativePath}`);
+        }
+    }
+    // Check required binaries (advisory — does not block but warns)
+    for (const bin of contract.requiredBinaries ?? []) {
+        const available = isBinaryAvailable(bin.binary);
+        if (!available) {
+            missingBinaries.push(bin.binary);
+            issues.push(makeWarning("BINARY_MISSING", `Required binary "${bin.binary}" not found. ${bin.installHint} (needed for: ${bin.requiredForSurfaces.join(", ")})`, bin.binary));
+        }
+        else {
+            passedChecks.push(`binary:${bin.binary}`);
+        }
+    }
+    const valid = issues.filter((i) => i.severity === "error").length === 0;
+    return {
+        valid,
+        issues,
+        passedChecks,
+        quickstartExists,
+        envExampleExists,
+        outputReadmeExists,
+        missingFiles,
+        missingBinaries,
+    };
+}
+// ---------------------------------------------------------------------------
+// Binary availability check
+// ---------------------------------------------------------------------------
+function isBinaryAvailable(binary) {
+    try {
+        execSync(`command -v ${binary}`, { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Validate .env.example declares expected keys
+// ---------------------------------------------------------------------------
+export function validateEnvExample(kitRoot, expectedKeys) {
+    const issues = [];
+    const envExamplePath = path.resolve(kitRoot, ".env.example");
+    if (!fs.existsSync(envExamplePath)) {
+        return {
+            valid: false,
+            issues: [makeError("ENV_EXAMPLE_MISSING", ".env.example not found.")],
+            declaredKeys: [],
+        };
+    }
+    const content = fs.readFileSync(envExamplePath, "utf8");
+    const declaredKeys = [];
+    for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const eqIndex = trimmed.indexOf("=");
+        if (eqIndex !== -1) {
+            declaredKeys.push(trimmed.slice(0, eqIndex).trim());
+        }
+    }
+    for (const key of expectedKeys) {
+        if (!declaredKeys.includes(key)) {
+            issues.push(makeError("ENV_EXAMPLE_KEY_MISSING", `.env.example does not declare required key: ${key}`, key));
+        }
+    }
+    return {
+        valid: issues.filter((i) => i.severity === "error").length === 0,
+        issues,
+        declaredKeys,
+    };
+}
+//# sourceMappingURL=setup-validation.js.map

package/dist/kits/core/adapter-core/setup-validation.js.map

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

package/dist/kits/core/factory/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Kit Factory — Family Template System
+ *
+ * Provides canonical ForkAdapterCoreConfig factories for each kit family:
+ *
+ *   studio   — AI studio (image/video/audio/cinema generation)
+ *   workflow — Multi-step agentic pipeline or automation workflow
+ *   operator — Domain-specific operator (email, growth, content, social)
+ *   ops      — Infrastructure, devops, or execution surface operator
+ *
+ * Each factory produces a complete ForkAdapterCoreConfig that wires together:
+ *   provider, envGate, setup, forkInspection, runtimeSurface, output
+ *
+ * Kits override the factory output for their specific values.
+ * The factory ensures all required fields are present by default.
+ */
+export { createStudioKitConfig, STUDIO_KIT_DEFAULTS } from "./studio-kit.js";
+export { createWorkflowKitConfig, WORKFLOW_KIT_DEFAULTS } from "./workflow-kit.js";
+export { createOperatorKitConfig, OPERATOR_KIT_DEFAULTS } from "./operator-kit.js";
+export { createOpsKitConfig, OPS_KIT_DEFAULTS } from "./ops-kit.js";
+export type { StudioKitOptions } from "./studio-kit.js";
+export type { WorkflowKitOptions } from "./workflow-kit.js";
+export type { OperatorKitOptions } from "./operator-kit.js";
+export type { OpsKitOptions } from "./ops-kit.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/kits/core/factory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/kits/core/factory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEpE,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * Kit Factory — Family Template System
+ *
+ * Provides canonical ForkAdapterCoreConfig factories for each kit family:
+ *
+ *   studio   — AI studio (image/video/audio/cinema generation)
+ *   workflow — Multi-step agentic pipeline or automation workflow
+ *   operator — Domain-specific operator (email, growth, content, social)
+ *   ops      — Infrastructure, devops, or execution surface operator
+ *
+ * Each factory produces a complete ForkAdapterCoreConfig that wires together:
+ *   provider, envGate, setup, forkInspection, runtimeSurface, output
+ *
+ * Kits override the factory output for their specific values.
+ * The factory ensures all required fields are present by default.
+ */
+export { createStudioKitConfig, STUDIO_KIT_DEFAULTS } from "./studio-kit.js";
+export { createWorkflowKitConfig, WORKFLOW_KIT_DEFAULTS } from "./workflow-kit.js";
+export { createOperatorKitConfig, OPERATOR_KIT_DEFAULTS } from "./operator-kit.js";
+export { createOpsKitConfig, OPS_KIT_DEFAULTS } from "./ops-kit.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/kits/core/factory/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/kits/core/factory/operator-kit.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Kit Factory — Operator Kit Template
+ *
+ * Canonical ForkAdapterCoreConfig for Operator kits.
+ *
+ * Operator kits wrap a domain-specific operator agent — a specialist that
+ * executes within a defined vertical (email marketing, growth, content,
+ * social, SEO, ads). They are typically not fork-backed but are provider-backed
+ * and produce structured output document packages.
+ *
+ * The growthub-email-marketing-v1 kit is an example of this family.
+ *
+ * Defaults:
+ *   surfaces      — browser-hosted (primary)
+ *   fork          — none
+ *   output        — operator-specific artifact set (overridden per kit)
+ *   env gate      — single primary API key required
+ */
+import type { ForkAdapterCoreConfig } from "../adapter-core/contracts.js";
+import type { OutputArtifactDeclaration } from "../types/index.js";
+export interface OperatorKitOptions {
+    kitId: string;
+    /** Domain vertical this operator serves */
+    vertical: string;
+    /** Primary env var for the API credential */
+    apiKeyEnvVar: string;
+    /** API key placeholder value */
+    apiKeyPlaceholder?: string;
+    /** Provider id */
+    providerId: string;
+    /** Provider name */
+    providerName: string;
+    /** Provider base URL */
+    providerBaseUrl: string;
+    /** Provider auth field */
+    providerAuthField?: string;
+    /** Reference doc path for the provider adapter */
+    providerReferenceDocPath?: string;
+    /** Output artifacts for this operator */
+    artifacts?: OutputArtifactDeclaration[];
+    /** Additional required env vars beyond the primary API key */
+    additionalRequiredEnvVars?: string[];
+}
+export declare const OPERATOR_KIT_DEFAULTS: {
+    readonly apiKeyPlaceholder: "your_api_key_here";
+    readonly providerAuthField: "x-api-key";
+    readonly providerReferenceDocPath: "docs/provider-adapter-layer.md";
+};
+export declare function createOperatorKitConfig(options: OperatorKitOptions): ForkAdapterCoreConfig;
+//# sourceMappingURL=operator-kit.d.ts.map

package/dist/kits/core/factory/operator-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-kit.d.ts","sourceRoot":"","sources":["../../../../src/kits/core/factory/operator-kit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAEnE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,0BAA0B;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,yCAAyC;IACzC,SAAS,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACxC,8DAA8D;IAC9D,yBAAyB,CAAC,EAAE,MAAM,EAAE,CAAC;CACtC;AAED,eAAO,MAAM,qBAAqB;;;;CAIxB,CAAC;AAEX,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,GAAG,qBAAqB,CAkF1F"}

package/dist/kits/core/factory/operator-kit.js

@@ -0,0 +1,88 @@
+/**
+ * Kit Factory — Operator Kit Template
+ *
+ * Canonical ForkAdapterCoreConfig for Operator kits.
+ *
+ * Operator kits wrap a domain-specific operator agent — a specialist that
+ * executes within a defined vertical (email marketing, growth, content,
+ * social, SEO, ads). They are typically not fork-backed but are provider-backed
+ * and produce structured output document packages.
+ *
+ * The growthub-email-marketing-v1 kit is an example of this family.
+ *
+ * Defaults:
+ *   surfaces      — browser-hosted (primary)
+ *   fork          — none
+ *   output        — operator-specific artifact set (overridden per kit)
+ *   env gate      — single primary API key required
+ */
+export const OPERATOR_KIT_DEFAULTS = {
+    apiKeyPlaceholder: "your_api_key_here",
+    providerAuthField: "x-api-key",
+    providerReferenceDocPath: "docs/provider-adapter-layer.md",
+};
+export function createOperatorKitConfig(options) {
+    const { kitId, vertical, apiKeyEnvVar, apiKeyPlaceholder = OPERATOR_KIT_DEFAULTS.apiKeyPlaceholder, providerId, providerName, providerBaseUrl, providerAuthField = OPERATOR_KIT_DEFAULTS.providerAuthField, providerReferenceDocPath = OPERATOR_KIT_DEFAULTS.providerReferenceDocPath, artifacts = [], additionalRequiredEnvVars = [], } = options;
+    return {
+        kitId,
+        family: "operator",
+        provider: {
+            providerId,
+            providerName,
+            operations: [
+                "SUBMIT_GENERATION",
+                "POLL_RESULT",
+                "NORMALIZE_RESULT",
+                "LIST_MODEL_CAPABILITIES",
+                "UPLOAD_ASSET",
+            ],
+            referenceDocPath: providerReferenceDocPath,
+            authMechanism: "api-key-header",
+            authField: providerAuthField,
+            baseUrl: providerBaseUrl,
+        },
+        envGate: {
+            requiredEnvVars: [apiKeyEnvVar, ...additionalRequiredEnvVars],
+            placeholderGuardedVars: [{ key: apiKeyEnvVar, placeholder: apiKeyPlaceholder }],
+            verifyCommandPath: "setup/verify-env.mjs",
+        },
+        setup: {
+            quickstart: "QUICKSTART.md",
+            envExample: ".env.example",
+            setupDir: "setup/",
+            outputDir: "output/",
+            files: [
+                { relativePath: "setup/verify-env.mjs", required: true, description: "Validate the API key" },
+            ],
+            requiredBinaries: [],
+        },
+        // Operator kits are typically not fork-backed
+        forkInspection: {
+            upstreamRepoUrl: "",
+            defaultLocalPath: "",
+            integrationDocPath: "docs/provider-adapter-layer.md",
+            inspectionRules: {
+                requiredPlanningFiles: [],
+                sourceOfTruthFiles: [],
+                note: `Operator kit for "${vertical}" vertical — no fork inspection required. Plan against provider docs and brand kit.`,
+            },
+        },
+        runtimeSurface: {
+            supportedSurfaces: ["browser-hosted"],
+            defaultSurface: "browser-hosted",
+            surfaceProbes: {
+                "local-fork": null,
+                "browser-hosted": null,
+                "desktop-app": null,
+                "custom": null,
+            },
+        },
+        output: {
+            outputRootPattern: "output/<client-slug>/<project-slug>/",
+            requiresDeliverableLog: true,
+            outputStandardsDocPath: "output-standards.md",
+            artifacts,
+        },
+    };
+}
+//# sourceMappingURL=operator-kit.js.map

package/dist/kits/core/factory/operator-kit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-kit.js","sourceRoot":"","sources":["../../../../src/kits/core/factory/operator-kit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA6BH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,iBAAiB,EAAE,mBAAmB;IACtC,iBAAiB,EAAE,WAAW;IAC9B,wBAAwB,EAAE,gCAAgC;CAClD,CAAC;AAEX,MAAM,UAAU,uBAAuB,CAAC,OAA2B;IACjE,MAAM,EACJ,KAAK,EACL,QAAQ,EACR,YAAY,EACZ,iBAAiB,GAAG,qBAAqB,CAAC,iBAAiB,EAC3D,UAAU,EACV,YAAY,EACZ,eAAe,EACf,iBAAiB,GAAG,qBAAqB,CAAC,iBAAiB,EAC3D,wBAAwB,GAAG,qBAAqB,CAAC,wBAAwB,EACzE,SAAS,GAAG,EAAE,EACd,yBAAyB,GAAG,EAAE,GAC/B,GAAG,OAAO,CAAC;IAEZ,OAAO;QACL,KAAK;QACL,MAAM,EAAE,UAAU;QAElB,QAAQ,EAAE;YACR,UAAU;YACV,YAAY;YACZ,UAAU,EAAE;gBACV,mBAAmB;gBACnB,aAAa;gBACb,kBAAkB;gBAClB,yBAAyB;gBACzB,cAAc;aACf;YACD,gBAAgB,EAAE,wBAAwB;YAC1C,aAAa,EAAE,gBAAgB;YAC/B,SAAS,EAAE,iBAAiB;YAC5B,OAAO,EAAE,eAAe;SACzB;QAED,OAAO,EAAE;YACP,eAAe,EAAE,CAAC,YAAY,EAAE,GAAG,yBAAyB,CAAC;YAC7D,sBAAsB,EAAE,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC;YAC/E,iBAAiB,EAAE,sBAAsB;SAC1C;QAED,KAAK,EAAE;YACL,UAAU,EAAE,eAAe;YAC3B,UAAU,EAAE,cAAc;YAC1B,QAAQ,EAAE,QAAQ;YAClB,SAAS,EAAE,SAAS;YACpB,KAAK,EAAE;gBACL,EAAE,YAAY,EAAE,sBAAsB,EAAE,QAAQ,EAAE,IAAI,EAAG,WAAW,EAAE,sBAAsB,EAAE;aAC/F;YACD,gBAAgB,EAAE,EAAE;SACrB;QAED,8CAA8C;QAC9C,cAAc,EAAE;YACd,eAAe,EAAE,EAAE;YACnB,gBAAgB,EAAE,EAAE;YACpB,kBAAkB,EAAE,gCAAgC;YACpD,eAAe,EAAE;gBACf,qBAAqB,EAAE,EAAE;gBACzB,kBAAkB,EAAE,EAAE;gBACtB,IAAI,EAAE,qBAAqB,QAAQ,qFAAqF;aACzH;SACF;QAED,cAAc,EAAE;YACd,iBAAiB,EAAE,CAAC,gBAAgB,CAAC;YACrC,cAAc,EAAE,gBAAgB;YAChC,aAAa,EAAE;gBACb,YAAY,EAAE,IAAI;gBAClB,gBAAgB,EAAE,IAAI;gBACtB,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE,IAAI;aACf;SACF;QAED,MAAM,EAAE;YACN,iBAAiB,EAAE,sCAAsC;YACzD,sBAAsB,EAAE,IAAI;YAC5B,sBAAsB,EAAE,qBAAqB;YAC7C,SAAS;SACV;KACF,CAAC;AACJ,CAAC"}

package/dist/kits/core/factory/ops-kit.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Kit Factory — Ops Kit Template
+ *
+ * Canonical ForkAdapterCoreConfig for Ops kits.
+ *
+ * Ops kits wrap infrastructure, devops, or execution surface operators.
+ * They typically deal with file systems, CLI toolchains, deployment pipelines,
+ * or monitoring surfaces rather than AI generation APIs.
+ *
+ * Characteristics:
+ *   - May have zero provider (pure local execution)
+ *   - Fork inspection is critical (they often wrap a local tool or repo)
+ *   - Binary dependency checking is high priority
+ *   - Output artifacts are typically reports, logs, or runbooks
+ *
+ * Example use cases:
+ *   - CI/CD pipeline operator
+ *   - Infrastructure audit operator
+ *   - Release checklist runner
+ */
+import type { ForkAdapterCoreConfig } from "../adapter-core/contracts.js";
+import type { RuntimeSurfaceType, RequiredBinaryDeclaration, OutputArtifactDeclaration } from "../types/index.js";
+export interface OpsKitOptions {
+    kitId: string;
+    /** What this ops kit manages */
+    domain: string;
+    /** Optional provider if the kit calls an external API */
+    provider?: {
+        providerId: string;
+        providerName: string;
+        providerBaseUrl: string;
+        apiKeyEnvVar: string;
+        apiKeyPlaceholder?: string;
+        authField?: string;
+        referenceDocPath?: string;
+    };
+    /** Optional fork details */
+    fork?: {
+        upstreamRepoUrl: string;
+        defaultLocalPath: string;
+        requiredPlanningFiles: string[];
+        sourceOfTruthFiles?: string[];
+    };
+    /** Required system binaries */
+    requiredBinaries?: RequiredBinaryDeclaration[];
+    /** Supported surfaces */
+    supportedSurfaces?: RuntimeSurfaceType[];
+    /** Output artifacts */
+    artifacts?: OutputArtifactDeclaration[];
+    /** Additional required env vars */
+    requiredEnvVars?: string[];
+}
+export declare const OPS_KIT_DEFAULTS: {
+    readonly supportedSurfaces: RuntimeSurfaceType[];
+};
+export declare function createOpsKitConfig(options: OpsKitOptions): ForkAdapterCoreConfig;
+//# sourceMappingURL=ops-kit.d.ts.map

package/dist/kits/core/factory/ops-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ops-kit.d.ts","sourceRoot":"","sources":["../../../../src/kits/core/factory/ops-kit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAElH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,yDAAyD;IACzD,QAAQ,CAAC,EAAE;QACT,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,4BAA4B;IAC5B,IAAI,CAAC,EAAE;QACL,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;QACzB,qBAAqB,EAAE,MAAM,EAAE,CAAC;QAChC,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;KAC/B,CAAC;IACF,+BAA+B;IAC/B,gBAAgB,CAAC,EAAE,yBAAyB,EAAE,CAAC;IAC/C,yBAAyB;IACzB,iBAAiB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACzC,uBAAuB;IACvB,SAAS,CAAC,EAAE,yBAAyB,EAAE,CAAC;IACxC,mCAAmC;IACnC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,eAAO,MAAM,gBAAgB;gCACU,kBAAkB,EAAE;CACjD,CAAC;AAEX,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,qBAAqB,CA4GhF"}

package/dist/kits/core/factory/ops-kit.js

@@ -0,0 +1,115 @@
+/**
+ * Kit Factory — Ops Kit Template
+ *
+ * Canonical ForkAdapterCoreConfig for Ops kits.
+ *
+ * Ops kits wrap infrastructure, devops, or execution surface operators.
+ * They typically deal with file systems, CLI toolchains, deployment pipelines,
+ * or monitoring surfaces rather than AI generation APIs.
+ *
+ * Characteristics:
+ *   - May have zero provider (pure local execution)
+ *   - Fork inspection is critical (they often wrap a local tool or repo)
+ *   - Binary dependency checking is high priority
+ *   - Output artifacts are typically reports, logs, or runbooks
+ *
+ * Example use cases:
+ *   - CI/CD pipeline operator
+ *   - Infrastructure audit operator
+ *   - Release checklist runner
+ */
+export const OPS_KIT_DEFAULTS = {
+    supportedSurfaces: ["local-fork"],
+};
+export function createOpsKitConfig(options) {
+    const { kitId, domain, provider, fork, requiredBinaries = [], supportedSurfaces = OPS_KIT_DEFAULTS.supportedSurfaces, artifacts = [], requiredEnvVars = [], } = options;
+    const providerContract = provider
+        ? {
+            providerId: provider.providerId,
+            providerName: provider.providerName,
+            operations: [
+                "SUBMIT_GENERATION",
+                "POLL_RESULT",
+                "NORMALIZE_RESULT",
+                "LIST_MODEL_CAPABILITIES",
+                "UPLOAD_ASSET",
+            ],
+            referenceDocPath: provider.referenceDocPath ?? "docs/provider-adapter-layer.md",
+            authMechanism: "api-key-header",
+            authField: provider.authField ?? "x-api-key",
+            baseUrl: provider.providerBaseUrl,
+        }
+        : {
+            providerId: "none",
+            providerName: "No external provider — local execution only",
+            operations: [],
+            referenceDocPath: "docs/provider-adapter-layer.md",
+            authMechanism: "custom",
+            authField: "none",
+            baseUrl: "",
+        };
+    const allRequiredEnvVars = provider
+        ? [provider.apiKeyEnvVar, ...requiredEnvVars]
+        : requiredEnvVars;
+    return {
+        kitId,
+        family: "ops",
+        provider: providerContract,
+        envGate: {
+            requiredEnvVars: allRequiredEnvVars,
+            placeholderGuardedVars: provider
+                ? [{ key: provider.apiKeyEnvVar, placeholder: provider.apiKeyPlaceholder ?? "your_api_key_here" }]
+                : [],
+            verifyCommandPath: allRequiredEnvVars.length > 0 ? "setup/verify-env.mjs" : undefined,
+        },
+        setup: {
+            quickstart: "QUICKSTART.md",
+            envExample: ".env.example",
+            setupDir: "setup/",
+            outputDir: "output/",
+            files: [
+                { relativePath: "setup/check-deps.sh", required: true, description: "Check system dependencies" },
+                { relativePath: "setup/verify-env.mjs", required: !!provider, description: "Validate the API key" },
+            ],
+            requiredBinaries,
+        },
+        forkInspection: fork
+            ? {
+                upstreamRepoUrl: fork.upstreamRepoUrl,
+                defaultLocalPath: fork.defaultLocalPath,
+                integrationDocPath: "docs/fork-integration.md",
+                inspectionRules: {
+                    requiredPlanningFiles: fork.requiredPlanningFiles,
+                    sourceOfTruthFiles: fork.sourceOfTruthFiles ?? fork.requiredPlanningFiles,
+                    note: `Ops kit for "${domain}" — inspect fork before generating any runbooks or execution plans.`,
+                },
+            }
+            : {
+                upstreamRepoUrl: "",
+                defaultLocalPath: "",
+                integrationDocPath: "docs/provider-adapter-layer.md",
+                inspectionRules: {
+                    requiredPlanningFiles: [],
+                    sourceOfTruthFiles: [],
+                    note: `Ops kit for "${domain}" — no fork. Plan against local toolchain and declared binary surface.`,
+                },
+            },
+        runtimeSurface: {
+            supportedSurfaces,
+            defaultSurface: supportedSurfaces[0] ?? "local-fork",
+            surfaceProbes: {
+                "local-fork": null,
+                "browser-hosted": null,
+                "desktop-app": null,
+                "custom": null,
+            },
+        },
+        output: {
+            outputRootPattern: "output/<project-slug>/",
+            requiresDeliverableLog: false,
+            outputStandardsDocPath: "output-standards.md",
+            artifacts,
+        },
+    };
+}
+//# sourceMappingURL=ops-kit.js.map

package/dist/kits/core/factory/ops-kit.js.map

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

package/dist/kits/core/factory/studio-kit.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Kit Factory — Studio Kit Template
+ *
+ * Canonical ForkAdapterCoreConfig for Studio kits.
+ *
+ * Studio kits wrap a forked open-source AI studio (image/video/audio/cinema)
+ * backed by a provider API. The Open Higgsfield Studio kit is the reference
+ * implementation of this family.
+ *
+ * Defaults:
+ *   provider      — Muapi (pluggable)
+ *   surfaces      — local-fork (primary), browser-hosted, desktop-app
+ *   env gate      — MUAPI_API_KEY required
+ *   fork          — Anil-matcha/Open-Higgsfield-AI (overridable)
+ *   output        — 9-artifact visual production package
+ */
+import type { ForkAdapterCoreConfig } from "../adapter-core/contracts.js";
+export interface StudioKitOptions {
+    kitId: string;
+    /** Override the upstream fork repo URL */
+    upstreamRepoUrl?: string;
+    /** Override the default local clone path */
+    defaultLocalPath?: string;
+    /** Override the default dev port */
+    defaultDevPort?: number;
+    /** Override the primary env var key for the API key */
+    apiKeyEnvVar?: string;
+    /** Override provider ID for non-Muapi providers */
+    providerId?: string;
+}
+export declare const STUDIO_KIT_DEFAULTS: {
+    readonly upstreamRepoUrl: "https://github.com/Anil-matcha/Open-Higgsfield-AI";
+    readonly defaultLocalPath: "~/open-higgsfield-ai";
+    readonly defaultDevPort: 3001;
+    readonly apiKeyEnvVar: "MUAPI_API_KEY";
+    readonly providerId: "muapi";
+};
+export declare function createStudioKitConfig(options: StudioKitOptions): ForkAdapterCoreConfig;
+//# sourceMappingURL=studio-kit.d.ts.map

package/dist/kits/core/factory/studio-kit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio-kit.d.ts","sourceRoot":"","sources":["../../../../src/kits/core/factory/studio-kit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAK1E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,mBAAmB;;;;;;CAMtB,CAAC;AAEX,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,qBAAqB,CAkFtF"}