@kynetic-ai/spec 0.5.0 → 0.7.0

package/dist/cli/commands/session/commands.js

@@ -0,0 +1,259 @@
+/**
+ * Session command registration.
+ *
+ * Wires up all session sub-commands with commander. This is the thin orchestration
+ * layer that imports action handlers from sub-modules.
+ */
+import chalk from "chalk";
+import { initContext, } from "../../../parser/index.js";
+import { ShadowError, shadowPull, } from "../../../parser/shadow.js";
+import { isObject } from "../../../acp/types.js";
+import { errors, sessionPrompt, } from "../../../strings/index.js";
+import { markMutating } from "../../command-annotations.js";
+import { EXIT_CODES } from "../../exit-codes.js";
+import { error, info, isJsonMode, output, warn } from "../../output.js";
+import { performCheckpoint } from "./checkpoint.js";
+import { gatherSessionContext } from "./context.js";
+import { sessionCreateAction } from "./create.js";
+import { formatCheckpointResult, formatSessionContext } from "./format.js";
+import { sessionLogListAction, sessionLogSearchAction, sessionLogShowAction, sessionLogStatsAction, } from "./log.js";
+// ─── Debug Logging ──────────────────────────────────────────────────────────
+function debugLog(message, detail) {
+    if (process.env.KSPEC_DEBUG === "1") {
+        if (detail) {
+            console.error(`[DEBUG] session/commands: ${message}`, detail);
+        }
+        else {
+            console.error(`[DEBUG] session/commands: ${message}`);
+        }
+    }
+}
+// ─── Action Handlers ────────────────────────────────────────────────────────
+async function sessionStartAction(options) {
+    try {
+        const ctx = await initContext();
+        // AC: @shadow-sync ac-2 - Pull remote changes before showing session context
+        let syncResult = null;
+        if (ctx.shadow?.enabled) {
+            syncResult = await shadowPull(ctx.shadow.worktreeDir);
+            // AC: @shadow-sync ac-3 - Warn about conflicts but continue with local state
+            if (syncResult.hadConflict) {
+                warn("Shadow sync conflict detected. Run `kspec shadow resolve` to fix.");
+                info("Continuing with local state...");
+            }
+            else if (syncResult.pulled) {
+                info("Synced shadow branch from remote");
+            }
+        }
+        const sessionCtx = await gatherSessionContext(ctx, options);
+        output(sessionCtx, () => formatSessionContext(sessionCtx, options));
+    }
+    catch (err) {
+        error(errors.failures.gatherSessionContext, err);
+        process.exit(EXIT_CODES.ERROR);
+    }
+}
+/**
+ * Read stdin if available (non-blocking check for hook input)
+ */
+async function readStdinIfAvailable() {
+    // Check if stdin is a TTY (interactive) - if so, don't try to read
+    if (process.stdin.isTTY) {
+        return null;
+    }
+    return new Promise((resolve) => {
+        let data = "";
+        const onData = (chunk) => {
+            data += chunk;
+        };
+        const onEnd = () => {
+            clearTimeout(timeout);
+            cleanup();
+            resolve(data || null);
+        };
+        const onError = () => {
+            clearTimeout(timeout);
+            cleanup();
+            resolve(null);
+        };
+        const cleanup = () => {
+            process.stdin.removeListener("data", onData);
+            process.stdin.removeListener("end", onEnd);
+            process.stdin.removeListener("error", onError);
+        };
+        const timeout = setTimeout(() => {
+            cleanup();
+            resolve(data || null);
+        }, 100); // 100ms timeout for stdin
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", onData);
+        process.stdin.on("end", onEnd);
+        process.stdin.on("error", onError);
+        process.stdin.resume();
+    });
+}
+/**
+ * Parse Claude Code hook input from stdin.
+ * Returns null (with debug log) if input is missing, not valid JSON, or not an object.
+ */
+export function parseHookInput(stdin) {
+    if (!stdin)
+        return null;
+    try {
+        const parsed = JSON.parse(stdin.trim());
+        if (!isObject(parsed)) {
+            debugLog("parseHookInput: parsed value is not an object");
+            return null;
+        }
+        return parsed;
+    }
+    catch (err) {
+        debugLog("parseHookInput: failed to parse stdin as JSON", err);
+        return null;
+    }
+}
+/**
+ * Output spec-first reminder for UserPromptSubmit hook.
+ *
+ * This is a simple context injection - always outputs the reminder,
+ * and Claude (Opus) is smart enough to apply it when relevant.
+ */
+async function sessionPromptCheckAction() {
+    // Lean, instructive reminder with kspec prefix
+    console.log(sessionPrompt.specCheck);
+}
+async function sessionCheckpointAction(options) {
+    try {
+        // Read stdin for Claude Code hook input
+        const stdin = await readStdinIfAvailable();
+        const hookInput = parseHookInput(stdin);
+        // Check if this is a retry (stop hook already active)
+        if (hookInput?.stop_hook_active) {
+            options.stopHookActive = true;
+        }
+        const ctx = await initContext();
+        const result = await performCheckpoint(ctx, options);
+        // Output format depends on mode:
+        // - JSON mode (--json): Output Claude Code hook format {"decision": "block", "reason": "..."}
+        // - Human mode: Output formatted checkpoint result
+        if (isJsonMode()) {
+            if (!result.ok) {
+                // Build reason message with issues and instructions
+                const issueLines = result.issues
+                    .map((i) => `- ${i.description}`)
+                    .join("\n");
+                const instructionLines = result.instructions
+                    .filter((i) => i.trim())
+                    .join("\n");
+                const reason = `${result.message}\n\nIssues:\n${issueLines}\n\n${instructionLines}`;
+                console.log(JSON.stringify({ decision: "block", reason }));
+            }
+            // If ok, exit silently (Claude Code expects no output when allowing stop)
+        }
+        else {
+            formatCheckpointResult(result);
+            if (!result.ok) {
+                process.exit(EXIT_CODES.ERROR);
+            }
+        }
+    }
+    catch (err) {
+        // Handle RUNNING_FROM_SHADOW gracefully - skip with warning instead of erroring
+        // This happens when the stop hook runs while cwd is inside .kspec/ directory
+        if (err instanceof ShadowError && err.code === "RUNNING_FROM_SHADOW") {
+            if (!isJsonMode()) {
+                console.log(chalk.yellow("[kspec] Session checkpoint skipped - running from inside .kspec/ directory"));
+            }
+            // Allow stop to proceed (exit successfully, no JSON output blocks the stop)
+            return;
+        }
+        error(errors.failures.runCheckpoint, err);
+        process.exit(EXIT_CODES.ERROR);
+    }
+}
+// ─── Command Registration ───────────────────────────────────────────────────
+/**
+ * Register the 'session' command group and aliases
+ */
+export function registerSessionCommands(program) {
+    const session = program
+        .command("session")
+        .description("Session management and context");
+    // Session create subcommand
+    markMutating(session.command("create"))
+        .description("Create a new kspec session with optional budget")
+        .option("--agent-type <type>", "Agent type (e.g., claude-code, codex-cli)", "claude-code")
+        .option("--budget <n>", "Maximum tasks per cycle (positive integer)")
+        .option("--inject", "Inject KSPEC_SESSION_ID into agent environment")
+        .option("--task-id <id>", "Optional task ID being worked on")
+        .action(sessionCreateAction);
+    session
+        .command("start")
+        .alias("resume")
+        .description("Surface relevant context for starting a new working session")
+        .option("--brief", "Compact summary (default)")
+        .option("--full", "Comprehensive context dump")
+        .option("--since <time>", "Filter by recency (ISO8601 or relative: 1h, 2d, 1w)")
+        .option("--no-git", "Skip git commit information")
+        .option("-n, --limit <n>", "Limit items per section", "10")
+        .action(sessionStartAction);
+    // Session log subcommand group
+    const log = session
+        .command("log")
+        .description("Session log analysis commands");
+    log
+        .command("list")
+        .description("List session logs with summary statistics")
+        .option("-s, --status <status>", "Filter by status (active, completed, abandoned)")
+        .option("--agent <type>", "Filter by agent type")
+        .option("--since <time>", "Only show sessions started after this time (ISO8601 or relative: 1h, 2d, 1w)")
+        .option("--sort <field>", "Sort by field (started_at, duration, events, iterations, tasks_completed)", "started_at")
+        .option("--count", "Show only the count of matching sessions")
+        .option("-n, --limit <n>", "Limit number of sessions shown")
+        .action(sessionLogListAction);
+    log
+        .command("show <session-id>")
+        .description("Show detailed view of a single session")
+        .option("-e, --events", "Include chronological event timeline")
+        .option("-t, --type <type>", "Filter events by type (e.g., tool.call)")
+        .option("-n, --limit <n>", "Show only the last N events")
+        .option("-c, --context <n>", "Show context snapshot for iteration N")
+        .action(sessionLogShowAction);
+    log
+        .command("stats")
+        .description("Aggregate analytics across sessions")
+        .option("--since <time>", "Only include sessions started after this time (ISO8601 or relative: 1h, 2d, 1w)")
+        .option("--agent <type>", "Only include sessions with this agent type")
+        .option("--tool-usage", "Display top 10 tool calls by frequency")
+        .option("--by-day", "Group stats by day")
+        .option("--by-week", "Group stats by week")
+        .action(sessionLogStatsAction);
+    log
+        .command("search <pattern>")
+        .description("Search across session events by content")
+        .option("-t, --type <type>", "Only search events of this type (e.g., session.update)")
+        .option("--since <time>", "Only search sessions started after this time (ISO8601 or relative: 1h, 2d, 1w)")
+        .option("--agent <type>", "Only search sessions with this agent type")
+        .option("-n, --limit <n>", "Maximum matches to return (default: 50)")
+        .action(sessionLogSearchAction);
+    session
+        .command("checkpoint")
+        .description("Pre-stop hook: check for uncommitted work before ending session")
+        .option("--force", "Allow session end regardless of issues")
+        .action(sessionCheckpointAction);
+    session
+        .command("prompt-check")
+        .description("UserPromptSubmit hook: inject spec-first reminder")
+        .action(sessionPromptCheckAction);
+    // Top-level alias: kspec context
+    program
+        .command("context")
+        .description("Alias for session start - surface session context")
+        .option("--brief", "Compact summary (default)")
+        .option("--full", "Comprehensive context dump")
+        .option("--since <time>", "Filter by recency (ISO8601 or relative: 1h, 2d, 1w)")
+        .option("--no-git", "Skip git commit information")
+        .option("-n, --limit <n>", "Limit items per section", "10")
+        .action(sessionStartAction);
+}
+//# sourceMappingURL=commands.js.map

package/dist/cli/commands/session/commands.js.map

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

package/dist/cli/commands/session/context.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Session context data gathering.
+ *
+ * Loads and aggregates all data needed for session start output.
+ */
+import { type KspecContext } from "../../../parser/index.js";
+import type { IterationStats, SessionStartContext, SessionOptions } from "./types.js";
+/**
+ * Gather session context data
+ */
+export declare function gatherSessionContext(ctx: KspecContext, options: SessionOptions): Promise<SessionStartContext>;
+/**
+ * Get iteration stats - tasks completed/started since a given time.
+ * AC: @ralph-task-limit ac-detection
+ */
+export declare function getIterationStats(ctx: KspecContext, since: Date): Promise<IterationStats>;
+//# sourceMappingURL=context.d.ts.map

package/dist/cli/commands/session/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/session/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEL,KAAK,YAAY,EAQlB,MAAM,0BAA0B,CAAC;AAWlC,OAAO,KAAK,EAQV,cAAc,EAId,mBAAmB,EAEnB,cAAc,EAGf,MAAM,YAAY,CAAC;AAwRpB;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,mBAAmB,CAAC,CA2S9B;AAID;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE,IAAI,GACV,OAAO,CAAC,cAAc,CAAC,CA4BzB"}