@kynetic-ai/spec 0.1.0

package/dist/schema/task.js

@@ -0,0 +1,130 @@
+import { z } from 'zod';
+import { UlidSchema, SlugSchema, RefSchema, DateTimeSchema, TaskStatusSchema, TaskTypeSchema, VcsRefSchema, } from './common.js';
+/**
+ * Automation eligibility status for tasks
+ * AC: @task-automation-eligibility ac-1
+ * - eligible: Task can be processed by automation loops
+ * - needs_review: Task was rejected by automation and needs human review
+ * - manual_only: Task should only be handled by humans
+ * - undefined/absent: Task has not been assessed for automation (unassessed)
+ */
+export const AutomationStatusSchema = z.enum(['eligible', 'needs_review', 'manual_only']);
+/**
+ * Note entry - append-only work log
+ */
+export const NoteSchema = z.object({
+    _ulid: UlidSchema,
+    created_at: DateTimeSchema,
+    author: z.string().optional(),
+    content: z.string(),
+    supersedes: UlidSchema.nullable().optional(),
+});
+/**
+ * Todo item - lightweight checklist
+ */
+export const TodoSchema = z.object({
+    id: z.number().int().positive(),
+    text: z.string(),
+    done: z.boolean().default(false),
+    done_at: DateTimeSchema.optional(),
+    added_at: DateTimeSchema,
+    added_by: z.string().optional(),
+    promoted_to: RefSchema.optional(),
+});
+/**
+ * Full task schema
+ * Note: created_at defaults to now if not provided (auto-populated on load)
+ */
+export const TaskSchema = z.object({
+    // Identity
+    _ulid: UlidSchema,
+    slugs: z.array(SlugSchema).default([]),
+    title: z.string().min(1, 'Title is required'),
+    type: TaskTypeSchema.default('task'),
+    // Content (doesn't duplicate spec - brief description for standalone context)
+    description: z.string().optional(),
+    // Spec relationship
+    spec_ref: RefSchema.nullable().optional(),
+    derivation: z.enum(['auto', 'manual']).optional(),
+    // Meta relationship (links to workflow, agent, or convention for process improvement tracking)
+    meta_ref: RefSchema.nullable().optional(),
+    // Origin tracking (where this task came from)
+    origin: z.enum(['manual', 'derived', 'observation_promotion']).optional(),
+    // State
+    status: TaskStatusSchema.default('pending'),
+    blocked_by: z.array(z.string()).default([]),
+    closed_reason: z.string().nullable().optional(),
+    // Dependencies
+    depends_on: z.array(RefSchema).default([]),
+    context: z.array(RefSchema).default([]),
+    // Work metadata
+    priority: z.number().int().min(1).max(5).default(3),
+    complexity: z.number().int().min(1).max(5).optional(),
+    tags: z.array(z.string()).default([]),
+    assignee: z.string().nullable().optional(),
+    // VCS references
+    vcs_refs: z.array(VcsRefSchema).default([]),
+    // Timestamps (auto-populated if not provided)
+    created_at: DateTimeSchema.default(() => new Date().toISOString()),
+    started_at: DateTimeSchema.nullable().optional(),
+    completed_at: DateTimeSchema.nullable().optional(),
+    // Notes (work log)
+    notes: z.array(NoteSchema).default([]),
+    // Todos (emergent subtasks)
+    todos: z.array(TodoSchema).default([]),
+    // Automation eligibility (AC: @task-automation-eligibility ac-1, ac-2)
+    // Optional - absent means unassessed
+    automation: AutomationStatusSchema.optional(),
+});
+/**
+ * Task input schema (for creating new tasks, some fields auto-generated)
+ * All fields except title are optional - defaults will be applied
+ */
+export const TaskInputSchema = z.object({
+    // Identity (auto-generated if not provided)
+    _ulid: UlidSchema.optional(),
+    slugs: z.array(SlugSchema).optional(),
+    title: z.string().min(1, 'Title is required'),
+    type: TaskTypeSchema.optional(),
+    // Content
+    description: z.string().optional(),
+    // Spec relationship
+    spec_ref: RefSchema.nullable().optional(),
+    derivation: z.enum(['auto', 'manual']).optional(),
+    // Meta relationship
+    meta_ref: RefSchema.nullable().optional(),
+    // Origin tracking
+    origin: z.enum(['manual', 'derived', 'observation_promotion']).optional(),
+    // State
+    status: TaskStatusSchema.optional(),
+    blocked_by: z.array(z.string()).optional(),
+    closed_reason: z.string().nullable().optional(),
+    // Dependencies
+    depends_on: z.array(RefSchema).optional(),
+    context: z.array(RefSchema).optional(),
+    // Work metadata
+    priority: z.number().int().min(1).max(5).optional(),
+    complexity: z.number().int().min(1).max(5).optional(),
+    tags: z.array(z.string()).optional(),
+    assignee: z.string().nullable().optional(),
+    // VCS references
+    vcs_refs: z.array(VcsRefSchema).optional(),
+    // Timestamps
+    created_at: DateTimeSchema.optional(),
+    started_at: DateTimeSchema.nullable().optional(),
+    completed_at: DateTimeSchema.nullable().optional(),
+    // Notes (work log)
+    notes: z.array(NoteSchema).optional(),
+    // Todos (emergent subtasks)
+    todos: z.array(TodoSchema).optional(),
+    // Automation eligibility (AC: @task-automation-eligibility ac-1, ac-2, ac-13)
+    automation: AutomationStatusSchema.optional(),
+});
+/**
+ * Tasks file schema (collection of tasks)
+ */
+export const TasksFileSchema = z.object({
+    kynetic_tasks: z.string().default('1.0'),
+    tasks: z.array(TaskSchema),
+});
+//# sourceMappingURL=task.js.map

