@software-dlc/cli 0.157.2

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

@@ -0,0 +1,475 @@
+import { createHash, randomUUID } from 'node:crypto';
+import { stringifyCanonicalJson } from './canonical.js';
+import { requireMutableLocalBranchRef } from './git-ref-authority.js';
+import { parsePortableCommit } from './portable-commit.js';
+import { LocalMixedHistoryGraph } from './workspace-mixed-history.js';
+function requireValue(value, label) {
+    const normalized_value = value.trim();
+    if (normalized_value.length === 0) {
+        throw new Error(`${label} must not be empty.`);
+    }
+    return normalized_value;
+}
+function parseStringArray(value, label) {
+    const parsed = JSON.parse(value);
+    if (!Array.isArray(parsed) ||
+        parsed.some((entry) => typeof entry !== 'string')) {
+        throw new Error(`${label} is corrupt.`);
+    }
+    return parsed;
+}
+export class LocalWorkspaceUpstreamStore {
+    database;
+    journal;
+    mixed_history;
+    constructor(database, journal) {
+        this.database = database;
+        this.journal = journal;
+        this.mixed_history = new LocalMixedHistoryGraph((commit_id) => this.canonicalCommitId(commit_id), (commit_id) => {
+            const portable = this.database
+                .prepare('select commit_json from portable_commit where id = ?')
+                .get(commit_id);
+            if (portable) {
+                const commit = parsePortableCommit(JSON.parse(portable.commit_json));
+                return {
+                    root_hash: commit.graph_root,
+                    parent_ids: commit.parent_ids
+                };
+            }
+            const local = this.localCommit(commit_id);
+            return local
+                ? { root_hash: local.root_hash, parent_ids: local.parent_ids }
+                : null;
+        });
+    }
+    listAttempts(local_ref) {
+        if (local_ref) {
+            const ref = requireMutableLocalBranchRef(local_ref, 'Local SDLC branch ref');
+            return this.database
+                .prepare(`select * from local_branch_integration_attempt
+           where local_ref = ? order by created_at, id`)
+                .all(ref);
+        }
+        return this.database
+            .prepare('select * from local_branch_integration_attempt order by created_at, id')
+            .all();
+    }
+    listResolutionAttempts(branch_integration_attempt_id) {
+        return this.database
+            .prepare(`select * from local_branch_integration_resolution_attempt
+         where branch_integration_attempt_id = ? order by created_at, id`)
+            .all(requireValue(branch_integration_attempt_id, 'Branch integration attempt id'));
+    }
+    getAttempt(attempt_id) {
+        return (this.database
+            .prepare('select * from local_branch_integration_attempt where id = ?')
+            .get(requireValue(attempt_id, 'Branch integration attempt id')) ?? null);
+    }
+    listRevertAttempts(local_ref) {
+        if (local_ref) {
+            const ref = requireMutableLocalBranchRef(local_ref, 'Local SDLC branch ref');
+            return this.database
+                .prepare(`select * from local_branch_integration_revert_attempt
+           where local_ref = ? order by created_at, id`)
+                .all(ref);
+        }
+        return this.database
+            .prepare(`select * from local_branch_integration_revert_attempt
+         order by created_at, id`)
+            .all();
+    }
+    revert(input) {
+        return this.runTransaction(() => {
+            const workspace = this.requireActiveWorkspace(input.actor_workspace_id);
+            if (workspace.actor_kind !== 'human') {
+                throw new Error('Upstream integration revert is owned by the active human workspace.');
+            }
+            const integration = this.getAttempt(input.branch_integration_attempt_id);
+            if (!integration) {
+                throw new Error('Branch integration attempt was not found.');
+            }
+            if (integration.status !== 'fast_forwarded' &&
+                integration.status !== 'merged') {
+                throw new Error('Only a successful head-moving integration can be reverted.');
+            }
+            if (!integration.resulting_head_commit_id) {
+                throw new Error('Successful integration has no resulting head.');
+            }
+            if (workspace.attached_ref !== integration.local_ref) {
+                throw new Error('The current workspace is not attached to the integrated local branch.');
+            }
+            const local = this.database
+                .prepare('select head_commit_id from local_workspace_ref where ref_name = ?')
+                .get(integration.local_ref);
+            if (!local)
+                throw new Error('Integrated local branch was not found.');
+            const expected_head_commit_id = integration.resulting_head_commit_id;
+            const observed_head_commit_id = local.head_commit_id;
+            const stale = workspace.head_sdlc_commit_id !== expected_head_commit_id ||
+                observed_head_commit_id !== expected_head_commit_id;
+            if (stale) {
+                const attempt = this.recordRevertAttempt({
+                    integration,
+                    workspace_id: workspace.id,
+                    expected_head_commit_id,
+                    observed_head_commit_id,
+                    revert_commit_id: null,
+                    status: 'stale_head',
+                    validation_evidence: []
+                });
+                return {
+                    version: 1,
+                    status: 'stale_head',
+                    attempt,
+                    current_head_commit_id: workspace.head_sdlc_commit_id
+                };
+            }
+            const previous_revert = this.database
+                .prepare(`select id from local_branch_integration_revert_attempt
+           where branch_integration_attempt_id = ? and status = 'reverted'`)
+                .get(integration.id);
+            if (previous_revert) {
+                throw new Error('Branch integration was already reverted.');
+            }
+            if (this.mixed_history.root(integration.expected_local_commit_id) !==
+                input.target_root_hash) {
+                throw new Error('Revert target root does not match the pre-integration commit.');
+            }
+            const validation_evidence = input.validation_evidence ?? [];
+            const commit = this.createCommit({
+                root_hash: input.target_root_hash,
+                parent_ids: [expected_head_commit_id],
+                author_workspace_id: workspace.id,
+                message: input.message ?? `Revert upstream integration ${integration.id}`,
+                validation_status: 'passed',
+                validation_evidence
+            });
+            this.advanceWorkspaceHead(workspace, commit.id);
+            const attempt = this.recordRevertAttempt({
+                integration,
+                workspace_id: workspace.id,
+                expected_head_commit_id,
+                observed_head_commit_id,
+                revert_commit_id: commit.id,
+                status: 'reverted',
+                validation_evidence
+            });
+            return { version: 1, status: 'reverted', attempt, commit };
+        });
+    }
+    integrate(input) {
+        return this.runTransaction(() => {
+            const workspace = this.requireActiveWorkspace(input.actor_workspace_id);
+            const local_ref = requireMutableLocalBranchRef(input.local_ref, 'Local SDLC branch ref');
+            if (workspace.actor_kind !== 'human') {
+                throw new Error('Upstream integration is owned by the active human workspace.');
+            }
+            if (workspace.attached_ref !== local_ref) {
+                throw new Error('The current workspace is not attached to the selected local branch.');
+            }
+            this.assertAssociation(input, local_ref);
+            const local = this.database
+                .prepare('select head_commit_id from local_workspace_ref where ref_name = ?')
+                .get(local_ref);
+            const upstream = this.database
+                .prepare(`select commit_id from remote_tracking_ref
+           where remote_name = ? and source_ref = ? and tracking_ref = ?`)
+                .get(input.remote_name, input.source_ref, input.tracking_ref);
+            const stale = workspace.head_sdlc_commit_id !== input.expected_local_commit_id ||
+                local?.head_commit_id !== input.expected_local_commit_id ||
+                upstream?.commit_id !== input.expected_upstream_commit_id;
+            this.assertMergeBindings(input);
+            const candidate = this.createCandidate(input, workspace.id);
+            if (stale) {
+                const attempt = this.recordAttempt({
+                    input,
+                    workspace_id: workspace.id,
+                    candidate,
+                    resulting_head_commit_id: null,
+                    status: 'stale_head'
+                });
+                return {
+                    version: 1,
+                    status: 'stale_head',
+                    attempt,
+                    current_local_commit_id: local?.head_commit_id ?? workspace.head_sdlc_commit_id,
+                    current_upstream_commit_id: upstream?.commit_id ?? null,
+                    candidate_commit_id: candidate?.id ?? null
+                };
+            }
+            if (input.merge_result.status === 'blocked_conflict') {
+                const attempt = this.recordAttempt({
+                    input,
+                    workspace_id: workspace.id,
+                    candidate: null,
+                    resulting_head_commit_id: null,
+                    status: 'blocked_conflict'
+                });
+                return {
+                    version: 1,
+                    status: 'blocked_conflict',
+                    attempt,
+                    candidate_commit_id: null
+                };
+            }
+            if (input.merge_result.status === 'blocked_validation') {
+                const attempt = this.recordAttempt({
+                    input,
+                    workspace_id: workspace.id,
+                    candidate,
+                    resulting_head_commit_id: null,
+                    status: 'blocked_validation'
+                });
+                return {
+                    version: 1,
+                    status: 'blocked_validation',
+                    attempt,
+                    candidate_commit_id: candidate?.id ?? null
+                };
+            }
+            if (input.mode === 'already_integrated') {
+                const attempt = this.recordAttempt({
+                    input,
+                    workspace_id: workspace.id,
+                    candidate: null,
+                    resulting_head_commit_id: input.expected_local_commit_id,
+                    status: 'already_integrated'
+                });
+                return {
+                    version: 1,
+                    status: 'already_integrated',
+                    attempt,
+                    head_commit_id: input.expected_local_commit_id
+                };
+            }
+            const next_head_commit_id = input.mode === 'fast_forward'
+                ? input.expected_upstream_commit_id
+                : candidate?.id;
+            if (!next_head_commit_id) {
+                throw new Error('Clean upstream integration candidate was not created.');
+            }
+            this.advanceWorkspaceHead(workspace, next_head_commit_id);
+            const status = input.mode === 'fast_forward' ? 'fast_forwarded' : 'merged';
+            const attempt = this.recordAttempt({
+                input,
+                workspace_id: workspace.id,
+                candidate,
+                resulting_head_commit_id: next_head_commit_id,
+                status
+            });
+            return status === 'fast_forwarded'
+                ? { version: 1, status, attempt, head_commit_id: next_head_commit_id }
+                : {
+                    version: 1,
+                    status,
+                    attempt,
+                    commit: candidate
+                };
+        });
+    }
+    runTransaction(operation) {
+        this.database.exec('begin immediate');
+        try {
+            const result = operation();
+            this.database.exec('commit');
+            return result;
+        }
+        catch (error) {
+            this.database.exec('rollback');
+            throw error;
+        }
+    }
+    requireActiveWorkspace(workspace_id) {
+        const workspace = this.database
+            .prepare(`select id, actor_kind, head_sdlc_commit_id, attached_ref, status
+         from local_workspace where id = ?`)
+            .get(workspace_id);
+        if (!workspace || workspace.status !== 'active') {
+            throw new Error('Active local workspace was not found.');
+        }
+        return workspace;
+    }
+    assertAssociation(input, local_ref) {
+        const association = this.database
+            .prepare('select * from local_branch_association where local_ref = ?')
+            .get(local_ref);
+        if (!association ||
+            association.upstream_remote_name !== input.remote_name ||
+            association.upstream_source_ref !== input.source_ref ||
+            association.upstream_tracking_ref !== input.tracking_ref) {
+            throw new Error('Local branch upstream association changed.');
+        }
+    }
+    createCandidate(input, workspace_id) {
+        if (input.mode !== 'merge' ||
+            input.merge_result.status === 'blocked_conflict') {
+            return null;
+        }
+        return this.createCommit({
+            root_hash: input.merge_result.root_hash,
+            parent_ids: [
+                input.expected_local_commit_id,
+                input.expected_upstream_commit_id
+            ],
+            author_workspace_id: workspace_id,
+            message: input.message ??
+                `Merge upstream commit ${input.expected_upstream_commit_id}`,
+            validation_status: input.merge_result.status === 'clean' ? 'passed' : 'failed',
+            validation_evidence: input.merge_result.status === 'clean'
+                ? (input.validation_evidence ?? [])
+                : input.merge_result.issues.map((issue) => `${issue.code}: ${issue.message}`)
+        });
+    }
+    createCommit(input) {
+        const created_at = new Date().toISOString();
+        const content = {
+            version: 1,
+            root_hash: requireValue(input.root_hash, 'Commit root hash'),
+            parent_ids: input.parent_ids.map((parent_id) => requireValue(parent_id, 'Parent commit id')),
+            author_workspace_id: input.author_workspace_id,
+            message: requireValue(input.message, 'Commit message'),
+            validation_status: input.validation_status,
+            validation_evidence: input.validation_evidence,
+            created_at
+        };
+        const commit = {
+            id: `sha256:${createHash('sha256')
+                .update(stringifyCanonicalJson(content))
+                .digest('hex')}`,
+            ...content
+        };
+        this.database
+            .prepare(`insert into local_workspace_commit (
+          id, root_hash, parent_ids_json, author_workspace_id, message,
+          validation_status, validation_evidence_json, created_at
+        ) values (?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(commit.id, commit.root_hash, stringifyCanonicalJson(commit.parent_ids), commit.author_workspace_id, commit.message, commit.validation_status, stringifyCanonicalJson(commit.validation_evidence), commit.created_at);
+        return commit;
+    }
+    advanceWorkspaceHead(workspace, next_head_commit_id) {
+        if (!workspace.attached_ref) {
+            throw new Error('Upstream integration requires an attached local branch.');
+        }
+        const now = new Date().toISOString();
+        const ref_update = this.database
+            .prepare(`update local_workspace_ref set head_commit_id = ?, updated_at = ?
+         where ref_name = ? and head_commit_id = ?`)
+            .run(next_head_commit_id, now, workspace.attached_ref, workspace.head_sdlc_commit_id);
+        const workspace_update = this.database
+            .prepare(`update local_workspace set head_sdlc_commit_id = ?, updated_at = ?
+         where id = ? and head_sdlc_commit_id = ?`)
+            .run(next_head_commit_id, now, workspace.id, workspace.head_sdlc_commit_id);
+        if (ref_update.changes !== 1 || workspace_update.changes !== 1) {
+            throw new Error('Upstream integration head CAS failed.');
+        }
+    }
+    recordAttempt(input) {
+        const attempt_id = this.journal.insertBranchIntegrationAttempt({
+            workspace_id: input.workspace_id,
+            local_ref: input.input.local_ref,
+            tracking_ref: input.input.tracking_ref,
+            expected_local_commit_id: input.input.expected_local_commit_id,
+            expected_upstream_commit_id: input.input.expected_upstream_commit_id,
+            merge_base_commit_id: input.input.merge_base_commit_id,
+            candidate_commit_id: input.candidate?.id ?? null,
+            resulting_head_commit_id: input.resulting_head_commit_id,
+            status: input.status,
+            merge_result: input.input.merge_result
+        });
+        this.journal.insertBranchIntegrationResolutionAttempts({
+            branch_integration_attempt_id: attempt_id,
+            attempts: input.input.resolution_attempts ?? [],
+            resulting_commit_id: input.candidate?.id ?? null,
+            resulting_root_hash: input.candidate?.root_hash ?? null
+        });
+        const attempt = this.database
+            .prepare('select * from local_branch_integration_attempt where id = ?')
+            .get(attempt_id);
+        if (!attempt) {
+            throw new Error('Branch integration attempt was not persisted.');
+        }
+        return attempt;
+    }
+    recordRevertAttempt(input) {
+        const attempt = {
+            id: randomUUID(),
+            branch_integration_attempt_id: input.integration.id,
+            workspace_id: input.workspace_id,
+            local_ref: input.integration.local_ref,
+            expected_head_commit_id: input.expected_head_commit_id,
+            observed_head_commit_id: input.observed_head_commit_id,
+            target_commit_id: input.integration.expected_local_commit_id,
+            revert_commit_id: input.revert_commit_id,
+            status: input.status,
+            validation_json: stringifyCanonicalJson(input.validation_evidence),
+            created_at: new Date().toISOString()
+        };
+        this.database
+            .prepare(`insert into local_branch_integration_revert_attempt (
+          id, branch_integration_attempt_id, workspace_id, local_ref,
+          expected_head_commit_id, observed_head_commit_id, target_commit_id,
+          revert_commit_id, status, validation_json, created_at
+        ) values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(attempt.id, attempt.branch_integration_attempt_id, attempt.workspace_id, attempt.local_ref, attempt.expected_head_commit_id, attempt.observed_head_commit_id, attempt.target_commit_id, attempt.revert_commit_id, attempt.status, attempt.validation_json, attempt.created_at);
+        return attempt;
+    }
+    assertMergeBindings(input) {
+        if (!this.mixed_history.isAncestor(input.merge_base_commit_id, input.expected_local_commit_id) ||
+            !this.mixed_history.isAncestor(input.merge_base_commit_id, input.expected_upstream_commit_id)) {
+            throw new Error('Upstream merge base is not an ancestor of both heads.');
+        }
+        if (input.mode === 'fast_forward' &&
+            !this.mixed_history.isAncestor(input.expected_local_commit_id, input.expected_upstream_commit_id)) {
+            throw new Error('Fast-forward target does not descend from the local head.');
+        }
+        if (input.mode === 'already_integrated' &&
+            !this.mixed_history.isAncestor(input.expected_upstream_commit_id, input.expected_local_commit_id)) {
+            throw new Error('Upstream head is not already integrated locally.');
+        }
+        for (const [commit_id, root_hash, message] of [
+            [
+                input.merge_base_commit_id,
+                input.merge_result.base_root_hash,
+                'Upstream merge base root does not match its commit.'
+            ],
+            [
+                input.expected_local_commit_id,
+                input.merge_result.coordinator_root_hash,
+                'Local merge input root does not match its commit.'
+            ],
+            [
+                input.expected_upstream_commit_id,
+                input.merge_result.child_root_hash,
+                'Upstream merge input root does not match its commit.'
+            ]
+        ]) {
+            if (this.mixed_history.root(commit_id) !== root_hash)
+                throw new Error(message);
+        }
+    }
+    canonicalCommitId(commit_id) {
+        const portable = this.database
+            .prepare('select id from portable_commit where id = ?')
+            .get(commit_id);
+        if (portable)
+            return portable.id;
+        const mapping = this.database
+            .prepare('select portable_commit_id from local_commit_portable_mapping where local_commit_id = ?')
+            .get(commit_id);
+        return mapping?.portable_commit_id ?? commit_id;
+    }
+    localCommit(commit_id) {
+        const row = this.database
+            .prepare('select * from local_workspace_commit where id = ?')
+            .get(commit_id);
+        return row
+            ? {
+                version: 1,
+                ...row,
+                parent_ids: parseStringArray(row.parent_ids_json, 'Commit parents'),
+                validation_evidence: parseStringArray(row.validation_evidence_json, 'Commit validation evidence')
+            }
+            : null;
+    }
+}
+//# sourceMappingURL=workspace-upstream-store.js.map

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

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

package/dist/local/workspace-viewer-server.d.ts

@@ -0,0 +1,136 @@
+import type { AppContractAnswer, AppContractRoute } from './app-contract-readers.js';
+import type { LocalWorkspaceRuntime } from './workspace-runtime.js';
+/** What a pin from the page did (cli-view threadsPinProvider). */
+export type LocalWorkspaceViewerPinResult = {
+    pinned: string[];
+} | {
+    refused: string;
+} | {
+    failed: string;
+};
+/** What the user marks done from the Tasks panel: a task given to them, or one wait on them. */
+export type LocalWorkspaceViewerTaskDoneTarget = {
+    task: string;
+} | {
+    hold: string;
+};
+/**
+ * What `status user-done` did for a Done from the page (cli-view taskDoneProvider): the words the
+ * threads it told got, the engine's refusal (what closes it instead), or why it could not run.
+ */
+export type LocalWorkspaceViewerTaskDoneResult = {
+    message: string;
+} | {
+    refused: string;
+} | {
+    failed: string;
+};
+/**
+ * A Releases panel subject: the summary, the list of releases, or one release, Planned Release,
+ * issue or task (its task page, read from task_page.py rather than release_links.py). threads is no
+ * panel: the open Planned Releases each thread serves (release_links.py threads, plan fea8cf22),
+ * which the shell's Threads merges into its rows by thread key.
+ */
+export type LocalWorkspaceViewerReleaseSubject = {
+    kind: 'summary';
+} | {
+    kind: 'releases';
+} | {
+    kind: 'threads';
+} | {
+    kind: 'release' | 'planned' | 'issue' | 'task';
+    ref: string;
+};
+/**
+ * A Releases panel read (cli-view releaseLinksPanelProvider): the panel's rows, an unknown subject's
+ * one line, why the read failed, or that the engine has no release links (the panel is left out).
+ * A partial panel has a section that could not be read (its Try again): like a failure, it is not kept.
+ * The threads subject's panel is release_links.py threads' answer as it is, { threads, entries }.
+ */
+export type LocalWorkspaceViewerReleaseAnswer = {
+    panel: unknown;
+    partial?: boolean;
+} | {
+    unknown: string;
+} | {
+    error: string;
+} | {
+    absent: true;
+};
+/** The subject a query names, or why it names none: at most one of release, planned, issue, task, releases, threads. */
+export declare function releaseSubjectOf(query: URLSearchParams): LocalWorkspaceViewerReleaseSubject | {
+    refused: string;
+};
+export type LocalWorkspaceViewerServer = {
+    url: string;
+    origin: string;
+    port: number;
+    /** 'react' when the React bundle answers '<token>/', 'classic' when the inline page does. */
+    page: 'react' | 'classic';
+    close: () => Promise<void>;
+    closed: Promise<void>;
+};
+/** Whether a path under the token is one of the shell's addresses. */
+export declare function isShellAddress(rest: string): boolean;
+/** Where the sdlc package ships the React viewer's built files: viewer/ beside dist/. */
+export declare function defaultViewerBundle(): string;
+export declare function startLocalWorkspaceViewer(input: {
+    runtime: LocalWorkspaceRuntime;
+    port?: number;
+    /** The Threads panel's data (cli-view threadsPanelProvider); absent, api/threads is 404. */
+    threads?: () => unknown;
+    /**
+     * Pins or unpins a thread in the store every SDLC view shares (cli-view threadsPinProvider):
+     * view state, not graph state. Absent, api/pin is 404.
+     */
+    pin?: (key: string, on: boolean) => LocalWorkspaceViewerPinResult;
+    /**
+     * The user marks a task given to them, or a wait on them, done (cli-view taskDoneProvider, which
+     * runs the engine's `status user-done`): a coordination write, not graph state. It must not block
+     * this process. Absent, api/task-done is 404.
+     */
+    taskDone?: (target: LocalWorkspaceViewerTaskDoneTarget) => Promise<LocalWorkspaceViewerTaskDoneResult>;
+    /**
+     * The Worktrees page's writes (la-worktrees, worktreesProvider): Merge joins a worktree's thread
+     * to the main promotion queue, Remove runs archive.py worktrees --apply --only for one, and
+     * Dismiss clears an outcome the page shows. Merge and Remove answer 202 once queued and run one
+     * at a time. Absent, api/worktree-merge, api/worktree-remove and api/worktree-dismiss are 404.
+     */
+    worktrees?: {
+        merge: (body: unknown) => Promise<AppContractAnswer>;
+        remove: (body: unknown) => Promise<AppContractAnswer>;
+        dismiss: (body: unknown) => AppContractAnswer;
+    };
+    /**
+     * The Releases panel's read of one subject (cli-view releaseLinksPanelProvider), which must not
+     * block this process: release_links.py view runs for two to three seconds. Absent,
+     * api/release-links is 404 and the page leaves the panel out.
+     */
+    releaseLinks?: (subject: LocalWorkspaceViewerReleaseSubject) => Promise<LocalWorkspaceViewerReleaseAnswer>;
+    /**
+     * The Work queues panel's data (cli-view queuesPanelProvider, qv-viewer): every queue, who waits in
+     * it and when it should clear. It must not block this process: the read takes about 20 s on a busy
+     * machine (qv-viewer-async). Absent, or answering null (no queue model), api/queues is 404.
+     */
+    queues?: () => Promise<unknown>;
+    /**
+     * The shared pages' contract reads (GET api/app/…, la-contracts; cli-view appContractsProvider):
+     * the tasks, issues, Releases, organization and project the hosted session routes answer, in their
+     * shapes. It must not block this process. Absent, every api/app/ path is 404.
+     */
+    app?: ((route: AppContractRoute) => Promise<AppContractAnswer>) & {
+        /** A HEAD's status for a route, which reads nothing; absent, every checked route is 200. */
+        head?: (segments: string[]) => number;
+        /** Drops the kept Tasks reads, after a Done changed them. */
+        invalidate?: () => void;
+    };
+    /** The clock the Releases panel's keeps read, epoch ms; tests stand it in. */
+    now?: () => number;
+    /**
+     * The React viewer's built files (plan viewer-react): absent, the sdlc package's viewer/; null, or
+     * a directory without index.html (a source checkout never built), and '<token>/' serves the
+     * classic page as before.
+     */
+    bundle?: string | null;
+}): Promise<LocalWorkspaceViewerServer>;
+//# sourceMappingURL=workspace-viewer-server.d.ts.map

package/dist/local/workspace-viewer-server.d.ts.map

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