@sudocode-ai/types 0.1.0

package/README.md

@@ -0,0 +1,13 @@
+# @sudocode/types
+
+TypeScript type definitions for [sudocode](https://github.com/sudocode-ai/sudocode) - Git-native spec and issue management for AI-assisted software development.
+
+## Overview
+
+This package provides shared TypeScript types used across all sudocode packages. It includes type definitions for specs, issues, relationships, feedback, events, and JSONL interchange formats.
+
+## Installation
+
+```bash
+npm install @sudocode/types
+```

package/dist/schema.d.ts

@@ -0,0 +1,45 @@
+/**
+ * SQLite schema definition for sudocode
+ * Shared between CLI and server packages
+ */
+export declare const SCHEMA_VERSION = "1.0";
+/**
+ * Database configuration SQL
+ */
+export declare const DB_CONFIG = "\n-- Enable WAL mode for better concurrency\nPRAGMA journal_mode=WAL;\n\n-- Enforce foreign keys\nPRAGMA foreign_keys=ON;\n\n-- Optimize for performance\nPRAGMA synchronous=NORMAL;\nPRAGMA temp_store=MEMORY;\nPRAGMA mmap_size=30000000000;\nPRAGMA page_size=4096;\nPRAGMA cache_size=10000;\n";
+/**
+ * Core table schemas
+ */
+export declare const SPECS_TABLE = "\nCREATE TABLE IF NOT EXISTS specs (\n    id TEXT PRIMARY KEY,\n    uuid TEXT NOT NULL UNIQUE,\n    title TEXT NOT NULL CHECK(length(title) <= 500),\n    file_path TEXT NOT NULL,\n    content TEXT NOT NULL DEFAULT '',\n    priority INTEGER NOT NULL DEFAULT 2 CHECK(priority >= 0 AND priority <= 4),\n    archived INTEGER NOT NULL DEFAULT 0 CHECK(archived IN (0, 1)),\n    archived_at DATETIME,\n    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    parent_id TEXT,\n    parent_uuid TEXT,\n    FOREIGN KEY (parent_id) REFERENCES specs(id) ON DELETE SET NULL,\n    FOREIGN KEY (parent_uuid) REFERENCES specs(uuid) ON DELETE SET NULL\n);\n";
+export declare const ISSUES_TABLE = "\nCREATE TABLE IF NOT EXISTS issues (\n    id TEXT PRIMARY KEY,\n    uuid TEXT NOT NULL UNIQUE,\n    title TEXT NOT NULL CHECK(length(title) <= 500),\n    content TEXT NOT NULL DEFAULT '',\n    status TEXT NOT NULL DEFAULT 'open',\n    priority INTEGER NOT NULL DEFAULT 2 CHECK(priority >= 0 AND priority <= 4),\n    assignee TEXT,\n    archived INTEGER NOT NULL DEFAULT 0 CHECK(archived IN (0, 1)),\n    archived_at DATETIME,\n    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    closed_at DATETIME,\n    parent_id TEXT,\n    parent_uuid TEXT,\n    FOREIGN KEY (parent_id) REFERENCES issues(id) ON DELETE SET NULL,\n    FOREIGN KEY (parent_uuid) REFERENCES issues(uuid) ON DELETE SET NULL\n);\n";
+export declare const RELATIONSHIPS_TABLE = "\nCREATE TABLE IF NOT EXISTS relationships (\n    from_id TEXT NOT NULL,\n    from_uuid TEXT NOT NULL,\n    from_type TEXT NOT NULL,\n    to_id TEXT NOT NULL,\n    to_uuid TEXT NOT NULL,\n    to_type TEXT NOT NULL,\n    relationship_type TEXT NOT NULL,\n    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    metadata TEXT,\n    PRIMARY KEY (from_id, from_type, to_id, to_type, relationship_type)\n);\n";
+export declare const TAGS_TABLE = "\nCREATE TABLE IF NOT EXISTS tags (\n    entity_id TEXT NOT NULL,\n    entity_uuid TEXT NOT NULL,\n    entity_type TEXT NOT NULL,\n    tag TEXT NOT NULL,\n    PRIMARY KEY (entity_id, entity_type, tag)\n);\n";
+export declare const EVENTS_TABLE = "\nCREATE TABLE IF NOT EXISTS events (\n    id INTEGER PRIMARY KEY AUTOINCREMENT,\n    entity_id TEXT NOT NULL,\n    entity_uuid TEXT NOT NULL,\n    entity_type TEXT NOT NULL,\n    event_type TEXT NOT NULL,\n    actor TEXT NOT NULL,\n    old_value TEXT,\n    new_value TEXT,\n    comment TEXT,\n    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    git_commit_sha TEXT,\n    source TEXT\n);\n";
+export declare const ISSUE_FEEDBACK_TABLE = "\nCREATE TABLE IF NOT EXISTS issue_feedback (\n    id TEXT PRIMARY KEY,\n    issue_id TEXT NOT NULL,\n    issue_uuid TEXT NOT NULL,\n    spec_id TEXT NOT NULL,\n    spec_uuid TEXT NOT NULL,\n    feedback_type TEXT NOT NULL CHECK(feedback_type IN ('comment', 'suggestion', 'request')),\n    content TEXT NOT NULL,\n    agent TEXT,\n    anchor TEXT,\n    dismissed INTEGER NOT NULL DEFAULT 0 CHECK(dismissed IN (0, 1)),\n    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    FOREIGN KEY (issue_id) REFERENCES issues(id) ON DELETE CASCADE,\n    FOREIGN KEY (issue_uuid) REFERENCES issues(uuid) ON DELETE CASCADE,\n    FOREIGN KEY (spec_id) REFERENCES specs(id) ON DELETE CASCADE,\n    FOREIGN KEY (spec_uuid) REFERENCES specs(uuid) ON DELETE CASCADE\n);\n";
+export declare const EXECUTIONS_TABLE = "\nCREATE TABLE IF NOT EXISTS executions (\n    id TEXT PRIMARY KEY,\n    issue_id TEXT,\n    issue_uuid TEXT,\n\n    -- Execution mode and configuration\n    mode TEXT CHECK(mode IN ('worktree', 'local')),\n    prompt TEXT,\n    config TEXT,\n\n    -- Process information (legacy + new)\n    agent_type TEXT CHECK(agent_type IN ('claude-code', 'codex')),\n    session_id TEXT,\n    workflow_execution_id TEXT,\n\n    -- Git/branch information\n    target_branch TEXT NOT NULL,\n    branch_name TEXT NOT NULL,\n    before_commit TEXT,\n    after_commit TEXT,\n    worktree_path TEXT,\n\n    -- Status (unified - supports both old and new statuses)\n    status TEXT NOT NULL CHECK(status IN (\n        'preparing', 'pending', 'running', 'paused',\n        'completed', 'failed', 'cancelled', 'stopped'\n    )),\n\n    -- Timing (consistent with other tables)\n    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    started_at DATETIME,\n    completed_at DATETIME,\n    cancelled_at DATETIME,\n\n    -- Results and metadata\n    exit_code INTEGER,\n    error_message TEXT,\n    error TEXT,\n    model TEXT,\n    summary TEXT,\n    files_changed TEXT,\n\n    -- Relationships\n    parent_execution_id TEXT,\n\n    -- Multi-step workflow support (future extension)\n    step_type TEXT,\n    step_index INTEGER,\n    step_config TEXT,\n\n    FOREIGN KEY (issue_id) REFERENCES issues(id) ON DELETE SET NULL,\n    FOREIGN KEY (issue_uuid) REFERENCES issues(uuid) ON DELETE SET NULL,\n    FOREIGN KEY (parent_execution_id) REFERENCES executions(id) ON DELETE SET NULL\n);\n";
+export declare const PROMPT_TEMPLATES_TABLE = "\nCREATE TABLE IF NOT EXISTS prompt_templates (\n    id TEXT PRIMARY KEY,\n    name TEXT NOT NULL,\n    description TEXT,\n    type TEXT NOT NULL CHECK(type IN ('issue', 'spec', 'custom')),\n    template TEXT NOT NULL,\n    variables TEXT NOT NULL,\n    is_default INTEGER NOT NULL DEFAULT 0 CHECK(is_default IN (0, 1)),\n    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP\n);\n";
+export declare const EXECUTION_LOGS_TABLE = "\nCREATE TABLE IF NOT EXISTS execution_logs (\n    execution_id TEXT PRIMARY KEY,\n    logs TEXT NOT NULL DEFAULT '',\n    byte_size INTEGER NOT NULL DEFAULT 0,\n    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,\n    FOREIGN KEY (execution_id) REFERENCES executions(id) ON DELETE CASCADE\n);\n";
+/**
+ * Index definitions
+ */
+export declare const SPECS_INDEXES = "\nCREATE INDEX IF NOT EXISTS idx_specs_uuid ON specs(uuid);\nCREATE INDEX IF NOT EXISTS idx_specs_priority ON specs(priority);\nCREATE INDEX IF NOT EXISTS idx_specs_parent_id ON specs(parent_id);\nCREATE INDEX IF NOT EXISTS idx_specs_parent_uuid ON specs(parent_uuid);\nCREATE INDEX IF NOT EXISTS idx_specs_archived ON specs(archived);\nCREATE INDEX IF NOT EXISTS idx_specs_created_at ON specs(created_at);\nCREATE INDEX IF NOT EXISTS idx_specs_updated_at ON specs(updated_at);\n";
+export declare const ISSUES_INDEXES = "\nCREATE INDEX IF NOT EXISTS idx_issues_uuid ON issues(uuid);\nCREATE INDEX IF NOT EXISTS idx_issues_status ON issues(status);\nCREATE INDEX IF NOT EXISTS idx_issues_priority ON issues(priority);\nCREATE INDEX IF NOT EXISTS idx_issues_assignee ON issues(assignee);\nCREATE INDEX IF NOT EXISTS idx_issues_parent_id ON issues(parent_id);\nCREATE INDEX IF NOT EXISTS idx_issues_parent_uuid ON issues(parent_uuid);\nCREATE INDEX IF NOT EXISTS idx_issues_archived ON issues(archived);\nCREATE INDEX IF NOT EXISTS idx_issues_created_at ON issues(created_at);\nCREATE INDEX IF NOT EXISTS idx_issues_updated_at ON issues(updated_at);\nCREATE INDEX IF NOT EXISTS idx_issues_closed_at ON issues(closed_at);\n";
+export declare const RELATIONSHIPS_INDEXES = "\nCREATE INDEX IF NOT EXISTS idx_rel_from_id ON relationships(from_id, from_type);\nCREATE INDEX IF NOT EXISTS idx_rel_from_uuid ON relationships(from_uuid, from_type);\nCREATE INDEX IF NOT EXISTS idx_rel_to_id ON relationships(to_id, to_type);\nCREATE INDEX IF NOT EXISTS idx_rel_to_uuid ON relationships(to_uuid, to_type);\nCREATE INDEX IF NOT EXISTS idx_rel_type ON relationships(relationship_type);\nCREATE INDEX IF NOT EXISTS idx_rel_created_at ON relationships(created_at);\n";
+export declare const TAGS_INDEXES = "\nCREATE INDEX IF NOT EXISTS idx_tags_entity_id ON tags(entity_id, entity_type);\nCREATE INDEX IF NOT EXISTS idx_tags_entity_uuid ON tags(entity_uuid, entity_type);\nCREATE INDEX IF NOT EXISTS idx_tags_tag ON tags(tag);\n";
+export declare const EVENTS_INDEXES = "\nCREATE INDEX IF NOT EXISTS idx_events_entity_id ON events(entity_id, entity_type);\nCREATE INDEX IF NOT EXISTS idx_events_entity_uuid ON events(entity_uuid, entity_type);\nCREATE INDEX IF NOT EXISTS idx_events_type ON events(event_type);\nCREATE INDEX IF NOT EXISTS idx_events_actor ON events(actor);\nCREATE INDEX IF NOT EXISTS idx_events_created_at ON events(created_at);\nCREATE INDEX IF NOT EXISTS idx_events_git_commit ON events(git_commit_sha);\n";
+export declare const ISSUE_FEEDBACK_INDEXES = "\nCREATE INDEX IF NOT EXISTS idx_feedback_issue_id ON issue_feedback(issue_id);\nCREATE INDEX IF NOT EXISTS idx_feedback_issue_uuid ON issue_feedback(issue_uuid);\nCREATE INDEX IF NOT EXISTS idx_feedback_spec_id ON issue_feedback(spec_id);\nCREATE INDEX IF NOT EXISTS idx_feedback_spec_uuid ON issue_feedback(spec_uuid);\nCREATE INDEX IF NOT EXISTS idx_feedback_dismissed ON issue_feedback(dismissed);\nCREATE INDEX IF NOT EXISTS idx_feedback_type ON issue_feedback(feedback_type);\nCREATE INDEX IF NOT EXISTS idx_feedback_created_at ON issue_feedback(created_at);\n";
+export declare const EXECUTIONS_INDEXES = "\nCREATE INDEX IF NOT EXISTS idx_executions_issue_id ON executions(issue_id);\nCREATE INDEX IF NOT EXISTS idx_executions_issue_uuid ON executions(issue_uuid);\nCREATE INDEX IF NOT EXISTS idx_executions_status ON executions(status);\nCREATE INDEX IF NOT EXISTS idx_executions_session_id ON executions(session_id);\nCREATE INDEX IF NOT EXISTS idx_executions_parent ON executions(parent_execution_id);\nCREATE INDEX IF NOT EXISTS idx_executions_created_at ON executions(created_at);\nCREATE INDEX IF NOT EXISTS idx_executions_workflow ON executions(workflow_execution_id);\nCREATE INDEX IF NOT EXISTS idx_executions_workflow_step ON executions(workflow_execution_id, step_index);\nCREATE INDEX IF NOT EXISTS idx_executions_step_type ON executions(step_type);\n";
+export declare const PROMPT_TEMPLATES_INDEXES = "\nCREATE INDEX IF NOT EXISTS idx_templates_type ON prompt_templates(type);\nCREATE INDEX IF NOT EXISTS idx_templates_default ON prompt_templates(is_default);\n";
+export declare const EXECUTION_LOGS_INDEXES = "\nCREATE INDEX IF NOT EXISTS idx_execution_logs_updated_at ON execution_logs(updated_at);\nCREATE INDEX IF NOT EXISTS idx_execution_logs_byte_size ON execution_logs(byte_size);\n";
+/**
+ * View definitions
+ */
+export declare const READY_ISSUES_VIEW = "\nCREATE VIEW IF NOT EXISTS ready_issues AS\nSELECT i.*\nFROM issues i\nWHERE i.status = 'open'\n  AND i.archived = 0\n  AND NOT EXISTS (\n    SELECT 1 FROM relationships r\n    JOIN issues blocker ON r.to_id = blocker.id AND r.to_type = 'issue'\n    WHERE r.from_id = i.id\n      AND r.from_type = 'issue'\n      AND r.relationship_type = 'blocks'\n      AND blocker.status IN ('open', 'in_progress', 'blocked')\n  );\n";
+export declare const BLOCKED_ISSUES_VIEW = "\nCREATE VIEW IF NOT EXISTS blocked_issues AS\nSELECT\n    i.*,\n    COUNT(r.to_id) as blocked_by_count,\n    GROUP_CONCAT(r.to_id) as blocked_by_ids\nFROM issues i\nJOIN relationships r ON i.id = r.from_id AND r.from_type = 'issue'\nJOIN issues blocker ON r.to_id = blocker.id AND r.to_type = 'issue'\nWHERE i.status IN ('open', 'in_progress', 'blocked')\n  AND i.archived = 0\n  AND r.relationship_type = 'blocks'\n  AND blocker.status IN ('open', 'in_progress', 'blocked')\nGROUP BY i.id;\n";
+/**
+ * Combined schema initialization
+ */
+export declare const ALL_TABLES: string[];
+export declare const ALL_INDEXES: string[];
+export declare const ALL_VIEWS: string[];
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,cAAc,QAAQ,CAAC;AAEpC;;GAEG;AACH,eAAO,MAAM,SAAS,uSAarB,CAAC;AAEF;;GAEG;AAEH,eAAO,MAAM,WAAW,ysBAiBvB,CAAC;AAEF,eAAO,MAAM,YAAY,qwBAmBxB,CAAC;AAEF,eAAO,MAAM,mBAAmB,iaAa/B,CAAC;AAEF,eAAO,MAAM,UAAU,mNAQtB,CAAC;AAEF,eAAO,MAAM,YAAY,uZAexB,CAAC;AAEF,eAAO,MAAM,oBAAoB,6zBAmBhC,CAAC;AAEF,eAAO,MAAM,gBAAgB,wmDAwD5B,CAAC;AAGF,eAAO,MAAM,sBAAsB,ocAYlC,CAAC;AAIF,eAAO,MAAM,oBAAoB,iXAShC,CAAC;AAEF;;GAEG;AAEH,eAAO,MAAM,aAAa,oeAQzB,CAAC;AAEF,eAAO,MAAM,cAAc,+rBAW1B,CAAC;AAEF,eAAO,MAAM,qBAAqB,seAOjC,CAAC;AAEF,eAAO,MAAM,YAAY,kOAIxB,CAAC;AAEF,eAAO,MAAM,cAAc,2cAO1B,CAAC;AAEF,eAAO,MAAM,sBAAsB,2jBAQlC,CAAC;AAEF,eAAO,MAAM,kBAAkB,0vBAU9B,CAAC;AAEF,eAAO,MAAM,wBAAwB,oKAGpC,CAAC;AAEF,eAAO,MAAM,sBAAsB,uLAGlC,CAAC;AAEF;;GAEG;AAEH,eAAO,MAAM,iBAAiB,yaAc7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,kfAc/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,UAUtB,CAAC;AAEF,eAAO,MAAM,WAAW,UAUvB,CAAC;AAEF,eAAO,MAAM,SAAS,UAA2C,CAAC"}

package/dist/schema.js

@@ -0,0 +1,338 @@
+/**
+ * SQLite schema definition for sudocode
+ * Shared between CLI and server packages
+ */
+export const SCHEMA_VERSION = "1.0";
+/**
+ * Database configuration SQL
+ */
+export const DB_CONFIG = `
+-- Enable WAL mode for better concurrency
+PRAGMA journal_mode=WAL;
+
+-- Enforce foreign keys
+PRAGMA foreign_keys=ON;
+
+-- Optimize for performance
+PRAGMA synchronous=NORMAL;
+PRAGMA temp_store=MEMORY;
+PRAGMA mmap_size=30000000000;
+PRAGMA page_size=4096;
+PRAGMA cache_size=10000;
+`;
+/**
+ * Core table schemas
+ */
+export const SPECS_TABLE = `
+CREATE TABLE IF NOT EXISTS specs (
+    id TEXT PRIMARY KEY,
+    uuid TEXT NOT NULL UNIQUE,
+    title TEXT NOT NULL CHECK(length(title) <= 500),
+    file_path TEXT NOT NULL,
+    content TEXT NOT NULL DEFAULT '',
+    priority INTEGER NOT NULL DEFAULT 2 CHECK(priority >= 0 AND priority <= 4),
+    archived INTEGER NOT NULL DEFAULT 0 CHECK(archived IN (0, 1)),
+    archived_at DATETIME,
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    parent_id TEXT,
+    parent_uuid TEXT,
+    FOREIGN KEY (parent_id) REFERENCES specs(id) ON DELETE SET NULL,
+    FOREIGN KEY (parent_uuid) REFERENCES specs(uuid) ON DELETE SET NULL
+);
+`;
+export const ISSUES_TABLE = `
+CREATE TABLE IF NOT EXISTS issues (
+    id TEXT PRIMARY KEY,
+    uuid TEXT NOT NULL UNIQUE,
+    title TEXT NOT NULL CHECK(length(title) <= 500),
+    content TEXT NOT NULL DEFAULT '',
+    status TEXT NOT NULL DEFAULT 'open',
+    priority INTEGER NOT NULL DEFAULT 2 CHECK(priority >= 0 AND priority <= 4),
+    assignee TEXT,
+    archived INTEGER NOT NULL DEFAULT 0 CHECK(archived IN (0, 1)),
+    archived_at DATETIME,
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    closed_at DATETIME,
+    parent_id TEXT,
+    parent_uuid TEXT,
+    FOREIGN KEY (parent_id) REFERENCES issues(id) ON DELETE SET NULL,
+    FOREIGN KEY (parent_uuid) REFERENCES issues(uuid) ON DELETE SET NULL
+);
+`;
+export const RELATIONSHIPS_TABLE = `
+CREATE TABLE IF NOT EXISTS relationships (
+    from_id TEXT NOT NULL,
+    from_uuid TEXT NOT NULL,
+    from_type TEXT NOT NULL,
+    to_id TEXT NOT NULL,
+    to_uuid TEXT NOT NULL,
+    to_type TEXT NOT NULL,
+    relationship_type TEXT NOT NULL,
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    metadata TEXT,
+    PRIMARY KEY (from_id, from_type, to_id, to_type, relationship_type)
+);
+`;
+export const TAGS_TABLE = `
+CREATE TABLE IF NOT EXISTS tags (
+    entity_id TEXT NOT NULL,
+    entity_uuid TEXT NOT NULL,
+    entity_type TEXT NOT NULL,
+    tag TEXT NOT NULL,
+    PRIMARY KEY (entity_id, entity_type, tag)
+);
+`;
+export const EVENTS_TABLE = `
+CREATE TABLE IF NOT EXISTS events (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    entity_id TEXT NOT NULL,
+    entity_uuid TEXT NOT NULL,
+    entity_type TEXT NOT NULL,
+    event_type TEXT NOT NULL,
+    actor TEXT NOT NULL,
+    old_value TEXT,
+    new_value TEXT,
+    comment TEXT,
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    git_commit_sha TEXT,
+    source TEXT
+);
+`;
+export const ISSUE_FEEDBACK_TABLE = `
+CREATE TABLE IF NOT EXISTS issue_feedback (
+    id TEXT PRIMARY KEY,
+    issue_id TEXT NOT NULL,
+    issue_uuid TEXT NOT NULL,
+    spec_id TEXT NOT NULL,
+    spec_uuid TEXT NOT NULL,
+    feedback_type TEXT NOT NULL CHECK(feedback_type IN ('comment', 'suggestion', 'request')),
+    content TEXT NOT NULL,
+    agent TEXT,
+    anchor TEXT,
+    dismissed INTEGER NOT NULL DEFAULT 0 CHECK(dismissed IN (0, 1)),
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (issue_id) REFERENCES issues(id) ON DELETE CASCADE,
+    FOREIGN KEY (issue_uuid) REFERENCES issues(uuid) ON DELETE CASCADE,
+    FOREIGN KEY (spec_id) REFERENCES specs(id) ON DELETE CASCADE,
+    FOREIGN KEY (spec_uuid) REFERENCES specs(uuid) ON DELETE CASCADE
+);
+`;
+export const EXECUTIONS_TABLE = `
+CREATE TABLE IF NOT EXISTS executions (
+    id TEXT PRIMARY KEY,
+    issue_id TEXT,
+    issue_uuid TEXT,
+
+    -- Execution mode and configuration
+    mode TEXT CHECK(mode IN ('worktree', 'local')),
+    prompt TEXT,
+    config TEXT,
+
+    -- Process information (legacy + new)
+    agent_type TEXT CHECK(agent_type IN ('claude-code', 'codex')),
+    session_id TEXT,
+    workflow_execution_id TEXT,
+
+    -- Git/branch information
+    target_branch TEXT NOT NULL,
+    branch_name TEXT NOT NULL,
+    before_commit TEXT,
+    after_commit TEXT,
+    worktree_path TEXT,
+
+    -- Status (unified - supports both old and new statuses)
+    status TEXT NOT NULL CHECK(status IN (
+        'preparing', 'pending', 'running', 'paused',
+        'completed', 'failed', 'cancelled', 'stopped'
+    )),
+
+    -- Timing (consistent with other tables)
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    started_at DATETIME,
+    completed_at DATETIME,
+    cancelled_at DATETIME,
+
+    -- Results and metadata
+    exit_code INTEGER,
+    error_message TEXT,
+    error TEXT,
+    model TEXT,
+    summary TEXT,
+    files_changed TEXT,
+
+    -- Relationships
+    parent_execution_id TEXT,
+
+    -- Multi-step workflow support (future extension)
+    step_type TEXT,
+    step_index INTEGER,
+    step_config TEXT,
+
+    FOREIGN KEY (issue_id) REFERENCES issues(id) ON DELETE SET NULL,
+    FOREIGN KEY (issue_uuid) REFERENCES issues(uuid) ON DELETE SET NULL,
+    FOREIGN KEY (parent_execution_id) REFERENCES executions(id) ON DELETE SET NULL
+);
+`;
+// Prompt templates table
+export const PROMPT_TEMPLATES_TABLE = `
+CREATE TABLE IF NOT EXISTS prompt_templates (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL,
+    description TEXT,
+    type TEXT NOT NULL CHECK(type IN ('issue', 'spec', 'custom')),
+    template TEXT NOT NULL,
+    variables TEXT NOT NULL,
+    is_default INTEGER NOT NULL DEFAULT 0 CHECK(is_default IN (0, 1)),
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+`;
+// Execution logs table - stores detailed execution output
+// Logs are stored in JSONL format (newline-delimited JSON)
+export const EXECUTION_LOGS_TABLE = `
+CREATE TABLE IF NOT EXISTS execution_logs (
+    execution_id TEXT PRIMARY KEY,
+    logs TEXT NOT NULL DEFAULT '',
+    byte_size INTEGER NOT NULL DEFAULT 0,
+    created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    updated_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    FOREIGN KEY (execution_id) REFERENCES executions(id) ON DELETE CASCADE
+);
+`;
+/**
+ * Index definitions
+ */
+export const SPECS_INDEXES = `
+CREATE INDEX IF NOT EXISTS idx_specs_uuid ON specs(uuid);
+CREATE INDEX IF NOT EXISTS idx_specs_priority ON specs(priority);
+CREATE INDEX IF NOT EXISTS idx_specs_parent_id ON specs(parent_id);
+CREATE INDEX IF NOT EXISTS idx_specs_parent_uuid ON specs(parent_uuid);
+CREATE INDEX IF NOT EXISTS idx_specs_archived ON specs(archived);
+CREATE INDEX IF NOT EXISTS idx_specs_created_at ON specs(created_at);
+CREATE INDEX IF NOT EXISTS idx_specs_updated_at ON specs(updated_at);
+`;
+export const ISSUES_INDEXES = `
+CREATE INDEX IF NOT EXISTS idx_issues_uuid ON issues(uuid);
+CREATE INDEX IF NOT EXISTS idx_issues_status ON issues(status);
+CREATE INDEX IF NOT EXISTS idx_issues_priority ON issues(priority);
+CREATE INDEX IF NOT EXISTS idx_issues_assignee ON issues(assignee);
+CREATE INDEX IF NOT EXISTS idx_issues_parent_id ON issues(parent_id);
+CREATE INDEX IF NOT EXISTS idx_issues_parent_uuid ON issues(parent_uuid);
+CREATE INDEX IF NOT EXISTS idx_issues_archived ON issues(archived);
+CREATE INDEX IF NOT EXISTS idx_issues_created_at ON issues(created_at);
+CREATE INDEX IF NOT EXISTS idx_issues_updated_at ON issues(updated_at);
+CREATE INDEX IF NOT EXISTS idx_issues_closed_at ON issues(closed_at);
+`;
+export const RELATIONSHIPS_INDEXES = `
+CREATE INDEX IF NOT EXISTS idx_rel_from_id ON relationships(from_id, from_type);
+CREATE INDEX IF NOT EXISTS idx_rel_from_uuid ON relationships(from_uuid, from_type);
+CREATE INDEX IF NOT EXISTS idx_rel_to_id ON relationships(to_id, to_type);
+CREATE INDEX IF NOT EXISTS idx_rel_to_uuid ON relationships(to_uuid, to_type);
+CREATE INDEX IF NOT EXISTS idx_rel_type ON relationships(relationship_type);
+CREATE INDEX IF NOT EXISTS idx_rel_created_at ON relationships(created_at);
+`;
+export const TAGS_INDEXES = `
+CREATE INDEX IF NOT EXISTS idx_tags_entity_id ON tags(entity_id, entity_type);
+CREATE INDEX IF NOT EXISTS idx_tags_entity_uuid ON tags(entity_uuid, entity_type);
+CREATE INDEX IF NOT EXISTS idx_tags_tag ON tags(tag);
+`;
+export const EVENTS_INDEXES = `
+CREATE INDEX IF NOT EXISTS idx_events_entity_id ON events(entity_id, entity_type);
+CREATE INDEX IF NOT EXISTS idx_events_entity_uuid ON events(entity_uuid, entity_type);
+CREATE INDEX IF NOT EXISTS idx_events_type ON events(event_type);
+CREATE INDEX IF NOT EXISTS idx_events_actor ON events(actor);
+CREATE INDEX IF NOT EXISTS idx_events_created_at ON events(created_at);
+CREATE INDEX IF NOT EXISTS idx_events_git_commit ON events(git_commit_sha);
+`;
+export const ISSUE_FEEDBACK_INDEXES = `
+CREATE INDEX IF NOT EXISTS idx_feedback_issue_id ON issue_feedback(issue_id);
+CREATE INDEX IF NOT EXISTS idx_feedback_issue_uuid ON issue_feedback(issue_uuid);
+CREATE INDEX IF NOT EXISTS idx_feedback_spec_id ON issue_feedback(spec_id);
+CREATE INDEX IF NOT EXISTS idx_feedback_spec_uuid ON issue_feedback(spec_uuid);
+CREATE INDEX IF NOT EXISTS idx_feedback_dismissed ON issue_feedback(dismissed);
+CREATE INDEX IF NOT EXISTS idx_feedback_type ON issue_feedback(feedback_type);
+CREATE INDEX IF NOT EXISTS idx_feedback_created_at ON issue_feedback(created_at);
+`;
+export const EXECUTIONS_INDEXES = `
+CREATE INDEX IF NOT EXISTS idx_executions_issue_id ON executions(issue_id);
+CREATE INDEX IF NOT EXISTS idx_executions_issue_uuid ON executions(issue_uuid);
+CREATE INDEX IF NOT EXISTS idx_executions_status ON executions(status);
+CREATE INDEX IF NOT EXISTS idx_executions_session_id ON executions(session_id);
+CREATE INDEX IF NOT EXISTS idx_executions_parent ON executions(parent_execution_id);
+CREATE INDEX IF NOT EXISTS idx_executions_created_at ON executions(created_at);
+CREATE INDEX IF NOT EXISTS idx_executions_workflow ON executions(workflow_execution_id);
+CREATE INDEX IF NOT EXISTS idx_executions_workflow_step ON executions(workflow_execution_id, step_index);
+CREATE INDEX IF NOT EXISTS idx_executions_step_type ON executions(step_type);
+`;
+export const PROMPT_TEMPLATES_INDEXES = `
+CREATE INDEX IF NOT EXISTS idx_templates_type ON prompt_templates(type);
+CREATE INDEX IF NOT EXISTS idx_templates_default ON prompt_templates(is_default);
+`;
+export const EXECUTION_LOGS_INDEXES = `
+CREATE INDEX IF NOT EXISTS idx_execution_logs_updated_at ON execution_logs(updated_at);
+CREATE INDEX IF NOT EXISTS idx_execution_logs_byte_size ON execution_logs(byte_size);
+`;
+/**
+ * View definitions
+ */
+export const READY_ISSUES_VIEW = `
+CREATE VIEW IF NOT EXISTS ready_issues AS
+SELECT i.*
+FROM issues i
+WHERE i.status = 'open'
+  AND i.archived = 0
+  AND NOT EXISTS (
+    SELECT 1 FROM relationships r
+    JOIN issues blocker ON r.to_id = blocker.id AND r.to_type = 'issue'
+    WHERE r.from_id = i.id
+      AND r.from_type = 'issue'
+      AND r.relationship_type = 'blocks'
+      AND blocker.status IN ('open', 'in_progress', 'blocked')
+  );
+`;
+export const BLOCKED_ISSUES_VIEW = `
+CREATE VIEW IF NOT EXISTS blocked_issues AS
+SELECT
+    i.*,
+    COUNT(r.to_id) as blocked_by_count,
+    GROUP_CONCAT(r.to_id) as blocked_by_ids
+FROM issues i
+JOIN relationships r ON i.id = r.from_id AND r.from_type = 'issue'
+JOIN issues blocker ON r.to_id = blocker.id AND r.to_type = 'issue'
+WHERE i.status IN ('open', 'in_progress', 'blocked')
+  AND i.archived = 0
+  AND r.relationship_type = 'blocks'
+  AND blocker.status IN ('open', 'in_progress', 'blocked')
+GROUP BY i.id;
+`;
+/**
+ * Combined schema initialization
+ */
+export const ALL_TABLES = [
+    SPECS_TABLE,
+    ISSUES_TABLE,
+    RELATIONSHIPS_TABLE,
+    TAGS_TABLE,
+    EVENTS_TABLE,
+    ISSUE_FEEDBACK_TABLE,
+    EXECUTIONS_TABLE,
+    PROMPT_TEMPLATES_TABLE,
+    EXECUTION_LOGS_TABLE,
+];
+export const ALL_INDEXES = [
+    SPECS_INDEXES,
+    ISSUES_INDEXES,
+    RELATIONSHIPS_INDEXES,
+    TAGS_INDEXES,
+    EVENTS_INDEXES,
+    ISSUE_FEEDBACK_INDEXES,
+    EXECUTIONS_INDEXES,
+    PROMPT_TEMPLATES_INDEXES,
+    EXECUTION_LOGS_INDEXES,
+];
+export const ALL_VIEWS = [READY_ISSUES_VIEW, BLOCKED_ISSUES_VIEW];
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC;AAEpC;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;;;;;;;;;;;;;CAaxB,CAAC;AAEF;;GAEG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;CAiB1B,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;CAmB3B,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;CAalC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;CAQzB,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;CAe3B,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;CAmBnC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwD/B,CAAC;AAEF,yBAAyB;AACzB,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;CAYrC,CAAC;AAEF,0DAA0D;AAC1D,2DAA2D;AAC3D,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;CASnC,CAAC;AAEF;;GAEG;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;CAQ5B,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;;CAW7B,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;CAOpC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;CAI3B,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;CAO7B,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;CAQrC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;CAUjC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;;;CAGvC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;CAGrC,CAAC;AAEF;;GAEG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;CAchC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;CAclC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,WAAW;IACX,YAAY;IACZ,mBAAmB;IACnB,UAAU;IACV,YAAY;IACZ,oBAAoB;IACpB,gBAAgB;IAChB,sBAAsB;IACtB,oBAAoB;CACrB,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,aAAa;IACb,cAAc;IACd,qBAAqB;IACrB,YAAY;IACZ,cAAc;IACd,sBAAsB;IACtB,kBAAkB;IAClB,wBAAwB;IACxB,sBAAsB;CACvB,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@sudocode-ai/types",
+  "version": "0.1.0",
+  "description": "TypeScript type definitions for sudocode",
+  "types": "src/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.d.ts"
+    },
+    "./schema": {
+      "types": "./dist/schema.d.ts",
+      "default": "./dist/schema.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "keywords": [
+    "sudocode",
+    "types",
+    "typescript"
+  ],
+  "author": "sudocode AI",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sudocode-ai/sudocode.git",
+    "directory": "types"
+  },
+  "homepage": "https://sudocode.ai",
+  "bugs": {
+    "url": "https://github.com/sudocode-ai/sudocode/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src/index.d.ts",
+    "dist"
+  ],
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}

