@methodts/runtime 0.1.0

package/dist/ports/event-reader.d.ts

@@ -0,0 +1,21 @@
+/**
+ * EventReader — cursor-based historical event replay port.
+ *
+ * Exposes historical event reading from the persistent event log for projection
+ * replay on startup. Implemented by PersistenceSink. Distinct from live event
+ * subscription (provided by EventBus) — this port is for catching up from disk.
+ *
+ * @see .method/sessions/fcd-design-persistence-projections/prd.md §Surfaces S3
+ */
+import type { RuntimeEvent } from './event-bus.js';
+export interface EventReader {
+    /**
+     * Read events from the persistent log where sequence > sinceSeq.
+     * Returns events in append order. Corrupt JSONL lines are skipped gracefully.
+     *
+     * @param sinceSeq — exclusive lower bound (returns events with sequence > sinceSeq)
+     * @returns events in append order
+     */
+    readEventsSince(sinceSeq: number): Promise<RuntimeEvent[]>;
+}
+//# sourceMappingURL=event-reader.d.ts.map

package/dist/ports/event-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-reader.d.ts","sourceRoot":"","sources":["../../src/ports/event-reader.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAC5D"}

package/dist/ports/event-reader.js

@@ -0,0 +1,12 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * EventReader — cursor-based historical event replay port.
+ *
+ * Exposes historical event reading from the persistent event log for projection
+ * replay on startup. Implemented by PersistenceSink. Distinct from live event
+ * subscription (provided by EventBus) — this port is for catching up from disk.
+ *
+ * @see .method/sessions/fcd-design-persistence-projections/prd.md §Surfaces S3
+ */
+export {};
+//# sourceMappingURL=event-reader.js.map

package/dist/ports/event-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-reader.js","sourceRoot":"","sources":["../../src/ports/event-reader.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;;;GAQG"}

package/dist/ports/event-rotator.d.ts

@@ -0,0 +1,39 @@
+/**
+ * EventRotator — archives events older than a cutoff window to keep the log bounded.
+ *
+ * Rotation compacts the main event log (`.method/events.jsonl`) by moving old
+ * events into gzipped daily archives (`.method/events.archive/YYYY-MM-DD.jsonl.gz`).
+ *
+ * Safety contract: rotation MUST NOT cross the cursor returned by safetyGuard —
+ * doing so would strand projection snapshots that haven't yet caught up, breaking
+ * their ability to recover on next restart.
+ *
+ * @see .method/sessions/fcd-design-persistence-projections/prd.md §Surfaces S-rotator
+ */
+export interface EventRotator {
+    /** Archive events older than the cutoff, after checking rotation is safe. */
+    rotate(options: RotateOptions): Promise<RotateResult>;
+}
+export interface RotateOptions {
+    /** Archive events older than this many days. */
+    readonly olderThanDays: number;
+    /**
+     * Safety guard — returns the lowest cursor below which rotation is safe.
+     * Returns null if rotation is unsafe at any cursor (e.g. no projections registered).
+     * Called by rotate() before any archive operation.
+     */
+    readonly safetyGuard: () => number | null;
+}
+export interface RotateResult {
+    /** Number of events moved to the archive file. */
+    readonly archivedEvents: number;
+    /** Path to the written archive file, or null if no events were archived. */
+    readonly archivePath: string | null;
+    /** Size of the main log after rotation, in bytes. */
+    readonly newLogSize: number;
+    /** True if the safety guard blocked rotation (archivedEvents will be 0). */
+    readonly skipped: boolean;
+    /** Human-readable reason when `skipped` is true. */
+    readonly skipReason?: string;
+}
+//# sourceMappingURL=event-rotator.d.ts.map

package/dist/ports/event-rotator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-rotator.d.ts","sourceRoot":"","sources":["../../src/ports/event-rotator.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,YAAY;IAC3B,6EAA6E;IAC7E,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,qDAAqD;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B"}

package/dist/ports/event-rotator.js

