@kynetic-ai/spec 0.9.0 → 0.10.0

package/dist/cli/commands/session/stale-close.js

@@ -0,0 +1,378 @@
+/**
+ * Session stale close command.
+ *
+ * Orchestrates stale-session candidate selection + auto-abandon metadata apply.
+ */
+import { initContext } from "../../../parser/index.js";
+import { applyAutoAbandonMetadata, getSession, resolveSessionId, resolveStaleSessionCriteria, selectStaleActiveSessions, } from "../../../sessions/store.js";
+import { EXIT_CODES } from "../../exit-codes.js";
+import { error, isJsonMode, output } from "../../output.js";
+function normalizeSessionRef(ref) {
+    return ref.startsWith("@") ? ref.slice(1) : ref;
+}
+function describeNotCandidate(evaluation) {
+    if (evaluation.blockedByLivenessGuard) {
+        return "Session has recent activity inside liveness guard window";
+    }
+    if (!evaluation.meetsAgeThreshold && !evaluation.meetsInactivityThreshold) {
+        return "Session does not meet older-than or inactive-for thresholds";
+    }
+    if (!evaluation.meetsAgeThreshold) {
+        return "Session does not meet older-than threshold";
+    }
+    if (!evaluation.meetsInactivityThreshold) {
+        return "Session does not meet inactive-for threshold";
+    }
+    return "Session is not eligible for stale auto-close";
+}
+async function promptConfirmation(question) {
+    const readline = await import("node:readline");
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const answer = await new Promise((resolve) => {
+        rl.question(question, resolve);
+    });
+    rl.close();
+    return answer.toLowerCase() === "y" || answer.toLowerCase() === "yes";
+}
+function buildConfirmationQuestion(mode, candidates) {
+    if (mode === "single") {
+        return "Auto-abandon this stale session? [y/N] ";
+    }
+    if (mode === "refs") {
+        return `Auto-abandon ${candidates} stale session(s) from --refs? [y/N] `;
+    }
+    return `Auto-abandon ${candidates} stale active session(s)? [y/N] `;
+}
+export async function sessionStaleCloseAction(sessionIdOrPrefix, options) {
+    try {
+        const ctx = await initContext();
+        const refs = options.refs ?? [];
+        const hasRefs = refs.length > 0;
+        const hasSingleTarget = typeof sessionIdOrPrefix === "string";
+        const allMode = options.all === true;
+        const dryRun = options.dryRun === true;
+        if (!allMode && !hasSingleTarget && !hasRefs) {
+            error("Missing target. Provide <session-id>, --refs, or --all.", "Try: kspec session stale close <session-id> | --refs <session-id...> | --all");
+            process.exit(EXIT_CODES.USAGE_ERROR);
+        }
+        if (allMode && hasSingleTarget) {
+            error("Cannot use <session-id> together with --all");
+            process.exit(EXIT_CODES.USAGE_ERROR);
+        }
+        if (allMode && hasRefs) {
+            error("Cannot use --refs together with --all");
+            process.exit(EXIT_CODES.USAGE_ERROR);
+        }
+        if (hasSingleTarget && hasRefs) {
+            error("Cannot use <session-id> together with --refs");
+            process.exit(EXIT_CODES.USAGE_ERROR);
+        }
+        const resolvedCriteria = resolveStaleSessionCriteria({
+            olderThan: options.olderThan,
+            inactiveFor: options.inactiveFor,
+            livenessGuard: options.livenessGuard,
+        });
+        if (!resolvedCriteria.ok) {
+            error(resolvedCriteria.message, {
+                field: resolvedCriteria.field,
+                value: resolvedCriteria.value,
+                guidance: resolvedCriteria.guidance,
+            });
+            process.exit(EXIT_CODES.USAGE_ERROR);
+        }
+        const selection = await selectStaleActiveSessions(ctx.specDir, {
+            olderThan: options.olderThan,
+            inactiveFor: options.inactiveFor,
+            livenessGuard: options.livenessGuard,
+        });
+        const evaluationById = new Map(selection.evaluations.map((evaluation) => [evaluation.sessionId, evaluation]));
+        const skippedById = new Map(selection.skipped.map((skipped) => [skipped.sessionId, skipped]));
+        const results = [];
+        const targetCandidates = [];
+        let failures = 0;
+        let mode;
+        let targetSessionId;
+        const targetRefs = [];
+        if (allMode) {
+            mode = "all";
+            for (const skipped of selection.skipped) {
+                results.push({
+                    session_id: skipped.sessionId,
+                    status: "skipped_error",
+                    reason: skipped.detail,
+                });
+            }
+            for (const evaluation of selection.evaluations) {
+                if (evaluation.eligible) {
+                    targetCandidates.push(evaluation);
+                    results.push({
+                        session_id: evaluation.sessionId,
+                        status: dryRun ? "would_abandon" : "abandoned",
+                        reason: "Session meets stale criteria and is eligible for auto-close",
+                        started_at: evaluation.startedAt,
+                        last_activity_at: evaluation.lastActivityAt,
+                        last_activity_source: evaluation.lastActivitySource,
+                        meets_age_threshold: evaluation.meetsAgeThreshold,
+                        meets_inactivity_threshold: evaluation.meetsInactivityThreshold,
+                        blocked_by_liveness_guard: evaluation.blockedByLivenessGuard,
+                    });
+                }
+                else {
+                    results.push({
+                        session_id: evaluation.sessionId,
+                        status: "not_candidate",
+                        reason: describeNotCandidate(evaluation),
+                        started_at: evaluation.startedAt,
+                        last_activity_at: evaluation.lastActivityAt,
+                        last_activity_source: evaluation.lastActivitySource,
+                        meets_age_threshold: evaluation.meetsAgeThreshold,
+                        meets_inactivity_threshold: evaluation.meetsInactivityThreshold,
+                        blocked_by_liveness_guard: evaluation.blockedByLivenessGuard,
+                    });
+                }
+            }
+            failures = selection.failureCount;
+        }
+        else {
+            mode = hasRefs ? "refs" : "single";
+            const resolvedTargets = [];
+            if (hasRefs) {
+                const seenSessionIds = new Set();
+                for (const rawRef of refs) {
+                    const normalized = normalizeSessionRef(rawRef);
+                    const resolution = await resolveSessionId(ctx.specDir, normalized);
+                    if (!resolution.ok) {
+                        failures += 1;
+                        if (resolution.error === "not_found") {
+                            results.push({
+                                session_id: normalized,
+                                input_ref: rawRef,
+                                status: "resolution_error",
+                                reason: `Session not found: ${rawRef}. Try: kspec session list --status active`,
+                            });
+                        }
+                        else {
+                            results.push({
+                                session_id: normalized,
+                                input_ref: rawRef,
+                                status: "resolution_error",
+                                reason: `Ambiguous session ref ${rawRef}: ${resolution.matches.join(", ")}. ` +
+                                    "Try: kspec session list --status active and use a longer ref.",
+                            });
+                        }
+                        continue;
+                    }
+                    if (seenSessionIds.has(resolution.id)) {
+                        continue;
+                    }
+                    seenSessionIds.add(resolution.id);
+                    resolvedTargets.push({
+                        inputRef: rawRef,
+                        sessionId: resolution.id,
+                    });
+                    targetRefs.push(resolution.id);
+                }
+            }
+            else {
+                const normalized = normalizeSessionRef(sessionIdOrPrefix);
+                const resolution = await resolveSessionId(ctx.specDir, normalized);
+                if (!resolution.ok) {
+                    if (resolution.error === "not_found") {
+                        error(`Session not found: ${sessionIdOrPrefix}`, "Try: kspec session list --status active");
+                        process.exit(EXIT_CODES.NOT_FOUND);
+                    }
+                    error(`Session prefix "${sessionIdOrPrefix}" is ambiguous: ${resolution.matches.join(", ")}`, "Try: kspec session list --status active and use a longer ref");
+                    process.exit(EXIT_CODES.NOT_FOUND);
+                }
+                targetSessionId = resolution.id;
+                resolvedTargets.push({
+                    inputRef: sessionIdOrPrefix,
+                    sessionId: resolution.id,
+                });
+            }
+            for (const target of resolvedTargets) {
+                const metadata = await getSession(ctx.specDir, target.sessionId);
+                if (!metadata) {
+                    failures += 1;
+                    results.push({
+                        session_id: target.sessionId,
+                        input_ref: target.inputRef,
+                        status: "resolution_error",
+                        reason: `Session metadata missing for ${target.sessionId}`,
+                    });
+                    continue;
+                }
+                if (metadata.status !== "active") {
+                    results.push({
+                        session_id: target.sessionId,
+                        input_ref: target.inputRef,
+                        status: "not_active",
+                        reason: `Session status is ${metadata.status}; only active sessions are eligible`,
+                    });
+                    continue;
+                }
+                const skipped = skippedById.get(target.sessionId);
+                if (skipped) {
+                    failures += 1;
+                    results.push({
+                        session_id: target.sessionId,
+                        input_ref: target.inputRef,
+                        status: "skipped_error",
+                        reason: skipped.detail,
+                    });
+                    continue;
+                }
+                const evaluation = evaluationById.get(target.sessionId);
+                if (!evaluation) {
+                    failures += 1;
+                    results.push({
+                        session_id: target.sessionId,
+                        input_ref: target.inputRef,
+                        status: "skipped_error",
+                        reason: "Session evaluation unavailable",
+                    });
+                    continue;
+                }
+                if (!evaluation.eligible) {
+                    results.push({
+                        session_id: target.sessionId,
+                        input_ref: target.inputRef,
+                        status: "not_candidate",
+                        reason: describeNotCandidate(evaluation),
+                        started_at: evaluation.startedAt,
+                        last_activity_at: evaluation.lastActivityAt,
+                        last_activity_source: evaluation.lastActivitySource,
+                        meets_age_threshold: evaluation.meetsAgeThreshold,
+                        meets_inactivity_threshold: evaluation.meetsInactivityThreshold,
+                        blocked_by_liveness_guard: evaluation.blockedByLivenessGuard,
+                    });
+                    continue;
+                }
+                targetCandidates.push(evaluation);
+                results.push({
+                    session_id: target.sessionId,
+                    input_ref: target.inputRef,
+                    status: dryRun ? "would_abandon" : "abandoned",
+                    reason: "Session meets stale criteria and is eligible for auto-close",
+                    started_at: evaluation.startedAt,
+                    last_activity_at: evaluation.lastActivityAt,
+                    last_activity_source: evaluation.lastActivitySource,
+                    meets_age_threshold: evaluation.meetsAgeThreshold,
+                    meets_inactivity_threshold: evaluation.meetsInactivityThreshold,
+                    blocked_by_liveness_guard: evaluation.blockedByLivenessGuard,
+                });
+            }
+        }
+        if (!dryRun && targetCandidates.length > 0 && !options.force) {
+            if (isJsonMode()) {
+                error("Confirmation required. Use --force with --json");
+                process.exit(EXIT_CODES.USAGE_ERROR);
+            }
+            const isTTY = process.env.KSPEC_TEST_TTY === "1" ||
+                process.env.KSPEC_TEST_TTY === "true" ||
+                process.stdin.isTTY;
+            if (!isTTY) {
+                error("Non-interactive environment. Use --force to proceed");
+                process.exit(EXIT_CODES.USAGE_ERROR);
+            }
+            const confirmed = await promptConfirmation(buildConfirmationQuestion(mode, targetCandidates.length));
+            if (!confirmed) {
+                error("Operation cancelled");
+                process.exit(EXIT_CODES.USAGE_ERROR);
+            }
+        }
+        const applyResult = await applyAutoAbandonMetadata(ctx.specDir, {
+            criteria: selection.criteria,
+            candidates: targetCandidates,
+        }, {
+            dryRun,
+            shadowCommitMessage: !dryRun && targetCandidates.length > 0
+                ? `session stale close: ${mode} (${targetCandidates.length} candidate${targetCandidates.length === 1 ? "" : "s"})`
+                : undefined,
+        });
+        const updatesBySessionId = new Map(applyResult.updates.map((update) => [update.sessionId, update]));
+        for (const result of results) {
+            if (result.status !== "would_abandon" && result.status !== "abandoned") {
+                continue;
+            }
+            const update = updatesBySessionId.get(result.session_id);
+            if (!update) {
+                failures += 1;
+                result.status = "skipped_error";
+                result.reason = "Failed to generate close metadata update";
+                continue;
+            }
+            result.close_reason = update.closeReason;
+            if (!dryRun) {
+                result.status = "abandoned";
+                result.reason = "Session was auto-abandoned";
+            }
+            else {
+                result.status = "would_abandon";
+                result.reason = "Session would be auto-abandoned (dry run)";
+            }
+        }
+        const candidatesCount = targetCandidates.length;
+        const changedSessions = dryRun ? 0 : applyResult.updatedCount;
+        const skippedSessions = results.filter((result) => result.status === "not_candidate" ||
+            result.status === "not_active" ||
+            result.status === "skipped_error" ||
+            result.status === "resolution_error").length;
+        const payload = {
+            dry_run: dryRun,
+            mode,
+            criteria: {
+                older_than: selection.criteria.olderThan,
+                inactive_for: selection.criteria.inactiveFor,
+                liveness_guard: selection.criteria.livenessGuard,
+            },
+            targets: {
+                session_id: targetSessionId,
+                refs: targetRefs.length > 0 ? targetRefs : undefined,
+                all: allMode,
+            },
+            sessions: results,
+            totals: {
+                active_sessions_total: selection.totalActiveSessions,
+                sessions_evaluated: results.filter((result) => result.status !== "resolution_error").length,
+                candidates: candidatesCount,
+                changed_sessions: changedSessions,
+                skipped_sessions: skippedSessions,
+                failures,
+            },
+        };
+        output(payload, () => {
+            if (dryRun) {
+                console.log("Dry run preview - no session files were modified.");
+            }
+            console.log("Stale session close results:");
+            for (const result of results) {
+                const shortId = result.session_id.slice(0, 8);
+                console.log(`[${shortId}] ${result.status} - ${result.reason}`);
+                if (result.close_reason) {
+                    console.log(`  close_reason: ${result.close_reason}`);
+                }
+            }
+            const totals = payload.totals;
+            console.log("");
+            console.log("Summary:");
+            console.log(`  Active sessions: ${totals.active_sessions_total}`);
+            console.log(`  Evaluated:       ${totals.sessions_evaluated}`);
+            console.log(`  Candidates:      ${totals.candidates}`);
+            console.log(`  Changed:         ${totals.changed_sessions}`);
+            console.log(`  Skipped:         ${totals.skipped_sessions}`);
+            console.log(`  Failures:        ${totals.failures}`);
+        });
+        if (failures > 0) {
+            process.exit(EXIT_CODES.ERROR);
+        }
+    }
+    catch (err) {
+        error("Failed to close stale sessions", err);
+        process.exit(EXIT_CODES.ERROR);
+    }
+}
+//# sourceMappingURL=stale-close.js.map

