simfile 0.0.1

package/dist/coverage/matrix.js

@@ -0,0 +1,173 @@
+export const systemViewTopLevelKeys = [
+    "simfile_version",
+    "name",
+    "spawnfile",
+    "clock",
+    "variables",
+    "generators",
+    "rules",
+    "ledger",
+    "telemetry",
+    "markers",
+    "probes"
+];
+export const coveragePrimitives = [
+    "clock",
+    "variables",
+    "generators",
+    "rules",
+    "ledger",
+    "telemetry",
+    "markers/probes"
+];
+export const matrix = [
+    // Frozen top-level rows.
+    {
+        subject: { kind: "top-level", key: "simfile_version" },
+        claim: 'Top-level `simfile_version` is structurally validated as `"0.1"`.',
+        specRef: "docs/SYSTEMS_VIEW.md#every-top-level-key",
+        status: "implemented",
+        evidence: "src/schema/model.ts"
+    },
+    {
+        subject: { kind: "top-level", key: "name" },
+        claim: "Top-level `name` is structurally validated as a Simfile identifier.",
+        specRef: "docs/SYSTEMS_VIEW.md#every-top-level-key",
+        status: "implemented",
+        evidence: "src/schema/parse.test.ts"
+    },
+    {
+        subject: { kind: "top-level", key: "spawnfile" },
+        claim: "Top-level `spawnfile` is parsed as an optional source pointer.",
+        specRef: "docs/SYSTEMS_VIEW.md#every-top-level-key",
+        status: "implemented",
+        evidence: "src/schema/model.ts"
+    },
+    {
+        subject: { kind: "top-level", key: "clock" },
+        claim: "Top-level `clock` is structurally parsed and required.",
+        specRef: "docs/SYSTEMS_VIEW.md#every-top-level-key",
+        status: "implemented",
+        evidence: "src/schema/parse.test.ts"
+    },
+    {
+        subject: { kind: "top-level", key: "variables" },
+        claim: "Top-level `variables` is structurally parsed as an id-keyed map.",
+        specRef: "docs/SYSTEMS_VIEW.md#every-top-level-key",
+        status: "implemented",
+        evidence: "src/schema/parse.test.ts"
+    },
+    {
+        subject: { kind: "top-level", key: "generators" },
+        claim: "Top-level `generators` is structurally parsed as an id-keyed map.",
+        specRef: "docs/SYSTEMS_VIEW.md#every-top-level-key",
+        status: "implemented",
+        evidence: "src/schema/parse.test.ts"
+    },
+    {
+        subject: { kind: "top-level", key: "rules" },
+        claim: "Top-level `rules` is structurally parsed as an id-keyed map.",
+        specRef: "docs/SYSTEMS_VIEW.md#every-top-level-key",
+        status: "implemented",
+        evidence: "src/schema/parse.test.ts"
+    },
+    {
+        subject: { kind: "top-level", key: "ledger" },
+        claim: "Top-level `ledger` storage configuration is structurally parsed.",
+        specRef: "docs/SYSTEMS_VIEW.md#every-top-level-key",
+        status: "implemented",
+        evidence: "src/schema/parse.test.ts"
+    },
+    {
+        subject: { kind: "top-level", key: "telemetry" },
+        claim: "Top-level `telemetry` snapshot configuration is structurally parsed.",
+        specRef: "docs/SYSTEMS_VIEW.md#every-top-level-key",
+        status: "implemented",
+        evidence: "src/runtime/run-record.test.ts"
+    },
+    {
+        subject: { kind: "top-level", key: "markers" },
+        claim: "Top-level `markers` is parsed and evaluated against trace events.",
+        specRef: "docs/SYSTEMS_VIEW.md#every-top-level-key",
+        status: "implemented",
+        evidence: "src/ledger/markers.test.ts"
+    },
+    {
+        subject: { kind: "top-level", key: "probes" },
+        claim: "Top-level `probes` is parsed and evaluated against trace artifacts.",
+        specRef: "docs/SYSTEMS_VIEW.md#every-top-level-key",
+        status: "implemented",
+        evidence: "src/report/probes.test.ts"
+    },
+    // Frozen primitive rows.
+    {
+        subject: { kind: "primitive", primitive: "clock" },
+        claim: "Clock duration, simulated time, phases, and tick resolution execute deterministically.",
+        specRef: "docs/DESIGN.md#clock",
+        status: "implemented",
+        evidence: "src/runtime/trace.test.ts"
+    },
+    {
+        subject: { kind: "primitive", primitive: "variables" },
+        claim: "Driven and derived numeric variables execute with range clamping.",
+        specRef: "docs/DESIGN.md#variables",
+        status: "implemented",
+        evidence: "src/runtime/trace.test.ts"
+    },
+    {
+        subject: { kind: "primitive", primitive: "variables" },
+        claim: "Measured and instrument-fed variables execute at tick boundaries.",
+        specRef: "docs/DESIGN.md#variables",
+        status: "deferred",
+        evidence: "src/runtime/trace-compile.ts"
+    },
+    {
+        subject: { kind: "primitive", primitive: "generators" },
+        claim: "Deterministic and seeded stochastic generators execute reproducibly.",
+        specRef: "docs/DESIGN.md#generators",
+        status: "implemented",
+        evidence: "src/runtime/trace.test.ts"
+    },
+    {
+        subject: { kind: "primitive", primitive: "rules" },
+        claim: "Conditions, crossing modes, variable effects, speech, DM, and wake actions execute.",
+        specRef: "docs/DESIGN.md#rules",
+        status: "implemented",
+        evidence: "src/runtime/trace.test.ts"
+    },
+    {
+        subject: { kind: "primitive", primitive: "ledger" },
+        claim: "Canonical event envelopes and byte-identical JSONL exports are implemented.",
+        specRef: "docs/DESIGN.md#events-and-ledger",
+        status: "implemented",
+        evidence: "src/runtime/run-record.test.ts"
+    },
+    {
+        subject: { kind: "primitive", primitive: "ledger" },
+        claim: "SQLite and PostgreSQL ledger persistence are available as runtime backends.",
+        specRef: "docs/SYSTEMS_VIEW.md#ledger",
+        status: "deferred",
+        evidence: "src/runtime/run-record.ts"
+    },
+    {
+        subject: { kind: "primitive", primitive: "telemetry" },
+        claim: "Snapshot cadence produces a deterministic telemetry artifact.",
+        specRef: "docs/SYSTEMS_VIEW.md#telemetry--markers",
+        status: "implemented",
+        evidence: "src/runtime/run-record.test.ts"
+    },
+    {
+        subject: { kind: "primitive", primitive: "markers/probes" },
+        claim: "Containment and propagation marker scanning and verdicts are implemented.",
+        specRef: "docs/SYSTEMS_VIEW.md#telemetry--markers",
+        status: "implemented",
+        evidence: "src/ledger/markers.test.ts"
+    },
+    {
+        subject: { kind: "primitive", primitive: "markers/probes" },
+        claim: "Probe expectations and bounded `after` plus `within` evaluation are implemented.",
+        specRef: "docs/DESIGN.md#probes",
+        status: "implemented",
+        evidence: "src/report/probes.test.ts"
+    }
+];

