@software-dlc/cli 0.157.2

package/dist/local/workspace-graph-store.js

@@ -0,0 +1,249 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { chmod, link, lstat, mkdir, readdir, readFile, rm, unlink, utimes, writeFile } from 'node:fs/promises';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+import { portable_graph_schema } from '@software-dlc/graph/schema';
+import { canonicalizePortableGraph, stringifyCanonicalGraph } from './canonical.js';
+import { withWorkspaceOperationLock } from './workspace-lock.js';
+const SHA256_ROOT_PATTERN = /^sha256:([0-9a-f]{64})$/;
+const GRAPH_OBJECT_PATTERN = /^([0-9a-f]{64})\.json$/;
+const GRAPH_OBJECT_TEMPORARY_PATTERN = /^([0-9a-f]{64})\.json\.tmp-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
+export function resolveLocalRepositoryStateDirectory(input) {
+    const override = input.override ?? process.env.SDLC_REPOSITORY_STATE_DIR;
+    if (override)
+        return resolve(override);
+    if (!isAbsolute(input.git_common_dir)) {
+        throw new Error('Git common directory must be an absolute path.');
+    }
+    return join(resolve(input.git_common_dir), 'sdlc', 'repository-v1');
+}
+function canonicalGraphJson(graph) {
+    return stringifyCanonicalGraph(canonicalizePortableGraph(portable_graph_schema.parse(graph)));
+}
+function sha256Root(text) {
+    return `sha256:${createHash('sha256').update(text).digest('hex')}`;
+}
+export function localGraphRootHash(graph) {
+    return sha256Root(canonicalGraphJson(graph));
+}
+function objectPath(state_dir, root_hash) {
+    const match = root_hash.match(SHA256_ROOT_PATTERN);
+    if (!match)
+        throw new Error('Graph root must be a sha256 hash.');
+    const digest = match[1];
+    return join(state_dir, 'objects', digest.slice(0, 2), `${digest}.json`);
+}
+export class LocalWorkspaceGraphStore {
+    state_dir;
+    constructor(state_dir) {
+        if (!isAbsolute(state_dir)) {
+            throw new Error('Workspace graph store directory must be absolute.');
+        }
+        this.state_dir = resolve(state_dir);
+    }
+    async writeGraph(graph) {
+        // The object holds exactly the canonical JSON its name hashes, so a read
+        // verifies it by hashing its bytes.
+        const graph_json = canonicalGraphJson(graph);
+        const root_hash = sha256Root(graph_json);
+        return this.withGraphObjectLock(root_hash, 'write-graph', () => this.writeGraphUnlocked(root_hash, graph_json));
+    }
+    async withGraphObjectLock(root_hash, operation, run) {
+        objectPath(this.state_dir, root_hash);
+        const digest = root_hash.slice('sha256:'.length);
+        return withWorkspaceOperationLock({
+            control_dir: join(this.state_dir, 'locks', 'graph-objects', digest.slice(0, 2), digest),
+            operation,
+            run
+        });
+    }
+    async withObjectStoreLock(operation, run) {
+        return withWorkspaceOperationLock({
+            control_dir: join(this.state_dir, 'locks', 'objects'),
+            operation,
+            run
+        });
+    }
+    async listGraphObjects() {
+        const objects_dir = join(this.state_dir, 'objects');
+        const shards = await readdir(objects_dir, { withFileTypes: true }).catch((error) => {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        });
+        const objects = [];
+        const temporary_objects = [];
+        for (const shard of shards) {
+            if (!shard.isDirectory() || !/^[0-9a-f]{2}$/.test(shard.name)) {
+                throw new Error('Graph object store contains an unexpected entry.');
+            }
+            const shard_path = join(objects_dir, shard.name);
+            const entries = await readdir(shard_path, { withFileTypes: true });
+            for (const entry of entries) {
+                const object_match = entry.name.match(GRAPH_OBJECT_PATTERN);
+                if (entry.isFile() &&
+                    object_match &&
+                    entry.name.startsWith(shard.name)) {
+                    const root_hash = `sha256:${object_match[1]}`;
+                    const object = await this.inspectGraphObject(root_hash);
+                    if (object)
+                        objects.push(object);
+                    continue;
+                }
+                const temporary_match = entry.name.match(GRAPH_OBJECT_TEMPORARY_PATTERN);
+                if (!entry.isFile() ||
+                    !temporary_match ||
+                    !entry.name.startsWith(shard.name)) {
+                    throw new Error('Graph object store contains an unexpected entry.');
+                }
+                temporary_objects.push({
+                    root_hash: `sha256:${temporary_match[1]}`,
+                    temporary_path: join(shard_path, entry.name)
+                });
+            }
+        }
+        for (const temporary_object of temporary_objects) {
+            await this.removeTemporaryGraphObject(temporary_object.root_hash, temporary_object.temporary_path);
+        }
+        return objects.sort((left, right) => left.root_hash.localeCompare(right.root_hash));
+    }
+    async pruneGraphObject(input) {
+        return this.withGraphObjectLock(input.root_hash, 'prune-graph-object', async () => {
+            if (input.is_retained())
+                return 'retained';
+            const current = await this.inspectGraphObject(input.root_hash);
+            if (!current)
+                return 'absent';
+            if (current.size_bytes !== input.expected_size_bytes ||
+                new Date(current.modified_at_ms).toISOString() !==
+                    input.expected_modified_at) {
+                return 'changed';
+            }
+            const object_path = objectPath(this.state_dir, input.root_hash);
+            try {
+                await unlink(object_path);
+                return 'removed';
+            }
+            catch (error) {
+                const code = typeof error === 'object' && error !== null && 'code' in error
+                    ? error.code
+                    : null;
+                if (code === 'ENOENT')
+                    return 'absent';
+                throw error;
+            }
+        });
+    }
+    async inspectGraphObject(root_hash) {
+        const object_path = objectPath(this.state_dir, root_hash);
+        let metadata;
+        try {
+            metadata = await lstat(object_path);
+        }
+        catch (error) {
+            const code = typeof error === 'object' && error !== null && 'code' in error
+                ? error.code
+                : null;
+            if (code === 'ENOENT')
+                return null;
+            throw error;
+        }
+        if (!metadata.isFile()) {
+            throw new Error('Graph object store contains an unexpected entry.');
+        }
+        return {
+            root_hash,
+            object_path,
+            size_bytes: metadata.size,
+            modified_at_ms: metadata.mtimeMs
+        };
+    }
+    async removeTemporaryGraphObject(root_hash, temporary_path) {
+        await this.withGraphObjectLock(root_hash, 'recover-graph-object-temporary', async () => {
+            let metadata;
+            try {
+                metadata = await lstat(temporary_path);
+            }
+            catch (error) {
+                const code = typeof error === 'object' && error !== null && 'code' in error
+                    ? error.code
+                    : null;
+                if (code === 'ENOENT')
+                    return;
+                throw error;
+            }
+            if (!metadata.isFile()) {
+                throw new Error('Graph object store contains an unexpected entry.');
+            }
+            await unlink(temporary_path).catch((error) => {
+                if (error.code !== 'ENOENT')
+                    throw error;
+            });
+        });
+    }
+    async writeGraphUnlocked(root_hash, graph_json) {
+        const object_path = objectPath(this.state_dir, root_hash);
+        await mkdir(join(this.state_dir, 'objects'), {
+            recursive: true,
+            mode: 0o700
+        });
+        await mkdir(dirname(object_path), { recursive: true, mode: 0o700 });
+        const temporary_path = `${object_path}.tmp-${randomUUID()}`;
+        try {
+            await writeFile(temporary_path, graph_json, {
+                encoding: 'utf8',
+                mode: 0o600,
+                flag: 'wx'
+            });
+            try {
+                await link(temporary_path, object_path);
+            }
+            catch (error) {
+                const code = typeof error === 'object' && error !== null && 'code' in error
+                    ? error.code
+                    : null;
+                if (code !== 'EEXIST')
+                    throw error;
+            }
+        }
+        finally {
+            await rm(temporary_path, { force: true });
+        }
+        if (!(await lstat(object_path)).isFile()) {
+            throw new Error('Graph object path is not a regular file.');
+        }
+        await chmod(object_path, 0o600);
+        const retained_at = new Date();
+        await utimes(object_path, retained_at, retained_at);
+        // An object already stored with other bytes passes when a read verifies
+        // it, as readGraph does.
+        if ((await readFile(object_path, 'utf8')) !== graph_json) {
+            await this.readGraph(root_hash).catch(() => {
+                throw new Error('Persisted graph object failed root verification.');
+            });
+        }
+        return root_hash;
+    }
+    async readGraph(root_hash) {
+        const object_path = objectPath(this.state_dir, root_hash);
+        let text;
+        let parsed;
+        try {
+            text = await readFile(object_path, 'utf8');
+            parsed = JSON.parse(text);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Local graph object ${root_hash} is unavailable: ${message}`);
+        }
+        const graph = canonicalizePortableGraph(portable_graph_schema.parse(parsed));
+        // Hashing the stored bytes verifies an object this store wrote without
+        // serializing it again. Bytes that are not canonical (an older writer)
+        // are verified by their canonical form.
+        if (sha256Root(text) !== root_hash &&
+            localGraphRootHash(graph) !== root_hash) {
+            throw new Error(`Local graph object ${root_hash} failed verification.`);
+        }
+        return graph;
+    }
+}
+//# sourceMappingURL=workspace-graph-store.js.map

package/dist/local/workspace-graph-store.js.map

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

package/dist/local/workspace-handoff.d.ts

@@ -0,0 +1,32 @@
+import type { LocalHandoffApplyResult, LocalHandoffInspection, LocalHandoffPrepareResult } from './workspace-history-types.js';
+import type { LocalWorkspaceStoreDatabase } from './workspace-store-database.js';
+export type LocalHandoffWorkspace = {
+    id: string;
+    source_workspace_id: string | null;
+    head_sdlc_commit_id: string;
+    attached_ref: string | null;
+    status: 'active' | 'closed';
+};
+type LocalHandoffDependencies = {
+    database: LocalWorkspaceStoreDatabase;
+    requireActiveWorkspace: (workspace_id: string) => LocalHandoffWorkspace;
+    requireValidatedCommit: (commit_id: string) => void;
+    isAncestor: (ancestor_id: string, descendant_id: string) => boolean;
+    advanceWorkspaceHead: (workspace: LocalHandoffWorkspace, next_commit_id: string) => void;
+};
+export declare function prepareLocalHandoff(dependencies: LocalHandoffDependencies, input: {
+    actor_workspace_id: string;
+    source_workspace_id: string;
+    expected_source_commit_id: string;
+    expected_child_commit_id: string;
+}): LocalHandoffPrepareResult;
+export declare function applyLocalHandoff(dependencies: LocalHandoffDependencies, input: {
+    actor_workspace_id: string;
+    handoff_id: string;
+}): LocalHandoffApplyResult;
+export declare function inspectLocalHandoff(dependencies: LocalHandoffDependencies, input: {
+    actor_workspace_id: string;
+    handoff_id: string;
+}): LocalHandoffInspection;
+export {};
+//# sourceMappingURL=workspace-handoff.d.ts.map

package/dist/local/workspace-handoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-handoff.d.ts","sourceRoot":"","sources":["../../src/local/workspace-handoff.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EAC1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAEjF,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC7B,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,QAAQ,EAAE,2BAA2B,CAAC;IACtC,sBAAsB,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,qBAAqB,CAAC;IACxE,sBAAsB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,UAAU,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC;IACpE,oBAAoB,EAAE,CACpB,SAAS,EAAE,qBAAqB,EAChC,cAAc,EAAE,MAAM,KACnB,IAAI,CAAC;CACX,CAAC;AA+DF,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,wBAAwB,EACtC,KAAK,EAAE;IACL,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yBAAyB,EAAE,MAAM,CAAC;IAClC,wBAAwB,EAAE,MAAM,CAAC;CAClC,GACA,yBAAyB,CAiE3B;AAED,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,wBAAwB,EACtC,KAAK,EAAE;IAAE,kBAAkB,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACxD,uBAAuB,CAkDzB;AAED,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,wBAAwB,EACtC,KAAK,EAAE;IAAE,kBAAkB,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACxD,sBAAsB,CA0BxB"}

package/dist/local/workspace-handoff.js

@@ -0,0 +1,144 @@
+import { randomUUID } from 'node:crypto';
+function requireHandoff(dependencies, handoff_id) {
+    const handoff = dependencies.database
+        .prepare('select * from local_handoff where id = ?')
+        .get(handoff_id);
+    if (!handoff)
+        throw new Error('Handoff was not found.');
+    return handoff;
+}
+function handoffAttempts(dependencies, handoff_id) {
+    return dependencies.database
+        .prepare(`
+        select * from local_handoff_attempt
+        where handoff_id = ?
+        order by rowid asc
+      `)
+        .all(handoff_id);
+}
+function assertHandoffLineage(child, source) {
+    if (child.source_workspace_id !== source.id) {
+        throw new Error('Handoff target must be the recorded source workspace.');
+    }
+}
+function insertHandoffAttempt(input) {
+    input.database
+        .prepare(`
+        insert into local_handoff_attempt (
+          id, handoff_id, status, observed_source_commit_id,
+          observed_child_commit_id, created_at
+        ) values (?, ?, ?, ?, ?, ?)
+      `)
+        .run(randomUUID(), input.handoff.id, input.status, input.source_commit_id, input.child_commit_id, new Date().toISOString());
+}
+export function prepareLocalHandoff(dependencies, input) {
+    const child = dependencies.requireActiveWorkspace(input.actor_workspace_id);
+    const source = dependencies.requireActiveWorkspace(input.source_workspace_id);
+    assertHandoffLineage(child, source);
+    if (source.head_sdlc_commit_id !== input.expected_source_commit_id ||
+        child.head_sdlc_commit_id !== input.expected_child_commit_id ||
+        !dependencies.isAncestor(input.expected_source_commit_id, input.expected_child_commit_id)) {
+        return {
+            version: 1,
+            status: 'stale_base',
+            current_source_commit_id: source.head_sdlc_commit_id,
+            current_child_commit_id: child.head_sdlc_commit_id
+        };
+    }
+    dependencies.requireValidatedCommit(input.expected_child_commit_id);
+    const now = new Date().toISOString();
+    const proposed_handoff = {
+        id: randomUUID(),
+        source_workspace_id: source.id,
+        source_commit_id: input.expected_source_commit_id,
+        child_workspace_id: child.id,
+        child_commit_id: input.expected_child_commit_id,
+        created_at: now
+    };
+    dependencies.database
+        .prepare(`
+        insert into local_handoff (
+          id, source_workspace_id, source_commit_id,
+          child_workspace_id, child_commit_id, created_at
+        ) values (?, ?, ?, ?, ?, ?)
+        on conflict(
+          source_workspace_id, source_commit_id,
+          child_workspace_id, child_commit_id
+        ) do nothing
+      `)
+        .run(proposed_handoff.id, proposed_handoff.source_workspace_id, proposed_handoff.source_commit_id, proposed_handoff.child_workspace_id, proposed_handoff.child_commit_id, proposed_handoff.created_at);
+    const handoff = dependencies.database
+        .prepare(`
+        select * from local_handoff
+        where source_workspace_id = ? and source_commit_id = ?
+          and child_workspace_id = ? and child_commit_id = ?
+      `)
+        .get(proposed_handoff.source_workspace_id, proposed_handoff.source_commit_id, proposed_handoff.child_workspace_id, proposed_handoff.child_commit_id);
+    return { version: 1, status: 'ready', handoff };
+}
+export function applyLocalHandoff(dependencies, input) {
+    const handoff = requireHandoff(dependencies, input.handoff_id);
+    if (handoff.source_workspace_id !== input.actor_workspace_id) {
+        throw new Error('Only the Handoff source workspace may apply it.');
+    }
+    const existing_application = dependencies.database
+        .prepare(`
+        select id from local_handoff_attempt
+        where handoff_id = ? and status = 'applied'
+      `)
+        .get(handoff.id);
+    if (existing_application) {
+        return { version: 1, status: 'applied', handoff };
+    }
+    const child = dependencies.requireActiveWorkspace(handoff.child_workspace_id);
+    const source = dependencies.requireActiveWorkspace(handoff.source_workspace_id);
+    assertHandoffLineage(child, source);
+    if (source.head_sdlc_commit_id !== handoff.source_commit_id ||
+        child.head_sdlc_commit_id !== handoff.child_commit_id) {
+        insertHandoffAttempt({
+            database: dependencies.database,
+            handoff,
+            status: 'stale_base',
+            source_commit_id: source.head_sdlc_commit_id,
+            child_commit_id: child.head_sdlc_commit_id
+        });
+        return {
+            version: 1,
+            status: 'stale_base',
+            current_source_commit_id: source.head_sdlc_commit_id,
+            current_child_commit_id: child.head_sdlc_commit_id
+        };
+    }
+    dependencies.advanceWorkspaceHead(source, handoff.child_commit_id);
+    insertHandoffAttempt({
+        database: dependencies.database,
+        handoff,
+        status: 'applied',
+        source_commit_id: handoff.source_commit_id,
+        child_commit_id: handoff.child_commit_id
+    });
+    return { version: 1, status: 'applied', handoff };
+}
+export function inspectLocalHandoff(dependencies, input) {
+    const handoff = requireHandoff(dependencies, input.handoff_id);
+    if (handoff.source_workspace_id !== input.actor_workspace_id &&
+        handoff.child_workspace_id !== input.actor_workspace_id) {
+        throw new Error('Only a Handoff peer workspace may inspect it.');
+    }
+    const child = dependencies.requireActiveWorkspace(handoff.child_workspace_id);
+    const source = dependencies.requireActiveWorkspace(handoff.source_workspace_id);
+    assertHandoffLineage(child, source);
+    const attempts = handoffAttempts(dependencies, handoff.id);
+    const applied = attempts.some((attempt) => attempt.status === 'applied');
+    const ready = source.head_sdlc_commit_id === handoff.source_commit_id &&
+        child.head_sdlc_commit_id === handoff.child_commit_id;
+    return {
+        version: 1,
+        status: applied ? 'applied' : ready ? 'ready' : 'stale_base',
+        handoff,
+        current_source_commit_id: source.head_sdlc_commit_id,
+        current_child_commit_id: child.head_sdlc_commit_id,
+        attempts
+    };
+}
+//# sourceMappingURL=workspace-handoff.js.map

package/dist/local/workspace-handoff.js.map

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

package/dist/local/workspace-history-journal.d.ts

@@ -0,0 +1,70 @@
+import type { LocalHandoffWorkspace } from './workspace-handoff.js';
+import type { LocalGraphMergeResult } from './workspace-merge.js';
+import type { LocalResolutionAttemptEvidence } from './workspace-resolution.js';
+import type { LocalWorkspaceStoreDatabase } from './workspace-store-database.js';
+import type { LocalBranchIntegrationAttempt, LocalIntegrationAttempt, LocalIntegrationQueueEntry, LocalReconciliationAttempt, LocalWorkspaceCommit } from './workspace-history-types.js';
+type ActiveWorkspaceRow = LocalHandoffWorkspace;
+export declare class LocalWorkspaceHistoryJournal {
+    private readonly database;
+    private readonly is_ancestor;
+    private readonly get_commit;
+    constructor(database: LocalWorkspaceStoreDatabase, is_ancestor: (ancestor_id: string, descendant_id: string) => boolean, get_commit: (commit_id: string) => LocalWorkspaceCommit | null);
+    insertResolutionAttempts(input: {
+        queue_entry: LocalIntegrationQueueEntry;
+        attempts: LocalResolutionAttemptEvidence[];
+        resulting_commit_id: string | null;
+        resulting_root_hash: string | null;
+    }): void;
+    insertIntegrationAttempt(input: {
+        queue_entry: LocalIntegrationQueueEntry;
+        merge_base_commit_id: string;
+        expected_head_commit_id: string;
+        candidate_commit_id: string | null;
+        status: LocalIntegrationAttempt['status'];
+        merge_result: LocalGraphMergeResult;
+    }): void;
+    insertReconciliationAttempt(input: {
+        child: ActiveWorkspaceRow;
+        source: ActiveWorkspaceRow;
+        merge_base_commit_id: string;
+        expected_child_commit_id: string;
+        expected_source_commit_id: string;
+        candidate_commit_id: string | null;
+        status: LocalReconciliationAttempt['status'];
+        merge_result: LocalGraphMergeResult;
+    }): string;
+    insertReconciliationResolutionAttempts(input: {
+        reconciliation_attempt_id: string;
+        attempts: LocalResolutionAttemptEvidence[];
+        resulting_commit_id: string | null;
+        resulting_root_hash: string | null;
+    }): void;
+    insertBranchIntegrationAttempt(input: {
+        workspace_id: string;
+        local_ref: string;
+        tracking_ref: string;
+        expected_local_commit_id: string;
+        expected_upstream_commit_id: string;
+        merge_base_commit_id: string;
+        candidate_commit_id: string | null;
+        resulting_head_commit_id: string | null;
+        status: LocalBranchIntegrationAttempt['status'];
+        merge_result: LocalGraphMergeResult;
+    }): string;
+    insertBranchIntegrationResolutionAttempts(input: {
+        branch_integration_attempt_id: string;
+        attempts: LocalResolutionAttemptEvidence[];
+        resulting_commit_id: string | null;
+        resulting_root_hash: string | null;
+    }): void;
+    assertMergeBindings(input: {
+        merge_base_commit_id: string;
+        coordinator_commit_id: string;
+        child_commit_id: string;
+        merge_result: LocalGraphMergeResult;
+        allow_external_child_commit?: boolean;
+    }): void;
+    private assertCommitRoot;
+}
+export {};
+//# sourceMappingURL=workspace-history-journal.d.ts.map

package/dist/local/workspace-history-journal.d.ts.map

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