@growthub/cli 0.6.0 → 0.6.1

package/dist/runtime/native-intelligence/contract.js

@@ -0,0 +1,23 @@
+/**
+ * Native Intelligence — Contract Types
+ *
+ * Stable types that define what the intelligence layer is allowed to see
+ * and what it can return. This is the boundary contract between the
+ * existing Growthub runtime and the Gemma model layer.
+ *
+ * Guardrails:
+ *   - Model layer does not directly run tools
+ *   - Model layer only shapes, recommends, explains, and drafts
+ *   - Final compile/save/execute still goes through existing contract pipeline
+ *   - Hosted runtime remains canonical execution truth
+ *   - CMS nodes remain canonical execution primitives
+ */
+export const DEFAULT_INTELLIGENCE_CONFIG = {
+    modelId: "gemma3",
+    backendType: "local",
+    endpoint: "http://localhost:8080/v1/chat/completions",
+    defaultTemperature: 0.3,
+    defaultMaxTokens: 4096,
+    timeoutMs: 30_000,
+};
+//# sourceMappingURL=contract.js.map

package/dist/runtime/native-intelligence/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../src/runtime/native-intelligence/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAwOH,MAAM,CAAC,MAAM,2BAA2B,GAA6B;IACnE,OAAO,EAAE,QAAQ;IACjB,WAAW,EAAE,OAAO;IACpB,QAAQ,EAAE,2CAA2C;IACrD,kBAAkB,EAAE,GAAG;IACvB,gBAAgB,EAAE,IAAI;IACtB,SAAS,EAAE,MAAM;CAClB,CAAC"}

package/dist/runtime/native-intelligence/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Native Intelligence Module
+ *
+ * A contract-driven intelligence layer that plugs into existing Growthub
+ * runtime contracts. Sits above the contract pipeline and below user intent,
+ * helping plan, normalize, recommend, and summarize without replacing the
+ * hosted runtime or CMS node substrate.
+ *
+ * Architecture:
+ *   Growthub runtime/orchestrator = OS
+ *   CMS nodes / workflows / kits = executable primitives
+ *   Gemma layer = planner / router / normalizer / recommender
+ *
+ * Model mapping:
+ *   - Gemma 3: hosted reasoning/planning/summaries (128K context)
+ *   - Gemma 3n: local/on-machine multimodal assistance (32K context)
+ *   - CodeGemma: code/graph synthesis tasks
+ *
+ * Guardrails:
+ *   - Hosted runtime remains canonical execution truth
+ *   - CMS nodes remain canonical execution primitives
+ *   - Model layer does not directly run tools
+ *   - Model layer only shapes, recommends, explains, and drafts
+ *   - Final compile/save/execute still goes through existing contract pipeline
+ */
+import type { NativeIntelligenceProvider, NativeIntelligenceConfig } from "./contract.js";
+export type { NativeIntelligenceProvider, NativeIntelligenceBackend, NativeIntelligenceConfig, NativeIntelligenceModelId, ModelCompletionInput, ModelCompletionResult, WorkflowPlanningInput, WorkflowPlanningResult, ProposedPipelineNode, PlanningConstraints, BindingNormalizationInput, BindingNormalizationResult, NormalizedField, WorkflowRecommendationInput, WorkflowRecommendationResult, WorkflowRecommendation, RecommendationStrategy, ExecutionSummaryInput, ExecutionSummaryResult, PipelineSummaryForIntelligence, ExecutionResultForIntelligence, ExecutionModeContext, WorkflowSummaryForIntelligence, } from "./contract.js";
+export { DEFAULT_INTELLIGENCE_CONFIG } from "./contract.js";
+export { createNativeIntelligenceBackend, createStubBackend, checkBackendHealth, NativeIntelligenceBackendError } from "./provider.js";
+export { summarizeExecution, buildDeterministicSummary } from "./summarizer.js";
+export { intelligentNormalizeBindings, buildDeterministicNormalization } from "./normalizer.js";
+export { recommendWorkflow, buildDeterministicRecommendation } from "./recommender.js";
+export { planWorkflow, buildDeterministicPlan } from "./planner.js";
+export declare function readIntelligenceConfig(): NativeIntelligenceConfig;
+export declare function writeIntelligenceConfig(config: NativeIntelligenceConfig): void;
+export declare function createNativeIntelligenceProvider(configOverride?: Partial<NativeIntelligenceConfig>): NativeIntelligenceProvider;
+export declare function createDeterministicProvider(): NativeIntelligenceProvider;
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/native-intelligence/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/native-intelligence/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAKH,OAAO,KAAK,EACV,0BAA0B,EAE1B,wBAAwB,EAUzB,MAAM,eAAe,CAAC;AAYvB,YAAY,EACV,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,0BAA0B,EAC1B,eAAe,EACf,2BAA2B,EAC3B,4BAA4B,EAC5B,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,8BAA8B,EAC9B,8BAA8B,EAC9B,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAE,+BAA+B,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,8BAA8B,EAAE,MAAM,eAAe,CAAC;AACvI,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,EAAE,4BAA4B,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AAChG,OAAO,EAAE,iBAAiB,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAUpE,wBAAgB,sBAAsB,IAAI,wBAAwB,CAoBjE;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,wBAAwB,GAAG,IAAI,CAI9E;AAWD,wBAAgB,gCAAgC,CAC9C,cAAc,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GACjD,0BAA0B,CAuB5B;AAMD,wBAAgB,2BAA2B,IAAI,0BAA0B,CAoBxE"}