package/dist/coverage/render.d.ts

@@ -0,0 +1,3 @@
+import type { CoverageRow } from "./matrix.js";
+export declare const renderCoverageMarkdown: (rows: readonly CoverageRow[]) => string;
+//# sourceMappingURL=render.d.ts.map

package/dist/coverage/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/coverage/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAmB,MAAM,aAAa,CAAC;AA+BhE,eAAO,MAAM,sBAAsB,GAAI,MAAM,SAAS,WAAW,EAAE,KAAG,MAKrE,CAAC"}

package/dist/coverage/render.js

@@ -0,0 +1,26 @@
+const GENERATED_HEADER = [
+    "# Simfile Coverage",
+    "",
+    "> Generated from `src/coverage/matrix.ts`. Run `npm run coverage:render` after changing the manifest.",
+    "",
+    "This matrix uses the seven audit buckets requested by B40. In `docs/DESIGN.md`, telemetry and markers are configuration, probes are a primitive, and entity lifecycle is the dormant seventh design primitive.",
+    ""
+].join("\n");
+const TABLE_HEADER = ["| Subject | Claim | Spec | Status | Evidence |", "|---|---|---|---|---|"].join("\n");
+const escapeCell = (value) => value.replace(/\r?\n/gu, " ").replace(/\|/gu, "\\|").trim();
+const formatSubject = (subject) => subject.kind === "top-level" ? `top-level · \`${subject.key}\`` : `primitive · \`${subject.primitive}\``;
+const formatRow = (row) => {
+    const cells = [
+        formatSubject(row.subject),
+        escapeCell(row.claim),
+        `\`${escapeCell(row.specRef)}\``,
+        `\`${escapeCell(row.status)}\``,
+        `\`${escapeCell(row.evidence)}\``
+    ];
+    return `| ${cells.join(" | ")} |`;
+};
+export const renderCoverageMarkdown = (rows) => {
+    const tableRows = rows.map(formatRow);
+    const body = [GENERATED_HEADER, TABLE_HEADER, ...tableRows].join("\n");
+    return `${body.replace(/\n+$/u, "")}\n`;
+};

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./schema/index.js";
+export * from "./kernel/index.js";
+export * from "./ledger/index.js";
+export * from "./moltnet/index.js";
+export * from "./report/index.js";
+export * from "./runtime/trace.js";
+export * from "./coverage/index.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":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./schema/index.js";
+export * from "./kernel/index.js";
+export * from "./ledger/index.js";
+export * from "./moltnet/index.js";
+export * from "./report/index.js";
+export * from "./runtime/trace.js";
+export * from "./coverage/index.js";