package/dist/cli/commands/session/stale-close.js.map

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

package/dist/cli/commands/setup.d.ts

@@ -32,6 +32,8 @@ export interface DetectedAgent {
     configPath?: string;
     envVars?: Record<string, string>;
 }
+declare const SETUP_AGENT_OVERRIDES: readonly ["claude-code", "cline", "cursor", "windsurf", "unknown"];
+type SetupAgentOverride = (typeof SETUP_AGENT_OVERRIDES)[number];
 /**
  * Detect which agent environment we're running in.
  * Returns the detected agent type and confidence level.
@@ -81,6 +83,8 @@ export interface SetupPipelineOptions {
     skipSkills?: boolean;
     installHooks?: boolean;
     force?: boolean;
+    /** Explicit agent override (bypasses auto-detection) */
+    agent?: SetupAgentOverride;
     /** Custom author string (overrides auto-detected default) */
     author?: string;
     /** Whether to configure author (only in command handler, not init) */

package/dist/cli/commands/setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAOH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,iCAAiC,CAAC;AAmBzC;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,OAAO,GACP,UAAU,GACV,aAAa,GACb,YAAY,GACZ,WAAW,GACX,OAAO,GACP,UAAU,GACV,KAAK,GACL,QAAQ,GACR,UAAU,GACV,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,eAAe,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,aAAa,CAE3C;AAwCD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AA4cD;;GAEG;AACH,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAmlBD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAmT9B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuN3D"}
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,iCAAiC,CAAC;AAmBzC;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,OAAO,GACP,UAAU,GACV,aAAa,GACb,YAAY,GACZ,WAAW,GACX,OAAO,GACP,UAAU,GACV,KAAK,GACL,QAAQ,GACR,UAAU,GACV,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,EAAE,eAAe,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,QAAA,MAAM,qBAAqB,oEAMjB,CAAC;AAEX,KAAK,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AA2BjE;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,aAAa,CAgB3C;AAwCD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AA4cD;;GAEG;AACH,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wDAAwD;IACxD,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAyrBD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CAuU9B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiO3D"}

