@exellix/graph-engine 8.2.0 → 8.4.0

package/.env.example

@@ -1,3 +1,16 @@
-# ============================================
-# nx-mongo Configuration
-# ============================================
+# Graph-engine host environment (copy to .env and fill in secrets)
+
+# Mongo — job runs (@exellix/exellix-db) and Memorix entity/event stores
+MONGO_URI=mongodb://localhost:27017
+
+# Memorix databases (bridged to Xronox via applyMemorixEnvBridgeToProcess)
+MEMORIX_ENTITIES_DB=memorix-entities
+MEMORIX_EVENTS_DB=memorix-events
+
+# Catalox — descriptor resolution for Memorix read/write local skills
+CATALOX_APP_ID=your-app-id
+CATALOX_STORE_ID=your-store-id
+
+# LLM keys — required when graphs include ai-tasks nodes
+# OPENROUTER_API_KEY=
+# GEMINI_API_KEY=

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 8.4.0 — Graphenix 2.5.0 coordinated release
+
+### Changed
+
+- **`@x12i/graphenix-*` ^2.5.0** — CRS-FRS-003 `jobMemory.context` on graph model; authoring validation + plan-compiler preservation.
+- **`check:no-legacy`** — floors graphenix-core/plan-compiler/plan-format ≥2.5.0.
+
+## 8.3.0 — Graphenix 2.4.0 PRE synthesis input contract alignment
+
+### Changed
+
+- **`@x12i/graphenix-*` ^2.4.0** — PRE synthesis reads decoupled from `inputsConfig` / `smartInput`; empty `memoryPaths` / `reads` valid (runtime default trio).
+- **`@exellix/ai-tasks` ^10.0.4**, **`@exellix/ai-skills` ^6.12.0** — PRE path resolver + default `jobVariables`, `taskVariables`, `input` reads.
+- **`check:no-legacy`** — floors ai-tasks ≥10.0.4, ai-skills ≥6.12.0, graphenix-core/plan-compiler/plan-format ≥2.4.0; rejects `executionMemory.input` in fixture `smartInput.paths`.
+
+### Added
+
+- **`assertCanonicalTaskNode`** rejects `executionMemory.input` in `smartInput.paths` and `inputSynthesis.sources`.
+
+### Fixed
+
+- **`graph-qcrbz6t-pre-synthesis` fixture** — removed legacy `smartInput: executionMemory.input` on synthesis task nodes (matches studio Part 2 target export).
+- **Integration tests** — expect PRE synthesis unit `memoryPaths: []`, `reads: []`; no `smartInput` on wire when absent.
+
+### Downstream
+
+- Studio handoff split: `temp/downstream/graphs-studio/CRS-FRS-005-PART-1` (UI housekeeping) and `PART-2` (PRE emission).
+
 ## 8.1.12 — Graphenix 2.1.0 path-only synthesis release
 
 ### Changed

package/dist/src/index.d.ts