package/dist/kernel/duration.d.ts

@@ -0,0 +1,9 @@
+export interface ParsedDuration {
+    value: number;
+    unit: "ms" | "s" | "m" | "h" | "d" | "w";
+    milliseconds: number;
+}
+export declare const parseDurationMs: (input: string) => number;
+export declare const parseDuration: (input: string) => ParsedDuration;
+export declare const parseDurationSeconds: (input: string) => number;
+//# sourceMappingURL=duration.d.ts.map

package/dist/kernel/duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../src/kernel/duration.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACzC,YAAY,EAAE,MAAM,CAAC;CACtB;AAQD,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,MAc/C,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,KAAG,cAe7C,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,KAAG,MAEpD,CAAC"}

package/dist/kernel/duration.js

@@ -0,0 +1,44 @@
+const DURATION_PATTERN = /^(-?(?:0|(?:[1-9][0-9]*))(?:\.[0-9]+)?)\s*(ms|s|m|h|d|w)$/u;
+const MILLIS_PER = {
+    ms: 1,
+    s: 1_000,
+    m: 60_000,
+    h: 3_600_000,
+    d: 86_400_000,
+    w: 604_800_000
+};
+const assertFinitePositive = (value) => {
+    if (!Number.isFinite(value)) {
+        throw new Error("duration must be a finite number");
+    }
+};
+export const parseDurationMs = (input) => {
+    const match = input.trim().match(DURATION_PATTERN);
+    if (!match) {
+        throw new Error(`invalid duration literal: ${input}`);
+    }
+    const raw = Number.parseFloat(match[1]);
+    assertFinitePositive(raw);
+    if (raw < 0) {
+        throw new Error(`duration must be non-negative: ${input}`);
+    }
+    const unit = match[2];
+    return raw * MILLIS_PER[unit];
+};
+export const parseDuration = (input) => {
+    const match = input.trim().match(DURATION_PATTERN);
+    if (!match) {
+        throw new Error(`invalid duration literal: ${input}`);
+    }
+    const value = Number.parseFloat(match[1]);
+    assertFinitePositive(value);
+    if (value < 0) {
+        throw new Error(`duration must be non-negative: ${input}`);
+    }
+    const unit = match[2];
+    const milliseconds = value * MILLIS_PER[unit];
+    return { value, unit, milliseconds };
+};
+export const parseDurationSeconds = (input) => {
+    return parseDurationMs(input) / 1_000;
+};

package/dist/kernel/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./duration.js";
+export * from "./range.js";
+export * from "./stochastic.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/kernel/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/kernel/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/kernel/index.js

