@growthub/cli 0.5.1 → 0.6.1

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

@@ -0,0 +1,96 @@
+/**
+ * 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 { buildMuapiProviderContract } from "../adapter-core/provider-adapter.js";
+import { buildStudioRuntimeSurfaceContract } from "../adapter-core/runtime-surface.js";
+import { buildStudioOutputContract } from "../adapter-core/output-contract.js";
+export const STUDIO_KIT_DEFAULTS = {
+    upstreamRepoUrl: "https://github.com/Anil-matcha/Open-Higgsfield-AI",
+    defaultLocalPath: "~/open-higgsfield-ai",
+    defaultDevPort: 3001,
+    apiKeyEnvVar: "MUAPI_API_KEY",
+    providerId: "muapi",
+};
+export function createStudioKitConfig(options) {
+    const { kitId, upstreamRepoUrl = STUDIO_KIT_DEFAULTS.upstreamRepoUrl, defaultLocalPath = STUDIO_KIT_DEFAULTS.defaultLocalPath, defaultDevPort = STUDIO_KIT_DEFAULTS.defaultDevPort, apiKeyEnvVar = STUDIO_KIT_DEFAULTS.apiKeyEnvVar, providerId = STUDIO_KIT_DEFAULTS.providerId, } = options;
+    return {
+        kitId,
+        family: "studio",
+        provider: buildMuapiProviderContract({ providerId }),
+        envGate: {
+            requiredEnvVars: [apiKeyEnvVar, "MUAPI_BASE_URL"],
+            placeholderGuardedVars: [
+                { key: apiKeyEnvVar, placeholder: "your_muapi_key_here" },
+            ],
+            verifyCommandPath: "setup/verify-env.mjs",
+            requiredReachableSurfaces: [
+                {
+                    id: "local-fork-http",
+                    type: "http",
+                    target: `http://localhost:${defaultDevPort}`,
+                    required: false,
+                    description: "Local fork dev server (only required in local-fork mode)",
+                },
+            ],
+        },
+        setup: {
+            quickstart: "QUICKSTART.md",
+            envExample: ".env.example",
+            setupDir: "setup/",
+            outputDir: "output/",
+            files: [
+                { relativePath: "setup/clone-fork.sh", required: true, description: "Clone and boot the local fork" },
+                { relativePath: "setup/verify-env.mjs", required: true, description: "Validate the API key against the provider" },
+                { relativePath: "setup/check-deps.sh", required: true, description: "Check system dependencies" },
+            ],
+            requiredBinaries: [
+                { binary: "node", installHint: "https://nodejs.org", requiredForSurfaces: ["local-fork"] },
+                { binary: "npm", installHint: "Comes with Node.js", requiredForSurfaces: ["local-fork"] },
+                { binary: "git", installHint: "https://git-scm.com/downloads", requiredForSurfaces: ["local-fork"] },
+                { binary: "ffmpeg", installHint: "brew install ffmpeg", requiredForSurfaces: ["local-fork"] },
+            ],
+        },
+        forkInspection: {
+            upstreamRepoUrl,
+            defaultLocalPath,
+            defaultDevPort,
+            integrationDocPath: "docs/open-higgsfield-fork-integration.md",
+            inspectionRules: {
+                requiredPlanningFiles: [
+                    "packages/studio/src/models.js",
+                    "packages/studio/src/muapi.js",
+                ],
+                sourceOfTruthFiles: [
+                    "README.md",
+                    "package.json",
+                    "app/studio/page.js",
+                    "components/StandaloneShell.js",
+                    "components/ApiKeyModal.js",
+                    "packages/studio/src/index.js",
+                    "packages/studio/src/components/ImageStudio.jsx",
+                    "packages/studio/src/components/VideoStudio.jsx",
+                    "packages/studio/src/components/LipSyncStudio.jsx",
+                    "packages/studio/src/components/CinemaStudio.jsx",
+                    "electron/",
+                ],
+                note: "models.js and studio components outrank all upstream assumptions. Always inspect before planning.",
+            },
+        },
+        runtimeSurface: buildStudioRuntimeSurfaceContract(),
+        output: buildStudioOutputContract(),
+    };
+}
+//# sourceMappingURL=studio-kit.js.map

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

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

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

@@ -0,0 +1,57 @@
+/**
+ * Kit Factory — Workflow Kit Template
+ *
+ * Canonical ForkAdapterCoreConfig for Workflow kits.
+ *
+ * Workflow kits wrap a multi-step agentic pipeline or automation workflow.
+ * They may or may not involve a forked repo — the fork inspection surface
+ * is optional. The provider is typically an API that accepts structured inputs
+ * and returns async results (same submit/poll pattern as Studio kits).
+ *
+ * Example use cases:
+ *   - Email broadcast pipeline (sequence of generation + review + send steps)
+ *   - Content calendar automation (plan → draft → review → schedule)
+ *   - Multi-channel campaign runner
+ *
+ * Defaults:
+ *   surfaces      — browser-hosted (primary), local-fork (optional)
+ *   fork          — none declared (optional override)
+ *   output        — workflow-specific artifact set (overridden per kit)
+ */
+import type { ForkAdapterCoreConfig } from "../adapter-core/contracts.js";
+import type { RuntimeSurfaceType, OutputArtifactDeclaration } from "../types/index.js";
+export interface WorkflowKitOptions {
+    kitId: 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;
+    /** Optional fork details */
+    fork?: {
+        upstreamRepoUrl: string;
+        defaultLocalPath: string;
+        requiredPlanningFiles: string[];
+    };
+    /** Supported surfaces (default: browser-hosted + local-fork) */
+    supportedSurfaces?: RuntimeSurfaceType[];
+    /** Output artifacts for this workflow */
+    artifacts?: OutputArtifactDeclaration[];
+}
+export declare const WORKFLOW_KIT_DEFAULTS: {
+    readonly supportedSurfaces: RuntimeSurfaceType[];
+    readonly apiKeyPlaceholder: "your_api_key_here";
+    readonly providerAuthField: "x-api-key";
+    readonly providerReferenceDocPath: "docs/provider-adapter-layer.md";
+};
+export declare function createWorkflowKitConfig(options: WorkflowKitOptions): ForkAdapterCoreConfig;
+//# sourceMappingURL=workflow-kit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-kit.d.ts","sourceRoot":"","sources":["../../../../src/kits/core/factory/workflow-kit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAEvF,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,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,4BAA4B;IAC5B,IAAI,CAAC,EAAE;QACL,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;QACzB,qBAAqB,EAAE,MAAM,EAAE,CAAC;KACjC,CAAC;IACF,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACzC,yCAAyC;IACzC,SAAS,CAAC,EAAE,yBAAyB,EAAE,CAAC;CACzC;AAED,eAAO,MAAM,qBAAqB;gCACuB,kBAAkB,EAAE;;;;CAInE,CAAC;AAEX,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,GAAG,qBAAqB,CAkG1F"}

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

