@software-dlc/cli 0.157.2

package/dist/local/workspace-portable-authoring.d.ts

@@ -0,0 +1,43 @@
+import { type LocalCommitPortableAttestation } from './portable-commit.js';
+import type { LocalPortableCommitStore } from './portable-commit-store.js';
+import type { LocalRemoteTrackingStore } from './workspace-remote-fetch.js';
+export type LocalPortableHistoryBaseCandidate = {
+    local_parent_id: string;
+    remote_name: string;
+    source_ref: string;
+    tracking_ref: string;
+    portable_commit_id: string;
+};
+export type LocalPortableHistoryPlan = {
+    version: 1;
+    head_local_commit_id: string;
+    head_portable_commit_id: string | null;
+    unmapped_local_commit_ids: string[];
+    required_author_workspace_ids: string[];
+    external_parent_ids: string[];
+    compatible_tracking_bases: LocalPortableHistoryBaseCandidate[];
+};
+export type LocalPortableHistoryConversionResult = {
+    version: 1;
+    status: 'already_mapped' | 'converted';
+    local_commit_id: string;
+    portable_commit_id: string;
+    created_portable_commit_ids: string[];
+    local_to_portable: Record<string, string>;
+    attestations: LocalCommitPortableAttestation[];
+};
+export declare class LocalWorkspacePortableAuthoring {
+    private readonly portable_commits;
+    private readonly remote_tracking;
+    constructor(portable_commits: LocalPortableCommitStore, remote_tracking: LocalRemoteTrackingStore);
+    plan(head_local_commit_id: string): LocalPortableHistoryPlan;
+    convert(input: {
+        head_local_commit_id: string;
+        identity_file?: unknown;
+        base_remote_name?: string;
+        base_source_ref?: string;
+    }): LocalPortableHistoryConversionResult;
+    private assertRequiredAuthors;
+    private trackingRefMatchesBoundary;
+}
+//# sourceMappingURL=workspace-portable-authoring.d.ts.map

package/dist/local/workspace-portable-authoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-portable-authoring.d.ts","sourceRoot":"","sources":["../../src/local/workspace-portable-authoring.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,8BAA8B,EAEpC,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAEV,wBAAwB,EACzB,MAAM,6BAA6B,CAAC;AAIrC,MAAM,MAAM,iCAAiC,GAAG;IAC9C,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,OAAO,EAAE,CAAC,CAAC;IACX,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,yBAAyB,EAAE,MAAM,EAAE,CAAC;IACpC,6BAA6B,EAAE,MAAM,EAAE,CAAC;IACxC,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,yBAAyB,EAAE,iCAAiC,EAAE,CAAC;CAChE,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG;IACjD,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,gBAAgB,GAAG,WAAW,CAAC;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,2BAA2B,EAAE,MAAM,EAAE,CAAC;IACtC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,YAAY,EAAE,8BAA8B,EAAE,CAAC;CAChD,CAAC;AAEF,qBAAa,+BAA+B;IAExC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe;gBADf,gBAAgB,EAAE,wBAAwB,EAC1C,eAAe,EAAE,wBAAwB;IAG5D,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,wBAAwB;IAoB5D,OAAO,CAAC,KAAK,EAAE;QACb,oBAAoB,EAAE,MAAM,CAAC;QAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,GAAG,oCAAoC;IA+HxC,OAAO,CAAC,qBAAqB;IAc7B,OAAO,CAAC,0BAA0B;CAOnC"}

package/dist/local/workspace-portable-authoring.js

