@exellix/ai-tasks 10.0.10 → 10.0.12

package/dist/web-scope/webContextMarkdown.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Serialize executionMemory.webContext (`@x12i/web-scoper` WebScopeResult / WebScopePackResult) into markdown.
+ */
+export type BuildWebContextEvidenceMarkdownOptions = {
+    maxTotalChars?: number;
+    /** @deprecated No longer affects excerpt selection — snippet is used. */
+    preferCleanContent?: boolean;
+    maxSources?: number;
+    dedupeByUrl?: boolean;
+};
+export declare function isWebContextEvidenceAvailable(webContextEntry: unknown): boolean;
+export declare function buildWebContextEvidenceMarkdown(webContextEntry: unknown, options?: BuildWebContextEvidenceMarkdownOptions): string;
+export declare function omitWebContextFromMemoryBundle(bundle: {
+    jobMemory?: Record<string, unknown>;
+    taskMemory?: Record<string, unknown>;
+    executionMemory?: Record<string, unknown>;
+}): {
+    jobMemory?: Record<string, unknown>;
+    taskMemory?: Record<string, unknown>;
+    executionMemory?: Record<string, unknown>;
+};
+//# sourceMappingURL=webContextMarkdown.d.ts.map

package/dist/web-scope/webContextMarkdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webContextMarkdown.d.ts","sourceRoot":"","sources":["../../src/web-scope/webContextMarkdown.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuEH,MAAM,MAAM,sCAAsC,GAAG;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,wBAAgB,6BAA6B,CAAC,eAAe,EAAE,OAAO,GAAG,OAAO,CAU/E;AAED,wBAAgB,+BAA+B,CAC7C,eAAe,EAAE,OAAO,EACxB,OAAO,CAAC,EAAE,sCAAsC,GAC/C,MAAM,CA0ER;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C,GAAG;IACF,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C,CAQA"}

package/dist/web-scope/webContextMarkdown.js

