@stackbilt/aegis-core 0.1.0

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@stackbilt/aegis-core",
+  "version": "0.1.0",
+  "description": "Persistent AI agent framework for Cloudflare Workers. Multi-tier memory, autonomous goals, dreaming cycles, MCP native.",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Stackbilt-dev/aegis-oss.git",
+    "directory": "web"
+  },
+  "type": "module",
+  "main": "src/exports.ts",
+  "types": "src/exports.ts",
+  "exports": {
+    ".": "./src/exports.ts",
+    "./core": "./src/core.ts",
+    "./types": "./src/types.ts",
+    "./edge-env": "./src/edge-env.ts",
+    "./auth": "./src/auth.ts",
+    "./version": "./src/version.ts",
+    "./kernel/dispatch": "./src/kernel/dispatch.ts",
+    "./kernel/router": "./src/kernel/router.ts",
+    "./kernel/types": "./src/kernel/types.ts",
+    "./kernel/memory": "./src/kernel/memory/index.ts",
+    "./kernel/memory-adapter": "./src/kernel/memory-adapter.ts",
+    "./kernel/resilience": "./src/kernel/resilience.ts",
+    "./kernel/classify-memory-topic": "./src/kernel/classify-memory-topic.ts",
+    "./kernel/briefing": "./src/kernel/briefing.ts",
+    "./kernel/dynamic-tools": "./src/kernel/dynamic-tools.ts",
+    "./kernel/argus-correlation": "./src/kernel/argus-correlation.ts",
+    "./kernel/port": "./src/kernel/port.ts",
+    "./kernel/executor-port": "./src/kernel/executor-port.ts",
+    "./kernel/executors": "./src/kernel/executors/index.ts",
+    "./kernel/scheduled": "./src/kernel/scheduled/index.ts",
+    "./kernel/scheduled/dreaming": "./src/kernel/scheduled/dreaming.ts",
+    "./kernel/scheduled/issue-watcher": "./src/kernel/scheduled/issue-watcher.ts",
+    "./operator": "./src/operator/index.ts",
+    "./operator/types": "./src/operator/types.ts",
+    "./operator/prompt-builder": "./src/operator/prompt-builder.ts",
+    "./mcp/server": "./src/mcp/server.ts",
+    "./mcp/tools": "./src/mcp/tools.ts",
+    "./mcp/handlers": "./src/mcp/handlers.ts",
+    "./lib/observability": "./src/lib/observability/errors.ts",
+    "./lib/audit-chain": "./src/lib/audit-chain/chain.ts",
+    "./routes/health": "./src/routes/health.ts",
+    "./routes/sessions": "./src/routes/sessions.ts",
+    "./routes/messages": "./src/routes/messages.ts",
+    "./routes/conversations": "./src/routes/conversations.ts",
+    "./routes/feedback": "./src/routes/feedback.ts",
+    "./routes/observability": "./src/routes/observability.ts",
+    "./routes/cc-tasks": "./src/routes/cc-tasks.ts",
+    "./routes/pages": "./src/routes/pages.ts",
+    "./routes/dynamic-tools": "./src/routes/dynamic-tools.ts",
+    "./adapters/voice": "./src/adapters/voice/cloudflare-agent.ts"
+  },
+  "scripts": {
+    "dev": "wrangler dev",
+    "deploy": "wrangler deploy",
+    "d1:create": "wrangler d1 create aegis-web",
+    "d1:migrate": "wrangler d1 execute aegis-web --file=schema.sql",
+    "d1:migrate:local": "wrangler d1 execute aegis-web --file=schema.sql --local",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@cloudflare/voice": "^0.1.3",
+    "@cloudflare/workers-oauth-provider": "^0.2.4",
+    "@stackbilt/llm-providers": "^1.6.0",
+    "agents": "^0.12.3",
+    "hono": "^4.12.12"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20241218.0",
+    "typescript": "^5.7.3",
+    "vite": "^8.0.5",
+    "vitest": "^4.0.18",
+    "wrangler": "^4.76.0"
+  },
+  "files": [
+    "src/**/*.ts",
+    "schema.sql"
+  ],
+  "keywords": [
+    "cloudflare-workers",
+    "ai-agent",
+    "mcp",
+    "autonomous-agent",
+    "memory",
+    "dreaming-cycle",
+    "hono"
+  ]
+}

