@x12i/graphenix-executable-format 1.0.0

package/dist/validators/validate-studio-execute-request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-studio-execute-request.js","sourceRoot":"","sources":["../../src/validators/validate-studio-execute-request.ts"],"names":[],"mappings":";;AAQA,oEA+DC;AAED,kEAIC;AAxED,mDAA2D;AAC3D,iFAAyE;AAEzE,SAAgB,4BAA4B,CAC1C,OAAgB;IAEhB,MAAM,MAAM,GAAqC,EAAE,CAAC;IAEpD,IAAI,CAAC,IAAA,mBAAQ,EAAC,OAAO,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE;gBACN,IAAA,oBAAS,EACP,gCAAgC,EAChC,2CAA2C,EAC3C,EAAE,CACH;aACF;SACF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CACT,IAAA,oBAAS,EACP,gCAAgC,EAChC,4CAA4C,EAC5C,OAAO,CACR,CACF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpE,MAAM,CAAC,IAAI,CACT,IAAA,oBAAS,EACP,gCAAgC,EAChC,2CAA2C,EAC3C,QAAQ,CACT,CACF,CAAC;IACJ,CAAC;IAED,IAAI,mBAAmB,IAAI,OAAO,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CACT,IAAA,oBAAS,EACP,sCAAsC,EACtC,+FAA+F,EAC/F,oBAAoB,CACrB,CACF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CACT,IAAA,oBAAS,EACP,gCAAgC,EAChC,2CAA2C,EAC3C,QAAQ,CACT,CACF,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,MAAM,WAAW,GAAG,IAAA,sDAAuB,EAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC3D,MAAM,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAEnC,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAED,SAAgB,2BAA2B,CACzC,KAAc;IAEd,OAAO,4BAA4B,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC;AACnD,CAAC"}

package/dist/validators/validate-task-actions.d.ts

@@ -0,0 +1,4 @@
+import type { ExecutableGraphValidationError } from "../types/errors.js";
+export declare function validateTaskActionList(nodeId: string, actions: unknown, listPath: string, allowActionLevelModelOverride: boolean): ExecutableGraphValidationError[];
+export declare function validateTaskNodeActions(nodeId: string, taskConfiguration: unknown, allowActionLevelModelOverride: boolean): ExecutableGraphValidationError[];
+//# sourceMappingURL=validate-task-actions.d.ts.map

package/dist/validators/validate-task-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-task-actions.d.ts","sourceRoot":"","sources":["../../src/validators/validate-task-actions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AA2BzE,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,6BAA6B,EAAE,OAAO,GACrC,8BAA8B,EAAE,CA4GlC;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,iBAAiB,EAAE,OAAO,EAC1B,6BAA6B,EAAE,OAAO,GACrC,8BAA8B,EAAE,CAqDlC"}