@@ -0,0 +1,128 @@
+import { portable_history_identity_file_schema } from './portable-commit.js';
+const CONTENT_ID_PATTERN = /^sha256:[0-9a-f]{64}$/;
+export class LocalWorkspacePortableAuthoring {
+    portable_commits;
+    remote_tracking;
+    constructor(portable_commits, remote_tracking) {
+        this.portable_commits = portable_commits;
+        this.remote_tracking = remote_tracking;
+    }
+    plan(head_local_commit_id) {
+        const plan = this.portable_commits.planLocalHistory(head_local_commit_id);
+        const compatible_tracking_bases = plan.external_parent_ids.flatMap((local_parent_id) => this.remote_tracking
+            .listRefs()
+            .filter((tracking_ref) => this.trackingRefMatchesBoundary(tracking_ref, local_parent_id))
+            .map((tracking_ref) => ({
+            local_parent_id,
+            remote_name: tracking_ref.remote_name,
+            source_ref: tracking_ref.source_ref,
+            tracking_ref: tracking_ref.tracking_ref,
+            portable_commit_id: tracking_ref.commit_id
+        })));
+        return { ...plan, compatible_tracking_bases };
+    }
+    convert(input) {
+        const plan = this.plan(input.head_local_commit_id);
+        if (plan.head_portable_commit_id) {
+            return {
+                version: 1,
+                status: 'already_mapped',
+                local_commit_id: plan.head_local_commit_id,
+                portable_commit_id: plan.head_portable_commit_id,
+                created_portable_commit_ids: [],
+                local_to_portable: {
+                    [plan.head_local_commit_id]: plan.head_portable_commit_id
+                },
+                attestations: []
+            };
+        }
+        if (plan.unmapped_local_commit_ids.length === 0) {
+            throw new Error('The selected head is not a local workspace commit and cannot be converted.');
+        }
+        if (input.identity_file === undefined) {
+            throw new Error('Portable conversion requires --identity-file.');
+        }
+        const identity_file = portable_history_identity_file_schema.parse(input.identity_file);
+        this.assertRequiredAuthors(plan, identity_file);
+        const external_parent_ids = {
+            ...identity_file.external_parent_ids
+        };
+        const has_base_remote = input.base_remote_name !== undefined;
+        const has_base_ref = input.base_source_ref !== undefined;
+        if (has_base_remote !== has_base_ref) {
+            throw new Error('--base-remote and --base-ref must be provided together.');
+        }
+        if (input.base_remote_name && input.base_source_ref) {
+            const tracking_ref = this.remote_tracking.getRef(input.base_remote_name, input.base_source_ref);
+            if (!tracking_ref) {
+                throw new Error('The selected remote tracking ref was not found.');
+            }
+            const matching_parent_ids = plan.external_parent_ids.filter((local_parent_id) => this.trackingRefMatchesBoundary(tracking_ref, local_parent_id));
+            if (matching_parent_ids.length !== 1) {
+                throw new Error('The selected tracking ref does not uniquely match one local history boundary.');
+            }
+            const local_parent_id = matching_parent_ids[0];
+            const explicit_mapping = external_parent_ids[local_parent_id];
+            if (explicit_mapping && explicit_mapping !== tracking_ref.commit_id) {
+                throw new Error('The selected tracking ref conflicts with the explicit external parent mapping.');
+            }
+            external_parent_ids[local_parent_id] = tracking_ref.commit_id;
+        }
+        const missing_parent_ids = plan.external_parent_ids.filter((local_parent_id) => !external_parent_ids[local_parent_id]);
+        if (missing_parent_ids.length > 0) {
+            throw new Error(`Portable conversion requires explicit mappings for local history boundaries: ${missing_parent_ids.join(', ')}.`);
+        }
+        const unavailable_parent_ids = plan.external_parent_ids.filter((local_parent_id) => {
+            const portable_parent_id = external_parent_ids[local_parent_id];
+            return (portable_parent_id !== undefined &&
+                this.portable_commits.getCommit(portable_parent_id) === null);
+        });
+        if (unavailable_parent_ids.length > 0) {
+            throw new Error(`Portable conversion requires locally fetched parent commits for history boundaries: ${unavailable_parent_ids.join(', ')}.`);
+        }
+        const mismatched_root_parent_ids = plan.external_parent_ids.filter((local_parent_id) => {
+            if (!CONTENT_ID_PATTERN.test(local_parent_id))
+                return false;
+            const portable_parent_id = external_parent_ids[local_parent_id];
+            if (!portable_parent_id)
+                return false;
+            return (this.portable_commits.getCommit(portable_parent_id)?.graph_root !==
+                local_parent_id);
+        });
+        if (mismatched_root_parent_ids.length > 0) {
+            throw new Error(`Portable parent graph roots do not match local history boundaries: ${mismatched_root_parent_ids.join(', ')}.`);
+        }
+        const conversion = this.portable_commits.migrateLocalHistory({
+            head_commit_ids: [plan.head_local_commit_id],
+            author_claims: identity_file.author_claims,
+            committer: identity_file.committer,
+            external_parent_ids,
+            reuse_existing_mappings: true
+        });
+        const portable_commit_id = conversion.local_to_portable[plan.head_local_commit_id] ??
+            this.portable_commits.getLocalMapping(plan.head_local_commit_id);
+        if (!portable_commit_id) {
+            throw new Error('Portable conversion did not map the selected head.');
+        }
+        return {
+            version: 1,
+            status: 'converted',
+            local_commit_id: plan.head_local_commit_id,
+            portable_commit_id,
+            created_portable_commit_ids: conversion.commits.map((commit) => commit.id),
+            local_to_portable: conversion.local_to_portable,
+            attestations: conversion.attestations
+        };
+    }
+    assertRequiredAuthors(plan, identity_file) {
+        const missing_author_ids = plan.required_author_workspace_ids.filter((workspace_id) => !identity_file.author_claims[workspace_id]);
+        if (missing_author_ids.length > 0) {
+            throw new Error(`Portable conversion requires explicit claims for local authors: ${missing_author_ids.join(', ')}.`);
+        }
+    }
+    trackingRefMatchesBoundary(tracking_ref, local_parent_id) {
+        const commit = this.portable_commits.getCommit(tracking_ref.commit_id);
+        return commit?.graph_root === local_parent_id;
+    }
+}
+//# sourceMappingURL=workspace-portable-authoring.js.map

