@zhin.js/workroom 0.0.0 → 0.0.2

package/lib/workroom/file-profile-journal.d.ts

@@ -0,0 +1,33 @@
+import { type ProjectProfileEvent, type ProjectProfileEventDraft, type ProjectProfileJournal } from './profile-registry.js';
+export interface ProjectProfileJournalFileHandle {
+    writeFile(value: string, encoding: 'utf8'): Promise<void>;
+    sync(): Promise<void>;
+    close(): Promise<void>;
+}
+/** Injectable only at the durable filesystem boundary. */
+export interface ProjectProfileJournalFileSystem {
+    readonly supportsDirectorySync?: boolean;
+    mkdir(path: string): Promise<void>;
+    readdir(path: string): Promise<readonly string[]>;
+    readFile(path: string, encoding: 'utf8'): Promise<string>;
+    open(path: string, flags: 'wx' | 'r'): Promise<ProjectProfileJournalFileHandle>;
+    link(existingPath: string, newPath: string): Promise<void>;
+    unlink(path: string): Promise<void>;
+}
+/**
+ * Crash-durable Project Profile Registry Journal.
+ *
+ * The configured leaf is created non-recursively. Its parent must already be
+ * durable; the adapter fsyncs that parent before publishing the first segment.
+ * Every append is an immutable segment, and a hard link to the first-sequence
+ * pathname is the cross-process expected-revision CAS.
+ */
+export declare class FileProjectProfileJournal implements ProjectProfileJournal {
+    #private;
+    readonly directory: string;
+    readonly fileSystem: ProjectProfileJournalFileSystem;
+    constructor(directory: string, fileSystem?: ProjectProfileJournalFileSystem);
+    read(projectId: string): Promise<readonly ProjectProfileEvent[]>;
+    append(projectId: string, expectedRevision: number, drafts: readonly ProjectProfileEventDraft[]): Promise<readonly ProjectProfileEvent[]>;
+}
+//# sourceMappingURL=file-profile-journal.d.ts.map

package/lib/workroom/file-profile-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-profile-journal.d.ts","sourceRoot":"","sources":["../../src/workroom/file-profile-journal.ts"],"names":[],"mappings":"AAeA,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAE/B,MAAM,WAAW,+BAA+B;IAC9C,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,0DAA0D;AAC1D,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,GAAG,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAChF,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAgCD;;;;;;;GAOG;AACH,qBAAa,yBAA0B,YAAW,qBAAqB;;IAEnE,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,UAAU,EAAE,+BAA+B;gBAD3C,SAAS,EAAE,MAAM,EACjB,UAAU,GAAE,+BAAgD;IAGjE,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC;IAQhE,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,SAAS,wBAAwB,EAAE,GAC1C,OAAO,CAAC,SAAS,mBAAmB,EAAE,CAAC;CA0J3C"}

package/lib/workroom/file-profile-journal.js

