specrails-core 4.11.3 → 5.0.0

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

@@ -2,6 +2,53 @@ 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';
+const PROVIDER_DEFAULT_MODELS = {
+    claude: 'sonnet',
+    codex: 'gpt-5.5-mini',
+    gemini: 'gemini-3.5-flash',
+    kimi: 'k3',
+};
+/**
+ * Agent ids become provider-native file/directory names. Keep them to the
+ * portable direct-child skill grammar so config cannot escape an install root
+ * or create names that Kimi's managed runner will later reject.
+ */
+const SAFE_AGENT_ID = /^[a-z0-9][a-z0-9-]{0,63}$/;
+/**
+ * Must remain byte-for-byte equivalent to the canonical Kimi runtime and the
+ * public integration contract. Config validation happens before any framework
+ * write so an unsafe model can never create an install that only fails later at
+ * process launch.
+ */
+const SAFE_KIMI_MODEL_ID = /^[A-Za-z0-9][A-Za-z0-9._/:-]{0,127}$/;
+/**
+ * Resolve a preset into provider-native identifiers. Kimi currently exposes no
+ * Core-defined cost/capability tier mapping, so every named preset resolves to
+ * its explicit `k3` default. User-supplied exact identifiers are handled later
+ * and are never interpreted as Claude aliases.
+ */
+export function resolveProviderModelConfig(provider, preset = 'balanced') {
+    if (provider === 'claude') {
+        if (preset === 'budget') {
+            return { preset, defaults: { model: 'haiku' }, overrides: {} };
+        }
+        if (preset === 'max') {
+            return {
+                preset,
+                defaults: { model: 'sonnet' },
+                overrides: {
+                    'sr-architect': 'opus',
+                    'sr-product-manager': 'opus',
+                },
+            };
+        }
+    }
+    return {
+        preset,
+        defaults: { model: PROVIDER_DEFAULT_MODELS[provider] },
+        overrides: {},
+    };
+}
 export class InvalidConfigError extends InstallerError {
     errors;
     constructor(errors) {
@@ -57,13 +104,18 @@ export function validateInstallConfig(raw) {
     if (doc.provider === undefined) {
         errors.push(`missing required 'provider' field`);
     }
-    else if (doc.provider !== 'claude' && doc.provider !== 'codex' && doc.provider !== 'gemini') {
-        errors.push(`unsupported provider '${String(doc.provider)}' (expected: claude, codex, or gemini)`);
-    }
-    if (doc.tier !== undefined && doc.tier !== 'full' && doc.tier !== 'quick') {
-        errors.push(`unsupported tier '${String(doc.tier)}' (expected: full or quick)`);
+    else if (doc.provider !== 'claude' &&
+        doc.provider !== 'codex' &&
+        doc.provider !== 'gemini' &&
+        doc.provider !== 'kimi') {
+        errors.push(`unsupported provider '${String(doc.provider)}' (expected: claude, codex, gemini, or kimi)`);
     }
+    // NOTE: a legacy `tier` field (`full`/`quick`) may still be present in pre-v5
+    // configs. It is intentionally ignored (not rejected and not carried forward)
+    // — v5 has no install tiers.
     const agents = doc.agents;
+    let selectedAgents = [];
+    let excludedAgents;
     if (!agents || typeof agents !== 'object') {
         errors.push(`missing required 'agents' section with 'selected' list`);
     }
@@ -71,6 +123,23 @@ export function validateInstallConfig(raw) {
         if (!Array.isArray(agents.selected)) {
             errors.push(`'agents.selected' must be a list`);
         }
+        else {
+            selectedAgents = validateAgentIdList(agents.selected, 'agents.selected', errors);
+        }
+        if (agents.excluded !== undefined && !Array.isArray(agents.excluded)) {
+            errors.push(`'agents.excluded' must be a list`);
+        }
+        else if (Array.isArray(agents.excluded)) {
+            excludedAgents = validateAgentIdList(agents.excluded, 'agents.excluded', errors);
+        }
+        if (Array.isArray(agents.selected) && Array.isArray(agents.excluded)) {
+            const excluded = new Set(excludedAgents ?? []);
+            for (const agent of selectedAgents) {
+                if (excluded.has(agent)) {
+                    errors.push(`'agents.selected' and 'agents.excluded' must not overlap: ${agent}`);
+                }
+            }
+        }
         if (agents.preset !== undefined &&
             agents.preset !== 'balanced' &&
             agents.preset !== 'budget' &&
@@ -78,27 +147,107 @@ export function validateInstallConfig(raw) {
             errors.push(`unsupported preset '${String(agents.preset)}' (expected: balanced, budget, or max)`);
         }
     }
+    const models = doc.models;
+    if (doc.models !== undefined && (!models || typeof models !== 'object')) {
+        errors.push(`'models' must be a mapping`);
+    }
+    const modelPreset = models?.preset;
+    if (modelPreset !== undefined &&
+        modelPreset !== 'balanced' &&
+        modelPreset !== 'budget' &&
+        modelPreset !== 'max') {
+        errors.push(`unsupported model preset '${String(modelPreset)}' (expected: balanced, budget, or max)`);
+    }
+    const provider = doc.provider;
+    const modelDefaults = models?.defaults;
+    if (models?.defaults !== undefined &&
+        (!modelDefaults || typeof modelDefaults !== 'object')) {
+        errors.push(`'models.defaults' must be a mapping`);
+    }
+    else if (modelDefaults?.model !== undefined &&
+        !isValidModelIdentifier(provider, modelDefaults.model)) {
+        errors.push(modelIdentifierError('models.defaults.model', provider));
+    }
+    const modelOverrides = models?.overrides;
+    if (modelOverrides !== undefined &&
+        (!modelOverrides || typeof modelOverrides !== 'object' || Array.isArray(modelOverrides))) {
+        errors.push(`'models.overrides' must be a mapping`);
+    }
+    else if (modelOverrides && typeof modelOverrides === 'object') {
+        for (const [agent, model] of Object.entries(modelOverrides)) {
+            if (!SAFE_AGENT_ID.test(agent)) {
+                errors.push(`'models.overrides' key '${agent}' must be a lowercase kebab-case agent id (1-64 characters)`);
+            }
+            if (!isValidModelIdentifier(provider, model)) {
+                errors.push(modelIdentifierError(`models.overrides.${agent}`, provider));
+            }
+        }
+    }
     if (errors.length > 0) {
         throw new InvalidConfigError(errors);
     }
-    const selected = agents?.selected ?? [];
+    const preset = (modelPreset ?? agents?.preset ?? 'balanced');
+    const resolvedModels = resolveProviderModelConfig(provider, preset);
+    if (typeof modelDefaults?.model === 'string') {
+        resolvedModels.defaults.model = modelDefaults.model;
+    }
+    if (modelOverrides && typeof modelOverrides === 'object') {
+        resolvedModels.overrides = { ...modelOverrides };
+    }
     const result = {
         version: 1,
-        provider: doc.provider,
+        provider,
         agents: {
-            selected,
+            selected: selectedAgents,
         },
+        models: resolvedModels,
     };
     // NOTE: a legacy `agent_teams` field may still be present in older configs.
     // It is intentionally ignored (not rejected) for backward compatibility.
-    if (doc.tier !== undefined) {
-        result.tier = doc.tier;
-    }
     if (agents?.preset !== undefined) {
         result.agents.preset = agents.preset;
     }
+    if (excludedAgents !== undefined) {
+        result.agents.excluded = excludedAgents;
+    }
     return result;
 }
+function validateAgentIdList(value, field, errors) {
+    const valid = [];
+    const seen = new Set();
+    for (const [index, entry] of value.entries()) {
+        if (typeof entry !== 'string' || !SAFE_AGENT_ID.test(entry)) {
+            errors.push(`'${field}[${index}]' must be a lowercase kebab-case agent id (1-64 characters)`);
+            continue;
+        }
+        if (seen.has(entry)) {
+            errors.push(`'${field}' must not contain duplicate agent id '${entry}'`);
+            continue;
+        }
+        seen.add(entry);
+        valid.push(entry);
+    }
+    return valid;
+}
+function isValidModelIdentifier(provider, value) {
+    if (provider === 'kimi') {
+        return typeof value === 'string' && SAFE_KIMI_MODEL_ID.test(value);
+    }
+    return isExactModelIdentifier(value);
+}
+function modelIdentifierError(field, provider) {
+    if (provider === 'kimi') {
+        return (`'${field}' must be a safe Kimi model id: 1-128 characters matching ` +
+            `[A-Za-z0-9][A-Za-z0-9._/:-]*`);
+    }
+    return `'${field}' must be a nonblank provider model identifier`;
+}
+function isExactModelIdentifier(value) {
+    return (typeof value === 'string' &&
+        value.length > 0 &&
+        value.trim().length > 0 &&
+        value === value.trim());
+}
 /**
  * Serialises an {@link InstallConfig} back to YAML and writes it with
  * LF line endings. Used by `npx specrails-core update --reset-config`

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

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

@@ -2,7 +2,7 @@ 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';
+import { pathExists, readBytes, readTextFile, writeFileLf } from '../util/fs.js';
 /**
  * Computes a stable sha256 digest for a file, returned as `sha256:<hex>`.
  */
@@ -12,10 +12,8 @@ export function sha256Of(filePath) {
     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.
+ * Walks `templates/**` plus the bundled doctor command file and
+ * produces a stable-sorted manifest.
  *
  * Stable-sort rule: artifact keys are sorted ascending by POSIX path.
  */
@@ -27,15 +25,38 @@ export function buildManifest(input) {
         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 {
+    const manifest = {
         version: input.version,
         installed_at,
         artifacts: sortKeys(artifacts),
     };
+    if (input.providers && input.providers.length > 0) {
+        const existing = readExistingProviderInventory(input.repoRoot);
+        manifest.providers = [...new Set([...existing.providers, ...input.providers])];
+        manifest.primary_provider =
+            existing.primaryProvider ?? input.primaryProvider ?? manifest.providers[0];
+    }
+    return manifest;
+}
+function readExistingProviderInventory(repoRoot) {
+    const manifestPath = path.join(repoRoot, '.specrails', 'specrails-manifest.json');
+    if (!pathExists(manifestPath))
+        return { providers: [] };
+    try {
+        const parsed = JSON.parse(readTextFile(manifestPath));
+        const providers = Array.isArray(parsed.providers)
+            ? parsed.providers.filter((provider) => typeof provider === 'string')
+            : [];
+        return {
+            providers,
+            primaryProvider: typeof parsed.primary_provider === 'string' ? parsed.primary_provider : undefined,
+        };
+    }
+    catch {
+        return { providers: [] };
+    }
 }
 /**
  * Writes the manifest JSON and the companion version file under

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

@@ -1 +1 @@
-{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../src/installer/phases/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,IAAI,MAAM,WAAW,CAAA;AAE5B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAatD;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,QAAgB;IACvC,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAA;IACjC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC7D,OAAO,UAAU,IAAI,EAAE,CAAA;AACzB,CAAC;AAaD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;IAE5F,MAAM,SAAS,GAA2B,EAAE,CAAA;IAE5C,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,WAAW,CAAC,CAAA;IAC5D,mBAAmB,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC7E,SAAS,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAA;IACtE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAA;IACtE,SAAS,CAAC,8BAA8B,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAA;IAChE,SAAS,CAAC,8BAA8B,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAA;IAEhE,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,YAAY;QACZ,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;KAC/B,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAgB,EAChB,QAA2B;IAE3B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,yBAAyB,CAAC,CAAA;IACjF,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,mBAAmB,CAAC,CAAA;IAC1E,WAAW,CAAC,YAAY,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;IACnE,WAAW,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAA;IACjD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,CAAA;AACtC,CAAC;AAED;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,IAAY;IACvC,MAAM,SAAS,GAAa,EAAE,CAAA;IAC9B,IAAI,CAAC;QACH,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;IACvB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,eAAe,CACvB,uCAAwC,GAAa,CAAC,OAAO,EAAE,EAC/D,IAAI,CACL,CAAA;IACH,CAAC;IACD,sEAAsE;IACtE,mEAAmE;IACnE,SAAS,CAAC,IAAI,EAAE,CAAA;IAChB,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,SAAS,IAAI,CAAC,GAAW,EAAE,GAAa;IACtC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;IAChC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;QAChC,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;QACxB,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;YACrB,IAAI,IAAI,KAAK,cAAc;gBAAE,SAAQ;YACrC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QAChB,CAAC;aAAM,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;YACvB,IAAI,IAAI,KAAK,mBAAmB;gBAAE,SAAQ;YAC1C,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACf,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAI,GAAsB;IACzC,MAAM,GAAG,GAAsB,EAAE,CAAA;IACjC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACxC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAE,CAAA;IAClB,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../../src/installer/phases/manifest.ts"],"names":[],"mappings":"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"}

package/dist/installer/phases/prereqs.js

@@ -4,13 +4,41 @@ 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';
+import { assertClaudeAuthenticated, assertKimiAuthenticated, claudeVersion, detectAvailability, isSupportedKimiVersion, kimiVersion, MIN_KIMI_VERSION, resolveProvider, } from './provider-detect.js';
+/**
+ * OpenSpec 1.4.1, which the installer invokes during the default init/update
+ * flow, requires Node >=20.19.0. Keep this floor independent from Kimi's npm
+ * package requirement: SpecRails launches an externally installed Kimi CLI and
+ * does not require the Kimi npm distribution.
+ */
+export const MIN_NODE_VERSION = '20.19.0';
+export function isSupportedNodeVersion(version) {
+    const parsed = /^v?(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/.exec(version.trim());
+    if (!parsed)
+        return false;
+    const actual = parsed.slice(1, 4).map(Number);
+    const minimum = MIN_NODE_VERSION.split('.').map(Number);
+    for (let index = 0; index < minimum.length; index++) {
+        if (actual[index] > minimum[index])
+            return true;
+        if (actual[index] < minimum[index])
+            return false;
+    }
+    return true;
+}
 /**
  * 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) {
+    const nodeVersion = process.versions.node;
+    if (!isSupportedNodeVersion(nodeVersion)) {
+        throw new PrerequisiteError(`Node.js ${nodeVersion} is unsupported. SpecRails requires Node.js ` +
+            `${MIN_NODE_VERSION} or newer because OpenSpec 1.4.1 uses that runtime floor. ` +
+            'Install a supported Node.js release from https://nodejs.org/');
+    }
+    ok(`Node.js: ${nodeVersion}`);
     if (!(await gitInstalled())) {
         throw new PrerequisiteError('git is required but not on PATH. Install git: https://git-scm.com/');
     }
@@ -40,18 +68,45 @@ export async function checkPrerequisites(options) {
             ok(`Provider: claude (--provider flag)`);
         }
     }
+    if (provider === 'kimi') {
+        if (availability.kimi) {
+            const v = await kimiVersion();
+            if (!isSupportedKimiVersion(v) && !options.skipPrereqs) {
+                throw new PrerequisiteError(`Kimi Code ${v} is unsupported. Upgrade to ${MIN_KIMI_VERSION} or newer: ` +
+                    'https://www.kimi.com/code/docs/en/kimi-code-cli/guides/getting-started.html');
+            }
+            ok(`Kimi Code CLI: ${v}`);
+        }
+        else if (options.explicitProvider === 'kimi') {
+            if (!options.skipPrereqs) {
+                throw new PrerequisiteError('Kimi Code CLI is not installed. Install it from https://www.kimi.com/code/docs/en/ ' +
+                    'and retry, or run with SPECRAILS_SKIP_PREREQS=1 for fixture generation.');
+            }
+            ok('Provider: kimi (--provider flag)');
+        }
+    }
     // 1.3 Authentication for the selected provider.
     if (provider === 'claude') {
         await assertClaudeAuthenticated({ skipPrereqs: options.skipPrereqs });
         ok('Claude: authenticated');
     }
+    if (provider === 'kimi' && availability.kimi) {
+        const status = await assertKimiAuthenticated({ skipPrereqs: options.skipPrereqs });
+        if (status === 'authenticated') {
+            ok('Kimi: authentication evidence found');
+        }
+        else if (status === 'unknown') {
+            info('Kimi authentication could not be proven without a billable prompt; ' +
+                '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.
     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/');
+            throw new PrerequisiteError(`npm is required but not on PATH. Install Node.js ${MIN_NODE_VERSION}+ from https://nodejs.org/`);
         }
     }
     else {
@@ -81,7 +136,6 @@ export async function checkPrerequisites(options) {
     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) {

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

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

@@ -3,17 +3,20 @@ 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';
+/** Oldest TypeScript Kimi Code CLI release covered by this integration. */
+export const MIN_KIMI_VERSION = '0.27.0';
 /**
  * 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, gemini] = await Promise.all([
+    const [claude, codex, gemini, kimi] = await Promise.all([
         commandExists('claude'),
         commandExists('codex'),
         commandExists('gemini'),
+        commandExists('kimi'),
     ]);
-    return { claude, codex, gemini };
+    return { claude, codex, gemini, kimi };
 }
 /**
  * Returns the Claude CLI version string (stdout of `claude --version`)
@@ -28,13 +31,36 @@ export async function claudeVersion() {
         return 'unknown';
     }
 }
+/** Returns the raw Kimi Code CLI version or `unknown` when it cannot be probed. */
+export async function kimiVersion() {
+    try {
+        const { stdout, stderr } = await runCommand('kimi', ['--version'], {
+            inherit: false,
+            timeoutMs: 10_000,
+        });
+        return stdout.trim() || stderr.trim() || 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/** Extracts a semver-like triple from version output such as `kimi-code 0.27.0`. */
+export function parseCliVersion(raw) {
+    return /(?:^|[^\d])(\d+)\.(\d+)\.(\d+)(?:[^\d]|$)/.exec(raw)?.slice(1, 4).join('.') ?? null;
+}
+/** True when `raw` identifies a Kimi CLI at or above {@link MIN_KIMI_VERSION}. */
+export function isSupportedKimiVersion(raw) {
+    const parsed = parseCliVersion(raw);
+    if (!parsed)
+        return false;
+    return compareVersionTriples(parsed, MIN_KIMI_VERSION) >= 0;
+}
 /**
  * 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`).
  */
@@ -45,26 +71,33 @@ export async function resolveProvider(availability, options = {}) {
         return 'claude';
     if (options.explicit === 'gemini')
         return 'gemini';
+    if (options.explicit === 'kimi')
+        return 'kimi';
     // No multi-provider auto-pick beyond the historical Claude-first default: when
     // several CLIs are installed and no provider was requested, prefer Claude so
     // existing projects don't get re-bootstrapped onto a different provider. Users
-    // pick codex/gemini via --provider or install-config.yaml.
+    // pick codex/gemini/kimi via --provider or install-config.yaml.
     if (availability.claude)
         return 'claude';
     if (availability.codex)
         return 'codex';
     if (availability.gemini)
         return 'gemini';
+    if (availability.kimi)
+        return 'kimi';
     if (options.skipPrereqs)
         return 'claude';
     throw new ProviderError('No AI CLI found. Install Claude Code (https://claude.ai/download), ' +
         'Codex CLI (https://developers.openai.com/codex), or ' +
-        'Gemini CLI (https://github.com/google-gemini/gemini-cli) before running specrails-core init.');
+        'Gemini CLI (https://github.com/google-gemini/gemini-cli), or ' +
+        'Kimi Code (https://www.kimi.com/code/docs/en/) before running specrails-core init.');
 }
 /**
  * Directory / filename conventions the provider dictates.
  *   - Claude Code:  .claude/ + CLAUDE.md
  *   - Codex:        .codex/  + AGENTS.md
+ *   - Gemini CLI:   .gemini/ + GEMINI.md
+ *   - Kimi Code:    .kimi-code/ + AGENTS.md
  */
 export function derivedPaths(provider) {
     if (provider === 'codex') {
@@ -73,7 +106,13 @@ export function derivedPaths(provider) {
     if (provider === 'gemini') {
         return { providerDir: '.gemini', instructionsFile: 'GEMINI.md' };
     }
-    return { providerDir: '.claude', instructionsFile: 'CLAUDE.md' };
+    if (provider === 'kimi') {
+        return { providerDir: '.kimi-code', instructionsFile: '.kimi-code/AGENTS.md' };
+    }
+    if (provider === 'claude') {
+        return { providerDir: '.claude', instructionsFile: 'CLAUDE.md' };
+    }
+    throw new ProviderError(`Unsupported provider: ${String(provider)}`);
 }
 /**
  * Asserts that Claude Code is authenticated. Matches the three-path
@@ -96,6 +135,59 @@ export async function assertClaudeAuthenticated(options = {}) {
         '  Option 2 (OAuth):   claude auth login',
     ].join('\n'));
 }
+/**
+ * Bounded, non-billing Kimi authentication probe.
+ *
+ * Kimi 0.27 has no CLI command that proves managed OAuth readiness without
+ * starting a model request. We therefore recognise non-secret evidence (the
+ * managed credential file or a process-scoped model key), and honour explicit
+ * login failures emitted by `kimi doctor`. A successful `kimi doctor` only
+ * validates configuration, so it deliberately yields `unknown`.
+ */
+export async function probeKimiAuthentication(options = {}) {
+    const env = options.env ?? process.env;
+    if (typeof env.KIMI_MODEL_API_KEY === 'string' &&
+        env.KIMI_MODEL_API_KEY.length > 0 &&
+        typeof env.KIMI_MODEL_NAME === 'string' &&
+        env.KIMI_MODEL_NAME.length > 0) {
+        return 'authenticated';
+    }
+    const kimiHome = options.kimiCodeHome ??
+        (typeof env.KIMI_CODE_HOME === 'string' && env.KIMI_CODE_HOME.length > 0
+            ? env.KIMI_CODE_HOME
+            : path.join(homedir(), '.kimi-code'));
+    if (pathExists(path.join(kimiHome, 'credentials', 'kimi-code.json'))) {
+        return 'authenticated';
+    }
+    try {
+        const { stdout, stderr } = await runCommand('kimi', ['doctor'], {
+            inherit: false,
+            timeoutMs: 10_000,
+            env,
+        });
+        return textReportsMissingKimiLogin(`${stdout}\n${stderr}`) ? 'unauthenticated' : 'unknown';
+    }
+    catch (error) {
+        const probe = error;
+        const text = `${probe.stdout ?? ''}\n${probe.stderr ?? ''}\n${probe.message ?? ''}`;
+        return textReportsMissingKimiLogin(text) ? 'unauthenticated' : 'unknown';
+    }
+}
+/**
+ * Rejects only a conclusive login failure. `unknown` is allowed because setup
+ * must not spend quota merely to prove authentication.
+ */
+export async function assertKimiAuthenticated(options = {}) {
+    const status = await probeKimiAuthentication(options);
+    if (status !== 'unauthenticated' || options.skipPrereqs)
+        return status;
+    throw new ProviderError([
+        'Kimi Code is installed but login is required.',
+        '',
+        '  Run: kimi login',
+        '  Then retry specrails-core init.',
+    ].join('\n'));
+}
 async function hasClaudeApiKeyConfigured() {
     try {
         const { stdout } = await runCommand('claude', ['config', 'list'], { inherit: false });
@@ -117,4 +209,22 @@ async function hasClaudeOauthJson() {
         return false;
     }
 }
+function textReportsMissingKimiLogin(raw) {
+    const text = raw.toLowerCase();
+    return (text.includes('login required') ||
+        text.includes('not logged in') ||
+        text.includes('not authenticated') ||
+        text.includes('please run kimi login') ||
+        text.includes('run `kimi login`'));
+}
+function compareVersionTriples(left, right) {
+    const a = left.split('.').map(Number);
+    const b = right.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const diff = (a[i] ?? 0) - (b[i] ?? 0);
+        if (diff !== 0)
+            return diff;
+    }
+    return 0;
+}
 //# sourceMappingURL=provider-detect.js.map