package/dist/local/workspace-portable-authoring.js.map

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

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

@@ -0,0 +1,63 @@
+import { LocalWorkspaceGraphStore } from './workspace-graph-store.js';
+import type { LocalWorkspaceStore } from './workspace-store.js';
+export type LocalWorkspacePruneDisposition = 'eligible' | 'already_absent' | 'retained';
+export type LocalWorkspacePruneWorktree = {
+    workspace_id: string;
+    git_worktree_path: string;
+    disposition: LocalWorkspacePruneDisposition;
+    reason: string;
+};
+export type LocalWorkspacePruneObject = {
+    root_hash: string;
+    object_path: string;
+    size_bytes: number;
+    modified_at: string;
+};
+export type LocalWorkspacePrunePlan = {
+    version: 1;
+    status: 'planned';
+    plan_hash: string;
+    generated_at: string;
+    actor_workspace_id: string;
+    min_age_hours: number;
+    retained_root_count: number;
+    retained_roots_hash: string;
+    worktrees: LocalWorkspacePruneWorktree[];
+    objects: LocalWorkspacePruneObject[];
+};
+export type LocalWorkspacePruneResult = {
+    version: 1;
+    status: 'applied';
+    plan_hash: string;
+    removed_worktree_ids: string[];
+    removed_object_root_hashes: string[];
+    reclaimed_bytes: number;
+};
+export declare class LocalWorkspacePruner {
+    private readonly repository_root;
+    private readonly current_worktree_path;
+    private readonly store;
+    private readonly graphs;
+    private readonly commits;
+    private readonly assert_actor_authority?;
+    constructor(input: {
+        repository_root: string;
+        current_worktree_path: string;
+        store: LocalWorkspaceStore;
+        graphs: LocalWorkspaceGraphStore;
+        assert_actor_authority?: (workspace_id: string) => Promise<void>;
+    });
+    plan(input: {
+        actor_workspace_id: string;
+        min_age_hours?: number;
+    }): Promise<LocalWorkspacePrunePlan>;
+    apply(input: {
+        actor_workspace_id: string;
+        expected_plan_hash: string;
+        min_age_hours?: number;
+    }): Promise<LocalWorkspacePruneResult>;
+    private buildPlan;
+    private inspectWorktree;
+    private isDescendantOf;
+}
+//# sourceMappingURL=workspace-prune.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-prune.d.ts","sourceRoot":"","sources":["../../src/local/workspace-prune.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,wBAAwB,EAEzB,MAAM,4BAA4B,CAAC;AAOpC,OAAO,KAAK,EAAkB,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAMhF,MAAM,MAAM,8BAA8B,GACtC,UAAU,GACV,gBAAgB,GAChB,UAAU,CAAC;AAEf,MAAM,MAAM,2BAA2B,GAAG;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,8BAA8B,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,2BAA2B,EAAE,CAAC;IACzC,OAAO,EAAE,yBAAyB,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,0BAA0B,EAAE,MAAM,EAAE,CAAC;IACrC,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AA6CF,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAErB;gBAEP,KAAK,EAAE;QACjB,eAAe,EAAE,MAAM,CAAC;QACxB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,KAAK,EAAE,mBAAmB,CAAC;QAC3B,MAAM,EAAE,wBAAwB,CAAC;QACjC,sBAAsB,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KAClE;IASK,IAAI,CAAC,KAAK,EAAE;QAChB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAQ9B,KAAK,CAAC,KAAK,EAAE;QACjB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,yBAAyB,CAAC;YAkFxB,SAAS;YAsDT,eAAe;IAgF7B,OAAO,CAAC,cAAc;CAavB"}

