@software-dlc/cli 0.157.2

package/dist/local/workspace-authority-guard.js

@@ -0,0 +1,69 @@
+import { discoverGitRemoteIdentity, discoverGitWorktree } from './git.js';
+/** Re-discovers Git before an operation relies on foreground authority. */
+export class LocalWorkspaceAuthorityGuard {
+    repository_root;
+    git_common_dir;
+    store;
+    constructor(repository_root, git_common_dir, store) {
+        this.repository_root = repository_root;
+        this.git_common_dir = git_common_dir;
+        this.store = store;
+    }
+    async requireCurrent(workspace_id, input = {}) {
+        const workspace = this.store.getWorkspace(workspace_id);
+        if (!workspace)
+            throw new Error('Local workspace was not found.');
+        if (workspace.status !== 'active')
+            throw new Error('Local workspace is closed.');
+        if (workspace.git_worktree_path !== this.repository_root) {
+            throw new Error('The actor workspace must match the current Git worktree.');
+        }
+        if (input.require_human && workspace.actor_kind !== 'human') {
+            throw new Error('This operation is owned by the active human workspace.');
+        }
+        const git = await discoverGitWorktree(this.repository_root);
+        if (git.repository_root !== this.repository_root ||
+            git.git_common_dir !== this.git_common_dir ||
+            git.git_dir !== workspace.git_dir) {
+            throw new Error('The current Git worktree identity no longer matches the registered workspace.');
+        }
+        const source_binding = this.store.getSourceRepositoryBinding(git.git_common_dir);
+        if (source_binding) {
+            const remote = await discoverGitRemoteIdentity(this.repository_root, source_binding.remote_name);
+            if (remote.repository_identity !== source_binding.remote_identity) {
+                throw new Error('Current Git repository identity does not match its source-association binding.');
+            }
+        }
+        if (!input.allow_branch_change && workspace.attached_ref) {
+            const association = this.store.getBranchAssociation(workspace.attached_ref);
+            if (!association || association.git_ref !== git.ref) {
+                const current = git.ref ? `Git branch ${git.ref}` : 'a detached HEAD';
+                const current_association = git.ref
+                    ? this.store.getBranchAssociationByGitRef(git.ref)
+                    : null;
+                const attached = association
+                    ? `This workspace's local SDLC branch ${workspace.attached_ref} is associated with Git branch ${association.git_ref}, but the checkout is on ${current}.`
+                    : `The local SDLC branch ${workspace.attached_ref} has no Git branch association, and the checkout is on ${current}.`;
+                const switch_back = association
+                    ? `Switch back with git switch ${shortBranch(association.git_ref)}. `
+                    : '';
+                // select and create need a clean projection, so switching back (and
+                // committing there) is offered first; create also needs a fetched
+                // remote, which a local-only graph does not have.
+                const way_back = current_association
+                    ? `${switch_back}With no uncommitted graph edits, sdlc branch select moves this workspace to ${current_association.local_ref}, the local SDLC branch of ${git.ref}.`
+                    : association && !git.ref
+                        ? `${switch_back}To cite code at this commit, record its sources at that commit instead of checking it out.`
+                        : association
+                            ? `${switch_back}To cite this branch's code, record its sources at that commit instead of switching. A graph fetched from an SDLC remote can give this Git branch its own local SDLC branch with no uncommitted graph edits: sdlc branch create --ref ${git.ref} --from-remote <remote> --from-ref <ref>.`
+                            : 'Select or create its explicit local SDLC branch association first (sdlc branch select, or sdlc branch create from a fetched remote).';
+                throw new Error(`${attached} ${way_back}`);
+            }
+        }
+        return { workspace, git };
+    }
+}
+function shortBranch(git_ref) {
+    return git_ref.replace(/^refs\/heads\//, '');
+}
+//# sourceMappingURL=workspace-authority-guard.js.map

package/dist/local/workspace-authority-guard.js.map

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

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

@@ -0,0 +1,33 @@
+import { type GitRefAuthority } from './git-ref-authority.js';
+import type { GitWorktreeContext } from './git.js';
+import type { LocalWorkspace } from './workspace-store.js';
+export type LocalWorkspaceAuthorityInspection = {
+    version: 1;
+    workspace_id: string;
+    actor_kind: LocalWorkspace['actor_kind'];
+    git_worktree_path: string;
+    git_ref: GitRefAuthority;
+    attached_local_sdlc_ref: GitRefAuthority;
+    local_authority: {
+        own_sdlc_head: 'write';
+        attached_local_sdlc_ref: 'write' | 'none';
+        source_sdlc_head: 'handoff_only' | 'none';
+        sibling_sdlc_heads: 'denied';
+        git_refs: 'read_only';
+        local_branch_creation: 'human_only' | 'denied';
+    };
+    remote_authority: {
+        remote_tracking_refs: 'fetch_managed';
+        named_sdlc_remotes: 'human_owned' | 'read_only';
+        fetch: 'available';
+        portable_history_plan: 'read_only';
+        portable_history_conversion: 'human_only' | 'denied';
+        push: 'human_only' | 'denied';
+        remote_ref_update: 'human_only_via_push' | 'denied';
+    };
+};
+export declare function inspectLocalWorkspaceAuthority(input: {
+    workspace: LocalWorkspace;
+    git: GitWorktreeContext;
+}): LocalWorkspaceAuthorityInspection;
+//# sourceMappingURL=workspace-authority.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-authority.d.ts","sourceRoot":"","sources":["../../src/local/workspace-authority.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,MAAM,iCAAiC,GAAG;IAC9C,OAAO,EAAE,CAAC,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;IACzC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,eAAe,CAAC;IACzB,uBAAuB,EAAE,eAAe,CAAC;IACzC,eAAe,EAAE;QACf,aAAa,EAAE,OAAO,CAAC;QACvB,uBAAuB,EAAE,OAAO,GAAG,MAAM,CAAC;QAC1C,gBAAgB,EAAE,cAAc,GAAG,MAAM,CAAC;QAC1C,kBAAkB,EAAE,QAAQ,CAAC;QAC7B,QAAQ,EAAE,WAAW,CAAC;QACtB,qBAAqB,EAAE,YAAY,GAAG,QAAQ,CAAC;KAChD,CAAC;IACF,gBAAgB,EAAE;QAChB,oBAAoB,EAAE,eAAe,CAAC;QACtC,kBAAkB,EAAE,aAAa,GAAG,WAAW,CAAC;QAChD,KAAK,EAAE,WAAW,CAAC;QACnB,qBAAqB,EAAE,WAAW,CAAC;QACnC,2BAA2B,EAAE,YAAY,GAAG,QAAQ,CAAC;QACrD,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;QAC9B,iBAAiB,EAAE,qBAAqB,GAAG,QAAQ,CAAC;KACrD,CAAC;CACH,CAAC;AAEF,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IACpD,SAAS,EAAE,cAAc,CAAC;IAC1B,GAAG,EAAE,kBAAkB,CAAC;CACzB,GAAG,iCAAiC,CAoCpC"}

package/dist/local/workspace-authority.js

@@ -0,0 +1,33 @@
+import { inspectGitRefAuthority } from './git-ref-authority.js';
+export function inspectLocalWorkspaceAuthority(input) {
+    return {
+        version: 1,
+        workspace_id: input.workspace.id,
+        actor_kind: input.workspace.actor_kind,
+        git_worktree_path: input.workspace.git_worktree_path,
+        git_ref: inspectGitRefAuthority(input.git.ref),
+        attached_local_sdlc_ref: inspectGitRefAuthority(input.workspace.attached_ref),
+        local_authority: {
+            own_sdlc_head: 'write',
+            attached_local_sdlc_ref: input.workspace.attached_ref ? 'write' : 'none',
+            source_sdlc_head: input.workspace.source_workspace_id
+                ? 'handoff_only'
+                : 'none',
+            sibling_sdlc_heads: 'denied',
+            git_refs: 'read_only',
+            local_branch_creation: input.workspace.actor_kind === 'human' ? 'human_only' : 'denied'
+        },
+        remote_authority: {
+            remote_tracking_refs: 'fetch_managed',
+            named_sdlc_remotes: input.workspace.actor_kind === 'human' ? 'human_owned' : 'read_only',
+            fetch: 'available',
+            portable_history_plan: 'read_only',
+            portable_history_conversion: input.workspace.actor_kind === 'human' ? 'human_only' : 'denied',
+            push: input.workspace.actor_kind === 'human' ? 'human_only' : 'denied',
+            remote_ref_update: input.workspace.actor_kind === 'human'
+                ? 'human_only_via_push'
+                : 'denied'
+        }
+    };
+}
+//# sourceMappingURL=workspace-authority.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-authority.js","sourceRoot":"","sources":["../../src/local/workspace-authority.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EAEvB,MAAM,wBAAwB,CAAC;AA8BhC,MAAM,UAAU,8BAA8B,CAAC,KAG9C;IACC,OAAO;QACL,OAAO,EAAE,CAAC;QACV,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE;QAChC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,UAAU;QACtC,iBAAiB,EAAE,KAAK,CAAC,SAAS,CAAC,iBAAiB;QACpD,OAAO,EAAE,sBAAsB,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;QAC9C,uBAAuB,EAAE,sBAAsB,CAC7C,KAAK,CAAC,SAAS,CAAC,YAAY,CAC7B;QACD,eAAe,EAAE;YACf,aAAa,EAAE,OAAO;YACtB,uBAAuB,EAAE,KAAK,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;YACxE,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAC,mBAAmB;gBACnD,CAAC,CAAC,cAAc;gBAChB,CAAC,CAAC,MAAM;YACV,kBAAkB,EAAE,QAAQ;YAC5B,QAAQ,EAAE,WAAW;YACrB,qBAAqB,EACnB,KAAK,CAAC,SAAS,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ;SACnE;QACD,gBAAgB,EAAE;YAChB,oBAAoB,EAAE,eAAe;YACrC,kBAAkB,EAChB,KAAK,CAAC,SAAS,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW;YACtE,KAAK,EAAE,WAAW;YAClB,qBAAqB,EAAE,WAAW;YAClC,2BAA2B,EACzB,KAAK,CAAC,SAAS,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ;YAClE,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ;YACtE,iBAAiB,EACf,KAAK,CAAC,SAAS,CAAC,UAAU,KAAK,OAAO;gBACpC,CAAC,CAAC,qBAAqB;gBACvB,CAAC,CAAC,QAAQ;SACf;KACF,CAAC;AACJ,CAAC"}

package/dist/local/workspace-branch-runtime.d.ts

@@ -0,0 +1,61 @@
+import { materializeGraphProjection } from './projection.js';
+import type { GitWorktreeContext } from './git.js';
+import { LocalWorkspaceAuthorityGuard } from './workspace-authority-guard.js';
+import { LocalWorkspaceCommitResolver } from './workspace-commit-resolver.js';
+import { LocalWorkspaceStore, type LocalBranchAssociation, type LocalWorkspace } from './workspace-store.js';
+type MaterializeProjection = typeof materializeGraphProjection;
+type LocalBranchTransitionResult = {
+    version: 1;
+    workspace: LocalWorkspace;
+    association: LocalBranchAssociation;
+    commit_id: string;
+    graph_root_hash: string;
+};
+export type LocalBranchTrackingStatus = {
+    relation: 'untracked' | 'gone' | 'current' | 'ahead' | 'behind' | 'diverged' | 'unrelated';
+    tracking_ref: string | null;
+    upstream_commit_id: string | null;
+    ahead_by: number;
+    behind_by: number;
+};
+export type LocalBranchStatus = {
+    ref_name: string;
+    head_commit_id: string;
+    association: LocalBranchAssociation;
+    current: boolean;
+    tracking: LocalBranchTrackingStatus;
+};
+export type LocalBranchCreationResult = LocalBranchTransitionResult & {
+    status: 'created' | 'created_recovery_required';
+    portable_commit_id: string;
+    previous_projection_root_hash?: string;
+    projection_error?: string;
+};
+export type LocalBranchSelectionResult = LocalBranchTransitionResult & {
+    status: 'selected' | 'selected_recovery_required';
+    previous_projection_root_hash?: string;
+    projection_error?: string;
+};
+export declare class LocalWorkspaceBranchRuntime {
+    private readonly initial_git;
+    private readonly store;
+    private readonly authority;
+    private readonly commits;
+    private readonly materialize_projection;
+    constructor(initial_git: GitWorktreeContext, store: LocalWorkspaceStore, authority: LocalWorkspaceAuthorityGuard, commits: LocalWorkspaceCommitResolver, materialize_projection: MaterializeProjection);
+    list(): LocalBranchStatus[];
+    private trackingStatus;
+    createFromTrackingRef(input: {
+        actor_workspace_id: string;
+        local_ref: string;
+        remote_name: string;
+        source_ref: string;
+    }): Promise<LocalBranchCreationResult>;
+    select(input: {
+        actor_workspace_id: string;
+    }): Promise<LocalBranchSelectionResult>;
+    private currentActiveWorkspace;
+    private assertProjectionClean;
+}
+export {};
+//# sourceMappingURL=workspace-branch-runtime.d.ts.map

package/dist/local/workspace-branch-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-branch-runtime.d.ts","sourceRoot":"","sources":["../../src/local/workspace-branch-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,0BAA0B,EAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAQ9E,OAAO,EACL,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAE9B,KAAK,qBAAqB,GAAG,OAAO,0BAA0B,CAAC;AAE/D,KAAK,2BAA2B,GAAG;IACjC,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,cAAc,CAAC;IAC1B,WAAW,EAAE,sBAAsB,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,EACJ,WAAW,GACX,MAAM,GACN,SAAS,GACT,OAAO,GACP,QAAQ,GACR,UAAU,GACV,WAAW,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,sBAAsB,CAAC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,yBAAyB,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,2BAA2B,GAAG;IACpE,MAAM,EAAE,SAAS,GAAG,2BAA2B,CAAC;IAChD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,2BAA2B,GAAG;IACrE,MAAM,EAAE,UAAU,GAAG,4BAA4B,CAAC;IAClD,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,qBAAa,2BAA2B;IAEpC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,sBAAsB;gBAJtB,WAAW,EAAE,kBAAkB,EAC/B,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE,4BAA4B,EACvC,OAAO,EAAE,4BAA4B,EACrC,sBAAsB,EAAE,qBAAqB;IAGhE,IAAI,IAAI,iBAAiB,EAAE;IAqB3B,OAAO,CAAC,cAAc;IAgDhB,qBAAqB,CAAC,KAAK,EAAE;QACjC,kBAAkB,EAAE,MAAM,CAAC;QAC3B,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAmFhC,MAAM,CAAC,KAAK,EAAE;QAClB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,0BAA0B,CAAC;IA6EvC,OAAO,CAAC,sBAAsB;YAUhB,qBAAqB;CAiBpC"}

package/dist/local/workspace-branch-runtime.js

@@ -0,0 +1,216 @@
+import { composeGraphProjection } from './projection.js';
+import { localGraphRootHash } from './workspace-graph-store.js';
+import { withWorkspaceOperationLock } from './workspace-lock.js';
+import { workspaceControlDirectory, workspaceProjectionDirectory } from './workspace-paths.js';
+import { trackingRefName } from './workspace-remote-fetch.js';
+export class LocalWorkspaceBranchRuntime {
+    initial_git;
+    store;
+    authority;
+    commits;
+    materialize_projection;
+    constructor(initial_git, store, authority, commits, materialize_projection) {
+        this.initial_git = initial_git;
+        this.store = store;
+        this.authority = authority;
+        this.commits = commits;
+        this.materialize_projection = materialize_projection;
+    }
+    list() {
+        const current = this.currentActiveWorkspace();
+        return this.store.listBranchAssociations().map((association) => {
+            const ref = this.store.getRef(association.local_ref);
+            if (!ref) {
+                throw new Error(`Associated local branch ${association.local_ref} is missing.`);
+            }
+            return {
+                ref_name: ref.ref_name,
+                head_commit_id: ref.head_commit_id,
+                association,
+                current: current.attached_ref === ref.ref_name &&
+                    association.git_ref === this.initial_git.ref,
+                tracking: this.trackingStatus(ref.head_commit_id, association)
+            };
+        });
+    }
+    trackingStatus(local_commit_id, association) {
+        const { upstream_remote_name, upstream_source_ref, upstream_tracking_ref } = association;
+        if (upstream_remote_name === null &&
+            upstream_source_ref === null &&
+            upstream_tracking_ref === null) {
+            return {
+                relation: 'untracked',
+                tracking_ref: null,
+                upstream_commit_id: null,
+                ahead_by: 0,
+                behind_by: 0
+            };
+        }
+        if (upstream_remote_name === null ||
+            upstream_source_ref === null ||
+            upstream_tracking_ref === null) {
+            throw new Error(`Local branch ${association.local_ref} has incomplete upstream metadata.`);
+        }
+        const upstream = this.store.remote_tracking.getRef(upstream_remote_name, upstream_source_ref);
+        if (!upstream || upstream.tracking_ref !== upstream_tracking_ref) {
+            return {
+                relation: 'gone',
+                tracking_ref: upstream_tracking_ref,
+                upstream_commit_id: null,
+                ahead_by: 0,
+                behind_by: 0
+            };
+        }
+        return {
+            ...this.commits.compare(local_commit_id, upstream.commit_id),
+            tracking_ref: upstream.tracking_ref,
+            upstream_commit_id: upstream.commit_id
+        };
+    }
+    async createFromTrackingRef(input) {
+        const { workspace, git } = await this.authority.requireCurrent(input.actor_workspace_id, { allow_branch_change: true, require_human: true });
+        if (!git.ref) {
+            throw new Error('Create or switch to a named Git branch before creating its local SDLC branch.');
+        }
+        const tracking = this.store.remote_tracking.getRef(input.remote_name, input.source_ref);
+        if (!tracking ||
+            tracking.tracking_ref !==
+                trackingRefName(input.remote_name, input.source_ref)) {
+            throw new Error('Remote-tracking ref is unavailable. Fetch it first.');
+        }
+        return withWorkspaceOperationLock({
+            control_dir: workspaceControlDirectory(workspace),
+            operation: 'create-local-branch',
+            run: async () => {
+                const { workspace: current, git: current_git } = await this.authority.requireCurrent(workspace.id, {
+                    allow_branch_change: true,
+                    require_human: true
+                });
+                await this.assertProjectionClean(current);
+                const previous_projection_root_hash = this.commits.root(current.head_sdlc_commit_id);
+                const graph = await this.commits.readGraph(tracking.commit_id);
+                const created = this.store.createBranchFromTrackingRef({
+                    actor_workspace_id: current.id,
+                    expected_workspace_head_commit_id: current.head_sdlc_commit_id,
+                    expected_tracking_commit_id: tracking.commit_id,
+                    local_ref: input.local_ref,
+                    git_ref: current_git.ref,
+                    remote_name: input.remote_name,
+                    source_ref: input.source_ref,
+                    tracking_ref: tracking.tracking_ref,
+                    git_head_commit_id: current_git.head
+                });
+                const portable = this.store.portable_commits.getCommit(tracking.commit_id);
+                if (!portable)
+                    throw new Error('Created branch baseline is unavailable.');
+                try {
+                    await this.materialize_projection({
+                        projection_dir: workspaceProjectionDirectory(created.workspace),
+                        graph
+                    });
+                }
+                catch (error) {
+                    return {
+                        version: 1,
+                        status: 'created_recovery_required',
+                        ...created,
+                        commit_id: portable.id,
+                        portable_commit_id: portable.id,
+                        graph_root_hash: portable.graph_root,
+                        previous_projection_root_hash,
+                        projection_error: error instanceof Error
+                            ? error.message
+                            : 'Projection materialization failed.'
+                    };
+                }
+                return {
+                    version: 1,
+                    status: 'created',
+                    ...created,
+                    commit_id: portable.id,
+                    portable_commit_id: portable.id,
+                    graph_root_hash: portable.graph_root
+                };
+            }
+        });
+    }
+    async select(input) {
+        const { workspace, git } = await this.authority.requireCurrent(input.actor_workspace_id, { allow_branch_change: true, require_human: true });
+        if (!git.ref) {
+            throw new Error('Switch to a named Git branch before selecting its local SDLC branch.');
+        }
+        const association = this.store.getBranchAssociationByGitRef(git.ref);
+        if (!association) {
+            throw new Error(`Git branch ${git.ref} has no local SDLC branch association.`);
+        }
+        const ref = this.store.getRef(association.local_ref);
+        if (!ref) {
+            throw new Error(`Local SDLC branch ${association.local_ref} is missing.`);
+        }
+        const graph = await this.commits.readGraph(ref.head_commit_id);
+        return withWorkspaceOperationLock({
+            control_dir: workspaceControlDirectory(workspace),
+            operation: 'select-local-branch',
+            run: async () => {
+                const { workspace: current, git: current_git } = await this.authority.requireCurrent(workspace.id, {
+                    allow_branch_change: true,
+                    require_human: true
+                });
+                if (current_git.ref !== git.ref) {
+                    throw new Error('The current Git branch changed while selecting its local SDLC branch.');
+                }
+                await this.assertProjectionClean(current);
+                const previous_projection_root_hash = this.commits.root(current.head_sdlc_commit_id);
+                const selected = this.store.selectBranchForWorkspace({
+                    actor_workspace_id: current.id,
+                    expected_workspace_head_commit_id: current.head_sdlc_commit_id,
+                    local_ref: association.local_ref,
+                    git_ref: current_git.ref,
+                    git_head_commit_id: current_git.head
+                });
+                const graph_root_hash = this.commits.root(ref.head_commit_id);
+                try {
+                    await this.materialize_projection({
+                        projection_dir: workspaceProjectionDirectory(selected.workspace),
+                        graph
+                    });
+                }
+                catch (error) {
+                    return {
+                        version: 1,
+                        status: 'selected_recovery_required',
+                        ...selected,
+                        commit_id: ref.head_commit_id,
+                        graph_root_hash,
+                        previous_projection_root_hash,
+                        projection_error: error instanceof Error
+                            ? error.message
+                            : 'Projection materialization failed.'
+                    };
+                }
+                return {
+                    version: 1,
+                    status: 'selected',
+                    ...selected,
+                    commit_id: ref.head_commit_id,
+                    graph_root_hash
+                };
+            }
+        });
+    }
+    currentActiveWorkspace() {
+        const workspace = this.store.getWorkspaceByGitWorktreePath(this.initial_git.repository_root);
+        if (!workspace || workspace.status !== 'active') {
+            throw new Error('The current Git worktree is not an active workspace.');
+        }
+        return workspace;
+    }
+    async assertProjectionClean(workspace) {
+        const { graph } = await composeGraphProjection(workspaceProjectionDirectory(workspace), undefined, { base: () => this.commits.readGraph(workspace.head_sdlc_commit_id) });
+        if (localGraphRootHash(graph) !==
+            this.commits.root(workspace.head_sdlc_commit_id)) {
+            throw new Error('Workspace projection has uncommitted changes; commit them before this operation.');
+        }
+    }
+}
+//# sourceMappingURL=workspace-branch-runtime.js.map

package/dist/local/workspace-branch-runtime.js.map

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

package/dist/local/workspace-built-content.d.ts

@@ -0,0 +1,137 @@
+import type { PortableGraph } from '@software-dlc/graph/types';
+import { type ProjectionEntityKind } from './projection.js';
+import type { LocalWorkspaceStoreDatabase } from './workspace-store-database.js';
+/**
+ * Built content and marked removal (docs/specs/graph-claim-status.md,
+ * Changing something already built). A gate merge puts a work stream's
+ * approved plan or design into the coordinator before its code exists. For
+ * each claim that merge added, changed, or removed, a pending claim records
+ * the commit that holds the claim's built content, so the graph can still be
+ * read as built. Landing the work stream clears its pending claims.
+ */
+export type LocalGate = 'plan' | 'design';
+export type LocalPendingClaimChange = 'added' | 'changed' | 'removal';
+export type LocalGraphClaimChange = {
+    entity_kind: ProjectionEntityKind;
+    entity_id: string;
+    change: LocalPendingClaimChange;
+};
+export type LocalPendingClaim = LocalGraphClaimChange & {
+    coordinator_workspace_id: string;
+    work_stream_workspace_id: string;
+    gate: LocalGate;
+    /** The commit holding the built content; null when it was never built. */
+    built_commit_id: string | null;
+    gate_commit_id: string;
+    recorded_at: string;
+};
+/**
+ * A pending claim with the entity's canonical JSON at its built commit and at
+ * its gate commit (`null` JSON when that graph lacks the entity), so the built
+ * view reads no other graph. Each content is stored with the commit it was
+ * read at and counts only while that is still the claim's commit: a claim
+ * recorded before the store kept content, or moved by a CLI that does not
+ * write it, reads as null until sdlc integrate fills it.
+ */
+export type LocalPendingClaimContent = LocalPendingClaim & {
+    built_content: string | null;
+    gate_content: string | null;
+};
+export type LocalBuiltView = {
+    graph: PortableGraph;
+    /** Built claims a gate merge removed: still built, absent from the head. */
+    marked_for_removal: Array<{
+        entity_kind: ProjectionEntityKind;
+        entity_id: string;
+        work_stream_workspace_ids: string[];
+    }>;
+    /**
+     * Built claims and head content the view left out because they sit under a
+     * node or path it left out. A publish of this view does not carry them.
+     */
+    left_out_orphans: Array<{
+        entity_kind: ProjectionEntityKind;
+        entity_id: string;
+    }>;
+    /**
+     * The view takes each claim at its own built content, so it can combine
+     * contents that were never one commit. It is reported, never refused.
+     */
+    validation: {
+        is_valid: boolean;
+        issues: string[];
+    };
+};
+/** The claims one merge added, changed, or removed, in a stable order. */
+export declare function graphClaimChanges(input: {
+    before_graph: PortableGraph;
+    after_graph: PortableGraph;
+}): LocalGraphClaimChange[];
+/**
+ * The graph as built: each pending claim at its built content, without the
+ * claims that were never built. A claim's stored built content is used when
+ * it has one; only a claim recorded before the store kept content reads its
+ * built commit's graph.
+ */
+export declare function readBuiltView(input: {
+    graph: PortableGraph;
+    pending: Array<LocalPendingClaim & {
+        built_content?: string | null;
+    }>;
+    readGraph: (commit_id: string) => Promise<PortableGraph>;
+}): Promise<LocalBuiltView>;
+export declare class LocalBuiltContentStore {
+    private readonly database;
+    constructor(database: LocalWorkspaceStoreDatabase);
+    /** Declares the gate a queued child commit merges under. */
+    setQueueGate(queue_entry_id: number, gate: LocalGate): void;
+    /** The gate a queue entry merges under; null for a landing. */
+    queueGate(queue_entry_id: number): LocalGate | null;
+    /**
+     * Queues a commit that merged under a gate again, as a landing. The gate
+     * merge already put it in the coordinator, so the landing merges nothing:
+     * it gives the work stream its landing commit and clears its claims.
+     */
+    requeueAsLanding(queue_entry_id: number): void;
+    listPendingClaims(coordinator_workspace_id: string): LocalPendingClaim[];
+    listPendingClaimContent(coordinator_workspace_id: string): LocalPendingClaimContent[];
+    /**
+     * Fills the content of claims that have none for their current commits,
+     * reading each commit's graph once and one at a time. Each write names the
+     * commit it read, so a claim that moved meanwhile is left for the next fill.
+     * A graph that cannot be read leaves its claims unfilled, read from their
+     * commits as before. Returns how many claims it filled.
+     */
+    fillPendingClaimContent(input: {
+        coordinator_workspace_id: string;
+        readGraph: (commit_id: string) => Promise<PortableGraph>;
+    }): Promise<number>;
+    /**
+     * Call inside the transaction that advances the coordinator from
+     * `before_graph` to `gate_graph`, committed as `gate_commit_id`. A claim
+     * keeps the built content its first pending claim recorded, whichever work
+     * stream changes it next.
+     */
+    recordGateMerge(input: {
+        coordinator_workspace_id: string;
+        work_stream_workspace_id: string;
+        gate: LocalGate;
+        before_commit_id: string;
+        before_graph: PortableGraph;
+        gate_commit_id: string;
+        gate_graph: PortableGraph;
+        changes: LocalGraphClaimChange[];
+    }): void;
+    /**
+     * Call inside the transaction that lands the work stream. Its pending
+     * claims are built now. Another stream's pending claim on the same entity
+     * keeps the built content it recorded, so nothing unbuilt reads as built;
+     * one recorded as never built takes this stream's gate commit, the first
+     * content of that entity that was built.
+     */
+    completeLanding(input: {
+        coordinator_workspace_id: string;
+        work_stream_workspace_id: string;
+    }): LocalPendingClaimContent[];
+}
+//# sourceMappingURL=workspace-built-content.d.ts.map

package/dist/local/workspace-built-content.d.ts.map

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