@jamesaphoenix/tx-core 0.5.8 → 0.5.10

package/migrations/021_agent_outbox.sql

@@ -0,0 +1,34 @@
+-- Migration 021: Agent Outbox Messaging (PRD-024)
+--
+-- Channel-based agent-to-agent messaging primitive.
+-- Two-state lifecycle: pending -> acked
+-- Read-only inbox with cursor-based fan-out.
+
+CREATE TABLE IF NOT EXISTS outbox_messages (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    channel TEXT NOT NULL,
+    sender TEXT NOT NULL,
+    content TEXT NOT NULL,
+    status TEXT NOT NULL DEFAULT 'pending'
+        CHECK (status IN ('pending', 'acked')),
+    correlation_id TEXT,
+    task_id TEXT REFERENCES tasks(id) ON DELETE SET NULL,
+    metadata TEXT NOT NULL DEFAULT '{}',
+    created_at TEXT NOT NULL,
+    acked_at TEXT,
+    expires_at TEXT
+);
+
+-- Primary query path: inbox reads by channel + cursor (id > ?)
+CREATE INDEX IF NOT EXISTS idx_outbox_channel_id ON outbox_messages(channel, id);
+-- Filter by status (pending vs acked)
+CREATE INDEX IF NOT EXISTS idx_outbox_channel_status ON outbox_messages(channel, status);
+-- Request/reply pattern
+CREATE INDEX IF NOT EXISTS idx_outbox_correlation ON outbox_messages(correlation_id) WHERE correlation_id IS NOT NULL;
+-- Task-scoped messages
+CREATE INDEX IF NOT EXISTS idx_outbox_task_id ON outbox_messages(task_id) WHERE task_id IS NOT NULL;
+-- TTL cleanup
+CREATE INDEX IF NOT EXISTS idx_outbox_expires ON outbox_messages(expires_at) WHERE expires_at IS NOT NULL;
+
+-- Record this migration
+INSERT OR IGNORE INTO schema_version (version, applied_at) VALUES (21, datetime('now'));

package/migrations/022_docs_as_primitives.sql