@@ -0,0 +1,3 @@
+export * from "./duration.js";
+export * from "./range.js";
+export * from "./stochastic.js";

package/dist/kernel/range.d.ts

@@ -0,0 +1,6 @@
+export interface ParsedRange {
+    min: number;
+    max: number;
+}
+export declare const parseRange: (input: string) => ParsedRange;
+//# sourceMappingURL=range.d.ts.map

package/dist/kernel/range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../src/kernel/range.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,WAgB1C,CAAC"}

package/dist/kernel/range.js

@@ -0,0 +1,16 @@
+const RANGE_PATTERN = /^(-?(?:0|(?:[1-9][0-9]*))(?:\.[0-9]+)?)\s*\.\.\s*(-?(?:0|(?:[1-9][0-9]*))(?:\.[0-9]+)?)$/u;
+export const parseRange = (input) => {
+    const match = input.trim().match(RANGE_PATTERN);
+    if (!match) {
+        throw new Error(`invalid range literal: ${input}`);
+    }
+    const min = Number.parseFloat(match[1]);
+    const max = Number.parseFloat(match[2]);
+    if (!Number.isFinite(min) || !Number.isFinite(max)) {
+        throw new Error(`invalid range bounds: ${input}`);
+    }
+    if (min >= max) {
+        throw new Error(`range lower bound must be smaller than upper bound: ${input}`);
+    }
+    return { min, max };
+};

package/dist/kernel/stochastic.d.ts

@@ -0,0 +1,10 @@
+export interface UniformDrawInput {
+    runSeed: string;
+    generatorId: string;
+    tick: number;
+    drawIndex: number;
+    min: number;
+    max: number;
+}
+export declare const drawUniform: ({ runSeed, generatorId, tick, drawIndex, min, max }: UniformDrawInput) => number;
+//# sourceMappingURL=stochastic.d.ts.map

package/dist/kernel/stochastic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stochastic.d.ts","sourceRoot":"","sources":["../../src/kernel/stochastic.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAUD,eAAO,MAAM,WAAW,GAAI,qDAOzB,gBAAgB,KAAG,MAiBrB,CAAC"}

package/dist/kernel/stochastic.js

@@ -0,0 +1,25 @@
+import { createHash } from "node:crypto";
+const TWO_POW_53 = 2 ** 53;
+const normalizeSeed = (value) => value.trim();
+const sampleUnitInterval = (input) => {
+    const digest = createHash("sha256").update(input, "utf8").digest();
+    const value = Number(digest.readBigUInt64BE(0) >> 11n) / TWO_POW_53;
+    return value;
+};
+export const drawUniform = ({ runSeed, generatorId, tick, drawIndex, min, max }) => {
+    if (!Number.isFinite(tick) || !Number.isInteger(tick) || tick < 0) {
+        throw new Error(`tick must be a non-negative integer: ${tick}`);
+    }
+    if (!Number.isFinite(drawIndex) || !Number.isInteger(drawIndex) || drawIndex < 0) {
+        throw new Error(`drawIndex must be a non-negative integer: ${drawIndex}`);
+    }
+    if (!Number.isFinite(min) || !Number.isFinite(max)) {
+        throw new Error("distribution bounds must be finite numbers");
+    }
+    if (max < min) {
+        throw new Error(`max must be >= min: ${min}..${max}`);
+    }
+    const key = `${normalizeSeed(runSeed)}:${normalizeSeed(generatorId)}:${tick}:${drawIndex}`;
+    const unitValue = sampleUnitInterval(key);
+    return min + (max - min) * unitValue;
+};

package/dist/ledger/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./markers.js";
+export * from "./stable.js";
+export * from "./validation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/ledger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ledger/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/dist/ledger/index.js

@@ -0,0 +1,3 @@
+export * from "./markers.js";
+export * from "./stable.js";
+export * from "./validation.js";

package/dist/ledger/markers.d.ts