@@ -0,0 +1,311 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { link as nodeLink, mkdir as nodeMkdir, open as nodeOpen, readFile as nodeReadFile, readdir as nodeReaddir, unlink as nodeUnlink, } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { canonicalWorkroomJson, deepFreezeWorkroomValue as deepFreeze, digestCanonicalWorkroomValue, } from './canonical-value.js';
+import { ProfileRegistrySequenceConflictError, replayProjectProfileJournal, } from './profile-registry.js';
+const nodeFileSystem = Object.freeze({
+    supportsDirectorySync: process.platform !== 'win32',
+    mkdir: async (path) => {
+        await nodeMkdir(path);
+    },
+    readdir: async (path) => await nodeReaddir(path),
+    readFile: async (path, encoding) => await nodeReadFile(path, encoding),
+    open: async (path, flags) => await nodeOpen(path, flags),
+    link: async (existingPath, newPath) => await nodeLink(existingPath, newPath),
+    unlink: async (path) => await nodeUnlink(path),
+});
+/**
+ * Crash-durable Project Profile Registry Journal.
+ *
+ * The configured leaf is created non-recursively. Its parent must already be
+ * durable; the adapter fsyncs that parent before publishing the first segment.
+ * Every append is an immutable segment, and a hard link to the first-sequence
+ * pathname is the cross-process expected-revision CAS.
+ */
+export class FileProjectProfileJournal {
+    directory;
+    fileSystem;
+    constructor(directory, fileSystem = nodeFileSystem) {
+        this.directory = directory;
+        this.fileSystem = fileSystem;
+    }
+    async read(projectId) {
+        const events = await this.#readEvents(identifier(projectId, 'projectId'));
+        // A previous writer may have linked the segment and then observed a failed
+        // directory fsync. Re-sync before a retry is allowed to confirm that fact.
+        if (events.length > 0)
+            await this.#syncDirectoryPath(this.directory);
+        return events;
+    }
+    async append(projectId, expectedRevision, drafts) {
+        const id = identifier(projectId, 'projectId');
+        expectedRegistryRevision(expectedRevision);
+        const snapshottedDrafts = snapshotDrafts(drafts);
+        const current = await this.#readEvents(id);
+        const replayed = exactReplay(current, expectedRevision, snapshottedDrafts);
+        if (replayed) {
+            if (current.length > 0)
+                await this.#syncDirectoryPath(this.directory);
+            return replayed;
+        }
+        const actualRevision = current.at(-1)?.sequence ?? -1;
+        if (actualRevision !== expectedRevision) {
+            throw new ProfileRegistrySequenceConflictError(id, expectedRevision, actualRevision);
+        }
+        if (snapshottedDrafts.length === 0)
+            return Object.freeze([]);
+        const events = deepFreeze(snapshottedDrafts.map((draft, index) => ({
+            ...draft,
+            version: 1,
+            projectId: id,
+            sequence: expectedRevision + index + 1,
+        })));
+        replayProjectProfileJournal(id, Object.freeze([...current, ...events]));
+        const payload = deepFreeze({
+            version: 1,
+            projectId: id,
+            expectedRegistryRevision: expectedRevision,
+            firstSequence: events[0].sequence,
+            lastSequence: events.at(-1).sequence,
+            events,
+        });
+        const segment = deepFreeze({
+            ...payload,
+            payloadDigest: digestCanonicalWorkroomValue(payload),
+        });
+        await this.#ensureDurableLeaf();
+        const path = this.#segmentPath(id, segment.firstSequence);
+        const temporaryPath = path + '.' + randomUUID() + '.tmp';
+        let temporaryExists = false;
+        try {
+            const handle = await this.fileSystem.open(temporaryPath, 'wx');
+            temporaryExists = true;
+            try {
+                await handle.writeFile(JSON.stringify(segment), 'utf8');
+                await handle.sync();
+            }
+            finally {
+                await handle.close();
+            }
+            await this.fileSystem.link(temporaryPath, path);
+            await this.fileSystem.unlink(temporaryPath);
+            temporaryExists = false;
+            await this.#syncDirectoryPath(this.directory);
+        }
+        catch (error) {
+            if (temporaryExists) {
+                await this.#removeTemporary(temporaryPath);
+                temporaryExists = false;
+            }
+            if (isAlreadyExists(error)) {
+                const winner = await this.#readEvents(id);
+                const exact = exactReplay(winner, expectedRevision, snapshottedDrafts);
+                await this.#syncDirectoryPath(this.directory);
+                if (exact)
+                    return exact;
+                throw new ProfileRegistrySequenceConflictError(id, expectedRevision, winner.at(-1)?.sequence ?? -1);
+            }
+            throw error;
+        }
+        finally {
+            if (temporaryExists)
+                await this.#removeTemporary(temporaryPath);
+        }
+        return events;
+    }
+    async #readEvents(projectId) {
+        const prefix = projectFilePrefix(projectId);
+        let names;
+        try {
+            names = await this.fileSystem.readdir(this.directory);
+        }
+        catch (error) {
+            if (isMissingFile(error))
+                return Object.freeze([]);
+            throw error;
+        }
+        const segmentNames = names
+            .filter(name => name.startsWith(prefix) && name.endsWith('.json'))
+            .sort();
+        for (const name of segmentNames) {
+            if (!segmentNamePattern(prefix).test(name)) {
+                throw new Error('Invalid Project Profile Journal segment name');
+            }
+        }
+        const segments = await Promise.all(segmentNames.map(async (name) => parseSegment(await this.fileSystem.readFile(join(this.directory, name), 'utf8'), projectId, Number(name.slice(prefix.length, prefix.length + 16)))));
+        const events = [];
+        let expectedFirstSequence = 0;
+        for (const segment of segments) {
+            if (segment.firstSequence !== expectedFirstSequence
+                || segment.expectedRegistryRevision !== expectedFirstSequence - 1) {
+                throw new Error('Project Profile Journal segment sequence gap');
+            }
+            events.push(...segment.events);
+            expectedFirstSequence = segment.lastSequence + 1;
+        }
+        const frozen = deepFreeze(events);
+        replayProjectProfileJournal(projectId, frozen);
+        return frozen;
+    }
+    #segmentPath(projectId, firstSequence) {
+        return join(this.directory, projectFilePrefix(projectId) + String(firstSequence).padStart(16, '0') + '.json');
+    }
+    async #ensureDurableLeaf() {
+        try {
+            await this.fileSystem.mkdir(this.directory);
+        }
+        catch (error) {
+            if (!isAlreadyExists(error)) {
+                if (isMissingFile(error)) {
+                    throw new Error('Project Profile Journal requires a pre-existing durable parent directory: '
+                        + dirname(this.directory), { cause: error });
+                }
+                throw error;
+            }
+        }
+        await this.#syncDirectoryPath(dirname(this.directory));
+    }
+    async #syncDirectoryPath(path) {
+        if (this.fileSystem.supportsDirectorySync === false)
+            return;
+        const handle = await this.fileSystem.open(path, 'r');
+        try {
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    async #removeTemporary(path) {
+        await this.fileSystem.unlink(path).catch(error => {
+            if (!isMissingFile(error))
+                throw error;
+        });
+    }
+}
+function snapshotDrafts(drafts) {
+    if (!Array.isArray(drafts))
+        throw new Error('Invalid Project Profile Journal event drafts');
+    return deepFreeze(drafts.map(draft => {
+        const encoded = JSON.stringify(draft);
+        if (typeof encoded !== 'string')
+            throw new Error('Invalid Project Profile Journal event draft');
+        return JSON.parse(encoded);
+    }));
+}
+function exactReplay(current, expectedRevision, drafts) {
+    if (drafts.length === 0)
+        return current.at(-1)?.sequence === expectedRevision
+            ? Object.freeze([])
+            : undefined;
+    const firstSequence = expectedRevision + 1;
+    if (firstSequence < 0 || firstSequence + drafts.length > current.length)
+        return undefined;
+    const persisted = current.slice(firstSequence, firstSequence + drafts.length);
+    const persistedDrafts = persisted.map(({ version: _version, projectId: _projectId, sequence: _sequence, ...draft }) => draft);
+    if (canonicalWorkroomJson(persistedDrafts) === canonicalWorkroomJson(drafts)) {
+        return deepFreeze(persisted);
+    }
+    if (persisted.length > 0) {
+        throw new Error('Project Profile Journal replay payload drift at registry revision '
+            + expectedRevision);
+    }
+    return undefined;
+}
+function parseSegment(value, projectId, fileFirstSequence) {
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch (error) {
+        throw new Error('Invalid Project Profile Journal segment JSON', { cause: error });
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error('Invalid Project Profile Journal segment');
+    }
+    const segment = parsed;
+    if (segment.version !== 1
+        || segment.projectId !== projectId
+        || !Number.isSafeInteger(segment.expectedRegistryRevision)
+        || !Number.isSafeInteger(segment.firstSequence)
+        || !Number.isSafeInteger(segment.lastSequence)
+        || !Array.isArray(segment.events)
+        || typeof segment.payloadDigest !== 'string') {
+        throw new Error('Invalid Project Profile Journal segment');
+    }
+    const segmentExpectedRevision = segment.expectedRegistryRevision;
+    const segmentFirstSequence = segment.firstSequence;
+    const segmentLastSequence = segment.lastSequence;
+    const events = segment.events.map(parseEvent);
+    if (segmentFirstSequence !== fileFirstSequence) {
+        throw new Error('Project Profile Journal segment name position mismatch');
+    }
+    if (events.length === 0
+        || events[0].sequence !== segmentFirstSequence
+        || events.at(-1).sequence !== segmentLastSequence
+        || segmentFirstSequence !== segmentExpectedRevision + 1) {
+        throw new Error('Invalid Project Profile Journal segment position');
+    }
+    for (let index = 0; index < events.length; index += 1) {
+        const event = events[index];
+        if (event.projectId !== projectId || event.sequence !== segmentFirstSequence + index) {
+            throw new Error('Invalid Project Profile Journal event position');
+        }
+    }
+    const payload = deepFreeze({
+        version: 1,
+        projectId,
+        expectedRegistryRevision: segmentExpectedRevision,
+        firstSequence: segmentFirstSequence,
+        lastSequence: segmentLastSequence,
+        events,
+    });
+    if (segment.payloadDigest !== digestCanonicalWorkroomValue(payload)) {
+        throw new Error('Project Profile Journal segment payload digest mismatch');
+    }
+    return deepFreeze({ ...payload, payloadDigest: segment.payloadDigest });
+}
+function parseEvent(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Invalid Project Profile Journal event');
+    }
+    const event = value;
+    if (event.version !== 1
+        || typeof event.projectId !== 'string'
+        || !Number.isSafeInteger(event.sequence)
+        || !['profile.revision_registered', 'profile.revision_activated', 'run.profile_pinned']
+            .includes(event.type ?? '')
+        || !event.payload
+        || typeof event.payload !== 'object'
+        || Array.isArray(event.payload)) {
+        throw new Error('Invalid Project Profile Journal event');
+    }
+    return deepFreeze(event);
+}
+function identifier(value, name) {
+    if (typeof value !== 'string' || !value.trim() || value !== value.trim()) {
+        throw new Error('Invalid Project Profile Journal ' + name);
+    }
+    return value;
+}
+function expectedRegistryRevision(value) {
+    if (!Number.isSafeInteger(value) || value < -1) {
+        throw new Error('Invalid Project Profile Journal expected registry revision');
+    }
+    return value;
+}
+function projectFilePrefix(projectId) {
+    return createHash('sha256').update(projectId).digest('hex') + '.';
+}
+function segmentNamePattern(prefix) {
+    return new RegExp('^' + prefix.replace('.', '\\.') + '\\d{16}\\.json$', 'u');
+}
+function isAlreadyExists(error) {
+    return Boolean(error && typeof error === 'object' && 'code' in error
+        && error.code === 'EEXIST');
+}
+function isMissingFile(error) {
+    return Boolean(error && typeof error === 'object' && 'code' in error
+        && error.code === 'ENOENT');
+}
+//# sourceMappingURL=file-profile-journal.js.map

