specrails-desktop 2.30.2 → 2.31.0

package/server/dist/core-package.js

@@ -8,12 +8,12 @@ exports.CORE_PACKAGE_SPEC = void 0;
  * minute it is published — adopting a new major is a deliberate one-line
  * bump here, shipped through the app's own release pipeline.
  *
- * Floor bumped to 4.8.0 — the version that ships the Gemini provider target
- * (`.gemini/` commands + agents). It also changes the `npx` package-spec string,
+ * Floor bumped to 4.12.0 — the version that ships the Kimi provider target
+ * (`.kimi-code/` skills + roles). It also changes the `npx` package-spec string,
  * which invalidates any stale `_npx` exec cache that npx would otherwise reuse
  * for the old `^4.6.0` range (so users actually resolve the newer core).
  *
  * `SPECRAILS_CORE_BIN` remains the escape hatch for local/linked builds
  * (see getCoreCommand in setup-manager.ts).
  */
-exports.CORE_PACKAGE_SPEC = 'specrails-core@^4.8.0';
+exports.CORE_PACKAGE_SPEC = 'specrails-core@^4.12.0';

package/server/dist/core-update-manager.js

@@ -116,7 +116,13 @@ class CoreUpdateManager {
         }
         this.updating = true;
         this.emit('downloading', { version: requested });
