@zhin.js/agent 1.1.13 → 1.1.14

package/lib/portfolio/database-capacity-control-outbox.js

@@ -0,0 +1,166 @@
+import { createHash } from 'node:crypto';
+import { createPortfolioControlOutboxEvent, replayPortfolioControlOutbox, } from './capacity-control-outbox.js';
+import { canonicalWorkroomJson } from '../workroom/canonical-value.js';
+/**
+ * Candidate-owned storage latch. The target is replayed before it becomes the
+ * writer, so generation handoff cannot expose a partially initialized DB.
+ */
+export class ActivatablePortfolioControlOutboxRepository {
+    #delegate;
+    async activate(delegate, portfolioIds, source) {
+        if (this.#delegate)
+            throw new Error('Portfolio Control Outbox storage is already active');
+        const ids = [...new Set(portfolioIds.map(id => required(id, 'portfolioId')))].sort();
+        if (ids.length !== portfolioIds.length) {
+            throw new Error('Portfolio Control Outbox activation contains duplicate Portfolio ids');
+        }
+        for (const portfolioId of ids) {
+            const sourceEvents = source ? await source.read(portfolioId) : Object.freeze([]);
+            let targetEvents = await delegate.read(portfolioId);
+            replayPortfolioControlOutbox(portfolioId, sourceEvents);
+            replayPortfolioControlOutbox(portfolioId, targetEvents);
+            const shared = Math.min(sourceEvents.length, targetEvents.length);
+            for (let index = 0; index < shared; index += 1) {
+                if (canonicalWorkroomJson(sourceEvents[index]) !== canonicalWorkroomJson(targetEvents[index])) {
+                    throw new Error('Portfolio Control Outbox File/Database handoff diverged');
+                }
+            }
+            for (const event of sourceEvents.slice(targetEvents.length)) {
+                await delegate.append(portfolioId, event.sequence - 1, {
+                    type: event.type,
+                    payload: event.payload,
+                });
+            }
+            targetEvents = await delegate.read(portfolioId);
+            if (targetEvents.length < sourceEvents.length
+                || sourceEvents.some((event, index) => canonicalWorkroomJson(event) !== canonicalWorkroomJson(targetEvents[index]))) {
+                throw new Error('Portfolio Control Outbox target did not durably replay the File source');
+            }
+        }
+        if (this.#delegate)
+            throw new Error('Portfolio Control Outbox storage is already active');
+        this.#delegate = delegate;
+    }
+    read(portfolioId) {
+        return this.#require().read(portfolioId);
+    }
+    append(portfolioId, expectedSequence, draft) {
+        return this.#require().append(portfolioId, expectedSequence, draft);
+    }
+    #require() {
+        if (!this.#delegate)
+            throw new Error('Portfolio Control Outbox storage is not active');
+        return this.#delegate;
+    }
+}
+/** Database-backed Portfolio control outbox using the repository's SERIALIZABLE CAS convention. */
+export class DatabasePortfolioControlOutboxRepository {
+    database;
+    model;
+    constructor(database, model) {
+        this.database = database;
+        this.model = model;
+    }
+    async read(portfolioId) {
+        const id = required(portfolioId, 'portfolioId');
+        return parseRows(id, await this.model.select().where({ portfolio_id: id }));
+    }
+    async append(portfolioId, expectedSequence, draft) {
+        const id = required(portfolioId, 'portfolioId');
+        const candidate = createPortfolioControlOutboxEvent(id, expectedSequence + 1, draft);
+        try {
+            return await this.database.transaction(async (transaction) => {
+                const current = parseRows(id, await transaction.select('portfolio_control_outbox')
+                    .where({ portfolio_id: id }));
+                const actualSequence = current.at(-1)?.sequence ?? -1;
+                if (actualSequence !== expectedSequence) {
+                    throw sequenceConflict(id, expectedSequence, actualSequence);
+                }
+                replayPortfolioControlOutbox(id, [...current, candidate]);
+                await transaction.insertMany('portfolio_control_outbox', [toRow(candidate)]);
+                return candidate;
+            }, { isolationLevel: 'SERIALIZABLE' });
+        }
+        catch (error) {
+            if (isSequenceConflict(error))
+                throw error;
+            const winner = await this.read(id);
+            const actualSequence = winner.at(-1)?.sequence ?? -1;
+            const occupied = winner[expectedSequence + 1];
+            if (occupied && canonicalWorkroomJson(occupied) === canonicalWorkroomJson(candidate)) {
+                return occupied;
+            }
+            if (actualSequence !== expectedSequence) {
+                throw sequenceConflict(id, expectedSequence, actualSequence);
+            }
+            throw error;
+        }
+    }
+}
+export const PORTFOLIO_CONTROL_OUTBOX_MODEL = {
+    id: { type: 'text', primary: true, nullable: false },
+    portfolio_id: { type: 'text', nullable: false },
+    sequence: { type: 'integer', nullable: false },
+    event_digest: { type: 'text', nullable: false },
+    event_json: { type: 'text', nullable: false },
+};
+export function definePortfolioControlOutboxDatabaseModel(database) {
+    database.define('portfolio_control_outbox', PORTFOLIO_CONTROL_OUTBOX_MODEL);
+}
+function parseRows(portfolioId, rows) {
+    const sorted = [...rows].sort((left, right) => integer(left.sequence, 'sequence') - integer(right.sequence, 'sequence'));
+    const events = sorted.map((row, sequence) => {
+        exactRow(row);
+        if (row.portfolio_id !== portfolioId || integer(row.sequence, 'sequence') !== sequence
+            || typeof row.event_json !== 'string') {
+            throw new Error('Portfolio Control Outbox database row binding drift');
+        }
+        const persisted = JSON.parse(row.event_json);
+        const canonical = createPortfolioControlOutboxEvent(portfolioId, sequence, {
+            type: persisted.type,
+            payload: persisted.payload,
+        });
+        if (row.event_digest !== canonical.digest
+            || canonicalWorkroomJson(persisted) !== canonicalWorkroomJson(canonical)) {
+            throw new Error('Portfolio Control Outbox database event drift');
+        }
+        return canonical;
+    });
+    replayPortfolioControlOutbox(portfolioId, events);
+    return Object.freeze(events);
+}
+function exactRow(row) {
+    const requiredKeys = ['id', 'portfolio_id', 'sequence', 'event_digest', 'event_json'];
+    if (Object.keys(row).length !== requiredKeys.length
+        || requiredKeys.some(key => !Object.hasOwn(row, key))) {
+        throw new Error('Portfolio Control Outbox database row exact schema drift');
+    }
+}
+function toRow(event) {
+    return {
+        id: `${createHash('sha256').update(event.portfolioId).digest('hex')}:${event.sequence}`,
+        portfolio_id: event.portfolioId,
+        sequence: event.sequence,
+        event_digest: event.digest,
+        event_json: canonicalWorkroomJson(event),
+    };
+}
+function required(value, label) {
+    if (typeof value !== 'string' || !value.trim() || value !== value.trim()) {
+        throw new Error(`${label} is invalid`);
+    }
+    return value;
+}
+function integer(value, label) {
+    if (!Number.isSafeInteger(value) || Number(value) < 0)
+        throw new Error(`${label} is invalid`);
+    return Number(value);
+}
+function sequenceConflict(portfolioId, expected, actual) {
+    return Object.assign(new Error(`Portfolio Control Outbox sequence conflict for ${portfolioId}: expected ${expected}, actual ${actual}`), { code: 'PORTFOLIO_CONTROL_SEQUENCE_CONFLICT' });
+}
+function isSequenceConflict(error) {
+    return !!error && typeof error === 'object'
+        && 'code' in error && error.code === 'PORTFOLIO_CONTROL_SEQUENCE_CONFLICT';
+}
+//# sourceMappingURL=database-capacity-control-outbox.js.map

package/lib/portfolio/database-capacity-control-outbox.js.map

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

package/lib/portfolio/file-capacity-control-outbox.d.ts

@@ -0,0 +1,10 @@
+import { type PortfolioControlOutboxEvent, type PortfolioControlOutboxEventDraft, type PortfolioControlOutboxRepository } from './capacity-control-outbox.js';
+export declare class FilePortfolioControlOutboxRepository implements PortfolioControlOutboxRepository {
+    #private;
+    readonly directory: string;
+    constructor(directory: string);
+    listPortfolioIds(): Promise<readonly string[]>;
+    read(portfolioId: string): Promise<readonly PortfolioControlOutboxEvent[]>;
+    append(portfolioId: string, expectedSequence: number, draft: PortfolioControlOutboxEventDraft): Promise<PortfolioControlOutboxEvent>;
+}
+//# sourceMappingURL=file-capacity-control-outbox.d.ts.map

package/lib/portfolio/file-capacity-control-outbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-capacity-control-outbox.d.ts","sourceRoot":"","sources":["../../src/portfolio/file-capacity-control-outbox.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,2BAA2B,EAChC,KAAK,gCAAgC,EACrC,KAAK,gCAAgC,EACtC,MAAM,8BAA8B,CAAC;AAetC,qBAAa,oCAAqC,YAAW,gCAAgC;;IAE/E,QAAQ,CAAC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;IAEhC,gBAAgB,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;IAoB9C,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,2BAA2B,EAAE,CAAC;IAmB1E,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,2BAA2B,CAAC;CAuBxC"}

package/lib/portfolio/file-capacity-control-outbox.js

@@ -0,0 +1,113 @@
+import { createHash } from 'node:crypto';
+import { readFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { DurableFileStore } from '../workroom/durable-file-store.js';
+import { createPortfolioControlOutboxEvent, replayPortfolioControlOutbox, } from './capacity-control-outbox.js';
+import { canonicalWorkroomJson, deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue as digest, } from '../workroom/canonical-value.js';
+export class FilePortfolioControlOutboxRepository {
+    directory;
+    #store;
+    constructor(directory) {
+        this.directory = directory;
+        this.#store = new DurableFileStore(directory);
+    }
+    async listPortfolioIds() {
+        let names;
+        try {
+            names = (await readdir(this.directory)).filter(name => name.endsWith('.json')).sort();
+        }
+        catch (error) {
+            if (hasCode(error, 'ENOENT'))
+                return Object.freeze([]);
+            throw error;
+        }
+        const ids = new Set();
+        for (const name of names) {
+            const value = JSON.parse(await readFile(join(this.directory, name), 'utf8'));
+            if (typeof value.portfolioId !== 'string' || !value.portfolioId.trim()) {
+                throw new Error('Portfolio Control Outbox segment has no Portfolio identity');
+            }
+            ids.add(value.portfolioId);
+        }
+        for (const portfolioId of ids)
+            await this.read(portfolioId);
+        return Object.freeze([...ids].sort());
+    }
+    async read(portfolioId) {
+        const prefix = filePrefix(portfolioId);
+        let names;
+        try {
+            names = (await readdir(this.directory)).filter(name => name.startsWith(prefix)).sort();
+        }
+        catch (error) {
+            if (hasCode(error, 'ENOENT'))
+                return Object.freeze([]);
+            throw error;
+        }
+        const events = [];
+        for (const [sequence, name] of names.entries()) {
+            if (name !== fileName(portfolioId, sequence))
+                throw new Error('Portfolio Control Outbox segment gap');
+            events.push(parseSegment(await readFile(join(this.directory, name), 'utf8'), portfolioId, sequence).event);
+        }
+        replayPortfolioControlOutbox(portfolioId, events);
+        if (events.length)
+            await this.#store.syncLeaf();
+        return Object.freeze(events);
+    }
+    async append(portfolioId, expectedSequence, draft) {
+        const current = await this.read(portfolioId);
+        if (current.length - 1 !== expectedSequence)
+            throw new Error('Portfolio Control Outbox sequence conflict');
+        const event = createPortfolioControlOutboxEvent(portfolioId, expectedSequence + 1, draft);
+        replayPortfolioControlOutbox(portfolioId, [...current, event]);
+        const body = deepFreeze({
+            version: 1, portfolioId, expectedSequence, event,
+        });
+        const segment = deepFreeze({ ...body, digest: digest(body) });
+        await this.#store.ensureDurableLeaf('Portfolio Control Outbox');
+        const target = join(this.directory, fileName(portfolioId, event.sequence));
+        const result = await this.#store.publishCreateOnly({
+            target, content: canonicalWorkroomJson(segment), createdValue: segment,
+            onConflict: async () => {
+                const existing = parseSegment(await readFile(target, 'utf8'), portfolioId, event.sequence);
+                if (canonicalWorkroomJson(existing) !== canonicalWorkroomJson(segment)) {
+                    throw new Error('Portfolio Control Outbox sequence conflict');
+                }
+                return existing;
+            },
+        });
+        return result.value.event;
+    }
+}
+function parseSegment(serialized, portfolioId, sequence) {
+    const value = JSON.parse(serialized);
+    if (value.version !== 1 || value.portfolioId !== portfolioId
+        || value.expectedSequence !== sequence - 1 || value.event.sequence !== sequence) {
+        throw new Error('Portfolio Control Outbox segment binding drift');
+    }
+    const canonicalEvent = createPortfolioControlOutboxEvent(portfolioId, sequence, {
+        type: value.event.type,
+        payload: value.event.payload,
+    });
+    if (canonicalWorkroomJson(canonicalEvent) !== canonicalWorkroomJson(value.event)) {
+        throw new Error('Portfolio Control Outbox event drift');
+    }
+    const body = deepFreeze({ version: 1, portfolioId, expectedSequence: sequence - 1, event: value.event });
+    const canonical = deepFreeze({ ...body, digest: digest(body) });
+    if (canonicalWorkroomJson(value) !== canonicalWorkroomJson(canonical)) {
+        throw new Error('Portfolio Control Outbox segment digest drift');
+    }
+    return canonical;
+}
+function filePrefix(portfolioId) {
+    return `portfolio-control-${createHash('sha256').update(portfolioId).digest('hex')}-`;
+}
+function fileName(portfolioId, sequence) {
+    return `${filePrefix(portfolioId)}${String(sequence).padStart(16, '0')}.json`;
+}
+function hasCode(error, code) {
+    return Boolean(error && typeof error === 'object' && 'code' in error
+        && error.code === code);
+}
+//# sourceMappingURL=file-capacity-control-outbox.js.map

package/lib/portfolio/file-capacity-control-outbox.js.map

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

package/lib/portfolio/file-portfolio-journal.d.ts

@@ -0,0 +1,11 @@
+import { type PortfolioFact, type PortfolioFactDraft, type PortfolioJournalRepository } from './portfolio-journal.js';
+/** Crash-durable immutable-segment adapter for the Portfolio Journal contract. */
+export declare class FilePortfolioJournalRepository implements PortfolioJournalRepository {
+    #private;
+    readonly directory: string;
+    constructor(directory: string);
+    listPortfolioIds(): Promise<readonly string[]>;
+    read(portfolioId: string): Promise<readonly PortfolioFact[]>;
+    append(portfolioId: string, expectedSequence: number, drafts: readonly PortfolioFactDraft[]): Promise<readonly PortfolioFact[]>;
+}
+//# sourceMappingURL=file-portfolio-journal.d.ts.map

package/lib/portfolio/file-portfolio-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-portfolio-journal.d.ts","sourceRoot":"","sources":["../../src/portfolio/file-portfolio-journal.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAChC,MAAM,wBAAwB,CAAC;AAmBhC,kFAAkF;AAClF,qBAAa,8BAA+B,YAAW,0BAA0B;;IAGnE,QAAQ,CAAC,SAAS,EAAE,MAAM;gBAAjB,SAAS,EAAE,MAAM;IAIhC,gBAAgB,IAAI,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;IAsB9C,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC;IAuC5D,MAAM,CACV,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,SAAS,kBAAkB,EAAE,GACpC,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC;CA4BrC"}

package/lib/portfolio/file-portfolio-journal.js

@@ -0,0 +1,196 @@
+import { createHash } from 'node:crypto';
+import { readFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { InMemoryPortfolioJournalRepository, parsePortfolioFactDraft, } from './portfolio-journal.js';
+import { canonicalWorkroomJson, deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue as digest, } from '../workroom/canonical-value.js';
+import { DurableFileStore } from '../workroom/durable-file-store.js';
+/** Crash-durable immutable-segment adapter for the Portfolio Journal contract. */
+export class FilePortfolioJournalRepository {
+    directory;
+    #store;
+    constructor(directory) {
+        this.directory = directory;
+        this.#store = new DurableFileStore(directory);
+    }
+    async listPortfolioIds() {
+        let names;
+        try {
+            names = await readdir(this.directory);
+        }
+        catch (error) {
+            if (hasCode(error, 'ENOENT'))
+                return Object.freeze([]);
+            throw error;
+        }
+        if (names.some(name => name.endsWith('.json') && !isSegmentName(name))) {
+            throw new Error('Invalid Portfolio Journal segment name');
+        }
+        const ids = new Set();
+        for (const name of names.filter(isSegmentName).sort()) {
+            ids.add((await parseSegment(await readFile(join(this.directory, name), 'utf8'), name)).portfolioId);
+        }
+        if (ids.size > 0)
+            await this.#store.syncLeaf();
+        return Object.freeze([...ids].sort());
+    }
+    async read(portfolioId) {
+        const id = identifier(portfolioId, 'portfolioId');
+        const prefix = `${hashId(id)}.`;
+        let names;
+        try {
+            names = await readdir(this.directory);
+        }
+        catch (error) {
+            if (hasCode(error, 'ENOENT'))
+                return Object.freeze([]);
+            throw error;
+        }
+        const candidates = names.filter(name => name.startsWith(prefix) && name.endsWith('.json'));
+        if (candidates.some(name => !isSegmentName(name))) {
+            throw new Error('Invalid Portfolio Journal segment name');
+        }
+        const segments = await Promise.all(candidates.sort().map(async (name) => await parseSegment(await readFile(join(this.directory, name), 'utf8'), name)));
+        if (segments.some(segment => segment.portfolioId !== id)) {
+            throw new Error('Portfolio Journal identifier digest collision');
+        }
+        const validator = new InMemoryPortfolioJournalRepository();
+        const events = [];
+        for (const segment of segments) {
+            if (segment.expectedSequence !== events.length - 1) {
+                throw new Error('Portfolio Journal segment sequence is not contiguous');
+            }
+            const appended = await validator.append(id, segment.expectedSequence, segment.events.map(toDraft));
+            if (canonicalWorkroomJson(appended) !== canonicalWorkroomJson(segment.events)) {
+                throw new Error('Portfolio Journal segment replay drift');
+            }
+            events.push(...appended);
+        }
+        if (events.length > 0)
+            await this.#store.syncLeaf();
+        return deepFreeze(events);
+    }
+    async append(portfolioId, expectedSequence, drafts) {
+        const id = identifier(portfolioId, 'portfolioId');
+        const current = await this.read(id);
+        const validator = await seed(id, current);
+        const appended = await validator.append(id, expectedSequence, drafts);
+        if (appended.length === 0 || appended.every(event => event.sequence <= (current.at(-1)?.sequence ?? -1))) {
+            return appended;
+        }
+        const payload = deepFreeze({
+            version: 1,
+            portfolioId: id,
+            expectedSequence,
+            events: appended,
+        });
+        const segment = deepFreeze({ ...payload, payloadDigest: digest(payload) });
+        await this.#store.ensureDurableLeaf('Portfolio Journal');
+        const target = join(this.directory, segmentName(id, appended[0].sequence));
+        const published = await this.#store.publishCreateOnly({
+            target,
+            content: canonicalWorkroomJson(segment),
+            createdValue: appended,
+            onConflict: async () => {
+                const winner = await this.read(id);
+                return await (await seed(id, winner)).append(id, expectedSequence, drafts);
+            },
+        });
+        return published.value;
+    }
+}
+async function seed(portfolioId, events) {
+    const repository = new InMemoryPortfolioJournalRepository();
+    for (const event of events) {
+        await repository.append(portfolioId, event.sequence - 1, [toDraft(event)]);
+    }
+    return repository;
+}
+function toDraft(event) {
+    return deepFreeze({
+        eventId: event.eventId,
+        occurredAt: event.occurredAt,
+        type: event.type,
+        payload: event.payload,
+    });
+}
+async function parseSegment(serialized, name) {
+    let value;
+    try {
+        value = JSON.parse(serialized);
+    }
+    catch (error) {
+        throw new Error('Portfolio Journal segment is not valid JSON', { cause: error });
+    }
+    if (!isRecord(value) || value.version !== 1 || typeof value.portfolioId !== 'string'
+        || !Number.isSafeInteger(value.expectedSequence) || Number(value.expectedSequence) < -1
+        || !Array.isArray(value.events) || value.events.length === 0
+        || typeof value.payloadDigest !== 'string') {
+        throw new Error('Invalid Portfolio Journal segment');
+    }
+    const segment = value;
+    const expectedSequence = Number(value.expectedSequence);
+    const events = normalizeSegmentEvents(value.events, value.portfolioId, expectedSequence);
+    const payload = {
+        version: 1,
+        portfolioId: identifier(segment.portfolioId, 'portfolioId'),
+        expectedSequence,
+        events,
+    };
+    if (segment.payloadDigest !== digest(payload)) {
+        throw new Error('Portfolio Journal segment payload digest mismatch');
+    }
+    if (name !== segmentName(payload.portfolioId, payload.expectedSequence + 1)) {
+        throw new Error('Portfolio Journal segment first sequence does not match its filename');
+    }
+    return deepFreeze({ ...payload, payloadDigest: segment.payloadDigest });
+}
+function normalizeSegmentEvents(values, portfolioId, expectedSequence) {
+    return deepFreeze(values.map((value, index) => {
+        if (!isRecord(value) || value.version !== 1 || value.portfolioId !== portfolioId
+            || value.sequence !== expectedSequence + index + 1
+            || typeof value.eventId !== 'string' || !value.eventId.trim()
+            || typeof value.occurredAt !== 'number' || !Number.isFinite(value.occurredAt)
+            || typeof value.type !== 'string' || !isRecord(value.payload)) {
+            throw new Error('Invalid Portfolio Journal segment event');
+        }
+        const draft = parsePortfolioFactDraft({
+            eventId: value.eventId,
+            occurredAt: value.occurredAt,
+            type: value.type,
+            payload: value.payload,
+        });
+        const normalized = deepFreeze({
+            version: 1,
+            portfolioId,
+            sequence: value.sequence,
+            ...draft,
+        });
+        if (canonicalWorkroomJson(normalized) !== canonicalWorkroomJson(value)) {
+            throw new Error('Portfolio Journal segment event materialization drift');
+        }
+        return normalized;
+    }));
+}
+function segmentName(portfolioId, firstSequence) {
+    return `${hashId(portfolioId)}.${String(firstSequence).padStart(16, '0')}.json`;
+}
+function hashId(value) {
+    return createHash('sha256').update(value).digest('hex');
+}
+function isSegmentName(name) {
+    return /^[a-f0-9]{64}\.[0-9]{16}\.json$/u.test(name);
+}
+function identifier(value, label) {
+    if (typeof value !== 'string' || !value.trim() || value !== value.trim()) {
+        throw new Error(`Invalid Portfolio ${label}`);
+    }
+    return value;
+}
+function isRecord(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+function hasCode(error, code) {
+    return Boolean(error && typeof error === 'object' && 'code' in error
+        && error.code === code);
+}
+//# sourceMappingURL=file-portfolio-journal.js.map

package/lib/portfolio/file-portfolio-journal.js.map

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

package/lib/portfolio/portfolio-admission.d.ts

@@ -0,0 +1,95 @@
+import { type PortfolioCapacityGrant, type PortfolioCapacityReclaim, type PortfolioCapacityRequest, type PortfolioFact, type PortfolioGovernanceProof, type PortfolioGrantAssignmentFailureReason, type PortfolioJournalRepository, type PortfolioKernelCommandAuthority, type PortfolioPolicySnapshot, type PortfolioPriorityOverride, type PortfolioProjectPolicy, type PortfolioClockAuthority, type PortfolioUsageGatewayAuthority, type PortfolioValidatedBundleAuthority } from './portfolio-journal.js';
+export interface PortfolioRequestState {
+    readonly request: PortfolioCapacityRequest;
+    readonly bundleAuthority: PortfolioValidatedBundleAuthority;
+    readonly requestedAt: number;
+    readonly requestedSequence: number;
+}
+export interface PortfolioAdmissionState {
+    readonly portfolioId: string;
+    readonly sequence: number;
+    readonly now: number;
+    readonly clockSequence: number;
+    readonly clockDigest?: string;
+    readonly usageSettlementCursor: number;
+    readonly policy?: PortfolioPolicySnapshot;
+    readonly requests: Readonly<Record<string, PortfolioRequestState>>;
+    readonly grants: Readonly<Record<string, PortfolioCapacityGrant>>;
+    readonly reclaims: Readonly<Record<string, PortfolioCapacityReclaim>>;
+    readonly overrides: Readonly<Record<string, PortfolioPriorityOverride>>;
+    readonly normalizedService: Readonly<Record<string, number>>;
+    readonly normalizedAtSequence: number;
+}
+export interface PortfolioAdmissionApplicationOptions {
+    readonly portfolioId: string;
+    readonly repository: PortfolioJournalRepository;
+    readonly ids: Readonly<{
+        eventId(type: PortfolioFact['type'], identity: string): string;
+    }>;
+    readonly maxCasAttempts?: number;
+}
+/** Journal-backed Portfolio resource authority. It never writes Workroom facts. */
+export declare class PortfolioAdmissionApplication {
+    #private;
+    readonly options: PortfolioAdmissionApplicationOptions;
+    constructor(options: PortfolioAdmissionApplicationOptions);
+    read(): Promise<PortfolioAdmissionState>;
+    pinPolicy(policy: PortfolioPolicySnapshot, governance: PortfolioGovernanceProof): Promise<void>;
+    updateProjectPolicy(policy: PortfolioProjectPolicy, governance: PortfolioGovernanceProof): Promise<void>;
+    updateProjectPolicies(policies: readonly PortfolioProjectPolicy[], governance: Readonly<Record<string, PortfolioGovernanceProof>>): Promise<void>;
+    setPriorityOverride(override: PortfolioPriorityOverride, governance: PortfolioGovernanceProof): Promise<void>;
+    submit(request: PortfolioCapacityRequest, bundleAuthority: PortfolioValidatedBundleAuthority): Promise<void>;
+    decideAdmission(): Promise<PortfolioCapacityGrant | null>;
+    consume(input: Readonly<{
+        grantId: string;
+        projectId: string;
+        fence: number;
+        assignmentRef: string;
+    }>, authority: PortfolioKernelCommandAuthority): Promise<void>;
+    failAssignment(input: Readonly<{
+        grantId: string;
+        projectId: string;
+        fence: number;
+        assignmentRef: string;
+        reason: PortfolioGrantAssignmentFailureReason;
+        kernelSequence: number;
+        kernelFactDigest: string;
+    }>, authority: PortfolioKernelCommandAuthority): Promise<void>;
+    renewLease(input: Readonly<{
+        grantId: string;
+        projectId: string;
+        fence: number;
+        assignmentRef: string;
+        heartbeatSequence: number;
+    }>, authority: PortfolioKernelCommandAuthority): Promise<void>;
+    acknowledgeReclaim(input: Readonly<{
+        reclaimId: string;
+        projectId: string;
+        fence: number;
+        outcome: 'checkpointed' | 'declined';
+        checkpointRef?: string;
+        checkpointDigest?: string;
+    }>, authority: PortfolioKernelCommandAuthority): Promise<void>;
+    settleUsage(authority: PortfolioUsageGatewayAuthority): Promise<void>;
+    advanceClock(authority: PortfolioClockAuthority): Promise<void>;
+    normalizeService(divisor: number): Promise<void>;
+}
+export declare function replayPortfolioAdmission(portfolioId: string, facts: readonly PortfolioFact[]): PortfolioAdmissionState;
+export declare function portfolioRequestStatus(state: PortfolioAdmissionState, requestId: string): 'pending' | 'granted' | 'usage_blocked' | 'settled';
+export declare function portfolioProjectBudget(state: PortfolioAdmissionState, projectId: string): {
+    limitMicros: number;
+    spentMicros: number;
+    reservedMicros: number;
+    availableMicros: number;
+};
+export declare function portfolioRequestBlockers(state: PortfolioAdmissionState, requestId: string): readonly string[];
+export declare function portfolioCapacityRequestDigest(request: PortfolioCapacityRequest): string;
+export declare function portfolioValidatedBundleDigest(authority: Omit<PortfolioValidatedBundleAuthority, 'validatedBundleDigest'> | PortfolioValidatedBundleAuthority): string;
+type KernelAuthorityClaims = Omit<PortfolioKernelCommandAuthority, 'commandDigest' | 'authorizedBy'>;
+type UsageAuthorityClaims = Omit<PortfolioUsageGatewayAuthority, 'receiptDigest' | 'authenticatedBy'>;
+type ClockAuthorityClaims = Omit<PortfolioClockAuthority, 'clockDigest' | 'authorizedBy'>;
+export declare function portfolioKernelCommandDigest(claims: KernelAuthorityClaims): string;
+export declare function portfolioUsageReceiptDigest(claims: UsageAuthorityClaims): string;
+export declare function portfolioClockDigest(claims: ClockAuthorityClaims): string;
+export {};
+//# sourceMappingURL=portfolio-admission.d.ts.map