package/lib/workroom/file-profile-journal.js.map

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

package/lib/workroom/git-workspace-gateway.d.ts

@@ -0,0 +1,152 @@
+export interface GitWorkspaceLeaseInput {
+    readonly leaseRef: string;
+    readonly projectId: string;
+    readonly runId: string;
+    readonly taskKey: string;
+    readonly taskRevision: number;
+    readonly assignmentId: string;
+    readonly attempt: number;
+    readonly fence: number;
+    readonly repository: Readonly<{
+        id: string;
+        bindingRef: string;
+        bindingDigest: string;
+    }>;
+    readonly baseSha: string;
+    readonly checkpointSha?: string;
+    readonly targetRef: string;
+    readonly attemptBranch: string;
+    readonly pathScopes: readonly string[];
+    readonly mode: 'branch_only' | 'pull_request';
+    readonly expiresAt: number;
+}
+export interface GitWorkspaceLease extends GitWorkspaceLeaseInput {
+    readonly version: 1;
+    readonly digest: string;
+}
+export interface GitWorkspaceCredential {
+    readonly credentialId: string;
+    readonly secret: string;
+    readonly expiresAt: number;
+}
+export interface GitWorkspaceCredentialPort {
+    resolve(input: Readonly<{
+        generation: number;
+        leaseDigest: string;
+        repositoryId: string;
+        bindingRef: string;
+        bindingDigest: string;
+        operation: 'git_push' | 'git_open_pr' | 'git_cancel_remote';
+    }>, signal: AbortSignal): Promise<GitWorkspaceCredential>;
+}
+export interface GitPushTransportInput {
+    readonly operationId: string;
+    readonly repositoryId: string;
+    readonly ref: string;
+    readonly headSha: string;
+    readonly force: false;
+    readonly baseSha: string;
+    readonly pathScopes: readonly string[];
+    readonly idempotencyKey: string;
+}
+export interface GitPullRequestTransportInput {
+    readonly baseSha: string;
+    readonly pathScopes: readonly string[];
+    readonly operationId: string;
+    readonly repositoryId: string;
+    readonly headRef: string;
+    readonly baseRef: string;
+    readonly headSha: string;
+    readonly idempotencyKey: string;
+}
+export interface GitWorkspaceTransportPort {
+    push(input: GitPushTransportInput, credential: GitWorkspaceCredential, signal: AbortSignal): Promise<GitPushReceipt>;
+    openPullRequest(input: GitPullRequestTransportInput, credential: GitWorkspaceCredential, signal: AbortSignal): Promise<GitPullRequestReceipt>;
+    cancel(input: Readonly<{
+        operationId: string;
+        repositoryId: string;
+        remoteOperationId: string;
+        idempotencyKey: string;
+    }>, credential: GitWorkspaceCredential, signal: AbortSignal): Promise<Readonly<{
+        repositoryId: string;
+        remoteOperationId: string;
+        acknowledged: boolean;
+        provider: {
+            id: string;
+            digest: string;
+        };
+        receiptRef: string;
+        receiptDigest: string;
+    }>>;
+}
+export interface GitPushReceipt {
+    readonly provider: Readonly<{
+        id: string;
+        digest: string;
+    }>;
+    readonly repositoryId: string;
+    readonly ref: string;
+    readonly headSha: string;
+    readonly externalReceiptRef: string;
+    readonly externalReceiptDigest: string;
+}
+export interface GitPullRequestReceipt {
+    readonly provider: Readonly<{
+        id: string;
+        digest: string;
+    }>;
+    readonly repositoryId: string;
+    readonly prRef: string;
+    readonly headRef: string;
+    readonly baseRef: string;
+    readonly prHeadSha: string;
+    readonly externalReceiptDigest: string;
+}
+export interface GitCancelReceipt {
+    readonly provider: Readonly<{
+        id: string;
+        digest: string;
+    }>;
+    readonly repositoryId: string;
+    readonly remoteOperationId: string;
+    readonly acknowledged: boolean;
+    readonly externalReceiptRef: string;
+    readonly externalReceiptDigest: string;
+}
+export declare function createGitWorkspaceLease(input: GitWorkspaceLeaseInput): GitWorkspaceLease;
+export interface GitWorkspaceGatewayOptions {
+    readonly generation: number;
+    readonly credentials: GitWorkspaceCredentialPort;
+    readonly transport: GitWorkspaceTransportPort;
+    readonly now?: () => number;
+}
+/** The only component that sees credentials; callers supply only an immutable lease. */
+export declare class GitWorkspaceGateway {
+    #private;
+    readonly options: GitWorkspaceGatewayOptions;
+    constructor(options: GitWorkspaceGatewayOptions);
+    push(input: Readonly<{
+        operationId: string;
+        lease: GitWorkspaceLease;
+        fence: number;
+        ref: string;
+        headSha: string;
+        changedPaths: readonly string[];
+        force: boolean;
+    }>, signal: AbortSignal): Promise<GitPushReceipt>;
+    openPullRequest(input: Readonly<{
+        operationId: string;
+        lease: GitWorkspaceLease;
+        fence: number;
+        headRef: string;
+        baseRef: string;
+        headSha: string;
+    }>, signal: AbortSignal): Promise<GitPullRequestReceipt>;
+    cancel(input: Readonly<{
+        operationId: string;
+        lease: GitWorkspaceLease;
+        fence: number;
+        remoteOperationId: string;
+    }>, signal: AbortSignal): Promise<GitCancelReceipt>;
+}
+//# sourceMappingURL=git-workspace-gateway.d.ts.map

package/lib/workroom/git-workspace-gateway.d.ts.map

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