package/dist/runtime/native-intelligence/index.js

@@ -0,0 +1,121 @@
+/**
+ * Native Intelligence Module
+ *
+ * A contract-driven intelligence layer that plugs into existing Growthub
+ * runtime contracts. Sits above the contract pipeline and below user intent,
+ * helping plan, normalize, recommend, and summarize without replacing the
+ * hosted runtime or CMS node substrate.
+ *
+ * Architecture:
+ *   Growthub runtime/orchestrator = OS
+ *   CMS nodes / workflows / kits = executable primitives
+ *   Gemma layer = planner / router / normalizer / recommender
+ *
+ * Model mapping:
+ *   - Gemma 3: hosted reasoning/planning/summaries (128K context)
+ *   - Gemma 3n: local/on-machine multimodal assistance (32K context)
+ *   - CodeGemma: code/graph synthesis tasks
+ *
+ * Guardrails:
+ *   - Hosted runtime remains canonical execution truth
+ *   - CMS nodes remain canonical execution primitives
+ *   - Model layer does not directly run tools
+ *   - Model layer only shapes, recommends, explains, and drafts
+ *   - Final compile/save/execute still goes through existing contract pipeline
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { resolvePaperclipHomeDir } from "../../config/home.js";
+import { DEFAULT_INTELLIGENCE_CONFIG } from "./contract.js";
+import { createNativeIntelligenceBackend } from "./provider.js";
+import { summarizeExecution, buildDeterministicSummary } from "./summarizer.js";
+import { intelligentNormalizeBindings, buildDeterministicNormalization } from "./normalizer.js";
+import { recommendWorkflow, buildDeterministicRecommendation } from "./recommender.js";
+import { planWorkflow, buildDeterministicPlan } from "./planner.js";
+export { DEFAULT_INTELLIGENCE_CONFIG } from "./contract.js";
+export { createNativeIntelligenceBackend, createStubBackend, checkBackendHealth, NativeIntelligenceBackendError } from "./provider.js";
+export { summarizeExecution, buildDeterministicSummary } from "./summarizer.js";
+export { intelligentNormalizeBindings, buildDeterministicNormalization } from "./normalizer.js";
+export { recommendWorkflow, buildDeterministicRecommendation } from "./recommender.js";
+export { planWorkflow, buildDeterministicPlan } from "./planner.js";
+// ---------------------------------------------------------------------------
+// Configuration persistence
+// ---------------------------------------------------------------------------
+function resolveConfigPath() {
+    return path.resolve(resolvePaperclipHomeDir(), "native-intelligence", "config.json");
+}
+export function readIntelligenceConfig() {
+    const configPath = resolveConfigPath();
+    if (!fs.existsSync(configPath)) {
+        return { ...DEFAULT_INTELLIGENCE_CONFIG };
+    }
+    try {
+        const raw = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+        return {
+            modelId: validateModelId(raw.modelId),
+            backendType: raw.backendType === "hosted" ? "hosted" : "local",
+            endpoint: typeof raw.endpoint === "string" ? raw.endpoint : DEFAULT_INTELLIGENCE_CONFIG.endpoint,
+            localModel: typeof raw.localModel === "string" ? raw.localModel : undefined,
+            apiKey: typeof raw.apiKey === "string" ? raw.apiKey : undefined,
+            defaultTemperature: typeof raw.defaultTemperature === "number" ? raw.defaultTemperature : DEFAULT_INTELLIGENCE_CONFIG.defaultTemperature,
+            defaultMaxTokens: typeof raw.defaultMaxTokens === "number" ? raw.defaultMaxTokens : DEFAULT_INTELLIGENCE_CONFIG.defaultMaxTokens,
+            timeoutMs: typeof raw.timeoutMs === "number" ? raw.timeoutMs : DEFAULT_INTELLIGENCE_CONFIG.timeoutMs,
+        };
+    }
+    catch {
+        return { ...DEFAULT_INTELLIGENCE_CONFIG };
+    }
+}
+export function writeIntelligenceConfig(config) {
+    const configPath = resolveConfigPath();
+    fs.mkdirSync(path.dirname(configPath), { recursive: true });
+    fs.writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf-8");
+}
+function validateModelId(id) {
+    if (id === "gemma3" || id === "gemma3n" || id === "codegemma")
+        return id;
+    return "gemma3";
+}
+// ---------------------------------------------------------------------------
+// Provider factory
+// ---------------------------------------------------------------------------
+export function createNativeIntelligenceProvider(configOverride) {
+    const config = { ...readIntelligenceConfig(), ...configOverride };
+    const backend = createNativeIntelligenceBackend(config);
+    return {
+        id: config.modelId,
+        async planWorkflow(input) {
+            return planWorkflow(input, backend);
+        },
+        async normalizeBindings(input) {
+            return intelligentNormalizeBindings(input, backend);
+        },
+        async recommendWorkflow(input) {
+            return recommendWorkflow(input, backend);
+        },
+        async summarizeExecution(input) {
+            return summarizeExecution(input, backend);
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Deterministic-only provider (no model backend needed)
+// ---------------------------------------------------------------------------
+export function createDeterministicProvider() {
+    return {
+        id: "gemma3",
+        async planWorkflow(input) {
+            return buildDeterministicPlan(input);
+        },
+        async normalizeBindings(input) {
+            return buildDeterministicNormalization(input);
+        },
+        async recommendWorkflow(input) {
+            return buildDeterministicRecommendation(input);
+        },
+        async summarizeExecution(input) {
+            return buildDeterministicSummary(input);
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/runtime/native-intelligence/index.js.map

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

package/dist/runtime/native-intelligence/normalizer.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Native Intelligence — Normalizer (Phase 2)
+ *
+ * Turns user/agent-friendly inputs into runtime-safe shapes using the
+ * intelligence layer. This is where the first big reliability jump comes
+ * from because it:
+ *   - Normalizes local assets into contract-safe refs
+ *   - Fills provider-neutral defaults
+ *   - Detects placeholder-like values
+ *   - Converts friendly values into compiled node inputs
+ *   - Spots incomplete bindings and proposes fixes
+ *
+ * Works alongside (not replacing) the existing deterministic normalizer
+ * in cms-node-contracts/normalize.ts. The intelligence normalizer adds
+ * semantic understanding on top of the mechanical normalization.
+ *
+ * Falls back to deterministic normalization when model is unavailable.
+ */
+import type { NativeIntelligenceBackend, BindingNormalizationInput, BindingNormalizationResult } from "./contract.js";
+export declare function intelligentNormalizeBindings(input: BindingNormalizationInput, backend: NativeIntelligenceBackend): Promise<BindingNormalizationResult>;
+export declare function buildDeterministicNormalization(input: BindingNormalizationInput): BindingNormalizationResult;
+//# sourceMappingURL=normalizer.d.ts.map