@@ -0,0 +1,107 @@
+/**
+ * Kit Factory — Workflow Kit Template
+ *
+ * Canonical ForkAdapterCoreConfig for Workflow kits.
+ *
+ * Workflow kits wrap a multi-step agentic pipeline or automation workflow.
+ * They may or may not involve a forked repo — the fork inspection surface
+ * is optional. The provider is typically an API that accepts structured inputs
+ * and returns async results (same submit/poll pattern as Studio kits).
+ *
+ * Example use cases:
+ *   - Email broadcast pipeline (sequence of generation + review + send steps)
+ *   - Content calendar automation (plan → draft → review → schedule)
+ *   - Multi-channel campaign runner
+ *
+ * Defaults:
+ *   surfaces      — browser-hosted (primary), local-fork (optional)
+ *   fork          — none declared (optional override)
+ *   output        — workflow-specific artifact set (overridden per kit)
+ */
+export const WORKFLOW_KIT_DEFAULTS = {
+    supportedSurfaces: ["browser-hosted", "local-fork"],
+    apiKeyPlaceholder: "your_api_key_here",
+    providerAuthField: "x-api-key",
+    providerReferenceDocPath: "docs/provider-adapter-layer.md",
+};
+export function createWorkflowKitConfig(options) {
+    const { kitId, apiKeyEnvVar, apiKeyPlaceholder = WORKFLOW_KIT_DEFAULTS.apiKeyPlaceholder, providerId, providerName, providerBaseUrl, providerAuthField = WORKFLOW_KIT_DEFAULTS.providerAuthField, providerReferenceDocPath = WORKFLOW_KIT_DEFAULTS.providerReferenceDocPath, fork, supportedSurfaces = WORKFLOW_KIT_DEFAULTS.supportedSurfaces, artifacts = [], } = options;
+    return {
+        kitId,
+        family: "workflow",
+        provider: {
+            providerId,
+            providerName,
+            operations: [
+                "UPLOAD_ASSET",
+                "SUBMIT_GENERATION",
+                "POLL_RESULT",
+                "NORMALIZE_RESULT",
+                "LIST_MODEL_CAPABILITIES",
+            ],
+            referenceDocPath: providerReferenceDocPath,
+            authMechanism: "api-key-header",
+            authField: providerAuthField,
+            baseUrl: providerBaseUrl,
+        },
+        envGate: {
+            requiredEnvVars: [apiKeyEnvVar],
+            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" },
+                { relativePath: "setup/check-deps.sh", required: false, description: "Check system dependencies" },
+            ],
+            requiredBinaries: fork
+                ? [
+                    { binary: "node", installHint: "https://nodejs.org", requiredForSurfaces: ["local-fork"] },
+                    { binary: "npm", installHint: "Comes with Node.js", requiredForSurfaces: ["local-fork"] },
+                    { binary: "git", installHint: "https://git-scm.com/downloads", requiredForSurfaces: ["local-fork"] },
+                ]
+                : [],
+        },
+        forkInspection: fork
+            ? {
+                upstreamRepoUrl: fork.upstreamRepoUrl,
+                defaultLocalPath: fork.defaultLocalPath,
+                integrationDocPath: "docs/fork-integration.md",
+                inspectionRules: {
+                    requiredPlanningFiles: fork.requiredPlanningFiles,
+                    sourceOfTruthFiles: fork.requiredPlanningFiles,
+                },
+            }
+            : {
+                upstreamRepoUrl: "",
+                defaultLocalPath: "",
+                integrationDocPath: "docs/provider-adapter-layer.md",
+                inspectionRules: {
+                    requiredPlanningFiles: [],
+                    sourceOfTruthFiles: [],
+                    note: "No fork declared for this workflow kit — using provider API directly.",
+                },
+            },
+        runtimeSurface: {
+            supportedSurfaces,
+            defaultSurface: supportedSurfaces[0] ?? "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=workflow-kit.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-kit.js","sourceRoot":"","sources":["../../../../src/kits/core/factory/workflow-kit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAiCH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,iBAAiB,EAAE,CAAC,gBAAgB,EAAE,YAAY,CAAyB;IAC3E,iBAAiB,EAAE,mBAAmB;IACtC,iBAAiB,EAAE,WAAW;IAC9B,wBAAwB,EAAE,gCAAgC;CAClD,CAAC;AAEX,MAAM,UAAU,uBAAuB,CAAC,OAA2B;IACjE,MAAM,EACJ,KAAK,EACL,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,IAAI,EACJ,iBAAiB,GAAG,qBAAqB,CAAC,iBAAiB,EAC3D,SAAS,GAAG,EAAE,GACf,GAAG,OAAO,CAAC;IAEZ,OAAO;QACL,KAAK;QACL,MAAM,EAAE,UAAU;QAElB,QAAQ,EAAE;YACR,UAAU;YACV,YAAY;YACZ,UAAU,EAAE;gBACV,cAAc;gBACd,mBAAmB;gBACnB,aAAa;gBACb,kBAAkB;gBAClB,yBAAyB;aAC1B;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,CAAC;YAC/B,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,EAAE,WAAW,EAAE,sBAAsB,EAAE;gBAC7F,EAAE,YAAY,EAAE,qBAAqB,EAAG,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,2BAA2B,EAAE;aACpG;YACD,gBAAgB,EAAE,IAAI;gBACpB,CAAC,CAAC;oBACE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,oBAAoB,EAAa,mBAAmB,EAAE,CAAC,YAAY,CAAC,EAAE;oBACrG,EAAE,MAAM,EAAE,KAAK,EAAG,WAAW,EAAE,oBAAoB,EAAa,mBAAmB,EAAE,CAAC,YAAY,CAAC,EAAE;oBACrG,EAAE,MAAM,EAAE,KAAK,EAAG,WAAW,EAAE,+BAA+B,EAAE,mBAAmB,EAAE,CAAC,YAAY,CAAC,EAAE;iBACtG;gBACH,CAAC,CAAC,EAAE;SACP;QAED,cAAc,EAAE,IAAI;YAClB,CAAC,CAAC;gBACE,eAAe,EAAE,IAAI,CAAC,eAAe;gBACrC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;gBACvC,kBAAkB,EAAE,0BAA0B;gBAC9C,eAAe,EAAE;oBACf,qBAAqB,EAAE,IAAI,CAAC,qBAAqB;oBACjD,kBAAkB,EAAE,IAAI,CAAC,qBAAqB;iBAC/C;aACF;YACH,CAAC,CAAC;gBACE,eAAe,EAAE,EAAE;gBACnB,gBAAgB,EAAE,EAAE;gBACpB,kBAAkB,EAAE,gCAAgC;gBACpD,eAAe,EAAE;oBACf,qBAAqB,EAAE,EAAE;oBACzB,kBAAkB,EAAE,EAAE;oBACtB,IAAI,EAAE,uEAAuE;iBAC9E;aACF;QAEL,cAAc,EAAE;YACd,iBAAiB;YACjB,cAAc,EAAE,iBAAiB,CAAC,CAAC,CAAC,IAAI,gBAAgB;YACxD,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/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Fork Adapter Core — Top-Level Barrel
+ *
+ * The primary import surface for the entire core module.
+ * Consuming code imports from here.
+ *
+ * @example
+ * import {
+ *   createStudioKitConfig,
+ *   runAdapterValidation,
+ *   buildMuapiProviderContract,
+ * } from '../kits/core/index.js';
+ */
+export * from "./types/index.js";
+export * from "./adapter-core/index.js";
+export { createStudioKitConfig, STUDIO_KIT_DEFAULTS, createWorkflowKitConfig, WORKFLOW_KIT_DEFAULTS, createOperatorKitConfig, OPERATOR_KIT_DEFAULTS, createOpsKitConfig, OPS_KIT_DEFAULTS, } from "./factory/index.js";
+export type { StudioKitOptions, WorkflowKitOptions, OperatorKitOptions, OpsKitOptions, } from "./factory/index.js";
+export { runAdapterValidation, formatAdapterValidationReport, } from "./validation/index.js";
+export type { AdapterValidationReport, AdapterValidationSection, } from "./validation/index.js";
+import type { ForkAdapterCoreConfig } from "./adapter-core/contracts.js";
+export declare function buildOpenHiggsfieldStudioConfig(): ForkAdapterCoreConfig;
+export declare function buildPostizSocialConfig(): ForkAdapterCoreConfig;
+export declare function buildAiWebsiteClonerConfig(): ForkAdapterCoreConfig;
+export declare function buildZernioSocialConfig(): ForkAdapterCoreConfig;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/kits/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,cAAc,yBAAyB,CAAC;AAGxC,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAS/B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEzE,wBAAgB,+BAA+B,IAAI,qBAAqB,CASvE;AAQD,wBAAgB,uBAAuB,IAAI,qBAAqB,CAsB/D;AAQD,wBAAgB,0BAA0B,IAAI,qBAAqB,CASlE;AAUD,wBAAgB,uBAAuB,IAAI,qBAAqB,CAsB/D"}

package/dist/kits/core/index.js

@@ -0,0 +1,111 @@
+/**
+ * Fork Adapter Core — Top-Level Barrel
+ *
+ * The primary import surface for the entire core module.
+ * Consuming code imports from here.
+ *
+ * @example
+ * import {
+ *   createStudioKitConfig,
+ *   runAdapterValidation,
+ *   buildMuapiProviderContract,
+ * } from '../kits/core/index.js';
+ */
+// Types
+export * from "./types/index.js";
+// Adapter core contracts and validators
+export * from "./adapter-core/index.js";
+// Kit factory — family templates
+export { createStudioKitConfig, STUDIO_KIT_DEFAULTS, createWorkflowKitConfig, WORKFLOW_KIT_DEFAULTS, createOperatorKitConfig, OPERATOR_KIT_DEFAULTS, createOpsKitConfig, OPS_KIT_DEFAULTS, } from "./factory/index.js";
+// Validation runner
+export { runAdapterValidation, formatAdapterValidationReport, } from "./validation/index.js";
+// ---------------------------------------------------------------------------
+// Reference config: Open Higgsfield Studio Kit (growthub-open-higgsfield-studio-v1)
+// The canonical Studio family reference — used in tests and as a living example.
+// ---------------------------------------------------------------------------
+import { createStudioKitConfig } from "./factory/studio-kit.js";
+import { createOperatorKitConfig } from "./factory/operator-kit.js";
+export function buildOpenHiggsfieldStudioConfig() {
+    return createStudioKitConfig({
+        kitId: "growthub-open-higgsfield-studio-v1",
+        upstreamRepoUrl: "https://github.com/Anil-matcha/Open-Higgsfield-AI",
+        defaultLocalPath: "~/open-higgsfield-ai",
+        defaultDevPort: 3001,
+        apiKeyEnvVar: "MUAPI_API_KEY",
+        providerId: "muapi",
+    });
+}
+// ---------------------------------------------------------------------------
+// Reference config: Postiz Social Media Studio Kit (growthub-postiz-social-v1)
+// Operator family reference wrapping the Postiz open-source social media platform.
+// Supports 28+ platforms, BullMQ scheduling, AI captions, and multi-workspace.
+// ---------------------------------------------------------------------------
+export function buildPostizSocialConfig() {
+    return createOperatorKitConfig({
+        kitId: "growthub-postiz-social-v1",
+        vertical: "social-media",
+        apiKeyEnvVar: "ANTHROPIC_API_KEY",
+        apiKeyPlaceholder: "your_anthropic_key_here",
+        providerId: "postiz",
+        providerName: "Postiz (self-hosted)",
+        providerBaseUrl: "http://localhost:3000",
+        providerAuthField: "Authorization",
+        providerReferenceDocPath: "docs/postiz-fork-integration.md",
+        additionalRequiredEnvVars: ["POSTIZ_API_URL"],
+        artifacts: [
+            { name: "Social Campaign Brief", relativePath: "templates/social-campaign-brief.md", required: true, description: "Campaign objectives, platforms, audience, and KPI targets" },
+            { name: "Content Calendar", relativePath: "templates/content-calendar.md", required: true, description: "30/60/90-day posting plan with theme pillars and cadence" },
+            { name: "Platform Publishing Plan", relativePath: "templates/platform-publishing-plan.md", required: true, description: "Per-platform format, frequency, and content mix specs" },
+            { name: "Caption Copy Deck", relativePath: "templates/caption-copy-deck.md", required: true, description: "A/B/C caption variants per post with hashtag sets" },
+            { name: "Scheduling Manifest", relativePath: "templates/scheduling-manifest.md", required: false, description: "BullMQ-compatible JSON manifest for Postiz API bulk scheduling" },
+            { name: "Analytics Brief", relativePath: "templates/analytics-brief.md", required: false, description: "Per-platform performance report with recommendations" },
+            { name: "Client Proposal", relativePath: "templates/client-proposal.md", required: false, description: "Agency-ready pitch with platform mix and ROI projection" },
+        ],
+    });
+}
+// ---------------------------------------------------------------------------
+// Reference config: AI Website Cloner Kit (growthub-ai-website-cloner-v1)
+// Studio family — local fork of ai-website-cloner-template by JCodesMore.
+// No provider API key required — all AI work is done by the local agent.
+// ---------------------------------------------------------------------------
+export function buildAiWebsiteClonerConfig() {
+    return createStudioKitConfig({
+        kitId: "growthub-ai-website-cloner-v1",
+        upstreamRepoUrl: "https://github.com/JCodesMore/ai-website-cloner-template",
+        defaultLocalPath: "~/ai-website-cloner-template",
+        defaultDevPort: 3000,
+        apiKeyEnvVar: "AI_CLONER_FORK_PATH",
+        providerId: "local-agent",
+    });
+}
+// ---------------------------------------------------------------------------
+// Reference config: Zernio Social Media Studio Kit (growthub-zernio-social-v1)
+// Operator family wrapping the hosted Zernio unified social media REST API.
+// Supports 14 platforms, recurring queues, media uploads, unified inbox,
+// and analytics. Auth is a single ZERNIO_API_KEY bearer token against
+// https://zernio.com/api/v1 — no self-hosted fork to clone.
+// ---------------------------------------------------------------------------
+export function buildZernioSocialConfig() {
+    return createOperatorKitConfig({
+        kitId: "growthub-zernio-social-v1",
+        vertical: "social-media",
+        apiKeyEnvVar: "ZERNIO_API_KEY",
+        apiKeyPlaceholder: "your_zernio_api_key_here",
+        providerId: "zernio",
+        providerName: "Zernio (hosted)",
+        providerBaseUrl: "https://zernio.com/api/v1",
+        providerAuthField: "Authorization",
+        providerReferenceDocPath: "docs/zernio-api-integration.md",
+        additionalRequiredEnvVars: ["ZERNIO_API_URL"],
+        artifacts: [
+            { name: "Social Campaign Brief", relativePath: "templates/social-campaign-brief.md", required: true, description: "Campaign objectives, platforms, audience, and KPI targets" },
+            { name: "Content Calendar", relativePath: "templates/content-calendar.md", required: true, description: "30/60/90-day posting plan with theme pillars and cadence" },
+            { name: "Platform Publishing Plan", relativePath: "templates/platform-publishing-plan.md", required: true, description: "Per-platform format, frequency, and content mix specs" },
+            { name: "Caption Copy Deck", relativePath: "templates/caption-copy-deck.md", required: true, description: "A/B/C caption variants per post with hashtag sets" },
+            { name: "Scheduling Manifest", relativePath: "templates/scheduling-manifest.md", required: false, description: "Zernio-shaped JSON manifest for POST /api/v1/posts scheduling" },
+            { name: "Analytics Brief", relativePath: "templates/analytics-brief.md", required: false, description: "Per-platform performance report with recommendations" },
+            { name: "Client Proposal", relativePath: "templates/client-proposal.md", required: false, description: "Agency-ready pitch with platform mix and ROI projection" },
+        ],
+    });
+}
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,65 @@
+/**
+ * Fork Adapter Core — Shared Type Primitives
+ *
+ * Kit family taxonomy and shared primitive types consumed across
+ * adapter-core, factory, and validation modules.
+ *
+ * Kit families map to vertical use cases:
+ *   studio   — wraps a forked open-source AI studio (image/video/audio/cinema)
+ *   workflow — wraps a multi-step agentic pipeline or automation workflow
+ *   operator — wraps a domain-specific operator (e.g. email, growth, content)
+ *   ops      — wraps an infrastructure or devops execution surface
+ */
+export type KitFamily = "studio" | "workflow" | "operator" | "ops";
+export declare const KIT_FAMILIES: readonly KitFamily[];
+export type ProviderOperation = "UPLOAD_ASSET" | "SUBMIT_GENERATION" | "POLL_RESULT" | "NORMALIZE_RESULT" | "LIST_MODEL_CAPABILITIES" | "CANCEL_JOB" | "LIST_HISTORY" | "HEALTHCHECK";
+export declare const REQUIRED_PROVIDER_OPERATIONS: readonly ProviderOperation[];
+export declare const OPTIONAL_PROVIDER_OPERATIONS: readonly ProviderOperation[];
+export type RuntimeSurfaceType = "local-fork" | "browser-hosted" | "desktop-app" | "custom";
+export declare const RUNTIME_SURFACE_TYPES: readonly RuntimeSurfaceType[];
+export type ReachabilityProbeType = "http" | "file" | "process";
+export interface ReachabilityProbe {
+    id: string;
+    type: ReachabilityProbeType;
+    target: string;
+    required: boolean;
+    description?: string;
+}
+export interface SetupFileDeclaration {
+    relativePath: string;
+    required: boolean;
+    description: string;
+}
+export interface RequiredBinaryDeclaration {
+    binary: string;
+    installHint: string;
+    requiredForSurfaces: RuntimeSurfaceType[];
+}
+export interface ForkInspectionRule {
+    requiredPlanningFiles: string[];
+    sourceOfTruthFiles: string[];
+    note?: string;
+}
+export interface OutputArtifactDeclaration {
+    name: string;
+    relativePath: string;
+    required: boolean;
+    description: string;
+}
+export type ValidationSeverity = "error" | "warning" | "info";
+export interface ValidationIssue {
+    severity: ValidationSeverity;
+    code: string;
+    message: string;
+    field?: string;
+    path?: string;
+}
+export interface CoreValidationResult {
+    valid: boolean;
+    issues: ValidationIssue[];
+    passedChecks: string[];
+}
+export declare function makeError(code: string, message: string, field?: string): ValidationIssue;
+export declare function makeWarning(code: string, message: string, field?: string): ValidationIssue;
+export declare function makeInfo(code: string, message: string): ValidationIssue;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/kits/core/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,KAAK,CAAC;AAEnE,eAAO,MAAM,YAAY,EAAE,SAAS,SAAS,EAKnC,CAAC;AAMX,MAAM,MAAM,iBAAiB,GACzB,cAAc,GACd,mBAAmB,GACnB,aAAa,GACb,kBAAkB,GAClB,yBAAyB,GACzB,YAAY,GACZ,cAAc,GACd,aAAa,CAAC;AAElB,eAAO,MAAM,4BAA4B,EAAE,SAAS,iBAAiB,EAM3D,CAAC;AAEX,eAAO,MAAM,4BAA4B,EAAE,SAAS,iBAAiB,EAI3D,CAAC;AAMX,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,gBAAgB,GAAG,aAAa,GAAG,QAAQ,CAAC;AAE5F,eAAO,MAAM,qBAAqB,EAAE,SAAS,kBAAkB,EAKrD,CAAC;AAMX,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,qBAAqB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;CAC3C;AAMD,MAAM,WAAW,kBAAkB;IACjC,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAMD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAExF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,eAAe,CAE1F;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,CAEvE"}

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

@@ -0,0 +1,49 @@
+/**
+ * Fork Adapter Core — Shared Type Primitives
+ *
+ * Kit family taxonomy and shared primitive types consumed across
+ * adapter-core, factory, and validation modules.
+ *
+ * Kit families map to vertical use cases:
+ *   studio   — wraps a forked open-source AI studio (image/video/audio/cinema)
+ *   workflow — wraps a multi-step agentic pipeline or automation workflow
+ *   operator — wraps a domain-specific operator (e.g. email, growth, content)
+ *   ops      — wraps an infrastructure or devops execution surface
+ */
+export const KIT_FAMILIES = [
+    "studio",
+    "workflow",
+    "operator",
+    "ops",
+];
+export const REQUIRED_PROVIDER_OPERATIONS = [
+    "UPLOAD_ASSET",
+    "SUBMIT_GENERATION",
+    "POLL_RESULT",
+    "NORMALIZE_RESULT",
+    "LIST_MODEL_CAPABILITIES",
+];
+export const OPTIONAL_PROVIDER_OPERATIONS = [
+    "CANCEL_JOB",
+    "LIST_HISTORY",
+    "HEALTHCHECK",
+];
+export const RUNTIME_SURFACE_TYPES = [
+    "local-fork",
+    "browser-hosted",
+    "desktop-app",
+    "custom",
+];
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+export function makeError(code, message, field) {
+    return { severity: "error", code, message, field };
+}
+export function makeWarning(code, message, field) {
+    return { severity: "warning", code, message, field };
+}
+export function makeInfo(code, message) {
+    return { severity: "info", code, message };
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/kits/core/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,MAAM,CAAC,MAAM,YAAY,GAAyB;IAChD,QAAQ;IACR,UAAU;IACV,UAAU;IACV,KAAK;CACG,CAAC;AAgBX,MAAM,CAAC,MAAM,4BAA4B,GAAiC;IACxE,cAAc;IACd,mBAAmB;IACnB,aAAa;IACb,kBAAkB;IAClB,yBAAyB;CACjB,CAAC;AAEX,MAAM,CAAC,MAAM,4BAA4B,GAAiC;IACxE,YAAY;IACZ,cAAc;IACd,aAAa;CACL,CAAC;AAQX,MAAM,CAAC,MAAM,qBAAqB,GAAkC;IAClE,YAAY;IACZ,gBAAgB;IAChB,aAAa;IACb,QAAQ;CACA,CAAC;AAyEX,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAAe,EAAE,KAAc;IACrE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,OAAe,EAAE,KAAc;IACvE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,OAAe;IACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC7C,CAAC"}

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

@@ -0,0 +1,42 @@
+/**
+ * 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 type { ForkAdapterCoreConfig } from "../adapter-core/contracts.js";
+import type { ValidationIssue } from "../types/index.js";
+export interface AdapterValidationReport {
+    kitId: string;
+    family: string;
+    overallValid: boolean;
+    sections: AdapterValidationSection[];
+    totalErrors: number;
+    totalWarnings: number;
+    totalInfos: number;
+    passedChecks: string[];
+}
+export interface AdapterValidationSection {
+    name: string;
+    valid: boolean;
+    issues: ValidationIssue[];
+    passedChecks: string[];
+}
+export declare function runAdapterValidation(kitRoot: string, config: ForkAdapterCoreConfig, options?: {
+    skipEnvGate?: boolean;
+    skipForkInspection?: boolean;
+    includeFileHashes?: boolean;
+}): AdapterValidationReport;
+export declare function formatAdapterValidationReport(report: AdapterValidationReport): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/kits/core/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAO1E,OAAO,KAAK,EAEV,eAAe,EAEhB,MAAM,mBAAmB,CAAC;AAM3B,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,wBAAwB,EAAE,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAMD,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,qBAAqB,EAC7B,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACxB,GACL,uBAAuB,CAiFzB;AAMD,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,uBAAuB,GAAG,MAAM,CAoBrF"}