@cendor/acttrace 0.2.0

package/dist/pyjson.js

@@ -0,0 +1,250 @@
+/**
+ * Python-`json`-compatible serialization + a number-preserving parser — the cross-language
+ * conformance backbone shared (vendored) by @cendor/cassette and @cendor/acttrace.
+ *
+ * Reproduces `json.dumps(..., ensure_ascii=False)` byte-for-byte for Cendor's value shapes:
+ *  - strings/bools/null: via `JSON.stringify` (JS matches Python's ensure_ascii=False escaping —
+ *    same control-char escapes, `/` unescaped, non-ASCII raw, U+2028/U+2029 raw).
+ *  - integers: `bigint` (or an integer-valued producer `number`) -> decimal string (no `.0`, no exp).
+ *  - floats: `PyFloat` wrapper (or a non-integer producer `number`) -> Python `repr(float)` form.
+ *
+ * The int/float distinction is the #1 hazard: `JSON.parse` collapses `2.0` and `2`. So the VERIFIER
+ * side must parse with {@link parsePreserving} (tags each number token int vs float from its literal).
+ * The PRODUCER side builds payloads with plain numbers; integer-valued numbers serialize as ints
+ * (self-consistent and Python-verifiable — Python re-reads `"12"` as int too).
+ */
+export class PyFloat {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+}
+/** Python `repr(float)`-compatible string (exact for finite non-exponential values; best-effort exp). */
+export function pyFloatRepr(n) {
+    if (Number.isNaN(n))
+        return 'NaN';
+    if (n === Number.POSITIVE_INFINITY)
+        return 'Infinity';
+    if (n === Number.NEGATIVE_INFINITY)
+        return '-Infinity';
+    let s = n.toString();
+    if (s.includes('e') || s.includes('E')) {
+        const m = s.match(/^(-?)(\d+(?:\.\d+)?)[eE]([+-]?)(\d+)$/);
+        if (m) {
+            const sign = m[1] ?? '';
+            const mant = m[2] ?? '';
+            const esign = m[3] === '-' ? '-' : '+';
+            const edig = m[4] ?? '';
+            s = `${sign}${mant}e${esign}${edig.length < 2 ? `0${edig}` : edig}`;
+        }
+        return s;
+    }
+    if (!s.includes('.'))
+        s += '.0';
+    return s;
+}
+function numberToken(v) {
+    if (typeof v === 'bigint')
+        return v.toString();
+    if (v instanceof PyFloat)
+        return pyFloatRepr(v.value);
+    if (Number.isInteger(v))
+        return Number.isSafeInteger(v) ? BigInt(v).toString() : v.toString();
+    return pyFloatRepr(v);
+}
+/** Sort by Unicode code point (Python `sort_keys`), not UTF-16 code unit. */
+function codePointCompare(a, b) {
+    const ia = Array.from(a);
+    const ib = Array.from(b);
+    const n = Math.min(ia.length, ib.length);
+    for (let i = 0; i < n; i++) {
+        const ca = ia[i].codePointAt(0);
+        const cb = ib[i].codePointAt(0);
+        if (ca !== cb)
+            return ca - cb;
+    }
+    return ia.length - ib.length;
+}
+function serialize(v, opts, depth) {
+    if (v === null)
+        return 'null';
+    if (typeof v === 'boolean')
+        return v ? 'true' : 'false';
+    if (typeof v === 'string')
+        return JSON.stringify(v);
+    if (typeof v === 'number' || typeof v === 'bigint' || v instanceof PyFloat)
+        return numberToken(v);
+    const pad = opts.indent !== null ? `\n${' '.repeat(opts.indent * (depth + 1))}` : '';
+    const padEnd = opts.indent !== null ? `\n${' '.repeat(opts.indent * depth)}` : '';
+    const itemSep = opts.indent !== null ? `,${pad}` : opts.compact ? ',' : ', ';
+    const kvSep = opts.compact ? ':' : ': ';
+    if (Array.isArray(v)) {
+        if (v.length === 0)
+            return '[]';
+        const items = v.map((x) => serialize(x, opts, depth + 1));
+        return `[${pad}${items.join(itemSep)}${padEnd}]`;
+    }
+    let keys = Object.keys(v);
+    if (opts.sortKeys)
+        keys = keys.sort(codePointCompare);
+    if (keys.length === 0)
+        return '{}';
+    const items = keys.map((k) => `${JSON.stringify(k)}${kvSep}${serialize(v[k], opts, depth + 1)}`);
+    return `{${pad}${items.join(itemSep)}${padEnd}}`;
+}
+/** `json.dumps(obj, sort_keys=True, ensure_ascii=False, separators=(",",":"))` — the HASH input. */
+export function canonical(v) {
+    return serialize(v, { sortKeys: true, indent: null, compact: true }, 0);
+}
+/** `json.dumps(obj, ensure_ascii=False)` — insertion order, spaces after `,`/`:` (acttrace JSONL). */
+export function dumpsDefault(v) {
+    return serialize(v, { sortKeys: false, indent: null, compact: false }, 0);
+}
+/** `json.dumps(obj, indent=2, ensure_ascii=False)` — insertion order, 2-space indent (cassette file). */
+export function dumpsIndent2(v) {
+    return serialize(v, { sortKeys: false, indent: 2, compact: false }, 0);
+}
+// --------------------------------------------------------------------------- number-preserving parse
+class PreservingParser {
+    s;
+    i = 0;
+    constructor(s) {
+        this.s = s;
+    }
+    parse() {
+        this.ws();
+        const v = this.value();
+        this.ws();
+        if (this.i !== this.s.length)
+            throw new SyntaxError(`trailing content at ${this.i}`);
+        return v;
+    }
+    ws() {
+        while (this.i < this.s.length) {
+            const c = this.s.charCodeAt(this.i);
+            if (c === 0x20 || c === 0x09 || c === 0x0a || c === 0x0d)
+                this.i++;
+            else
+                break;
+        }
+    }
+    value() {
+        const c = this.s[this.i];
+        if (c === '{')
+            return this.object();
+        if (c === '[')
+            return this.array();
+        if (c === '"')
+            return this.string();
+        if (c === '-' || (c !== undefined && c >= '0' && c <= '9'))
+            return this.number();
+        if (this.s.startsWith('true', this.i)) {
+            this.i += 4;
+            return true;
+        }
+        if (this.s.startsWith('false', this.i)) {
+            this.i += 5;
+            return false;
+        }
+        if (this.s.startsWith('null', this.i)) {
+            this.i += 4;
+            return null;
+        }
+        throw new SyntaxError(`unexpected '${c}' at ${this.i}`);
+    }
+    object() {
+        const o = {};
+        this.i++;
+        this.ws();
+        if (this.s[this.i] === '}') {
+            this.i++;
+            return o;
+        }
+        for (;;) {
+            this.ws();
+            const k = this.string();
+            this.ws();
+            if (this.s[this.i] !== ':')
+                throw new SyntaxError(`expected ':' at ${this.i}`);
+            this.i++;
+            this.ws();
+            o[k] = this.value();
+            this.ws();
+            const ch = this.s[this.i];
+            if (ch === ',') {
+                this.i++;
+                continue;
+            }
+            if (ch === '}') {
+                this.i++;
+                return o;
+            }
+            throw new SyntaxError(`expected ',' or '}' at ${this.i}`);
+        }
+    }
+    array() {
+        const a = [];
+        this.i++;
+        this.ws();
+        if (this.s[this.i] === ']') {
+            this.i++;
+            return a;
+        }
+        for (;;) {
+            this.ws();
+            a.push(this.value());
+            this.ws();
+            const ch = this.s[this.i];
+            if (ch === ',') {
+                this.i++;
+                continue;
+            }
+            if (ch === ']') {
+                this.i++;
+                return a;
+            }
+            throw new SyntaxError(`expected ',' or ']' at ${this.i}`);
+        }
+    }
+    string() {
+        if (this.s[this.i] !== '"')
+            throw new SyntaxError(`expected string at ${this.i}`);
+        const start = this.i;
+        this.i++;
+        for (;;) {
+            const c = this.s[this.i++];
+            if (c === undefined)
+                throw new SyntaxError('unterminated string');
+            if (c === '"')
+                break;
+            if (c === '\\')
+                this.i++;
+        }
+        // Reuse JSON.parse for exact unescaping (inverse of JSON.stringify).
+        return JSON.parse(this.s.slice(start, this.i));
+    }
+    number() {
+        const start = this.i;
+        if (this.s[this.i] === '-')
+            this.i++;
+        let isFloat = false;
+        while (this.i < this.s.length) {
+            const c = this.s[this.i];
+            if (c >= '0' && c <= '9')
+                this.i++;
+            else if (c === '.' || c === 'e' || c === 'E' || c === '+' || c === '-') {
+                isFloat = isFloat || c === '.' || c === 'e' || c === 'E';
+                this.i++;
+            }
+            else
+                break;
+        }
+        const token = this.s.slice(start, this.i);
+        return isFloat ? new PyFloat(Number(token)) : BigInt(token);
+    }
+}
+/** Parse JSON preserving int (`bigint`) vs float ({@link PyFloat}) from each numeric literal. */
+export function parsePreserving(text) {
+    return new PreservingParser(text).parse();
+}
+//# sourceMappingURL=pyjson.js.map

