specrails-core 4.1.1 → 4.2.0

package/dist/installer/phases/scaffold.js

@@ -0,0 +1,373 @@
+import { rmSync } from 'node:fs';
+import path from 'node:path';
+import { copyDir, copyFile, isDir, listDir, mkdirp, pathExists, readTextFile, writeFileLf } from '../util/fs.js';
+import { info, ok, warn } from '../util/logger.js';
+/**
+ * Agents excluded from the quick tier because they require a full
+ * /specrails:enrich persona pass to function correctly.
+ */
+const QUICK_EXCLUDED_AGENTS = new Set(['sr-product-manager', 'sr-product-analyst']);
+/**
+ * Skills excluded from the quick tier because they depend on
+ * VPC-only agents (sr-product-manager, sr-product-analyst).
+ */
+const QUICK_EXCLUDED_SKILLS = new Set([
+    'sr-auto-propose-backlog-specs',
+    'sr-get-backlog-specs',
+]);
+const QUICK_REQUIRED_AGENTS = new Set([
+    'sr-architect',
+    'sr-developer',
+    'sr-reviewer',
+    'sr-merge-resolver',
+]);
+/**
+ * Command → required agent dependency map. A command is excluded
+ * from the quick tier when its required agent was excluded (i.e.
+ * VPC-dependent) or when the feature flag (Agent Teams) is off.
+ */
+const COMMAND_AGENT_DEPENDENCIES = [
+    { command: 'auto-propose-backlog-specs', requires: ['sr-product-manager'] },
+    { command: 'vpc-drift', requires: ['sr-product-manager', 'sr-product-analyst'] },
+    { command: 'get-backlog-specs', requires: ['sr-product-analyst'] },
+    { command: 'merge-resolve', requires: ['sr-merge-resolver'] },
+];
+/**
+ * Agents that write "explanation" memory records. When any of them
+ * ships we also need a shared `.claude/agent-memory/explanations/`
+ * directory alongside the per-agent memory dirs.
+ */
+const EXPLANATION_AUTHORS = new Set(['sr-architect', 'sr-reviewer']);
+/**
+ * Returns true iff any of the provider directories already contains
+ * content. The hub-driven path skips the "merge existing?" prompt and
+ * assumes `--yes`; the CLI dispatcher (bin/specrails-core.cjs) should
+ * have prompted before entering this phase.
+ */
+export function detectExistingSetup(input) {
+    const roots = [
+        path.join(input.repoRoot, input.providerDir, 'agents'),
+        path.join(input.repoRoot, input.providerDir, 'commands'),
+        path.join(input.repoRoot, input.providerDir, 'rules'),
+        path.join(input.repoRoot, 'openspec'),
+    ];
+    for (const r of roots) {
+        if (isDir(r) && listDir(r).length > 0)
+            return true;
+    }
+    return false;
+}
+/**
+ * Entry point. Creates directories, copies templates, updates
+ * .gitignore. Returns a summary for logging / tests.
+ */
+export function scaffoldInstallation(input) {
+    const createdDirs = [];
+    let copiedFiles = 0;
+    const mk = (abs) => {
+        mkdirp(abs);
+        createdDirs.push(abs);
+    };
+    // --- Directory skeleton ---
+    mk(path.join(input.repoRoot, input.providerDir));
+    if (input.provider === 'codex') {
+        mk(path.join(input.repoRoot, '.agents', 'skills', 'enrich'));
+        mk(path.join(input.repoRoot, '.agents', 'skills', 'doctor'));
+    }
+    else {
+        mk(path.join(input.repoRoot, input.providerDir, 'commands', 'specrails'));
+        mk(path.join(input.repoRoot, input.providerDir, 'skills'));
+    }
+    const setupTemplates = path.join(input.repoRoot, '.specrails', 'setup-templates');
+    mk(path.join(setupTemplates, 'agents'));
+    mk(path.join(setupTemplates, 'commands'));
+    mk(path.join(setupTemplates, 'skills'));
+    mk(path.join(setupTemplates, 'rules'));
+    mk(path.join(setupTemplates, 'personas'));
+    mk(path.join(setupTemplates, 'claude-md'));
+    mk(path.join(setupTemplates, 'settings'));
+    // --- .gitignore hygiene ---
+    ensureGitignore(input.repoRoot, ['.claude/agent-memory/', '.specrails/']);
+    // --- Copy bundled templates into setup-templates/ ---
+    const templatesSrc = path.join(input.scriptDir, 'templates');
+    if (pathExists(templatesSrc)) {
+        copyDir(templatesSrc, setupTemplates, {
+            filter: (_src, rel) => {
+                // Skip node_modules + package-lock; manifest excludes them too.
+                if (rel.includes('node_modules'))
+                    return false;
+                if (rel.endsWith('package-lock.json'))
+                    return false;
+                return true;
+            },
+        });
+        // Count files copied (approximate — recount via a flat listDir walk).
+        copiedFiles = countFiles(setupTemplates);
+    }
+    else {
+        warn(`templates/ not found at ${templatesSrc} — skipping template copy`);
+    }
+    // --- Write bundled commands (enrich.md + doctor.md) ---
+    copyBundledCommands({ ...input, copiedIncrement: (n) => (copiedFiles += n) });
+    pruneLegacyArtifacts(input);
+    // --- Quick tier: direct-placement short-circuit ---
+    if (input.tier === 'quick') {
+        const placed = placeQuickTierArtefacts({ ...input });
+        copiedFiles += placed.agents + placed.commands + placed.rules;
+        const skippedNote = placed.skippedAgents > 0 ? ` (skipped ${placed.skippedAgents} VPC-dependent)` : '';
+        info(`Quick tier: placed ${placed.agents} agent(s) + ${placed.commands} command(s) + ` +
+            `${placed.rules} rule file(s) directly into ${input.providerDir}/${skippedNote}`);
+    }
+    // --- Skills direct-placement (both tiers, claude provider) ---
+    if (input.provider === 'claude') {
+        const skills = placeSkills(input);
+        copiedFiles += skills.filesCopied;
+        const skillSkipNote = skills.skipped > 0 ? ` (skipped ${skills.skipped} VPC-dependent)` : '';
+        info(`Placed ${skills.placed} skill(s) into ${input.providerDir}/skills/${skillSkipNote}`);
+    }
+    // --- Full-tier hint: enrich is required to generate VPC artefacts ---
+    if (input.tier === 'full') {
+        info('Full tier staged. Run `/specrails:enrich` in Claude Code to generate ' +
+            'VPC personas and adapt agents (including sr-product-manager and ' +
+            'sr-product-analyst) to this codebase.');
+    }
+    ok(`Created ${createdDirs.length} directories, copied ${copiedFiles} files`);
+    return {
+        existingSetup: detectExistingSetup({
+            repoRoot: input.repoRoot,
+            providerDir: input.providerDir,
+        }),
+        createdDirs,
+        copiedFiles,
+    };
+}
+function copyBundledCommands(input) {
+    const commandsSrc = path.join(input.scriptDir, 'commands');
+    if (!isDir(commandsSrc))
+        return;
+    if (input.provider === 'codex') {
+        // Codex: write enrich + doctor as Agent Skills.
+        copyFile(path.join(commandsSrc, 'enrich.md'), path.join(input.repoRoot, '.agents', 'skills', 'enrich', 'SKILL.md'));
+        copyFile(path.join(commandsSrc, 'doctor.md'), path.join(input.repoRoot, '.agents', 'skills', 'doctor', 'SKILL.md'));
+        input.copiedIncrement(2);
+        return;
+    }
+    // Claude: all commands land under <providerDir>/commands/specrails/.
+    const destDir = path.join(input.repoRoot, input.providerDir, 'commands', 'specrails');
+    let count = 0;
+    for (const entry of listDir(commandsSrc)) {
+        const name = path.basename(entry);
+        if (!name.endsWith('.md'))
+            continue;
+        if (name === 'setup.md')
+            continue;
+        // Agent Teams gating — skip team-* commands unless explicitly opted in.
+        if (!input.agentTeams && /^team-/.test(name))
+            continue;
+        copyFile(entry, path.join(destDir, name));
+        count++;
+    }
+    input.copiedIncrement(count);
+}
+function pruneLegacyArtifacts(input) {
+    const legacyPaths = [
+        path.join(input.repoRoot, '.specrails', 'bin', 'doctor.sh'),
+        path.join(input.repoRoot, '.specrails', 'setup-templates', '.provider-detection.json'),
+        path.join(input.repoRoot, '.specrails', 'setup-templates', 'settings', 'integration-contract.json'),
+        path.join(input.repoRoot, '.specrails-version'),
+    ];
+    if (input.provider === 'codex') {
+        legacyPaths.push(path.join(input.repoRoot, '.agents', 'skills', 'setup'));
+    }
+    else {
+        legacyPaths.push(path.join(input.repoRoot, input.providerDir, 'commands', 'setup.md'));
+        legacyPaths.push(path.join(input.repoRoot, input.providerDir, 'commands', 'specrails', 'setup.md'));
+    }
+    for (const target of legacyPaths) {
+        try {
+            rmSync(target, { recursive: true, force: true, maxRetries: 3, retryDelay: 50 });
+        }
+        catch (err) {
+            warn(`failed to prune legacy artifact ${target}: ${err.message}`);
+        }
+    }
+}
+/**
+ * Quick-tier placement: copy agents / commands / rules from the
+ * .specrails/setup-templates/ staging directory into the live
+ * provider directory, substituting template placeholders and
+ * excluding agents + commands whose dependencies are not present.
+ *
+ * Source is setup-templates/ (not scriptDir/templates/) so the pipeline
+ * is: scriptDir/templates/ → setup-templates/ (earlier scaffold step)
+ * → <providerDir>/ (this function). The intermediate hop mirrors the
+ * retired bash installer and lets downstream consumers (specrails-hub's
+ * deployTemplates, /specrails:enrich, update flow) read from a single
+ * canonical staging dir.
+ */
+function placeQuickTierArtefacts(input) {
+    const setupTemplates = path.join(input.repoRoot, '.specrails', 'setup-templates');
+    const projectName = path.basename(input.repoRoot);
+    const providerDirAbs = path.join(input.repoRoot, input.providerDir);
+    const placeholders = {
+        PROJECT_NAME: projectName,
+        SECURITY_EXEMPTIONS_PATH: `${input.providerDir}/security-exemptions.yaml`,
+        PERSONA_DIR: `${input.providerDir}/agents/personas/`,
+    };
+    // --- Agents ---
+    const agentsSrc = path.join(setupTemplates, 'agents');
+    const agentsDest = path.join(providerDirAbs, 'agents');
+    let agentsPlaced = 0;
+    let agentsSkipped = 0;
+    const installedAgentNames = new Set();
+    const selectedAgents = input.selectedAgents
+        ? new Set([...input.selectedAgents, ...QUICK_REQUIRED_AGENTS])
+        : null;
+    if (isDir(agentsSrc)) {
+        mkdirp(agentsDest);
+        for (const src of listDir(agentsSrc)) {
+            const name = path.basename(src);
+            if (!name.endsWith('.md'))
+                continue;
+            const agentId = name.slice(0, -3);
+            if (selectedAgents && !selectedAgents.has(agentId))
+                continue;
+            if (QUICK_EXCLUDED_AGENTS.has(agentId)) {
+                agentsSkipped++;
+                continue;
+            }
+            const dest = path.join(agentsDest, name);
+            const rendered = renderPlaceholders(readTextFile(src), {
+                ...placeholders,
+                MEMORY_PATH: `.claude/agent-memory/${agentId}/`,
+            });
+            writeFileLf(dest, rendered);
+            agentsPlaced++;
+            installedAgentNames.add(agentId);
+            // Per-agent memory directory. Created even when empty so
+            // the first run of the agent doesn't error on ENOENT.
+            mkdirp(path.join(input.repoRoot, '.claude', 'agent-memory', agentId));
+            if (EXPLANATION_AUTHORS.has(agentId)) {
+                mkdirp(path.join(input.repoRoot, '.claude', 'agent-memory', 'explanations'));
+            }
+        }
+    }
+    // --- Commands ---
+    // Skip commands whose required agents were excluded.
+    const excludedCommands = new Set();
+    for (const dep of COMMAND_AGENT_DEPENDENCIES) {
+        const hasAllRequired = dep.requires.every((a) => installedAgentNames.has(a));
+        if (!hasAllRequired)
+            excludedCommands.add(dep.command);
+    }
+    if (!input.agentTeams) {
+        excludedCommands.add('team-debug');
+        excludedCommands.add('team-review');
+    }
+    const commandsSrc = path.join(setupTemplates, 'commands', 'specrails');
+    const commandsDest = path.join(providerDirAbs, 'commands', 'specrails');
+    let commandsPlaced = 0;
+    if (isDir(commandsSrc)) {
+        mkdirp(commandsDest);
+        for (const src of listDir(commandsSrc)) {
+            const name = path.basename(src);
+            if (!name.endsWith('.md'))
+                continue;
+            const cmdId = name.slice(0, -3);
+            if (excludedCommands.has(cmdId))
+                continue;
+            const dest = path.join(commandsDest, name);
+            const rendered = renderPlaceholders(readTextFile(src), {
+                ...placeholders,
+                MEMORY_PATH: '.claude/agent-memory/',
+            });
+            writeFileLf(dest, rendered);
+            commandsPlaced++;
+        }
+    }
+    // --- Rules ---
+    const rulesSrc = path.join(setupTemplates, 'rules');
+    const rulesDest = path.join(providerDirAbs, 'rules');
+    let rulesPlaced = 0;
+    if (isDir(rulesSrc)) {
+        mkdirp(rulesDest);
+        for (const src of listDir(rulesSrc)) {
+            const name = path.basename(src);
+            if (!name.endsWith('.md'))
+                continue;
+            const dest = path.join(rulesDest, name);
+            const rendered = renderPlaceholders(readTextFile(src), placeholders);
+            writeFileLf(dest, rendered);
+            rulesPlaced++;
+        }
+    }
+    return { agents: agentsPlaced, commands: commandsPlaced, rules: rulesPlaced, skippedAgents: agentsSkipped };
+}
+// Copy each `sr-*` subfolder from `.specrails/setup-templates/skills/`
+// into `<providerDir>/skills/`. Skills are full directories
+// (SKILL.md + optional assets), so the whole folder is copied.
+// Quick tier excludes VPC-dependent skills; full tier copies all.
+function placeSkills(input) {
+    const setupSkills = path.join(input.repoRoot, '.specrails', 'setup-templates', 'skills');
+    const destBase = path.join(input.repoRoot, input.providerDir, 'skills');
+    const result = { placed: 0, skipped: 0, filesCopied: 0 };
+    if (!isDir(setupSkills))
+        return result;
+    mkdirp(destBase);
+    for (const entry of listDir(setupSkills)) {
+        if (!isDir(entry))
+            continue;
+        const skillId = path.basename(entry);
+        if (input.tier === 'quick' && QUICK_EXCLUDED_SKILLS.has(skillId)) {
+            result.skipped++;
+            continue;
+        }
+        const dest = path.join(destBase, skillId);
+        copyDir(entry, dest);
+        result.placed++;
+        result.filesCopied += countFiles(dest);
+    }
+    return result;
+}
+/**
+ * Substitutes `{{KEY}}` tokens in the input text with the provided
+ * values, then strips any remaining `{{UNKNOWN}}` tokens (replacing
+ * them with the empty string). Matches the retired bash installer's
+ * `sed` pipeline byte-for-byte for the documented token set.
+ */
+function renderPlaceholders(text, values) {
+    let out = text;
+    for (const [k, v] of Object.entries(values)) {
+        out = out.split(`{{${k}}}`).join(v);
+    }
+    return out.replace(/\{\{[A-Z_]*\}\}/g, '');
+}
+function ensureGitignore(repoRoot, entries) {
+    const p = path.join(repoRoot, '.gitignore');
+    let current = '';
+    if (pathExists(p)) {
+        current = readTextFile(p);
+    }
+    const needed = entries.filter((e) => !lineInFile(current, e));
+    if (needed.length === 0)
+        return;
+    const prefix = current.endsWith('\n') || current.length === 0 ? '' : '\n';
+    const block = ['', '# specrails', ...needed, ''].join('\n');
+    writeFileLf(p, `${current}${prefix}${block}`);
+}
+function lineInFile(contents, line) {
+    return contents.split(/\r?\n/).some((l) => l.trim() === line.trim());
+}
+function countFiles(dir) {
+    if (!isDir(dir))
+        return 0;
+    let n = 0;
+    for (const entry of listDir(dir)) {
+        if (isDir(entry))
+            n += countFiles(entry);
+        else
+            n++;
+    }
+    return n;
+}
+//# sourceMappingURL=scaffold.js.map

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

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