@@ -0,0 +1,163 @@
+/**
+ * Serialize executionMemory.webContext (`@x12i/web-scoper` WebScopeResult / WebScopePackResult) into markdown.
+ */
+import { isWebScopeSearchManyResult } from "./client.js";
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function nonEmptyString(v) {
+    if (typeof v !== "string")
+        return undefined;
+    const t = v.trim();
+    return t ? t : undefined;
+}
+function normalizeUrlKey(url) {
+    try {
+        const u = new URL(url.trim());
+        u.hash = "";
+        return u.href;
+    }
+    catch {
+        return url.trim().split("#")[0] ?? url.trim();
+    }
+}
+function pickSourceUrl(src) {
+    return nonEmptyString(src.url) ?? nonEmptyString(src.link);
+}
+function pickSourceBody(src) {
+    return nonEmptyString(src.snippet) ?? nonEmptyString(src.title);
+}
+function resolveWebContext(entry) {
+    if (!isRecord(entry))
+        return undefined;
+    if (entry.ok === true && isRecord(entry.context))
+        return entry.context;
+    if (isWebScopeSearchManyResult(entry)) {
+        if (isRecord(entry.pack?.primary))
+            return entry.pack.primary;
+        for (const scope of Object.values(entry.pack?.scopes ?? {})) {
+            if (isRecord(scope) && scope.ok === true && isRecord(scope.context)) {
+                return scope.context;
+            }
+        }
+    }
+    return undefined;
+}
+function formatFindings(findings) {
+    if (findings == null)
+        return undefined;
+    if (typeof findings === "string") {
+        const t = findings.trim();
+        return t ? `**Findings:**\n\n${t}` : undefined;
+    }
+    if (!Array.isArray(findings) || findings.length === 0)
+        return undefined;
+    const lines = ["**Findings:**", ""];
+    for (const f of findings) {
+        if (typeof f === "string" && f.trim())
+            lines.push(`- ${f.trim()}`);
+        else if (isRecord(f)) {
+            const claim = nonEmptyString(f.claim);
+            lines.push(`- ${claim ?? JSON.stringify(f)}`);
+        }
+    }
+    return lines.join("\n");
+}
+function parseMaxTotalCharsEnv() {
+    const raw = process.env.WEB_CONTEXT_MARKDOWN_MAX_CHARS;
+    if (!raw)
+        return undefined;
+    const n = parseInt(raw, 10);
+    return !Number.isNaN(n) && n > 0 ? n : undefined;
+}
+export function isWebContextEvidenceAvailable(webContextEntry) {
+    const ctx = resolveWebContext(webContextEntry);
+    if (!ctx)
+        return false;
+    const sources = Array.isArray(ctx.sources) ? ctx.sources : [];
+    const hasSourceMaterial = sources.some((s) => isRecord(s) && (pickSourceBody(s) || pickSourceUrl(s)));
+    const summary = nonEmptyString(ctx.summary);
+    const findingsBlock = formatFindings(ctx.findings);
+    return hasSourceMaterial || !!summary || !!findingsBlock;
+}
+export function buildWebContextEvidenceMarkdown(webContextEntry, options) {
+    const ctx = resolveWebContext(webContextEntry);
+    if (!ctx)
+        return "";
+    let sources = Array.isArray(ctx.sources) ? [...ctx.sources] : [];
+    const dedupeByUrl = options?.dedupeByUrl !== false;
+    const maxSources = options?.maxSources ?? 5;
+    if (dedupeByUrl && sources.length > 0) {
+        const seen = new Set();
+        const out = [];
+        for (const s of sources) {
+            if (!isRecord(s)) {
+                out.push(s);
+                continue;
+            }
+            const url = pickSourceUrl(s);
+            const key = url ? normalizeUrlKey(url) : `__nourl_${out.length}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            out.push(s);
+        }
+        sources = out;
+    }
+    if (maxSources > 0 && sources.length > maxSources) {
+        sources = sources.slice(0, maxSources);
+    }
+    const summary = nonEmptyString(ctx.summary);
+    const findingsBlock = formatFindings(ctx.findings);
+    const hasSourceMaterial = sources.some((s) => isRecord(s) && (pickSourceBody(s) || pickSourceUrl(s)));
+    if (!hasSourceMaterial && !summary && !findingsBlock)
+        return "";
+    const lines = [
+        "",
+        "## Web sources (primary evidence)",
+        "",
+        "Ground factual claims in the **source excerpts** below. **Summary** and **findings** (if present) are overview hints only—not authoritative on their own.",
+        "",
+    ];
+    if (summary || findingsBlock) {
+        lines.push("### Web overview (hints only)", "", "*Do not treat this subsection alone as sufficient evidence.*", "");
+        if (summary)
+            lines.push("**Summary:**", summary, "");
+        if (findingsBlock)
+            lines.push(findingsBlock, "");
+    }
+    lines.push("### Source excerpts (ground truth)", "");
+    for (let i = 0; i < sources.length; i++) {
+        const src = sources[i];
+        if (!isRecord(src))
+            continue;
+        const title = nonEmptyString(src.title) ?? nonEmptyString(src.name) ?? `Source ${i + 1}`;
+        const url = pickSourceUrl(src);
+        const body = pickSourceBody(src);
+        if (!body && !url)
+            continue;
+        lines.push(`#### ${title}`, "");
+        if (url)
+            lines.push(`- URL: ${url}`, "");
+        if (body)
+            lines.push(body, "");
+    }
+    let out = lines.join("\n");
+    const maxTotal = options?.maxTotalChars ?? parseMaxTotalCharsEnv();
+    if (maxTotal !== undefined && out.length > maxTotal) {
+        const marker = "\n\n[truncated — web source budget exceeded]";
+        const cut = Math.max(0, maxTotal - marker.length);
+        return out.slice(0, cut) + marker;
+    }
+    return out.endsWith("\n") ? out : `${out}\n`;
+}
+export function omitWebContextFromMemoryBundle(bundle) {
+    const ex = bundle.executionMemory;
+    if (!ex || typeof ex !== "object" || !("webContext" in ex)) {
+        return bundle;
+    }
+    const restExec = { ...ex };
+    delete restExec.webContext;
+    return { ...bundle, executionMemory: restExec };
+}
+//# sourceMappingURL=webContextMarkdown.js.map

package/dist/web-scope/webContextMarkdown.js.map

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

package/documenations/run-task-execution-flow.md

@@ -13,11 +13,7 @@ flowchart TD
     B -- Yes --> N1[Resolve raw record]
     N1 --> N2[Run Narrix pre-processor]
     N2 --> N3[Attach _narrix to executionMemory and jobMemory]
-    N3 --> N4{narrix.enableWebScope === true?}
-    N4 -- Yes --> N5[Run web scoper]
-    N5 --> N6[Set executionMemory.webContext]
-    N4 -- No --> B2
-    N6 --> B2
+    N3 --> B2
 
     B2 -- Yes --> H1[Resolve narrixInput]
     H1 --> H2[Run structured Narrix handler]
@@ -57,7 +53,7 @@ flowchart TD
    - Resolve the raw record from `executionMemory`, `jobMemory`, or `input`.
    - Run Narrix (ingest + runner).
    - Attach result to `executionMemory._narrix` (or configured field) and mirror to `jobMemory._narrix`.
-   - If `narrix.enableWebScope` is `true`, run web scoping and store result in `executionMemory.webContext`.
+   - NARRIX does **not** trigger web scoping. Web context comes from a standalone `webScope` PRE unit (see [web-scoping-in-ai-tasks.md](./web-scoping-in-ai-tasks.md)).
 4. Else if **`narrixMode === "handler"`**, run structured Narrix from `narrixInput` (same behavior as legacy `narrix-then-direct` Narrix phase), **before** local tasks and pipeline PRE.
 5. Check local task registry for `skillKey`.
 6. If local handler exists, execute it and return immediately (skip enrichment/LLM path).
@@ -77,7 +73,7 @@ flowchart TD
 
 - Default execution is effectively direct when no pipeline is provided.
 - Local tasks are deterministic and bypass LLM execution.
-- Web scoping is non-fatal: Narrix attachment can still succeed when web scope misses/fails.
+- Web scoping is a standalone `webScope` PRE unit (rendered `webQueryTemplate`); it is non-fatal at runtime and decoupled from NARRIX.
 - POST steps (`audit`, `polish`) run only when declared in `executionPipeline`.
 - For PRE `synthesized-context`, structured mode is additive and template-core-aware (`templateCores` + question), while markdown mode remains available for backward compatibility.
 - Structured core discovery is pre-render from raw instructions/prompt templates and expects core directives in `{{core:...}}` form.

package/documenations/web-scoping-in-ai-tasks.md

@@ -6,21 +6,20 @@ This document explains how web scoping is wired into ai-tasks, how requests opt
 
 ## 1. High-level overview
 
-- **Goal**: Retrieve **external web context** for a natural-language question (optionally enriched with record facts) and expose it on `executionMemory.webContext`.
+- **Goal**: Retrieve **external web context** for a search query (optionally enriched with record facts) and expose it on `executionMemory.webContext`.
 - **Package**: [`@x12i/web-scoper`](https://www.npmjs.com/package/@x12i/web-scoper) — planning, Tavily search via `@x12i/search-adapter`, normalized `WebContext`.
-- **Adapter layer**: `src/web-scope/` compiles graph/task fields into `{ question, record?, options? }` or a multi-question pack. No Graphenix, Activix, or NARRIX CNI fields are sent to the scoper.
-- **Triggers**:
-  - **`RunTaskRequest.narrix.enableWebScope === true`** — after a successful NARRIX preprocessor run.
-  - **Standalone PRE unit** — `externalPreUtility` with `strategyKey: "webScope"` (Graphenix node plans, ai-tasks playground).
+- **Adapter layer**: `src/web-scope/` renders the unit's `webQueryTemplate` into `{ question, record?, options? }` (or a pack), then calls the scoper. No Graphenix, Activix, or NARRIX CNI fields are sent.
+- **Trigger** (single, explicit): an `externalPreUtility` execution unit with **`strategyKey: "webScope"`**. There is **no** NARRIX trigger and **no** implicit question fallback.
+- **Search query**: the **rendered `unitParams.webQueryTemplate`** (a Rendrix string, e.g. `"How to solve {{input.vulnerability}}?"`). The template is **required** when the unit is enabled.
 - **Result**:
 
   ```ts
   ctx.executionMemory.webContext: WebScopeResult | WebScopePackResult
   ```
 
-  Always set when web scoping is enabled for that hop, including miss/error shapes (`ok: false`).
+  Always set when the unit runs, including miss/error shapes (`ok: false`).
 
-- **Failure stance**: **Lenient.** Web scoping failures do not abort NARRIX or MAIN execution.
+- **Failure stance**: **Lenient at runtime** (web scoping failures do not abort MAIN execution), but **loud and early at validation**: a missing/unresolvable `webQueryTemplate` is a config error.
 
 ---
 
@@ -57,35 +56,39 @@ await scoper.searchMany({
 
 ## 3. How ai-tasks compiles the payload
 
-Implementation: **`src/web-scope/buildSearchInput.ts`**, **`src/web-scope/applyWebScopeToRequest.ts`**, **`src/web-scope/client.ts`**.
+Implementation: **`src/web-scope/buildSearchInput.ts`**, **`src/web-scope/renderWebQueryTemplate.ts`**, **`src/web-scope/applyWebScopeToRequest.ts`**, **`src/web-scope/client.ts`**.
 
-### 3.1. Question resolution order
+### 3.1. Query resolution — rendered template only
 
-1. `RunTaskRequest.input.question` or string `input`
-2. `nodePlan.invokeContract.taskVariable.question`
-3. `executionMemory.taskVariables.question`
+The search query is the **rendered `unitParams.webQueryTemplate`**. There is **no** fallback to `input.question`, `taskVariable.question`, or `executionMemory.taskVariables.question`.
+
+1. `webScopeInvokeConfigFromUnitParams(unitParams)` reads `webQueryTemplate` (single) and/or `webQueryTemplates` (pack).
+2. `renderWebQueryTemplate(template, request)` renders it with `@x12i/rendrix` `render()` against `buildTemplateContext(request)` — the same roots used by validation (`input`, `jobVariables`, `taskVariables`, `executionMemory`, …).
+3. An empty render (e.g. a template that is only an unresolved token) yields no query → `{ ok: false, error: { reason: "no_queries" } }`.
 
 ### 3.2. Record resolution
 
 Merged from (when present):
 
-- `input.record` or non-question fields on object `input`
+- `input.record` or fields on object `input`
 - `executionMemory.input` / `executionMemory.input.raw`
-- CNI `knownFacts` (when NARRIX ran first and CNI is passed into the web-scope hop)
+- CNI `knownFacts` (when facts are passed into the web-scope hop)
+
+The record carries **facts only** — the query comes from the template, which references those facts via `{{input.*}}`.
 
-### 3.3. Options / legacy graphenix fields
+### 3.3. Options
 
 | Source | Maps to |
 |--------|---------|
-| `unitParams.options` | `WebScopeOptions` (preferred) |
-| `unitParams.webScopeOptions` | same |
-| `narrix.webScopeOptions` | same |
-| `narrix.webScoping` / `unitParams.webScoping` | `mapLegacyWebScopingToOptions()` — `maxQueries`, `freshnessDays`, domain filters, **`webScopeTemplates` → `options.queryTemplates`**, etc. |
-| `narrix.webScopeQuestions` / `unitParams.webScopeQuestions` / `unitParams.questions` | `searchMany` pack |
+| `unitParams.options` | `WebScopeOptions` (`maxQueries`, `freshnessDays`, domain filters, `queryTemplates`, …) |
+
+There are no legacy `webScoping` / `webScopeOptions` / `webScopeQuestions` mappings and no NARRIX option sources.
+
+### 3.4. Pack mode
 
-When a non-empty question list is configured, ai-tasks calls **`searchMany`**; otherwise **`search`** with a single `question`. If neither a question nor pack questions are available, web scoping stores `{ ok: false, error: { reason: "no_queries", … } }`.
+When `unitParams.webQueryTemplates` is a non-empty `string[]`, each template is rendered independently (`renderWebQueryTemplates`) into a `searchMany` question pack (UUID ids assigned per question). Otherwise a single `search` runs with the rendered `webQueryTemplate`.
 
-### 3.4. Standalone PRE web-scope unit
+### 3.5. The web-scope unit
 
 Graphenix / playground unit:
 
@@ -95,34 +98,28 @@ Graphenix / playground unit:
   "strategyKey": "webScope",
   "unitParams": {
     "enableWebScope": true,
+    "webQueryTemplate": "How to solve {{input.vulnerability}}?",
     "options": { "maxQueries": 3 }
   }
 }
 ```
 
-Playground input:
+Playground input (record/facts only — referenced by the template):
 
 ```json
 {
-  "question": "What is the patch status for CVE-2021-44228?",
-  "record": { "cveId": "CVE-2021-44228", "vendor": "apache" }
+  "vulnerability": "CVE-2021-44228",
+  "vendor": "apache"
 }
 ```
 
----
-
-## 4. NARRIX + web scope
-
-When **`narrix.enableWebScope === true`**, the NARRIX preprocessor runs first; on success, ai-tasks calls the same web-scope adapter with optional CNI facts merged into `record`.
+`enableWebScope` (default `true`) is the on/off switch. When `false`, the unit is a no-op.
 
-Optional **`RunTaskRequest.narrix`** fields (backward compatible):
+---
 
-- **`webScopeQuestions`** — explicit pack (see §3.3)
-- **`webScopeOptions`** — preferred options object
-- **`webScoping`**, **`webScopeTemplates`**, **`webScopeQuestionTemplate`**, **`webScopeObjects`** — legacy; mapped at invoke time where supported
-- **`skipWebScopeWhenExternalWebMarkdownPresent`** — skip when `executionMemory.webContextMarkdown` is already non-empty
+## 4. NARRIX (no longer triggers web scope)
 
-NARRIX attachment (`executionMemory._narrix` or `attachToField`) is independent of web scoping.
+Web scoping is **fully decoupled from NARRIX**. The NARRIX preprocessor/handler still builds its CNI attachment (`executionMemory._narrix` or `attachToField`), but it does **not** trigger or configure web search. To web-scope after NARRIX, add an explicit `webScope` unit to the node plan with its own `webQueryTemplate`.
 
 ---
 
@@ -145,15 +142,14 @@ if (web && "ok" in web && web.ok === true && web.context) {
 }
 ```
 
-For **`includeContextInPrompt`** / synthesis PRE, ai-tasks builds **Web sources (primary evidence)** markdown when `ok === true`, preferring source `snippet` / `title`. Raw `webContext` JSON is omitted from synthesized memory slices when markdown is included (see `resolveSourceMaterial` tests).
-
-Legacy **`available`** field from `@exellix/narrix-web-scoper` is **not** used; check **`ok`**.
+For **`includeContextInPrompt`** / synthesis PRE, ai-tasks builds **Web sources (primary evidence)** markdown when `ok === true`, preferring source `snippet` / `title`. Raw `webContext` JSON is omitted from synthesized memory slices when markdown is included (see `resolveSourceMaterial` tests). Always check **`ok`** on `WebScopeResult` / `WebScopePackResult`.
 
 ---
 
 ## 7. Testing
 
-- **`test/narrix/webScoper.test.ts`** — payload compilation, client error handling, `applyWebScopeToRequest`
+- **`test/web-scope/buildSearchInput.test.ts`** — template rendering, payload compilation, client error handling, `applyWebScopeToRequest`
+- **`test/validation/validateWebScopeUnit.test.ts`** — required `webQueryTemplate` and token resolution checks
 - **`test/narrix/webContextMarkdown.test.ts`** — markdown from `{ ok, context }`
 - **`test/synthesis/resolveSourceMaterial.test.ts`** — web evidence in source material
 - **`test/utils/collectEvidence.test.ts`** — local handler uses web scoper for query discovery
@@ -161,20 +157,7 @@ Legacy **`available`** field from `@exellix/narrix-web-scoper` is **not** used;
 Run targeted tests:
 
 ```bash
-cd ai-tasks && npm run build && npx tsc -p tsconfig.test.json && node --test dist-test/test/narrix/webScoper.test.js dist-test/test/narrix/webContextMarkdown.test.js
+cd ai-tasks && npm run build && npx tsc -p tsconfig.test.json && node --test dist-test/test/web-scope/buildSearchInput.test.js dist-test/test/validation/validateWebScopeUnit.test.js
 ```
 
 Live Tavily: **`npm run test:e2e:webScope`** (requires `TAVILY_API_KEY`).
-
----
-
-## 8. Migration from `@exellix/narrix-web-scoper`
-
-| Before (narrix-web-scoper) | After (`@x12i/web-scoper`) |
-|----------------------------|----------------------------|
-| `ScopeInput` with `datasetId`, `entity`, `cni` | `{ question, record?, options? }` only |
-| `WebScoperResult.available` | `WebScopeResult.ok` |
-| `runWebScope()` / `scopeQuestionPack()` | `search()` / `searchMany()` |
-| `src/narrix/webScoper.ts` | `src/web-scope/` |
-
-Graph/node authoring should pass **question + record** at the ai-tasks boundary; NARRIX/CNI enrichment stays in the adapter.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exellix/ai-tasks",
-  "version": "10.0.10",
+  "version": "10.0.12",
   "description": "Task orchestration for the Exellix stack: runTask() with local handlers or LLM-backed execution, task-scoped memory/context enrichment, and executor dispatch via @exellix/ai-skills. ERC-compliant.",
   "type": "module",
   "main": "dist/index.js",
@@ -21,21 +21,14 @@
   "scripts": {
     "build": "tsc",
     "dev": "ts-node src/index.ts",
-    "prepublishOnly": "npm run build && node scripts/ensure-nx-content-md-variants.mjs",
+    "prepublishOnly": "node scripts/assert-publishable-deps.mjs && npm run build && node scripts/ensure-nx-content-md-variants.mjs",
     "deps:latest": "npx npm-check-updates -u && npm install",
-    "test": "node scripts/ensure-xynthesis-dist.mjs && node scripts/ensure-ai-skills-dist.mjs && node scripts/clean-dist-test.mjs && tsc -p tsconfig.test.json && node scripts/copy-test-fixtures.mjs && node --test --test-force-exit --test-concurrency=1 dist-test/test/node-execution/**/*.js dist-test/test/narrix/*.js dist-test/test/narrix-then-execute/*.js dist-test/test/aiScoping/*.js dist-test/test/intermediateSteps/*.js dist-test/test/post-steps/**/*.js dist-test/test/planWebScopeQuestions/*.js dist-test/test/synthesis/*.js dist-test/test/fact-guard/*.js dist-test/test/utils/*.js dist-test/test/errors/*.js dist-test/test/validation/*.js dist-test/test/task-strategies/*.js dist-test/test/observability/*.js dist-test/test/run-task/*.js dist-test/test/internal/*.js dist-test/test/execution-strategies/*.js dist-test/test/invocation/*.js dist-test/test/e2e/*.js",
-    "test:with-narrix-ingest": "node scripts/run-npm-test-with-narrix-ingest.mjs",
+    "test": "node scripts/ensure-xynthesis-dist.mjs && node scripts/ensure-ai-skills-dist.mjs && node scripts/clean-dist-test.mjs && tsc -p tsconfig.test.json && node scripts/copy-test-fixtures.mjs && node --test --test-force-exit --test-concurrency=1 dist-test/test/node-execution/**/*.js dist-test/test/aiScoping/*.js dist-test/test/intermediateSteps/*.js dist-test/test/post-steps/**/*.js dist-test/test/planWebScopeQuestions/*.js dist-test/test/synthesis/*.js dist-test/test/fact-guard/*.js dist-test/test/utils/*.js dist-test/test/errors/*.js dist-test/test/validation/*.js dist-test/test/web-scope/*.js dist-test/test/task-strategies/*.js dist-test/test/observability/*.js dist-test/test/run-task/*.js dist-test/test/internal/*.js dist-test/test/execution-strategies/*.js dist-test/test/invocation/*.js dist-test/test/e2e/*.js",
     "test:e2e:intermediateSteps": "node scripts/run-with-env.mjs RUN_INTERMEDIATE_STEPS_E2E=1 npm run test",
     "test:e2e:synthesis": "node scripts/run-synthesis-e2e.mjs",
     "test:e2e:webScope": "node scripts/run-web-scope-e2e.mjs",
     "test:fact-guard": "node scripts/ensure-xynthesis-dist.mjs && node scripts/clean-dist-test.mjs && tsc -p tsconfig.test.json && node --test --test-force-exit dist-test/test/fact-guard/*.js dist-test/test/post-steps/runPostStepLlmCall.factGuard.test.js",
     "test:live": "node scripts/run-live-ai-e2e.mjs",
-    "test:narrix:live": "node scripts/check-narrix-archive.mjs && node scripts/run-npm-test-with-narrix-ingest.mjs",
-    "local:narrix:subnets": "node dist/localTasks/narrixSubnetPlayground.js",
-    "local:narrix:assets": "node dist/localTasks/narrixAssetPlayground.js",
-    "local:narrix:vuln-groups": "node dist/localTasks/narrixVulnGroupPlayground.js",
-    "local:narrix:vuln-instances": "node dist/localTasks/narrixVulnInstancePlayground.js",
-    "local:narrix:all": "npm run local:narrix:subnets && npm run local:narrix:assets && npm run local:narrix:vuln-groups && npm run local:narrix:vuln-instances",
     "publish:task-strategies": "tsx scripts/publish-ai-task-strategies-catalog.ts"
   },
   "keywords": [
@@ -65,32 +58,22 @@
     "@x12i/catalox-contracts": "^5.9.7"
   },
   "dependencies": {
-    "@exellix/ai-skills": "^6.12.3",
-    "@exellix/fact-guard-adapters": "file:../fact-guard/packages/adapters",
-    "@exellix/fact-guard-enrichment": "file:../fact-guard/packages/enrichment",
-    "@exellix/fact-guard-policies": "file:../fact-guard/packages/policies",
-    "@exellix/fact-guard-types": "file:../fact-guard/packages/types",
-    "@exellix/fact-guard-validation": "file:../fact-guard/packages/validation",
-    "@exellix/memorix-narrix-adapter": "^2.0.0",
-    "@exellix/narrix-adapter-chat": "^2.0.0",
-    "@exellix/narrix-adapter-docs": "^2.0.0",
-    "@exellix/narrix-adapter-records": "^2.0.0",
-    "@exellix/narrix-adapter-text": "^2.0.0",
-    "@exellix/narrix-adapters-core": "^2.0.0",
-    "@exellix/narrix-catalox": "^2.0.0",
-    "@exellix/narrix-cni": "^2.0.0",
-    "@exellix/narrix-ingest": "^2.0.0",
-    "@exellix/narrix-runner": "^2.0.0",
+    "@exellix/ai-skills": "^6.12.4",
+    "@exellix/fact-guard-adapters": "^1.0.1",
+    "@exellix/fact-guard-enrichment": "^1.0.1",
+    "@exellix/fact-guard-policies": "^1.0.1",
+    "@exellix/fact-guard-types": "^1.0.1",
+    "@exellix/fact-guard-validation": "^1.0.1",
     "@exellix/xynthesis": "^4.8.4",
     "@x12i/activix": "^8.6.3",
     "@x12i/ai-profiles": "^3.4.0",
     "@x12i/catalox": "^5.9.7",
     "@x12i/execution-memory-manager": "^1.2.0",
     "@x12i/funcx": "^4.9.13",
-    "@x12i/graphenix-core": "^2.7.0",
-    "@x12i/graphenix-executable-contracts": "^2.7.0",
-    "@x12i/graphenix-plan-format": "^2.7.0",
-    "@x12i/graphenix-trace-format": "^2.7.0",
+    "@x12i/graphenix-core": "^2.7.3",
+    "@x12i/graphenix-executable-contracts": "^2.7.3",
+    "@x12i/graphenix-plan-format": "^2.7.3",
+    "@x12i/graphenix-trace-format": "^2.7.3",
     "@x12i/logxer": "^4.6.0",
     "@x12i/optimixer": "^3.5.2",
     "@x12i/rendrix": "^4.3.0",
@@ -102,9 +85,9 @@
   "devDependencies": {
     "@types/node": "^18.0.0 || ^20.0.0",
     "@x12i/catalox-contracts": "^5.9.7",
-    "@x12i/graphenix-authoring-format": "^2.7.0",
-    "@x12i/graphenix-plan-compiler": "^2.7.0",
-    "@x12i/graphenix-task-node-format": "^2.7.0",
+    "@x12i/graphenix-authoring-format": "^2.7.3",
+    "@x12i/graphenix-plan-compiler": "^2.7.3",
+    "@x12i/graphenix-task-node-format": "^2.7.3",
     "dotenv": "^16.0.0",
     "ts-node": "^10.9.0",
     "tsx": "^4.0.0",

package/dist/narrix/applyWebScopeToRequest.d.ts

@@ -1,9 +0,0 @@
-import type { NarrixPreProcessorConfig, RunTaskRequest } from "../types/task-types.js";
-import type { NarrixRunOutputSuccess } from "./types.js";
-/**
- * Run web scoping and merge `executionMemory.webContext` (lenient — always sets webContext when enabled).
- */
-export declare function applyWebScopeToRequest(request: RunTaskRequest, narrix: NarrixPreProcessorConfig, narrixSuccess?: NarrixRunOutputSuccess): Promise<RunTaskRequest>;
-/** Standalone Layer-1 web-scope unit (no Narrix preprocessor required). */
-export declare function applyStandaloneWebScopeUnit(request: RunTaskRequest, unitParams?: Record<string, unknown>): Promise<RunTaskRequest>;
-//# sourceMappingURL=applyWebScopeToRequest.d.ts.map

package/dist/narrix/applyWebScopeToRequest.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"applyWebScopeToRequest.d.ts","sourceRoot":"","sources":["../../src/narrix/applyWebScopeToRequest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAMvF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AA0FzD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,wBAAwB,EAChC,aAAa,CAAC,EAAE,sBAAsB,GACrC,OAAO,CAAC,cAAc,CAAC,CA4CzB;AAED,2EAA2E;AAC3E,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,cAAc,EACvB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,OAAO,CAAC,cAAc,CAAC,CAiCzB"}