@@ -0,0 +1,46 @@
+export interface LedgerEvent {
+    event_id?: string;
+    kind: string;
+    sim_time?: number;
+    actor?: string;
+    target?: string;
+    scope?: string;
+    payload?: unknown;
+}
+export interface MarkerDefinition {
+    text?: string[];
+    mode: "containment" | "propagation";
+    scopes: string[];
+}
+export interface MarkerHit {
+    markerId: string;
+    eventId: string;
+    eventKind: string;
+    scope: string;
+    simTime: number;
+    alias: string;
+}
+export interface MarkerScanResult {
+    markerId: string;
+    hits: MarkerHit[];
+}
+export interface MarkerCoverageResult {
+    markerId: string;
+    mode: "containment" | "propagation";
+    passed: boolean;
+    evidence: string[];
+    detail: string;
+}
+/** Exported for reuse by `../observe/spreadMatcher.ts`'s exact matcher: the same
+ * word-boundary, case-insensitive alias check `scanMarker` uses internally,
+ * applied directly to already-joined content strings (transcript messages,
+ * mneme bank content, recalled memory content) rather than `LedgerEvent`s. */
+export declare const containsAlias: (payload: string, alias: string) => boolean;
+export declare const scanMarker: (events: readonly LedgerEvent[], markerId: string, marker: MarkerDefinition) => MarkerScanResult;
+export declare const scanMarkers: (events: readonly LedgerEvent[], markers: Record<string, MarkerDefinition>) => Record<string, MarkerHit[]>;
+export declare const evaluateContainmentMarker: (markerId: string, marker: MarkerDefinition, hits: readonly MarkerHit[]) => MarkerCoverageResult;
+export interface EvaluatePropagationOptions {
+    requireAllScopes?: boolean;
+}
+export declare const evaluatePropagationMarker: (markerId: string, marker: MarkerDefinition, hits: readonly MarkerHit[], options?: EvaluatePropagationOptions) => MarkerCoverageResult;
+//# sourceMappingURL=markers.d.ts.map

package/dist/ledger/markers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markers.d.ts","sourceRoot":"","sources":["../../src/ledger/markers.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,aAAa,GAAG,aAAa,CAAC;IACpC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,SAAS,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,aAAa,GAAG,aAAa,CAAC;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAWD;;;8EAG8E;AAC9E,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,EAAE,OAAO,MAAM,KAAG,OAI9D,CAAC;AAiCF,eAAO,MAAM,UAAU,GACrB,QAAQ,SAAS,WAAW,EAAE,EAC9B,UAAU,MAAM,EAChB,QAAQ,gBAAgB,KACvB,gBAoCF,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,QAAQ,SAAS,WAAW,EAAE,EAC9B,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,KACxC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAO5B,CAAC;AAIF,eAAO,MAAM,yBAAyB,GACpC,UAAU,MAAM,EAChB,QAAQ,gBAAgB,EACxB,MAAM,SAAS,SAAS,EAAE,KACzB,oBAaF,CAAC;AAEF,MAAM,WAAW,0BAA0B;IACzC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,eAAO,MAAM,yBAAyB,GACpC,UAAU,MAAM,EAChB,QAAQ,gBAAgB,EACxB,MAAM,SAAS,SAAS,EAAE,EAC1B,UAAS,0BAA+B,KACvC,oBAiBF,CAAC"}

package/dist/ledger/markers.js