package/src/index.d.ts

@@ -0,0 +1,278 @@
+/**
+ * Core entity types for sudocode
+ */
+export interface Spec {
+  id: string;
+  title: string;
+  uuid: string;
+  file_path: string;
+  content: string;
+  priority: number;
+  archived?: boolean;
+  archived_at?: string;
+  created_at: string;
+  updated_at: string;
+  parent_id?: string;
+  parent_uuid?: string;
+}
+
+export interface Issue {
+  id: string;
+  title: string;
+  status: IssueStatus;
+  uuid: string;
+  content: string;
+  priority: number;
+  assignee?: string;
+  archived?: boolean;
+  archived_at?: string;
+  created_at: string;
+  updated_at: string;
+  closed_at?: string;
+  parent_id?: string;
+  parent_uuid?: string;
+}
+
+export type IssueStatus =
+  | "open"
+  | "in_progress"
+  | "blocked"
+  | "needs_review"
+  | "closed";
+
+export interface Relationship {
+  from_id: string;
+  from_uuid: string;
+  from_type: EntityType;
+  to_id: string;
+  to_uuid: string;
+  to_type: EntityType;
+  relationship_type: RelationshipType;
+  created_at: string;
+  metadata?: string;
+}
+
+export type EntityType = "spec" | "issue";
+
+export type RelationshipType =
+  | "blocks"
+  | "related"
+  | "discovered-from"
+  | "implements"
+  | "references"
+  | "depends-on";
+
+export interface Tag {
+  entity_id: string;
+  entity_uuid: string;
+  entity_type: EntityType;
+  tag: string;
+}
+
+export interface Event {
+  id: number;
+  entity_id: string;
+  entity_uuid: string;
+  entity_type: EntityType;
+  event_type: EventType;
+  actor: string;
+  old_value: string | null;
+  new_value: string | null;
+  comment: string | null;
+  created_at: string;
+  git_commit_sha: string | null;
+  source?: string;
+}
+
+export type EventType =
+  | "created"
+  | "updated"
+  | "status_changed"
+  | "relationship_added"
+  | "relationship_removed"
+  | "tag_added"
+  | "tag_removed";
+
+/**
+ * Issue-based spec feedback types
+ */
+export interface IssueFeedback {
+  id: string;
+  issue_id: string;
+  issue_uuid: string;
+  spec_id: string;
+  spec_uuid: string;
+  feedback_type: FeedbackType;
+  content: string;
+  agent?: string;
+  anchor?: string;
+  dismissed?: boolean;
+  created_at: string;
+  updated_at: string;
+}
+
+/**
+ * Base location anchor for tracking positions in markdown documents
+ */
+export interface LocationAnchor {
+  section_heading?: string;
+  section_level?: number;
+  line_number?: number;
+  line_offset?: number;
+  text_snippet?: string;
+  context_before?: string;
+  context_after?: string;
+  content_hash?: string;
+}
+
+/**
+ * Feedback anchor with additional tracking for changes over time
+ */
+export interface FeedbackAnchor extends LocationAnchor {
+  anchor_status: "valid" | "relocated" | "stale";
+  last_verified_at?: string;
+  original_location?: {
+    line_number: number;
+    section_heading?: string;
+  };
+}
+
+export type FeedbackType = "comment" | "suggestion" | "request";
+
+/**
+ * JSONL format types
+ */
+export interface SpecJSONL extends Spec {
+  relationships: RelationshipJSONL[];
+  tags: string[];
+}
+
+export interface IssueJSONL extends Issue {
+  relationships: RelationshipJSONL[];
+  tags: string[];
+  feedback?: FeedbackJSONL[];
+}
+
+export interface FeedbackJSONL {
+  id: string;
+  issue_id: string;
+  spec_id: string;
+  feedback_type: FeedbackType;
+  content: string;
+  agent?: string;
+  anchor?: FeedbackAnchor;
+  dismissed?: boolean;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface RelationshipJSONL {
+  from: string;
+  from_type: EntityType;
+  to: string;
+  to_type: EntityType;
+  type: RelationshipType;
+}
+
+/**
+ * Worktree configuration for session isolation
+ */
+export interface WorktreeConfig {
+  /** Where to store worktrees (default: ".sudocode/worktrees") */
+  worktreeStoragePath: string;
+  /** Auto-create branches for new sessions (default: true) */
+  autoCreateBranches: boolean;
+  /** Auto-delete branches when session is cleaned up (default: false) */
+  autoDeleteBranches: boolean;
+  /** Use sparse-checkout for worktrees (default: false) */
+  enableSparseCheckout: boolean;
+  /** Patterns for sparse-checkout (optional) */
+  sparseCheckoutPatterns?: string[];
+  /** Branch naming prefix (default: "sudocode") */
+  branchPrefix: string;
+  /** Cleanup orphaned worktrees on server startup (default: true) */
+  cleanupOrphanedWorktreesOnStartup: boolean;
+}
+
+/**
+ * Config metadata file structure (.sudocode/config.json)
+ */
+export interface Config {
+  version: string;
+  id_prefix: {
+    spec: string;
+    issue: string;
+  };
+  /** Worktree configuration (optional) */
+  worktree?: WorktreeConfig;
+}
+
+/**
+ * Agent types supported for execution
+ */
+export type AgentType = "claude-code" | "codex";
+
+/**
+ * Execution status
+ */
+export type ExecutionStatus =
+  | "preparing" // Template being prepared
+  | "pending" // Created, not yet started
+  | "running" // Agent executing
+  | "paused" // Execution paused (awaiting follow-up)
+  | "completed" // Successfully finished
+  | "failed" // Execution failed
+  | "cancelled" // User cancelled
+  | "stopped"; // User stopped (legacy alias for cancelled)
+
+/**
+ * Represents a single agent run on an issue
+ * Tracks the full lifecycle of a coding agent execution
+ */
+export interface Execution {
+  id: string;
+  issue_id: string | null;
+  issue_uuid: string | null;
+
+  mode: string | null;
+  prompt: string | null;
+  config: string | null;
+
+  // Process information
+  agent_type: AgentType;
+  session_id: string | null;
+  workflow_execution_id: string | null;
+
+  // Git/branch information
+  target_branch: string;
+  branch_name: string;
+  before_commit: string | null;
+  after_commit: string | null;
+  worktree_path: string | null;
+
+  // Status
+  status: ExecutionStatus;
+
+  // Timing
+  created_at: string;
+  updated_at: string;
+  started_at: string | null;
+  completed_at: string | null;
+  cancelled_at: string | null;
+
+  // Results and metadata
+  // TODO: Expand as a proper JSON object
+  exit_code: number | null;
+  error_message: string | null;
+  error: string | null;
+  model: string | null;
+  summary: string | null;
+  files_changed: string | null;
+
+  parent_execution_id: string | null;
+
+  // Multi-step workflow support (future extension)
+  step_type: string | null;
+  step_index: number | null;
+  step_config: string | null;
+}