@@ -0,0 +1,66 @@
+-- Migration 022: Docs as Primitives (DD-023)
+-- Tables: docs, doc_links, task_doc_links, invariants, invariant_checks
+
+CREATE TABLE IF NOT EXISTS docs (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  hash TEXT NOT NULL,
+  kind TEXT NOT NULL CHECK (kind IN ('overview', 'prd', 'design')),
+  name TEXT NOT NULL,
+  title TEXT NOT NULL,
+  version INTEGER NOT NULL DEFAULT 1,
+  status TEXT NOT NULL CHECK (status IN ('changing', 'locked')) DEFAULT 'changing',
+  file_path TEXT NOT NULL,
+  parent_doc_id INTEGER REFERENCES docs(id) ON DELETE SET NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  locked_at TEXT,
+  metadata TEXT DEFAULT '{}'
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_docs_name_version ON docs(name, version);
+
+CREATE TABLE IF NOT EXISTS doc_links (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  from_doc_id INTEGER NOT NULL REFERENCES docs(id) ON DELETE CASCADE,
+  to_doc_id INTEGER NOT NULL REFERENCES docs(id) ON DELETE CASCADE,
+  link_type TEXT NOT NULL CHECK (link_type IN ('overview_to_prd', 'overview_to_design', 'prd_to_design', 'design_patch')),
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  UNIQUE(from_doc_id, to_doc_id),
+  CHECK(from_doc_id != to_doc_id)
+);
+
+CREATE TABLE IF NOT EXISTS task_doc_links (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
+  doc_id INTEGER NOT NULL REFERENCES docs(id) ON DELETE CASCADE,
+  link_type TEXT NOT NULL CHECK (link_type IN ('implements', 'references')),
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  UNIQUE(task_id, doc_id)
+);
+
+CREATE TABLE IF NOT EXISTS invariants (
+  id TEXT PRIMARY KEY,
+  rule TEXT NOT NULL,
+  enforcement TEXT NOT NULL CHECK (enforcement IN ('integration_test', 'linter', 'llm_as_judge')),
+  doc_id INTEGER NOT NULL REFERENCES docs(id) ON DELETE CASCADE,
+  subsystem TEXT,
+  test_ref TEXT,
+  lint_rule TEXT,
+  prompt_ref TEXT,
+  status TEXT NOT NULL CHECK (status IN ('active', 'deprecated')) DEFAULT 'active',
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  metadata TEXT DEFAULT '{}'
+);
+
+CREATE TABLE IF NOT EXISTS invariant_checks (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  invariant_id TEXT NOT NULL REFERENCES invariants(id) ON DELETE CASCADE,
+  passed INTEGER NOT NULL CHECK (passed IN (0, 1)),
+  details TEXT,
+  checked_at TEXT NOT NULL DEFAULT (datetime('now')),
+  duration_ms INTEGER
+);
+
+CREATE INDEX IF NOT EXISTS idx_invariant_checks_invariant_id ON invariant_checks(invariant_id);
+
+-- Record this migration
+INSERT OR IGNORE INTO schema_version (version, applied_at) VALUES (22, datetime('now'));

package/migrations/023_task_labels.sql

@@ -0,0 +1,29 @@
+-- Migration 023: Task labels (Linear-style simplified label system)
+-- Tables: task_labels, task_label_assignments
+
+CREATE TABLE IF NOT EXISTS task_labels (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  name TEXT NOT NULL,
+  color TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_task_labels_name_ci
+  ON task_labels(lower(name));
+
+CREATE TABLE IF NOT EXISTS task_label_assignments (
+  task_id TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
+  label_id INTEGER NOT NULL REFERENCES task_labels(id) ON DELETE CASCADE,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  PRIMARY KEY (task_id, label_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_task_label_assignments_task
+  ON task_label_assignments(task_id);
+
+CREATE INDEX IF NOT EXISTS idx_task_label_assignments_label
+  ON task_label_assignments(label_id);
+
+-- Record this migration
+INSERT OR IGNORE INTO schema_version (version, applied_at) VALUES (23, datetime('now'));

package/migrations/024_task_assignment.sql

@@ -0,0 +1,27 @@
+-- Migration 024: Task assignment columns with legacy backfill
+-- Tables: tasks (alter)
+
+ALTER TABLE tasks ADD COLUMN assignee_type TEXT
+  CHECK (assignee_type IN ('human', 'agent'));
+
+ALTER TABLE tasks ADD COLUMN assignee_id TEXT;
+
+ALTER TABLE tasks ADD COLUMN assigned_at TEXT;
+
+ALTER TABLE tasks ADD COLUMN assigned_by TEXT;
+
+UPDATE tasks
+SET assignee_type = 'agent',
+    assignee_id = NULL,
+    assigned_at = datetime('now'),
+    assigned_by = 'migration:024_task_assignment'
+WHERE assignee_type IS NULL;
+
+CREATE INDEX IF NOT EXISTS idx_tasks_assignee_type
+  ON tasks(assignee_type);
+
+CREATE INDEX IF NOT EXISTS idx_tasks_assignee_type_id
+  ON tasks(assignee_type, assignee_id);
+
+-- Record this migration
+INSERT OR IGNORE INTO schema_version (version, applied_at) VALUES (24, datetime('now'));

package/migrations/025_run_heartbeat_state.sql

@@ -0,0 +1,21 @@
+-- Version: 025
+-- Migration: Add run heartbeat state table for transcript-progress monitoring
+
+CREATE TABLE IF NOT EXISTS run_heartbeat_state (
+    run_id TEXT PRIMARY KEY REFERENCES runs(id) ON DELETE CASCADE,
+    last_check_at TEXT NOT NULL,
+    last_activity_at TEXT NOT NULL,
+    stdout_bytes INTEGER NOT NULL DEFAULT 0 CHECK (stdout_bytes >= 0),
+    stderr_bytes INTEGER NOT NULL DEFAULT 0 CHECK (stderr_bytes >= 0),
+    transcript_bytes INTEGER NOT NULL DEFAULT 0 CHECK (transcript_bytes >= 0),
+    last_delta_bytes INTEGER NOT NULL DEFAULT 0 CHECK (last_delta_bytes >= 0),
+    updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_run_heartbeat_check_at
+ON run_heartbeat_state(last_check_at);
+
+CREATE INDEX IF NOT EXISTS idx_run_heartbeat_activity_at
+ON run_heartbeat_state(last_activity_at);
+
+INSERT OR IGNORE INTO schema_version (version, applied_at) VALUES (25, datetime('now'));

package/migrations/026_task_order_composite_indexes.sql

@@ -0,0 +1,17 @@
+-- Version: 026
+-- Migration: Add composite task ordering indexes for dashboard task list polling
+--
+-- Dashboard /api/tasks uses ORDER BY score DESC, id ASC with optional status filter.
+-- Existing single-column indexes can trigger temporary sort B-trees under pagination.
+-- These composite indexes support index-backed ordering for both query shapes:
+--   1) Unfiltered: ORDER BY score DESC, id ASC
+--   2) Filtered:   WHERE status IN (...) ORDER BY score DESC, id ASC
+
+CREATE INDEX IF NOT EXISTS idx_tasks_score_id
+  ON tasks(score DESC, id ASC);
+
+CREATE INDEX IF NOT EXISTS idx_tasks_status_score_id
+  ON tasks(status, score DESC, id ASC);
+
+-- Record this migration
+INSERT OR IGNORE INTO schema_version (version, applied_at) VALUES (26, datetime('now'));

package/migrations/027_runs_events_hot_query_indexes.sql

@@ -0,0 +1,35 @@
+-- Version: 027
+-- Migration: Add runs/events composite + expression indexes for watchdog/dashboard trace hot paths
+--
+-- Targets:
+-- 1) runs list/filter/sort queries:
+--      ORDER BY started_at DESC, id ASC
+--      optional WHERE status = ? or agent = ?
+-- 2) orphan-active task checks:
+--      EXISTS/NOT EXISTS on runs(task_id, status='running')
+-- 3) watchdog worker burst checks:
+--      json_extract(metadata, '$.worker') + status + started_at window
+-- 4) trace error spans:
+--      events WHERE event_type='span' AND json_extract(metadata, '$.status')='error'
+--      ORDER BY timestamp DESC LIMIT ?
+
+CREATE INDEX IF NOT EXISTS idx_runs_started_id
+  ON runs(started_at DESC, id ASC);
+
+CREATE INDEX IF NOT EXISTS idx_runs_status_started_id
+  ON runs(status, started_at DESC, id ASC);
+
+CREATE INDEX IF NOT EXISTS idx_runs_agent_started_id
+  ON runs(agent, started_at DESC, id ASC);
+
+CREATE INDEX IF NOT EXISTS idx_runs_task_status
+  ON runs(task_id, status);
+
+CREATE INDEX IF NOT EXISTS idx_runs_worker_status_started
+  ON runs(json_extract(metadata, '$.worker'), status, started_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_events_type_metadata_status_timestamp
+  ON events(event_type, json_extract(metadata, '$.status'), timestamp DESC);
+
+-- Record this migration
+INSERT OR IGNORE INTO schema_version (version, applied_at) VALUES (27, datetime('now'));

package/migrations/028_task_group_context.sql

@@ -0,0 +1,13 @@
+-- Version: 028
+-- Migration: Add task group context storage and source lookup index
+--
+-- Adds first-class task-group context that can be inherited across parent/child lineage.
+
+ALTER TABLE tasks ADD COLUMN group_context TEXT;
+
+CREATE INDEX IF NOT EXISTS idx_tasks_group_context_present
+  ON tasks(id, updated_at DESC)
+  WHERE group_context IS NOT NULL AND length(trim(group_context)) > 0;
+
+-- Record this migration
+INSERT OR IGNORE INTO schema_version (version, applied_at) VALUES (28, datetime('now'));

package/package.json

@@ -1,48 +1,44 @@
 {
   "name": "@jamesaphoenix/tx-core",
-  "version": "0.5.8",
+  "version": "0.5.10",
   "description": "Core business logic for tx - Effect-TS services and repositories",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "bun": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
     "./services": {
-      "bun": "./src/services/index.ts",
       "types": "./dist/services/index.d.ts",
       "import": "./dist/services/index.js"
     },
     "./repo": {
-      "bun": "./src/repo/index.ts",
       "types": "./dist/repo/index.d.ts",
       "import": "./dist/repo/index.js"
     },
     "./schemas": {
-      "bun": "./src/schemas/index.ts",
       "types": "./dist/schemas/index.d.ts",
       "import": "./dist/schemas/index.js"
     },
     "./mappers": {
-      "bun": "./src/mappers/index.ts",
       "types": "./dist/mappers/index.d.ts",
       "import": "./dist/mappers/index.js"
     },
     "./layer": {
-      "bun": "./src/layer.ts",
       "types": "./dist/layer.d.ts",
       "import": "./dist/layer.js"
     }
   },
   "files": [
     "dist",
+    "migrations",
     "README.md"
   ],
   "scripts": {
-    "build": "tsc -b",
+    "prebuild": "node ../../scripts/bundle-migrations.js",
+    "build": "tsc -b && { rm -r ./migrations 2>/dev/null; cp -r ../../migrations ./migrations; }",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src/",
     "test": "bunx --bun vitest run --passWithNoTests"