@aquex/cmos-mcp 1.0.0

package/dist/tools/cmos/schema-migrations.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Schema migrations for CMOS database evolution.
+ *
+ * Handles backward-compatible schema changes via ALTER TABLE
+ * with soft column detection (PRAGMA table_info).
+ *
+ * @module tools/cmos/schema-migrations
+ */
+import type { CmosDatabaseClient } from './client';
+/**
+ * Valid decision categories.
+ */
+export declare const DECISION_CATEGORIES: readonly ["architectural", "process", "tooling", "design", "business"];
+export type DecisionCategory = (typeof DECISION_CATEGORIES)[number];
+/**
+ * Valid decision statuses.
+ */
+export declare const DECISION_STATUSES: readonly ["active", "superseded", "archived"];
+export type DecisionStatus = (typeof DECISION_STATUSES)[number];
+export interface MigrationResult {
+    columnsAdded: string[];
+    indexesCreated: string[];
+    rowsUpdated: number;
+    alreadyCurrent: boolean;
+}
+/**
+ * Run the strategic_decisions v2.1 migration.
+ *
+ * Adds category, superseded_by, status, evidence columns.
+ * Sets status='active' on existing rows where status is NULL.
+ * Creates indexes on status, category, and mission_id.
+ *
+ * Safe to call multiple times (idempotent).
+ */
+export declare function migrateStrategicDecisionsV21(client: CmosDatabaseClient): MigrationResult;
+/**
+ * Run all pending migrations for the strategic_decisions table.
+ * Currently only v2.1 migration exists.
+ */
+export declare function ensureStrategicDecisionsSchema(client: CmosDatabaseClient): MigrationResult;
+/**
+ * Ensure missions table has timestamp columns.
+ * Adds created_at, started_at, updated_at if missing.
+ *
+ * Safe to call multiple times (idempotent).
+ */
+export declare function ensureMissionTimestamps(client: CmosDatabaseClient): MigrationResult;
+/**
+ * Valid learning categories.
+ */
+export declare const LEARNING_CATEGORIES: readonly ["technical", "process", "agent-behavior", "tooling"];
+export type LearningCategory = (typeof LEARNING_CATEGORIES)[number];
+/**
+ * Ensure the learnings table exists.
+ * Creates the table and indexes if they don't exist, and runs the lazy
+ * column-level migrations (`evergreen` — Sprint 61 m03) on pre-existing tables.
+ *
+ * Sprint 61 m03 — `evergreen INTEGER DEFAULT 0` is now part of the canonical
+ * schema. It is set to 1 by an operator (or by `cmos_learnings(action="update",
+ * evergreen=true)`) on institutional-rule learnings that should never trip the
+ * staleness signal. The staleness query gates on `evergreen = 0` so flagged
+ * institutional rules drop out of the pile entirely.
+ *
+ * MUST be called on read paths in addition to write paths — un-migrated DBs
+ * would otherwise hit `no such column: evergreen` the first time the staleness
+ * query runs against learnings.
+ *
+ * Safe to call multiple times (idempotent).
+ */
+export declare function ensureLearningsTable(client: CmosDatabaseClient): MigrationResult;
+/**
+ * Run the content_hash migration (v2.2).
+ *
+ * Adds content_hash column to strategic_decisions and learnings tables.
+ * Computes SHA-256 hashes for existing records.
+ *
+ * Safe to call multiple times (idempotent).
+ */
+export declare function migrateContentHash(client: CmosDatabaseClient): MigrationResult;
+/**
+ * Ensure session_id exists on learnings and strategic_decisions so sprint-close
+ * archival can cross-reference sessions. Idempotent.
+ */
+export declare function ensureArchivalColumns(client: CmosDatabaseClient): MigrationResult;
+/**
+ * Ensure last_reviewed_at columns exist on learnings and strategic_decisions.
+ * Idempotent — safe to call on DBs where the column already exists.
+ */
+export declare function ensureReviewTimestamps(client: CmosDatabaseClient): MigrationResult;
+/**
+ * Compute a SHA-256 content hash for dedup.
+ * Uses canonical JSON of (text, domain) for consistent hashing.
+ */
+export declare function computeContentHash(text: string, domain: string): string;
+/**
+ * Ensure the FTS5 virtual table for decisions exists and is synced.
+ *
+ * Creates:
+ * - decisions_fts FTS5 virtual table (content-external, synced with strategic_decisions)
+ * - Triggers for auto-sync on INSERT, UPDATE, DELETE
+ *
+ * Safe to call multiple times (idempotent).
+ */
+/**
+ * Ensure the session_missions junction table exists.
+ * Creates the table and index if they don't exist.
+ *
+ * Safe to call multiple times (idempotent).
+ */
+export declare function ensureSessionMissionsTable(client: CmosDatabaseClient): MigrationResult;
+/**
+ * Valid next-step statuses.
+ */
+export declare const NEXT_STEP_STATUSES: readonly ["pending", "completed", "carried", "dropped"];
+export type NextStepStatus = (typeof NEXT_STEP_STATUSES)[number];
+/**
+ * Ensure the next_steps table exists.
+ * Creates the table and indexes if they don't exist.
+ *
+ * Safe to call multiple times (idempotent).
+ */
+export declare function ensureNextStepsTable(client: CmosDatabaseClient): MigrationResult;
+/**
+ * Valid constraint statuses.
+ */
+export declare const CONSTRAINT_STATUSES: readonly ["active", "archived", "expired"];
+export type ConstraintStatus = (typeof CONSTRAINT_STATUSES)[number];
+/**
+ * Ensure the constraints table exists.
+ * Creates the table and indexes if they don't exist.
+ *
+ * Safe to call multiple times (idempotent).
+ */
+export declare function ensureConstraintsTable(client: CmosDatabaseClient): MigrationResult;
+export declare function ensureDecisionsFts5(client: CmosDatabaseClient): MigrationResult;
+/**
+ * Valid statuses for agent_feedback rows.
+ *
+ * Sprint 56 m03 — the agentFeedback standing-channel lets agents report UX
+ * issues or improvement ideas from high-friction surfaces without being
+ * prompted. Human operator triages periodically.
+ */
+export declare const AGENT_FEEDBACK_STATUSES: readonly ["open", "triaged", "resolved", "archived"];
+export type AgentFeedbackStatus = (typeof AGENT_FEEDBACK_STATUSES)[number];
+/**
+ * Ensure the agent_feedback table exists (Sprint 56 m03).
+ *
+ * Holds free-text UX reports emitted by agents through the `agentFeedback`
+ * parameter on cmos_session(complete), cmos_mission_transition(complete),
+ * and cmos_agent_onboard. Kept as a dedicated table rather than reusing
+ * session captures so the triage surface (cmos_feedback) can filter/sort
+ * without entangling sprint-close capture aggregation.
+ *
+ * Safe to call multiple times (idempotent).
+ */
+export declare function ensureAgentFeedbackTable(client: CmosDatabaseClient): MigrationResult;
+//# sourceMappingURL=schema-migrations.d.ts.map

package/dist/tools/cmos/schema-migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-migrations.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/schema-migrations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,mBAAmB,wEAMtB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,iBAAiB,+CAAgD,CAAC;AAE/E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAqEhE,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CAgDxF;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CAE1F;AAWD;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CAqBnF;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,gEAAiE,CAAC;AAElG,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CAgEhF;AA6BD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CAkE9E;AAgBD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CAejF;AAcD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CAiBlF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED;;;;;;;;GAQG;AACH;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CA6BtF;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,yDAA0D,CAAC;AAE1F,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CAgDhF;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,4CAA6C,CAAC;AAE9E,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CA+ClF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CAgE/E;AAED;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,sDAAuD,CAAC;AAC5F,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3E;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,GAAG,eAAe,CAiDpF"}