specrails-core 4.1.0 → 4.2.0

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

@@ -0,0 +1,120 @@
+import path from 'node:path';
+import yaml from 'js-yaml';
+import { FilesystemError, InstallerError } from '../util/errors.js';
+import { pathExists, readTextFile, writeFileLf } from '../util/fs.js';
+export class InvalidConfigError extends InstallerError {
+    errors;
+    constructor(errors) {
+        super(`install-config.yaml is invalid:\n${errors.map((e) => `  - ${e}`).join('\n')}`, 40);
+        this.name = 'InvalidConfigError';
+        this.errors = errors;
+    }
+}
+export const CONFIG_RELATIVE_PATH = '.specrails/install-config.yaml';
+/**
+ * Resolves the install-config path: explicit argument > repo-root default.
+ */
+export function resolveConfigPath(repoRoot, explicit) {
+    if (explicit && explicit.length > 0) {
+        return path.isAbsolute(explicit) ? explicit : path.resolve(repoRoot, explicit);
+    }
+    return path.join(repoRoot, CONFIG_RELATIVE_PATH);
+}
+/**
+ * Reads and parses the install-config. Returns `null` if the file is
+ * not present — caller decides whether that's an error or a fallback.
+ */
+export function loadInstallConfig(configPath) {
+    if (!pathExists(configPath))
+        return null;
+    const raw = readTextFile(configPath);
+    let parsed;
+    try {
+        parsed = yaml.load(raw);
+    }
+    catch (err) {
+        throw new InvalidConfigError([`YAML parse error: ${err.message}`]);
+    }
+    return validateInstallConfig(parsed);
+}
+/**
+ * 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).
+ */
+export function validateInstallConfig(raw) {
+    const errors = [];
+    if (raw === null || raw === undefined || typeof raw !== 'object') {
+        throw new InvalidConfigError(['config must be a YAML mapping']);
+    }
+    const doc = raw;
+    if (doc.version === undefined) {
+        errors.push(`missing required 'version' field`);
+    }
+    else if (doc.version !== 1) {
+        errors.push(`unsupported version '${String(doc.version)}' (expected: 1)`);
+    }
+    if (doc.provider === undefined) {
+        errors.push(`missing required 'provider' field`);
+    }
+    else if (doc.provider === 'codex') {
+        errors.push(`Codex (OpenAI) support is coming soon — currently being tested in our lab. Set provider: claude.`);
+    }
+    else if (doc.provider !== 'claude') {
+        errors.push(`unsupported provider '${String(doc.provider)}' (expected: claude)`);
+    }
+    if (doc.tier !== undefined && doc.tier !== 'full' && doc.tier !== 'quick') {
+        errors.push(`unsupported tier '${String(doc.tier)}' (expected: full or quick)`);
+    }
+    const agents = doc.agents;
+    if (!agents || typeof agents !== 'object') {
+        errors.push(`missing required 'agents' section with 'selected' list`);
+    }
+    else {
+        if (!Array.isArray(agents.selected)) {
+            errors.push(`'agents.selected' must be a list`);
+        }
+        if (agents.preset !== undefined &&
+            agents.preset !== 'balanced' &&
+            agents.preset !== 'budget' &&
+            agents.preset !== 'max') {
+            errors.push(`unsupported preset '${String(agents.preset)}' (expected: balanced, budget, or max)`);
+        }
+    }
+    if (errors.length > 0) {
+        throw new InvalidConfigError(errors);
+    }
+    const selected = agents?.selected ?? [];
+    const result = {
+        version: 1,
+        provider: doc.provider,
+        agents: {
+            selected,
+        },
+    };
+    if (typeof doc.agent_teams === 'boolean') {
+        result.agent_teams = doc.agent_teams;
+    }
+    if (doc.tier !== undefined) {
+        result.tier = doc.tier;
+    }
+    if (agents?.preset !== undefined) {
+        result.agents.preset = agents.preset;
+    }
+    return result;
+}
+/**
+ * Serialises an {@link InstallConfig} back to YAML and writes it with
+ * LF line endings. Used by `npx specrails-core update --reset-config`
+ * paths (not wired yet) and by tests.
+ */
+export function writeInstallConfig(configPath, config) {
+    try {
+        const text = yaml.dump(config, { lineWidth: 120, noRefs: true });
+        writeFileLf(configPath, text);
+    }
+    catch (err) {
+        throw new FilesystemError(`failed to write install-config.yaml: ${err.message}`, configPath);
+    }
+}
+//# sourceMappingURL=install-config.js.map

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

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

