@cleocode/core 2026.3.76 → 2026.4.0

package/dist/store/tasks-schema.js

@@ -0,0 +1,637 @@
+/**
+ * Drizzle ORM schema for CLEO tasks.db (SQLite via node:sqlite + sqlite-proxy).
+ *
+ * Tables: tasks, task_dependencies, task_relations, sessions, task_work_history
+ * Archive uses the same tasks table with status = 'archived' + archive metadata.
+ *
+ * @epic T4454
+ * @task W1-T2
+ */
+import { sql } from 'drizzle-orm';
+import { index, integer, primaryKey, sqliteTable, text, unique, } from 'drizzle-orm/sqlite-core';
+import { ADR_STATUSES, GATE_STATUSES, LIFECYCLE_PIPELINE_STATUSES, LIFECYCLE_STAGE_STATUSES, MANIFEST_STATUSES, SESSION_STATUSES, TASK_STATUSES, } from './status-registry.js';
+// Re-export agent schema tables so drizzle-kit picks them up for migrations.
+export { AGENT_INSTANCE_STATUSES, AGENT_TYPES, agentErrorLog, agentInstances, } from '../agents/agent-schema.js';
+// Re-export WarpChain schema tables so drizzle-kit picks them up for migrations.
+export { warpChainInstances, warpChains } from './chain-schema.js';
+// Re-export status constants and types so existing imports from schema.ts still work.
+export { ADR_STATUSES, GATE_STATUSES, isValidStatus, LIFECYCLE_PIPELINE_STATUSES, LIFECYCLE_STAGE_STATUSES, MANIFEST_STATUSES, SESSION_STATUSES, TASK_STATUSES, } from './status-registry.js';
+// === CANONICAL ENUM CONSTANTS (non-status) ===
+/** Task priorities matching DB CHECK constraint on tasks.priority. */
+export const TASK_PRIORITIES = ['critical', 'high', 'medium', 'low'];
+/** Task types matching DB CHECK constraint on tasks.type. */
+export const TASK_TYPES = ['epic', 'task', 'subtask'];
+/** Task size values matching DB CHECK constraint on tasks.size. */
+export const TASK_SIZES = ['small', 'medium', 'large'];
+/** Canonical lifecycle stage names matching DB CHECK constraint on lifecycle_stages.stage_name. */
+export const LIFECYCLE_STAGE_NAMES = [
+    'research',
+    'consensus',
+    'architecture_decision',
+    'specification',
+    'decomposition',
+    'implementation',
+    'validation',
+    'testing',
+    'release',
+    'contribution',
+];
+/** Gate result values matching DB CHECK constraint on lifecycle_gate_results.result. */
+export const LIFECYCLE_GATE_RESULTS = ['pass', 'fail', 'warn'];
+/** Evidence type values matching DB CHECK constraint on lifecycle_evidence.type. */
+export const LIFECYCLE_EVIDENCE_TYPES = ['file', 'url', 'manifest'];
+/** Token measurement methods for central token telemetry. */
+export const TOKEN_USAGE_METHODS = ['otel', 'provider_api', 'tokenizer', 'heuristic'];
+/** Confidence levels for token measurements. */
+export const TOKEN_USAGE_CONFIDENCE = ['real', 'high', 'estimated', 'coarse'];
+/** Transport types for token telemetry. */
+export const TOKEN_USAGE_TRANSPORTS = ['cli', 'mcp', 'api', 'agent', 'unknown'];
+/** Task relation types matching DB CHECK constraint on task_relations.relation_type. */
+export const TASK_RELATION_TYPES = [
+    'related',
+    'blocks',
+    'duplicates',
+    'absorbs',
+    'fixes',
+    'extends',
+    'supersedes',
+];
+/** Lifecycle transition types matching DB CHECK constraint on lifecycle_transitions.transition_type. */
+export const LIFECYCLE_TRANSITION_TYPES = ['automatic', 'manual', 'forced'];
+/** External task link types matching DB constraint on external_task_links.link_type. */
+export const EXTERNAL_LINK_TYPES = ['created', 'matched', 'manual', 'transferred'];
+/** Sync direction types matching DB constraint on external_task_links.sync_direction. */
+export const SYNC_DIRECTIONS = ['inbound', 'outbound', 'bidirectional'];
+// === TASKS TABLE ===
+export const tasks = sqliteTable('tasks', {
+    id: text('id').primaryKey(),
+    title: text('title').notNull(),
+    description: text('description'),
+    status: text('status', {
+        enum: TASK_STATUSES,
+    })
+        .notNull()
+        .default('pending'),
+    priority: text('priority', {
+        enum: TASK_PRIORITIES,
+    })
+        .notNull()
+        .default('medium'),
+    type: text('type', { enum: TASK_TYPES }),
+    parentId: text('parent_id').references(() => tasks.id, {
+        onDelete: 'set null',
+    }),
+    phase: text('phase'),
+    size: text('size', { enum: TASK_SIZES }),
+    position: integer('position'),
+    positionVersion: integer('position_version').default(0),
+    // JSON-serialized complex fields (avoids excessive normalization)
+    labelsJson: text('labels_json').default('[]'),
+    notesJson: text('notes_json').default('[]'),
+    acceptanceJson: text('acceptance_json').default('[]'),
+    filesJson: text('files_json').default('[]'),
+    // Provenance
+    origin: text('origin'),
+    blockedBy: text('blocked_by'),
+    epicLifecycle: text('epic_lifecycle'),
+    noAutoComplete: integer('no_auto_complete', { mode: 'boolean' }),
+    // Timestamps
+    createdAt: text('created_at').notNull().default(sql `(datetime('now'))`),
+    updatedAt: text('updated_at'),
+    completedAt: text('completed_at'),
+    cancelledAt: text('cancelled_at'),
+    cancellationReason: text('cancellation_reason'),
+    // Archive metadata (populated when status = 'archived')
+    archivedAt: text('archived_at'),
+    archiveReason: text('archive_reason'),
+    cycleTimeDays: integer('cycle_time_days'),
+    // Verification (JSON-serialized)
+    verificationJson: text('verification_json'),
+    // Provenance tracking
+    createdBy: text('created_by'),
+    modifiedBy: text('modified_by'),
+    sessionId: text('session_id').references(() => sessions.id, {
+        onDelete: 'set null',
+    }),
+    // T060: pipeline stage name (RCASD-IVTR+C). Stored as a plain stage name string.
+    // Not referencing lifecycle_stages.id so that stage binding works without
+    // requiring a lifecycle pipeline record for every task.
+    pipelineStage: text('pipeline_stage'),
+    /** Agent ID that has claimed/is assigned to this task. */
+    assignee: text('assignee'),
+}, (table) => [
+    index('idx_tasks_status').on(table.status),
+    index('idx_tasks_parent_id').on(table.parentId),
+    index('idx_tasks_phase').on(table.phase),
+    index('idx_tasks_type').on(table.type),
+    index('idx_tasks_priority').on(table.priority),
+    index('idx_tasks_session_id').on(table.sessionId),
+    index('idx_tasks_pipeline_stage').on(table.pipelineStage),
+    index('idx_tasks_assignee').on(table.assignee),
+    // T033 composite indexes
+    index('idx_tasks_parent_status').on(table.parentId, table.status),
+    index('idx_tasks_status_priority').on(table.status, table.priority),
+    index('idx_tasks_type_phase').on(table.type, table.phase),
+    index('idx_tasks_status_archive_reason').on(table.status, table.archiveReason),
+]);
+// === TASK DEPENDENCIES ===
+export const taskDependencies = sqliteTable('task_dependencies', {
+    taskId: text('task_id')
+        .notNull()
+        .references(() => tasks.id, { onDelete: 'cascade' }),
+    dependsOn: text('depends_on')
+        .notNull()
+        .references(() => tasks.id, { onDelete: 'cascade' }),
+}, (table) => [
+    primaryKey({ columns: [table.taskId, table.dependsOn] }),
+    index('idx_deps_depends_on').on(table.dependsOn),
+]);
+// === TASK RELATIONS ===
+export const taskRelations = sqliteTable('task_relations', {
+    taskId: text('task_id')
+        .notNull()
+        .references(() => tasks.id, { onDelete: 'cascade' }),
+    relatedTo: text('related_to')
+        .notNull()
+        .references(() => tasks.id, { onDelete: 'cascade' }),
+    relationType: text('relation_type', {
+        enum: TASK_RELATION_TYPES,
+    })
+        .notNull()
+        .default('related'),
+    reason: text('reason'),
+}, (table) => [
+    primaryKey({ columns: [table.taskId, table.relatedTo] }),
+    index('idx_task_relations_related_to').on(table.relatedTo),
+]);
+// === SESSIONS ===
+export const sessions = sqliteTable('sessions', {
+    id: text('id').primaryKey(),
+    name: text('name').notNull(),
+    status: text('status', {
+        enum: SESSION_STATUSES,
+    })
+        .notNull()
+        .default('active'),
+    scopeJson: text('scope_json').notNull().default('{}'),
+    currentTask: text('current_task').references(() => tasks.id, {
+        onDelete: 'set null',
+    }),
+    taskStartedAt: text('task_started_at'),
+    agent: text('agent'),
+    notesJson: text('notes_json').default('[]'),
+    tasksCompletedJson: text('tasks_completed_json').default('[]'),
+    tasksCreatedJson: text('tasks_created_json').default('[]'),
+    handoffJson: text('handoff_json'),
+    startedAt: text('started_at').notNull().default(sql `(datetime('now'))`),
+    endedAt: text('ended_at'),
+    // Session chain columns (T4959)
+    previousSessionId: text('previous_session_id').references(() => sessions.id, {
+        onDelete: 'set null',
+    }),
+    nextSessionId: text('next_session_id').references(() => sessions.id, {
+        onDelete: 'set null',
+    }),
+    agentIdentifier: text('agent_identifier'),
+    handoffConsumedAt: text('handoff_consumed_at'),
+    handoffConsumedBy: text('handoff_consumed_by'),
+    debriefJson: text('debrief_json'),
+    // Provider adapter tracking (T5240)
+    providerId: text('provider_id'),
+    // Session stats columns (type unification)
+    statsJson: text('stats_json'),
+    resumeCount: integer('resume_count'),
+    gradeMode: integer('grade_mode'),
+}, (table) => [
+    index('idx_sessions_status').on(table.status),
+    index('idx_sessions_previous').on(table.previousSessionId),
+    index('idx_sessions_agent_identifier').on(table.agentIdentifier),
+    index('idx_sessions_started_at').on(table.startedAt),
+    // T033 composite index: getActiveSession hot path
+    index('idx_sessions_status_started_at').on(table.status, table.startedAt),
+]);
+// === TASK WORK HISTORY ===
+export const taskWorkHistory = sqliteTable('task_work_history', {
+    id: integer('id').primaryKey({ autoIncrement: true }),
+    sessionId: text('session_id')
+        .notNull()
+        .references(() => sessions.id, { onDelete: 'cascade' }),
+    taskId: text('task_id')
+        .notNull()
+        .references(() => tasks.id, { onDelete: 'cascade' }),
+    setAt: text('set_at').notNull().default(sql `(datetime('now'))`),
+    clearedAt: text('cleared_at'),
+}, (table) => [index('idx_work_history_session').on(table.sessionId)]);
+// === LIFECYCLE PIPELINES ===
+export const lifecyclePipelines = sqliteTable('lifecycle_pipelines', {
+    id: text('id').primaryKey(),
+    taskId: text('task_id')
+        .notNull()
+        .references(() => tasks.id, { onDelete: 'cascade' }),
+    status: text('status', {
+        enum: LIFECYCLE_PIPELINE_STATUSES,
+    })
+        .notNull()
+        .default('active'),
+    currentStageId: text('current_stage_id'),
+    startedAt: text('started_at').notNull().default(sql `(datetime('now'))`),
+    completedAt: text('completed_at'),
+    updatedAt: text('updated_at').default(sql `(datetime('now'))`),
+    version: integer('version').notNull().default(1),
+}, (table) => [
+    index('idx_lifecycle_pipelines_task_id').on(table.taskId),
+    index('idx_lifecycle_pipelines_status').on(table.status),
+]);
+// === LIFECYCLE STAGES ===
+export const lifecycleStages = sqliteTable('lifecycle_stages', {
+    id: text('id').primaryKey(),
+    pipelineId: text('pipeline_id')
+        .notNull()
+        .references(() => lifecyclePipelines.id, { onDelete: 'cascade' }),
+    stageName: text('stage_name', { enum: LIFECYCLE_STAGE_NAMES }).notNull(),
+    status: text('status', {
+        enum: LIFECYCLE_STAGE_STATUSES,
+    })
+        .notNull()
+        .default('not_started'),
+    sequence: integer('sequence').notNull(),
+    startedAt: text('started_at'),
+    completedAt: text('completed_at'),
+    blockedAt: text('blocked_at'),
+    blockReason: text('block_reason'),
+    skippedAt: text('skipped_at'),
+    skipReason: text('skip_reason'),
+    notesJson: text('notes_json').default('[]'),
+    metadataJson: text('metadata_json').default('{}'),
+    // RCASD provenance tracking columns (T5100)
+    outputFile: text('output_file'),
+    createdBy: text('created_by'),
+    validatedBy: text('validated_by'),
+    validatedAt: text('validated_at'),
+    validationStatus: text('validation_status', {
+        enum: ['pending', 'in_review', 'approved', 'rejected', 'needs_revision'],
+    }),
+    provenanceChainJson: text('provenance_chain_json'),
+}, (table) => [
+    index('idx_lifecycle_stages_pipeline_id').on(table.pipelineId),
+    index('idx_lifecycle_stages_stage_name').on(table.stageName),
+    index('idx_lifecycle_stages_status').on(table.status),
+    index('idx_lifecycle_stages_validated_by').on(table.validatedBy),
+]);
+// === LIFECYCLE GATE RESULTS ===
+export const lifecycleGateResults = sqliteTable('lifecycle_gate_results', {
+    id: text('id').primaryKey(),
+    stageId: text('stage_id')
+        .notNull()
+        .references(() => lifecycleStages.id, { onDelete: 'cascade' }),
+    gateName: text('gate_name').notNull(),
+    result: text('result', {
+        enum: LIFECYCLE_GATE_RESULTS,
+    }).notNull(),
+    checkedAt: text('checked_at').notNull().default(sql `(datetime('now'))`),
+    checkedBy: text('checked_by').notNull(),
+    details: text('details'),
+    reason: text('reason'),
+}, (table) => [index('idx_lifecycle_gate_results_stage_id').on(table.stageId)]);
+// === LIFECYCLE EVIDENCE ===
+export const lifecycleEvidence = sqliteTable('lifecycle_evidence', {
+    id: text('id').primaryKey(),
+    stageId: text('stage_id')
+        .notNull()
+        .references(() => lifecycleStages.id, { onDelete: 'cascade' }),
+    uri: text('uri').notNull(),
+    type: text('type', {
+        enum: LIFECYCLE_EVIDENCE_TYPES,
+    }).notNull(),
+    recordedAt: text('recorded_at').notNull().default(sql `(datetime('now'))`),
+    recordedBy: text('recorded_by'),
+    description: text('description'),
+}, (table) => [index('idx_lifecycle_evidence_stage_id').on(table.stageId)]);
+// === LIFECYCLE TRANSITIONS ===
+export const lifecycleTransitions = sqliteTable('lifecycle_transitions', {
+    id: text('id').primaryKey(),
+    pipelineId: text('pipeline_id')
+        .notNull()
+        .references(() => lifecyclePipelines.id, { onDelete: 'cascade' }),
+    fromStageId: text('from_stage_id')
+        .notNull()
+        .references(() => lifecycleStages.id, { onDelete: 'cascade' }),
+    toStageId: text('to_stage_id')
+        .notNull()
+        .references(() => lifecycleStages.id, { onDelete: 'cascade' }),
+    transitionType: text('transition_type', {
+        enum: LIFECYCLE_TRANSITION_TYPES,
+    })
+        .notNull()
+        .default('automatic'),
+    transitionedBy: text('transitioned_by'),
+    createdAt: text('created_at').notNull().default(sql `(datetime('now'))`),
+}, (table) => [index('idx_lifecycle_transitions_pipeline_id').on(table.pipelineId)]);
+// === MANIFEST ENTRIES (RCASD provenance — T5100) ===
+export const manifestEntries = sqliteTable('manifest_entries', {
+    id: text('id').primaryKey(),
+    pipelineId: text('pipeline_id').references(() => lifecyclePipelines.id, {
+        onDelete: 'cascade',
+    }),
+    stageId: text('stage_id').references(() => lifecycleStages.id, { onDelete: 'cascade' }),
+    title: text('title').notNull(),
+    date: text('date').notNull(),
+    status: text('status', { enum: MANIFEST_STATUSES }).notNull(),
+    agentType: text('agent_type'),
+    outputFile: text('output_file'),
+    topicsJson: text('topics_json').default('[]'),
+    findingsJson: text('findings_json').default('[]'),
+    linkedTasksJson: text('linked_tasks_json').default('[]'),
+    createdBy: text('created_by'),
+    createdAt: text('created_at').notNull().default(sql `(datetime('now'))`),
+}, (table) => [
+    index('idx_manifest_entries_pipeline_id').on(table.pipelineId),
+    index('idx_manifest_entries_stage_id').on(table.stageId),
+    index('idx_manifest_entries_status').on(table.status),
+]);
+// === PIPELINE MANIFEST (T5581) ===
+export const pipelineManifest = sqliteTable('pipeline_manifest', {
+    id: text('id').primaryKey(),
+    sessionId: text('session_id').references(() => sessions.id, { onDelete: 'set null' }),
+    taskId: text('task_id').references(() => tasks.id, { onDelete: 'set null' }),
+    epicId: text('epic_id').references(() => tasks.id, { onDelete: 'set null' }),
+    type: text('type').notNull(),
+    content: text('content').notNull(),
+    contentHash: text('content_hash'),
+    status: text('status').notNull().default('active'),
+    distilled: integer('distilled', { mode: 'boolean' }).notNull().default(false),
+    brainObsId: text('brain_obs_id'),
+    sourceFile: text('source_file'),
+    metadataJson: text('metadata_json'),
+    createdAt: text('created_at').notNull(),
+    archivedAt: text('archived_at'),
+}, (table) => [
+    index('idx_pipeline_manifest_task_id').on(table.taskId),
+    index('idx_pipeline_manifest_session_id').on(table.sessionId),
+    index('idx_pipeline_manifest_distilled').on(table.distilled),
+    index('idx_pipeline_manifest_status').on(table.status),
+    index('idx_pipeline_manifest_content_hash').on(table.contentHash),
+]);
+// === RELEASE MANIFESTS (T5580) ===
+export const releaseManifests = sqliteTable('release_manifests', {
+    id: text('id').primaryKey(),
+    version: text('version').notNull().unique(),
+    status: text('status').notNull().default('draft'),
+    pipelineId: text('pipeline_id').references(() => lifecyclePipelines.id, {
+        onDelete: 'set null',
+    }),
+    epicId: text('epic_id').references(() => tasks.id, { onDelete: 'set null' }),
+    tasksJson: text('tasks_json').notNull().default('[]'),
+    changelog: text('changelog'),
+    notes: text('notes'),
+    previousVersion: text('previous_version'),
+    commitSha: text('commit_sha'),
+    gitTag: text('git_tag'),
+    npmDistTag: text('npm_dist_tag'),
+    createdAt: text('created_at').notNull(),
+    preparedAt: text('prepared_at'),
+    committedAt: text('committed_at'),
+    taggedAt: text('tagged_at'),
+    pushedAt: text('pushed_at'),
+}, (table) => [
+    index('idx_release_manifests_status').on(table.status),
+    index('idx_release_manifests_version').on(table.version),
+]);
+// === SCHEMA METADATA ===
+export const schemaMeta = sqliteTable('schema_meta', {
+    key: text('key').primaryKey(),
+    value: text('value').notNull(),
+});
+// === AUDIT LOG ===
+/**
+ * Task change audit log — stores every add/update/complete/delete/archive operation.
+ * Migrated from legacy JSONL task logs to SQLite per ADR-006/ADR-012.
+ * No FK on taskId — log entries must survive task deletion.
+ *
+ * @task T4837
+ */
+export const auditLog = sqliteTable('audit_log', {
+    id: text('id').primaryKey(),
+    timestamp: text('timestamp').notNull().default(sql `(datetime('now'))`),
+    action: text('action').notNull(),
+    taskId: text('task_id').notNull(),
+    actor: text('actor').notNull().default('system'),
+    detailsJson: text('details_json').default('{}'),
+    beforeJson: text('before_json'),
+    afterJson: text('after_json'),
+    // Dispatch layer columns (migration 20260225200000_audit-log-dispatch-columns)
+    domain: text('domain'),
+    operation: text('operation'),
+    sessionId: text('session_id'),
+    requestId: text('request_id'),
+    durationMs: integer('duration_ms'),
+    success: integer('success'),
+    source: text('source'),
+    gateway: text('gateway'),
+    errorMessage: text('error_message'),
+    // Project correlation (T5334)
+    projectHash: text('project_hash'),
+}, (table) => [
+    index('idx_audit_log_task_id').on(table.taskId),
+    index('idx_audit_log_action').on(table.action),
+    index('idx_audit_log_timestamp').on(table.timestamp),
+    index('idx_audit_log_domain').on(table.domain),
+    index('idx_audit_log_request_id').on(table.requestId),
+    index('idx_audit_log_project_hash').on(table.projectHash),
+    index('idx_audit_log_actor').on(table.actor),
+    // T033 composite indexes
+    index('idx_audit_log_session_timestamp').on(table.sessionId, table.timestamp),
+    index('idx_audit_log_domain_operation').on(table.domain, table.operation),
+]);
+// === TOKEN USAGE ===
+/**
+ * Central provider-aware token telemetry for CLI, MCP, and external adapters.
+ * Stores measured request/response token counts plus method/confidence metadata.
+ */
+export const tokenUsage = sqliteTable('token_usage', {
+    id: text('id').primaryKey(),
+    createdAt: text('created_at').notNull().default(sql `(datetime('now'))`),
+    provider: text('provider').notNull().default('unknown'),
+    model: text('model'),
+    transport: text('transport', { enum: TOKEN_USAGE_TRANSPORTS }).notNull().default('unknown'),
+    gateway: text('gateway'),
+    domain: text('domain'),
+    operation: text('operation'),
+    sessionId: text('session_id').references(() => sessions.id, { onDelete: 'set null' }),
+    taskId: text('task_id').references(() => tasks.id, { onDelete: 'set null' }),
+    requestId: text('request_id'),
+    inputChars: integer('input_chars').notNull().default(0),
+    outputChars: integer('output_chars').notNull().default(0),
+    inputTokens: integer('input_tokens').notNull().default(0),
+    outputTokens: integer('output_tokens').notNull().default(0),
+    totalTokens: integer('total_tokens').notNull().default(0),
+    method: text('method', { enum: TOKEN_USAGE_METHODS }).notNull().default('heuristic'),
+    confidence: text('confidence', { enum: TOKEN_USAGE_CONFIDENCE }).notNull().default('coarse'),
+    requestHash: text('request_hash'),
+    responseHash: text('response_hash'),
+    metadataJson: text('metadata_json').notNull().default('{}'),
+}, (table) => [
+    index('idx_token_usage_created_at').on(table.createdAt),
+    index('idx_token_usage_request_id').on(table.requestId),
+    index('idx_token_usage_session_id').on(table.sessionId),
+    index('idx_token_usage_task_id').on(table.taskId),
+    index('idx_token_usage_provider').on(table.provider),
+    index('idx_token_usage_transport').on(table.transport),
+    index('idx_token_usage_domain_operation').on(table.domain, table.operation),
+    index('idx_token_usage_method').on(table.method),
+    index('idx_token_usage_gateway').on(table.gateway),
+]);
+// === ARCHITECTURE DECISIONS ===
+/**
+ * Architecture Decision Records (ADRs) stored in the database.
+ * Corresponds to the physical ADR markdown files in .cleo/adrs/.
+ * Self-referential FKs (supersedes_id, superseded_by_id, amends_id) are
+ * enforced at the DB level by T033 migration.
+ */
+export const architectureDecisions = sqliteTable('architecture_decisions', {
+    id: text('id').primaryKey(),
+    title: text('title').notNull(),
+    status: text('status', { enum: ADR_STATUSES }).notNull().default('proposed'),
+    supersedesId: text('supersedes_id').references(() => architectureDecisions.id, { onDelete: 'set null' }),
+    supersededById: text('superseded_by_id').references(() => architectureDecisions.id, { onDelete: 'set null' }),
+    consensusManifestId: text('consensus_manifest_id').references(() => manifestEntries.id, { onDelete: 'set null' }),
+    content: text('content').notNull(),
+    createdAt: text('created_at').notNull().default(sql `(datetime('now'))`),
+    updatedAt: text('updated_at'),
+    // ADR-017 §5.3 extension columns
+    date: text('date').notNull().default(''),
+    acceptedAt: text('accepted_at'),
+    gate: text('gate', { enum: ['HITL', 'automated'] }),
+    gateStatus: text('gate_status', { enum: GATE_STATUSES }),
+    amendsId: text('amends_id').references(() => architectureDecisions.id, {
+        onDelete: 'set null',
+    }),
+    filePath: text('file_path').notNull().default(''),
+    // ADR-017 §5.4 cognitive search columns (T4942)
+    summary: text('summary'),
+    keywords: text('keywords'),
+    topics: text('topics'),
+}, (table) => [
+    index('idx_arch_decisions_status').on(table.status),
+    index('idx_arch_decisions_amends_id').on(table.amendsId),
+]);
+// === ADR JUNCTION TABLES (ADR-017 §5.3) ===
+/** ADR-to-Task links (soft FK — tasks can be purged) */
+export const adrTaskLinks = sqliteTable('adr_task_links', {
+    adrId: text('adr_id')
+        .notNull()
+        .references(() => architectureDecisions.id, { onDelete: 'cascade' }),
+    taskId: text('task_id')
+        .notNull()
+        .references(() => tasks.id, { onDelete: 'cascade' }),
+    linkType: text('link_type', {
+        enum: ['related', 'governed_by', 'implements'],
+    })
+        .notNull()
+        .default('related'),
+}, (table) => [
+    primaryKey({ columns: [table.adrId, table.taskId] }),
+    index('idx_adr_task_links_task_id').on(table.taskId),
+]);
+/** ADR cross-reference relationships */
+export const adrRelations = sqliteTable('adr_relations', {
+    fromAdrId: text('from_adr_id')
+        .notNull()
+        .references(() => architectureDecisions.id, { onDelete: 'cascade' }),
+    toAdrId: text('to_adr_id')
+        .notNull()
+        .references(() => architectureDecisions.id, { onDelete: 'cascade' }),
+    relationType: text('relation_type', {
+        enum: ['supersedes', 'amends', 'related'],
+    }).notNull(),
+}, (table) => [primaryKey({ columns: [table.fromAdrId, table.toAdrId, table.relationType] })]);
+// === EXTERNAL TASK LINKS (provider-agnostic task reconciliation) ===
+/**
+ * Tracks links between CLEO tasks and external system tasks (Linear, Jira, GitHub, etc.).
+ * Used by the reconciliation engine to match external tasks to existing CLEO tasks,
+ * detect updates, and maintain bidirectional traceability.
+ *
+ * Each row represents one link: one CLEO task ↔ one external task from one provider.
+ * A CLEO task MAY have links from multiple providers (e.g., both Linear and GitHub).
+ * An external task SHOULD have at most one link per provider.
+ */
+export const externalTaskLinks = sqliteTable('external_task_links', {
+    id: text('id').primaryKey(),
+    taskId: text('task_id')
+        .notNull()
+        .references(() => tasks.id, { onDelete: 'cascade' }),
+    /** Provider identifier (e.g. 'linear', 'jira', 'github', 'gitlab'). */
+    providerId: text('provider_id').notNull(),
+    /** Provider-assigned identifier for the external task (opaque to CLEO). */
+    externalId: text('external_id').notNull(),
+    /** Optional URL to the external task (for human navigation). */
+    externalUrl: text('external_url'),
+    /** Title of the external task at the time of last sync. */
+    externalTitle: text('external_title'),
+    /** How this link was established. */
+    linkType: text('link_type', {
+        enum: EXTERNAL_LINK_TYPES,
+    }).notNull(),
+    /** Direction of the sync that created this link. */
+    syncDirection: text('sync_direction', {
+        enum: SYNC_DIRECTIONS,
+    })
+        .notNull()
+        .default('inbound'),
+    /** Arbitrary provider-specific metadata (JSON). */
+    metadataJson: text('metadata_json').default('{}'),
+    /** When the link was first established. */
+    linkedAt: text('linked_at').notNull().default(sql `(datetime('now'))`),
+    /** When the external task was last synchronized. */
+    lastSyncAt: text('last_sync_at'),
+}, (table) => [
+    index('idx_ext_links_task_id').on(table.taskId),
+    index('idx_ext_links_provider_external').on(table.providerId, table.externalId),
+    index('idx_ext_links_provider_id').on(table.providerId),
+    unique('uq_ext_links_task_provider_external').on(table.taskId, table.providerId, table.externalId),
+]);
+// === STATUS REGISTRY (ADR-018) ===
+export const statusRegistryTable = sqliteTable('status_registry', {
+    name: text('name').notNull(),
+    entityType: text('entity_type', {
+        enum: ['task', 'session', 'lifecycle_pipeline', 'lifecycle_stage', 'adr', 'gate', 'manifest'],
+    }).notNull(),
+    namespace: text('namespace', { enum: ['workflow', 'governance', 'manifest'] }).notNull(),
+    description: text('description').notNull(),
+    isTerminal: integer('is_terminal', { mode: 'boolean' }).notNull().default(false),
+}, (table) => [
+    primaryKey({ columns: [table.name, table.entityType] }),
+    index('idx_status_registry_entity_type').on(table.entityType),
+    index('idx_status_registry_namespace').on(table.namespace),
+]);
+// === AGENT CREDENTIALS (Unified Agent Registry — T170/T173) ===
+/**
+ * Agent credentials for the unified agent registry.
+ * Stores encrypted API keys and transport configuration for registered agents.
+ * Replaces loose JSON config files (legacy clawmsgr-*.json format).
+ *
+ * @see docs/specs/SIGNALDOCK-UNIFIED-AGENT-REGISTRY.md Section 3.1
+ */
+export const agentCredentials = sqliteTable('agent_credentials', {
+    agentId: text('agent_id').primaryKey(),
+    displayName: text('display_name').notNull(),
+    /** API key encrypted at rest using AES-256-GCM with machine-bound key. */
+    apiKeyEncrypted: text('api_key_encrypted').notNull(),
+    apiBaseUrl: text('api_base_url').notNull().default('https://api.signaldock.io'),
+    classification: text('classification'),
+    privacyTier: text('privacy_tier').notNull().default('public'),
+    /** JSON array of capability slugs. */
+    capabilities: text('capabilities').notNull().default('[]'),
+    /** JSON array of skill slugs. */
+    skills: text('skills').notNull().default('[]'),
+    /** JSON object with transport-specific settings. */
+    transportConfig: text('transport_config').notNull().default('{}'),
+    isActive: integer('is_active', { mode: 'boolean' }).notNull().default(true),
+    lastUsedAt: integer('last_used_at'),
+    createdAt: integer('created_at').notNull(),
+    updatedAt: integer('updated_at').notNull(),
+}, (table) => [
+    index('idx_agent_credentials_active').on(table.isActive),
+    index('idx_agent_credentials_last_used').on(table.lastUsedAt),
+]);
+//# sourceMappingURL=tasks-schema.js.map