@@ -0,0 +1,15 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * EventRotator — archives events older than a cutoff window to keep the log bounded.
+ *
+ * Rotation compacts the main event log (`.method/events.jsonl`) by moving old
+ * events into gzipped daily archives (`.method/events.archive/YYYY-MM-DD.jsonl.gz`).
+ *
+ * Safety contract: rotation MUST NOT cross the cursor returned by safetyGuard —
+ * doing so would strand projection snapshots that haven't yet caught up, breaking
+ * their ability to recover on next restart.
+ *
+ * @see .method/sessions/fcd-design-persistence-projections/prd.md §Surfaces S-rotator
+ */
+export {};
+//# sourceMappingURL=event-rotator.js.map

package/dist/ports/event-rotator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-rotator.js","sourceRoot":"","sources":["../../src/ports/event-rotator.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;;;;;;GAWG"}

package/dist/ports/file-system.d.ts

@@ -0,0 +1,48 @@
+/**
+ * FileSystemProvider — Port interface for filesystem operations.
+ *
+ * PRD-057 / S2 §5.3: Only the interface lives in runtime. The Node impl
+ * (`NodeFileSystemProvider`) stays in bridge because it binds directly to
+ * `node:fs` — an OS-transport dependency runtime cannot take.
+ */
+export interface DirEntry {
+    name: string;
+    isDirectory(): boolean;
+    isFile(): boolean;
+}
+export interface FileStat {
+    mtimeMs: number;
+    mtime: Date;
+    size: number;
+    isFile(): boolean;
+    isDirectory(): boolean;
+}
+export interface FileSystemProvider {
+    readFileSync(path: string, encoding: BufferEncoding): string;
+    writeFileSync(path: string, content: string, options?: {
+        encoding?: BufferEncoding;
+        mode?: number;
+    }): void;
+    existsSync(path: string): boolean;
+    readdirSync(path: string): string[];
+    readdirSync(path: string, options: {
+        withFileTypes: true;
+    }): DirEntry[];
+    statSync(path: string): FileStat;
+    unlinkSync(path: string): void;
+    mkdirSync(path: string, options?: {
+        recursive?: boolean;
+    }): void;
+    renameSync(oldPath: string, newPath: string): void;
+    realpathSync(path: string): string;
+    readFile(path: string, encoding: BufferEncoding): Promise<string>;
+    writeFile(path: string, content: string, encoding: BufferEncoding): Promise<void>;
+    appendFile(path: string, content: string, encoding: BufferEncoding): Promise<void>;
+    readdir(path: string): Promise<string[]>;
+    stat(path: string): Promise<FileStat>;
+    access(path: string): Promise<void>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+}
+//# sourceMappingURL=file-system.d.ts.map

package/dist/ports/file-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../../src/ports/file-system.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAIH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,IAAI,OAAO,CAAC;IACvB,MAAM,IAAI,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,IAAI,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,IAAI,OAAO,CAAC;IAClB,WAAW,IAAI,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IAEjC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAAC;IAC7D,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,cAAc,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3G,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACpC,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,aAAa,EAAE,IAAI,CAAA;KAAE,GAAG,QAAQ,EAAE,CAAC;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACjC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IACjE,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACnD,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAGnC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnF,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE"}

package/dist/ports/file-system.js

@@ -0,0 +1,10 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * FileSystemProvider — Port interface for filesystem operations.
+ *
+ * PRD-057 / S2 §5.3: Only the interface lives in runtime. The Node impl
+ * (`NodeFileSystemProvider`) stays in bridge because it binds directly to
+ * `node:fs` — an OS-transport dependency runtime cannot take.
+ */
+export {};
+//# sourceMappingURL=file-system.js.map

package/dist/ports/file-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.js","sourceRoot":"","sources":["../../src/ports/file-system.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;GAMG"}

package/dist/ports/historical-observations.d.ts