package/dist/installer/phases/manifest.js

@@ -0,0 +1,93 @@
+import { createHash } from 'node:crypto';
+import { readdirSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { FilesystemError } from '../util/errors.js';
+import { readBytes, writeFileLf } from '../util/fs.js';
+/**
+ * Computes a stable sha256 digest for a file, returned as `sha256:<hex>`.
+ */
+export function sha256Of(filePath) {
+    const bytes = readBytes(filePath);
+    const hash = createHash('sha256').update(bytes).digest('hex');
+    return `sha256:${hash}`;
+}
+/**
+ * Walks `templates/**` plus the two bundled command files and
+ * produces a stable-sorted manifest. Replicates the output format of
+ * the retired `generate_manifest` bash helper so the byte-diff CI
+ * fixture passes without modification.
+ *
+ * Stable-sort rule: artifact keys are sorted ascending by POSIX path.
+ */
+export function buildManifest(input) {
+    const installed_at = input.installedAt ?? new Date().toISOString().replace(/\.\d{3}Z$/, 'Z');
+    const artifacts = {};
+    const templatesDir = path.join(input.scriptDir, 'templates');
+    walkManifestSources(templatesDir).forEach((absFile) => {
+        const rel = path.relative(input.scriptDir, absFile).split(path.sep).join('/');
+        artifacts[rel] = sha256Of(absFile);
+    });
+    const enrichPath = path.join(input.scriptDir, 'commands', 'enrich.md');
+    const doctorPath = path.join(input.scriptDir, 'commands', 'doctor.md');
+    artifacts['commands/specrails/enrich.md'] = sha256Of(enrichPath);
+    artifacts['commands/specrails/doctor.md'] = sha256Of(doctorPath);
+    return {
+        version: input.version,
+        installed_at,
+        artifacts: sortKeys(artifacts),
+    };
+}
+/**
+ * Writes the manifest JSON and the companion version file under
+ * `.specrails/` in the user repo. Both files use LF terminators.
+ */
+export function writeManifestFiles(repoRoot, manifest) {
+    const manifestPath = path.join(repoRoot, '.specrails', 'specrails-manifest.json');
+    const versionPath = path.join(repoRoot, '.specrails', 'specrails-version');
+    writeFileLf(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
+    writeFileLf(versionPath, `${manifest.version}\n`);
+    return { manifestPath, versionPath };
+}
+/**
+ * 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'
+ */
+function walkManifestSources(root) {
+    const collected = [];
+    try {
+        walk(root, collected);
+    }
+    catch (err) {
+        throw new FilesystemError(`failed to walk templates directory: ${err.message}`, root);
+    }
+    // Stable sort on POSIX-normalised relative path ensures deterministic
+    // output across operating systems (readdir order is FS-dependent).
+    collected.sort();
+    return collected;
+}
+function walk(dir, acc) {
+    const entries = readdirSync(dir);
+    for (const name of entries) {
+        const abs = path.join(dir, name);
+        const st = statSync(abs);
+        if (st.isDirectory()) {
+            if (name === 'node_modules')
+                continue;
+            walk(abs, acc);
+        }
+        else if (st.isFile()) {
+            if (name === 'package-lock.json')
+                continue;
+            acc.push(abs);
+        }
+    }
+}
+function sortKeys(obj) {
+    const out = {};
+    for (const k of Object.keys(obj).sort()) {
+        out[k] = obj[k];
+    }
+    return out;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/installer/phases/manifest.js.map

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

package/dist/installer/phases/prereqs.js

@@ -0,0 +1,116 @@
+import path from 'node:path';
+import { PrerequisiteError } from '../util/errors.js';
+import { commandExists, runCommand } from '../util/exec.js';
+import { isDir, isFile, listDir } from '../util/fs.js';
+import { info, ok, warn } from '../util/logger.js';
+import { gitInstalled, initRepo, isGitRepo, repoRoot } from '../util/git.js';
+import { assertClaudeAuthenticated, claudeVersion, detectAvailability, resolveProvider, } from './provider-detect.js';
+/**
+ * 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.
+ */
+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 / hub TUI).
+    if (!(await isGitRepo(options.repoRoot))) {
+        if (!options.autoYes) {
+            throw new PrerequisiteError(`${options.repoRoot} is not a git repository. ` +
+                `Run \`git init\` first, or pass --yes to let the installer initialise it.`);
+        }
+        await initRepo(options.repoRoot);
+    }
+    const root = await repoRoot(options.repoRoot);
+    ok(`Git repository root: ${root}`);
+    // 1.2 Provider detection.
+    const availability = await detectAvailability();
+    const provider = await resolveProvider(availability, {
+        explicit: options.explicitProvider,
+        skipPrereqs: options.skipPrereqs,
+    });
+    if (provider === 'claude') {
+        if (availability.claude) {
+            const v = await claudeVersion();
+            ok(`Claude Code CLI: ${v}`);
+        }
+        else if (options.explicitProvider === 'claude') {
+            ok(`Provider: claude (--provider flag)`);
+        }
+    }
+    // 1.3 Authentication for the selected provider.
+    if (provider === 'claude') {
+        await assertClaudeAuthenticated({ skipPrereqs: options.skipPrereqs });
+        ok('Claude: authenticated');
+    }
+    // 1.4 npm — required for running the TUI and for the `update` command.
+    if (!(await commandExists('npm'))) {
+        if (options.skipPrereqs) {
+            warn('npm not found (skipped — SPECRAILS_SKIP_PREREQS=1)');
+        }
+        else {
+            throw new PrerequisiteError('npm is required but not on PATH. Install Node.js 20+ from https://nodejs.org/');
+        }
+    }
+    else {
+        ok('npm: found');
+    }
+    // 1.5 OpenSpec CLI — optional. The installer falls back to
+    //     `npx openspec` automatically, so a missing global install is
+    //     not a problem. Warn only when present is preferable (faster).
+    if (await commandExists('openspec')) {
+        ok('OpenSpec CLI: found (global)');
+    }
+    else {
+        info('OpenSpec CLI not on PATH — will fetch via npx during install');
+    }
+    // 1.6 GitHub CLI — optional; enables OSS detection + issue-backed flows.
+    const hasGh = await commandExists('gh');
+    if (hasGh) {
+        ok('GitHub CLI: found');
+    }
+    else {
+        info('GitHub CLI not found — optional, enables OSS detection');
+    }
+    // 1.7 OSS detection — runs only when gh is present + authenticated.
+    //     Degrades gracefully (every signal independently false) when
+    //     prereqs are missing.
+    const ossSignals = await detectOssSignals(options.repoRoot, hasGh);
+    if (ossSignals.isOss) {
+        ok('OSS project detected (public repo + CI + CONTRIBUTING.md)');
+    }
+    // 1.8 JIRA CLI — silently skipped when missing (only relevant in enrich).
+    return { availability, provider, ossSignals };
+}
+async function detectOssSignals(repoRoot, hasGh) {
+    let publicRepo = false;
+    if (hasGh) {
+        try {
+            const { stdout } = await runCommand('gh', ['repo', 'view', '--json', 'isPrivate', '--jq', '.isPrivate'], { cwd: repoRoot, inherit: false });
+            // gh emits 'true' / 'false' newline-terminated.
+            publicRepo = stdout.trim().toLowerCase() === 'false';
+        }
+        catch {
+            /* not a gh-tracked repo or gh not authenticated — leave false */
+        }
+    }
+    const hasCi = hasCiWorkflows(repoRoot);
+    const hasContributing = isFile(path.join(repoRoot, 'CONTRIBUTING.md')) ||
+        isFile(path.join(repoRoot, '.github', 'CONTRIBUTING.md'));
+    return {
+        hasGh,
+        publicRepo,
+        hasCi,
+        hasContributing,
+        isOss: hasGh && publicRepo && hasCi && hasContributing,
+    };
+}
+function hasCiWorkflows(repoRoot) {
+    const dir = path.join(repoRoot, '.github', 'workflows');
+    if (!isDir(dir))
+        return false;
+    return listDir(dir).some((p) => p.endsWith('.yml') || p.endsWith('.yaml'));
+}
+//# sourceMappingURL=prereqs.js.map

package/dist/installer/phases/prereqs.js.map

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

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

@@ -0,0 +1,111 @@
+import { homedir } from 'node:os';
+import path from 'node:path';
+import { ProviderError } from '../util/errors.js';
+import { commandExists, runCommand } from '../util/exec.js';
+import { pathExists, readTextFile } from '../util/fs.js';
+/**
+ * Detects which AI CLIs are on PATH. Runs `where` on Windows and
+ * `which` on POSIX via the cross-platform commandExists helper.
+ */
+export async function detectAvailability() {
+    const [claude, codex] = await Promise.all([commandExists('claude'), commandExists('codex')]);
+    return { claude, codex };
+}
+/**
+ * Returns the Claude CLI version string (stdout of `claude --version`)
+ * or 'unknown' if the CLI cannot be invoked.
+ */
+export async function claudeVersion() {
+    try {
+        const { stdout } = await runCommand('claude', ['--version'], { inherit: false });
+        return stdout.trim() || 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/**
+ * Resolves which provider the installer should use. Priority:
+ *   1. Explicit `--provider claude` flag (already passed through args).
+ *   2. Config file (read upstream in install-config.ts).
+ *   3. Whichever CLI is installed.
+ *
+ * Codex-only installs error out — see design: Codex is "coming soon".
+ * The caller may bypass prereq failures with `skipPrereqs: true`
+ * (env `SPECRAILS_SKIP_PREREQS=1`).
+ */
+export async function resolveProvider(availability, options = {}) {
+    if (options.explicit === 'codex') {
+        throw new ProviderError('Codex (OpenAI) support is coming soon — currently being tested in our lab. ' +
+            'Use --provider claude for now.');
+    }
+    if (options.explicit === 'claude')
+        return 'claude';
+    if (availability.claude && availability.codex)
+        return 'claude';
+    if (availability.claude)
+        return 'claude';
+    if (availability.codex) {
+        throw new ProviderError('Only Codex detected — Codex (OpenAI) support is coming soon (currently in our lab). ' +
+            'Please install Claude Code to continue: https://claude.ai/download');
+    }
+    if (options.skipPrereqs)
+        return 'claude';
+    throw new ProviderError('No AI CLI found (claude). ' +
+        'Install Claude Code: https://claude.ai/download. ' +
+        'Codex (OpenAI) support: coming soon.');
+}
+/**
+ * Directory / filename conventions the provider dictates.
+ *   - Claude Code:  .claude/ + CLAUDE.md
+ *   - Codex:        .codex/  + AGENTS.md
+ */
+export function derivedPaths(provider) {
+    if (provider === 'codex') {
+        return { providerDir: '.codex', instructionsFile: 'AGENTS.md' };
+    }
+    return { providerDir: '.claude', instructionsFile: 'CLAUDE.md' };
+}
+/**
+ * Asserts that Claude Code is authenticated. Matches the three-path
+ * check from install.sh: `claude config list` → ANTHROPIC_API_KEY env →
+ * ~/.claude.json OAuth.
+ */
+export async function assertClaudeAuthenticated(options = {}) {
+    if (await hasClaudeApiKeyConfigured())
+        return;
+    if (process.env.ANTHROPIC_API_KEY && process.env.ANTHROPIC_API_KEY.length > 0)
+        return;
+    if (await hasClaudeOauthJson())
+        return;
+    if (options.skipPrereqs)
+        return;
+    throw new ProviderError([
+        'No Claude authentication found.',
+        '',
+        '  Option 1 (API key): claude config set api_key <your-key>',
+        '  Option 2 (OAuth):   claude auth login',
+    ].join('\n'));
+}
+async function hasClaudeApiKeyConfigured() {
+    try {
+        const { stdout } = await runCommand('claude', ['config', 'list'], { inherit: false });
+        return stdout.includes('api_key');
+    }
+    catch {
+        return false;
+    }
+}
+async function hasClaudeOauthJson() {
+    const p = path.join(homedir(), '.claude.json');
+    if (!pathExists(p))
+        return false;
+    try {
+        const raw = readTextFile(p);
+        return raw.includes('"oauthAccount"');
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=provider-detect.js.map

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

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