@exellix/ai-tasks 7.8.0

package/dist/localTasks/index.js

@@ -0,0 +1,19 @@
+export { registerLocalTask, getLocalTask } from "./registry.js";
+import { registerLocalTask } from "./registry.js";
+import { nodeCallExportHandler } from "./nodeCallExport.js";
+import { nodeCallExportBatchHandler } from "./nodeCallExportBatch.js";
+import { validateInputHandler } from "./validateInput.js";
+import { normalizeNarrixResultHandler } from "./normalizeNarrixResult.js";
+import { collectEvidenceHandler } from "./collectEvidence.js";
+import { decideWebScopeHandler } from "./decideWebScope.js";
+import "../narrix/index.js"; // registers skills/skill.local:narrixRun
+// Batch playgrounds: local:narrix:subnets | assets | vuln-groups | vuln-instances | all
+export function registerBuiltInLocalTasks() {
+    registerLocalTask("skills/node.callExport", nodeCallExportHandler);
+    registerLocalTask("skills/node.callExportBatch", nodeCallExportBatchHandler);
+    registerLocalTask("skills/skill.local:validateInput", validateInputHandler);
+    registerLocalTask("skills/skill.local:normalizeNarrixResult", normalizeNarrixResultHandler);
+    registerLocalTask("skills/graph.collectEvidence", collectEvidenceHandler);
+    registerLocalTask("skills/graph.decide-web-scope", decideWebScopeHandler);
+}
+//# sourceMappingURL=index.js.map

package/dist/localTasks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/localTasks/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,oBAAoB,CAAC,CAAC,yCAAyC;AAEtE,wFAAwF;AAExF,MAAM,UAAU,yBAAyB;IACvC,iBAAiB,CAAC,wBAAwB,EAAE,qBAAqB,CAAC,CAAC;IACnE,iBAAiB,CAAC,6BAA6B,EAAE,0BAA0B,CAAC,CAAC;IAC7E,iBAAiB,CAAC,kCAAkC,EAAE,oBAAoB,CAAC,CAAC;IAC5E,iBAAiB,CAAC,0CAA0C,EAAE,4BAA4B,CAAC,CAAC;IAC5F,iBAAiB,CAAC,8BAA8B,EAAE,sBAAsB,CAAC,CAAC;IAC1E,iBAAiB,CAAC,+BAA+B,EAAE,qBAAqB,CAAC,CAAC;AAC5E,CAAC"}

package/dist/localTasks/narrixAssetPlayground.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Playground/batch test: run narrix record handler on all asset test-data JSON files,
+ * write one output JSON per input plus _summary.json.
+ *
+ * Env (optional):
+ *   NARRIX_PLAYGROUND_IN   default .tests/test-data
+ *   NARRIX_PLAYGROUND_OUT  default .tests/test-output/assets
+ *   NARRIX_DATASET_ID      default assetEgress
+ *
+ * Run: npm run local:narrix:assets (after npm run build)
+ */
+export {};
+//# sourceMappingURL=narrixAssetPlayground.d.ts.map

package/dist/localTasks/narrixAssetPlayground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrixAssetPlayground.d.ts","sourceRoot":"","sources":["../../src/localTasks/narrixAssetPlayground.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/localTasks/narrixAssetPlayground.js