package/dist/schema/task.js.map

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

package/dist/sessions/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Session event storage module.
+ *
+ * Provides JSONL-based event storage for agent sessions with:
+ * - Append-only event logs for auditability
+ * - Session metadata tracking
+ * - Integration with kspec commit boundaries
+ */
+export * from './types.js';
+export * from './store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/sessions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sessions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,YAAY,CAAC;AAG3B,cAAc,YAAY,CAAC"}

package/dist/sessions/index.js

@@ -0,0 +1,13 @@
+/**
+ * Session event storage module.
+ *
+ * Provides JSONL-based event storage for agent sessions with:
+ * - Append-only event logs for auditability
+ * - Session metadata tracking
+ * - Integration with kspec commit boundaries
+ */
+// Re-export types
+export * from './types.js';
+// Re-export storage functions
+export * from './store.js';
+//# sourceMappingURL=index.js.map

package/dist/sessions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sessions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,kBAAkB;AAClB,cAAc,YAAY,CAAC;AAE3B,8BAA8B;AAC9B,cAAc,YAAY,CAAC"}

package/dist/sessions/store.d.ts

@@ -0,0 +1,144 @@
+/**
+ * Session event storage.
+ *
+ * JSONL-based event storage for agent sessions with:
+ * - Atomic appends for crash safety (AC-3)
+ * - Auto-assigned timestamps and sequence numbers (AC-2)
+ * - Session metadata management
+ *
+ * Storage structure:
+ *   .kspec/sessions/{session-id}/
+ *     session.yaml      # Metadata
+ *     events.jsonl      # Append-only event log
+ */
+import { type SessionMetadata, type SessionMetadataInput, type SessionEvent, type SessionEventInput, type SessionStatus } from './types.js';
+/**
+ * Get the sessions directory path within a spec directory.
+ */
+export declare function getSessionsDir(specDir: string): string;
+/**
+ * Get the path to a specific session's directory.
+ */
+export declare function getSessionDir(specDir: string, sessionId: string): string;
+/**
+ * Get the path to a session's metadata file.
+ */
+export declare function getSessionMetadataPath(specDir: string, sessionId: string): string;
+/**
+ * Get the path to a session's events file.
+ */
+export declare function getSessionEventsPath(specDir: string, sessionId: string): string;
+/**
+ * Get the path to a session's context snapshot file for a given iteration.
+ */
+export declare function getSessionContextPath(specDir: string, sessionId: string, iteration: number): string;
+/**
+ * Create a new session with metadata.
+ *
+ * AC-1: Creates .kspec/sessions/{id}/ directory with session.yaml metadata file.
+ * AC-5: Metadata includes task_id (optional), agent_type, status, started_at, ended_at.
+ *
+ * @param specDir - The .kspec directory path
+ * @param input - Session metadata input
+ * @returns The created session metadata
+ */
+export declare function createSession(specDir: string, input: SessionMetadataInput): Promise<SessionMetadata>;
+/**
+ * Read session metadata.
+ *
+ * @param specDir - The .kspec directory path
+ * @param sessionId - Session ID
+ * @returns Session metadata or null if not found
+ */
+export declare function getSession(specDir: string, sessionId: string): Promise<SessionMetadata | null>;
+/**
+ * Update session status.
+ *
+ * AC-6: Updates metadata with status and ended_at timestamp when session ends.
+ *
+ * @param specDir - The .kspec directory path
+ * @param sessionId - Session ID
+ * @param status - New status
+ * @returns Updated metadata or null if session not found
+ */
+export declare function updateSessionStatus(specDir: string, sessionId: string, status: SessionStatus): Promise<SessionMetadata | null>;
+/**
+ * List all sessions.
+ *
+ * @param specDir - The .kspec directory path
+ * @returns Array of session IDs
+ */
+export declare function listSessions(specDir: string): Promise<string[]>;
+/**
+ * Check if a session exists.
+ */
+export declare function sessionExists(specDir: string, sessionId: string): Promise<boolean>;
+/**
+ * Append an event to a session's event log.
+ *
+ * AC-2: Appends JSON line to events.jsonl with auto-assigned ts and seq.
+ * AC-3: Uses atomic append (appendFileSync) for crash safety.
+ *
+ * Creates the session directory if it doesn't exist (lazy creation).
+ *
+ * Note: This function is not safe for concurrent access to the same session.
+ * The sequence number assignment has a race condition between reading the
+ * event count and appending the event. This is acceptable for CLI use
+ * (single-process, sequential event logging). If concurrent access is needed
+ * in the future, consider file locking or an in-memory counter per session.
+ *
+ * @param specDir - The .kspec directory path
+ * @param input - Event input (ts and seq are auto-assigned if not provided)
+ * @returns The appended event with auto-assigned fields
+ */
+export declare function appendEvent(specDir: string, input: SessionEventInput): Promise<SessionEvent>;
+/**
+ * Read all events from a session.
+ *
+ * AC-4: Returns all events in sequence order.
+ *
+ * @param specDir - The .kspec directory path
+ * @param sessionId - Session ID
+ * @returns Array of events sorted by sequence number
+ */
+export declare function readEvents(specDir: string, sessionId: string): Promise<SessionEvent[]>;
+/**
+ * Read events within a time range.
+ *
+ * @param specDir - The .kspec directory path
+ * @param sessionId - Session ID
+ * @param since - Start timestamp (inclusive)
+ * @param until - End timestamp (inclusive)
+ * @returns Array of events within the time range
+ */
+export declare function readEventsSince(specDir: string, sessionId: string, since: number, until?: number): Promise<SessionEvent[]>;
+/**
+ * Get the last event in a session.
+ *
+ * @param specDir - The .kspec directory path
+ * @param sessionId - Session ID
+ * @returns The last event or null if no events
+ */
+export declare function getLastEvent(specDir: string, sessionId: string): Promise<SessionEvent | null>;
+/**
+ * Save session context snapshot for a given iteration.
+ *
+ * This creates an audit trail of what context the agent saw at each iteration,
+ * useful for debugging and reviewing agent behavior.
+ *
+ * @param specDir - The .kspec directory path
+ * @param sessionId - Session ID
+ * @param iteration - Iteration number
+ * @param context - The session context data
+ */
+export declare function saveSessionContext(specDir: string, sessionId: string, iteration: number, context: unknown): Promise<void>;
+/**
+ * Read session context snapshot for a given iteration.
+ *
+ * @param specDir - The .kspec directory path
+ * @param sessionId - Session ID
+ * @param iteration - Iteration number
+ * @returns The context snapshot or null if not found
+ */
+export declare function readSessionContext(specDir: string, sessionId: string, iteration: number): Promise<unknown | null>;
+//# sourceMappingURL=store.d.ts.map

