specrails-core 5.5.1 → 6.0.0

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 {};