specrails-core 5.6.0 → 6.0.1

package/dist/installer/cli.js

@@ -1,100 +1,35 @@
 /**
- * specrails-core CLI entry point (Node / TypeScript).
- *
- * Replaces the legacy bash-dispatch path in `bin/specrails-core.js`.
- * During the port, `bin/specrails-core.js` keeps shelling out to the
- * shell scripts while this module carries the in-progress Node
- * implementation. Once Phases 2–4 ship the command handlers and
- * Phase 5 deletes the shell scripts, the `bin/` dispatcher collapses
- * to a single `import { main } from './dist/installer/cli.js'` call.
+ * specrails-core CLI: the installer and runtime entry points Desktop drives.
+ * `bin/specrails-core.mjs` and a direct `node dist/installer/cli.js` run both
+ * land in {@link main}.
  */
 import { readFileSync, realpathSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
-import { runDoctor } from './commands/doctor.js';
 import { runAssemble, runInstallFramework, runSwapCurrent, } from './commands/framework.js';
 import { runInit } from './commands/init.js';
-import { runUpdate } from './commands/update.js';
-import { runPipelineCommand } from './runtime/pipeline-state.js';
+import { runPipelineCommand } from '../pipeline/pipeline-state.js';
+import { parseArgs } from '../shared/args.js';
 import { isInstallerError } from './util/errors.js';
 import { fatal } from './util/logger.js';
-/**
- * Minimal arg parser, no external dep. Handles:
- *   subcommand                (first bare positional)
- *   --flag                    (boolean true)
- *   --flag=value              (string)
- *   --flag value              (string, consumes next token)
- *   -h / --help               (help alias)
- *   -v / --version            (version alias)
- *   positionals               (everything else)
- */
-export function parseArgs(argv) {
-    const flags = {};
-    const positionals = [];
-    let subcommand = null;
-    for (let i = 0; i < argv.length; i++) {
-        const token = argv[i];
-        if (token.startsWith('--')) {
-            const rest = token.slice(2);
-            const eq = rest.indexOf('=');
-            if (eq >= 0) {
-                flags[rest.slice(0, eq)] = rest.slice(eq + 1);
-            }
-            else {
-                const peek = argv[i + 1];
-                if (peek !== undefined && !peek.startsWith('-')) {
-                    flags[rest] = peek;
-                    i++;
-                }
-                else {
-                    flags[rest] = true;
-                }
-            }
-        }
-        else if (token === '-h') {
-            flags.help = true;
-        }
-        else if (token === '-v') {
-            flags.version = true;
-        }
-        else if (token.startsWith('-') && token.length > 1) {
-            flags[token.slice(1)] = true;
-        }
-        else {
-            if (subcommand === null) {
-                subcommand = token;
-            }
-            else {
-                positionals.push(token);
-            }
-        }
-    }
-    return { subcommand, flags, positionals };
-}
 function usageText() {
     return [
         '',
-        'specrails-core — Provider-independent AI agent workflow system',
+        'specrails-core — agent workflow engine for specrails-desktop',
         '',
         'Usage:',
         '  specrails-core <command> [options]',
         '',
         'Commands:',
-        '  init                Install specrails into a repository',
-        '  update              Update an existing specrails installation',
-        '  pipeline            Inspect and execute durable implementation phases',
-        '  runtime             Run, inspect and resume programmatic agents',
-        '  doctor              Diagnose the health of an existing installation',
+        '  init                Install specrails into a repository (claude, codex, gemini, or kimi)',
         '  install-framework   Materialize the versioned framework (offline)',
         '  swap-current        Point framework/current at a version (offline)',
-        '  assemble            Symlink the framework into a workspace (offline)',
+        '  assemble            Link the framework into a project workspace (offline)',
+        '  pipeline            Inspect and verify durable implementation phases',
+        '  runtime             Run, inspect and resume programmatic agents',
         '  help                Show this help message',
         '  version             Print the installed version',
         '',
-        'Global options:',
-        '  -h, --help     Show this help',
-        '  -v, --version  Print version',
-        '',
     ].join('\n');
 }
 function readVersion() {
@@ -113,30 +48,15 @@ function readVersion() {
         return 'unknown';
     }
 }
-/**
- * Sentinel exit code used during the port: when a Node command is not
- * yet implemented, the CLI exits with this code and the outer bash
- * dispatcher (bin/specrails-core.js) may choose to fall through to
- * the shell path. Removed entirely in Phase 5 when no shell scripts
- * remain.
- */
-export const NOT_IMPLEMENTED = 2;
-async function dispatch(subcommand, flags, _positionals) {
+async function dispatch(subcommand, flags, positionals) {
     switch (subcommand) {
         case 'init':
             await runInit(flags);
             return 0;
-        case 'update':
-            await runUpdate(flags);
-            return 0;
         case 'pipeline':
-            return runPipelineCommand(flags, _positionals);
+            return runPipelineCommand(flags, positionals);
         case 'runtime':
-            return (await import('../agent-runtime/cli.js')).runRuntimeCommand(flags, _positionals);
-        case 'doctor': {
-            const result = await runDoctor(flags);
-            return result.failed === 0 ? 0 : 1;
-        }
+            return (await import('../agent-runtime/cli.js')).runRuntimeCommand(flags, positionals);
         case 'install-framework':
             await runInstallFramework(flags);
             return 0;
@@ -147,7 +67,6 @@ async function dispatch(subcommand, flags, _positionals) {
             await runAssemble(flags);
             return 0;
         case 'help':
-        case '':
             process.stdout.write(usageText());
             return 0;
         case 'version':
@@ -161,16 +80,23 @@ async function dispatch(subcommand, flags, _positionals) {
 }
 export async function main(argv = process.argv.slice(2)) {
     const { subcommand, flags, positionals } = parseArgs(argv);
-    if (flags.help === true) {
+    // `--version` is global only before a command: `swap-current --version <v>`
+    // names a framework version.
+    if (subcommand === null) {
+        if (flags.version === true || flags.V === true) {
+            process.stdout.write(`${readVersion()}\n`);
+            return 0;
+        }
         process.stdout.write(usageText());
         return 0;
     }
-    if (flags.version === true) {
-        process.stdout.write(`${readVersion()}\n`);
+    // `init --help` must print help, never install.
+    if (flags.help === true && subcommand !== 'runtime') {
+        process.stdout.write(usageText());
         return 0;
     }
     try {
-        return await dispatch(subcommand ?? '', flags, positionals);
+        return await dispatch(subcommand, flags, positionals);
     }
     catch (err) {
         if (isInstallerError(err)) {
@@ -187,8 +113,8 @@ export async function main(argv = process.argv.slice(2)) {
  * (`node dist/installer/cli.js <subcommand>`), run `main()` and propagate its
  * exit code. specrails-desktop's bundled-core path (server/framework-manager.ts)
  * spawns `node <core>/dist/installer/cli.js install-framework|assemble …` and
- * relies on this — the legacy bin dispatcher (bin/specrails-core.mjs) imports
- * `main` and is unaffected (it never executes this file as argv[1]).
+ * relies on this — `bin/specrails-core.mjs` imports `main` and is unaffected
+ * (it never executes this file as argv[1]).
  *
  * Comparing `import.meta.url` against `process.argv[1]` keeps the guard inert on
  * import (so unit tests that `import { main }` never trigger a process.exit).
@@ -219,4 +145,3 @@ if (isDirectRun) {
         process.exitCode = code;
     });
 }
-//# sourceMappingURL=cli.js.map

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

@@ -40,7 +40,7 @@ export interface AssembleFlags {
     /** Comma-separated per-project agent allow-list (links a subset of the superset). */
     'selected-agents'?: string | boolean;
 }
-export interface InstallFrameworkOutcome {
+interface InstallFrameworkOutcome {
     frameworkDir: string;
     provider: Provider;
     version: string;
@@ -48,13 +48,13 @@ export interface InstallFrameworkOutcome {
     /** True when `current` was swapped to `<version>` this call. */
     swapped: boolean;
 }
-export interface SwapCurrentOutcome {
+interface SwapCurrentOutcome {
     frameworkDir: string;
     version: string;
     /** Complete provider set validated before the pointer was moved. */
     providers: Provider[];
 }
-export interface AssembleOutcome {
+interface AssembleOutcome {
     workspace: string;
     frameworkDir: string;
     provider: Provider;
@@ -83,3 +83,4 @@ export declare function runSwapCurrent(flags: SwapCurrentFlags): Promise<SwapCur
 export declare function runAssemble(flags: AssembleFlags): Promise<AssembleOutcome>;
 /** Read the package version (the version the desktop should materialize). */
 export declare function readPackageVersion(scriptDir?: string): string;
+export {};

package/dist/installer/commands/framework.js

@@ -186,4 +186,3 @@ export function readPackageVersion(scriptDir) {
         return 'unknown';
     }
 }
-//# sourceMappingURL=framework.js.map

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