package/dist/sessions/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/sessions/store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EACnB,MAAM,YAAY,CAAC;AAUpB;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAExE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEnG;AAID;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAuB1B;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAUjC;AAED;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAkBjC;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAWrE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQxF;AAuBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,YAAY,CAAC,CA6BvB;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,EAAE,CAAC,CAuBzB;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,EAAE,CAAC,CAOzB;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAM9B;AAID;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CASzB"}

package/dist/sessions/store.js

@@ -0,0 +1,325 @@
+/**
+ * Session event storage.
+ *
+ * JSONL-based event storage for agent sessions with:
+ * - Atomic appends for crash safety (AC-3)
+ * - Auto-assigned timestamps and sequence numbers (AC-2)
+ * - Session metadata management
+ *
+ * Storage structure:
+ *   .kspec/sessions/{session-id}/
+ *     session.yaml      # Metadata
+ *     events.jsonl      # Append-only event log
+ */
+import * as fs from 'node:fs';
+import * as fsPromises from 'node:fs/promises';
+import * as path from 'node:path';
+import * as YAML from 'yaml';
+import { SessionMetadataSchema, SessionEventSchema, } from './types.js';
+// ─── Constants ───────────────────────────────────────────────────────────────
+const SESSIONS_DIR = 'sessions';
+const METADATA_FILE = 'session.yaml';
+const EVENTS_FILE = 'events.jsonl';
+// ─── Path Helpers ────────────────────────────────────────────────────────────
+/**
+ * Get the sessions directory path within a spec directory.
+ */
+export function getSessionsDir(specDir) {
+    return path.join(specDir, SESSIONS_DIR);
+}
+/**
+ * Get the path to a specific session's directory.
+ */
+export function getSessionDir(specDir, sessionId) {
+    return path.join(getSessionsDir(specDir), sessionId);
+}
+/**
+ * Get the path to a session's metadata file.
+ */
+export function getSessionMetadataPath(specDir, sessionId) {
+    return path.join(getSessionDir(specDir, sessionId), METADATA_FILE);
+}
+/**
+ * Get the path to a session's events file.
+ */
+export function getSessionEventsPath(specDir, sessionId) {
+    return path.join(getSessionDir(specDir, sessionId), EVENTS_FILE);
+}
+/**
+ * Get the path to a session's context snapshot file for a given iteration.
+ */
+export function getSessionContextPath(specDir, sessionId, iteration) {
+    return path.join(getSessionDir(specDir, sessionId), `context-iter-${iteration}.json`);
+}
+// ─── Session CRUD ────────────────────────────────────────────────────────────
+/**
+ * Create a new session with metadata.
+ *
+ * AC-1: Creates .kspec/sessions/{id}/ directory with session.yaml metadata file.
+ * AC-5: Metadata includes task_id (optional), agent_type, status, started_at, ended_at.
+ *
+ * @param specDir - The .kspec directory path
+ * @param input - Session metadata input
+ * @returns The created session metadata
+ */
+export async function createSession(specDir, input) {
+    const sessionDir = getSessionDir(specDir, input.id);
+    const metadataPath = getSessionMetadataPath(specDir, input.id);
+    // Create session directory
+    await fsPromises.mkdir(sessionDir, { recursive: true });
+    // Build full metadata
+    const metadata = {
+        id: input.id,
+        task_id: input.task_id,
+        agent_type: input.agent_type,
+        status: input.status ?? 'active',
+        started_at: input.started_at ?? new Date().toISOString(),
+        ended_at: undefined,
+    };
+    // Validate and write metadata
+    const validated = SessionMetadataSchema.parse(metadata);
+    const content = YAML.stringify(validated, { indent: 2, lineWidth: 100, sortMapEntries: false });
+    await fsPromises.writeFile(metadataPath, content, 'utf-8');
+    return validated;
+}
+/**
+ * Read session metadata.
+ *
+ * @param specDir - The .kspec directory path
+ * @param sessionId - Session ID
+ * @returns Session metadata or null if not found
+ */
+export async function getSession(specDir, sessionId) {
+    const metadataPath = getSessionMetadataPath(specDir, sessionId);
+    try {
+        const content = await fsPromises.readFile(metadataPath, 'utf-8');
+        const raw = YAML.parse(content);
+        return SessionMetadataSchema.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Update session status.
+ *
+ * AC-6: Updates metadata with status and ended_at timestamp when session ends.
+ *
+ * @param specDir - The .kspec directory path
+ * @param sessionId - Session ID
+ * @param status - New status
+ * @returns Updated metadata or null if session not found
+ */
+export async function updateSessionStatus(specDir, sessionId, status) {
+    const metadata = await getSession(specDir, sessionId);
+    if (!metadata) {
+        return null;
+    }
+    // Update status and ended_at if transitioning away from active
+    const updated = {
+        ...metadata,
+        status,
+        ended_at: status !== 'active' ? new Date().toISOString() : metadata.ended_at,
+    };
+    const metadataPath = getSessionMetadataPath(specDir, sessionId);
+    const content = YAML.stringify(updated, { indent: 2, lineWidth: 100, sortMapEntries: false });
+    await fsPromises.writeFile(metadataPath, content, 'utf-8');
+    return updated;
+}
+/**
+ * List all sessions.
+ *
+ * @param specDir - The .kspec directory path
+ * @returns Array of session IDs
+ */
+export async function listSessions(specDir) {
+    const sessionsDir = getSessionsDir(specDir);
+    try {
+        const entries = await fsPromises.readdir(sessionsDir, { withFileTypes: true });
+        return entries
+            .filter(e => e.isDirectory())
+            .map(e => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Check if a session exists.
+ */
+export async function sessionExists(specDir, sessionId) {
+    const metadataPath = getSessionMetadataPath(specDir, sessionId);
+    try {
+        await fsPromises.access(metadataPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ─── Event Storage ───────────────────────────────────────────────────────────
+/**
+ * Get the current event count for a session (for seq assignment).
+ *
+ * @param specDir - The .kspec directory path
+ * @param sessionId - Session ID
+ * @returns Number of events in the session
+ */
+async function getEventCount(specDir, sessionId) {
+    const eventsPath = getSessionEventsPath(specDir, sessionId);
+    try {
+        const content = await fsPromises.readFile(eventsPath, 'utf-8');
+        const lines = content.trim().split('\n').filter(line => line.length > 0);
+        return lines.length;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Append an event to a session's event log.
+ *
+ * AC-2: Appends JSON line to events.jsonl with auto-assigned ts and seq.
+ * AC-3: Uses atomic append (appendFileSync) for crash safety.
+ *
+ * Creates the session directory if it doesn't exist (lazy creation).
+ *
+ * Note: This function is not safe for concurrent access to the same session.
+ * The sequence number assignment has a race condition between reading the
+ * event count and appending the event. This is acceptable for CLI use
+ * (single-process, sequential event logging). If concurrent access is needed
+ * in the future, consider file locking or an in-memory counter per session.
+ *
+ * @param specDir - The .kspec directory path
+ * @param input - Event input (ts and seq are auto-assigned if not provided)
+ * @returns The appended event with auto-assigned fields
+ */
+export async function appendEvent(specDir, input) {
+    const sessionDir = getSessionDir(specDir, input.session_id);
+    const eventsPath = getSessionEventsPath(specDir, input.session_id);
+    // Ensure session directory exists (lazy creation)
+    await fsPromises.mkdir(sessionDir, { recursive: true });
+    // Get current event count for seq assignment
+    const seq = input.seq ?? await getEventCount(specDir, input.session_id);
+    // Build full event
+    const event = {
+        ts: input.ts ?? Date.now(),
+        seq,
+        type: input.type,
+        session_id: input.session_id,
+        trace_id: input.trace_id,
+        data: input.data,
+    };
+    // Validate event
+    const validated = SessionEventSchema.parse(event);
+    // AC-3: Use synchronous append for crash safety
+    // This ensures the line is fully written before returning
+    const line = JSON.stringify(validated) + '\n';
+    fs.appendFileSync(eventsPath, line, 'utf-8');
+    return validated;
+}
+/**
+ * Read all events from a session.
+ *
+ * AC-4: Returns all events in sequence order.
+ *
+ * @param specDir - The .kspec directory path
+ * @param sessionId - Session ID
+ * @returns Array of events sorted by sequence number
+ */
+export async function readEvents(specDir, sessionId) {
+    const eventsPath = getSessionEventsPath(specDir, sessionId);
+    try {
+        const content = await fsPromises.readFile(eventsPath, 'utf-8');
+        const lines = content.trim().split('\n').filter(line => line.length > 0);
+        const events = [];
+        for (const line of lines) {
+            try {
+                const raw = JSON.parse(line);
+                const event = SessionEventSchema.parse(raw);
+                events.push(event);
+            }
+            catch {
+                // Skip invalid lines
+            }
+        }
+        // AC-4: Sort by sequence number
+        return events.sort((a, b) => a.seq - b.seq);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Read events within a time range.
+ *
+ * @param specDir - The .kspec directory path
+ * @param sessionId - Session ID
+ * @param since - Start timestamp (inclusive)
+ * @param until - End timestamp (inclusive)
+ * @returns Array of events within the time range
+ */
+export async function readEventsSince(specDir, sessionId, since, until) {
+    const events = await readEvents(specDir, sessionId);
+    return events.filter(e => {
+        if (e.ts < since)
+            return false;
+        if (until !== undefined && e.ts > until)
+            return false;
+        return true;
+    });
+}
+/**
+ * Get the last event in a session.
+ *
+ * @param specDir - The .kspec directory path
+ * @param sessionId - Session ID
+ * @returns The last event or null if no events
+ */
+export async function getLastEvent(specDir, sessionId) {
+    const events = await readEvents(specDir, sessionId);
+    if (events.length === 0) {
+        return null;
+    }
+    return events[events.length - 1];
+}
+// ─── Context Snapshots ───────────────────────────────────────────────────────
+/**
+ * Save session context snapshot for a given iteration.
+ *
+ * This creates an audit trail of what context the agent saw at each iteration,
+ * useful for debugging and reviewing agent behavior.
+ *
+ * @param specDir - The .kspec directory path
+ * @param sessionId - Session ID
+ * @param iteration - Iteration number
+ * @param context - The session context data
+ */
+export async function saveSessionContext(specDir, sessionId, iteration, context) {
+    const sessionDir = getSessionDir(specDir, sessionId);
+    const contextPath = getSessionContextPath(specDir, sessionId, iteration);
+    // Ensure session directory exists
+    await fsPromises.mkdir(sessionDir, { recursive: true });
+    // Write context snapshot as pretty JSON
+    const content = JSON.stringify(context, null, 2);
+    await fsPromises.writeFile(contextPath, content, 'utf-8');
+}
+/**
+ * Read session context snapshot for a given iteration.
+ *
+ * @param specDir - The .kspec directory path
+ * @param sessionId - Session ID
+ * @param iteration - Iteration number
+ * @returns The context snapshot or null if not found
+ */
+export async function readSessionContext(specDir, sessionId, iteration) {
+    const contextPath = getSessionContextPath(specDir, sessionId, iteration);
+    try {
+        const content = await fsPromises.readFile(contextPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/sessions/store.js.map

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