package/schema.sql

@@ -0,0 +1,586 @@
+-- AEGIS Web — D1 Schema
+-- Run: wrangler d1 execute aegis-web --file=schema.sql
+
+-- ─── Chat ──────────────────────────────────────────────────────
+
+CREATE TABLE IF NOT EXISTS conversations (
+  id TEXT PRIMARY KEY,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  title TEXT
+);
+
+CREATE TABLE IF NOT EXISTS messages (
+  id TEXT PRIMARY KEY,
+  conversation_id TEXT NOT NULL,
+  role TEXT NOT NULL CHECK (role IN ('user', 'assistant')),
+  content TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  metadata TEXT,
+  FOREIGN KEY (conversation_id) REFERENCES conversations(id)
+);
+
+
+CREATE TABLE IF NOT EXISTS web_events (
+  event_id TEXT PRIMARY KEY,
+  received_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- ─── ARGUS Phase 1: Webhook Event Ingestion ──────────────────
+
+
+-- ─── Kernel Memory ─────────────────────────────────────────────
+
+CREATE TABLE IF NOT EXISTS memory_entries (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  topic TEXT NOT NULL,
+  fact TEXT NOT NULL,
+  fact_hash TEXT NOT NULL DEFAULT '',
+  confidence REAL NOT NULL DEFAULT 0.8,
+  source TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  expires_at TEXT,
+  valid_until TEXT,                           -- NULL = current/active; set to invalidate
+  superseded_by INTEGER,                     -- FK to replacing entry's id
+  strength INTEGER NOT NULL DEFAULT 1,       -- recall frequency (for decay)
+  last_recalled_at TEXT,                     -- last retrieval time
+  -- CRIX Phase 2a: validation pipeline
+  validation_stage TEXT DEFAULT 'candidate'
+    CHECK (validation_stage IN ('candidate', 'validated', 'expert', 'canonical', 'refuted')),
+  validators TEXT                            -- JSON array: [{ repo, confirmed, date }]
+);
+
+CREATE TABLE IF NOT EXISTS episodic_memory (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  intent_class TEXT NOT NULL,
+  channel TEXT NOT NULL,
+  summary TEXT NOT NULL,
+  outcome TEXT NOT NULL DEFAULT 'success'
+    CHECK (outcome IN ('success', 'failure')),
+  cost REAL NOT NULL DEFAULT 0,
+  latency_ms INTEGER NOT NULL DEFAULT 0,
+  near_miss TEXT,
+  classifier_confidence REAL,
+  reclassified INTEGER NOT NULL DEFAULT 0,
+  thread_id TEXT,                              -- conversation thread for dreaming cycle
+  executor TEXT,                               -- which executor handled this
+  complexity_tier TEXT,                        -- aegis#563: procedureKey complement (low|mid|high); NULL for non-dispatcher producers
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- aegis#564 Phase 2: shadow-read drift log for cached-vs-derived stats on
+-- procedural_memory. Populated by getProcedureWithDerivedStats /
+-- getAllProceduresWithDerivedStats. Phase 3 gate: drift row p95 within
+-- tolerance across a 7-day window before dropping the cached aggregate
+-- columns from procedural_memory.
+CREATE TABLE IF NOT EXISTS shadow_read_drift (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  reader TEXT NOT NULL,
+  task_pattern TEXT NOT NULL,
+  cached_count INTEGER NOT NULL,
+  cached_success_count INTEGER NOT NULL,
+  cached_fail_count INTEGER NOT NULL,
+  cached_avg_latency_ms REAL NOT NULL,
+  cached_avg_cost REAL NOT NULL,
+  cached_last_used TEXT,
+  derived_count INTEGER NOT NULL,
+  derived_success_count INTEGER NOT NULL,
+  derived_fail_count INTEGER NOT NULL,
+  derived_avg_latency_ms REAL NOT NULL,
+  derived_avg_cost REAL NOT NULL,
+  derived_last_used TEXT,
+  pre_tier_count INTEGER NOT NULL DEFAULT 0,
+  sampled_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE INDEX IF NOT EXISTS idx_shadow_read_drift_reader_sampled
+  ON shadow_read_drift(reader, sampled_at);
+
+CREATE TABLE IF NOT EXISTS procedural_memory (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  task_pattern TEXT NOT NULL UNIQUE,
+  executor TEXT NOT NULL,
+  executor_config TEXT NOT NULL DEFAULT '{}',
+  success_count INTEGER NOT NULL DEFAULT 0,
+  fail_count INTEGER NOT NULL DEFAULT 0,
+  avg_latency_ms REAL NOT NULL DEFAULT 0,
+  avg_cost REAL NOT NULL DEFAULT 0,
+  status TEXT NOT NULL DEFAULT 'learning',
+  consecutive_failures INTEGER NOT NULL DEFAULT 0,
+  refinements TEXT NOT NULL DEFAULT '[]',
+  last_used TEXT,
+  candidate_executor TEXT,                     -- probation: untrusted executor being tested
+  candidate_successes INTEGER NOT NULL DEFAULT 0,  -- consecutive successes of candidate
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS heartbeat_results (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  actionable BOOLEAN NOT NULL,
+  severity TEXT NOT NULL,
+  summary TEXT NOT NULL,
+  checks_json TEXT NOT NULL,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS agent_agenda (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  item TEXT NOT NULL,
+  context TEXT,
+  priority TEXT NOT NULL DEFAULT 'medium' CHECK (priority IN ('low', 'medium', 'high')),
+  status TEXT NOT NULL DEFAULT 'active' CHECK (status IN ('active', 'done', 'dismissed')),
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  resolved_at TEXT,
+  business_unit TEXT NOT NULL DEFAULT 'stackbilt'  -- partition key for multi-BU operators
+);
+
+-- ─── Autonomous Goals (#14) ────────────────────────────────────
+
+CREATE TABLE IF NOT EXISTS agent_goals (
+  id TEXT PRIMARY KEY,
+  title TEXT NOT NULL,
+  description TEXT,
+  status TEXT NOT NULL DEFAULT 'active' CHECK (status IN ('active', 'paused', 'completed', 'failed')),
+  authority_level TEXT NOT NULL DEFAULT 'propose' CHECK (authority_level IN ('propose', 'auto_low', 'auto_high')),
+  schedule_hours INTEGER NOT NULL DEFAULT 6,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  last_run_at TEXT,
+  next_run_at TEXT,
+  completed_at TEXT,
+  run_count INTEGER NOT NULL DEFAULT 0,
+  context_json TEXT,
+  business_unit TEXT NOT NULL DEFAULT 'stackbilt'  -- partition key for multi-BU operators
+);
+
+CREATE TABLE IF NOT EXISTS agent_actions (
+  id TEXT PRIMARY KEY,
+  goal_id TEXT,
+  action_type TEXT NOT NULL CHECK (action_type IN ('proposed', 'executed', 'skipped')),
+  description TEXT NOT NULL,
+  tool_called TEXT,
+  tool_args_json TEXT,
+  tool_result_json TEXT,
+  outcome TEXT CHECK (outcome IN ('success', 'failure', 'pending')),
+  auto_executed INTEGER NOT NULL DEFAULT 0,
+  authority_level TEXT NOT NULL DEFAULT 'propose',
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- ─── Reflections (#introspection) ─────────────────────────────
+
+CREATE TABLE IF NOT EXISTS reflections (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  content TEXT NOT NULL,
+  memory_count INTEGER NOT NULL DEFAULT 0,
+  topics_covered TEXT,               -- JSON array of topic strings
+  cost REAL NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- ─── Operator Log (#introspection) ────────────────────────────
+
+CREATE TABLE IF NOT EXISTS operator_log (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  content TEXT NOT NULL,
+  episodes_count INTEGER NOT NULL DEFAULT 0,
+  goals_run INTEGER NOT NULL DEFAULT 0,
+  tasks_completed INTEGER NOT NULL DEFAULT 0,
+  tasks_failed INTEGER NOT NULL DEFAULT 0,
+  prs_created INTEGER NOT NULL DEFAULT 0,
+  total_cost REAL NOT NULL DEFAULT 0,
+  cost REAL NOT NULL DEFAULT 0,            -- cost of generating this log entry
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- ─── Indexes ───────────────────────────────────────────────────
+
+CREATE INDEX IF NOT EXISTS idx_messages_conversation ON messages(conversation_id);
+CREATE INDEX IF NOT EXISTS idx_messages_created ON messages(created_at);
+CREATE INDEX IF NOT EXISTS idx_memory_topic ON memory_entries(topic);
+CREATE INDEX IF NOT EXISTS idx_memory_dedup ON memory_entries(topic, fact_hash);
+CREATE INDEX IF NOT EXISTS idx_memory_expires ON memory_entries(expires_at);
+CREATE INDEX IF NOT EXISTS idx_memory_valid ON memory_entries(valid_until);
+CREATE INDEX IF NOT EXISTS idx_memory_validation_stage ON memory_entries(validation_stage);
+CREATE INDEX IF NOT EXISTS idx_episodic_class ON episodic_memory(intent_class);
+CREATE INDEX IF NOT EXISTS idx_episodic_created ON episodic_memory(created_at);
+CREATE INDEX IF NOT EXISTS idx_episodic_thread ON episodic_memory(thread_id);
+CREATE INDEX IF NOT EXISTS idx_procedural_pattern ON procedural_memory(task_pattern);
+CREATE INDEX IF NOT EXISTS idx_procedural_status ON procedural_memory(status);
+CREATE INDEX IF NOT EXISTS idx_heartbeat_created ON heartbeat_results(created_at);
+CREATE INDEX IF NOT EXISTS idx_agenda_status ON agent_agenda(status);
+CREATE INDEX IF NOT EXISTS idx_agenda_priority ON agent_agenda(priority);
+CREATE INDEX IF NOT EXISTS idx_agenda_bu ON agent_agenda(business_unit, status);
+CREATE INDEX IF NOT EXISTS idx_goals_status ON agent_goals(status);
+CREATE INDEX IF NOT EXISTS idx_goals_next_run ON agent_goals(next_run_at);
+CREATE INDEX IF NOT EXISTS idx_goals_bu ON agent_goals(business_unit, status);
+CREATE INDEX IF NOT EXISTS idx_actions_goal ON agent_actions(goal_id);
+CREATE INDEX IF NOT EXISTS idx_actions_created ON agent_actions(created_at);
+
+-- ─── Task Observability ─────────────────────────────────────
+
+CREATE TABLE IF NOT EXISTS task_runs (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  task_name TEXT NOT NULL,
+  status TEXT NOT NULL CHECK (status IN ('ok', 'error', 'skipped')),
+  duration_ms INTEGER,
+  error_message TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_task_runs_name ON task_runs(task_name, created_at);
+CREATE INDEX IF NOT EXISTS idx_task_runs_status ON task_runs(status, created_at);
+
+-- ─── Shadow Mode: Dual-Write Tracking ───────────────────────
+
+CREATE TABLE IF NOT EXISTS shadow_writes (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  topic TEXT NOT NULL,
+  fact_hash TEXT NOT NULL,
+  worker_ok INTEGER NOT NULL DEFAULT 0,
+  d1_ok INTEGER NOT NULL DEFAULT 0,
+  worker_ms INTEGER,
+  d1_ms INTEGER,
+  error_source TEXT,
+  error_message TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_shadow_writes_created ON shadow_writes(created_at);
+CREATE INDEX IF NOT EXISTS idx_shadow_writes_errors ON shadow_writes(error_source, created_at);
+
+-- ─── Claude Code Session Ingestion ──────────────────────────
+
+CREATE TABLE IF NOT EXISTS cc_sessions (
+  id TEXT PRIMARY KEY,
+  session_date TEXT NOT NULL,
+  summary TEXT NOT NULL,
+  commits TEXT,
+  files_changed TEXT,
+  issues_opened TEXT,
+  issues_closed TEXT,
+  decisions TEXT,
+  repos TEXT,
+  duration_minutes INTEGER,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_cc_sessions_date ON cc_sessions(session_date);
+
+-- ─── Shadow Mode: Dual-Read Comparison ──────────────────────
+
+CREATE TABLE IF NOT EXISTS shadow_reads (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  call_site TEXT NOT NULL,
+  query_text TEXT,
+  worker_count INTEGER NOT NULL DEFAULT 0,
+  d1_count INTEGER NOT NULL DEFAULT 0,
+  overlap_count INTEGER NOT NULL DEFAULT 0,
+  worker_only_count INTEGER NOT NULL DEFAULT 0,
+  d1_only_count INTEGER NOT NULL DEFAULT 0,
+  rank_drift REAL,
+  worker_ms INTEGER,
+  d1_ms INTEGER,
+  error_source TEXT,
+  error_message TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_shadow_reads_created ON shadow_reads(created_at);
+CREATE INDEX IF NOT EXISTS idx_shadow_reads_site ON shadow_reads(call_site, created_at);
+
+-- ─── Claude Code Task Queue ──────────────────────────────────
+
+CREATE TABLE IF NOT EXISTS cc_tasks (
+  id TEXT PRIMARY KEY,
+  title TEXT NOT NULL,
+  repo TEXT NOT NULL,                            -- target repo path (e.g. my-project, demo-app-v2)
+  prompt TEXT NOT NULL,                          -- mission brief for Claude Code
+  completion_signal TEXT,                        -- string to look for in output to confirm success
+  status TEXT NOT NULL DEFAULT 'pending'
+    CHECK (status IN ('pending', 'running', 'completed', 'failed', 'cancelled')),
+  priority INTEGER NOT NULL DEFAULT 50,          -- 0=highest, 100=lowest
+  depends_on TEXT,                               -- task ID this depends on (NULL = no dependency) — single blocker, legacy
+  blocked_by TEXT,                               -- JSON array of task IDs that must complete first (DAG dependencies)
+  max_turns INTEGER NOT NULL DEFAULT 25,         -- --max-turns for safety
+  allowed_tools TEXT,                            -- JSON array of allowed tool patterns (NULL = default set)
+  session_id TEXT,                               -- Claude Code session ID once started
+  result TEXT,                                   -- output/result summary
+  error TEXT,                                    -- error message if failed
+  exit_code INTEGER,                             -- process exit code
+  preflight_json TEXT,                           -- structured runner-side viability/preflight data
+  failure_kind TEXT,                             -- normalized failure classifier for self-improvement
+  retryable INTEGER NOT NULL DEFAULT 0,          -- whether the failure is likely transient/retryable
+  autopsy_json TEXT,                             -- structured failure autopsy + recommended action
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  started_at TEXT,
+  completed_at TEXT,
+  created_by TEXT NOT NULL DEFAULT 'operator',   -- who created: operator, aegis, goal:{id}
+  authority TEXT NOT NULL DEFAULT 'operator'     -- operator=run immediately, auto_safe=safe category, proposed=needs approval
+    CHECK (authority IN ('proposed', 'auto_safe', 'operator')),
+  category TEXT NOT NULL DEFAULT 'feature'       -- task type for governance routing
+    CHECK (category IN ('docs', 'tests', 'research', 'bugfix', 'feature', 'refactor', 'deploy')),
+  branch TEXT,                                   -- git branch name (auto/{task_id:8})
+  pr_url TEXT,                                   -- GitHub PR URL if one was created
+  utility_json TEXT,                              -- PR utility scoring: {impact, novelty, signals[]}
+  github_issue_repo TEXT,                        -- source issue repo (e.g. 'my-org/aegis')
+  github_issue_number INTEGER,                   -- source issue number (repo-scoped)
+  business_unit TEXT NOT NULL DEFAULT 'stackbilt' -- partition key for multi-BU operators
+);
+
+CREATE INDEX IF NOT EXISTS idx_cc_tasks_status ON cc_tasks(status, priority);
+CREATE INDEX IF NOT EXISTS idx_cc_tasks_depends ON cc_tasks(depends_on);
+CREATE INDEX IF NOT EXISTS idx_cc_tasks_created ON cc_tasks(created_at);
+CREATE INDEX IF NOT EXISTS idx_cc_tasks_bu ON cc_tasks(business_unit, status);
+CREATE INDEX IF NOT EXISTS idx_cc_tasks_authority ON cc_tasks(authority);
+CREATE INDEX IF NOT EXISTS idx_cc_tasks_gh_issue ON cc_tasks(github_issue_repo, github_issue_number);
+CREATE INDEX IF NOT EXISTS idx_cc_tasks_failure_kind ON cc_tasks(failure_kind, completed_at);
+
+-- ─── Cognitive Layer ──────────────────────────────────────────
+
+-- Phase 1: Narratives — maintained story arcs across sessions
+CREATE TABLE IF NOT EXISTS narratives (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  arc TEXT NOT NULL,                          -- short label: "llc_formation", "oauth_migration"
+  arc_hash TEXT NOT NULL DEFAULT '',          -- djb2 hash for dedup
+  title TEXT NOT NULL,                        -- human-readable: "LLC formation stuck on bureaucracy"
+  summary TEXT NOT NULL,                      -- 2-4 sentence current state
+  status TEXT NOT NULL DEFAULT 'active'
+    CHECK (status IN ('active', 'resolved', 'stalled', 'abandoned')),
+  tension TEXT,                              -- what's unresolved
+  last_beat TEXT,                            -- most recent development (1 sentence)
+  beat_count INTEGER NOT NULL DEFAULT 1,
+  related_topics TEXT NOT NULL DEFAULT '[]', -- JSON array of memory topic strings
+  related_goal_ids TEXT NOT NULL DEFAULT '[]',
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  resolved_at TEXT
+);
+
+-- Phase 2: Knowledge Graph — nodes + edges with spreading activation
+CREATE TABLE IF NOT EXISTS kg_nodes (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  label TEXT NOT NULL,
+  node_type TEXT NOT NULL
+    CHECK (node_type IN ('concept','project','person','decision','pattern','tool','event',
+                         'file','module','function','class','interface','type_alias')),
+  description TEXT,
+  activation REAL NOT NULL DEFAULT 0.0,
+  last_activated_at TEXT,
+  memory_ids TEXT NOT NULL DEFAULT '[]',     -- JSON array of memory_entries.id links
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  source_system TEXT NOT NULL DEFAULT 'cognitive'
+    CHECK (source_system IN ('cognitive', 'code', 'manual')),
+  source_ref TEXT,                           -- e.g. "my-project:src/kernel/dispatch.ts:45"
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS kg_edges (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  source_id INTEGER NOT NULL REFERENCES kg_nodes(id),
+  target_id INTEGER NOT NULL REFERENCES kg_nodes(id),
+  relation TEXT NOT NULL                     -- depends_on, part_of, decided_by, blocks, uses, related_to, caused
+    CHECK (relation IN ('depends_on', 'part_of', 'decided_by', 'blocks', 'uses', 'related_to', 'caused')),
+  weight REAL NOT NULL DEFAULT 0.5,
+  confidence REAL NOT NULL DEFAULT 0.7,
+  evidence TEXT,
+  co_activation_count INTEGER NOT NULL DEFAULT 1,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  first_seen_at TEXT NOT NULL DEFAULT (datetime('now')),
+  last_seen_at TEXT NOT NULL DEFAULT (datetime('now')),
+  source_system TEXT NOT NULL DEFAULT 'cognitive'
+    CHECK (source_system IN ('cognitive', 'code', 'manual'))
+);
+
+
+-- Phase 1: CognitiveState — precomputed warm-boot blob (singleton)
+CREATE TABLE IF NOT EXISTS cognitive_state (
+  id INTEGER PRIMARY KEY CHECK (id = 1),
+  state_json TEXT NOT NULL DEFAULT '{}',
+  version INTEGER NOT NULL DEFAULT 0,
+  computed_at TEXT NOT NULL DEFAULT (datetime('now')),
+  compute_cost REAL NOT NULL DEFAULT 0,
+  compute_ms INTEGER NOT NULL DEFAULT 0
+);
+
+-- ─── Cognitive Layer Indexes ──────────────────────────────────
+CREATE INDEX IF NOT EXISTS idx_narratives_status ON narratives(status);
+CREATE INDEX IF NOT EXISTS idx_narratives_arc ON narratives(arc);
+CREATE INDEX IF NOT EXISTS idx_narratives_updated ON narratives(updated_at);
+CREATE INDEX IF NOT EXISTS idx_kg_nodes_type ON kg_nodes(node_type);
+CREATE INDEX IF NOT EXISTS idx_kg_nodes_label ON kg_nodes(label);
+CREATE INDEX IF NOT EXISTS idx_kg_nodes_activation ON kg_nodes(activation);
+CREATE INDEX IF NOT EXISTS idx_kg_nodes_source ON kg_nodes(source_system);
+CREATE INDEX IF NOT EXISTS idx_kg_nodes_source_ref ON kg_nodes(source_ref);
+CREATE INDEX IF NOT EXISTS idx_kg_edges_source ON kg_edges(source_id);
+CREATE INDEX IF NOT EXISTS idx_kg_edges_target ON kg_edges(target_id);
+CREATE INDEX IF NOT EXISTS idx_kg_edges_relation ON kg_edges(relation);
+CREATE INDEX IF NOT EXISTS idx_kg_edges_source_system ON kg_edges(source_system);
+
+-- ─── Tech Posts (consolidated to roundtable-db, kept for reference) ──
+-- Posts are now in ROUNDTABLE_DB `posts` table. This table is legacy.
+
+-- ─── Exocortex v2: Memory Blocks ─────────────────────────────
+
+CREATE TABLE IF NOT EXISTS memory_blocks (
+  id         TEXT PRIMARY KEY,
+  content    TEXT NOT NULL,
+  version    INTEGER NOT NULL DEFAULT 1,
+  priority   INTEGER NOT NULL,
+  max_bytes  INTEGER NOT NULL,
+  updated_by TEXT NOT NULL DEFAULT 'operator',
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- ─── Platform Feedback ──────────────────────────────────────
+
+CREATE TABLE IF NOT EXISTS feedback (
+  id TEXT PRIMARY KEY,
+  email TEXT,
+  category TEXT NOT NULL DEFAULT 'general'
+    CHECK (category IN ('general', 'bug', 'feature', 'question')),
+  message TEXT NOT NULL,
+  source TEXT NOT NULL DEFAULT 'web'            -- web, mcp, api
+    CHECK (source IN ('web', 'mcp', 'api')),
+  user_agent TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_feedback_created ON feedback(created_at);
+CREATE INDEX IF NOT EXISTS idx_feedback_category ON feedback(category);
+
+-- ─── Feed Watcher ───────────────────────────────────────────
+CREATE TABLE IF NOT EXISTS watched_feeds (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(8)))),
+  url TEXT NOT NULL UNIQUE,
+  title TEXT,
+  category TEXT NOT NULL DEFAULT 'general',
+  last_fetched_at TEXT,
+  last_entry_id TEXT,
+  enabled INTEGER NOT NULL DEFAULT 1,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS feed_entries (
+  id TEXT PRIMARY KEY DEFAULT (lower(hex(randomblob(8)))),
+  feed_id TEXT NOT NULL REFERENCES watched_feeds(id),
+  entry_id TEXT NOT NULL,
+  title TEXT NOT NULL,
+  link TEXT,
+  summary TEXT,
+  published_at TEXT,
+  ingested_at TEXT NOT NULL DEFAULT (datetime('now')),
+  recorded_to_memory INTEGER NOT NULL DEFAULT 0,
+  UNIQUE(feed_id, entry_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_feed_entries_feed ON feed_entries(feed_id);
+CREATE INDEX IF NOT EXISTS idx_feed_entries_ingested ON feed_entries(ingested_at);
+
+-- ─── Project Board ──────────────────────────────────────────────
+-- D1 cache of GitHub Projects v2 board state.
+-- Written by ARGUS webhooks (real-time) and board-sync (hourly reconciliation).
+-- Read by Overworld snapshot endpoint.
+
+CREATE TABLE IF NOT EXISTS board_items (
+  id TEXT PRIMARY KEY,                                          -- GitHub Projects item node ID
+  project_id TEXT NOT NULL,                                     -- GitHub Projects project node ID
+  content_type TEXT NOT NULL CHECK (content_type IN ('issue', 'pr')),
+  content_node_id TEXT NOT NULL,                                -- GitHub node ID of the issue/PR
+  repo TEXT NOT NULL,                                           -- 'my-org/aegis' format
+  number INTEGER NOT NULL,
+  title TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'backlog'
+    CHECK (status IN ('backlog', 'queued', 'in_progress', 'blocked', 'shipped')),
+  labels TEXT NOT NULL DEFAULT '[]',                            -- JSON array
+  assignee TEXT,
+  cc_task_id TEXT,                                              -- FK to cc_tasks.id if linked
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  synced_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_board_status ON board_items(status);
+CREATE INDEX IF NOT EXISTS idx_board_repo ON board_items(repo);
+CREATE INDEX IF NOT EXISTS idx_board_content ON board_items(content_node_id);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_board_repo_number ON board_items(repo, number);
+
+-- ─── Content Queue (Content Drip) ─────────────────────────────
+
+CREATE TABLE IF NOT EXISTS content_queue (
+  id TEXT PRIMARY KEY,
+  platform TEXT NOT NULL DEFAULT 'bluesky',
+  text TEXT NOT NULL,
+  image_url TEXT,
+  image_alt TEXT,
+  link_url TEXT,
+  scheduled_at TEXT NOT NULL,
+  published_at TEXT,
+  status TEXT NOT NULL DEFAULT 'scheduled'
+    CHECK (status IN ('scheduled', 'published', 'failed', 'cancelled')),
+  post_url TEXT,
+  error TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_content_queue_status ON content_queue(status, scheduled_at);
+
+-- ─── Dynamic Tools ────────────────────────────────────────────
+
+CREATE TABLE IF NOT EXISTS dynamic_tools (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL UNIQUE,
+  description TEXT NOT NULL,
+  input_schema TEXT NOT NULL DEFAULT '{}',
+  prompt_template TEXT NOT NULL,
+  executor TEXT NOT NULL DEFAULT 'gpt_oss'
+    CHECK (executor IN ('gpt_oss', 'workers_ai', 'groq')),
+  created_by TEXT NOT NULL DEFAULT 'operator',
+  status TEXT NOT NULL DEFAULT 'active'
+    CHECK (status IN ('active', 'promoted', 'retired', 'draft')),
+  ttl_days INTEGER,
+  use_count INTEGER NOT NULL DEFAULT 0,
+  last_used_at TEXT,
+  avg_latency_ms REAL NOT NULL DEFAULT 0,
+  avg_cost REAL NOT NULL DEFAULT 0,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  expires_at TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_dynamic_tools_status ON dynamic_tools(status);
+CREATE INDEX IF NOT EXISTS idx_dynamic_tools_expires ON dynamic_tools(expires_at);
+
+-- ─── CodeBeast Findings ──────────────────────────────────────
+
+CREATE TABLE IF NOT EXISTS codebeast_findings (
+  finding_id TEXT PRIMARY KEY,
+  repo TEXT NOT NULL,
+  file_path TEXT NOT NULL DEFAULT '',
+  line_start INTEGER NOT NULL DEFAULT 0,
+  line_end INTEGER NOT NULL DEFAULT 0,
+  severity TEXT NOT NULL
+    CHECK (severity IN ('HIGH', 'MID', 'LOW', 'INFO')),
+  category TEXT NOT NULL DEFAULT 'LOGIC'
+    CHECK (category IN ('SECURITY', 'LOGIC', 'STYLE', 'DEPENDENCY', 'BOUNDARY')),
+  title TEXT NOT NULL,
+  description TEXT NOT NULL DEFAULT '',
+  commit_sha TEXT NOT NULL DEFAULT '',
+  branch TEXT NOT NULL DEFAULT 'main',
+  priority TEXT NOT NULL DEFAULT 'low'
+    CHECK (priority IN ('high', 'medium', 'low')),
+  status TEXT NOT NULL DEFAULT 'open'
+    CHECK (status IN ('open', 'resolved')),
+  fix_id TEXT,
+  outcome_summary TEXT,
+  fix_attempts INTEGER NOT NULL DEFAULT 0,
+  last_fix_error TEXT,
+  detected_at TEXT NOT NULL DEFAULT (datetime('now')),
+  resolved_at TEXT,
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_cb_findings_status ON codebeast_findings(status);
+CREATE INDEX IF NOT EXISTS idx_cb_findings_repo ON codebeast_findings(repo);
+CREATE INDEX IF NOT EXISTS idx_cb_findings_severity ON codebeast_findings(severity);