@kynetic-ai/spec 0.1.0

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

@@ -0,0 +1,164 @@
+/**
+ * Session management commands
+ *
+ * Provides context for starting/resuming work sessions.
+ */
+import { Command } from 'commander';
+import { type KspecContext } from '../../parser/index.js';
+import type { SessionContext as StoredSessionContext } from '../../schema/index.js';
+import { type GitWorkingTree } from '../../utils/index.js';
+export interface CheckpointResult {
+    /** Whether session can end cleanly */
+    ok: boolean;
+    /** Human-readable message for Claude Code */
+    message: string;
+    /** Issues that need attention before stopping */
+    issues: CheckpointIssue[];
+    /** Instructions for the agent */
+    instructions: string[];
+}
+export interface CheckpointIssue {
+    type: 'uncommitted_changes' | 'in_progress_task' | 'incomplete_todo';
+    description: string;
+    details?: Record<string, unknown>;
+}
+export interface SessionContext {
+    /** When this context was generated */
+    generated_at: string;
+    /** Current git branch */
+    branch: string | null;
+    /** Session context (focus, threads, questions) */
+    context: StoredSessionContext | null;
+    /** Tasks currently in progress */
+    active_tasks: ActiveTaskSummary[];
+    /** Tasks awaiting review (code done, PR pending) */
+    pending_review_tasks: ActiveTaskSummary[];
+    /** Recent notes from active tasks */
+    recent_notes: NoteSummary[];
+    /** Incomplete todos from active tasks */
+    active_todos: TodoSummary[];
+    /** Tasks ready to be picked up */
+    ready_tasks: ReadyTaskSummary[];
+    /** Blocked tasks with blockers */
+    blocked_tasks: BlockedTaskSummary[];
+    /** Recently completed tasks */
+    recently_completed: CompletedTaskSummary[];
+    /** Recent git commits */
+    recent_commits: CommitSummary[];
+    /** Working tree status */
+    working_tree: GitWorkingTree | null;
+    /** Inbox items awaiting triage (oldest first) */
+    inbox_items: InboxSummary[];
+    /** Summary statistics */
+    stats: SessionStats;
+}
+export interface ActiveTaskSummary {
+    ref: string;
+    title: string;
+    started_at: string | null;
+    priority: number;
+    spec_ref: string | null;
+    note_count: number;
+    last_note_at: string | null;
+    todo_count: number;
+    incomplete_todos: number;
+}
+export interface NoteSummary {
+    task_ref: string;
+    task_title: string;
+    note_ulid: string;
+    created_at: string;
+    author: string | null;
+    content: string;
+}
+export interface TodoSummary {
+    task_ref: string;
+    task_title: string;
+    id: number;
+    text: string;
+    added_at: string;
+    added_by: string | null;
+}
+export interface ReadyTaskSummary {
+    ref: string;
+    title: string;
+    priority: number;
+    spec_ref: string | null;
+    tags: string[];
+}
+export interface BlockedTaskSummary {
+    ref: string;
+    title: string;
+    blocked_by: string[];
+    unmet_deps: string[];
+}
+export interface CompletedTaskSummary {
+    ref: string;
+    title: string;
+    completed_at: string;
+    closed_reason: string | null;
+    origin?: 'manual' | 'derived' | 'observation_promotion';
+}
+export interface CommitSummary {
+    hash: string;
+    full_hash: string;
+    date: string;
+    message: string;
+    author: string;
+}
+export interface SessionStats {
+    total_tasks: number;
+    in_progress: number;
+    pending_review: number;
+    ready: number;
+    blocked: number;
+    completed: number;
+    inbox_items: number;
+}
+export interface InboxSummary {
+    ref: string;
+    text: string;
+    created_at: string;
+    tags: string[];
+    added_by: string | null;
+}
+export interface SessionOptions {
+    brief?: boolean;
+    full?: boolean;
+    since?: string;
+    git?: boolean;
+    limit?: string;
+    eligible?: boolean;
+}
+/**
+ * Gather session context data
+ */
+export declare function gatherSessionContext(ctx: KspecContext, options: SessionOptions): Promise<SessionContext>;
+export interface CheckpointOptions {
+    force?: boolean;
+    /** Set when stop hook is already active (retry after previous block) */
+    stopHookActive?: boolean;
+}
+/** Claude Code hook input for Stop hooks */
+export interface StopHookInput {
+    session_id?: string;
+    transcript_path?: string;
+    hook_event_name?: string;
+    stop_hook_active?: boolean;
+}
+/**
+ * Perform session checkpoint - check for uncommitted work before ending session.
+ *
+ * This is designed for use as a Claude Code stop hook. It checks for:
+ * - Uncommitted git changes (staged, unstaged, untracked)
+ * - Tasks in in_progress status
+ * - Incomplete todos on active tasks
+ *
+ * Returns a structured result indicating whether the session can end cleanly.
+ */
+export declare function performCheckpoint(ctx: KspecContext, options: CheckpointOptions): Promise<CheckpointResult>;
+/**
+ * Register the 'session' command group and aliases
+ */
+export declare function registerSessionCommands(program: Command): void;
+//# sourceMappingURL=session.d.ts.map

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

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