package/dist/cli/commands/setup.js

@@ -18,6 +18,7 @@
  * AC: @enhanced-setup ac-9 - skills referenced by ralph (task-work, reflect) are present
  */
 import * as fs from "node:fs/promises";
+import { existsSync } from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
 import * as readline from "node:readline/promises";
@@ -41,6 +42,31 @@ function debugLog(message, detail) {
         }
     }
 }
+const SETUP_AGENT_OVERRIDES = [
+    "claude-code",
+    "cline",
+    "cursor",
+    "windsurf",
+    "unknown",
+];
+function parseSetupAgentOverride(value) {
+    const normalized = value.trim().toLowerCase();
+    if (SETUP_AGENT_OVERRIDES.includes(normalized)) {
+        return normalized;
+    }
+    const allowed = SETUP_AGENT_OVERRIDES.join(", ");
+    throw new Error(`Invalid --agent value "${value}". Supported values: ${allowed}`);
+}
+function buildDetectedAgent(type) {
+    if (type === "claude-code") {
+        return {
+            type,
+            confidence: "high",
+            configPath: path.join(os.homedir(), ".claude", "settings.json"),
+        };
+    }
+    return { type, confidence: "high" };
+}
 /**
  * Detect which agent environment we're running in.
  * Returns the detected agent type and confidence level.
@@ -48,7 +74,19 @@ function debugLog(message, detail) {
  * Detection priority matters - more specific markers checked first.
  */
 export function detectAgent() {
-    return detectAgentFromEnv();
+    const detected = detectAgentFromEnv();
+    if (detected.type !== "unknown") {
+        return detected;
+    }
+    // Fallback for non-interactive contexts where env markers may be absent.
+    if (existsSync(path.join(os.homedir(), ".claude"))) {
+        return {
+            type: "claude-code",
+            confidence: "low",
+            configPath: path.join(os.homedir(), ".claude", "settings.json"),
+        };
+    }
+    return detected;
 }
 /**
  * Install KSPEC_AUTHOR config for Claude Code (global settings)
@@ -460,8 +498,10 @@ function printManualInstructions(agentType) {
  * Check the current setup status
  * AC: @enhanced-setup ac-7, ac-8
  */