@@ -119,4 +119,5 @@ export type { CreatePlaygroundReporterOptions, PlaygroundDebugArtifact, Playgrou
 export { getNodeScopingQuestion, getNodeMemoryShape, getNodeNarrixDiscovery, fetchNodeScopingData, inspectNode, resolveNodeSkillKey, getGraphNodes, getGraphCatalogs, inspectGraph, collectPredicatePaths, executionMemoryPathTail, executionMemoryTailsMatch, getNodeExecutionMemoryWriteTails, getNodeControlDependencies, getNodeSideEffects, inspectFinalizer, inspectNodeContract, inspectGraphContracts, EXELLIX_VIRTUAL_GRAPH_ENTRY_NODE_ID, EXELLIX_VIRTUAL_GRAPH_RESPONSE_NODE_ID, EXELLIX_VIRTUAL_BOUNDARY_NODE_METADATA_KEY, EXELLIX_VIRTUAL_BOUNDARY_EDGE_FLAG_KEY, getVirtualGraphEntryLayer, getVirtualGraphResponseLayer, materializeVirtualBoundaryDiagram, stripMaterializedVirtualBoundaryDiagram, validateCatalogPlanning, isCatalogBinding, isCatalogRequestEntry, inspectGraphModelSelection, } from './inspection/index.js';
 export type { GraphModelSelectionInspection, NodeModelSelection, ModelSelectionSource, NodeScopingQuestion, NodeScopeSource, NodeScopeTarget, NodeScopingData, NodeMemoryShape, MemoryPath, NodeNarrixDiscovery, NodeInspection, GraphInspection, NodeIOEdge, GraphCatalogs, CatalogBindingSummary, CatalogPlanningValidationIssue, GraphVirtualIO, GraphVirtualIONode, GraphVirtualIOEdge, GraphVirtualIONodeRole, VirtualGraphEntryLayer, VirtualGraphResponseLayer, MaterializeVirtualBoundaryDiagramOptions, MaterializedVirtualBoundaryDiagram, MaterializedVirtualBoundaryDiagramMeta, InspectNodeContractOptions, LocalSkillKey, NodeExecutionType, FactProvenance, ProvenancedSection, NodeInputBindingEntry, ScopedDataDependency, NodeInputContract, ExecutionMemoryWriteSpec, NodeOutputContract, NodeSideEffects, ControlBranchEntry, NodeControlContract, NodeValidationContract, FinalizerContractInspection, NodeContractInspection, GraphContractsInspection, } from './inspection/index.js';
 export type { NarrixPreProcessorConfig, WebScopeQuestion, LocalTaskHandler, LocalTaskContext } from './types/narrix.js';
+export { shutdownMemorixRuntime } from './runtime/localSkills/memorixRuntime.js';
 export type { ScopedDataReaderConfig, ScopedDataReaderOutput, ScopedDataReaderPackOutput, ScopedAnswerAssemblerConfig, ScopedAnswerAssemblerOutput, ScopedAnswerWriterConfig, ScopedAnswerWriterOutput, } from './runtime/localSkills/index.js';

package/dist/src/index.js

@@ -87,4 +87,5 @@ export { composeEventEmitters } from './runtime/events.js';
 export { createPlaygroundReporter } from './playground/index.js';
 // Graph Inspection API
 export { getNodeScopingQuestion, getNodeMemoryShape, getNodeNarrixDiscovery, fetchNodeScopingData, inspectNode, resolveNodeSkillKey, getGraphNodes, getGraphCatalogs, inspectGraph, collectPredicatePaths, executionMemoryPathTail, executionMemoryTailsMatch, getNodeExecutionMemoryWriteTails, getNodeControlDependencies, getNodeSideEffects, inspectFinalizer, inspectNodeContract, inspectGraphContracts, EXELLIX_VIRTUAL_GRAPH_ENTRY_NODE_ID, EXELLIX_VIRTUAL_GRAPH_RESPONSE_NODE_ID, EXELLIX_VIRTUAL_BOUNDARY_NODE_METADATA_KEY, EXELLIX_VIRTUAL_BOUNDARY_EDGE_FLAG_KEY, getVirtualGraphEntryLayer, getVirtualGraphResponseLayer, materializeVirtualBoundaryDiagram, stripMaterializedVirtualBoundaryDiagram, validateCatalogPlanning, isCatalogBinding, isCatalogRequestEntry, inspectGraphModelSelection, } from './inspection/index.js';
+export { shutdownMemorixRuntime } from './runtime/localSkills/memorixRuntime.js';
 // Web context rendering — consume execution.webContext → markdown for prompts (Layer 04)

package/dist/src/runtime/validateCanonicalGraphDocument.js

@@ -6,6 +6,7 @@ import { getStructuredDataFilterPathViolations } from './dataFiltersEvaluation.j
 import { conditionWhenSignature, countDefaultModelConfigCases, isEmptyConditionWhen, isGraphAiModelConfig, isModelConfigSelection, isPartialGraphAiModelConfig, } from './modelConfigSelection.js';
 import { assertGraphAiProfileNameString } from './graphAiModelConfig.js';
 import { assertCanonicalGraphDocumentMetadata } from './graphModelStudioSeparation.js';
+import { collectSmartInputPaths } from './smartInputPaths.js';
 /** Top-level keys permitted on a canonical exellix-graph executable graph JSON document. */
 export const CANONICAL_GRAPH_TOP_LEVEL_KEYS = [
     'id',
@@ -544,7 +545,7 @@ export function assertCanonicalTaskNode(node, context, options) {
             }
         }
         if (legacyPreInputPaths.length > 0) {
-            throw new ExellixGraphError(ExellixGraphErrorCode.NON_CANONICAL_TASK_NODE, `Task node "${String(node.id)}": ${legacyPreInputPaths.join(', ')} is not allowed — synthesis memory scope is path-driven via inputsConfig and smartInput.paths only; template key is skill-catalog-only.`, { jobId: context?.jobId, graphId: context?.graphId, nodeId: String(node.id) });
+            throw new ExellixGraphError(ExellixGraphErrorCode.NON_CANONICAL_TASK_NODE, `Task node "${String(node.id)}": ${legacyPreInputPaths.join(', ')} is not allowed — use optional taskConfiguration.aiTaskProfile.inputSynthesis.sources for explicit PRE read scope; otherwise runtime applies the platform default trio (jobVariables, taskVariables, input). Template key is skill-catalog-only.`, { jobId: context?.jobId, graphId: context?.graphId, nodeId: String(node.id) });
         }
     }
     const narrixTc = tc && isPlainObject(tc.narrix) ? tc.narrix : undefined;