package/dist/validators/validate-task-actions.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateTaskActionList = validateTaskActionList;
+exports.validateTaskNodeActions = validateTaskNodeActions;
+const utils_js_1 = require("../internal/utils.js");
+const validate_profile_choice_js_1 = require("../profile-choice/validate-profile-choice.js");
+function validateActionConfigObject(value, path, label) {
+    if (value === undefined) {
+        return [];
+    }
+    if (!(0, utils_js_1.isRecord)(value)) {
+        return [
+            (0, utils_js_1.execError)("TASK_ACTION_INVALID", `${label} must be a JSON object.`, path)
+        ];
+    }
+    return [];
+}
+function validateTaskActionList(nodeId, actions, listPath, allowActionLevelModelOverride) {
+    const errors = [];
+    if (actions === undefined) {
+        return errors;
+    }
+    if (!Array.isArray(actions)) {
+        errors.push((0, utils_js_1.execError)("TASK_ACTION_INVALID", `${listPath} must be an array.`, listPath));
+        return errors;
+    }
+    const seenIds = new Set();
+    for (const [index, action] of actions.entries()) {
+        const path = `${listPath}/${index}`;
+        if (!(0, utils_js_1.isRecord)(action)) {
+            errors.push((0, utils_js_1.execError)("TASK_ACTION_INVALID", `Action ${index} on node ${nodeId} must be an object.`, path));
+            continue;
+        }
+        const actionConfig = action;
+        if (typeof actionConfig.id !== "string" || actionConfig.id.length === 0) {
+            errors.push((0, utils_js_1.execError)("TASK_ACTION_INVALID", `Action ${index} on node ${nodeId} must define id.`, `${path}/id`));
+        }
+        else if (seenIds.has(actionConfig.id)) {
+            errors.push((0, utils_js_1.execError)("TASK_ACTION_ID_DUPLICATE", `Duplicate action id "${actionConfig.id}" on node ${nodeId}.`, `${path}/id`));
+        }
+        else {
+            seenIds.add(actionConfig.id);
+        }
+        if (typeof actionConfig.actionKey !== "string" ||
+            actionConfig.actionKey.length === 0) {
+            errors.push((0, utils_js_1.execError)("TASK_ACTION_MISSING_ACTION_KEY", `Action ${actionConfig.id ?? index} on node ${nodeId} must define actionKey.`, `${path}/actionKey`));
+        }
+        errors.push(...validateActionConfigObject(actionConfig.config, `${path}/config`, "config"));
+        errors.push(...validateActionConfigObject(actionConfig.inputsConfig, `${path}/inputsConfig`, "inputsConfig"));
+        errors.push(...validateActionConfigObject(actionConfig.outputMapping, `${path}/outputMapping`, "outputMapping"));
+        if (actionConfig.modelSelection !== undefined) {
+            if (!allowActionLevelModelOverride) {
+                errors.push((0, utils_js_1.execError)("TASK_ACTION_MODEL_OVERRIDE_FORBIDDEN", `Action ${actionConfig.id ?? index} on node ${nodeId} defines modelSelection but graph policy allowActionLevelModelOverride is false.`, `${path}/modelSelection`));
+            }
+            else {
+                errors.push(...(0, validate_profile_choice_js_1.validateAiModelSelection)(actionConfig.modelSelection, `${path}/modelSelection`));
+            }
+        }
+    }
+    return errors;
+}
+function validateTaskNodeActions(nodeId, taskConfiguration, allowActionLevelModelOverride) {
+    if (!(0, utils_js_1.isRecord)(taskConfiguration)) {
+        return [];
+    }
+    const preActions = taskConfiguration.preActions;
+    const postActions = taskConfiguration.postActions;
+    const basePath = `/graph/nodes/${nodeId}/parameters/taskConfiguration`;
+    const errors = [];
+    errors.push(...validateTaskActionList(nodeId, preActions, `${basePath}/preActions`, allowActionLevelModelOverride));
+    errors.push(...validateTaskActionList(nodeId, postActions, `${basePath}/postActions`, allowActionLevelModelOverride));
+    if (Array.isArray(preActions) && Array.isArray(postActions)) {
+        const ids = new Set();
+        for (const [listName, list] of [
+            ["preActions", preActions],
+            ["postActions", postActions]
+        ]) {
+            for (const [index, action] of list.entries()) {
+                if (!(0, utils_js_1.isRecord)(action) || typeof action.id !== "string") {
+                    continue;
+                }
+                if (ids.has(action.id)) {
+                    errors.push((0, utils_js_1.execError)("TASK_ACTION_ID_DUPLICATE", `Duplicate action id "${action.id}" on node ${nodeId}.`, `${basePath}/${listName}/${index}/id`));
+                }
+                else {
+                    ids.add(action.id);
+                }
+            }
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=validate-task-actions.js.map

package/dist/validators/validate-task-actions.js.map

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

package/dist/validators/validate-task-node.d.ts

@@ -0,0 +1,6 @@
+import type { Node } from "@x12i/graphenix-core";
+import type { ExecutableGraphValidationError } from "../types/errors.js";
+import type { GraphDocument } from "@x12i/graphenix-core";
+export declare function validateTaskNode(node: Node, doc?: GraphDocument): ExecutableGraphValidationError[];
+export declare function isTaskNodeParameters(value: unknown): boolean;
+//# sourceMappingURL=validate-task-node.d.ts.map

package/dist/validators/validate-task-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-task-node.d.ts","sourceRoot":"","sources":["../../src/validators/validate-task-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAazE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,GAAG,CAAC,EAAE,aAAa,GAClB,8BAA8B,EAAE,CAyElC;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAM5D"}

package/dist/validators/validate-task-node.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateTaskNode = validateTaskNode;
+exports.isTaskNodeParameters = isTaskNodeParameters;
+const constants_js_1 = require("../constants.js");
+const utils_js_1 = require("../internal/utils.js");
+const validate_model_config_js_1 = require("./validate-model-config.js");
+const validate_task_actions_js_1 = require("./validate-task-actions.js");
+function validateTaskNode(node, doc) {
+    const errors = [];
+    const basePath = `/graph/nodes/${node.id}`;
+    if (node.kind !== constants_js_1.TASK_NODE_KIND) {
+        errors.push((0, utils_js_1.execError)("TASK_NODE_INVALID", `Node ${node.id} must use kind ${constants_js_1.TASK_NODE_KIND}.`, `${basePath}/kind`));
+        return errors;
+    }
+    const params = (0, utils_js_1.getTaskNodeConfig)(node);
+    if (!params) {
+        errors.push((0, utils_js_1.execError)("TASK_NODE_MISSING_PARAMETERS", `Task node ${node.id} must define executable task parameters.`, `${basePath}/parameters`));
+        return errors;
+    }
+    if (params.profile !== constants_js_1.EXECUTABLE_NODE_PROFILE) {
+        errors.push((0, utils_js_1.execError)("TASK_NODE_INVALID", `Task node ${node.id} parameters.profile must be ${constants_js_1.EXECUTABLE_NODE_PROFILE}.`, `${basePath}/parameters/profile`));
+    }
+    if (params.nodeType !== "task") {
+        errors.push((0, utils_js_1.execError)("TASK_NODE_INVALID", `Task node ${node.id} parameters.nodeType must be task.`, `${basePath}/parameters/nodeType`));
+    }
+    if (typeof params.skillKey !== "string" || params.skillKey.length === 0) {
+        errors.push((0, utils_js_1.execError)("TASK_NODE_MISSING_SKILL_KEY", `Task node ${node.id} must define skillKey.`, `${basePath}/parameters/skillKey`));
+    }
+    const nodeModelConfig = params.taskConfiguration?.modelConfig;
+    const inherit = nodeModelConfig?.inherit !== false;
+    errors.push(...(0, validate_model_config_js_1.validateNodeModelConfig)(node.id, nodeModelConfig, inherit));
+    const allowActionLevelModelOverride = (doc ? (0, utils_js_1.getExecutableProfile)(doc)?.policies?.allowActionLevelModelOverride : undefined) ??
+        false;
+    errors.push(...(0, validate_task_actions_js_1.validateTaskNodeActions)(node.id, params.taskConfiguration, allowActionLevelModelOverride));
+    return errors;
+}
+function isTaskNodeParameters(value) {
+    return ((0, utils_js_1.isRecord)(value) &&
+        value.profile === constants_js_1.EXECUTABLE_NODE_PROFILE &&
+        value.nodeType === "task");
+}
+//# sourceMappingURL=validate-task-node.js.map

package/dist/validators/validate-task-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-task-node.js","sourceRoot":"","sources":["../../src/validators/validate-task-node.ts"],"names":[],"mappings":";;AAgBA,4CA4EC;AAED,oDAMC;AAlGD,kDAGyB;AACzB,mDAK8B;AAC9B,yEAAqE;AACrE,yEAAqE;AAGrE,SAAgB,gBAAgB,CAC9B,IAAU,EACV,GAAmB;IAEnB,MAAM,MAAM,GAAqC,EAAE,CAAC;IACpD,MAAM,QAAQ,GAAG,gBAAgB,IAAI,CAAC,EAAE,EAAE,CAAC;IAE3C,IAAI,IAAI,CAAC,IAAI,KAAK,6BAAc,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CACT,IAAA,oBAAS,EACP,mBAAmB,EACnB,QAAQ,IAAI,CAAC,EAAE,kBAAkB,6BAAc,GAAG,EAClD,GAAG,QAAQ,OAAO,CACnB,CACF,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,4BAAiB,EAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,CAAC,IAAI,CACT,IAAA,oBAAS,EACP,8BAA8B,EAC9B,aAAa,IAAI,CAAC,EAAE,0CAA0C,EAC9D,GAAG,QAAQ,aAAa,CACzB,CACF,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,KAAK,sCAAuB,EAAE,CAAC;QAC/C,MAAM,CAAC,IAAI,CACT,IAAA,oBAAS,EACP,mBAAmB,EACnB,aAAa,IAAI,CAAC,EAAE,+BAA+B,sCAAuB,GAAG,EAC7E,GAAG,QAAQ,qBAAqB,CACjC,CACF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CACT,IAAA,oBAAS,EACP,mBAAmB,EACnB,aAAa,IAAI,CAAC,EAAE,oCAAoC,EACxD,GAAG,QAAQ,sBAAsB,CAClC,CACF,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,CAAC,IAAI,CACT,IAAA,oBAAS,EACP,6BAA6B,EAC7B,aAAa,IAAI,CAAC,EAAE,wBAAwB,EAC5C,GAAG,QAAQ,sBAAsB,CAClC,CACF,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,MAAM,CAAC,iBAAiB,EAAE,WAAW,CAAC;IAC9D,MAAM,OAAO,GAAG,eAAe,EAAE,OAAO,KAAK,KAAK,CAAC;IACnD,MAAM,CAAC,IAAI,CAAC,GAAG,IAAA,kDAAuB,EAAC,IAAI,CAAC,EAAE,EAAE,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;IAE3E,MAAM,6BAA6B,GACjC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAA,+BAAoB,EAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,6BAA6B,CAAC,CAAC,CAAC,SAAS,CAAC;QACtF,KAAK,CAAC;IACR,MAAM,CAAC,IAAI,CACT,GAAG,IAAA,kDAAuB,EACxB,IAAI,CAAC,EAAE,EACP,MAAM,CAAC,iBAAiB,EACxB,6BAA6B,CAC9B,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,oBAAoB,CAAC,KAAc;IACjD,OAAO,CACL,IAAA,mBAAQ,EAAC,KAAK,CAAC;QACf,KAAK,CAAC,OAAO,KAAK,sCAAuB;QACzC,KAAK,CAAC,QAAQ,KAAK,MAAM,CAC1B,CAAC;AACJ,CAAC"}

package/docs/IMPLEMENTATION-REPORT.md

@@ -0,0 +1,200 @@
+# Implementation Report: Deterministic Case-Based Model Configuration
+
+**Package:** `@x12i/graphenix-executable-format`  
+**Status:** Ready for publish  
+**Date:** 2026-06-06  
+**Related packages:** `@x12i/graphenix-core`, `@x12i/ai-profiles`
+
+---
+
+## 1. Goal
+
+Support **conditional model configuration cases** in executable Graphenix graphs while ensuring model/profile selection remains:
+
+- deterministic
+- auditable
+- non-AI selected
+- validated
+- explainable
+- safe for execution
+
+**Core rule:** Cases may choose stronger or weaker `profileChoice` keys. AI may never choose which case applies.
+
+---
+
+## 2. What was implemented
+
+### 2.1 Case condition DSL
+
+| Component | Location |
+| --------- | -------- |
+| Types (`CaseCondition`, predicates) | `src/types/case-condition.ts` |
+| Validation | `src/case-condition/validate-case-condition.ts` |
+| Evaluation | `src/case-condition/evaluate-case-condition.ts` |
+| Allowed/forbidden paths | `src/case-condition/allowed-paths.ts` |
+
+Supports `all`, `any`, `not`, and path predicates (`eq`, `neq`, `in`, `notIn`, `exists`, `notExists`, `gt`, `gte`, `lt`, `lte`, `matches`).
+
+Rejects AI/LLM/semantic/function-based selectors and forbidden path roots (`ai.*`, `node.output.*`, `executionMemory.ai.*`, etc.).
+
+### 2.2 Profile choice via `@x12i/ai-profiles`
+
+| Component | Location |
+| --------- | -------- |
+| `kind: "profileChoice"` type | `src/types/model-config.ts` |
+| Format + known-key validation | `src/profile-choice/known-profile-choices.ts` |
+| Selection validation | `src/profile-choice/validate-profile-choice.ts` |
+
+- Delegates `isProfileChoiceKeyFormat` and `isKnownProfileChoice` to `@x12i/ai-profiles` bundled registry.
+- Rejects deprecated `kind: "profile"`.
+- Does **not** resolve `profileChoice` → vendor/model during normalization.
+
+**Dependency:** `"@x12i/ai-profiles": "^3.2.0"` in `package.json`.
+
+### 2.3 Case selection
+
+| Component | Location |
+| --------- | -------- |
+| Graph case selection | `src/case-condition/select-graph-model-case.ts` |
+| Node case selection | `src/case-condition/select-node-model-case.ts` |
+| Resolution | `src/resolution/resolve-node-ai-plan.ts` |
+
+Rules enforced:
+
+1. Graph cases evaluated before node cases.
+2. First matching conditional case wins.
+3. Fallback to `id: "default"` when no conditional case matches.
+4. Exactly one default graph case (validated).
+5. Graph cases require full model triplet.
+6. Node cases may be partial when `inherit: true`.
+7. `caseSelection` with matched condition explanations on resolved plans.
+
+### 2.4 Authoring vs normalized forms
+
+| Component | Location |
+| --------- | -------- |
+| Graph `default` → `cases[]` | `src/normalize/normalize-model-config.ts` |
+| Node `modelConfig` → `cases[]` | same |
+| Full graph normalize | `src/normalize/normalize-executable-graph.ts` |
+| Authoring validation | `src/validators/validate-authoring-executable-graph.ts` |
+| Normalized validation | `src/validators/validate-normalized-executable-graph.ts` |
+| Assert normalized | `src/validators/assert-normalized-executable-graph.ts` |
+
+`compileExecutablePlan` now calls `assertNormalizedExecutableGraph()` after normalization.
+
+### 2.5 Compile, studio adapter, trace
+
+| Component | Location |
+| --------- | -------- |
+| Plan compilation | `src/compile/compile-executable-plan.ts` |
+| Studio adapter | `src/adapter/build-graph-execution-request-from-studio-execute.ts` |
+| Execution trace | `src/trace/` |
+| Execution units | `src/compile/build-node-execution-units.ts` |
+
+Engine receives `{ plan, runtime }` — not raw authoring graph.
+
+### 2.6 Fallback
+
+`src/resolution/resolve-node-model-slot.ts` — same-slot fallback only, from selected graph case triplet. Policy-gated via `fallbackPolicy`.
+
+---
+
+## 3. Error codes (section 14)
+
+All CR/FR error codes are defined in `src/types/errors.ts` and emitted by validators except:
+
+| Code | Status |
+| ---- | ------ |
+| `CASE_SELECTION_UNRESOLVED` | Reserved — runtime always falls back to default case; authoring validation catches missing default via `CASE_SELECTION_DEFAULT_MISSING` |
+
+---
+
+## 4. Acceptance test coverage
+
+**44 tests pass** in `src/test/executable-format.test.ts`.
+
+### Explicitly covered (section 18)
+
+| AC | Test |
+| -- | ---- |
+| AC-001 | `runtime.mode eq simulate` accepted |
+| AC-004–006 | `all`, `any`, `not` evaluation |
+| AC-007–008 | First matching case / default fallback |
+| AC-009 | Missing default case fails |
+| AC-020, 024–025 | Forbidden AI selectors / paths |
+| AC-030–039 | Profile choice validation |
+| AC-060, AC-066 | Graph normalization |
+| Section 12 example | Full resolution with graph + node cases |
+| AC-070 partial | Studio adapter compiles plan |
+| AC-075–076 | Forbidden runtime/request model defaults |
+| Fallback partial | Same-slot fallback test |
+
+### Covered indirectly (integration tests)
+
+- Graph inheritance (AC-044, AC-053)
+- Node partial override (AC-050, AC-054)
+- Compile lifecycle (AC-P001, AC-E003)
+- Execution units + trace (separate CR)
+
+### Not yet dedicated tests
+
+AC-002, AC-003, AC-010, AC-021–023, AC-026–027, AC-041–043, AC-051, AC-061–065, AC-082.
+
+Core logic for these exists in validators; tests can be added incrementally.
+
+---
+
+## 5. Known limitations
+
+| Item | Notes |
+| ---- | ----- |
+| JSON Schema | `schema/graphenix-executable-format-1.0.0.schema.json` is a structural subset; full semantics enforced by TS validators |
+| Studio UI | Case preview / resolved plan display is Studio responsibility (out of package scope) |
+| AC-037 | `openai/gpt-4o-mini` passes format check per `@x12i/ai-profiles`; rejected as `PROFILE_CHOICE_KEY_UNKNOWN` |
+| Node authoring shorthand | Uses `modelConfig` field (not `default`); normalizes to `cases[0].id = "default"` |
+
+---
+
+## 5. Non-goals (per CR/FR section 19)
+
+Not added to `@x12i/graphenix-core`:
+
+- AI model profiles
+- profileChoice validation
+- Case selection for models
+- Fallback policies
+- Runtime object / studio envelope
+- LLM invocation
+
+These belong only in `@x12i/graphenix-executable-format` (+ `@x12i/ai-profiles` for registry).
+
+---
+
+## 6. Publish readiness
+
+| Check | Status |
+| ----- | ------ |
+| Build passes | ✅ |
+| 44 tests pass | ✅ |
+| `@x12i/ai-profiles` dependency declared | ✅ |
+| README updated | ✅ |
+| `compileExecutablePlan` asserts normalized graph | ✅ |
+| First npm publish (`@x12i/graphenix-core@2.0.0`, `@x12i/graphenix-executable-format@1.0.0`) | Pending |
+
+**Publish order:** `@x12i/graphenix-core` first, then `@x12i/graphenix-executable-format`.
+
+---
+
+## 7. Final rule (enforced)
+
+```txt
+The graph may contain conditional model/profile cases.
+Those cases may select stronger or weaker profileChoice keys.
+Case selection must be deterministic and based only on allowed runtime/graph context.
+AI is never allowed to choose which AI model/profile case applies.
+All profile-based slots must use explicit @x12i/ai-profiles composite keys: profile/choice.
+The saved graph is Design/Edit (Authoring) form.
+The engine uses Normalized/Executable form via ExecutableGraphPlan.
+Graph-level selected case is the inheritance and fallback source.
+Node-level selected case may partially override it.
+```

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@x12i/graphenix-executable-format",
+  "version": "1.0.0",
+  "description": "X12i executable graph profile: deterministic model cases, profileChoice validation via @x12i/ai-profiles, compile/trace lifecycle, studio adapter.",
+  "license": "MIT",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json",
+    "clean": "rimraf dist",
+    "test": "npm run build && node --test dist/test/*.test.js",
+    "prepare": "npm run build"
+  },
+  "files": [
+    "dist",
+    "schema",
+    "docs"
+  ],
+  "keywords": [
+    "graph",
+    "graphenix",
+    "executable",
+    "workflow",
+    "validation",
+    "ai-profiles",
+    "profileChoice",
+    "deterministic"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/x12i/graphenix-format.git",
+    "directory": "packages/executable-format"
+  },
+  "bugs": {
+    "url": "https://github.com/x12i/graphenix-format/issues"
+  },
+  "homepage": "https://github.com/x12i/graphenix-format/tree/master/packages/executable-format#readme",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "peerDependencies": {
+    "@x12i/graphenix-core": "^2.0.0"
+  },
+  "dependencies": {
+    "@x12i/ai-profiles": "^3.2.0",
+    "@x12i/graphenix-core": "^2.0.0",
+    "ajv": "^8.17.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.1",
+    "rimraf": "^6.0.1",
+    "typescript": "^5.6.3"
+  }
+}

package/schema/graphenix-executable-format-1.0.0.schema.json

@@ -0,0 +1,40 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://graphenix.dev/schema/graphenix-executable-format-1.0.0.json",
+  "title": "Graphenix Executable Profile 1.0.0",
+  "description": "JSON Schema fragment for x12i.executable/v1 profile under graph.metadata.extensions.",
+  "type": "object",
+  "required": ["profileVersion", "modelConfig"],
+  "additionalProperties": true,
+  "properties": {
+    "profileVersion": {
+      "const": "x12i.executable/v1"
+    },
+    "modelConfig": {
+      "type": "object",
+      "required": ["version", "cases"],
+      "properties": {
+        "version": { "const": "graph-model-config/v1" },
+        "cases": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "required": ["id", "modelConfig"],
+            "properties": {
+              "id": { "type": "string" },
+              "modelConfig": {
+                "type": "object",
+                "required": [
+                  "preActionModel",
+                  "skillModel",
+                  "postActionModel"
+                ]
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}