specrails-core 5.6.0 → 6.0.0

package/dist/installer/commands/init.d.ts

@@ -2,8 +2,7 @@ import { type Provider } from '../phases/install-config.js';
 /**
  * `npx specrails-core init` entry point.
  *
- * Flags consumed (must remain in sync with ALLOWED_FLAGS in
- * bin/specrails-core.cjs until Phase 5):
+ * Flags consumed:
  *   --root-dir <path>     Target repo (default: cwd)
  *   --yes / -y            Non-interactive; auto-init git + accept defaults
  *   --provider <name>     Force provider (claude, codex, gemini, or kimi)
@@ -26,11 +25,11 @@ export interface InitFlags {
     relocate?: boolean;
     'hub-json'?: boolean;
 }
-export interface InitResult {
+interface InitResult {
     repoRoot: string;
     provider: Provider;
 }
-export type WorkspaceProviderSelections = Partial<Record<Provider, string[]>>;
+type WorkspaceProviderSelections = Partial<Record<Provider, string[]>>;
 /**
  * Snapshot the provider/role inventory exposed by one live workspace before a
  * global framework version swap. This matters on Windows: directory junctions
@@ -40,25 +39,6 @@ export type WorkspaceProviderSelections = Partial<Record<Provider, string[]>>;
  * optional role selection during that refresh.
  */
 export declare function snapshotWorkspaceProviderSelections(workspace: string): WorkspaceProviderSelections;
-interface ReassembleWorkspaceProvidersInput {
-    workspace: string;
-    frameworkDir: string;
-    version: string;
-    codeRoot: string;
-    scriptDir: string;
-    selectedProvider: Provider;
-    selectedAgents?: string[];
-    previousSelections: WorkspaceProviderSelections;
-    copyStatics: boolean;
-}
-/**
- * Refresh every provider already represented in the project plus the provider
- * selected by the current operation. POSIX symlinks continue to follow
- * `framework/current`; Windows junctions do not reliably preserve that
- * indirection, so rebuilding all live links is required for true
- * multi-provider version parity.
- */
-export declare function reassembleWorkspaceProviders(input: ReassembleWorkspaceProvidersInput): Provider[];
 /**
  * Entry called by cli.ts. Returns a {@link InitResult} on success;
  * throws a typed error (translated to an exit code by the outer CLI)
@@ -72,7 +52,7 @@ export declare function runInit(flags: InitFlags): Promise<InitResult>;
  * points at the v5 extension path.
  */
 export declare function warnUnknownSelectedAgents(selected: string[] | undefined): void;
