@agenticprimitives/provenance-node 0.0.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agentic Trust Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,32 @@
+# @agenticprimitives/provenance-node
+
+> Part of **[Agentic Primitives](https://agenticprimitives.dev)** — the open-source trust substrate for agentic applications: identity that can sign, authority checked at act time, evidence the owner carries. [Developer kit](https://github.com/agentictrustlabs/agentic-primitives) · [All packages](https://agenticprimitives.dev/developers)
+
+The Node-side reference bindings of the provenance ports, and the conformance suite that proves a store binding keeps a
+run's record intact.
+
+A run's provenance is a W3C PROV-O / P-Plan / EP-Plan graph in JSON-LD; its measurements are W3C DQV. Where those
+records are KEPT — an agent's vault, a directory of files, a Solid pod, a Graph Store — is a binding of one port.
+`ap conform provenance` runs any binding through six checks and prints what it broke:
+
+| | Check |
+| --- | --- |
+| C1 | a record put and got back has the same RDFC-1.0 digest (the graph, not the bytes) |
+| C2 | every predicate and class IRI in it is declared in the published ontology; Turtle is served from it |
+| C3 | it conforms to the published SHACL shapes as returned, and a twin still fails |
+| C4 | it carries no words (no address, no body; a measurement is a number) |
+| C5 | an absent record is absent; a reader without standing is refused — never served empty |
+| C6 | a rollup wiped and rebuilt from the records gives the same numbers |
+
+```bash
+ap conform provenance file:./eval-store     # a directory of .jsonld files
+ap conform provenance memory:               # the in-memory reference
+```
+
+In code: `runProvenanceConformance(store, { stranger, rollup })` for any `ProvenanceStorePort` — the vault binding in
+`apps/demo-a2a` is run through the same suite in its tests.
+
+Also exported: `rdfcCanonicalizer` (for `recordDigest`), `validateQuads` (SHACL over the published shapes with the
+subclass closure materialized), `toTurtle`, and `fileProvenanceStore`.
+
+Node only. A Worker bundles the zero-dependency `@agenticprimitives/provenance` and never this package.

package/dist/conform.d.ts

@@ -0,0 +1,27 @@
+import { type HarnessRunProvenanceInput, type ProvenanceStorePort } from '@agenticprimitives/provenance';
+import { type RollupPort } from '@agenticprimitives/evaluation';
+export interface ConformanceCheck {
+    id: string;
+    level: 'MUST' | 'SHOULD' | 'MAY';
+    ok: boolean;
+    detail?: string;
+}
+export interface ConformanceReport {
+    target: string;
+    ok: boolean;
+    checks: ConformanceCheck[];
+}
+/** The fixture run: an A2A door, a variant, a model call, engagements, a governing skill, a mandated completed step. */
+export declare const CONFORMANCE_RUN: HarnessRunProvenanceInput;
+export interface RunConformanceOptions {
+    /** The same store as a reader WITHOUT standing sees it (C5). Absent ⇒ C5 is reported as not exercised (SHOULD). */
+    stranger?: ProvenanceStorePort;
+    /** The rollup binding under test (C6). Absent ⇒ the reference in-memory rollup. */
+    rollup?: RollupPort;
+    target?: string;
+}
+/** Run C1–C6 against a store binding. */
+export declare function runProvenanceConformance(store: ProvenanceStorePort, opts?: RunConformanceOptions): Promise<ConformanceReport>;
+/** The devkit entry (`ap conform provenance <target>`): `file:<dir>` (a directory store; a temp dir when empty) or `memory:`. */
+export declare function conformProvenance(target: string): Promise<ConformanceReport>;
+//# sourceMappingURL=conform.d.ts.map

package/dist/conform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conform.d.ts","sourceRoot":"","sources":["../src/conform.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAuD,KAAK,yBAAyB,EAAE,KAAK,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAE9J,OAAO,EAAmE,KAAK,UAAU,EAAyB,MAAM,+BAA+B,CAAC;AAKxJ,MAAM,WAAW,gBAAgB;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;AAChH,MAAM,WAAW,iBAAiB;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAAE;AAK9F,wHAAwH;AACxH,eAAO,MAAM,eAAe,EAAE,yBAa7B,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,mHAAmH;IACnH,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,mFAAmF;IACnF,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,yCAAyC;AACzC,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,mBAAmB,EAAE,IAAI,GAAE,qBAA0B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA4EvI;AAED,iIAAiI;AACjI,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAWlF"}

package/dist/conform.js

@@ -0,0 +1,151 @@
+// `ap conform provenance` — THE STORAGE IS A BINDING, PROVED (spec 414 §6). Any `ProvenanceStorePort` binding — the
+// acting agent's vault, a directory of files, a Solid pod, a Graph Store — is run through the same six checks with the
+// same fixtures, and passes or names what it broke:
+//
+//   C1  round trip — a record put and got back has the SAME RDFC-1.0 digest (the graph, not the bytes);
+//   C2  serialization — what comes back expands under the published context, and every predicate and class IRI in it
+//       is declared in the shipped T-box; Turtle is served from it;
+//   C3  shapes — the run record conforms to R1–R11 and the measurements to M1–M3 AS RETURNED, and a twin still fails;
+//   C4  no words — R6 (no address, no body among the run's members) and M3 (a measurement is a number) hold on it;
+//   C5  access — an absent key is `absent`; a reader without standing is `refused`, never served, never "empty";
+//   C6  rollup — a rollup wiped and rebuilt from the records gives the numbers the live one held.
+//
+// The report shape is the devkit's (`ConformanceReport`), so `ap conform provenance file:<dir>` prints like `ap conform a2a`.
+import { mkdtemp } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { projectHarnessRunProvenance, toJsonLd, recordDigest } from '@agenticprimitives/provenance';
+import { RUN_PROVENANCE_CONTEXT, RUN_MEASURES_CONTEXT } from '@agenticprimitives/ontology';
+import { measureRun, measuresToJsonLd, memoryRollup, rollupRebuildsEqual } from '@agenticprimitives/evaluation';
+import { rdfcCanonicalizer, quadsOf, toTurtle } from './rdfc.js';
+import { validateQuads, declaredTerms } from './shacl.js';
+import { fileProvenanceStore } from './file-store.js';
+const AGENT = '0xb0d11ce19b756a682e78b4904cd8d832303b3d11';
+const RDF_TYPE = 'http://www.w3.org/1999/02/22-rdf-syntax-ns#type';
+/** The fixture run: an A2A door, a variant, a model call, engagements, a governing skill, a mandated completed step. */
+export const CONFORMANCE_RUN = {
+    runRef: 'run-conform', endedAt: '2026-09-25T12:00:10.000Z', agent: AGENT, agentClass: 'person', asker: AGENT, chainId: 34348,
+    intentDigest: '0x' + '22'.repeat(32), outcome: 'completed',
+    door: { kind: 'a2a-message', messageId: 'm-conform', contextId: 'c-conform', taskId: 't-conform' },
+    variant: { digest: 'sha256:' + 'ab'.repeat(32), plannerKind: 'model', routePolicy: 'budget' },
+    modelCalls: [{ role: 'plan', model: 'model-x', provider: 'provider-x', tokensIn: 100, tokensOut: 20, startedAt: '2026-09-25T12:00:01.000Z', endedAt: '2026-09-25T12:00:02.000Z' }],
+    engagements: [{ capability: 'planner/model', effect: 'changed-plan' }],
+    steps: [{
+            stepRef: 's0', toolId: 'people.members.list', capability: { id: 'people.members.list', action: 'read' }, status: 'completed',
+            startedAt: '2026-09-25T12:00:03.000Z', endedAt: '2026-09-25T12:00:09.000Z', receiptDigest: '0x' + 'd1'.repeat(32),
+            authority: { presentedRef: '0x' + '11'.repeat(32), decision: 'allow', afterApproval: false },
+            skill: { id: 'skill:people/members', version: '1.0.0', contractDigest: '0x' + '44'.repeat(32) },
+        }],
+};
+/** Run C1–C6 against a store binding. */
+export async function runProvenanceConformance(store, opts = {}) {
+    const checks = [];
+    const add = (id, ok, detail, level = 'MUST') => checks.push({ id, level, ok, ...(detail ? { detail } : {}) });
+    const run = toJsonLd(projectHarnessRunProvenance(CONFORMANCE_RUN), { context: RUN_PROVENANCE_CONTEXT['@context'], chainId: 34348 });
+    const measurements = measureRun({ runRef: CONFORMANCE_RUN.runRef, outcome: 'completed', startedAt: '2026-09-25T12:00:00.000Z', endedAt: CONFORMANCE_RUN.endedAt, stepsPlanned: 1, modelCalls: [{ tokensIn: 100, tokensOut: 20 }], engagements: 1, steps: CONFORMANCE_RUN.steps.map((s) => ({ stepRef: s.stepRef, status: 'executed', ...(s.startedAt ? { startedAt: s.startedAt } : {}), ...(s.endedAt ? { endedAt: s.endedAt } : {}), ...(s.authority ? { authority: { decision: s.authority.decision, afterApproval: s.authority.afterApproval } } : {}) })) });
+    const agentIri = `urn:ap:agent:eip155:34348:${AGENT}`;
+    const measures = measuresToJsonLd(CONFORMANCE_RUN.runRef, measurements, { context: RUN_MEASURES_CONTEXT['@context'], agentIri, runtimeIri: `urn:ap:prov:runtime:${agentIri}`, at: CONFORMANCE_RUN.endedAt });
+    const refs = { run: { agent: AGENT, key: `run.provenance:${CONFORMANCE_RUN.runRef}` }, measures: { agent: AGENT, key: `run.measures:${CONFORMANCE_RUN.runRef}` } };
+    // C1 — the round trip, by the graph's identity.
+    const got = { run: null, measures: null };
+    try {
+        for (const [k, doc] of [['run', run], ['measures', measures]]) {
+            const w = await store.put(refs[k], doc);
+            if (!w.ok) {
+                add(`C1 round trip (${k})`, false, `put refused: ${w.error}`);
+                continue;
+            }
+            const r = await store.get(refs[k]);
+            if (r.status !== 'found') {
+                add(`C1 round trip (${k})`, false, `get answered ${r.status}${r.status === 'refused' ? `: ${r.reason}` : ''}`);
+                continue;
+            }
+            got[k] = r.document;
+            const [a, b] = [await recordDigest(doc, rdfcCanonicalizer), await recordDigest(r.document, rdfcCanonicalizer)];
+            add(`C1 round trip (${k})`, a === b, a === b ? a : `digest changed: ${a} → ${b}`);
+        }
+    }
+    catch (e) {
+        add('C1 round trip', false, e instanceof Error ? e.message : String(e));
+    }
+    // C2 — expands under the context; every IRI declared; Turtle served.
+    try {
+        const declared = await declaredTerms();
+        const undeclared = new Set();
+        for (const doc of [got.run, got.measures].filter((d) => !!d)) {
+            for (const q of await quadsOf(doc)) {
+                if (q.predicate.value !== RDF_TYPE && !declared.has(q.predicate.value))
+                    undeclared.add(q.predicate.value);
+                if (q.predicate.value === RDF_TYPE && q.object.termType === 'NamedNode' && !declared.has(q.object.value))
+                    undeclared.add(q.object.value);
+            }
+        }
+        add('C2 every IRI declared in the T-box', got.run !== null && undeclared.size === 0, undeclared.size ? [...undeclared].slice(0, 5).join(', ') : undefined);
+        const ttl = got.run ? await toTurtle(got.run) : '';
+        add('C2 Turtle served from the record', ttl.includes('prov#') || ttl.includes('prov:'), ttl ? `${ttl.split('\n').length} lines` : 'no record');
+    }
+    catch (e) {
+        add('C2 serialization', false, e instanceof Error ? e.message : String(e));
+    }
+    // C3 + C4 — the shapes on what came back; a twin still fails.
+    try {
+        if (got.run) {
+            const r = await validateQuads('cbox/run-provenance-shapes.shacl.ttl', await quadsOf(got.run));
+            add('C3 run record conforms (R1–R11)', r.conforms, r.messages.slice(0, 2).join(' | ') || undefined);
+            add('C4 no words in the run record (R6)', !r.messages.some((m) => m.startsWith('R6')));
+            const twin = { ...got.run, graph: got.run['graph'].map((n) => (n['id'] === `urn:ap:prov:act:${CONFORMANCE_RUN.runRef}` ? { ...n, arrivedBy: undefined } : n)) };
+            const t = await validateQuads('cbox/run-provenance-shapes.shacl.ttl', await quadsOf(twin));
+            add('C3 a twin without its door is refused (R9)', !t.conforms && t.messages.some((m) => m.startsWith('R9')));
+        }
+        if (got.measures) {
+            const m = await validateQuads('cbox/run-measures-shapes.shacl.ttl', await quadsOf(got.measures));
+            add('C3 measurements conform (M1–M3)', m.conforms, m.messages.slice(0, 2).join(' | ') || undefined);
+            add('C4 no words in the measurements (M3)', !m.messages.some((x) => x.startsWith('M3')));
+        }
+    }
+    catch (e) {
+        add('C3 shapes', false, e instanceof Error ? e.message : String(e));
+    }
+    // C5 — absent is absent; no standing is refused.
+    try {
+        const absent = await store.get({ agent: AGENT, key: 'run.provenance:run-that-never-was' });
+        add('C5 an absent record is absent (not refused, not thrown)', absent.status === 'absent', absent.status);
+        if (opts.stranger) {
+            const s = await opts.stranger.get(refs.run);
+            add('C5 a reader without standing is refused', s.status === 'refused', s.status);
+        }
+        else
+            add('C5 a reader without standing is refused', false, 'not exercised — no stranger view of this binding was given', 'SHOULD');
+    }
+    catch (e) {
+        add('C5 access', false, e instanceof Error ? e.message : String(e));
+    }
+    // C6 — the rollup rebuilds to the same numbers.
+    try {
+        const rollup = opts.rollup ?? memoryRollup();
+        const facts = [{ runRef: CONFORMANCE_RUN.runRef, agent: AGENT, endedAt: CONFORMANCE_RUN.endedAt, variantDigest: CONFORMANCE_RUN.variant.digest, skillContracts: ['skill:people/members'], capabilities: ['planner/model'], measurements }];
+        await rollup.clear();
+        for (const f of facts)
+            await rollup.add(f);
+        const r = await rollupRebuildsEqual(rollup, facts);
+        add(`C6 rollup (${rollup.binding}) rebuilds to the same numbers`, r.equal, `${r.live} rows live, ${r.rebuilt} rebuilt`);
+    }
+    catch (e) {
+        add('C6 rollup', false, e instanceof Error ? e.message : String(e));
+    }
+    return { target: opts.target ?? store.binding, ok: checks.every((c) => c.ok || c.level !== 'MUST'), checks };
+}
+/** The devkit entry (`ap conform provenance <target>`): `file:<dir>` (a directory store; a temp dir when empty) or `memory:`. */
+export async function conformProvenance(target) {
+    if (target.startsWith('file:')) {
+        const dir = target.slice('file:'.length) || (await mkdtemp(join(tmpdir(), 'ap-conform-')));
+        return runProvenanceConformance(fileProvenanceStore(dir), { stranger: fileProvenanceStore(dir, { reader: '0x' + '99'.repeat(20) }), target: `file:${dir}` });
+    }
+    if (target === 'memory:' || target === 'memory') {
+        const m = new Map();
+        const store = { binding: 'memory', async put(ref, d) { m.set(`${ref.agent}|${ref.key}`, structuredClone(d)); return { ok: true }; }, async get(ref) { const d = m.get(`${ref.agent}|${ref.key}`); return d ? { status: 'found', document: structuredClone(d) } : { status: 'absent' }; } };
+        return runProvenanceConformance(store, { target: 'memory:' });
+    }
+    return { target, ok: false, checks: [{ id: 'target', level: 'MUST', ok: false, detail: 'a provenance target is file:<dir> or memory: — a vault is conformed from its own runtime (runProvenanceConformance)' }] };
+}
+//# sourceMappingURL=conform.js.map

package/dist/conform.js.map

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

package/dist/file-store.d.ts

@@ -0,0 +1,9 @@
+import type { ProvenanceStorePort } from '@agenticprimitives/provenance';
+export interface FileStoreOptions {
+    /** Who is reading (an agent address). Absent ⇒ the operator of the directory (no standing check). */
+    reader?: string;
+    /** Agents the reader stewards — may read their records too. */
+    stewards?: Record<string, readonly string[]>;
+}
+export declare function fileProvenanceStore(dir: string, opts?: FileStoreOptions): ProvenanceStorePort;
+//# sourceMappingURL=file-store.d.ts.map

package/dist/file-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-store.d.ts","sourceRoot":"","sources":["../src/file-store.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,qGAAqG;IACrG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;CAC9C;AAID,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,gBAAqB,GAAG,mBAAmB,CA4BjG"}

package/dist/file-store.js

@@ -0,0 +1,51 @@
+// A DIRECTORY OF .jsonld FILES as a `ProvenanceStorePort` (spec 414 §5; 415 §7 — the eval store's first binding). One
+// file per record: `<dir>/<agent>/<key>.jsonld`. Readable only by the agent itself or a named steward when a reader is
+// given — a stranger is REFUSED, never served empty (conformance C5, ADR-0013). Node-side.
+import { mkdir, readFile, readdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+const safe = (s) => encodeURIComponent(s);
+export function fileProvenanceStore(dir, opts = {}) {
+    const standing = (agent) => !opts.reader || opts.reader.toLowerCase() === agent.toLowerCase() || (opts.stewards?.[opts.reader.toLowerCase()] ?? []).map((a) => a.toLowerCase()).includes(agent.toLowerCase());
+    const pathOf = (agent, key) => join(dir, safe(agent.toLowerCase()), `${safe(key)}.jsonld`);
+    return {
+        binding: 'file',
+        async put(ref, document) {
+            try {
+                await mkdir(join(dir, safe(ref.agent.toLowerCase())), { recursive: true });
+                await writeFile(pathOf(ref.agent, ref.key), `${JSON.stringify(document, null, 2)}\n`);
+                return { ok: true };
+            }
+            catch (e) {
+                return { ok: false, error: e instanceof Error ? e.message : String(e) };
+            }
+        },
+        async get(ref) {
+            if (!standing(ref.agent))
+                return { status: 'refused', reason: 'the reader has no standing on this agent\'s records' };
+            try {
+                return { status: 'found', document: JSON.parse(await readFile(pathOf(ref.agent, ref.key), 'utf8')) };
+            }
+            catch (e) {
+                return e.code === 'ENOENT' ? { status: 'absent' } : { status: 'refused', reason: e instanceof Error ? e.message : String(e) };
+            }
+        },
+        async list(agent, selector) {
+            if (!standing(agent))
+                return { refused: 'the reader has no standing on this agent\'s records' };
+            let names = [];
+            try {
+                names = await readdir(join(dir, safe(agent.toLowerCase())));
+            }
+            catch (e) {
+                if (e.code !== 'ENOENT')
+                    return { refused: e instanceof Error ? e.message : String(e) };
+            }
+            const keys = names.filter((n) => n.endsWith('.jsonld')).map((n) => decodeURIComponent(n.slice(0, -'.jsonld'.length))).filter((k) => k.startsWith(selector.keyPrefix)).sort();
+            const from = selector.after ? keys.findIndex((k) => k > selector.after) : 0;
+            const page = keys.slice(from < 0 ? keys.length : from, (from < 0 ? keys.length : from) + (selector.limit ?? 100));
+            const next = keys.length > (from < 0 ? keys.length : from) + page.length ? page[page.length - 1] : undefined;
+            return { keys: page, ...(next ? { next } : {}) };
+        },
+    };
+}
+//# sourceMappingURL=file-store.js.map

package/dist/file-store.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export declare const PACKAGE_NAME: "@agenticprimitives/provenance-node";
+export declare const SPEC_REF: "specs/414-tracing-as-the-record-and-skill-effectiveness.md";
+export { rdfcCanonicalizer, quadsOf, toTurtle } from './rdfc.js';
+export { validateQuads, declaredTerms, type ShaclResultV1 } from './shacl.js';
+export { fileProvenanceStore, type FileStoreOptions } from './file-store.js';
+export { runProvenanceConformance, conformProvenance, CONFORMANCE_RUN, type RunConformanceOptions, type ConformanceReport, type ConformanceCheck } from './conform.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,YAAY,EAAG,oCAA6C,CAAC;AAC1E,eAAO,MAAM,QAAQ,EAAG,4DAAqE,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// @agenticprimitives/provenance-node — the Node-side reference bindings of the provenance ports (spec 414 §5, A2d).
+// The ports and the digest live in the zero-dependency `@agenticprimitives/provenance`; this package fills them with a
+// stock RDF stack (RDFC-1.0, SHACL, Turtle) and a directory store, and carries the conformance suite every binding —
+// the vault included — is run through (`./conform`, `ap conform provenance`). Node only: a Worker carries none of it.
+export const PACKAGE_NAME = '@agenticprimitives/provenance-node';
+export const SPEC_REF = 'specs/414-tracing-as-the-record-and-skill-effectiveness.md';
+export { rdfcCanonicalizer, quadsOf, toTurtle } from './rdfc.js';
+export { validateQuads, declaredTerms } from './shacl.js';
+export { fileProvenanceStore } from './file-store.js';
+export { runProvenanceConformance, conformProvenance, CONFORMANCE_RUN } from './conform.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,uHAAuH;AACvH,qHAAqH;AACrH,sHAAsH;AACtH,MAAM,CAAC,MAAM,YAAY,GAAG,oCAA6C,CAAC;AAC1E,MAAM,CAAC,MAAM,QAAQ,GAAG,4DAAqE,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAsB,MAAM,YAAY,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAyB,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,eAAe,EAA6E,MAAM,cAAc,CAAC"}

package/dist/rdfc.d.ts

@@ -0,0 +1,21 @@
+import type { RdfCanonicalizer } from '@agenticprimitives/provenance';
+/** W3C RDFC-1.0 over a JSON-LD document. */
+export declare const rdfcCanonicalizer: RdfCanonicalizer;
+/** The document's quads, structurally (for a validator or a graph engine). */
+export declare function quadsOf(document: Record<string, unknown>): Promise<Array<{
+    subject: {
+        termType: string;
+        value: string;
+    };
+    predicate: {
+        termType: string;
+        value: string;
+    };
+    object: {
+        termType: string;
+        value: string;
+    };
+}>>;
+/** The same graph as Turtle — the third serialization PROV-AQ content negotiation offers (414 §5). */
+export declare function toTurtle(document: Record<string, unknown>): Promise<string>;
+//# sourceMappingURL=rdfc.d.ts.map

package/dist/rdfc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rdfc.d.ts","sourceRoot":"","sources":["../src/rdfc.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAUtE,4CAA4C;AAC5C,eAAO,MAAM,iBAAiB,EAAE,gBAAyG,CAAC;AAE1I,8EAA8E;AAC9E,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,SAAS,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC,CAAC,CAE9N;AAED,sGAAsG;AACtG,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAOjF"}

package/dist/rdfc.js

@@ -0,0 +1,31 @@
+// THE RDFC-1.0 BINDING (spec 414 §2 rule 3). A JSON-LD document → its canonical N-Quads, by a stock RDF stack
+// (@zazuko/env-node: a JSON-LD parser and rdf-ext's canonical form, which is URDNA2015 = W3C RDFC-1.0's output). The
+// provenance package names the seam (`RdfCanonicalizer`) and hashes; this fills it. Node-side: a Worker does not carry it.
+import { Readable } from 'node:stream';
+import rdf from '@zazuko/env-node';
+const TURTLE = 'text/turtle';
+const JSON_LD = 'application/ld+json';
+async function datasetOf(mediaType, text) {
+    const quads = rdf.formats.parsers.import(mediaType, Readable.from([text]));
+    if (!quads)
+        throw new Error(`no parser for ${mediaType}`);
+    return rdf.dataset().import(quads);
+}
+/** W3C RDFC-1.0 over a JSON-LD document. */
+export const rdfcCanonicalizer = async (document) => (await datasetOf(JSON_LD, JSON.stringify(document))).toCanonical();
+/** The document's quads, structurally (for a validator or a graph engine). */
+export async function quadsOf(document) {
+    return [...(await datasetOf(JSON_LD, JSON.stringify(document)))];
+}
+/** The same graph as Turtle — the third serialization PROV-AQ content negotiation offers (414 §5). */
+export async function toTurtle(document) {
+    const ds = await datasetOf(JSON_LD, JSON.stringify(document));
+    const out = rdf.formats.serializers.import(TURTLE, ds.toStream());
+    if (!out)
+        throw new Error('no turtle serializer');
+    let text = '';
+    for await (const chunk of out)
+        text += String(chunk);
+    return text;
+}
+//# sourceMappingURL=rdfc.js.map

package/dist/rdfc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rdfc.js","sourceRoot":"","sources":["../src/rdfc.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,qHAAqH;AACrH,2HAA2H;AAC3H,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,GAAG,MAAM,kBAAkB,CAAC;AAEnC,MAAM,MAAM,GAAG,aAAa,CAAC;AAC7B,MAAM,OAAO,GAAG,qBAAqB,CAAC;AAEtC,KAAK,UAAU,SAAS,CAAC,SAAiB,EAAE,IAAY;IACtD,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3E,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,SAAS,EAAE,CAAC,CAAC;IAC1D,OAAO,GAAG,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,4CAA4C;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAqB,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAE1I,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,QAAiC;IAC7D,OAAO,CAAC,GAAG,CAAC,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAU,CAAC;AAC5E,CAAC;AAED,sGAAsG;AACtG,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,QAAiC;IAC9D,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClE,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAClD,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,GAAgD;QAAE,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAClG,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/shacl.d.ts

@@ -0,0 +1,9 @@
+/** Every IRI the shipped T-box declares (a subject with an rdf:type). */
+export declare function declaredTerms(): Promise<Set<string>>;
+export interface ShaclResultV1 {
+    conforms: boolean;
+    messages: string[];
+}
+/** Validate a record's quads against one published shapes file (`cbox/run-provenance-shapes.shacl.ttl`, …). */
+export declare function validateQuads(shapesRel: string, quads: Iterable<unknown>): Promise<ShaclResultV1>;
+//# sourceMappingURL=shacl.d.ts.map

package/dist/shacl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shacl.d.ts","sourceRoot":"","sources":["../src/shacl.ts"],"names":[],"mappings":"AA8BA,yEAAyE;AACzE,wBAAsB,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAI1D;AAED,MAAM,WAAW,aAAa;IAAG,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE;AAIxE,+GAA+G;AAC/G,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAWvG"}

package/dist/shacl.js

@@ -0,0 +1,63 @@
+// SHACL VALIDATION over the published run shapes (spec 389 R1–R6, 414 R7–R11, M1–M3), with the SHIPPED T-box and the
+// codelists as the data graph's context and the rdfs:subClassOf* closure materialized (shacl-engine does not compute
+// SHACL-instance-of; without the closure a shape targeting a superclass matches nothing and passes by not looking).
+import { readFileSync } from 'node:fs';
+import { Readable } from 'node:stream';
+import rdf from '@zazuko/env-node';
+import { Validator } from 'shacl-engine';
+import { targetResolvers, validations } from 'shacl-engine/sparql.js';
+import { ARTIFACTS, artifactPath } from '@agenticprimitives/ontology/artifacts';
+const TURTLE = 'text/turtle';
+const JSON_LD = 'application/ld+json';
+const RDF_TYPE = 'http://www.w3.org/1999/02/22-rdf-syntax-ns#type';
+const SUBCLASS_OF = 'http://www.w3.org/2000/01/rdf-schema#subClassOf';
+const CODELISTS = ['cbox/controlled-vocabularies.ttl', 'cbox/registry-vocabulary.ttl'];
+async function turtle(ttl) {
+    const q = rdf.formats.parsers.import(TURTLE, Readable.from([ttl]));
+    if (!q)
+        throw new Error('no turtle parser');
+    return rdf.dataset().import(q);
+}
+let tboxCache;
+async function tbox() {
+    if (tboxCache)
+        return tboxCache;
+    const ttl = [...ARTIFACTS.tbox, ...CODELISTS].map((rel) => readFileSync(artifactPath(rel), 'utf8')).join('\n');
+    tboxCache = [...(await turtle(ttl))];
+    return tboxCache;
+}
+/** Every IRI the shipped T-box declares (a subject with an rdf:type). */
+export async function declaredTerms() {
+    const out = new Set();
+    for (const q of (await tbox()))
+        if (q.subject.termType === 'NamedNode' && q.predicate.value === RDF_TYPE)
+            out.add(q.subject.value);
+    return out;
+}
+/** Validate a record's quads against one published shapes file (`cbox/run-provenance-shapes.shacl.ttl`, …). */
+export async function validateQuads(shapesRel, quads) {
+    const validator = new Validator(await turtle(readFileSync(artifactPath(shapesRel), 'utf8')), { factory: rdf, targetResolvers, validations });
+    const data = rdf.dataset();
+    for (const q of await tbox())
+        data.add(q);
+    for (const q of quads) {
+        const x = q;
+        data.add(rdf.quad(x.subject, x.predicate, x.object));
+    }
+    const parents = new Map();
+    for (const q of data)
+        if (q.predicate.value === SUBCLASS_OF)
+            parents.set(q.subject.value, [...(parents.get(q.subject.value) ?? []), q.object.value]);
+    const ancestors = (c, seen = new Set()) => { for (const p of parents.get(c) ?? [])
+        if (!seen.has(p)) {
+            seen.add(p);
+            ancestors(p, seen);
+        } return [...seen]; };
+    for (const q of [...data])
+        if (q.predicate.value === RDF_TYPE)
+            for (const a of ancestors(q.object.value))
+                data.add(rdf.quad(q.subject, q.predicate, rdf.namedNode(a)));
+    const r = await validator.validate({ dataset: data });
+    return { conforms: r.conforms, messages: r.results.flatMap((x) => (Array.isArray(x.message) ? x.message.map((m) => m.value) : [])) };
+}
+//# sourceMappingURL=shacl.js.map

package/dist/shacl.js.map

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

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@agenticprimitives/provenance-node",
+  "version": "0.0.0-alpha.1",
+  "description": "Node-side reference bindings of the provenance ports (spec 414 §5): the W3C RDFC-1.0 canonicalizer, SHACL validation over the published run shapes, a directory store, and the `ap conform provenance` suite (C1–C6) any binding is run through.",
+  "homepage": "https://agenticprimitives.dev",
+  "bugs": {
+    "url": "https://github.com/agentictrustlabs/agenticprimitives/issues"
+  },
+  "author": {
+    "name": "Agentic Trust Labs",
+    "url": "https://agenticprimitives.dev"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agentictrustlabs/agenticprimitives.git",
+    "directory": "packages/provenance-node"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./conform": {
+      "types": "./dist/conform.d.ts",
+      "import": "./dist/conform.js"
+    }
+  },
+  "files": [
+    "LICENSE",
+    "dist",
+    "spec.md",
+    "README.md"
+  ],
+  "dependencies": {
+    "@zazuko/env-node": "^2.1.1",
+    "shacl-engine": "^1.1.2",
+    "@agenticprimitives/evaluation": "0.0.0-alpha.4",
+    "@agenticprimitives/ontology": "1.0.0-alpha.26",
+    "@agenticprimitives/provenance": "0.0.0-alpha.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.7.0",
+    "vitest": "^4.1.8"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "agentic",
+    "primitives",
+    "provenance",
+    "prov-o",
+    "rdfc",
+    "shacl",
+    "conformance",
+    "agenticprimitives"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:unit": "vitest run test/unit --passWithNoTests",
+    "clean": "rm -rf dist"
+  }
+}

package/spec.md

@@ -0,0 +1,7 @@
+# @agenticprimitives/provenance-node — package spec
+
+Spec of record: [specs/414-tracing-as-the-record-and-skill-effectiveness.md](../../specs/414-tracing-as-the-record-and-skill-effectiveness.md)
+§5 (ports and bindings) and §6 (conformance), sequenced by [specs/415-skills-assessment-program.md](../../specs/415-skills-assessment-program.md) A2d.
+
+Owns the Node-side reference bindings (RDFC-1.0, SHACL, a directory store) and the conformance suite C1–C6. Does not own
+the ports or the digest (`provenance`), the shapes or the T-box (`ontology`), or the measurements and rollup (`evaluation`).