@@ -593,6 +594,24 @@ export function assertCanonicalTaskNode(node, context, options) {
             }
         }
     }
+    for (const path of collectSmartInputPaths(taskNode)) {
+        if (path === 'executionMemory.input' || path.startsWith('executionMemory.input.')) {
+            throw new ExellixGraphError(ExellixGraphErrorCode.NON_CANONICAL_TASK_NODE, `Task node "${String(node.id)}": smartInput.paths must not use executionMemory.input — use path "input" for invoke payload or omit smartInput on synthesis nodes (runtime PRE default reads apply).`, { jobId: context?.jobId, graphId: context?.graphId, nodeId: String(node.id) });
+        }
+    }
+    const synthesisSources = inputSynthesis?.sources;
+    if (Array.isArray(synthesisSources)) {
+        for (const entry of synthesisSources) {
+            const path = typeof entry === 'string'
+                ? entry.trim()
+                : isPlainObject(entry) && typeof entry.path === 'string'
+                    ? entry.path.trim()
+                    : '';
+            if (path === 'executionMemory.input' || path.startsWith('executionMemory.input.')) {
+                throw new ExellixGraphError(ExellixGraphErrorCode.NON_CANONICAL_TASK_NODE, `Task node "${String(node.id)}": inputSynthesis.sources must not use executionMemory.input — use path "input" for invoke payload.`, { jobId: context?.jobId, graphId: context?.graphId, nodeId: String(node.id) });
+            }
+        }
+    }
 }
 /**
  * Throws {@link ExellixGraphError} when the value is not a canonical graph document

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exellix/graph-engine",
-  "version": "8.2.0",
+  "version": "8.4.0",
   "type": "module",
   "description": "Graph executor SDK",
   "main": "dist/src/index.js",
@@ -52,27 +52,27 @@
     "access": "public"
   },
   "dependencies": {
-    "@exellix/ai-skills": "^6.11.0",
-    "@exellix/ai-tasks": "^10.0.3",
+    "@exellix/ai-skills": "^6.12.0",
+    "@exellix/ai-tasks": "^10.0.4",
     "@x12i/activix": "^8.6.3",
     "@x12i/catalox": "^5.9.7",
     "@x12i/env": "^4.0.1",
     "@x12i/funcx": "^4.9.13",
     "@x12i/graphenix": "^2.5.0",
-    "@x12i/graphenix-authoring-format": "^2.3.0",
-    "@x12i/graphenix-core": "^2.3.0",
-    "@x12i/graphenix-executable-contracts": "^2.3.0",
-    "@x12i/graphenix-executable-format": "^2.3.0",
-    "@x12i/graphenix-execute-envelope": "^2.3.0",
+    "@x12i/graphenix-authoring-format": "^2.5.0",
+    "@x12i/graphenix-core": "^2.5.0",
+    "@x12i/graphenix-executable-contracts": "^2.5.0",
+    "@x12i/graphenix-executable-format": "^2.5.0",
+    "@x12i/graphenix-execute-envelope": "^2.5.0",
     "@x12i/graphenix-format": "^2.0.0",
-    "@x12i/graphenix-plan-compiler": "^2.3.0",
-    "@x12i/graphenix-plan-format": "^2.3.0",
-    "@x12i/graphenix-task-node-format": "^2.3.0",
-    "@x12i/graphenix-trace-format": "^2.3.0",
+    "@x12i/graphenix-plan-compiler": "^2.5.0",
+    "@x12i/graphenix-plan-format": "^2.5.0",
+    "@x12i/graphenix-task-node-format": "^2.5.0",
+    "@x12i/graphenix-trace-format": "^2.5.0",
     "@x12i/logxer": "^4.6.0",
-    "@x12i/memorix-descriptors": "^1.6.0",
-    "@x12i/memorix-retrieval": "^1.11.2",
-    "@x12i/memorix-writer": "^1.0.0",
+    "@x12i/memorix-descriptors": "1.7.0",
+    "@x12i/memorix-retrieval": "1.12.0",
+    "@x12i/memorix-writer": "1.1.0",
     "@x12i/rendrix": "^4.3.0",
     "@x12i/runx": "^1.3.2"
   },