-export interface EnsureFrameworkInput {
+interface EnsureFrameworkInput {
     scriptDir: string;
     frameworkDir: string;
     provider: Provider;
@@ -143,5 +123,4 @@ export declare const KIMI_REQUIRED_OPENSPEC_SKILLS: readonly ["openspec-propose"
  */
 export declare function normalizeKimiOpenSpecSkills(repoRoot: string, artifactRoot: string): string[];
 export declare function normalizeGeminiOpenSpecSkills(repoRoot: string, artifactRoot: string): string[];
-export declare function installOpenSpecProject(repoRoot: string, provider: Provider, artifactRoot?: string): Promise<void>;
 export {};

package/dist/installer/commands/init.js

@@ -97,7 +97,7 @@ function workspaceHasManagedProviderLink(providerRoot, provider) {
  * indirection, so rebuilding all live links is required for true
  * multi-provider version parity.
  */
-export function reassembleWorkspaceProviders(input) {
+function reassembleWorkspaceProviders(input) {
     const providers = WORKSPACE_PROVIDER_ORDER.filter((provider) => provider === input.selectedProvider ||
         Object.prototype.hasOwnProperty.call(input.previousSelections, provider));
     for (const provider of providers) {
@@ -129,9 +129,8 @@ export async function runInit(flags) {
     const repoRoot = path.resolve(typeof flags['root-dir'] === 'string' ? flags['root-dir'] : process.cwd());
     const autoYes = flags.yes === true || flags.y === true;
     const skipPrereqs = process.env.SPECRAILS_SKIP_PREREQS === '1';
-    // Validate an explicit provider before consulting --from-config. The TUI
-    // intentionally re-enters init with BOTH flags; accepting that flow is safe
-    // only when the generated config agrees with the original explicit choice.
+    // Validate an explicit provider before consulting --from-config; when both
+    // are given, the config must agree with the explicit choice.
     let explicitProvider;
     if (flags.provider !== undefined) {
         if (typeof flags.provider !== 'string' ||
@@ -257,7 +256,6 @@ export async function runInit(flags) {
                 recordSuccessfulInstall(repoRoot, { home: process.env.SPECRAILS_REGISTRY_HOME, providers: [prereqs.provider], coreVersion: version });
             step('Installation complete');
             info('Agents, commands, and rules were placed directly — no follow-up step required.');
-            info('Extend the core trio (sr-architect, sr-developer, sr-reviewer) via profiles + custom-*.md agents.');
             // Terminal sentinel for programmatic consumers (specrails-desktop's setup
             // wizard matches this exact line via regex to mark the "init complete"
             // checkpoint). The sentinel line below is FROZEN — the downstream setup
@@ -282,7 +280,7 @@ export function warnUnknownSelectedAgents(selected) {
     for (const id of selected) {
         if (!CORE_AGENTS.has(id)) {
             warn(`install-config.yaml selects agent '${id}', which specrails-core no longer ships — ` +
-                `skipping (removed in v5; use a .claude/agents/custom-*.md agent declared in a profile).`);
+                `skipping (removed in v5).`);
         }
     }
 }
@@ -658,7 +656,7 @@ function removeDirectoryIfEmpty(dir) {
     if (isDir(dir) && listDir(dir).length === 0)
         removePath(dir);
 }
-export async function installOpenSpecProject(repoRoot, provider, artifactRoot = repoRoot) {
+async function installOpenSpecProject(repoRoot, provider, artifactRoot = repoRoot) {
     if (process.env.SPECRAILS_SKIP_OPENSPEC_INIT === '1') {
         if (provider === 'kimi') {
             const generatedRoots = [
@@ -709,4 +707,3 @@ export async function installOpenSpecProject(repoRoot, provider, artifactRoot =
         }
     }
 }
-//# sourceMappingURL=init.js.map

package/dist/installer/phases/framework-lifecycle.d.ts

@@ -1,30 +1,15 @@
 import { type Provider } from './provider-detect.js';
-/**
- * Stable provider order for the global framework store. `framework/current` is
- * shared by every relocated workspace, so a version transition must carry
- * forward every provider that can still have live links through that pointer.
- */
-export declare const FRAMEWORK_PROVIDERS: readonly Provider[];
-export interface ResolveRequiredFrameworkProvidersInput {
+interface ResolveRequiredFrameworkProvidersInput {
     frameworkDir: string;
     /** Providers requested by the lifecycle operation that is about to swap. */
     requested?: readonly Provider[];
     /** Registry home. Defaults to SPECRAILS_REGISTRY_HOME / the normal home. */
     registryHome?: string;
 }
-export interface MaterializeFrameworkVersionInput extends ResolveRequiredFrameworkProvidersInput {
+interface MaterializeFrameworkVersionInput extends ResolveRequiredFrameworkProvidersInput {
     scriptDir: string;
     version: string;
 }
-/**
- * Discover providers represented by a framework version.
- *
- * A provider is included when either its subtree or its stamp exists. For the
- * current version this is deliberately conservative: an interrupted/legacy
- * materialization without a stamp may still have live workspace symlinks, so
- * the next version must carry that provider forward rather than dropping it.
- */
-export declare function discoverFrameworkProviders(frameworkDir: string, version: string): Provider[];
 /**
  * Compute the provider set that MUST exist in a destination version before the
  * process may move the global `current` pointer:
@@ -51,3 +36,4 @@ export declare function assertFrameworkVersionComplete(frameworkDir: string, ver
  * fails, existing workspaces continue resolving through the previous version.
  */
 export declare function materializeFrameworkVersion(input: MaterializeFrameworkVersionInput): Provider[];
+export {};

package/dist/installer/phases/framework-lifecycle.js

@@ -10,7 +10,7 @@ import { ensureCurrentSymlink, frameworkMaterializationProblem, frameworkStampPa
  * shared by every relocated workspace, so a version transition must carry
  * forward every provider that can still have live links through that pointer.
  */
-export const FRAMEWORK_PROVIDERS = [
+const FRAMEWORK_PROVIDERS = [
     'claude',
     'codex',
     'gemini',
@@ -34,7 +34,7 @@ function stableProviders(values) {
  * materialization without a stamp may still have live workspace symlinks, so
  * the next version must carry that provider forward rather than dropping it.
  */
-export function discoverFrameworkProviders(frameworkDir, version) {
+function discoverFrameworkProviders(frameworkDir, version) {
     const versionDir = path.join(frameworkDir, version);
     return FRAMEWORK_PROVIDERS.filter((provider) => {
         const { providerDir } = derivedPaths(provider);
@@ -124,4 +124,3 @@ export function materializeFrameworkVersion(input) {
     ensureCurrentSymlink(input.frameworkDir, input.version);
     return required;
 }
-//# sourceMappingURL=framework-lifecycle.js.map

package/dist/installer/phases/install-config.d.ts

@@ -4,9 +4,9 @@ import { InstallerError } from '../util/errors.js';
  */
 export type Provider = 'claude' | 'codex' | 'gemini' | 'kimi';
 /** Cost / capability preset for the model picker. */
-export type ModelPreset = 'balanced' | 'budget' | 'max';
+type ModelPreset = 'balanced' | 'budget' | 'max';
 /** Provider-native model selection retained verbatim in install-config.yaml. */
-export interface InstallModelConfig {
+interface InstallModelConfig {
     preset: ModelPreset;
     defaults: {
         model: string;
@@ -14,11 +14,10 @@ export interface InstallModelConfig {
     overrides: Record<string, string>;
 }
 /**
- * Shape of the `.specrails/install-config.yaml` file — the single
- * source of truth the TUI writes and the installer reads. Fields map
- * 1:1 onto the grep-based parser in the retired install.sh.
+ * Shape of the `.specrails/install-config.yaml` file that
+ * specrails-desktop writes and `init --from-config` reads.
  */
-export interface InstallConfig {
+interface InstallConfig {
     version: 1;
     provider: Provider;
     agents: {
@@ -52,8 +51,7 @@ export declare function resolveConfigPath(repoRoot: string, explicit?: string):
 export declare function loadInstallConfig(configPath: string): InstallConfig | null;
 /**
  * Validates an already-parsed YAML document. Collects every error
- * before throwing so the user sees them all at once (matches the
- * bash installer's `_config_errors` accumulator behaviour).
+ * before throwing so the user sees them all at once.
  */
 export declare function validateInstallConfig(raw: unknown): InstallConfig;
 /**
@@ -62,3 +60,4 @@ export declare function validateInstallConfig(raw: unknown): InstallConfig;
  * paths (not wired yet) and by tests.
  */
 export declare function writeInstallConfig(configPath: string, config: InstallConfig): void;
+export {};

package/dist/installer/phases/install-config.js

@@ -36,10 +36,7 @@ export function resolveProviderModelConfig(provider, preset = 'balanced') {
             return {
                 preset,
                 defaults: { model: 'sonnet' },
-                overrides: {
-                    'sr-architect': 'opus',
-                    'sr-product-manager': 'opus',
-                },
+                overrides: { 'sr-architect': 'opus' },
             };
         }
     }
@@ -86,8 +83,7 @@ export function loadInstallConfig(configPath) {
 }
 /**
  * Validates an already-parsed YAML document. Collects every error
- * before throwing so the user sees them all at once (matches the
- * bash installer's `_config_errors` accumulator behaviour).
+ * before throwing so the user sees them all at once.
  */
 export function validateInstallConfig(raw) {
     const errors = [];
@@ -262,4 +258,3 @@ export function writeInstallConfig(configPath, config) {
         throw new FilesystemError(`failed to write install-config.yaml: ${err.message}`, configPath);
     }
 }
-//# sourceMappingURL=install-config.js.map

package/dist/installer/phases/manifest.d.ts

@@ -1,9 +1,8 @@
 /**
  * Shape of the `.specrails/specrails-manifest.json` file the installer
- * writes at install time. Consumers (specrails-desktop's compat check,
- * the `doctor` command, update.sh) parse it to detect template drift.
+ * writes at install time. specrails-desktop reads it to detect template drift.
  */
-export interface SpecrailsManifest {
+interface SpecrailsManifest {
     version: string;
     installed_at: string;
     /** Provider inventory is emitted only by provider-aware lifecycle callers. */
@@ -15,12 +14,12 @@ export interface SpecrailsManifest {
  * Computes a stable sha256 digest for a file, returned as `sha256:<hex>`.
  */
 export declare function sha256Of(filePath: string): string;
-export interface BuildManifestInput {
+interface BuildManifestInput {
     /** Absolute path to the specrails-core source package directory. */
     scriptDir: string;
     /** Absolute path to the user's repo root where the manifest is written. */
     repoRoot: string;
-    /** Version string from the specrails-core VERSION file. */
+    /** specrails-core package version. */
     version: string;
     /** Override "installed_at" — exposed for deterministic testing. */
     installedAt?: string;
@@ -29,8 +28,7 @@ export interface BuildManifestInput {
     primaryProvider?: string;
 }
 /**
- * Walks `templates/**` plus the bundled doctor command file and
- * produces a stable-sorted manifest.
+ * Walks `templates/**` and produces a stable-sorted manifest.
  *
  * Stable-sort rule: artifact keys are sorted ascending by POSIX path.
  */
@@ -43,3 +41,4 @@ export declare function writeManifestFiles(repoRoot: string, manifest: Specrails
     manifestPath: string;
     versionPath: string;
 };
+export {};

package/dist/installer/phases/manifest.js

@@ -12,8 +12,7 @@ export function sha256Of(filePath) {
     return `sha256:${hash}`;
 }
 /**
- * Walks `templates/**` plus the bundled doctor command file and
- * produces a stable-sorted manifest.
+ * Walks `templates/**` and produces a stable-sorted manifest.
  *
  * Stable-sort rule: artifact keys are sorted ascending by POSIX path.
  */
@@ -25,8 +24,6 @@ export function buildManifest(input) {
         const rel = path.relative(input.scriptDir, absFile).split(path.sep).join('/');
         artifacts[rel] = sha256Of(absFile);
     });
-    const doctorPath = path.join(input.scriptDir, 'commands', 'doctor.md');
-    artifacts['commands/specrails/doctor.md'] = sha256Of(doctorPath);
     const manifest = {
         version: input.version,
         installed_at,
@@ -71,8 +68,7 @@ export function writeManifestFiles(repoRoot, manifest) {
 }
 /**
  * Enumerates files under `templates/` excluding `node_modules/` and
- * package-lock files, matching the bash helper's find clause:
- *   find ... -not -path "(star)/node_modules/(star)" -not -name 'package-lock.json'
+ * package-lock files.
  */
 function walkManifestSources(root) {
     const collected = [];
@@ -111,4 +107,3 @@ function sortKeys(obj) {
     }
     return out;
 }
-//# sourceMappingURL=manifest.js.map

package/dist/installer/phases/prereqs.d.ts

@@ -8,13 +8,12 @@ import { type Provider, type ProviderAvailability } from './provider-detect.js';
 export declare const MIN_NODE_VERSION = "20.19.0";
 export declare function isSupportedNodeVersion(version: string): boolean;
 /**
- * Phase 1 prerequisite bundle. Mirrors install.sh's Phase 1 flow but
- * with explicit options rather than a grab-bag of globals.
+ * Phase 1 prerequisite bundle.
  *
  * Returns the resolved inputs later phases need — primarily the
  * selected provider and the detected CLI availability.
  */
-export interface PrereqOptions {
+interface PrereqOptions {
     /** Absolute path to the target repository root. */
     repoRoot: string;
     /** --yes / -y equivalent — auto-init git, skip interactive prompts. */
@@ -24,7 +23,7 @@ export interface PrereqOptions {
     /** SPECRAILS_SKIP_PREREQS=1 equivalent — relax hard failures for CI. */
     skipPrereqs: boolean;
 }
-export interface PrereqResult {
+interface PrereqResult {
     availability: ProviderAvailability;
     provider: Provider;
     /**
@@ -36,7 +35,7 @@ export interface PrereqResult {
      */
     ossSignals: OssSignals;
 }
-export interface OssSignals {
+interface OssSignals {
     hasGh: boolean;
     publicRepo: boolean;
     hasCi: boolean;
@@ -45,7 +44,7 @@ export interface OssSignals {
 }
 /**
  * Orchestrates every prerequisite check that must pass before the
- * installer proceeds to Phase 3 (scaffolding). Emits ok/warn/info
- * lines matching the retired bash output.
+ * installer proceeds to Phase 3 (scaffolding).
  */
 export declare function checkPrerequisites(options: PrereqOptions): Promise<PrereqResult>;
+export {};

package/dist/installer/phases/prereqs.js

@@ -28,8 +28,7 @@ export function isSupportedNodeVersion(version) {
 }
 /**
  * Orchestrates every prerequisite check that must pass before the
- * installer proceeds to Phase 3 (scaffolding). Emits ok/warn/info
- * lines matching the retired bash output.
+ * installer proceeds to Phase 3 (scaffolding).
  */
 export async function checkPrerequisites(options) {
     const nodeVersion = process.versions.node;
@@ -42,8 +41,8 @@ export async function checkPrerequisites(options) {
     if (!(await gitInstalled())) {
         throw new PrerequisiteError('git is required but not on PATH. Install git: https://git-scm.com/');
     }
-    // 1.1 Git repository — auto-init when --yes, otherwise assume caller
-    //     resolved the prompt upstream (bin/specrails-core.cjs / desktop app TUI).
+    // 1.1 Git repository — auto-init when --yes; otherwise the caller must
+    //     provide a repository.
     if (!(await isGitRepo(options.repoRoot))) {
         if (!options.autoYes) {
             throw new PrerequisiteError(`${options.repoRoot} is not a git repository. ` +
@@ -100,7 +99,7 @@ export async function checkPrerequisites(options) {
                 'the first workflow will report 401/login errors. Run `kimi login` if needed.');
         }
     }
-    // 1.4 npm — required for running the TUI and for the `update` command.
+    // 1.4 npm — required to run the pinned OpenSpec CLI through npx.
     if (!(await commandExists('npm'))) {
         if (options.skipPrereqs) {
             warn('npm not found (skipped — SPECRAILS_SKIP_PREREQS=1)');
@@ -167,4 +166,3 @@ function hasCiWorkflows(repoRoot) {
         return false;
     return listDir(dir).some((p) => p.endsWith('.yml') || p.endsWith('.yaml'));
 }
-//# sourceMappingURL=prereqs.js.map

package/dist/installer/phases/provider-detect.d.ts

@@ -1,6 +1,5 @@
 /**
- * Provider detection + authentication checks. These mirror the Phase
- * 1.2 / 1.3 branches of the retired install.sh.
+ * Provider detection + authentication checks (init Phase 1.2 / 1.3).
  */
 export type Provider = 'claude' | 'codex' | 'gemini' | 'kimi';
 /** Oldest TypeScript Kimi Code CLI release covered by this integration. */
@@ -13,7 +12,7 @@ export interface ProviderAvailability {
     /** Optional so callers/tests predating Kimi still typecheck; absent = false. */
     kimi?: boolean;
 }
-export interface ProviderDerivedPaths {
+interface ProviderDerivedPaths {
     /** Root directory inside the user's repo: `.claude` / `.codex` / `.gemini` / `.kimi-code`. */
     providerDir: string;
     /** Instructions file relative to the artifact root. */
@@ -57,14 +56,13 @@ export declare function resolveProvider(availability: ProviderAvailability, opti
  */
 export declare function derivedPaths(provider: Provider): ProviderDerivedPaths;
 /**
- * Asserts that Claude Code is authenticated. Matches the three-path
- * check from install.sh: `claude config list` → ANTHROPIC_API_KEY env →
- * ~/.claude.json OAuth.
+ * Asserts that Claude Code is authenticated: `claude config list` →
+ * ANTHROPIC_API_KEY env → ~/.claude.json OAuth.
  */
 export declare function assertClaudeAuthenticated(options?: {
     skipPrereqs?: boolean;
 }): Promise<void>;
-export type KimiAuthenticationStatus = 'authenticated' | 'unauthenticated' | 'unknown';
+type KimiAuthenticationStatus = 'authenticated' | 'unauthenticated' | 'unknown';
 /**
  * Bounded, non-billing Kimi authentication probe.
  *
@@ -87,3 +85,4 @@ export declare function assertKimiAuthenticated(options?: {
     kimiCodeHome?: string;
     env?: NodeJS.ProcessEnv;
 }): Promise<KimiAuthenticationStatus>;
+export {};

package/dist/installer/phases/provider-detect.js

@@ -115,9 +115,8 @@ export function derivedPaths(provider) {
     throw new ProviderError(`Unsupported provider: ${String(provider)}`);
 }
 /**
- * Asserts that Claude Code is authenticated. Matches the three-path
- * check from install.sh: `claude config list` → ANTHROPIC_API_KEY env →
- * ~/.claude.json OAuth.
+ * Asserts that Claude Code is authenticated: `claude config list` →
+ * ANTHROPIC_API_KEY env → ~/.claude.json OAuth.
  */
 export async function assertClaudeAuthenticated(options = {}) {
     if (await hasClaudeApiKeyConfigured())
@@ -227,4 +226,3 @@ function compareVersionTriples(left, right) {
     }
     return 0;
 }
-//# sourceMappingURL=provider-detect.js.map

package/dist/installer/phases/scaffold.d.ts

@@ -30,7 +30,7 @@ export declare function translateOpsxSkillCallsForGemini(body: string): string;
 export declare function translateClaudeTextForKimi(body: string): string;
 export declare function geminiAgentLimitMetadata(env?: NodeJS.ProcessEnv): string[];
 /**
- * Phase 2 + Phase 3 of the retired install.sh:
+ * Phase 2 + Phase 3 of init:
  *   - Detect prior installation state (.claude/.codex/openspec already present).
  *   - Create the directory skeleton.
  *   - Copy templates into `.specrails/setup-templates/` (the internal
@@ -41,7 +41,7 @@ export declare function geminiAgentLimitMetadata(env?: NodeJS.ProcessEnv): strin
  * the user's live `.claude/agents/` and `.claude/commands/specrails/` dirs so
  * the installer finishes in one pass — no follow-up wizard required.
  */
-export interface ScaffoldInput {
+interface ScaffoldInput {
     /** Absolute path to the specrails-core package (installed via npx). */
     scriptDir: string;
     /**
@@ -80,16 +80,14 @@ export interface ScaffoldInput {
      */
     materializeAllAgents?: boolean;
 }
-export interface ScaffoldResult {
+interface ScaffoldResult {
     existingSetup: boolean;
     createdDirs: string[];
     copiedFiles: number;
 }
 /**
  * Returns true iff any of the provider directories already contains
- * content. The desktop-app-driven path skips the "merge existing?" prompt and
- * assumes `--yes`; the CLI dispatcher (bin/specrails-core.cjs) should
- * have prompted before entering this phase.
+ * content.
  */
 export declare function detectExistingSetup(input: Pick<ScaffoldInput, 'artifactRoot' | 'codeRoot' | 'providerDir'>): boolean;
 /**
@@ -97,7 +95,7 @@ export declare function detectExistingSetup(input: Pick<ScaffoldInput, 'artifact
  * .gitignore. Returns a summary for logging / tests.
  */
 export declare function scaffoldInstallation(input: ScaffoldInput): ScaffoldResult;
-export interface InstallFrameworkInput {
+interface InstallFrameworkInput {
     /** Absolute path to the specrails-core package (templates/ + commands/). */
     scriptDir: string;
     /** Root of the versioned framework store, e.g. `<home>/.specrails/framework`. */
@@ -111,7 +109,7 @@ export interface InstallFrameworkInput {
     /** Optional explicit agent allow-list (kept for parity with scaffold). */
     selectedAgents?: string[];
 }
-export interface InstallFrameworkResult {
+interface InstallFrameworkResult {
     /** `<frameworkDir>/<version>/<providerDir>` — root of the static subtree. */
     providerFrameworkDir: string;
     /** `<frameworkDir>/<version>` — the version root (also holds setup-templates/). */
@@ -141,7 +139,7 @@ export declare function installFramework(input: InstallFrameworkInput): InstallF
  * provider links resolve through `current/...` and an update is a single swap.
  */
 export declare function ensureCurrentSymlink(frameworkDir: string, version: string): void;
-export interface AssembleProjectWorkspaceInput {
+interface AssembleProjectWorkspaceInput {
     /** The per-project workspace artifact root (= resolveArtifacts artifactRoot). */
     workspace: string;
     /** Root of the versioned framework store (the parent of `current/`). */
@@ -176,7 +174,7 @@ export interface AssembleProjectWorkspaceInput {
      */
     copyStatics?: boolean;
 }
-export interface AssembleProjectWorkspaceResult {
+interface AssembleProjectWorkspaceResult {
     /** Per-linked-subtree mechanism, for diagnostics (copy-fallback loses O(1) swap). */
     links: Record<string, 'symlink' | 'junction' | 'copy'>;
     /** Agent ids whose memory dirs were seeded as real writable dirs. */
@@ -209,3 +207,4 @@ export declare function assembleProjectWorkspace(input: AssembleProjectWorkspace
  * acknowledged interactively).
  */
 export declare function writeGeminiAgentAcknowledgments(repoRoot: string, agentIds: string[], agentsBaseDir?: string): void;
+export {};