@@ -0,0 +1,108 @@
+const normalizeAlias = (text) => text.trim().toLocaleLowerCase();
+const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+/** Exported for reuse by `../observe/spreadMatcher.ts`'s exact matcher: the same
+ * word-boundary, case-insensitive alias check `scanMarker` uses internally,
+ * applied directly to already-joined content strings (transcript messages,
+ * mneme bank content, recalled memory content) rather than `LedgerEvent`s. */
+export const containsAlias = (payload, alias) => {
+    const boundary = "(?<![\\p{L}\\p{N}_])";
+    const endBoundary = "(?![\\p{L}\\p{N}_])";
+    return new RegExp(`${boundary}${escapeRegExp(alias)}${endBoundary}`, "iu").test(payload);
+};
+const extractTextCandidates = (payload) => {
+    if (typeof payload === "string") {
+        return [payload];
+    }
+    if (!payload || typeof payload !== "object") {
+        return [];
+    }
+    const record = payload;
+    const fields = ["content", "text", "message", "body"];
+    const values = fields
+        .map((field) => record[field])
+        .filter((entry) => typeof entry === "string");
+    if (values.length > 0) {
+        return values;
+    }
+    if (typeof record.content === "object" && record.content !== null && "text" in record.content) {
+        const nested = record.content.text;
+        if (typeof nested === "string") {
+            return [nested];
+        }
+    }
+    return [];
+};
+const eventScope = (event) => event.scope ?? event.target ?? "global";
+const eventIdForHit = (event, fallback) => event.event_id ?? fallback;
+export const scanMarker = (events, markerId, marker) => {
+    const aliases = (marker.text && marker.text.length > 0 ? marker.text : [markerId]).map(normalizeAlias);
+    const hits = new Map();
+    for (let index = 0; index < events.length; index += 1) {
+        const event = events[index];
+        const payloadText = extractTextCandidates(event.payload).join(" ");
+        const lowerPayload = payloadText.toLocaleLowerCase();
+        const matchedAlias = aliases.find((alias) => containsAlias(lowerPayload, alias));
+        if (!matchedAlias) {
+            continue;
+        }
+        const normalized = {
+            eventId: eventIdForHit(event, `index:${index}`),
+            scope: eventScope(event)
+        };
+        const key = normalized.eventId;
+        if (hits.has(key)) {
+            continue;
+        }
+        hits.set(key, {
+            markerId,
+            eventId: normalized.eventId,
+            eventKind: event.kind,
+            scope: normalized.scope,
+            simTime: event.sim_time ?? 0,
+            alias: matchedAlias
+        });
+    }
+    return {
+        markerId,
+        hits: [...hits.values()]
+    };
+};
+export const scanMarkers = (events, markers) => {
+    const output = {};
+    for (const [markerId, marker] of Object.entries(markers)) {
+        const result = scanMarker(events, markerId, marker);
+        output[markerId] = result.hits;
+    }
+    return output;
+};
+const withinScope = (scope, scopes) => scopes.includes(scope);
+export const evaluateContainmentMarker = (markerId, marker, hits) => {
+    const inScope = hits.filter((hit) => withinScope(hit.scope, marker.scopes));
+    const outOfScope = hits.filter((hit) => !withinScope(hit.scope, marker.scopes));
+    const passed = inScope.length > 0 && outOfScope.length === 0;
+    return {
+        markerId,
+        mode: "containment",
+        passed,
+        evidence: hits.map((hit) => hit.eventId),
+        detail: passed
+            ? "contained marker stayed within declared scopes"
+            : "marker violated containment policy"
+    };
+};
+export const evaluatePropagationMarker = (markerId, marker, hits, options = {}) => {
+    const inScope = hits.filter((hit) => withinScope(hit.scope, marker.scopes));
+    const required = options.requireAllScopes === true;
+    const passed = required
+        ? marker.scopes.every((scope) => inScope.some((hit) => hit.scope === scope))
+        : inScope.length > 0;
+    return {
+        markerId,
+        mode: "propagation",
+        passed,
+        evidence: inScope.map((hit) => hit.eventId),
+        detail: passed
+            ? "marker reached required propagation scope(s)"
+            : "marker did not reach required propagation scope(s)"
+    };
+};

package/dist/ledger/stable.d.ts