package/dist/runtime/native-intelligence/normalizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizer.d.ts","sourceRoot":"","sources":["../../../src/runtime/native-intelligence/normalizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,yBAAyB,EACzB,0BAA0B,EAG3B,MAAM,eAAe,CAAC;AA2CvB,wBAAsB,4BAA4B,CAChD,KAAK,EAAE,yBAAyB,EAChC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,0BAA0B,CAAC,CAqBrC;AAMD,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,yBAAyB,GAC/B,0BAA0B,CA0F5B"}

package/dist/runtime/native-intelligence/normalizer.js

@@ -0,0 +1,307 @@
+/**
+ * Native Intelligence — Normalizer (Phase 2)
+ *
+ * Turns user/agent-friendly inputs into runtime-safe shapes using the
+ * intelligence layer. This is where the first big reliability jump comes
+ * from because it:
+ *   - Normalizes local assets into contract-safe refs
+ *   - Fills provider-neutral defaults
+ *   - Detects placeholder-like values
+ *   - Converts friendly values into compiled node inputs
+ *   - Spots incomplete bindings and proposes fixes
+ *
+ * Works alongside (not replacing) the existing deterministic normalizer
+ * in cms-node-contracts/normalize.ts. The intelligence normalizer adds
+ * semantic understanding on top of the mechanical normalization.
+ *
+ * Falls back to deterministic normalization when model is unavailable.
+ */
+// ---------------------------------------------------------------------------
+// System prompt for binding normalization
+// ---------------------------------------------------------------------------
+const NORMALIZER_SYSTEM_PROMPT = `You are a binding normalizer for the Growthub workflow platform.
+Your job is to take raw user/agent input bindings for a CMS workflow node and normalize them into runtime-safe shapes.
+
+Given a node contract (input schema) and raw bindings, you must:
+1. Identify which bindings are present and which are missing
+2. Detect placeholder-like values ("enter X", "select Y", empty strings, "placeholder")
+3. Coerce types where possible (string "123" -> number 123, "true" -> boolean true)
+4. Propose defaults for missing optional fields based on the contract
+5. Flag required fields that cannot be inferred
+6. Normalize asset references into consistent formats
+
+Rules:
+- NEVER invent values for required fields — only flag them as missing
+- For optional fields with obvious defaults (e.g., quality=1080, format="mp4"), propose the default
+- Detect and clear placeholder strings
+- Preserve user-provided values that are already valid
+
+Respond in JSON:
+{
+  "fields": [
+    {
+      "key": "string",
+      "originalValue": "any",
+      "normalizedValue": "any",
+      "action": "kept | coerced | defaulted | cleared | inferred",
+      "reason": "string | null"
+    }
+  ],
+  "missingRequired": ["string — keys of required fields that are missing"],
+  "warnings": ["string — warnings about the normalization"],
+  "confidence": 0.0-1.0
+}`;
+// ---------------------------------------------------------------------------
+// Normalizer
+// ---------------------------------------------------------------------------
+export async function intelligentNormalizeBindings(input, backend) {
+    const userPrompt = buildNormalizerPrompt(input);
+    try {
+        const completion = await backend.complete({
+            systemPrompt: NORMALIZER_SYSTEM_PROMPT,
+            userPrompt,
+            temperature: 0.1,
+            maxTokens: 2048,
+            responseFormat: "json",
+        });
+        const parsed = parseJsonSafe(completion.text);
+        if (parsed) {
+            return toNormalizationResult(parsed, input);
+        }
+    }
+    catch {
+        // Fall through to deterministic fallback
+    }
+    return buildDeterministicNormalization(input);
+}
+// ---------------------------------------------------------------------------
+// Deterministic fallback (no model required)
+// ---------------------------------------------------------------------------
+export function buildDeterministicNormalization(input) {
+    const { rawBindings, contract } = input;
+    const fields = [];
+    const missingRequired = [];
+    const warnings = [];
+    const normalizedBindings = {};
+    for (const field of contract.inputs) {
+        const rawValue = rawBindings[field.key];
+        const hasValue = field.key in rawBindings;
+        if (!hasValue) {
+            if (field.required) {
+                missingRequired.push(field.key);
+                fields.push({
+                    key: field.key,
+                    originalValue: undefined,
+                    normalizedValue: undefined,
+                    action: "cleared",
+                    reason: `Required field "${field.label}" is not provided.`,
+                });
+            }
+            else if (field.defaultValue !== undefined && field.defaultValue !== null && field.defaultValue !== "") {
+                normalizedBindings[field.key] = field.defaultValue;
+                fields.push({
+                    key: field.key,
+                    originalValue: undefined,
+                    normalizedValue: field.defaultValue,
+                    action: "defaulted",
+                    reason: `Using contract default for "${field.label}".`,
+                });
+            }
+            continue;
+        }
+        if (isPlaceholderValue(rawValue)) {
+            if (field.required) {
+                missingRequired.push(field.key);
+                warnings.push(`"${field.label}" contains a placeholder value and is required.`);
+            }
+            fields.push({
+                key: field.key,
+                originalValue: rawValue,
+                normalizedValue: field.defaultValue ?? "",
+                action: "cleared",
+                reason: "Placeholder value detected and cleared.",
+            });
+            normalizedBindings[field.key] = field.defaultValue ?? "";
+            continue;
+        }
+        const coerced = coerceToFieldType(rawValue, field.type);
+        if (coerced !== rawValue) {
+            normalizedBindings[field.key] = coerced;
+            fields.push({
+                key: field.key,
+                originalValue: rawValue,
+                normalizedValue: coerced,
+                action: "coerced",
+                reason: `Coerced from ${typeof rawValue} to ${field.type}.`,
+            });
+        }
+        else {
+            normalizedBindings[field.key] = rawValue;
+            fields.push({
+                key: field.key,
+                originalValue: rawValue,
+                normalizedValue: rawValue,
+                action: "kept",
+            });
+        }
+    }
+    for (const [key, value] of Object.entries(rawBindings)) {
+        if (contract.inputs.some((i) => i.key === key))
+            continue;
+        normalizedBindings[key] = value;
+        fields.push({
+            key,
+            originalValue: value,
+            normalizedValue: value,
+            action: "kept",
+            reason: "Extra binding not in contract — passed through.",
+        });
+    }
+    return {
+        normalizedBindings,
+        fields,
+        missingRequired,
+        warnings,
+        confidence: 1.0,
+    };
+}
+// ---------------------------------------------------------------------------
+// Placeholder detection
+// ---------------------------------------------------------------------------
+function isPlaceholderValue(value) {
+    if (typeof value !== "string")
+        return false;
+    const normalized = value.trim().toLowerCase();
+    if (!normalized)
+        return true;
+    return (normalized.startsWith("enter ") ||
+        normalized.startsWith("select ") ||
+        normalized === "placeholder" ||
+        normalized === "todo" ||
+        normalized === "tbd" ||
+        normalized === "n/a" ||
+        normalized === "none" ||
+        normalized === "your_" ||
+        normalized.startsWith("your_") ||
+        normalized.startsWith("<") && normalized.endsWith(">"));
+}
+// ---------------------------------------------------------------------------
+// Type coercion
+// ---------------------------------------------------------------------------
+function coerceToFieldType(value, targetType) {
+    if (targetType === "number" && typeof value === "string") {
+        const trimmed = value.trim();
+        if (trimmed.length > 0 && !Number.isNaN(Number(trimmed))) {
+            return Number(trimmed);
+        }
+    }
+    if (targetType === "boolean" && typeof value === "string") {
+        const lower = value.trim().toLowerCase();
+        if (lower === "true" || lower === "yes" || lower === "1")
+            return true;
+        if (lower === "false" || lower === "no" || lower === "0")
+            return false;
+    }
+    if (targetType === "array" && typeof value === "string") {
+        try {
+            const parsed = JSON.parse(value);
+            if (Array.isArray(parsed))
+                return parsed;
+        }
+        catch {
+            // Not valid JSON array — return as-is
+        }
+    }
+    if (targetType === "object" && typeof value === "string") {
+        try {
+            const parsed = JSON.parse(value);
+            if (parsed && typeof parsed === "object" && !Array.isArray(parsed))
+                return parsed;
+        }
+        catch {
+            // Not valid JSON object — return as-is
+        }
+    }
+    return value;
+}
+// ---------------------------------------------------------------------------
+// Prompt builder
+// ---------------------------------------------------------------------------
+function buildNormalizerPrompt(input) {
+    const { nodeSlug, rawBindings, contract, userIntent, executionMode } = input;
+    const sections = [
+        `Node Slug: ${nodeSlug}`,
+        `Execution Mode: ${executionMode ?? "hosted"}`,
+    ];
+    if (userIntent) {
+        sections.push(`User Intent: ${userIntent}`);
+    }
+    sections.push("", "Contract Inputs:");
+    for (const field of contract.inputs) {
+        sections.push(`  - ${field.key} (${field.type}): ${field.required ? "REQUIRED" : "optional"}`
+            + (field.defaultValue !== undefined && field.defaultValue !== null && field.defaultValue !== ""
+                ? ` [default: ${JSON.stringify(field.defaultValue)}]`
+                : ""));
+    }
+    sections.push("", "Raw Bindings:");
+    for (const [key, value] of Object.entries(rawBindings)) {
+        sections.push(`  - ${key}: ${JSON.stringify(value)}`);
+    }
+    return sections.join("\n");
+}
+function toNormalizationResult(raw, input) {
+    const normalizedBindings = {};
+    const fields = [];
+    if (Array.isArray(raw.fields)) {
+        for (const f of raw.fields) {
+            if (typeof f.key !== "string")
+                continue;
+            const action = validateAction(f.action);
+            normalizedBindings[f.key] = f.normalizedValue ?? f.originalValue ?? input.rawBindings[f.key];
+            fields.push({
+                key: f.key,
+                originalValue: f.originalValue ?? input.rawBindings[f.key],
+                normalizedValue: f.normalizedValue ?? f.originalValue ?? input.rawBindings[f.key],
+                action,
+                reason: typeof f.reason === "string" ? f.reason : undefined,
+            });
+        }
+    }
+    for (const [key, value] of Object.entries(input.rawBindings)) {
+        if (!(key in normalizedBindings)) {
+            normalizedBindings[key] = value;
+        }
+    }
+    return {
+        normalizedBindings,
+        fields,
+        missingRequired: Array.isArray(raw.missingRequired) ? raw.missingRequired : [],
+        warnings: Array.isArray(raw.warnings) ? raw.warnings : [],
+        confidence: typeof raw.confidence === "number" ? Math.max(0, Math.min(1, raw.confidence)) : 0.5,
+    };
+}
+function validateAction(action) {
+    const valid = ["kept", "coerced", "defaulted", "cleared", "inferred"];
+    if (typeof action === "string" && valid.includes(action)) {
+        return action;
+    }
+    return "kept";
+}
+// ---------------------------------------------------------------------------
+// JSON parse helper
+// ---------------------------------------------------------------------------
+function parseJsonSafe(text) {
+    try {
+        const trimmed = text.trim();
+        const jsonStart = trimmed.indexOf("{");
+        const jsonEnd = trimmed.lastIndexOf("}");
+        if (jsonStart >= 0 && jsonEnd > jsonStart) {
+            return JSON.parse(trimmed.slice(jsonStart, jsonEnd + 1));
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=normalizer.js.map

package/dist/runtime/native-intelligence/normalizer.js.map

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

package/dist/runtime/native-intelligence/planner.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Native Intelligence — Planner (Phase 4)
+ *
+ * Generates or refines workflow graphs from intent + contract truth.
+ *
+ * V1 scope:
+ *   - Recommend a node sequence from available contracts
+ *   - Map node slugs to fulfill user intent
+ *   - Suggest bindings to collect
+ *   - Optionally choose an existing workflow instead of creating a new one
+ *
+ * Important rule:
+ *   Planner does NOT execute.
+ *   Planner outputs graph suggestions only.
+ *   Final compile/save/execute still goes through the existing contract pipeline.
+ *
+ * Falls back to deterministic single-node planning when model is unavailable.
+ */
+import type { NativeIntelligenceBackend, WorkflowPlanningInput, WorkflowPlanningResult } from "./contract.js";
+export declare function planWorkflow(input: WorkflowPlanningInput, backend: NativeIntelligenceBackend): Promise<WorkflowPlanningResult>;
+export declare function buildDeterministicPlan(input: WorkflowPlanningInput): WorkflowPlanningResult;
+//# sourceMappingURL=planner.d.ts.map

package/dist/runtime/native-intelligence/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../../src/runtime/native-intelligence/planner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EACV,yBAAyB,EACzB,qBAAqB,EACrB,sBAAsB,EAKvB,MAAM,eAAe,CAAC;AA6CvB,wBAAsB,YAAY,CAChC,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,sBAAsB,CAAC,CAqBjC;AAMD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,qBAAqB,GAC3B,sBAAsB,CA2ExB"}