specrails-core 4.11.3 → 5.0.0

package/dist/installer/commands/update.js

@@ -6,9 +6,9 @@ import { copyDir, isDir, pathExists, readTextFile } from '../util/fs.js';
 import { loadInstallConfig, resolveConfigPath } from '../phases/install-config.js';
 import { buildManifest, writeManifestFiles } from '../phases/manifest.js';
 import { derivedPaths, detectAvailability, resolveProvider } from '../phases/provider-detect.js';
-import { assembleProjectWorkspace } from '../phases/scaffold.js';
 import { frameworkRoot, resolveArtifacts } from '../util/registry.js';
-import { ensureFramework } from './init.js';
+import { migratePreV5Install } from './v5-migration.js';
+import { ensureFramework, installOpenSpecProject, reassembleWorkspaceProviders, snapshotWorkspaceProviderSelections, warnUnknownSelectedAgents, } from './init.js';
 const VALID_ONLY = new Set([
     'all',
     'core',
@@ -21,9 +21,6 @@ export async function runUpdate(flags) {
     const currentVersion = readVersion(scriptDir);
     const repoRoot = path.resolve(typeof flags['root-dir'] === 'string' ? flags['root-dir'] : process.cwd());
     const dryRun = flags['dry-run'] === true;
-    // Read install-config.yaml so the user's original choices (tier) survive
-    // the update. Flag overrides win when present; missing config falls back to
-    // defaults (tier=full).
     // ─── Resolve where artifacts live: in-repo (default) vs relocated ─────
     // Mirrors init: standalone updates resolve IN-REPO by default (`allocate:false`
     // + no registry entry ⇒ `artifactRoot === codeRoot === repoRoot`); desktop and
@@ -42,21 +39,25 @@ export async function runUpdate(flags) {
     // can't know the relocated workspace path), so it is read from repoRoot — NOT
     // the artifactRoot. Falls back to a workspace copy if present (none today).
     const config = loadInstallConfig(resolveConfigPath(repoRoot)) ?? loadInstallConfig(resolveConfigPath(artifactRoot));
-    const tier = config?.tier ?? 'full';
     const selectedAgents = config?.agents.selected;
+    warnUnknownSelectedAgents(selectedAgents);
     const marker = path.join(artifactRoot, '.specrails', 'specrails-version');
     if (!pathExists(marker)) {
         throw new PrerequisiteError(`No existing specrails install detected at ${repoRoot}. Run \`npx specrails-core init\` first.`);
     }
     const previousVersion = readExistingVersion(artifactRoot);
+    const previousSelections = snapshotWorkspaceProviderSelections(artifactRoot);
     // Provider can be FORCED via --provider (e.g. specrails-desktop updating one
     // provider on a multi-provider workspace, where auto-detection would always
-    // resolve `.claude` first and never reach codex/gemini). Absent ⇒ auto-detect
+    // resolve `.claude` first and never reach codex/gemini/kimi). Absent ⇒ auto-detect
     // from the existing install — byte-identical single-provider behaviour.
     let provider;
     if (typeof flags.provider === 'string') {
-        if (flags.provider !== 'claude' && flags.provider !== 'codex' && flags.provider !== 'gemini') {
-            throw new InstallerError(`--provider value must be 'claude', 'codex', or 'gemini', got: ${flags.provider}`, 40);
+        if (flags.provider !== 'claude' &&
+            flags.provider !== 'codex' &&
+            flags.provider !== 'gemini' &&
+            flags.provider !== 'kimi') {
+            throw new InstallerError(`--provider value must be 'claude', 'codex', 'gemini', or 'kimi', got: ${flags.provider}`, 40);
         }
         provider = flags.provider;
         step(`Update: using requested provider ${provider}`);
@@ -67,20 +68,39 @@ export async function runUpdate(flags) {
     }
     const { providerDir } = derivedPaths(provider);
     ok(`Detected provider: ${provider} (${providerDir})`);
+    if (artifactRoot !== codeRoot) {
+        resolveArtifacts(repoRoot, {
+            allocate: true,
+            allocator: 'core-standalone',
+            home: process.env.SPECRAILS_REGISTRY_HOME,
+            providers: [provider],
+            coreVersion: currentVersion,
+        });
+    }
     // ─── Resolve --only scope ────────────────────────────────────────
     const scope = resolveScope(flags.only);
     if (scope === 'web-manager') {
         warn('--only=web-manager is deprecated. The standalone web-manager has been retired; ' +
             'specrails-desktop is the supported dashboard. Skipping with no changes.');
-        return { repoRoot, previousVersion, currentVersion, provider, dryRun, scope, tier };
+        return { repoRoot, previousVersion, currentVersion, provider, dryRun, scope };
     }
-    if (config) {
-        info(`Honouring install-config.yaml: tier=${tier}`);
+    if (provider === 'kimi' &&
+        (scope === 'rules' || scope === 'agents')) {
+        throw new InstallerError(`--only=${scope} cannot safely refresh Kimi's linked direct-child skill ` +
+            'catalogue in isolation. Run `npx specrails-core update --provider kimi` ' +
+            'without --only so framework, live workspace, and manifest advance together.', 40);
     }
     if (dryRun) {
-        info(`Dry run: would update [${scope}, tier=${tier}] ` +
+        info(`Dry run: would update [${scope}] ` +
             `for ${previousVersion ?? '(unknown)'} → ${currentVersion}.`);
-        return { repoRoot, previousVersion, currentVersion, provider, dryRun, scope, tier };
+        return { repoRoot, previousVersion, currentVersion, provider, dryRun, scope };
+    }
+    // ─── v5 migration: remove artefacts a pre-v5 install left behind ─────
+    // Runs BEFORE the re-scaffold so obsolete agents/commands/staging are gone
+    // before the fresh v5 template set is placed. Reserved paths (profiles, custom-*)
+    // and files the installer never owned are left untouched.
+    if (scope === 'all' || scope === 'core') {
+        migratePreV5Install({ artifactRoot, providerDir });
     }
     step(`Update: refreshing scaffold [scope=${scope}] (${previousVersion ?? '?'} → ${currentVersion})`);
     if (scope === 'all' || scope === 'core') {
@@ -97,18 +117,23 @@ export async function runUpdate(flags) {
             version: currentVersion,
             selectedAgents,
         });
-        assembleProjectWorkspace({
+        reassembleWorkspaceProviders({
             workspace: artifactRoot,
             frameworkDir: fwDir,
-            provider,
-            providerDir,
             version: currentVersion,
             codeRoot,
             scriptDir,
-            selectedAgents,
+            selectedProvider: provider,
+            selectedAgents: config?.provider === provider
+                ? selectedAgents
+                : previousSelections[provider] ?? selectedAgents,
+            previousSelections,
             // In-repo updates COPY real files; relocated workspaces symlink.
             copyStatics: artifactRoot === codeRoot,
         });
+        if (provider === 'kimi') {
+            await installOpenSpecProject(codeRoot, provider, artifactRoot);
+        }
         ok(`Re-linked ${providerDir}/ at framework ${currentVersion} + rewrote manifest`);
     }
     else if (scope === 'rules' || scope === 'agents') {
@@ -118,6 +143,8 @@ export async function runUpdate(flags) {
             scriptDir,
             repoRoot: artifactRoot,
             version: currentVersion,
+            providers: [provider],
+            primaryProvider: provider,
         });
         const { manifestPath, versionPath } = writeManifestFiles(artifactRoot, manifest);
         ok(`Wrote ${path.relative(artifactRoot, manifestPath)}`);
@@ -127,14 +154,13 @@ export async function runUpdate(flags) {
     info(`specrails-core ${previousVersion ?? '?'} → ${currentVersion}`);
     // Terminal sentinel for programmatic consumers (see comment in init.ts).
     ok('update complete');
-    return { repoRoot, previousVersion, currentVersion, provider, dryRun: false, scope, tier };
+    return { repoRoot, previousVersion, currentVersion, provider, dryRun: false, scope };
 }
 /**
  * Re-applies a single subtree (rules or agents) from the bundled
- * templates into both the staging dir (.specrails/setup-templates/)
- * and the live provider directory if it already exists. Skips the
- * enrich placeholders + agent-memory bootstrap that scaffoldInstallation
- * does — those should only run on a true (re-)install.
+ * templates into the staging dir (.specrails/setup-templates/). Skips the
+ * agent-memory bootstrap that scaffoldInstallation does — that should only
+ * run on a true (re-)install.
  */
 function rescaffoldComponent(component, args) {
     const src = path.join(args.scriptDir, 'templates', component);
@@ -171,6 +197,8 @@ async function resolveExistingProvider(artifactRoot) {
         return 'codex';
     if (pathExists(path.join(artifactRoot, '.gemini')))
         return 'gemini';
+    if (pathExists(path.join(artifactRoot, '.kimi-code')))
+        return 'kimi';
     // None present — fall back to resolving via CLI availability.
     const avail = await detectAvailability();
     try {

package/dist/installer/commands/update.js.map

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

package/dist/installer/commands/v5-migration.js

@@ -0,0 +1,119 @@
+import path from 'node:path';
+import { info, ok } from '../util/logger.js';
+import { pathExists, removePath } from '../util/fs.js';
+import { isReservedPath, repoRelative } from '../util/paths.js';
+/**
+ * Agent ids removed in v5. On update of a pre-v5 install their live `.md`
+ * files (installer-owned by the manifest contract) are deleted. `custom-*`
+ * agents are NEVER in this set and are protected by the reserved-paths gate.
+ */
+const REMOVED_AGENTS = [
+    'sr-product-manager',
+    'sr-product-analyst',
+    'sr-test-writer',
+    'sr-doc-sync',
+    'sr-merge-resolver',
+    'sr-frontend-developer',
+    'sr-backend-developer',
+    'sr-frontend-reviewer',
+    'sr-backend-reviewer',
+    'sr-security-reviewer',
+    'sr-performance-reviewer',
+];
+/** Command ids removed in v5 (deleted across every provider surface). */
+const REMOVED_COMMANDS = [
+    'enrich',
+    'reconfig',
+    'vpc-drift',
+    'auto-propose-backlog-specs',
+    'get-backlog-specs',
+    'merge-resolve',
+    'test',
+];
+/**
+ * Removes artefacts a pre-v5 install left behind so the fresh v5 template set
+ * places into a clean tree. Strictly subtractive and reserved-path-safe:
+ *
+ *   - Removed agent files (`.claude/agents/sr-*.md`, `.gemini/agents/sr-*.md`)
+ *   - Removed command files (`<providerDir>/commands/specrails/*.md`) and their
+ *     codex skill dirs (`.codex/skills/<cmd>/`)
+ *   - The generated top-level skills for removed commands (`.claude/skills/<id>/`)
+ *   - Obsolete staging subtrees under `.specrails/setup-templates/`
+ *     (`personas/`, `skills/enrich/`, and the removed command/agent templates)
+ *   - VPC persona output dirs (`<providerDir>/agents/personas/`)
+ *
+ * `custom-*.md` agents and `.specrails/profiles/**` are protected by
+ * {@link isReservedPath}; files the installer never owned are not enumerated
+ * here, so they are untouched. When at least one path is removed a migration
+ * summary is printed so the user sees exactly what changed.
+ */
+export function migratePreV5Install(input) {
+    const { artifactRoot, providerDir } = input;
+    const removed = [];
+    const remove = (abs) => {
+        if (!pathExists(abs))
+            return;
+        const rel = repoRelative(artifactRoot, abs);
+        if (isReservedPath(rel))
+            return;
+        removePath(abs);
+        removed.push(rel);
+    };
+    // Agents (claude + gemini both store `<providerDir>/agents/<id>.md`).
+    const agentsDir = path.join(artifactRoot, providerDir, 'agents');
+    for (const id of REMOVED_AGENTS) {
+        remove(path.join(agentsDir, `${id}.md`));
+    }
+    // VPC persona output directory (created by the retired enrich flow).
+    remove(path.join(agentsDir, 'personas'));
+    // Commands (claude/gemini command files) + codex skill dirs.
+    const commandsDir = path.join(artifactRoot, providerDir, 'commands', 'specrails');
+    const skillsDir = path.join(artifactRoot, providerDir, 'skills');
+    for (const id of REMOVED_COMMANDS) {
+        remove(path.join(commandsDir, `${id}.md`));
+        remove(path.join(commandsDir, `${id}.toml`));
+        remove(path.join(skillsDir, id));
+    }
+    // Top-level generated skills for removed backlog commands (claude).
+    for (const id of ['sr-get-backlog-specs', 'sr-auto-propose-backlog-specs']) {
+        remove(path.join(skillsDir, id));
+    }
+    // Codex rail skills for removed agents.
+    const railsDir = path.join(skillsDir, 'rails');
+    for (const id of REMOVED_AGENTS) {
+        remove(path.join(railsDir, id));
+    }
+    // Obsolete staging subtrees under setup-templates/ (the dir itself stays).
+    const staging = path.join(artifactRoot, '.specrails', 'setup-templates');
+    remove(path.join(staging, 'personas'));
+    remove(path.join(staging, 'skills', 'enrich'));
+    const stagingRails = path.join(staging, 'skills', 'rails');
+    for (const id of REMOVED_AGENTS) {
+        remove(path.join(stagingRails, id));
+    }
+    const stagingAgents = path.join(staging, 'agents');
+    for (const id of REMOVED_AGENTS) {
+        remove(path.join(stagingAgents, `${id}.md`));
+    }
+    const stagingCommands = path.join(staging, 'commands', 'specrails');
+    for (const id of REMOVED_COMMANDS) {
+        remove(path.join(stagingCommands, `${id}.md`));
+    }
+    // Removed settings template (perf thresholds).
+    remove(path.join(staging, 'settings', 'perf-thresholds.yml'));
+    if (removed.length === 0)
+        return;
+    info(`v5 migration: removed ${removed.length} obsolete artefact(s) from a pre-v5 install:`);
+    for (const rel of removed.sort())
+        info(`  - ${rel}`);
+    ok('Removed v4 artefacts — agents beyond the core trio now come from profiles (custom-*.md).');
+}
+/**
+ * Test helper: enumerate removed agent/command ids so specs can assert the
+ * migration set stays in lock-step with the deleted templates.
+ */
+export const V5_REMOVED = {
+    agents: REMOVED_AGENTS,
+    commands: REMOVED_COMMANDS,
+};
+//# sourceMappingURL=v5-migration.js.map

package/dist/installer/commands/v5-migration.js.map

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

package/dist/installer/phases/framework-lifecycle.js

@@ -0,0 +1,125 @@
+import path from 'node:path';
+import { InstallerError } from '../util/errors.js';
+import { isDir, pathExists } from '../util/fs.js';
+import { readRegistryOrEmpty } from '../util/registry.js';
+import { derivedPaths, } from './provider-detect.js';
+import { ensureCurrentSymlink, frameworkMaterializationProblem, frameworkStampPath, installFramework, } from './scaffold.js';
+/**
+ * Stable provider order for the global framework store. `framework/current` is
+ * shared by every relocated workspace, so a version transition must carry
+ * forward every provider that can still have live links through that pointer.
+ */
+export const FRAMEWORK_PROVIDERS = [
+    'claude',
+    'codex',
+    'gemini',
+    'kimi',
+];
+function isProvider(value) {
+    return (value === 'claude' ||
+        value === 'codex' ||
+        value === 'gemini' ||
+        value === 'kimi');
+}
+function stableProviders(values) {
+    const wanted = new Set(values);
+    return FRAMEWORK_PROVIDERS.filter((provider) => wanted.has(provider));
+}
+/**
+ * Discover providers represented by a framework version.
+ *
+ * A provider is included when either its subtree or its stamp exists. For the
+ * current version this is deliberately conservative: an interrupted/legacy
+ * materialization without a stamp may still have live workspace symlinks, so
+ * the next version must carry that provider forward rather than dropping it.
+ */
+export function discoverFrameworkProviders(frameworkDir, version) {
+    const versionDir = path.join(frameworkDir, version);
+    return FRAMEWORK_PROVIDERS.filter((provider) => {
+        const { providerDir } = derivedPaths(provider);
+        return (pathExists(path.join(versionDir, providerDir)) ||
+            pathExists(frameworkStampPath(versionDir, providerDir)));
+    });
+}
+/**
+ * Compute the provider set that MUST exist in a destination version before the
+ * process may move the global `current` pointer:
+ *
+ *  1. providers requested by this operation;
+ *  2. every supported provider recorded by any project in registry.json;
+ *  3. every provider represented by the version currently serving workspaces.
+ *
+ * Taking the global registry union (not just the active project) is essential:
+ * `framework/current` is global, while provider inventories are per project.
+ */
+export function resolveRequiredFrameworkProviders(input) {
+    const required = new Set(input.requested ?? []);
+    const registry = readRegistryOrEmpty(input.registryHome);
+    for (const entry of Object.values(registry.projects)) {
+        for (const provider of entry.providers ?? []) {
+            if (isProvider(provider))
+                required.add(provider);
+        }
+        if (isProvider(entry.primaryProvider))
+            required.add(entry.primaryProvider);
+    }
+    for (const provider of discoverFrameworkProviders(input.frameworkDir, 'current')) {
+        required.add(provider);
+    }
+    return stableProviders(required);
+}
+/**
+ * Fail closed when a destination version is missing or only partially
+ * materialized. A valid provider requires BOTH its provider subtree and the
+ * final stamp written after scaffold completion, with matching version/provider
+ * fields. The caller may supply an empty requirement only for a first install;
+ * in that case at least one complete provider must be discoverable in target.
+ */
+export function assertFrameworkVersionComplete(frameworkDir, version, requiredProviders) {
+    const versionDir = path.join(frameworkDir, version);
+    if (!isDir(versionDir)) {
+        throw new InstallerError(`framework version ${version} is not materialized at ${versionDir}`, 41);
+    }
+    const required = requiredProviders.length > 0
+        ? stableProviders(requiredProviders)
+        : discoverFrameworkProviders(frameworkDir, version);
+    if (required.length === 0) {
+        throw new InstallerError(`framework version ${version} is incomplete: no provider was materialized`, 41);
+    }
+    const problems = [];
+    for (const provider of required) {
+        const { providerDir } = derivedPaths(provider);
+        const problem = frameworkMaterializationProblem(versionDir, version, provider, providerDir);
+        if (problem)
+            problems.push(`${provider}: ${problem}`);
+    }
+    if (problems.length > 0) {
+        throw new InstallerError(`framework version ${version} is incomplete; refusing to move current: ` +
+            problems.join('; '), 41);
+    }
+    return required;
+}
+/**
+ * Materialize a complete destination version and expose it with ONE atomic
+ * pointer swap. No call in the provider loop can move `current`; if any provider
+ * fails, existing workspaces continue resolving through the previous version.
+ */
+export function materializeFrameworkVersion(input) {
+    const required = resolveRequiredFrameworkProviders(input);
+    if (required.length === 0) {
+        throw new InstallerError(`framework version ${input.version} has no requested or registered provider`, 41);
+    }
+    for (const provider of required) {
+        installFramework({
+            scriptDir: input.scriptDir,
+            frameworkDir: input.frameworkDir,
+            provider,
+            providerDir: derivedPaths(provider).providerDir,
+            version: input.version,
+        });
+    }
+    assertFrameworkVersionComplete(input.frameworkDir, input.version, required);
+    ensureCurrentSymlink(input.frameworkDir, input.version);
+    return required;
+}
+//# sourceMappingURL=framework-lifecycle.js.map

package/dist/installer/phases/framework-lifecycle.js.map

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