@@ -0,0 +1,65 @@
+export type Provenance = "mechanical" | "agentic" | "external";
+/**
+ * Causal envelope constants shared with `specs/causal-event.v1.schema.json`
+ * (root, canonical) and `specs/CAUSAL.md`. Simfile does not import that
+ * schema file directly — this is simfile's own native TS copy of the wire
+ * contract, per the "type sharing" rule: siblings do not vendor the schema,
+ * they each hand-write a native type and stay conformant with the wire JSON.
+ */
+export declare const CAUSAL_ENVELOPE_VERSION: "noopolis.causal-event.v1";
+export declare const SIMFILE_EMITTER_SYSTEM: "simfile";
+export declare const DEFAULT_EMITTER_STREAM_ID: "world";
+export declare const DEFAULT_PRINCIPAL_ID: "system:simfile.world";
+export interface CausalEmitter {
+    system: typeof SIMFILE_EMITTER_SYSTEM;
+    stream_id: string;
+    seq: number;
+}
+export interface LedgerEventEnvelopeInput<TPayload = unknown> {
+    runId: string;
+    seq: number;
+    kind: string;
+    simTime: number;
+    provenance: Provenance;
+    actor: string;
+    target: string;
+    scope: string;
+    payload: TPayload;
+    /** Logical stream within simfile's emitter identity. Defaults to "world". */
+    streamId?: string;
+    /** Authenticated principal that caused this event. Defaults to "system:simfile.world". */
+    principalId?: string;
+    /** Direct parent event_ids only (no trace_id, no transitive closure). */
+    causeEventIds?: readonly string[];
+    /** ISO 8601 diagnostics-only timestamp override. Defaults to a deterministic value derived from simTime. */
+    observedAt?: string;
+}
+export interface LedgerEventEnvelope<TPayload = unknown> {
+    /** Causal envelope schema version. Always noopolis.causal-event.v1 once stamped. */
+    version?: typeof CAUSAL_ENVELOPE_VERSION;
+    /** Identifier shared by every authority participating in a single run. */
+    run_id?: string;
+    event_id: string;
+    /** simfile's emitter identity: system + logical stream + per-stream seq. */
+    emitter?: CausalEmitter;
+    kind: string;
+    /** Authenticated principal that caused this event. Never model-supplied. */
+    principal_id?: string;
+    /** ISO 8601 timestamp. Diagnostics only; never used to order or trust events. */
+    recorded_at?: string;
+    /** Direct parent event_ids only. */
+    cause_event_ids?: string[];
+    sim_time: number;
+    provenance: Provenance;
+    actor: string;
+    target: string;
+    scope: string;
+    payload: TPayload;
+}
+export declare const stableStringify: (value: unknown) => string;
+/** simfile's event_id convention: `simfile:<runId>:<seq>` (system:local, per the shared schema). */
+export declare const createEventId: (runId: string, seq: number) => string;
+export declare const createCanonicalEventEnvelope: <TPayload = unknown>(input: LedgerEventEnvelopeInput<TPayload>) => LedgerEventEnvelope<TPayload>;
+export declare const stableEventLine: <TPayload = unknown>(input: LedgerEventEnvelopeInput<TPayload>) => string;
+export declare const createEventDigest: (input: LedgerEventEnvelopeInput<unknown>) => string;
+//# sourceMappingURL=stable.d.ts.map

package/dist/ledger/stable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable.d.ts","sourceRoot":"","sources":["../../src/ledger/stable.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,UAAU,GAAG,YAAY,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/D;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,EAAG,0BAAmC,CAAC;AAC3E,eAAO,MAAM,sBAAsB,EAAG,SAAkB,CAAC;AACzD,eAAO,MAAM,yBAAyB,EAAG,OAAgB,CAAC;AAC1D,eAAO,MAAM,oBAAoB,EAAG,sBAA+B,CAAC;AAEpE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,OAAO,sBAAsB,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,wBAAwB,CAAC,QAAQ,GAAG,OAAO;IAC1D,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,QAAQ,CAAC;IAClB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0FAA0F;IAC1F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,4GAA4G;IAC5G,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB,CAAC,QAAQ,GAAG,OAAO;IACrD,oFAAoF;IACpF,OAAO,CAAC,EAAE,OAAO,uBAAuB,CAAC;IACzC,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,QAAQ,CAAC;CACnB;AAiCD,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,MAEhD,CAAC;AAEF,oGAAoG;AACpG,eAAO,MAAM,aAAa,GAAI,OAAO,MAAM,EAAE,KAAK,MAAM,KAAG,MACd,CAAC;AAK9C,eAAO,MAAM,4BAA4B,GAAI,QAAQ,GAAG,OAAO,EAC7D,OAAO,wBAAwB,CAAC,QAAQ,CAAC,KACxC,mBAAmB,CAAC,QAAQ,CAmC9B,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,QAAQ,GAAG,OAAO,EAChD,OAAO,wBAAwB,CAAC,QAAQ,CAAC,KACxC,MAA8D,CAAC;AAElE,eAAO,MAAM,iBAAiB,GAAI,OAAO,wBAAwB,CAAC,OAAO,CAAC,KAAG,MACV,CAAC"}