-        const tmp = fs_1.default.mkdtempSync(path_1.default.join(os_1.default.tmpdir(), 'core-update-'));
+        // realpath the tmp root: on macOS os.tmpdir() is a symlinked path
+        // (/var/folders → /private/var/folders). The staged core's cli.js has an
+        // auto-run guard comparing import.meta.url (realpathed by Node's ESM
+        // loader) against process.argv[1] (the literal spawn arg) — a symlinked
+        // staging path makes them differ, so main() never runs and every
+        // install-framework/swap-current child exits 0 as a silent no-op.
+        const tmp = fs_1.default.mkdtempSync(path_1.default.join(realTmpDir(), 'core-update-'));
         try {
             this.npmInstallFn(`${exports.CORE_PACKAGE}@${requested}`, tmp);
             const coreRoot = path_1.default.join(tmp, 'node_modules', exports.CORE_PACKAGE);
@@ -187,6 +193,16 @@ function uniqueProviders(values) {
     const out = Array.from(new Set(values.filter((v) => typeof v === 'string' && v.length > 0)));
     return out.length > 0 ? out : ['claude'];
 }
+/** os.tmpdir() with symlinks resolved (macOS /var/folders → /private/var/folders). */
+function realTmpDir() {
+    const dir = os_1.default.tmpdir();
+    try {
+        return fs_1.default.realpathSync(dir);
+    }
+    catch {
+        return dir;
+    }
+}
 /** GET the latest published version from the npm registry (no npm binary needed). */
 async function fetchLatestFromRegistry() {
     const controller = new AbortController();

package/server/dist/db.js

@@ -1426,6 +1426,44 @@ const MIGRATIONS = [
             db.exec(`ALTER TABLE rail_pr_deliveries ADD COLUMN safety_archives TEXT NOT NULL DEFAULT '[]'`);
         }
     },
+    // Migration 55: Agent Studio history belongs to a provider-native role
+    // catalog. The same logical custom role id can validly exist for Claude and
+    // Kimi in one project; keying history only by agent_name mixed bodies and
+    // version counters across those catalogs. Legacy rows predate provider-aware
+    // Studio and therefore belong to Claude.
+    (db) => {
+        const versionCols = new Set(db.prepare(`PRAGMA table_info(agent_versions)`).all()
+            .map((row) => row.name));
+        if (!versionCols.has('provider')) {
+            db.exec(`
+        ALTER TABLE agent_versions RENAME TO agent_versions_v54;
+        CREATE TABLE agent_versions (
+          id           INTEGER PRIMARY KEY AUTOINCREMENT,
+          provider     TEXT    NOT NULL DEFAULT 'claude',
+          agent_name   TEXT    NOT NULL,
+          version      INTEGER NOT NULL,
+          body         TEXT    NOT NULL,
+          created_at   INTEGER NOT NULL,
+          UNIQUE (provider, agent_name, version)
+        );
+        INSERT INTO agent_versions (id, provider, agent_name, version, body, created_at)
+          SELECT id, 'claude', agent_name, version, body, created_at
+            FROM agent_versions_v54;
+        DROP TABLE agent_versions_v54;
+        CREATE INDEX idx_agent_versions_provider_name
+          ON agent_versions(provider, agent_name);
+      `);
+        }
+        const testCols = new Set(db.prepare(`PRAGMA table_info(agent_tests)`).all()
+            .map((row) => row.name));
+        if (!testCols.has('provider')) {
+            db.exec(`ALTER TABLE agent_tests ADD COLUMN provider TEXT NOT NULL DEFAULT 'claude'`);
+        }
+        db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_agent_tests_provider_name
+        ON agent_tests(provider, agent_name)
+    `);
+    },
 ];
 function applyMigrations(db) {
     // Ensure the migrations table exists (migration 1 creates it, but we need
@@ -1624,7 +1662,12 @@ function listJobs(db, opts) {
 }
 function getJob(db, jobId) {
     return db
-        .prepare('SELECT * FROM jobs WHERE id = ?')
+        .prepare(`
+      SELECT jobs.*, jp.profile_name AS profile_name
+      FROM jobs
+      LEFT JOIN job_profiles jp ON jp.job_id = jobs.id
+      WHERE jobs.id = ?
+    `)
         .get(jobId);
 }
 function getJobEvents(db, jobId) {
@@ -1884,11 +1927,19 @@ function getStats(db) {
     const costSum = `COALESCE(SUM(total_cost_usd), 0)`;
     const estSum = `COALESCE(SUM(CASE WHEN total_cost_usd_estimated = 1 THEN total_cost_usd ELSE 0 END), 0)`;
     const costRow = db.prepare(`
-    SELECT ${costSum} as totalCostUsd, ${estSum} as estimatedCostUsd
+    SELECT
+      ${costSum} as totalCostUsd,
+      ${estSum} as estimatedCostUsd,
+      COUNT(total_cost_usd) as pricedRuns,
+      SUM(CASE WHEN total_cost_usd IS NULL THEN 1 ELSE 0 END) as unpricedRuns
     FROM ai_invocations
   `).get();
     const costTodayRow = db.prepare(`
-    SELECT ${costSum} as costToday, ${estSum} as estimatedCostToday
+    SELECT
+      ${costSum} as costToday,
+      ${estSum} as estimatedCostToday,
+      COUNT(total_cost_usd) as pricedTodayRuns,
+      SUM(CASE WHEN total_cost_usd IS NULL THEN 1 ELSE 0 END) as unpricedTodayRuns
     FROM ai_invocations
     WHERE strftime('%Y-%m-%d', started_at) = ?
   `).get(today);
@@ -1900,14 +1951,18 @@ function getStats(db) {
         costToday: costTodayRow.costToday,
         estimatedCostUsd: costRow.estimatedCostUsd,
         estimatedCostToday: costTodayRow.estimatedCostToday,
+        pricedRuns: costRow.pricedRuns,
+        unpricedRuns: costRow.unpricedRuns ?? 0,
+        pricedTodayRuns: costTodayRow.pricedTodayRuns,
+        unpricedTodayRuns: costTodayRow.unpricedTodayRuns ?? 0,
         avgDurationMs: totalRow.avgDurationMs,
     };
 }
 // ─── Project settings ─────────────────────────────────────────────────────────
 /**
- * Default pre-prompt used by Freestyle (Claude-only rails) when the project
+ * Default pre-prompt used by provider-capable Freestyle rails when the project
  * has no per-project override. Freestyle skips the OpenSpec pipeline entirely:
- * it hands Claude the spec text plus this instruction and lets it work
+ * it hands the selected autonomous provider the spec text plus this instruction and lets it work
  * autonomously end-to-end.
  */
 exports.DEFAULT_FREESTYLE_PRE_PROMPT = [

package/server/dist/desktop-analytics.js

@@ -55,7 +55,9 @@ function queryProjectCost(db, clause, params) {
     return db.prepare(`
     SELECT
       COALESCE(SUM(total_cost_usd), 0) as totalCostUsd,
-      COALESCE(SUM(CASE WHEN total_cost_usd_estimated = 1 THEN total_cost_usd ELSE 0 END), 0) as estimatedCostUsd
+      COALESCE(SUM(CASE WHEN total_cost_usd_estimated = 1 THEN total_cost_usd ELSE 0 END), 0) as estimatedCostUsd,
+      COUNT(total_cost_usd) as pricedRuns,
+      SUM(CASE WHEN total_cost_usd IS NULL THEN 1 ELSE 0 END) as unpricedRuns
     FROM ai_invocations ${clause}
   `).get(...params);
 }
@@ -76,6 +78,8 @@ function queryProjectKpi(db, clause, params) {
     return {
         totalCostUsd: cost.totalCostUsd,
         estimatedCostUsd: cost.estimatedCostUsd,
+        pricedRuns: cost.pricedRuns ?? 0,
+        unpricedRuns: cost.unpricedRuns ?? 0,
         totalJobs: counts.totalJobs,
         successCount: counts.successCount ?? 0,
         avgDurationMs: counts.avgDurationMs,
@@ -110,7 +114,8 @@ function queryProjectTimeline(db, clause, params) {
     SELECT
       strftime('%Y-%m-%d', started_at) as date,
       COALESCE(SUM(total_cost_usd), 0) as costUsd,
-      COALESCE(SUM(CASE WHEN total_cost_usd_estimated = 1 THEN total_cost_usd ELSE 0 END), 0) as estimatedCostUsd
+      COALESCE(SUM(CASE WHEN total_cost_usd_estimated = 1 THEN total_cost_usd ELSE 0 END), 0) as estimatedCostUsd,
+      SUM(CASE WHEN total_cost_usd IS NULL THEN 1 ELSE 0 END) as unpricedCount
     FROM ai_invocations ${clause}
     GROUP BY date
     ORDER BY date ASC
@@ -127,10 +132,14 @@ function getDesktopAnalytics(registry, opts) {
     const contexts = registry.listContexts();
     let totalCostUsd = 0;
     let estimatedCostUsd = 0;
+    let pricedRuns = 0;
+    let unpricedRuns = 0;
     let totalJobs = 0;
     let totalSuccess = 0;
     let costToday = 0;
     let estimatedCostToday = 0;
+    let pricedTodayRuns = 0;
+    let unpricedTodayRuns = 0;
     let jobsToday = 0;
     const projectBreakdown = [];
     const timelineMap = new Map();
@@ -141,24 +150,31 @@ function getDesktopAnalytics(registry, opts) {
         const timeline = queryProjectTimeline(ctx.db, clause, params);
         totalCostUsd += kpi.totalCostUsd;
         estimatedCostUsd += kpi.estimatedCostUsd;
+        pricedRuns += kpi.pricedRuns;
+        unpricedRuns += kpi.unpricedRuns;
         totalJobs += kpi.totalJobs;
         totalSuccess += kpi.successCount;
         costToday += todayKpi.totalCostUsd;
         estimatedCostToday += todayKpi.estimatedCostUsd;
+        pricedTodayRuns += todayKpi.pricedRuns;
+        unpricedTodayRuns += todayKpi.unpricedRuns;
         jobsToday += todayKpi.totalJobs;
         projectBreakdown.push({
             projectId: ctx.project.id,
             projectName: ctx.project.name,
             totalCostUsd: kpi.totalCostUsd,
             estimatedCostUsd: kpi.estimatedCostUsd,
+            pricedRuns: kpi.pricedRuns,
+            unpricedRuns: kpi.unpricedRuns,
             totalJobs: kpi.totalJobs,
             successRate: kpi.totalJobs > 0 ? kpi.successCount / kpi.totalJobs : 0,
             avgDurationMs: kpi.avgDurationMs,
         });
         for (const row of timeline) {
-            const acc = timelineMap.get(row.date) ?? { costUsd: 0, estimatedCostUsd: 0 };
+            const acc = timelineMap.get(row.date) ?? { costUsd: 0, estimatedCostUsd: 0, unpricedCount: 0 };
             acc.costUsd += row.costUsd;
             acc.estimatedCostUsd += row.estimatedCostUsd;
+            acc.unpricedCount += row.unpricedCount ?? 0;
             timelineMap.set(row.date, acc);
         }
     }
@@ -170,7 +186,12 @@ function getDesktopAnalytics(registry, opts) {
     // Build sorted cost timeline
     const costTimeline = Array.from(timelineMap.entries())
         .sort(([a], [b]) => a.localeCompare(b))
-        .map(([date, v]) => ({ date, costUsd: v.costUsd, estimatedCostUsd: v.estimatedCostUsd }));
+        .map(([date, v]) => ({
+        date,
+        costUsd: v.costUsd,
+        estimatedCostUsd: v.estimatedCostUsd,
+        ...(v.unpricedCount > 0 ? { unpricedCount: v.unpricedCount } : {}),
+    }));
     // Sort projects by cost descending
     projectBreakdown.sort((a, b) => b.totalCostUsd - a.totalCostUsd);
     return {
@@ -179,10 +200,14 @@ function getDesktopAnalytics(registry, opts) {
             totalCostUsd,
             estimatedCostUsd,
             includesEstimated: estimatedCostUsd > 0,
+            pricedRuns,
+            unpricedRuns,
             totalJobs,
             successRate: totalJobs > 0 ? totalSuccess / totalJobs : 0,
             costToday,
             estimatedCostToday,
+            pricedTodayRuns,
+            unpricedTodayRuns,
             jobsToday,
         },
         projectBreakdown,
@@ -221,11 +246,15 @@ function getDesktopTodayStats(registry) {
     let costToday = 0;
     let estimatedCostToday = 0;
     let jobsToday = 0;
+    let pricedRuns = 0;
+    let unpricedRuns = 0;
     for (const ctx of registry.listContexts()) {
         const costRow = ctx.db.prepare(`
       SELECT
         COALESCE(SUM(total_cost_usd), 0) as costToday,
-        COALESCE(SUM(CASE WHEN total_cost_usd_estimated = 1 THEN total_cost_usd ELSE 0 END), 0) as estimatedCostToday
+        COALESCE(SUM(CASE WHEN total_cost_usd_estimated = 1 THEN total_cost_usd ELSE 0 END), 0) as estimatedCostToday,
+        COUNT(total_cost_usd) as pricedRuns,
+        SUM(CASE WHEN total_cost_usd IS NULL THEN 1 ELSE 0 END) as unpricedRuns
       FROM ai_invocations ${clause}
     `).get(...params);
         const jobsRow = ctx.db.prepare(`
@@ -233,9 +262,18 @@ function getDesktopTodayStats(registry) {
     `).get(...params);
         costToday += costRow.costToday;
         estimatedCostToday += costRow.estimatedCostToday;
+        pricedRuns += costRow.pricedRuns;
+        unpricedRuns += costRow.unpricedRuns ?? 0;
         jobsToday += jobsRow.jobsToday;
     }
     // App-level agent-chat spend (desktop.sqlite), added to the headline figure.
     costToday += agentCostSince(registry, today);
-    return { costToday, estimatedCostToday, includesEstimated: estimatedCostToday > 0, jobsToday };
+    return {
+        costToday,
+        estimatedCostToday,
+        includesEstimated: estimatedCostToday > 0,
+        jobsToday,
+        pricedRuns,
+        unpricedRuns,
+    };
 }

package/server/dist/desktop-router.js

@@ -107,9 +107,74 @@ function hasCommandFiles(dir) {
         return false;
     }
 }
+function hasProviderSkillFiles(dir) {
+    try {
+        for (const entry of fs_1.default.readdirSync(dir)) {
+            if (fs_1.default.existsSync(path_1.default.join(dir, entry, 'SKILL.md')))
+                return true;
+            if (entry === 'rails') {
+                for (const role of fs_1.default.readdirSync(path_1.default.join(dir, entry))) {
+                    if (fs_1.default.existsSync(path_1.default.join(dir, entry, role, 'SKILL.md')))
+                        return true;
+                }
+            }
+        }
+    }
+    catch {
+        return false;
+    }
+    return false;
+}
 function hasSpecrails(projectPath) {
     return hasCommandFiles(path_1.default.join(projectPath, '.claude', 'commands', 'sr'))
-        || hasCommandFiles(path_1.default.join(projectPath, '.claude', 'commands', 'specrails'));
+        || hasCommandFiles(path_1.default.join(projectPath, '.claude', 'commands', 'specrails'))
+        || hasProviderSkillFiles(path_1.default.join(projectPath, '.kimi-code', 'skills'));
+}
+function readinessIssue(adapter, detection) {
+    if (!detection.installed) {
+        return {
+            code: 'provider_cli_missing',
+            message: `${adapter.displayName} CLI was not found on PATH. Install it, authenticate, then restart Specrails.`,
+        };
+    }
+    if (!detection.executable) {
+        return {
+            code: 'provider_cli_unusable',
+            message: detection.error
+                ?? `${adapter.displayName} was found but its executable readiness probe failed. Reinstall it, authenticate, then restart Specrails.`,
+        };
+    }
+    // An adapter with a pinned floor is usable only when the probe positively
+    // verifies that floor. Treat an unparseable/unknown version as incompatible;
+    // otherwise the UI could advertise a binary that cannot honour our contract.
+    if (adapter.minCliVersion && detection.meetsMinimum !== true) {
+        return {
+            code: 'provider_cli_outdated',
+            message: detection.error
+                ?? `${adapter.displayName} ${detection.version ?? '(unknown version)'} does not satisfy the required minimum ${adapter.minCliVersion}.`,
+        };
+    }
+    return null;
+}
+async function detectProviderReadiness(adapter) {
+    try {
+        const detection = await adapter.detectInstalled();
+        return { detection, issue: readinessIssue(adapter, detection) };
+    }
+    catch (err) {
+        const detection = {
+            installed: false,
+            executable: false,
+            error: err instanceof Error ? err.message : String(err),
+        };
+        return {
+            detection,
+            issue: {
+                code: 'provider_cli_unusable',
+                message: `${adapter.displayName} readiness probe failed: ${detection.error}`,
+            },
+        };
+    }
 }
 function canonicalizePath(resolvedPath) {
     try {
@@ -293,12 +358,8 @@ function createDesktopRouter(registry, broadcast) {
     // the multi-provider work. The `SPECRAILS_CODEX_BETA=0` env var is honoured
     // as an emergency rollback (forces codex back to "unavailable" in the UI
     // without redeploying) — unset or `1` reports the real detection.
-    router.get('/available-providers', (_req, res) => {
+    router.get('/available-providers', async (_req, res) => {
         const providers = (0, core_compat_1.detectAvailableCLIs)();
-        // tiers: quick install is always available (app-driven config); full requires an AI CLI
-        const tiers = ['quick'];
-        if (Object.values(providers).some(Boolean))
-            tiers.push('full');
         // Return the full detected map (registry-driven) so a newly-registered
         // provider surfaces here with no edit. Apply per-provider beta gates: codex
         // is forced unavailable when SPECRAILS_CODEX_BETA=0 (emergency rollback).
@@ -309,7 +370,34 @@ function createDesktopRouter(registry, broadcast) {
         // SPECRAILS_GEMINI_BETA=0 (emergency rollback, parity with codex).
         if (isGeminiBetaDisabled())
             gated.gemini = false;
-        res.json({ ...gated, tiers });
+        const providerIssues = {};
+        if (gated.kimi) {
+            const readiness = await detectProviderReadiness((0, providers_1.getAdapter)('kimi'));
+            if (readiness.issue) {
+                gated.kimi = false;
+                providerIssues.kimi = readiness.issue;
+            }
+            else {
+                const core = await (0, core_compat_1.checkCoreCompat)();
+                if (!(0, core_compat_1.coreCompatSupportsProvider)(core, 'kimi')) {
+                    gated.kimi = false;
+                    providerIssues.kimi = {
+                        code: 'core_provider_unsupported',
+                        message: 'This Specrails Core build cannot render Kimi skills. Update or reinstall Specrails, then retry.',
+                    };
+                }
+            }
+        }
+        // tiers: quick install is always available (app-driven config); full
+        // requires a CLI that also survives provider-specific compatibility gates.
+        const tiers = ['quick'];
+        if (Object.values(gated).some(Boolean))
+            tiers.push('full');
+        const launchDescriptors = Object.fromEntries((0, providers_1.listAdapters)().map((adapter) => [
+            adapter.id,
+            { command: adapter.binary, args: [] },
+        ]));
+        res.json({ ...gated, tiers, providerIssues, launchDescriptors });
     });
     router.get('/setup-prerequisites', (req, res) => {
         const status = (0, setup_prerequisites_1.getSetupPrerequisitesStatus)();
@@ -335,7 +423,7 @@ function createDesktopRouter(registry, broadcast) {
         res.json(status);
     });
     // POST /api/projects — register a new project by path
-    router.post('/projects', (req, res) => {
+    router.post('/projects', async (req, res) => {
         const { path: projectPath, name, provider, providers: providersRaw } = req.body ?? {};
         if (!projectPath || typeof projectPath !== 'string') {
             res.status(400).json({ error: 'path is required' });
@@ -382,6 +470,27 @@ function createDesktopRouter(registry, broadcast) {
             });
             return;
         }
+        if (providers.includes('kimi')) {
+            const readiness = await detectProviderReadiness((0, providers_1.getAdapter)('kimi'));
+            if (readiness.issue) {
+                res.status(409).json({
+                    code: readiness.issue.code,
+                    provider: 'kimi',
+                    error: readiness.issue.message,
+                    detection: readiness.detection,
+                });
+                return;
+            }
+            const core = await (0, core_compat_1.checkCoreCompat)();
+            if (!(0, core_compat_1.coreCompatSupportsProvider)(core, 'kimi')) {
+                res.status(409).json({
+                    code: 'core_provider_unsupported',
+                    provider: 'kimi',
+                    error: 'This Specrails Core build cannot render Kimi skills. Update or reinstall Specrails, then retry.',
+                });
+                return;
+            }
+        }
         const resolvedPath = path_1.default.resolve(projectPath);
         // Validate path exists
         if (!fs_1.default.existsSync(resolvedPath)) {
@@ -537,11 +646,18 @@ function createDesktopRouter(registry, broadcast) {
         const desktopDailyBudgetUsd = desktopDailyBudgetRaw != null ? parseFloat(desktopDailyBudgetRaw) : null;
         const costAlertRaw = (0, desktop_db_1.getDesktopSetting)(registry.desktopDb, 'cost_alert_threshold_usd');
         const costAlertThresholdUsd = costAlertRaw != null ? parseFloat(costAlertRaw) : null;
-        const { costToday } = (0, desktop_analytics_1.getDesktopTodayStats)(registry);
-        const budgetUtilizationPct = desktopDailyBudgetUsd != null && desktopDailyBudgetUsd > 0
+        const { costToday, pricedRuns, unpricedRuns } = (0, desktop_analytics_1.getDesktopTodayStats)(registry);
+        const budgetUtilizationPct = desktopDailyBudgetUsd != null && desktopDailyBudgetUsd > 0 && unpricedRuns === 0
             ? (costToday / desktopDailyBudgetUsd) * 100
             : null;
-        res.json({ desktopDailyBudgetUsd, costAlertThresholdUsd, costToday, budgetUtilizationPct });
+        res.json({
+            desktopDailyBudgetUsd,
+            costAlertThresholdUsd,
+            costToday,
+            pricedRuns,
+            unpricedRuns,
+            budgetUtilizationPct,
+        });
     });
     // PATCH /api/budget — update app-level budget settings
     router.patch('/budget', (req, res) => {

package/server/dist/explore-cwd-manager.js

@@ -17,8 +17,9 @@ const providers_1 = require("./providers");
  * provider CLI for Explore Spec turns. See openspec/changes/accelerate-spec-
  * chat-first-token/design.md decisions D1–D3 + D9, and openspec/changes/
  * add-multi-provider-support/specs/explore-spec/spec.md for the multi-
- * provider behaviour (instructions file is adapter-driven: CLAUDE.md for
- * claude, AGENTS.md for codex).
+ * provider behaviour (the instructions path is adapter-driven: CLAUDE.md for
+ * Claude, AGENTS.md for Codex, GEMINI.md for Gemini, and
+ * .kimi-code/AGENTS.md for Kimi).
  *
  * Layout under `<specrails-home>/.specrails/projects/<slug>/explore-cwd/`:
  *   ├── <adapter.instructionsFilename>  — embedded mini-prompt, app-owned
@@ -115,6 +116,9 @@ function ensureExploreCwd(input, baseDir) {
     fs_1.default.mkdirSync(cwd, { recursive: true });
     const adapter = (0, providers_1.getAdapter)(input.provider ?? 'claude');
     const instructionsPath = path_1.default.join(cwd, adapter.instructionsFilename);
+    // Provider instruction paths are project-relative, not necessarily
+    // top-level filenames (Kimi uses `.kimi-code/AGENTS.md`).
+    fs_1.default.mkdirSync(path_1.default.dirname(instructionsPath), { recursive: true });
     const desiredInstructions = renderExploreInstructions(input.projectName);
     let currentInstructions = null;
     try {
@@ -130,7 +134,12 @@ function ensureExploreCwd(input, baseDir) {
     // — provider is immutable post-creation but the lifecycle code MUST handle
     // the edge per spec), remove any stale instructions file authored by a
     // different provider so the explore-cwd doesn't carry both.
-    const STALE_INSTRUCTION_FILES = ['CLAUDE.md', 'AGENTS.md', 'GEMINI.md'];
+    const STALE_INSTRUCTION_FILES = [
+        'CLAUDE.md',
+        'AGENTS.md',
+        'GEMINI.md',
+        path_1.default.join('.kimi-code', 'AGENTS.md'),
+    ];
     for (const stale of STALE_INSTRUCTION_FILES) {
         if (stale === adapter.instructionsFilename)
             continue;
@@ -140,6 +149,13 @@ function ensureExploreCwd(input, baseDir) {
                 fs_1.default.unlinkSync(stalePath);
             }
             catch { /* best-effort */ }
+            const staleParent = path_1.default.dirname(stalePath);
+            if (staleParent !== cwd) {
+                try {
+                    fs_1.default.rmdirSync(staleParent);
+                }
+                catch { /* non-empty or already gone */ }
+            }
         }
     }
     ensureProjectLink(cwd, input.projectPath);

package/server/dist/feature-flags.js

@@ -30,7 +30,7 @@ function isJiraEnabled() {
 }
 /**
  * Interactive freestyle jobs: when launched with the rail's "Interactive"
- * toggle, an freestyle (Claude-only) job becomes a persistent chat session —
+ * toggle, a Claude Freestyle job becomes a persistent chat session —
  * the user sends multiple prompts across turns, the job stays resident until an
  * explicit "Finalize Job" action, and every turn's real token spend is summed
  * into the single job row. Server-side default ON; set

package/server/dist/file-story-manager.js

@@ -152,9 +152,9 @@ class FileStoryManager {
                 started_at: startedIso,
                 finished_at: new Date((this.deps.now ?? Date.now)()).toISOString(),
                 model: out?.model,
-                total_cost_usd: out?.costUsd ?? 0,
-                tokens_in: out?.tokensIn ?? 0,
-                tokens_out: out?.tokensOut ?? 0,
+                total_cost_usd: out?.costUsd ?? undefined,
+                tokens_in: out?.tokensIn ?? undefined,
+                tokens_out: out?.tokensOut ?? undefined,
                 tokens_cache_read: out?.tokensCacheRead,
                 tokens_cache_create: out?.tokensCacheCreate,
                 duration_ms: out?.durationMs ?? 0,

package/server/dist/file-summary-generator.js

@@ -9,6 +9,7 @@ const readline_1 = require("readline");
 const tree_kill_1 = __importDefault(require("tree-kill"));
 const cli_prompt_1 = require("./util/cli-prompt");
 const result_event_1 = require("./result-event");
+const runtime_1 = require("./providers/runtime");
 const GENERATE_TIMEOUT_MS = 60_000;
 const SYSTEM_PROMPT_EN = 'You are explaining code to a non-developer. Output 2 to 4 sentences in plain language about what the file does. ' +
     'No code, no jargon, no bullet lists. Output only the explanation, nothing else.';
@@ -54,14 +55,20 @@ function createFileSummaryGenerator(opts) {
         const startedAt = Date.now();
         if (signal?.aborted)
             throw new Error('file-summary generator aborted before start');
-        const args = adapter.buildArgs('spec-gen', {
+        const toolPolicy = (0, runtime_1.pureOutputToolPolicy)(adapter);
+        if (!toolPolicy) {
+            throw new Error(`provider_tool_policy_unsupported:${adapter.id}:pure-output`);
+        }
+        const spawnOptions = {
             prompt: buildUserPrompt(input, adapter, systemPromptFor),
             systemPrompt: adapter.capabilities.systemPromptArg ? systemPromptFor(input.language) : undefined,
             model,
             maxTurns: 1,
-        });
+            toolPolicy,
+        };
+        const args = adapter.buildArgs('spec-gen', spawnOptions);
         const child = spawn(adapter.binary, args, {
-            env: process.env,
+            env: (0, runtime_1.buildProviderEnv)(adapter, spawnOptions),
             stdio: ['ignore', 'pipe', 'pipe'],
             cwd: opts.cwd,
         });
@@ -81,10 +88,10 @@ function createFileSummaryGenerator(opts) {
                     return {
                         model: result.model ?? model,
                         provider: adapter.id,
-                        costUsd: result.total_cost_usd ?? 0,
+                        costUsd: result.total_cost_usd ?? null,
                         costEstimated: estimated,
-                        tokensIn: result.tokens_in ?? 0,
-                        tokensOut: result.tokens_out ?? 0,
+                        tokensIn: result.tokens_in ?? null,
+                        tokensOut: result.tokens_out ?? null,
                         tokensCacheRead: result.tokens_cache_read,
                         tokensCacheCreate: result.tokens_cache_create,
                         durationMs: result.duration_ms ?? (Date.now() - startedAt),
@@ -159,12 +166,11 @@ function createFileSummaryGenerator(opts) {
             }
             const reader = (0, readline_1.createInterface)({ input: child.stdout, crlfDelay: Infinity });
             reader.on('line', (line) => {
-                const ev = adapter.parseStreamLine(line);
-                if (!ev)
-                    return;
-                events.push(ev);
-                if (ev.kind === 'text-delta')
-                    fullText += ev.text;
+                for (const ev of (0, runtime_1.parseStreamEvents)(adapter, line)) {
+                    events.push(ev);
+                    if (ev.kind === 'text-delta')
+                        fullText += ev.text;
+                }
             });
             child.on('error', (err) => {
                 clearTimeout(timer);
@@ -213,10 +219,10 @@ function createFileSummaryGenerator(opts) {
                     summary,
                     model: result.model ?? model,
                     provider: adapter.id,
-                    costUsd: result.total_cost_usd ?? 0,
+                    costUsd: result.total_cost_usd ?? null,
                     costEstimated: estimated,
-                    tokensIn: result.tokens_in ?? 0,
-                    tokensOut: result.tokens_out ?? 0,
+                    tokensIn: result.tokens_in ?? null,
+                    tokensOut: result.tokens_out ?? null,
                     tokensCacheRead: result.tokens_cache_read,
                     tokensCacheCreate: result.tokens_cache_create,
                     durationMs,

package/server/dist/file-summary-manager.js

@@ -554,9 +554,9 @@ class FileSummaryManager {
                     started_at: startedIso,
                     finished_at: new Date((this.deps.now ?? Date.now)()).toISOString(),
                     model: out.model,
-                    total_cost_usd: out.costUsd,
-                    tokens_in: out.tokensIn,
-                    tokens_out: out.tokensOut,
+                    total_cost_usd: out.costUsd ?? undefined,
+                    tokens_in: out.tokensIn ?? undefined,
+                    tokens_out: out.tokensOut ?? undefined,
                     tokens_cache_read: out.tokensCacheRead,
                     tokens_cache_create: out.tokensCacheCreate,
                     duration_ms: out.durationMs,
@@ -598,9 +598,9 @@ class FileSummaryManager {
                     started_at: startedIso,
                     finished_at: new Date((this.deps.now ?? Date.now)()).toISOString(),
                     model: partial?.model,
-                    total_cost_usd: partial?.costUsd ?? 0,
-                    tokens_in: partial?.tokensIn ?? 0,
-                    tokens_out: partial?.tokensOut ?? 0,
+                    total_cost_usd: partial?.costUsd ?? undefined,
+                    tokens_in: partial?.tokensIn ?? undefined,
+                    tokens_out: partial?.tokensOut ?? undefined,
                     tokens_cache_read: partial?.tokensCacheRead,
                     tokens_cache_create: partial?.tokensCacheCreate,
                     duration_ms: partial?.durationMs ?? 0,