@@ -0,0 +1,161 @@
+/**
+ * Playground/batch test: run narrix record handler on all asset test-data JSON files,
+ * write one output JSON per input plus _summary.json.
+ *
+ * Env (optional):
+ *   NARRIX_PLAYGROUND_IN   default .tests/test-data
+ *   NARRIX_PLAYGROUND_OUT  default .tests/test-output/assets
+ *   NARRIX_DATASET_ID      default assetEgress
+ *
+ * Run: npm run local:narrix:assets (after npm run build)
+ */
+import { readdir, readFile, mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { narrixRunHandler } from "../narrix/task.js";
+const DATASET_ID = process.env.NARRIX_DATASET_ID ?? "assetEgress";
+const PLAYGROUND_IN = process.env.NARRIX_PLAYGROUND_IN ?? ".tests/test-data";
+const PLAYGROUND_OUT = process.env.NARRIX_PLAYGROUND_OUT ?? ".tests/test-output/assets";
+/** Match: assets-information_tplg.*.json or any assets-*.json */
+function isAssetInputFile(name) {
+    if (!name.endsWith(".json"))
+        return false;
+    return name.startsWith("assets-information_tplg.") || name.startsWith("assets-");
+}
+function deriveFromResult(result) {
+    if (!result.ok) {
+        return {
+            signalCodes: [],
+            narrativeTypeIds: [],
+            ok: false,
+            error: result.error ?? null,
+        };
+    }
+    const signals = result.signals ?? [];
+    const stories = result.stories ?? [];
+    return {
+        signalCodes: signals.map((s) => s.code ?? "").filter(Boolean),
+        narrativeTypeIds: stories.map((s) => s.narrativeTypeId ?? "").filter(Boolean),
+        ok: true,
+        error: null,
+    };
+}
+function getProjectRoot() {
+    const dir = path.dirname(fileURLToPath(import.meta.url));
+    if (dir.endsWith("localTasks"))
+        return path.resolve(dir, "../..");
+    return path.resolve(dir, "../..");
+}
+const ctx = {
+    skillKey: "skills/skill.local:narrixRun",
+};
+async function main() {
+    const root = getProjectRoot();
+    const inDir = path.resolve(root, PLAYGROUND_IN);
+    const outDir = path.resolve(root, PLAYGROUND_OUT);
+    let entries;
+    try {
+        entries = (await readdir(inDir, { withFileTypes: true }));
+    }
+    catch (err) {
+        const e = err;
+        console.error("Playground input dir not found or not readable:", inDir, e.message);
+        process.exit(1);
+    }
+    const files = entries
+        .filter((e) => e.isFile() && isAssetInputFile(e.name))
+        .map((e) => e.name)
+        .sort();
+    if (files.length === 0) {
+        console.log("No asset input files found in", inDir);
+        await mkdir(outDir, { recursive: true });
+        const summary = {
+            datasetId: DATASET_ID,
+            runCount: 0,
+            okCount: 0,
+            failCount: 0,
+            byFile: [],
+        };
+        await writeFile(path.join(outDir, "_summary.json"), JSON.stringify(summary, null, 2), "utf8");
+        console.log("Wrote _summary.json (0 runs).");
+        return;
+    }
+    console.log("Running", files.length, "asset file(s)…");
+    await mkdir(outDir, { recursive: true });
+    const byFile = [];
+    let okCount = 0;
+    let failCount = 0;
+    for (const filename of files) {
+        const fullPath = path.join(inDir, filename);
+        const startedAt = new Date().toISOString();
+        let result;
+        try {
+            const raw = await readFile(fullPath, "utf8");
+            const parsed = JSON.parse(raw);
+            const record = Array.isArray(parsed) && parsed.length > 0
+                ? parsed[0]
+                : parsed;
+            try {
+                result = (await narrixRunHandler({
+                    input: { medium: "record", datasetId: DATASET_ID, record },
+                    ctx,
+                }));
+            }
+            catch (err) {
+                const e = err;
+                result = {
+                    ok: false,
+                    error: "PLAYGROUND_EXCEPTION",
+                    message: e.message ?? "narrix run threw",
+                };
+            }
+        }
+        catch (err) {
+            const e = err;
+            result = {
+                ok: false,
+                error: "PLAYGROUND_EXCEPTION",
+                message: `Failed to read/parse input: ${e.message}`,
+            };
+        }
+        const finishedAt = new Date().toISOString();
+        const durationMs = new Date(finishedAt).getTime() - new Date(startedAt).getTime();
+        const derived = deriveFromResult(result);
+        if (derived.ok)
+            okCount++;
+        else
+            failCount++;
+        byFile.push({
+            filename,
+            ok: derived.ok,
+            signalCount: derived.signalCodes.length,
+            storyCount: derived.narrativeTypeIds.length,
+            signalCodes: derived.signalCodes,
+            narrativeTypeIds: derived.narrativeTypeIds,
+            error: derived.error,
+        });
+        const outDoc = {
+            input: { filename, fullPath, datasetId: DATASET_ID },
+            result,
+            derived,
+            timestamps: { startedAt, finishedAt, durationMs },
+        };
+        const outBasename = filename.replace(/\.json$/i, "") + ".out.json";
+        await writeFile(path.join(outDir, outBasename), JSON.stringify(outDoc, null, 2), "utf8");
+        console.log(derived.ok ? "ok" : "fail", filename, "signals:", derived.signalCodes.length, "stories:", derived.narrativeTypeIds.length, derived.error ?? "");
+    }
+    const summary = {
+        datasetId: DATASET_ID,
+        runCount: files.length,
+        okCount,
+        failCount,
+        byFile,
+    };
+    await writeFile(path.join(outDir, "_summary.json"), JSON.stringify(summary, null, 2), "utf8");
+    console.log("Finished. ok:", okCount, "fail:", failCount, "→", path.join(outDir, "_summary.json"));
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=narrixAssetPlayground.js.map

package/dist/localTasks/narrixAssetPlayground.js.map

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

package/dist/localTasks/narrixSubnetPlayground.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Playground/batch test: run narrix record handler on all subnet test-data JSON files,
+ * write one output JSON per input plus _summary.json.
+ *
+ * Env (optional):
+ *   NARRIX_PLAYGROUND_IN   default .tests/test-data
+ *   NARRIX_PLAYGROUND_OUT  default .tests/test-output/subnets
+ *   NARRIX_DATASET_ID      default subnetEgress
+ *   NARRIX_DEBUG=1         already supported by handler
+ *
+ * Run: npm run local:narrix:subnets (after npm run build)
+ */
+export {};
+//# sourceMappingURL=narrixSubnetPlayground.d.ts.map

package/dist/localTasks/narrixSubnetPlayground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrixSubnetPlayground.d.ts","sourceRoot":"","sources":["../../src/localTasks/narrixSubnetPlayground.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/localTasks/narrixSubnetPlayground.js

@@ -0,0 +1,168 @@
+/**
+ * Playground/batch test: run narrix record handler on all subnet test-data JSON files,
+ * write one output JSON per input plus _summary.json.
+ *
+ * Env (optional):
+ *   NARRIX_PLAYGROUND_IN   default .tests/test-data
+ *   NARRIX_PLAYGROUND_OUT  default .tests/test-output/subnets
+ *   NARRIX_DATASET_ID      default subnetEgress
+ *   NARRIX_DEBUG=1         already supported by handler
+ *
+ * Run: npm run local:narrix:subnets (after npm run build)
+ */
+import { readdir, readFile, mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { narrixRunHandler } from "../narrix/task.js";
+const DATASET_ID = process.env.NARRIX_DATASET_ID ?? "subnetEgress";
+const PLAYGROUND_IN = process.env.NARRIX_PLAYGROUND_IN ?? ".tests/test-data";
+const PLAYGROUND_OUT = process.env.NARRIX_PLAYGROUND_OUT ?? ".tests/test-output/subnets";
+/** Match: subnets-information_tplg.*.json or any subnets-*.json */
+function isSubnetInputFile(name) {
+    if (!name.endsWith(".json"))
+        return false;
+    return name.startsWith("subnets-information_tplg.") || name.startsWith("subnets-");
+}
+function deriveFromResult(result) {
+    if (!result.ok) {
+        return {
+            signalCodes: [],
+            narrativeTypeIds: [],
+            ok: false,
+            error: result.error ?? null,
+        };
+    }
+    const signals = result.signals ?? [];
+    const stories = result.stories ?? [];
+    return {
+        signalCodes: signals.map((s) => s.code ?? "").filter(Boolean),
+        narrativeTypeIds: stories.map((s) => s.narrativeTypeId ?? "").filter(Boolean),
+        ok: true,
+        error: null,
+    };
+}
+function getProjectRoot() {
+    const dir = path.dirname(fileURLToPath(import.meta.url));
+    // From dist/localTasks or src/localTasks go up to project root
+    if (dir.endsWith("localTasks"))
+        return path.resolve(dir, "../..");
+    return path.resolve(dir, "../..");
+}
+const ctx = {
+    skillKey: "skills/skill.local:narrixRun",
+};
+async function main() {
+    const root = getProjectRoot();
+    const inDir = path.resolve(root, PLAYGROUND_IN);
+    const outDir = path.resolve(root, PLAYGROUND_OUT);
+    let entries;
+    try {
+        entries = await readdir(inDir, { withFileTypes: true });
+    }
+    catch (err) {
+        const e = err;
+        console.error("Playground input dir not found or not readable:", inDir, e.message);
+        process.exit(1);
+    }
+    const files = entries
+        .filter((e) => e.isFile() && isSubnetInputFile(e.name))
+        .map((e) => e.name)
+        .sort();
+    if (files.length === 0) {
+        console.log("No subnet input files found in", inDir);
+        await mkdir(outDir, { recursive: true });
+        const summary = {
+            datasetId: DATASET_ID,
+            runCount: 0,
+            okCount: 0,
+            failCount: 0,
+            byFile: [],
+        };
+        await writeFile(path.join(outDir, "_summary.json"), JSON.stringify(summary, null, 2), "utf8");
+        console.log("Wrote _summary.json (0 runs).");
+        return;
+    }
+    console.log("Running", files.length, "subnet file(s)…");
+    await mkdir(outDir, { recursive: true });
+    const byFile = [];
+    let okCount = 0;
+    let failCount = 0;
+    for (const filename of files) {
+        const fullPath = path.join(inDir, filename);
+        const startedAt = new Date().toISOString();
+        let result;
+        try {
+            const raw = await readFile(fullPath, "utf8");
+            const parsed = JSON.parse(raw);
+            const record = Array.isArray(parsed) && parsed.length > 0
+                ? parsed[0]
+                : parsed;
+            try {
+                result = (await narrixRunHandler({
+                    input: { medium: "record", datasetId: DATASET_ID, record },
+                    ctx,
+                }));
+            }
+            catch (err) {
+                const e = err;
+                result = {
+                    ok: false,
+                    error: "PLAYGROUND_EXCEPTION",
+                    message: e.message ?? "narrix run threw",
+                };
+            }
+        }
+        catch (err) {
+            const e = err;
+            result = {
+                ok: false,
+                error: "PLAYGROUND_EXCEPTION",
+                message: `Failed to read/parse input: ${e.message}`,
+            };
+        }
+        const finishedAt = new Date().toISOString();
+        const startedMs = new Date(startedAt).getTime();
+        const finishedMs = new Date(finishedAt).getTime();
+        const durationMs = finishedMs - startedMs;
+        const derived = deriveFromResult(result);
+        if (derived.ok)
+            okCount++;
+        else
+            failCount++;
+        const signalCount = derived.signalCodes.length;
+        const storyCount = derived.narrativeTypeIds.length;
+        byFile.push({
+            filename,
+            ok: derived.ok,
+            signalCount,
+            storyCount,
+            signalCodes: derived.signalCodes,
+            narrativeTypeIds: derived.narrativeTypeIds,
+            error: derived.error,
+        });
+        const outDoc = {
+            input: { filename, fullPath, datasetId: DATASET_ID },
+            result,
+            derived,
+            timestamps: { startedAt, finishedAt, durationMs },
+        };
+        const outBasename = filename.replace(/\.json$/i, "") + ".out.json";
+        const outPath = path.join(outDir, outBasename);
+        await writeFile(outPath, JSON.stringify(outDoc, null, 2), "utf8");
+        console.log(derived.ok ? "ok" : "fail", filename, "signals:", signalCount, "stories:", storyCount, derived.error ?? "");
+    }
+    const summary = {
+        datasetId: DATASET_ID,
+        runCount: files.length,
+        okCount,
+        failCount,
+        byFile,
+    };
+    await writeFile(path.join(outDir, "_summary.json"), JSON.stringify(summary, null, 2), "utf8");
+    console.log("Finished. ok:", okCount, "fail:", failCount, "→", path.join(outDir, "_summary.json"));
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=narrixSubnetPlayground.js.map

package/dist/localTasks/narrixSubnetPlayground.js.map

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

package/dist/localTasks/narrixVulnGroupPlayground.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Playground/batch test: run narrix record handler on all vulnerability-group test-data JSON files,
+ * write one output JSON per input plus _summary.json.
+ *
+ * Env (optional):
+ *   NARRIX_PLAYGROUND_IN   default .tests/test-data
+ *   NARRIX_PLAYGROUND_OUT  default .tests/test-output/vuln-groups
+ *   NARRIX_DATASET_ID      default vulnGroup
+ *
+ * Run: npm run local:narrix:vuln-groups (after npm run build)
+ */
+export {};
+//# sourceMappingURL=narrixVulnGroupPlayground.d.ts.map

package/dist/localTasks/narrixVulnGroupPlayground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrixVulnGroupPlayground.d.ts","sourceRoot":"","sources":["../../src/localTasks/narrixVulnGroupPlayground.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/localTasks/narrixVulnGroupPlayground.js

@@ -0,0 +1,161 @@
+/**
+ * Playground/batch test: run narrix record handler on all vulnerability-group test-data JSON files,
+ * write one output JSON per input plus _summary.json.
+ *
+ * Env (optional):
+ *   NARRIX_PLAYGROUND_IN   default .tests/test-data
+ *   NARRIX_PLAYGROUND_OUT  default .tests/test-output/vuln-groups
+ *   NARRIX_DATASET_ID      default vulnGroup
+ *
+ * Run: npm run local:narrix:vuln-groups (after npm run build)
+ */
+import { readdir, readFile, mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { narrixRunHandler } from "../narrix/task.js";
+const DATASET_ID = process.env.NARRIX_DATASET_ID ?? "vulnGroup";
+const PLAYGROUND_IN = process.env.NARRIX_PLAYGROUND_IN ?? ".tests/test-data";
+const PLAYGROUND_OUT = process.env.NARRIX_PLAYGROUND_OUT ?? ".tests/test-output/vuln-groups";
+function isVulnGroupInputFile(name) {
+    if (!name.endsWith(".json"))
+        return false;
+    return (name.startsWith("vulnerability-groups-information_g.") ||
+        (name.includes("vuln") && name.includes("group")));
+}
+function deriveFromResult(result) {
+    if (!result.ok) {
+        return {
+            signalCodes: [],
+            narrativeTypeIds: [],
+            ok: false,
+            error: result.error ?? null,
+        };
+    }
+    const signals = result.signals ?? [];
+    const stories = result.stories ?? [];
+    return {
+        signalCodes: signals.map((s) => s.code ?? "").filter(Boolean),
+        narrativeTypeIds: stories.map((s) => s.narrativeTypeId ?? "").filter(Boolean),
+        ok: true,
+        error: null,
+    };
+}
+function getProjectRoot() {
+    const dir = path.dirname(fileURLToPath(import.meta.url));
+    if (dir.endsWith("localTasks"))
+        return path.resolve(dir, "../..");
+    return path.resolve(dir, "../..");
+}
+const ctx = {
+    skillKey: "skills/skill.local:narrixRun",
+};
+async function main() {
+    const root = getProjectRoot();
+    const inDir = path.resolve(root, PLAYGROUND_IN);
+    const outDir = path.resolve(root, PLAYGROUND_OUT);
+    let entries;
+    try {
+        entries = (await readdir(inDir, { withFileTypes: true }));
+    }
+    catch (err) {
+        const e = err;
+        console.error("Playground input dir not found or not readable:", inDir, e.message);
+        process.exit(1);
+    }
+    const files = entries
+        .filter((e) => e.isFile() && isVulnGroupInputFile(e.name))
+        .map((e) => e.name)
+        .sort();
+    if (files.length === 0) {
+        console.log("No vuln-group input files found in", inDir);
+        await mkdir(outDir, { recursive: true });
+        const summary = {
+            datasetId: DATASET_ID,
+            runCount: 0,
+            okCount: 0,
+            failCount: 0,
+            byFile: [],
+        };
+        await writeFile(path.join(outDir, "_summary.json"), JSON.stringify(summary, null, 2), "utf8");
+        console.log("Wrote _summary.json (0 runs).");
+        return;
+    }
+    console.log("Running", files.length, "vuln-group file(s)...");
+    await mkdir(outDir, { recursive: true });
+    const byFile = [];
+    let okCount = 0;
+    let failCount = 0;
+    for (const filename of files) {
+        const fullPath = path.join(inDir, filename);
+        const startedAt = new Date().toISOString();
+        let result;
+        try {
+            const raw = await readFile(fullPath, "utf8");
+            const parsed = JSON.parse(raw);
+            const record = Array.isArray(parsed) && parsed.length > 0
+                ? parsed[0]
+                : parsed;
+            try {
+                result = (await narrixRunHandler({
+                    input: { medium: "record", datasetId: DATASET_ID, record },
+                    ctx,
+                }));
+            }
+            catch (err) {
+                const e = err;
+                result = {
+                    ok: false,
+                    error: "PLAYGROUND_EXCEPTION",
+                    message: e.message ?? "narrix run threw",
+                };
+            }
+        }
+        catch (err) {
+            const e = err;
+            result = {
+                ok: false,
+                error: "PLAYGROUND_EXCEPTION",
+                message: `Failed to read/parse input: ${e.message}`,
+            };
+        }
+        const finishedAt = new Date().toISOString();
+        const durationMs = new Date(finishedAt).getTime() - new Date(startedAt).getTime();
+        const derived = deriveFromResult(result);
+        if (derived.ok)
+            okCount++;
+        else
+            failCount++;
+        byFile.push({
+            filename,
+            ok: derived.ok,
+            signalCount: derived.signalCodes.length,
+            storyCount: derived.narrativeTypeIds.length,
+            signalCodes: derived.signalCodes,
+            narrativeTypeIds: derived.narrativeTypeIds,
+            error: derived.error,
+        });
+        const outDoc = {
+            input: { filename, fullPath, datasetId: DATASET_ID },
+            result,
+            derived,
+            timestamps: { startedAt, finishedAt, durationMs },
+        };
+        const outBasename = filename.replace(/\.json$/i, "") + ".out.json";
+        await writeFile(path.join(outDir, outBasename), JSON.stringify(outDoc, null, 2), "utf8");
+        console.log(derived.ok ? "ok" : "fail", filename, "signals:", derived.signalCodes.length, "stories:", derived.narrativeTypeIds.length, derived.error ?? "");
+    }
+    const summary = {
+        datasetId: DATASET_ID,
+        runCount: files.length,
+        okCount,
+        failCount,
+        byFile,
+    };
+    await writeFile(path.join(outDir, "_summary.json"), JSON.stringify(summary, null, 2), "utf8");
+    console.log("Finished. ok:", okCount, "fail:", failCount, "->", path.join(outDir, "_summary.json"));
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=narrixVulnGroupPlayground.js.map

package/dist/localTasks/narrixVulnGroupPlayground.js.map

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

package/dist/localTasks/narrixVulnInstancePlayground.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Playground/batch test: run narrix record handler on all vulnerability (instance) test-data JSON files,
+ * write one output JSON per input plus _summary.json.
+ *
+ * Env (optional):
+ *   NARRIX_PLAYGROUND_IN   default .tests/test-data
+ *   NARRIX_PLAYGROUND_OUT  default .tests/test-output/vulnerabilities
+ *   NARRIX_DATASET_ID      default vulnInstance
+ *
+ * Run: npm run local:narrix:vuln-instances (after npm run build)
+ */
+export {};
+//# sourceMappingURL=narrixVulnInstancePlayground.d.ts.map

package/dist/localTasks/narrixVulnInstancePlayground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"narrixVulnInstancePlayground.d.ts","sourceRoot":"","sources":["../../src/localTasks/narrixVulnInstancePlayground.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}