@@ -0,0 +1,39 @@
+/**
+ * HistoricalObservations — Port interface (PRD 051 S5).
+ *
+ * Consumed by cost-governor domain (CostOracle reads history).
+ * Implemented by ObservationsStore in cost-governor domain.
+ */
+import type { InvocationSignature, ProviderClass, AccountId } from '@methodts/types';
+export interface Observation {
+    readonly signature: InvocationSignature;
+    readonly costUsd: number;
+    readonly durationMs: number;
+    readonly tokensIn: number;
+    readonly tokensOut: number;
+    readonly tokensCacheRead: number;
+    readonly tokensCacheWrite: number;
+    readonly recordedAt: number;
+    readonly accountId: AccountId;
+    readonly providerClass: ProviderClass;
+    readonly hmac: string;
+}
+/**
+ * Opaque capability — only the composition root creates one and
+ * passes it to the RateGovernor. Prevents poisoning via hostile
+ * strategy authors.
+ */
+declare const __appendTokenBrand: unique symbol;
+export type AppendToken = {
+    readonly [__appendTokenBrand]: true;
+};
+/** Create an AppendToken. Only call this in the composition root. */
+export declare function createAppendToken(): AppendToken;
+export interface HistoricalObservations {
+    /** Query observations matching a signature, newest first. */
+    query(sig: InvocationSignature, limit?: number): readonly Observation[];
+    /** Append an observation. Requires a capability token. */
+    append(obs: Omit<Observation, 'hmac'>, token: AppendToken): void;
+}
+export {};
+//# sourceMappingURL=historical-observations.d.ts.map

package/dist/ports/historical-observations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"historical-observations.d.ts","sourceRoot":"","sources":["../../src/ports/historical-observations.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIrF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAID;;;;GAIG;AACH,OAAO,CAAC,MAAM,kBAAkB,EAAE,OAAO,MAAM,CAAC;AAChD,MAAM,MAAM,WAAW,GAAG;IAAE,QAAQ,CAAC,CAAC,kBAAkB,CAAC,EAAE,IAAI,CAAA;CAAE,CAAC;AAElE,qEAAqE;AACrE,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C;AAID,MAAM,WAAW,sBAAsB;IACrC,6DAA6D;IAC7D,KAAK,CAAC,GAAG,EAAE,mBAAmB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,WAAW,EAAE,CAAC;IAExE,0DAA0D;IAC1D,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;CAClE"}

package/dist/ports/historical-observations.js

@@ -0,0 +1,12 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * HistoricalObservations — Port interface (PRD 051 S5).
+ *
+ * Consumed by cost-governor domain (CostOracle reads history).
+ * Implemented by ObservationsStore in cost-governor domain.
+ */
+/** Create an AppendToken. Only call this in the composition root. */
+export function createAppendToken() {
+    return Object.freeze({});
+}
+//# sourceMappingURL=historical-observations.js.map

package/dist/ports/historical-observations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"historical-observations.js","sourceRoot":"","sources":["../../src/ports/historical-observations.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;GAKG;AA8BH,qEAAqE;AACrE,MAAM,UAAU,iBAAiB;IAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,EAAiB,CAAC,CAAC;AAC1C,CAAC"}

package/dist/ports/in-memory-source.d.ts

@@ -0,0 +1,46 @@
+/**
+ * InMemorySource — Test MethodologySource for port substitutability proof.
+ *
+ * WS-1 success criterion 6: "a 20-line InMemorySource for tests proves
+ * the port interface is a real seam, not a port-shaped wrapper."
+ *
+ * PRD-057 / S2 §5.3: promoted from bridge to runtime.
+ * PRD-064 / S7: gains no-op lifecycle stubs + a controllable `onChange`
+ *   trigger (`emitChange()`) so tests can simulate methodology-update
+ *   fan-out without a real Cortex events port.
+ *
+ * Accepts catalog entries and typed values in the constructor.
+ * No I/O, no external dependencies — pure data container.
+ */
+import type { MethodologySource, MethodologyChange } from './methodology-source.js';
+import type { CatalogMethodologyEntry } from '@methodts/methodts/stdlib';
+import type { Method } from '@methodts/methodts';
+import type { Methodology } from '@methodts/methodts';
+export declare class InMemorySource implements MethodologySource {
+    private readonly catalog;
+    private readonly methods;
+    private readonly methodologies;
+    private readonly listeners;
+    constructor(catalog: CatalogMethodologyEntry[], methods?: Array<{
+        key: string;
+        method: Method<any>;
+    }>, methodologies?: Array<{
+        id: string;
+        methodology: Methodology<any>;
+    }>);
+    list(): CatalogMethodologyEntry[];
+    getMethod(methodologyId: string, methodId: string): Method<any> | undefined;
+    getMethodology(methodologyId: string): Methodology<any> | undefined;
+    init(): Promise<void>;
+    reload(_methodologyId?: string): Promise<void>;
+    onChange(listener: (c: MethodologyChange) => void): () => void;
+    close(): Promise<void>;
+    /**
+     * Test-only hook — fires `change` to every registered listener. Lets
+     * tests exercise `onChange`-dependent paths (e.g. routing-cache
+     * invalidation in `MethodologySessionStore`) without wiring a full
+     * Cortex events port.
+     */
+    emitChange(change: MethodologyChange): void;
+}
+//# sourceMappingURL=in-memory-source.d.ts.map