package/dist/local/workspace-prune.js

@@ -0,0 +1,267 @@
+import { createHash } from 'node:crypto';
+import { lstat } from 'node:fs/promises';
+import { stringifyCanonicalJson } from './canonical.js';
+import { discoverGitWorktree, listGitWorktreeStatus, removeGitWorktree } from './git.js';
+import { composeGraphProjection } from './projection.js';
+import { localGraphRootHash } from './workspace-graph-store.js';
+import { withWorkspaceOperationLock } from './workspace-lock.js';
+import { LocalWorkspaceCommitResolver } from './workspace-commit-resolver.js';
+import { workspaceControlDirectory, workspaceProjectionDirectory } from './workspace-paths.js';
+const DEFAULT_MIN_AGE_HOURS = 24;
+const MIN_MIN_AGE_HOURS = 1 / 60;
+const MAX_MIN_AGE_HOURS = 24 * 365;
+function sha256(value) {
+    return `sha256:${createHash('sha256').update(value).digest('hex')}`;
+}
+function minAgeHours(value) {
+    const normalized = value ?? DEFAULT_MIN_AGE_HOURS;
+    if (!Number.isFinite(normalized) ||
+        normalized < MIN_MIN_AGE_HOURS ||
+        normalized > MAX_MIN_AGE_HOURS) {
+        throw new Error(`Prune minimum age must be from ${MIN_MIN_AGE_HOURS} through ${MAX_MIN_AGE_HOURS} hours.`);
+    }
+    return normalized;
+}
+async function pathExists(path) {
+    try {
+        await lstat(path);
+        return true;
+    }
+    catch (error) {
+        const code = typeof error === 'object' && error !== null && 'code' in error
+            ? error.code
+            : null;
+        if (code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+function ignoredStatusIsManaged(status) {
+    if (!status.startsWith('!! '))
+        return false;
+    const path = status.slice(3);
+    return (path === '.sdlc/' ||
+        path.startsWith('.sdlc/') ||
+        path === 'sdlc/' ||
+        path.startsWith('sdlc/'));
+}
+export class LocalWorkspacePruner {
+    repository_root;
+    current_worktree_path;
+    store;
+    graphs;
+    commits;
+    assert_actor_authority;
+    constructor(input) {
+        this.repository_root = input.repository_root;
+        this.current_worktree_path = input.current_worktree_path;
+        this.store = input.store;
+        this.graphs = input.graphs;
+        this.commits = new LocalWorkspaceCommitResolver(input.store, input.graphs);
+        this.assert_actor_authority = input.assert_actor_authority;
+    }
+    async plan(input) {
+        await this.assert_actor_authority?.(input.actor_workspace_id);
+        const min_age_hours = minAgeHours(input.min_age_hours);
+        return this.graphs.withObjectStoreLock('prune-plan', () => this.buildPlan(input.actor_workspace_id, min_age_hours));
+    }
+    async apply(input) {
+        const min_age_hours = minAgeHours(input.min_age_hours);
+        if (!/^sha256:[0-9a-f]{64}$/.test(input.expected_plan_hash)) {
+            throw new Error('Expected prune plan hash must be a sha256 hash.');
+        }
+        return this.graphs.withObjectStoreLock('prune-apply', async () => {
+            await this.assert_actor_authority?.(input.actor_workspace_id);
+            const plan = await this.buildPlan(input.actor_workspace_id, min_age_hours);
+            if (plan.plan_hash !== input.expected_plan_hash) {
+                throw new Error(`Prune plan is stale; expected ${input.expected_plan_hash}, current ${plan.plan_hash}.`);
+            }
+            const removed_worktree_ids = [];
+            for (const entry of plan.worktrees) {
+                if (entry.disposition !== 'eligible')
+                    continue;
+                const workspace = this.store.getWorkspace(entry.workspace_id);
+                if (!workspace)
+                    throw new Error('Planned workspace is unavailable.');
+                await withWorkspaceOperationLock({
+                    control_dir: workspaceControlDirectory(workspace),
+                    operation: 'prune-worktree',
+                    run: async () => {
+                        await this.assert_actor_authority?.(input.actor_workspace_id);
+                        const current = await this.inspectWorktree(workspace, input.actor_workspace_id);
+                        if (current.disposition !== 'eligible') {
+                            throw new Error(`Workspace prune eligibility changed: ${workspace.id} (${current.reason}).`);
+                        }
+                        await removeGitWorktree({
+                            repository_cwd: this.repository_root,
+                            target_path: workspace.git_worktree_path,
+                            force: true
+                        });
+                        removed_worktree_ids.push(workspace.id);
+                    }
+                });
+            }
+            const removed_object_root_hashes = [];
+            let reclaimed_bytes = 0;
+            for (const object of plan.objects) {
+                const result = await this.graphs.pruneGraphObject({
+                    root_hash: object.root_hash,
+                    expected_size_bytes: object.size_bytes,
+                    expected_modified_at: object.modified_at,
+                    is_retained: () => this.store.listRetainedGraphRootHashes().includes(object.root_hash)
+                });
+                if (result === 'retained') {
+                    throw new Error(`Graph object became reachable during prune: ${object.root_hash}.`);
+                }
+                if (result === 'changed') {
+                    throw new Error(`Graph object changed after prune planning: ${object.root_hash}.`);
+                }
+                if (result === 'removed') {
+                    removed_object_root_hashes.push(object.root_hash);
+                    reclaimed_bytes += object.size_bytes;
+                }
+            }
+            return {
+                version: 1,
+                status: 'applied',
+                plan_hash: plan.plan_hash,
+                removed_worktree_ids,
+                removed_object_root_hashes,
+                reclaimed_bytes
+            };
+        });
+    }
+    async buildPlan(actor_workspace_id, min_age_hours) {
+        const actor = this.store.getWorkspace(actor_workspace_id);
+        if (!actor || actor.status !== 'active') {
+            throw new Error('Prune actor must be an active local workspace.');
+        }
+        if (actor.git_worktree_path !== this.current_worktree_path) {
+            throw new Error('Prune actor must match the current Git worktree.');
+        }
+        const worktrees = await Promise.all(this.store
+            .listWorkspaces()
+            .map((workspace) => this.inspectWorktree(workspace, actor_workspace_id)));
+        const retained_roots = this.store.listRetainedGraphRootHashes();
+        const retained_set = new Set(retained_roots);
+        const cutoff_ms = Date.now() - min_age_hours * 60 * 60 * 1000;
+        const objects = (await this.graphs.listGraphObjects())
+            .filter((object) => !retained_set.has(object.root_hash) &&
+            object.modified_at_ms <= cutoff_ms)
+            .map((object) => ({
+            root_hash: object.root_hash,
+            object_path: object.object_path,
+            size_bytes: object.size_bytes,
+            modified_at: new Date(object.modified_at_ms).toISOString()
+        }));
+        const retained_roots_hash = sha256(stringifyCanonicalJson(retained_roots));
+        const plan_payload = {
+            version: 1,
+            actor_workspace_id,
+            min_age_hours,
+            retained_roots_hash,
+            worktrees,
+            objects
+        };
+        return {
+            version: 1,
+            status: 'planned',
+            plan_hash: sha256(stringifyCanonicalJson(plan_payload)),
+            generated_at: new Date().toISOString(),
+            actor_workspace_id,
+            min_age_hours,
+            retained_root_count: retained_roots.length,
+            retained_roots_hash,
+            worktrees,
+            objects
+        };
+    }
+    async inspectWorktree(workspace, actor_workspace_id) {
+        const retained = (reason) => ({
+            workspace_id: workspace.id,
+            git_worktree_path: workspace.git_worktree_path,
+            disposition: 'retained',
+            reason
+        });
+        if (workspace.git_worktree_path === this.current_worktree_path) {
+            return retained('current_physical_worktree');
+        }
+        if (!this.isDescendantOf(workspace, actor_workspace_id)) {
+            return retained('outside_actor_lineage');
+        }
+        if (workspace.status !== 'closed')
+            return retained('workspace_active');
+        if (workspace.actor_kind !== 'ai')
+            return retained('not_ai_owned');
+        if (!workspace.source_workspace_id)
+            return retained('foreground_workspace');
+        if (workspace.attached_ref)
+            return retained('attached_ref');
+        if (this.store
+            .listChildWorkspaces(workspace.id)
+            .some((child) => child.status === 'active')) {
+            return retained('active_child_workspace');
+        }
+        if (!(await pathExists(workspace.git_worktree_path))) {
+            return {
+                workspace_id: workspace.id,
+                git_worktree_path: workspace.git_worktree_path,
+                disposition: 'already_absent',
+                reason: 'physical_path_absent'
+            };
+        }
+        let git;
+        try {
+            git = await discoverGitWorktree(workspace.git_worktree_path);
+        }
+        catch {
+            return retained('git_worktree_unreadable');
+        }
+        if (git.repository_root !== workspace.git_worktree_path ||
+            git.git_common_dir !== workspace.git_common_dir ||
+            git.git_dir !== workspace.git_dir) {
+            return retained('git_identity_mismatch');
+        }
+        if (git.ref !== null)
+            return retained('git_ref_attached');
+        if (git.head !== workspace.fork_git_commit_id) {
+            return retained('git_head_mismatch');
+        }
+        if (git.is_dirty)
+            return retained('git_worktree_dirty');
+        const status = await listGitWorktreeStatus(workspace.git_worktree_path, {
+            include_ignored: true
+        });
+        if (status.some((entry) => !ignoredStatusIsManaged(entry))) {
+            return retained('unmanaged_ignored_content');
+        }
+        try {
+            const { graph } = await composeGraphProjection(workspaceProjectionDirectory(workspace), undefined, { base: () => this.commits.readGraph(workspace.head_sdlc_commit_id) });
+            const head = this.commits.root(workspace.head_sdlc_commit_id);
+            if (localGraphRootHash(graph) !== head) {
+                return retained('managed_projection_dirty');
+            }
+        }
+        catch {
+            return retained('managed_projection_unreadable');
+        }
+        return {
+            workspace_id: workspace.id,
+            git_worktree_path: workspace.git_worktree_path,
+            disposition: 'eligible',
+            reason: 'closed_detached_ai_child'
+        };
+    }
+    isDescendantOf(workspace, ancestor_workspace_id) {
+        let source_workspace_id = workspace.source_workspace_id;
+        while (source_workspace_id) {
+            if (source_workspace_id === ancestor_workspace_id)
+                return true;
+            source_workspace_id =
+                this.store.getWorkspace(source_workspace_id)?.source_workspace_id ??
+                    null;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=workspace-prune.js.map

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

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

package/dist/local/workspace-remote-fetch.d.ts

@@ -0,0 +1,82 @@
+import { type PortableCommit } from './portable-commit.js';
+export { remote_fetch_request_schema, remote_fetch_response_schema, remote_graph_object_schema, remote_ref_advertisement_schema, remote_ref_schema, type RemoteRefAdvertisement } from './portable-remote.js';
+import type { LocalPortableCommitStore } from './portable-commit-store.js';
+import { type LocalWorkspaceGraphStore } from './workspace-graph-store.js';
+import { type LocalWorkspaceRemoteProviderStore } from './workspace-remote-provider.js';
+import type { LocalWorkspaceStoreDatabase } from './workspace-store-database.js';
+export type LocalRemoteTrackingRef = {
+    remote_name: string;
+    source_ref: string;
+    tracking_ref: string;
+    commit_id: string;
+    created_at: string;
+    updated_at: string;
+};
+export type LocalRemoteFetchJournal = {
+    id: string;
+    remote_name: string;
+    source_ref: string;
+    tracking_ref: string;
+    expected_old_commit_id: string | null;
+    wanted_commit_id: string;
+    haves: string[];
+    received_commit_ids: string[];
+    received_graph_roots: string[];
+    status: 'planned' | 'verified' | 'completed' | 'stale' | 'failed';
+    error_code: string | null;
+    created_at: string;
+    updated_at: string;
+};
+export type LocalRemoteFetchResult = {
+    version: 1;
+    status: 'updated' | 'unchanged' | 'stale';
+    remote_name: string;
+    source_ref: string;
+    tracking_ref: string;
+    previous_commit_id: string | null;
+    commit_id: string;
+    received_commit_count: number;
+    received_graph_object_count: number;
+    journal_id: string;
+};
+export declare function trackingRefName(remote_name: string, source_ref: string): string;
+export declare class LocalRemoteTrackingStore {
+    private readonly database;
+    private readonly portable_commits;
+    constructor(database: LocalWorkspaceStoreDatabase, portable_commits: LocalPortableCommitStore);
+    listRefs(remote_name?: string): LocalRemoteTrackingRef[];
+    getRef(remote_name: string, source_ref: string): LocalRemoteTrackingRef | null;
+    listPortableCommitIds(): string[];
+    listJournals(remote_name?: string): LocalRemoteFetchJournal[];
+    plan(input: {
+        remote_name: string;
+        source_ref: string;
+        wanted_commit_id: string;
+        haves: string[];
+    }): LocalRemoteFetchJournal;
+    fail(journal_id: string, error_code: string): void;
+    recordVerifiedClosure(input: {
+        journal_id: string;
+        commit_ids: string[];
+        graph_roots: string[];
+    }): void;
+    complete(input: {
+        journal: LocalRemoteFetchJournal;
+        commits: PortableCommit[];
+        received_graph_roots: string[];
+    }): 'updated' | 'unchanged' | 'stale';
+}
+export declare class LocalWorkspaceRemoteFetcher {
+    private readonly remotes;
+    private readonly tracking;
+    private readonly portable_commits;
+    private readonly graphs;
+    constructor(remotes: LocalWorkspaceRemoteProviderStore, tracking: LocalRemoteTrackingStore, portable_commits: LocalPortableCommitStore, graphs: LocalWorkspaceGraphStore);
+    fetch(input: {
+        name: string;
+        source_ref: string;
+        fetch_impl?: typeof fetch;
+        timeout_ms?: number;
+    }): Promise<LocalRemoteFetchResult>;
+}
+//# sourceMappingURL=workspace-remote-fetch.d.ts.map

package/dist/local/workspace-remote-fetch.d.ts.map

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