@exellix/graph-composer 2.12.0 → 2.14.0

package/CHANGELOG.md

@@ -111,7 +111,7 @@
 
 ### Fixed
 
-- Load `@exellix/ai-skills` analysis helpers via resolved file paths instead of non-exported package subpaths, so consumers importing `@exellix/graph-composer` or `@exellix/exellix-runtime` (e.g. `@exellix/exellix-jobs`) no longer fail at module load.
+- Load `@exellix/ai-skills` analysis helpers via resolved file paths instead of non-exported package subpaths, so consumers importing `@exellix/graph-composer` or `@x12i/exellix-runtime` (e.g. `@x12i/exellix-jobs`) no longer fail at module load.
 
 ## 2.5.0
 

package/README.md

@@ -1,9 +1,9 @@
-# @x12i/graph-composer
+# @exellix/graph-composer
 
 | | Location |
 |---|----------|
 | **GitHub (source)** | [`woroces/graph-composer`](https://github.com/woroces/graph-composer) — clone: `git@github.com:woroces/graph-composer.git` |
-| **npm (package)** | [`@x12i/graph-composer`](https://www.npmjs.com/package/@x12i/graph-composer) |
+| **npm (package)** | [`@exellix/graph-composer`](https://www.npmjs.com/package/@exellix/graph-composer) |
 
 The Git repo lives under the **woroces** org with repo name **graph-composer**. That is separate from the npm scope **@x12i**.
 
@@ -62,7 +62,7 @@ Copy [`.env.example`](./.env.example) to `.env` for local development. **Do not
 ## Quick start (direct worker)
 
 ```ts
-import { runGraphComposer } from "@x12i/graph-composer";
+import { runGraphComposer } from "@exellix/graph-composer";
 
 const result = await runGraphComposer(
   {
@@ -103,7 +103,7 @@ const result = await runGraphComposer(
 ### Orchestrator (toolbox)
 
 ```ts
-import { runGraphComposerAgent } from "@x12i/graph-composer";
+import { runGraphComposerAgent } from "@exellix/graph-composer";
 
 const out = await runGraphComposerAgent(
   {
@@ -162,7 +162,7 @@ Types: `GraphConceptPatch`, `GraphConceptPatchKey`, `PrimaryIntentType`. Helper:
 **Example using the bundled fixture helper:**
 
 ```ts
-import { runGraphComposer, inputSuggestConceptObjectiveNetworkVulnSubnet } from "@x12i/graph-composer";
+import { runGraphComposer, inputSuggestConceptObjectiveNetworkVulnSubnet } from "@exellix/graph-composer";
 
 const result = await runGraphComposer(inputSuggestConceptObjectiveNetworkVulnSubnet(), {
   askTimeoutMs: 120_000,
@@ -186,7 +186,7 @@ import {
   configureGraphComposerLogging,
   getGraphComposerLoggingConfig,
   runGraphComposer,
-} from "@x12i/graph-composer";
+} from "@exellix/graph-composer";
 
 // Process-wide (e.g. after reading your service config)
 configureGraphComposerLogging({ logsLevel: "info" });
@@ -205,7 +205,7 @@ Precedence per worker run: **`options.logsLevel`** → **`configureGraphComposer
 Use `generateGraphJsonInputExample` when a host has a graph-specific expected input JSON Schema and wants a realistic smoke-test payload. It wraps Funcx `generateJsonExample`, adding graph metadata such as `metadata.graphConcept.expectedInput` and core tasks to the guidance.
 
 ```ts
-import { generateGraphJsonInputExample } from "@x12i/graph-composer";
+import { generateGraphJsonInputExample } from "@exellix/graph-composer";
 
 const out = await generateGraphJsonInputExample({
   existingGraph: myGraphJson,
@@ -220,7 +220,7 @@ The package also re-exports Funcx `generateJsonExample`, `generateMdExample`, an
 
 ### Catalog resolution & creation (`suggestCatalogResolution`, `suggestCatalogCreations`)
 
-Both **require** `existingGraph`. Pass **`catalogCandidates`** (from **Catalox** via `loadCatalogCandidatesFromCatalox`, or fixtures): `aiSkills`, `utilitySkills`, `scopingMaps`, `narrixTemplates` — see [`docs/worox-graphs-catalogs.md`](./docs/worox-graphs-catalogs.md) and [`docs/catalog-metadb-end-state-contract.md`](./docs/catalog-metadb-end-state-contract.md) (**Catalox bridge + `catalogCandidates` as documented there: `@x12i/graph-composer` ≥ 1.6.0**).
+Both **require** `existingGraph`. Pass **`catalogCandidates`** (from **Catalox** via `loadCatalogCandidatesFromCatalox`, or fixtures): `aiSkills`, `utilitySkills`, `scopingMaps`, `narrixTemplates` — see [`docs/worox-graphs-catalogs.md`](./docs/worox-graphs-catalogs.md) and [`docs/catalog-metadb-end-state-contract.md`](./docs/catalog-metadb-end-state-contract.md) (**Catalox bridge + `catalogCandidates` as documented there: `@exellix/graph-composer` ≥ 1.6.0**).
 
 - **`suggestCatalogResolution`** — Per-node style recommendations: `skillResolution`, `scopingResolution`, `narrixResolution`, `gaps`. Optional **`matchLists`** pre-pass (skills / scoping / narrix) injects **`catalogMatchHints`** into the worker prompt when `catalogMatchListsAssist !== false` (default) and an OpenRouter **client** is available.
 - **`suggestCatalogCreations`** — `catalogRequestProposals` (+ optional `newSkillDescriptors`). Host applies approved rows via **Catalox** (or your store); this package emits JSON only.
@@ -228,7 +228,7 @@ Both **require** `existingGraph`. Pass **`catalogCandidates`** (from **Catalox**
 ### Scoping need match & scoping map creation
 
 - **`suggestScopingNeedMatch`** — **Does not** require `existingGraph` (optional context). **Requires** non-empty **`catalogCandidates.scopingMaps`**. Put the data need in **`intent.description`**. Output: **`hasSuitableMatch`**, **`recommended`** (`scopingMapId` / `questionId` when true, **`null` when false**), **`gaps`**, optional **`alternatives`**. Optional **`matchLists`** injects **`scopingNeedMatchHints`** (same client / `catalogMatchListsAssist` flag).
-- **`suggestScopingMapCreation`** — Plan a new scoping map: **`scopingMapProposal`** + non-empty **`catalogRequestProposals`**. Host persists approved artifacts; see **`WoroxScopingMapCatalogCreatePayload`** exported from **`@x12i/graph-composer`** (authored as `src/scopingCatalogHostTypes.ts` in this repo).
+- **`suggestScopingMapCreation`** — Plan a new scoping map: **`scopingMapProposal`** + non-empty **`catalogRequestProposals`**. Host persists approved artifacts; see **`WoroxScopingMapCatalogCreatePayload`** exported from **`@exellix/graph-composer`** (authored as `src/scopingCatalogHostTypes.ts` in this repo).
 
 ### `RunGraphComposerOptions` (workers)
 
@@ -266,8 +266,8 @@ Authoritative JSON shapes: [`functions/graph-composer/meta.json`](./functions/gr
 
 ```bash
 export OPENROUTER_API_KEY=sk-or-...
-npx @x12i/graph-composer explain-basic
-npx @x12i/graph-composer network-vuln
+npx @exellix/graph-composer explain-basic
+npx @exellix/graph-composer network-vuln
 ```
 
 Or use the binary name:
@@ -339,11 +339,7 @@ npm run typecheck
 npm test          # live tests; needs OPENROUTER_API_KEY in .env
 ```
 
-Optional: [nx-config2](https://www.npmjs.com/package/nx-config2) for scripts that load `.env`:
-
-```bash
-npx nx-config2 run --env-file .env -- npm test
-```
+Live tests and scripts load `.env` via `@x12i/env` (`x12i-env run --env-file .env -- …`); see `npm test` / `npm run test:live` scripts.
 
 **Maintainer smoke (suggest only, truncated JSON):** `npm run suggest-smoke` (repo only; uses `scripts/run-suggest-concept-smoke.ts`).
 
@@ -363,11 +359,11 @@ Published npm tarball still **does not** ship `docs/`; clone the repo or read th
 
 ## Publishing (maintainers)
 
-Scoped package `@x12i/graph-composer` uses `publishConfig.access: "public"`. Ensure your npm user is a member of the **x12i** org (or owns the scope) and has a valid token in `~/.npmrc` or project `.npmrc` (never commit tokens).
+Scoped package `@exellix/graph-composer` uses `publishConfig.access: "public"`. Ensure your npm user is a member of the **x12i** org (or owns the scope) and has a valid token in the **monorepo root** `.npmrc` (copy from `.npmrc.example`; never commit tokens). Publish via `npm run publish:all` from the repo root — do not run `npm publish` in this folder directly.
 
 ```bash
-npm run build
-npm publish
+# From monorepo root (uses root .npmrc for all packages)
+npm run publish:all -- --packages graph-composer
 ```
 
 Confirm tarball: `npm run pack:check` (must **not** list `docs/`, `.env`, or `test/`).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exellix/graph-composer",
-  "version": "2.12.0",
+  "version": "2.14.0",
   "publishConfig": {
     "access": "public"
   },
@@ -28,7 +28,6 @@
     ".env.example"
   ],
   "scripts": {
-    "postinstall": "node -e \"const fs=require('fs'),p=require('path');const s=p.join('node_modules','nx-config2','bin','nx-config2.js'),d=p.join('node_modules','@x12i','env','bin','nx-config2.js');try{if(fs.existsSync(s)&&!fs.existsSync(d))fs.copyFileSync(s,d);}catch(_){}\"",
     "build": "tsc -p tsconfig.build.json",
     "prepublishOnly": "npm run build",
     "start": "x12i-env run --env-file .env -- node dist/cli.js",
@@ -57,34 +56,18 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/woroces/graph-composer.git"
+    "url": "git+ssh://git@github.com/exellix/exellix-engine-mono-repo.git",
+    "directory": "graph-composer"
   },
   "bugs": {
     "url": "https://github.com/woroces/graph-composer/issues"
   },
   "homepage": "https://github.com/woroces/graph-composer#readme",
-  "overrides": {
-    "@x12i/graphenix-authoring-format": "^2.7.3",
-    "@x12i/graphenix-case-format": "^2.7.3",
-    "@x12i/graphenix-core": "^2.7.3",
-    "@x12i/graphenix-executable-contracts": "^2.7.3",
-    "@x12i/graphenix-executable-format": "^2.7.3",
-    "@x12i/graphenix-execute-envelope": "^2.7.3",
-    "@x12i/graphenix-format": "^2.0.0",
-    "@x12i/graphenix-plan-compiler": "^2.7.3",
-    "@x12i/graphenix-plan-format": "^2.7.3",
-    "@x12i/graphenix-task-node-format": "^2.7.3",
-    "@x12i/graphenix-trace-format": "^2.7.3"
-  },
   "peerDependencies": {
     "@exellix/ai-skills": "^6.12.5",
-    "@exellix/ai-tasks": "^10.0.13",
-    "@exellix/graph-engine": "^8.6.0"
+    "@exellix/ai-tasks": "^10.0.13"
   },
   "peerDependenciesMeta": {
-    "@exellix/graph-engine": {
-      "optional": true
-    },
     "@exellix/ai-tasks": {
       "optional": true
     },
@@ -93,18 +76,17 @@
     }
   },
   "dependencies": {
+    "@exellix/graph-engine": "^8.6.0",
     "@x12i/catalox": "^5.9.8",
-    "@x12i/env": "^4.0.1",
+    "@x12i/env": "^4.0.3",
     "@x12i/funcx": "^4.9.13",
     "@x12i/logxer": "^4.6.0"
   },
   "devDependencies": {
     "@exellix/ai-skills": "^6.12.5",
     "@exellix/ai-tasks": "^10.0.13",
-    "@exellix/graph-engine": "^8.6.0",
     "@types/node": "^22.10.2",
     "@x12i/rendrix": "^4.3.0",
-    "nx-config2": "^3.6.5",
     "tsx": "^4.19.2",
     "typescript": "^5.7.2"
   }