package/dist/pyjson.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,17 @@
+/** A tamper-evident-chain backend: truncate-open, append durable lines, and re-read the full chain. */
+export interface ChainStorage {
+    appendLine(line: string): void;
+    readLines(): string[];
+    close(): void;
+}
+/** In-memory chain storage (browser/tests). */
+export declare function memoryChainStorage(): ChainStorage;
+/**
+ * Filesystem chain storage (the Node default): truncate-open on creation, `write`+`fsync` each line
+ * for durability, re-read the full chain from disk on demand (so a bounded in-memory log can still
+ * export/verify the complete file).
+ */
+export declare function fsChainStorage(path: string): ChainStorage;
+/** Read all non-empty lines from a path (for `verify()` / CLI). */
+export declare function fsReadLines(path: string): string[];
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAUA,uGAAuG;AACvG,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,IAAI,MAAM,EAAE,CAAC;IACtB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,+CAA+C;AAC/C,wBAAgB,kBAAkB,IAAI,YAAY,CASjD;AA0BD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CA2BzD;AAED,mEAAmE;AACnE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAIlD"}

package/dist/storage.js

@@ -0,0 +1,71 @@
+/**
+ * Pluggable acttrace chain storage. Core logic uses the {@link ChainStorage} interface; the fs
+ * adapter lazily requires `node:fs` so importing the package never forces Node built-ins into a
+ * bundle. acttrace is server-side (signing keys never belong in a browser), so fs + memory are the
+ * shipped adapters; a Workers-KV/other backend can implement the same interface.
+ */
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+/** In-memory chain storage (browser/tests). */
+export function memoryChainStorage() {
+    const lines = [];
+    return {
+        appendLine: (line) => {
+            lines.push(line);
+        },
+        readLines: () => lines.map((l) => l.replace(/\n$/, '')),
+        close: () => { },
+    };
+}
+let fs;
+let pathMod;
+function nodeFs() {
+    if (fs === undefined)
+        fs = require('node:fs');
+    return fs;
+}
+function nodePath() {
+    if (pathMod === undefined)
+        pathMod = require('node:path');
+    return pathMod;
+}
+/**
+ * Filesystem chain storage (the Node default): truncate-open on creation, `write`+`fsync` each line
+ * for durability, re-read the full chain from disk on demand (so a bounded in-memory log can still
+ * export/verify the complete file).
+ */
+export function fsChainStorage(path) {
+    nodeFs().mkdirSync(nodePath().dirname(path), { recursive: true });
+    let fd = nodeFs().openSync(path, 'w');
+    return {
+        appendLine: (line) => {
+            if (fd === null) {
+                // handle closed: append-open, write, close (matches the reference fallback)
+                const f = nodeFs().openSync(path, 'a');
+                nodeFs().writeSync(f, line);
+                nodeFs().fsyncSync(f);
+                nodeFs().closeSync(f);
+                return;
+            }
+            nodeFs().writeSync(fd, line);
+            nodeFs().fsyncSync(fd);
+        },
+        readLines: () => {
+            const text = nodeFs().existsSync(path) ? nodeFs().readFileSync(path, 'utf8') : '';
+            return text.split('\n').filter((l) => l.length > 0);
+        },
+        close: () => {
+            if (fd !== null) {
+                nodeFs().closeSync(fd);
+                fd = null;
+            }
+        },
+    };
+}
+/** Read all non-empty lines from a path (for `verify()` / CLI). */
+export function fsReadLines(path) {
+    const f = require('node:fs');
+    const text = f.readFileSync(path, 'utf8');
+    return text.split('\n');
+}
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@cendor/acttrace",
+  "version": "0.2.0",
+  "description": "A tamper-evident, auto-populated audit log for AI decisions. The TypeScript port of cendor.acttrace (regex/pattern detectors only).",
+  "type": "module",
+  "license": "Apache-2.0",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./storage": {
+      "types": "./dist/storage.d.ts",
+      "default": "./dist/storage.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@cendor/core": "^0.2.0"
+  },
+  "keywords": [
+    "llm",
+    "audit",
+    "governance",
+    "eu-ai-act",
+    "tamper-evident",
+    "cendor"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cendorhq/cendor-libs-js.git",
+    "directory": "packages/acttrace"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}