package/dist/ports/in-memory-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-source.d.ts","sourceRoot":"","sources":["../../src/ports/in-memory-source.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,qBAAa,cAAe,YAAW,iBAAiB;IAQpD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IAEnD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgC;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6C;gBAGpD,OAAO,EAAE,uBAAuB,EAAE,EAEnD,OAAO,GAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;KAAE,CAAM,EAEzD,aAAa,GAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAA;KAAE,CAAM;IAM1E,IAAI,IAAI,uBAAuB,EAAE;IAEjC,SAAS,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS;IAI3E,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,SAAS;IAM7D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,MAAM,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,iBAAiB,KAAK,IAAI,GAAG,MAAM,IAAI;IAOxD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;CAG5C"}

package/dist/ports/in-memory-source.js

@@ -0,0 +1,69 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * InMemorySource — Test MethodologySource for port substitutability proof.
+ *
+ * WS-1 success criterion 6: "a 20-line InMemorySource for tests proves
+ * the port interface is a real seam, not a port-shaped wrapper."
+ *
+ * PRD-057 / S2 §5.3: promoted from bridge to runtime.
+ * PRD-064 / S7: gains no-op lifecycle stubs + a controllable `onChange`
+ *   trigger (`emitChange()`) so tests can simulate methodology-update
+ *   fan-out without a real Cortex events port.
+ *
+ * Accepts catalog entries and typed values in the constructor.
+ * No I/O, no external dependencies — pure data container.
+ */
+export class InMemorySource {
+    catalog;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    methods;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    methodologies;
+    listeners = new Set();
+    constructor(catalog, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    methods = [], 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    methodologies = []) {
+        this.catalog = catalog;
+        this.methods = new Map(methods.map(m => [m.key, m.method]));
+        this.methodologies = new Map(methodologies.map(m => [m.id, m.methodology]));
+    }
+    list() { return this.catalog; }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getMethod(methodologyId, methodId) {
+        return this.methods.get(`${methodologyId}/${methodId}`);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getMethodology(methodologyId) {
+        return this.methodologies.get(methodologyId);
+    }
+    // ── PRD-064 / S7 lifecycle stubs ──────────────────────────────────
+    async init() {
+        /* no-op — data provided via constructor */
+    }
+    async reload(_methodologyId) {
+        /* no-op — data provided via constructor */
+    }
+    onChange(listener) {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    }
+    async close() {
+        this.listeners.clear();
+    }
+    // ── Test helper ───────────────────────────────────────────────────
+    /**
+     * Test-only hook — fires `change` to every registered listener. Lets
+     * tests exercise `onChange`-dependent paths (e.g. routing-cache
+     * invalidation in `MethodologySessionStore`) without wiring a full
+     * Cortex events port.
+     */
+    emitChange(change) {
+        for (const l of this.listeners)
+            l(change);
+    }
+}
+//# sourceMappingURL=in-memory-source.js.map

package/dist/ports/in-memory-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-source.js","sourceRoot":"","sources":["../../src/ports/in-memory-source.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;;;;;;;;GAaG;AAUH,MAAM,OAAO,cAAc;IAQN;IAPnB,8DAA8D;IAC7C,OAAO,CAA2B;IACnD,8DAA8D;IAC7C,aAAa,CAAgC;IAC7C,SAAS,GAAG,IAAI,GAAG,EAAkC,CAAC;IAEvE,YACmB,OAAkC;IACnD,8DAA8D;IAC9D,UAAuD,EAAE;IACzD,8DAA8D;IAC9D,gBAAsE,EAAE;QAJvD,YAAO,GAAP,OAAO,CAA2B;QAMnD,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC5D,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,KAAgC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1D,8DAA8D;IAC9D,SAAS,CAAC,aAAqB,EAAE,QAAgB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,aAAa,IAAI,QAAQ,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,8DAA8D;IAC9D,cAAc,CAAC,aAAqB;QAClC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC/C,CAAC;IAED,qEAAqE;IAErE,KAAK,CAAC,IAAI;QACR,2CAA2C;IAC7C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,cAAuB;QAClC,2CAA2C;IAC7C,CAAC;IAED,QAAQ,CAAC,QAAwC;QAC/C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAClC,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,qEAAqE;IAErE;;;;;OAKG;IACH,UAAU,CAAC,MAAyB;QAClC,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS;YAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC;CACF"}

package/dist/ports/index.d.ts

@@ -0,0 +1,32 @@
+export type { FileSystemProvider, DirEntry, FileStat } from './file-system.js';
+export type { YamlLoader } from './yaml-loader.js';
+export type { NativeSessionDiscovery, NativeSessionInfo } from './native-session-discovery.js';
+export type { MethodologySource, MethodologyChange } from './methodology-source.js';
+export { InMemorySource } from './in-memory-source.js';
+export type { EventBus, EventSink, EventConnector, EventFilter, EventSubscription, ConnectorHealth, RuntimeEvent, RuntimeEventInput, EventDomain, EventSeverity, StrategyGateAwaitingApprovalPayload, StrategyGateApprovalResponsePayload, } from './event-bus.js';
+export type { SessionBudget, SessionChainInfo, SessionMode, IsolationMode, WorktreeAction, WorktreeInfo, SessionStatusInfo, SessionSnapshot, StreamEvent, PtySessionHandle, SessionProviderOptions, SessionProviderFactory, } from './session-pool.js';
+export type { CostOracle, NodeEstimate, StrategyEstimate } from './cost-oracle.js';
+export type { RuntimeRateGovernor } from './rate-governor.js';
+export type { HistoricalObservations, Observation, AppendToken } from './historical-observations.js';
+export { createAppendToken } from './historical-observations.js';
+export type { CheckpointPort, PipelineCheckpoint, PipelineCheckpointSummary, Phase, FeatureSpec, TestableAssertion, ConversationMessage, } from './checkpoint.js';
+export type { ConversationPort, AgentMessage, HumanMessage, GateDecision, GateType, SkillRequest, StructuredCard, } from './conversation.js';
+export { GATE_ACTIONS } from './conversation.js';
+export type { Projection } from './projection.js';
+export type { ProjectionStore, StartResult } from './projection-store.js';
+export type { EventReader } from './event-reader.js';
+export type { EventRotator, RotateOptions, RotateResult } from './event-rotator.js';
+export type { SessionStore } from './session-store.js';
+export type { SessionStatus, PactRef, SessionSnapshot as PersistedSessionSnapshot, EventCursor, AgentStateBlob, BudgetReservation, NextAction, Checkpoint, CheckpointMeta, ResumeOptions, ResumeContext, } from './session-store-types.js';
+export type { SessionStoreErrorCode, SessionStoreErrorOptions, } from './session-store-errors.js';
+export { SessionStoreError, isSessionStoreError, } from './session-store-errors.js';
+export type { CheckpointSink, CheckpointSinkOptions, CheckpointCapture, } from './checkpoint-sink.js';
+export type { ContinuationEnvelope, CheckpointRef, BudgetRef, BudgetCarryStrategy, TokenContext, CrossAppContinuationContext, NextAction as ContinuationNextAction, } from './continuation-envelope.js';
+export { EnvelopeVersionError, BudgetExpiredError, ENVELOPE_SIZE_SOFT_CAP_BYTES, parseContinuationEnvelope, } from './continuation-envelope.js';
+export type { JobBackedExecutor, JobClient, JobHandlerCtx, PactFactory, PactStartInput, } from './job-backed-executor.js';
+export { DuplicateAttachError, PactRegistrationError, BudgetStrategyNotImplemented, } from './job-backed-executor.js';
+export type { DlqObserver, DlqRecord, } from './dlq-observer.js';
+export type { ScheduleClient } from './schedule-client.js';
+export type { CrossAppInvoker, CrossAppInvokeRequest, CrossAppInvokeResult, CrossAppInvokerCapabilities, DelegationCarry, } from './cross-app-invoker.js';
+export { CrossAppNotConfiguredError, CrossAppTargetNotDeclaredError, CrossAppScopeMissingError, CrossAppDelegationDepthExceededError, CrossAppTargetError, CrossAppTargetUnknownError, NullCrossAppInvoker, CROSS_APP_DEFAULT_MAX_DELEGATION_DEPTH, assertCrossAppTargetsAllowed, } from './cross-app-invoker.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/ports/index.js

@@ -0,0 +1,10 @@
+// SPDX-License-Identifier: Apache-2.0
+// PRD-057 / S2 §3.1: @methodts/runtime/ports — unified public port surface.
+export { InMemorySource } from './in-memory-source.js';
+export { createAppendToken } from './historical-observations.js';
+export { GATE_ACTIONS } from './conversation.js';
+export { SessionStoreError, isSessionStoreError, } from './session-store-errors.js';
+export { EnvelopeVersionError, BudgetExpiredError, ENVELOPE_SIZE_SOFT_CAP_BYTES, parseContinuationEnvelope, } from './continuation-envelope.js';
+export { DuplicateAttachError, PactRegistrationError, BudgetStrategyNotImplemented, } from './job-backed-executor.js';
+export { CrossAppNotConfiguredError, CrossAppTargetNotDeclaredError, CrossAppScopeMissingError, CrossAppDelegationDepthExceededError, CrossAppTargetError, CrossAppTargetUnknownError, NullCrossAppInvoker, CROSS_APP_DEFAULT_MAX_DELEGATION_DEPTH, assertCrossAppTargetsAllowed, } from './cross-app-invoker.js';
+//# sourceMappingURL=index.js.map

package/dist/ports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ports/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,4EAA4E;AAS5E,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAsCvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAqBjE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA8BjD,OAAO,EACL,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,2BAA2B,CAAC;AAsBnC,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,4BAA4B,CAAC;AAQpC,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,0BAA0B,CAAC;AAelC,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,EAC9B,yBAAyB,EACzB,oCAAoC,EACpC,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,EACnB,sCAAsC,EACtC,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC"}

package/dist/ports/job-backed-executor.d.ts

@@ -0,0 +1,139 @@
+/**
+ * JobBackedExecutor — drives a pact across worker boundaries via ctx.jobs.
+ *
+ * PRD-062 / S5 §2.2. Frozen: 2026-04-14.
+ *
+ * Owner:    @methodts/runtime
+ * Producer: @methodts/runtime (impl: CortexJobBackedExecutor)
+ * Consumer: tenant app composition root (wires ctx.jobs into the executor)
+ *
+ * The tenant app never calls `enqueue`/`dispatch` directly — it registers
+ * the executor once (`attach(ctx.jobs)`) and the runtime internally emits
+ * continuations whenever a pact yields.
+ */
+import type { Pact } from '@methodts/pacta';
+import type { ContinuationEnvelope, BudgetRef, NextAction } from './continuation-envelope.js';
+export interface JobBackedExecutor {
+    /**
+     * Wire the executor into a tenant's ctx.jobs. Registers exactly ONE handler
+     * (`method.pact.continue`) that dispatches all pact continuations for the
+     * entire app. Safe to call in app boot or test harnesses.
+     *
+     * Must be called before `start()`. Throws `DuplicateAttachError` if called
+     * twice with different `JobClient` instances.
+     */
+    attach(jobs: JobClient): Promise<void>;
+    /**
+     * Register a pact factory under a stable key. Continuations reference pacts
+     * by key so the envelope stays small and forward-compatible across deploys.
+     *
+     * A factory returns a `Pact` given the rehydrated input context.
+     */
+    registerPact(key: string, factory: PactFactory): void;
+    /**
+     * Start a new pact as a job-backed execution. Returns the sessionId —
+     * results arrive via the tenant's `events` channel, not as a return value.
+     *
+     * The first turn runs inline (attempt to complete synchronously); if the
+     * pact yields, subsequent turns run in jobs.
+     */
+    start(input: PactStartInput): Promise<{
+        sessionId: string;
+        traceId: string;
+    }>;
+    /**
+     * Emit a continuation envelope. Called internally when a pact yields.
+     * Surface is exposed on the port so alternative executors (testkit) can
+     * observe + assert on envelope emission.
+     */
+    yield(envelope: ContinuationEnvelope): Promise<void>;
+    /**
+     * Graceful shutdown: stop accepting new pacts, drain in-flight continuations
+     * up to `timeoutMs`, unack anything still running so SQS re-delivers.
+     */
+    stop(timeoutMs: number): Promise<void>;
+}
+export interface PactStartInput {
+    pactKey: string;
+    initialPrompt: string;
+    userSub: string;
+    originatingRequestId: string;
+    /** Hard wall-clock cap across ALL continuations. Default 24h. */
+    maxLifetimeMs?: number;
+    /**
+     * Budget strategy for this invocation. Defaults to `'fresh-per-continuation'`
+     * in Wave 1 (S5 §5). Other strategies throw `BudgetStrategyNotImplemented`
+     * until Cortex O1 (`ctx.llm.reserve()/settle()`) lands.
+     */
+    budgetStrategy?: 'fresh-per-continuation' | 'batched-held' | 'predictive-prereserve';
+    /** Per-turn budget cap (USD) for `fresh-per-continuation`. Default 2.0. */
+    perTurnBudgetUsd?: number;
+    /** Absolute deadline for the whole pact (UTC ms). Default `now + 24h`. */
+    expiresAt?: number;
+    /** Optional initial context passed to the factory. */
+    initialContext?: Record<string, unknown>;
+    /** RFC 8693 exchange depth so far. Default 0. */
+    exchangeDepth?: number;
+}
+/**
+ * Factory signature. Called on every turn — the executor rehydrates
+ * checkpoint + budget + nextAction, then invokes the factory to produce
+ * a `Pact` that will execute this turn.
+ */
+export type PactFactory = (rehydrated: {
+    /** Opaque — SessionStore deserializes. First turn sees `null`. */
+    checkpoint: unknown;
+    budget: BudgetRef;
+    nextAction: NextAction;
+    initialContext: Record<string, unknown>;
+}) => Pact;
+/**
+ * Minimal slice of ctx.jobs the runtime consumes. Cortex's JobClient is
+ * structurally compatible. A test-only LocalJobClient implements the same
+ * surface for `npm run bridge:test`.
+ */
+export interface JobClient {
+    enqueue(jobType: string, payload: unknown): Promise<{
+        jobId: string;
+    }>;
+    handle(jobType: string, handler: (payload: unknown, ctx: JobHandlerCtx) => Promise<void>): void;
+}
+export interface JobHandlerCtx {
+    /** Attempt number (0 = first delivery, 1-4 = retries per PRD-071). */
+    attempt: number;
+    /**
+     * Called by runtime when the continuation is effectively DLQ'd (attempt=4
+     * failed). Signals Cortex that the job should be moved to the DLQ rather
+     * than retried further.
+     */
+    signalDeadLetter: (error: string) => Promise<void>;
+}
+/**
+ * Thrown when `attach()` is called twice on the same executor with
+ * structurally different `JobClient` instances. Re-attaching with the
+ * same instance is a no-op (idempotent, S5 §3).
+ */
+export declare class DuplicateAttachError extends Error {
+    constructor();
+}
+/**
+ * Thrown when `registerPact` is called twice with the same key, or when
+ * `start`/dispatch references a pactKey that was never registered.
+ */
+export declare class PactRegistrationError extends Error {
+    readonly pactKey: string;
+    constructor(pactKey: string, reason: 'duplicate' | 'missing');
+}
+/**
+ * Thrown when the envelope requests a budget strategy that isn't
+ * implemented in this wave (S5 §5).
+ *
+ * Wave 1 supports `'fresh-per-continuation'` only. `'batched-held'` and
+ * `'predictive-prereserve'` are gated on Cortex Open Question O1
+ * (`ctx.llm.reserve()/settle()` API).
+ */
+export declare class BudgetStrategyNotImplemented extends Error {
+    readonly strategy: string;
+    constructor(strategy: string, reason?: string);
+}
+//# sourceMappingURL=job-backed-executor.d.ts.map

package/dist/ports/job-backed-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-backed-executor.d.ts","sourceRoot":"","sources":["../../src/ports/job-backed-executor.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EACV,oBAAoB,EACpB,SAAS,EACT,UAAU,EACX,MAAM,4BAA4B,CAAC;AAEpC,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC;;;;;OAKG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAC;IAEtD;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE9E;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD;;;OAGG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,cAAc,CAAC,EAAE,wBAAwB,GAAG,cAAc,GAAG,uBAAuB,CAAC;IACrF,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,UAAU,EAAE;IACrC,kEAAkE;IAClE,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC,KAAK,IAAI,CAAC;AAEX;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvE,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,GAC/D,IAAI,CAAC;CACT;AAED,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;;CAK9C;AAED;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBACb,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS;CAS7D;AAED;;;;;;;GAOG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACrD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACd,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAE,MAA+B;CAKtE"}

package/dist/ports/job-backed-executor.js

@@ -0,0 +1,56 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * JobBackedExecutor — drives a pact across worker boundaries via ctx.jobs.
+ *
+ * PRD-062 / S5 §2.2. Frozen: 2026-04-14.
+ *
+ * Owner:    @methodts/runtime
+ * Producer: @methodts/runtime (impl: CortexJobBackedExecutor)
+ * Consumer: tenant app composition root (wires ctx.jobs into the executor)
+ *
+ * The tenant app never calls `enqueue`/`dispatch` directly — it registers
+ * the executor once (`attach(ctx.jobs)`) and the runtime internally emits
+ * continuations whenever a pact yields.
+ */
+/**
+ * Thrown when `attach()` is called twice on the same executor with
+ * structurally different `JobClient` instances. Re-attaching with the
+ * same instance is a no-op (idempotent, S5 §3).
+ */
+export class DuplicateAttachError extends Error {
+    constructor() {
+        super('JobBackedExecutor.attach called twice with a different JobClient');
+        this.name = 'DuplicateAttachError';
+    }
+}
+/**
+ * Thrown when `registerPact` is called twice with the same key, or when
+ * `start`/dispatch references a pactKey that was never registered.
+ */
+export class PactRegistrationError extends Error {
+    pactKey;
+    constructor(pactKey, reason) {
+        super(reason === 'duplicate'
+            ? `Pact '${pactKey}' already registered`
+            : `Pact '${pactKey}' not registered — call runtime.registerPact first`);
+        this.name = 'PactRegistrationError';
+        this.pactKey = pactKey;
+    }
+}
+/**
+ * Thrown when the envelope requests a budget strategy that isn't
+ * implemented in this wave (S5 §5).
+ *
+ * Wave 1 supports `'fresh-per-continuation'` only. `'batched-held'` and
+ * `'predictive-prereserve'` are gated on Cortex Open Question O1
+ * (`ctx.llm.reserve()/settle()` API).
+ */
+export class BudgetStrategyNotImplemented extends Error {
+    strategy;
+    constructor(strategy, reason = 'blocked on Cortex O1') {
+        super(`Budget strategy '${strategy}' not implemented in Wave 1 — ${reason}`);
+        this.name = 'BudgetStrategyNotImplemented';
+        this.strategy = strategy;
+    }
+}
+//# sourceMappingURL=job-backed-executor.js.map

package/dist/ports/job-backed-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-backed-executor.js","sourceRoot":"","sources":["../../src/ports/job-backed-executor.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC;;;;;;;;;;;;GAYG;AA+GH;;;;GAIG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C;QACE,KAAK,CAAC,kEAAkE,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IACrC,OAAO,CAAS;IACzB,YAAY,OAAe,EAAE,MAA+B;QAC1D,KAAK,CACH,MAAM,KAAK,WAAW;YACpB,CAAC,CAAC,SAAS,OAAO,sBAAsB;YACxC,CAAC,CAAC,SAAS,OAAO,oDAAoD,CACzE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,4BAA6B,SAAQ,KAAK;IAC5C,QAAQ,CAAS;IAC1B,YAAY,QAAgB,EAAE,SAAiB,sBAAsB;QACnE,KAAK,CAAC,oBAAoB,QAAQ,iCAAiC,MAAM,EAAE,CAAC,CAAC;QAC7E,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;QAC3C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF"}