package/dist/installer/util/errors.js

@@ -0,0 +1,79 @@
+/**
+ * Typed error hierarchy for the installer. Each subclass carries an
+ * `exitCode` which the CLI dispatcher translates to the process exit
+ * code so callers (shells, CI, specrails-hub wizard) can distinguish
+ * failure modes without string-parsing stdout.
+ *
+ * Exit-code ranges:
+ *   0       — success
+ *   1       — generic runtime error
+ *   10-19   — prerequisite failures (missing tools, auth, etc.)
+ *   20-29   — filesystem / I/O errors
+ *   30-39   — git errors
+ *   40-49   — provider detection / resolution errors
+ *   50-59   — child-process errors (spawned command failed)
+ *   60      — user aborted a prompt (Ctrl+C or non-TTY with no default)
+ */
+export class InstallerError extends Error {
+    exitCode;
+    constructor(message, exitCode = 1) {
+        super(message);
+        this.name = 'InstallerError';
+        this.exitCode = exitCode;
+        // Preserve prototype chain across transpilation.
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export class PrerequisiteError extends InstallerError {
+    constructor(message) {
+        super(message, 10);
+        this.name = 'PrerequisiteError';
+    }
+}
+export class FilesystemError extends InstallerError {
+    path;
+    constructor(message, path) {
+        super(message, 20);
+        this.name = 'FilesystemError';
+        this.path = path;
+    }
+}
+export class GitError extends InstallerError {
+    command;
+    constructor(message, command) {
+        super(message, 30);
+        this.name = 'GitError';
+        this.command = command;
+    }
+}
+export class ProviderError extends InstallerError {
+    constructor(message) {
+        super(message, 40);
+        this.name = 'ProviderError';
+    }
+}
+export class ExecError extends InstallerError {
+    command;
+    code;
+    stdout;
+    stderr;
+    constructor(command, code, stdout, stderr) {
+        super(`command "${command}" exited with code ${code}`, 50);
+        this.name = 'ExecError';
+        this.command = command;
+        this.code = code;
+        this.stdout = stdout;
+        this.stderr = stderr;
+    }
+}
+export class PromptAbortError extends InstallerError {
+    constructor(message = 'prompt aborted by user or non-TTY environment') {
+        super(message, 60);
+        this.name = 'PromptAbortError';
+    }
+}
+/** Runtime check used by the CLI to map a caught unknown to a typed error. */
+export function isInstallerError(err) {
+    return err instanceof InstallerError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/installer/util/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/installer/util/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,QAAQ,CAAQ;IAEzB,YAAY,OAAe,EAAE,WAAmB,CAAC;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAA;QACxB,iDAAiD;QACjD,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;IACnD,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,cAAc;IACnD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QAClB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAA;IACjC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,cAAc;IACxC,IAAI,CAAoB;IAEjC,YAAY,OAAe,EAAE,IAAa;QACxC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QAClB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAED,MAAM,OAAO,QAAS,SAAQ,cAAc;IACjC,OAAO,CAAoB;IAEpC,YAAY,OAAe,EAAE,OAAgB;QAC3C,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QAClB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAA;QACtB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,cAAc;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QAClB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,SAAU,SAAQ,cAAc;IAClC,OAAO,CAAQ;IACf,IAAI,CAAe;IACnB,MAAM,CAAQ;IACd,MAAM,CAAQ;IAEvB,YACE,OAAe,EACf,IAAmB,EACnB,MAAc,EACd,MAAc;QAEd,KAAK,CAAC,YAAY,OAAO,sBAAsB,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;QAC1D,IAAI,CAAC,IAAI,GAAG,WAAW,CAAA;QACvB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;IACtB,CAAC;CACF;AAED,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IAClD,YAAY,UAAkB,+CAA+C;QAC3E,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAA;QAClB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;IAChC,CAAC;CACF;AAED,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,OAAO,GAAG,YAAY,cAAc,CAAA;AACtC,CAAC"}

package/dist/installer/util/exec.js

@@ -0,0 +1,151 @@
+import { spawn, spawnSync } from 'node:child_process';
+import { ExecError } from './errors.js';
+/**
+ * Cross-platform spawn wrapper.
+ *
+ * - On Windows sets `shell: true` so `.cmd` / `.bat` shims (claude.cmd,
+ *   npm.cmd, gh.cmd) are executable. Required by Node.js since
+ *   CVE-2024-27980; without it, spawning a `.cmd` throws.
+ * - On POSIX sets `shell: false` to keep argv boundaries clean and
+ *   avoid shell-injection surface on user-provided args.
+ * - Streams stdio by default so long commands show progress. Set
+ *   `inherit: false` to capture stdout/stderr into the returned
+ *   {@link RunResult}.
+ * - Throws {@link ExecError} on non-zero exit (captured stdout/stderr
+ *   attached) unless the caller passed `inherit: true` (stream mode).
+ */
+export async function runCommand(cmd, args, opts = {}) {
+    const inherit = opts.inherit ?? true;
+    const useShell = process.platform === 'win32';
+    const spawnOpts = {
+        cwd: opts.cwd,
+        env: opts.env ? { ...process.env, ...opts.env } : process.env,
+        shell: useShell,
+        stdio: inherit ? 'inherit' : ['ignore', 'pipe', 'pipe'],
+    };
+    // When shell:true, Node hands argv to cmd.exe / sh which re-tokenises
+    // the command line. Args containing spaces (commit messages, paths
+    // with whitespace, JSON strings) get split unless we quote them.
+    // POSIX double-quotes work; Windows cmd.exe also accepts them when
+    // we escape inner double quotes as `""`.
+    const finalArgs = useShell ? args.map(quoteArgForShell) : args;
+    return new Promise((resolve, reject) => {
+        const child = spawn(cmd, finalArgs, spawnOpts);
+        let stdout = '';
+        let stderr = '';
+        let timer = null;
+        if (!inherit) {
+            child.stdout?.on('data', (chunk) => {
+                stdout += chunk.toString('utf8');
+            });
+            child.stderr?.on('data', (chunk) => {
+                stderr += chunk.toString('utf8');
+            });
+        }
+        if (opts.timeoutMs && opts.timeoutMs > 0) {
+            timer = setTimeout(() => {
+                terminateProcessTree(child.pid);
+            }, opts.timeoutMs);
+        }
+        child.on('error', (err) => {
+            if (timer)
+                clearTimeout(timer);
+            reject(err);
+        });
+        child.on('close', (code) => {
+            if (timer)
+                clearTimeout(timer);
+            const exitCode = code ?? -1;
+            if (exitCode === 0) {
+                resolve({ code: exitCode, stdout, stderr });
+                return;
+            }
+            if (inherit) {
+                // In stream mode we did not capture output; surface an ExecError
+                // with empty stdout/stderr so callers still get a typed failure.
+                reject(new ExecError(`${cmd} ${args.join(' ')}`.trim(), exitCode, '', ''));
+                return;
+            }
+            reject(new ExecError(`${cmd} ${args.join(' ')}`.trim(), exitCode, stdout, stderr));
+        });
+    });
+}
+/**
+ * Runs a command and returns whether it exited zero. Never throws.
+ * Useful for feature-detection style probes (`commandExists`,
+ * `git --version`).
+ */
+export async function tryRunCommand(cmd, args, opts = {}) {
+    try {
+        await runCommand(cmd, args, { ...opts, inherit: false });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Cross-platform check for whether a command is on PATH. Uses `where`
+ * on Windows and `which` on POSIX.
+ */
+export async function commandExists(cmd) {
+    const probe = process.platform === 'win32' ? 'where' : 'which';
+    return tryRunCommand(probe, [cmd], { inherit: false });
+}
+/**
+ * Terminates a child process tree, not just the immediate child.
+ *
+ * On POSIX, `child.kill('SIGKILL')` to the immediate child is enough
+ * because Node sends the signal to the process and (when detached)
+ * its group. We don't detach, so a SIGKILL to the leader works for
+ * the common case.
+ *
+ * On Windows, when shell:true is in effect (always, in this module),
+ * the immediate child is cmd.exe. Terminating cmd.exe leaves its
+ * spawned children orphaned with stdio pipes still open, and Node's
+ * 'close' event never fires on the parent handle. The fix is to ask
+ * Windows to terminate the entire descendant tree via taskkill /T /F.
+ *
+ * Falls back silently when the PID is unavailable or taskkill fails —
+ * the caller's promise will eventually reject either way (timeout
+ * source unchanged), so the worst-case outcome is the original
+ * "orphan child holds the pipe" behaviour.
+ */
+function terminateProcessTree(pid) {
+    if (pid === undefined)
+        return;
+    if (process.platform === 'win32') {
+        try {
+            // /T = include child processes, /F = force.
+            spawnSync('taskkill', ['/PID', String(pid), '/T', '/F'], { stdio: 'ignore' });
+        }
+        catch {
+            /* taskkill missing or failed — fall through to single-process kill */
+        }
+        return;
+    }
+    // POSIX: SIGKILL the leader. Node delivers the signal directly.
+    try {
+        process.kill(pid, 'SIGKILL');
+    }
+    catch {
+        /* process already exited */
+    }
+}
+/**
+ * Quotes a single argv entry so it survives re-tokenisation by cmd.exe
+ * (Windows shell:true) or sh (POSIX shell:true). Already-quoted
+ * arguments and arguments with no whitespace are returned untouched.
+ *
+ * The quoting strategy is deliberately simple: wrap in double quotes,
+ * escape inner double quotes as `\"`. cmd.exe accepts this dialect
+ * uniformly and POSIX sh does too.
+ */
+function quoteArgForShell(arg) {
+    if (arg.length === 0)
+        return '""';
+    if (!/\s|[<>|&^"`$\\]/.test(arg))
+        return arg;
+    return `"${arg.replace(/"/g, '\\"')}"`;
+}
+//# sourceMappingURL=exec.js.map

package/dist/installer/util/exec.js.map

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