-async function getSetupStatus(projectDir) {
-    const detected = detectAgent();
+async function getSetupStatus(projectDir, agentOverride) {
+    const detected = agentOverride
+        ? buildDetectedAgent(agentOverride)
+        : detectAgent();
     const configPath = path.join(projectDir, ".claude", "settings.json");
     const hooksDir = path.join(projectDir, ".claude", "hooks");
     const agentsMdPath = path.join(projectDir, "kspec-agents.md");
@@ -721,6 +761,85 @@ async function renderSkillsForSetup(projectDir, dryRun) {
         return { rendered: 0, skipped: 0, pluginProvided: 0, skillIds: [] };
     }
 }
+/**
+ * Ensure built-in worker and reviewer agent definitions exist in the project meta.
+ *
+ * Creates task-worker and pr-reviewer agents with dispatch rules that match
+ * ralph's behavior. Skips creation if agents already exist (idempotent).
+ *
+ * AC: @ralph-replacement ac-2 — built-in worker and reviewer agent definitions
+ * created in kynetic.meta.yaml with default dispatch rules matching ralph's behavior
+ */
+async function ensureBuiltInAgents(projectDir, dryRun) {
+    const { initContext } = await import("../../parser/index.js");
+    const { loadMetaContext, saveMetaItem } = await import("../../parser/meta.js");
+    const { ulid } = await import("ulid");
+    const created = [];
+    const skipped = [];
+    try {
+        const ctx = await initContext();
+        if (!ctx.manifestPath) {
+            return { created, skipped };
+        }
+        const meta = await loadMetaContext(ctx);
+        const existingIds = new Set((meta.agents || []).map((a) => a.id));
+        // Built-in agent definitions — match ralph's dispatch behavior
+        const builtInAgents = [
+            {
+                id: "task-worker",
+                name: "Task Worker",
+                description: "Autonomous task worker. Picks up automation-eligible ready and needs_work tasks.",
+                capabilities: ["code", "test", "refactor"],
+                tools: ["kspec", "git", "npm"],
+                dispatch: [
+                    { on: "task.in_progress", filter: { automation: "eligible" } },
+                    { on: "task.ready", filter: { automation: "eligible" } },
+                    { on: "task.needs_work", filter: { automation: "eligible" } },
+                ],
+                skills: ["task-work"],
+                concurrency: { max_concurrent: 1 },
+                auto_approve: true,
+            },
+            {
+                id: "pr-reviewer",
+                name: "PR Reviewer",
+                description: "Automated PR reviewer. Reviews pending_review tasks and merges when quality gates pass.",
+                capabilities: ["review"],
+                tools: ["kspec", "git", "gh"],
+                dispatch: [{ on: "task.pending_review" }],
+                skills: ["pr-review"],
+                concurrency: { max_concurrent: 1 },
+                auto_approve: false,
+            },
+        ];
+        for (const def of builtInAgents) {
+            if (existingIds.has(def.id)) {
+                skipped.push(def.id);
+                continue;
+            }
+            if (!dryRun) {
+                await saveMetaItem(ctx, {
+                    _ulid: ulid(),
+                    id: def.id,
+                    name: def.name,
+                    description: def.description,
+                    capabilities: [...def.capabilities],
+                    tools: [...def.tools],
+                    conventions: [],
+                    dispatch: def.dispatch.map((r) => ({ ...r })),
+                    skills: [...def.skills],
+                    concurrency: { ...def.concurrency },
+                    auto_approve: def.auto_approve,
+                }, "agent");
+            }
+            created.push(def.id);
+        }
+    }
+    catch (err) {
+        debugLog("ensureBuiltInAgents failed", err);
+    }
+    return { created, skipped };
+}
 /**
  * Generate kspec-agents.md using the canonical implementation from agents.ts
  * AC: @setup-pipeline-unification ac-1 - calls generateAgentsContent() from agents.ts
@@ -895,7 +1014,9 @@ export async function runSetupPipeline(projectDir, options) {
     let permissionsSeeded = false;
     let memorySeeded = false;
     try {
-        const detected = detectAgent();
+        const detected = options.agent
+            ? buildDetectedAgent(options.agent)
+            : detectAgent();
         // Step 1: Agent detection
         steps.push({
             name: "Agent detection",
@@ -1074,6 +1195,22 @@ export async function runSetupPipeline(projectDir, options) {
                 message: "--skip-skills flag",
             });
         }
+        // Step 4b: Ensure built-in worker and reviewer agent definitions exist
+        // AC: @ralph-replacement ac-2 — built-in agents created in kynetic.meta.yaml
+        {
+            const agentsBuiltIn = await ensureBuiltInAgents(projectDir, dryRun);
+            const totalNew = agentsBuiltIn.created.length;
+            const totalSkipped = agentsBuiltIn.skipped.length;
+            if (totalNew > 0 || totalSkipped > 0) {
+                steps.push({
+                    name: "Ensure built-in agents",
+                    status: "done",
+                    message: totalNew > 0
+                        ? `created: ${agentsBuiltIn.created.join(", ")}`
+                        : `already exist: ${agentsBuiltIn.skipped.join(", ")}`,
+                });
+            }
+        }
         // Step 5: Generate kspec-agents.md
         // AC: @init-setup-integration ac-3 - kspec-agents.md present
         const agentsResult = await generateAgentInstructions(projectDir, dryRun);
@@ -1189,6 +1326,7 @@ export function registerSetupCommand(program) {
     program
         .command("setup")
         .description("Configure agent environment for kspec (orchestrated pipeline)")
+        .option("--agent <type>", "Explicit agent type override (claude-code|cline|cursor|windsurf|unknown)")
         .option("--dry-run", "Show what would be done without making changes")
         .option("--author <author>", "Custom author string (default: auto-detected based on agent)")
         .option("--no-hooks", "Skip installing hooks")
@@ -1199,9 +1337,12 @@ export function registerSetupCommand(program) {
         .action(async (options) => {
         try {
             const projectDir = process.cwd();
+            const agentOverride = options.agent
+                ? parseSetupAgentOverride(options.agent)
+                : undefined;
             // AC: @enhanced-setup ac-7, ac-8 - --status mode
             if (options.status) {
-                const status = await getSetupStatus(projectDir);
+                const status = await getSetupStatus(projectDir, agentOverride);
                 output(status, () => {
                     console.log(chalk.bold("kspec Setup Status\n"));
                     // Agent detection
@@ -1274,7 +1415,9 @@ export function registerSetupCommand(program) {
                 // User declined worktree creation or it failed
                 process.exit(EXIT_CODES.ERROR);
             }
-            const detected = detectAgent();
+            const detected = agentOverride
+                ? buildDetectedAgent(agentOverride)
+                : detectAgent();
             const dryRun = options.dryRun || false;
             if (detected.type === "unknown") {
                 warn("Could not auto-detect agent environment");
@@ -1288,6 +1431,7 @@ export function registerSetupCommand(program) {
                 skipSkills: options.skipSkills || false,
                 installHooks: options.hooks !== false,
                 force: options.force || false,
+                agent: agentOverride,
                 author: options.author,
                 configureAuthor: true,
             });