@mc1global/opencode-jarvis 0.13.1 → 0.14.0

package/src/domain/kanban/schema.sql

@@ -1,340 +0,0 @@
--- Kanban Schema - SQLite database for Agile+Kanban workflow
--- Separate bounded context from context_memory
--- Schema Version: 1.4.0
-
--- Schema metadata for version tracking (must be first)
-CREATE TABLE IF NOT EXISTS schema_meta (
-    version TEXT PRIMARY KEY,
-    applied_at TEXT DEFAULT (datetime('now', 'utc') || 'Z'),
-    description TEXT
-);
-
--- Insert current version if not exists
-INSERT OR IGNORE INTO schema_meta (version, description)
-VALUES ('1.4.0', 'Add token_usage table for agent metrics tracking');
-
--- Sprints table
-CREATE TABLE IF NOT EXISTS sprints (
-    id TEXT PRIMARY KEY,                    -- SP-001
-    workspace TEXT NOT NULL,
-    name TEXT NOT NULL,
-    goal TEXT,
-    start_date TEXT NOT NULL,
-    end_date TEXT NOT NULL,
-    status TEXT NOT NULL DEFAULT 'planning' CHECK(status IN (
-        'planning', 'active', 'closed', 'cancelled'
-    )),
-    velocity_planned INTEGER DEFAULT 0,
-    velocity_actual INTEGER DEFAULT 0,
-    created_at TEXT DEFAULT (datetime('now', 'utc') || 'Z'),
-    updated_at TEXT DEFAULT (datetime('now', 'utc') || 'Z')
-);
-
--- Epics table (feature groups)
-CREATE TABLE IF NOT EXISTS epics (
-    id TEXT PRIMARY KEY,                    -- EP-001
-    workspace TEXT NOT NULL,
-    title TEXT NOT NULL,
-    description TEXT,
-    priority TEXT DEFAULT 'medium' CHECK(priority IN ('high', 'medium', 'low')),
-    status TEXT NOT NULL DEFAULT 'backlog' CHECK(status IN (
-        'backlog', 'grooming', 'ready', 'doing', 'done', 'archived'
-    )),
-    owner TEXT,
-    created_at TEXT DEFAULT (datetime('now', 'utc') || 'Z'),
-    updated_at TEXT DEFAULT (datetime('now', 'utc') || 'Z')
-);
-
--- Cards table (stories/tasks)
-CREATE TABLE IF NOT EXISTS cards (
-    id TEXT PRIMARY KEY,                    -- CD-001
-    workspace TEXT NOT NULL,
-    epic_id TEXT REFERENCES epics(id),
-    sprint_id TEXT REFERENCES sprints(id),
-    user_story_id TEXT,                     -- ST-XXX reference for Story-Card binding
-    title TEXT NOT NULL,
-    description TEXT,
-
-    -- User story format (optional, for inline definition)
-    as_a TEXT,
-    i_want TEXT,
-    so_that TEXT,
-
-    -- Kanban workflow
-    status TEXT NOT NULL DEFAULT 'backlog' CHECK(status IN (
-        'backlog', 'grooming', 'ready', 'doing', 'review',
-        'tested', 'blocked', 'done', 'rejected', 'archived'
-    )),
-    previous_status TEXT,                   -- For unblocking
-
-    -- Assignment
-    assigned_agent TEXT,
-
-    -- Estimation
-    priority TEXT DEFAULT 'medium' CHECK(priority IN ('high', 'medium', 'low')),
-    story_points INTEGER CHECK(story_points IN (1, 2, 3, 5, 8, 13, 21)),
-
-    -- Review tracking (reflection technique)
-    review_iterations INTEGER DEFAULT 0,
-    max_review_iterations INTEGER DEFAULT 4,
-
-    -- Flags
-    parallel_safe INTEGER DEFAULT 0,        -- Can be worked in parallel
-
-    -- Grooming tracking
-    grooming_completed INTEGER DEFAULT 0,   -- 1 = grooming done, can move to ready
-    grooming_artifacts_count INTEGER DEFAULT 0,
-    grooming_at TEXT,                       -- When grooming was completed
-
-    -- Timestamps
-    created_at TEXT DEFAULT (datetime('now', 'utc') || 'Z'),
-    updated_at TEXT DEFAULT (datetime('now', 'utc') || 'Z'),
-    started_at TEXT,                        -- When moved to 'doing'
-    completed_at TEXT                       -- When moved to 'done'
-);
-
--- Acceptance Criteria
-CREATE TABLE IF NOT EXISTS acceptance_criteria (
-    id TEXT PRIMARY KEY,                    -- AC-001
-    card_id TEXT NOT NULL REFERENCES cards(id) ON DELETE CASCADE,
-    given_clause TEXT NOT NULL,
-    when_clause TEXT NOT NULL,
-    then_clause TEXT NOT NULL,
-    status TEXT DEFAULT 'pending' CHECK(status IN ('pending', 'passed', 'failed')),
-    created_at TEXT DEFAULT (datetime('now', 'utc') || 'Z')
-);
-
--- Grooming Artifacts (produced during grooming phase)
-CREATE TABLE IF NOT EXISTS artifacts (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    card_id TEXT NOT NULL REFERENCES cards(id) ON DELETE CASCADE,
-    type TEXT NOT NULL CHECK(type IN (
-        'scope_doc', 'diagram', 'wireframe', 'api_spec',
-        'data_model', 'test_plan', 'other'
-    )),
-    title TEXT NOT NULL,
-    content TEXT NOT NULL,
-    file_path TEXT,                         -- Path to artifact file (relative to workspace)
-    format TEXT DEFAULT 'markdown',         -- markdown, mermaid, json, yaml
-    created_by TEXT,
-    created_at TEXT DEFAULT (datetime('now', 'utc') || 'Z')
-);
-
--- Technical Artifacts (expanded specifications for cards/epics/sprints)
--- Added in V1.1.0, now part of base schema V1.3.0
-CREATE TABLE IF NOT EXISTS technical_artifacts (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    card_id TEXT REFERENCES cards(id) ON DELETE SET NULL,
-    epic_id TEXT REFERENCES epics(id) ON DELETE SET NULL,
-    sprint_id TEXT REFERENCES sprints(id) ON DELETE SET NULL,
-    type TEXT NOT NULL CHECK(type IN (
-        'scope_doc', 'diagram', 'wireframe', 'api_spec',
-        'data_model', 'test_plan', 'technical_spec', 'algorithm',
-        'architecture_decision', 'data_schema', 'interface_contract',
-        'implementation_guide', 'validation_rules', 'migration_plan', 'other'
-    )),
-    title TEXT NOT NULL,
-    description TEXT,
-    content TEXT NOT NULL,
-    file_path TEXT,                         -- Path to artifact file (relative to workspace)
-    format TEXT DEFAULT 'markdown' CHECK(format IN (
-        'markdown', 'mermaid', 'json', 'yaml', 'sql', 'python', 'toon'
-    )),
-    created_by TEXT NOT NULL,
-    owner_role TEXT CHECK(owner_role IN (
-        'tech_lead', 'data_engineer', 'solution_architect',
-        'product_owner', 'developer', 'other'
-    )),
-    version INTEGER DEFAULT 1,
-    supersedes_id INTEGER REFERENCES technical_artifacts(id),
-    status TEXT DEFAULT 'active' CHECK(status IN (
-        'draft', 'active', 'deprecated', 'archived'
-    )),
-    tags TEXT,
-    indexed INTEGER DEFAULT 0,
-    created_at TEXT DEFAULT (datetime('now', 'utc') || 'Z'),
-    updated_at TEXT DEFAULT (datetime('now', 'utc') || 'Z'),
-    CHECK (card_id IS NOT NULL OR epic_id IS NOT NULL OR sprint_id IS NOT NULL)
-);
-
--- Deliverables (expected outputs from card)
-CREATE TABLE IF NOT EXISTS deliverables (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    card_id TEXT NOT NULL REFERENCES cards(id) ON DELETE CASCADE,
-    type TEXT NOT NULL CHECK(type IN (
-        'code', 'test', 'doc', 'config', 'migration', 'script', 'other'
-    )),
-    description TEXT NOT NULL,
-    file_path TEXT,                         -- Expected file path
-    acceptance TEXT,                        -- How to verify completion
-    completed INTEGER DEFAULT 0,
-    completed_at TEXT,
-    created_at TEXT DEFAULT (datetime('now', 'utc') || 'Z')
-);
-
--- Review History (audit trail for reflection iterations)
-CREATE TABLE IF NOT EXISTS reviews (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    card_id TEXT NOT NULL REFERENCES cards(id) ON DELETE CASCADE,
-    iteration INTEGER NOT NULL,
-    reviewer TEXT NOT NULL,
-    passed INTEGER NOT NULL,                -- 0=failed, 1=passed
-    feedback TEXT,
-    created_at TEXT DEFAULT (datetime('now', 'utc') || 'Z')
-);
-
--- Card Activity Log (for async coordination)
-CREATE TABLE IF NOT EXISTS card_activities (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    card_id TEXT NOT NULL REFERENCES cards(id) ON DELETE CASCADE,
-    agent TEXT NOT NULL,
-    action TEXT NOT NULL,                   -- started, paused, resumed, completed, blocked, comment
-    details TEXT,
-    created_at TEXT DEFAULT (datetime('now', 'utc') || 'Z')
-);
-
--- Blockers
-CREATE TABLE IF NOT EXISTS blockers (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    card_id TEXT NOT NULL REFERENCES cards(id) ON DELETE CASCADE,
-    description TEXT NOT NULL,
-    blocked_by TEXT,                        -- Another card ID or external
-    resolved INTEGER DEFAULT 0,
-    resolved_at TEXT,
-    created_at TEXT DEFAULT (datetime('now', 'utc') || 'Z')
-);
-
--- Dependencies between cards
-CREATE TABLE IF NOT EXISTS card_dependencies (
-    card_id TEXT NOT NULL REFERENCES cards(id) ON DELETE CASCADE,
-    depends_on TEXT NOT NULL REFERENCES cards(id) ON DELETE CASCADE,
-    PRIMARY KEY (card_id, depends_on)
-);
-
--- Indexes for common queries
-CREATE INDEX IF NOT EXISTS idx_sprints_workspace ON sprints(workspace);
-CREATE INDEX IF NOT EXISTS idx_sprints_status ON sprints(status);
-CREATE INDEX IF NOT EXISTS idx_epics_workspace ON epics(workspace);
-CREATE INDEX IF NOT EXISTS idx_cards_workspace ON cards(workspace);
-CREATE INDEX IF NOT EXISTS idx_cards_status ON cards(status);
-CREATE INDEX IF NOT EXISTS idx_cards_sprint ON cards(sprint_id);
-CREATE INDEX IF NOT EXISTS idx_cards_epic ON cards(epic_id);
-CREATE INDEX IF NOT EXISTS idx_cards_agent ON cards(assigned_agent);
-CREATE INDEX IF NOT EXISTS idx_cards_user_story ON cards(user_story_id);
-CREATE INDEX IF NOT EXISTS idx_activities_card ON card_activities(card_id);
-CREATE INDEX IF NOT EXISTS idx_reviews_card ON reviews(card_id);
-CREATE INDEX IF NOT EXISTS idx_artifacts_file_path ON artifacts(file_path);
-CREATE INDEX IF NOT EXISTS idx_tech_artifacts_card ON technical_artifacts(card_id);
-CREATE INDEX IF NOT EXISTS idx_tech_artifacts_epic ON technical_artifacts(epic_id);
-CREATE INDEX IF NOT EXISTS idx_tech_artifacts_type ON technical_artifacts(type);
-CREATE INDEX IF NOT EXISTS idx_tech_artifacts_file_path ON technical_artifacts(file_path);
-
--- View: Sprint Board (cards grouped by status)
-CREATE VIEW IF NOT EXISTS v_sprint_board AS
-SELECT
-    s.id as sprint_id,
-    s.name as sprint_name,
-    s.workspace,
-    c.status,
-    COUNT(c.id) as card_count,
-    SUM(c.story_points) as total_points
-FROM sprints s
-LEFT JOIN cards c ON c.sprint_id = s.id
-WHERE s.status = 'active'
-GROUP BY s.id, c.status;
-
--- View: Agent Workload
-CREATE VIEW IF NOT EXISTS v_agent_workload AS
-SELECT
-    assigned_agent,
-    workspace,
-    status,
-    COUNT(*) as card_count,
-    SUM(story_points) as total_points
-FROM cards
-WHERE assigned_agent IS NOT NULL
-AND status IN ('doing', 'review', 'tested')
-GROUP BY assigned_agent, workspace, status;
-
--- Token Usage (v1.4.0)
--- Tracks token consumption per agent/card/operation for cost management and efficiency analysis
-CREATE TABLE IF NOT EXISTS token_usage (
-    id TEXT PRIMARY KEY,                     -- TU-001 or UUID
-    workspace TEXT NOT NULL,
-    card_id TEXT REFERENCES cards(id) ON DELETE SET NULL,
-    sprint_id TEXT REFERENCES sprints(id) ON DELETE SET NULL,
-    agent TEXT NOT NULL,                     -- Agent that consumed tokens
-    operation TEXT NOT NULL CHECK(operation IN (
-        'implementation',                    -- Code implementation
-        'review',                            -- Code review
-        'fix',                               -- Bug fix / revision after review
-        'planning',                          -- Sprint/epic planning
-        'grooming',                          -- Card grooming
-        'other'                              -- Other operations
-    )),
-    input_tokens INTEGER NOT NULL DEFAULT 0,
-    output_tokens INTEGER NOT NULL DEFAULT 0,
-    total_tokens INTEGER GENERATED ALWAYS AS (input_tokens + output_tokens) STORED,
-    model TEXT,                              -- Model used (claude-sonnet, etc.)
-    cost_usd REAL,                           -- Estimated cost in USD
-    session_id TEXT,                         -- Session/conversation ID
-    status TEXT DEFAULT 'active' CHECK(status IN (
-        'active', 'deprecated', 'archived'
-    )),
-    metadata TEXT,                           -- JSON with additional context
-    created_at TEXT DEFAULT (datetime('now', 'utc') || 'Z')
-);
-
--- Indexes for token_usage
-CREATE INDEX IF NOT EXISTS idx_token_usage_workspace ON token_usage(workspace);
-CREATE INDEX IF NOT EXISTS idx_token_usage_card ON token_usage(card_id);
-CREATE INDEX IF NOT EXISTS idx_token_usage_agent ON token_usage(agent);
-CREATE INDEX IF NOT EXISTS idx_token_usage_sprint ON token_usage(sprint_id);
-CREATE INDEX IF NOT EXISTS idx_token_usage_operation ON token_usage(operation);
-CREATE INDEX IF NOT EXISTS idx_token_usage_session ON token_usage(session_id);
-
--- View: Token Usage Summary by Agent
-CREATE VIEW IF NOT EXISTS v_token_usage_by_agent AS
-SELECT
-    workspace,
-    agent,
-    operation,
-    COUNT(*) as usage_count,
-    SUM(input_tokens) as total_input,
-    SUM(output_tokens) as total_output,
-    SUM(total_tokens) as total_tokens,
-    SUM(cost_usd) as total_cost_usd,
-    AVG(total_tokens) as avg_tokens_per_operation
-FROM token_usage
-WHERE status = 'active'
-GROUP BY workspace, agent, operation;
-
--- View: Token Usage Summary by Card
-CREATE VIEW IF NOT EXISTS v_token_usage_by_card AS
-SELECT
-    workspace,
-    card_id,
-    COUNT(*) as usage_count,
-    SUM(input_tokens) as total_input,
-    SUM(output_tokens) as total_output,
-    SUM(total_tokens) as total_tokens,
-    SUM(cost_usd) as total_cost_usd
-FROM token_usage
-WHERE status = 'active' AND card_id IS NOT NULL
-GROUP BY workspace, card_id;
-
--- View: Token Usage Summary by Sprint
-CREATE VIEW IF NOT EXISTS v_token_usage_by_sprint AS
-SELECT
-    workspace,
-    sprint_id,
-    COUNT(*) as usage_count,
-    SUM(input_tokens) as total_input,
-    SUM(output_tokens) as total_output,
-    SUM(total_tokens) as total_tokens,
-    SUM(cost_usd) as total_cost_usd,
-    COUNT(DISTINCT card_id) as cards_count,
-    COUNT(DISTINCT agent) as agents_count
-FROM token_usage
-WHERE status = 'active' AND sprint_id IS NOT NULL
-GROUP BY workspace, sprint_id;

package/src/domain/kanban/schema_provider.py

@@ -1,347 +0,0 @@
-"""
-Kanban Schema Provider - Single Source of Truth for database schemas.
-
-Provides version management, schema definitions, and migration paths.
-Used by MigrationRunner to ensure database consistency across workspaces.
-
-Following DDD: Domain layer defines WHAT the schema should be,
-Application layer (MigrationRunner) handles HOW to apply it.
-"""
-
-from dataclasses import dataclass
-from enum import Enum
-from pathlib import Path
-from typing import List, Optional, Callable
-import sqlite3
-
-
-class SchemaVersion(Enum):
-    """Canonical schema versions for Kanban bounded context."""
-
-    V1_0_0 = "1.0.0"  # Base schema
-    V1_1_0 = "1.1.0"  # Add technical_artifacts table (M001)
-    V1_2_0 = "1.2.0"  # Add user_story_id, file_path (M002, M003)
-    V1_3_0 = "1.3.0"  # Add grooming tracking fields (M005)
-    V1_4_0 = "1.4.0"  # Add token_usage table for agent metrics (M006)
-    V1_5_0 = "1.5.0"  # Add workflow constraints and force_operations audit (M007)
-
-    @classmethod
-    def from_string(cls, version: str) -> "SchemaVersion":
-        """Convert string to SchemaVersion enum."""
-        for v in cls:
-            if v.value == version:
-                return v
-        raise ValueError(f"Unknown schema version: {version}")
-
-    @classmethod
-    def current(cls) -> "SchemaVersion":
-        """Get current (latest) schema version."""
-        return cls.V1_5_0
-
-    def __lt__(self, other: "SchemaVersion") -> bool:
-        versions = list(SchemaVersion)
-        return versions.index(self) < versions.index(other)
-
-    def __le__(self, other: "SchemaVersion") -> bool:
-        return self == other or self < other
-
-
-@dataclass
-class Migration:
-    """Represents a database migration."""
-
-    from_version: SchemaVersion
-    to_version: SchemaVersion
-    description: str
-    sql: str
-
-
-class SchemaProvider:
-    """
-    Single Source of Truth for Kanban database schemas.
-
-    Responsibilities:
-    - Define current schema version
-    - Provide schema SQL for any version
-    - Define migration paths between versions
-    - Detect schema version from existing database
-    """
-
-    CURRENT_VERSION = SchemaVersion.current()
-
-    # Helper to load M007 SQL from file
-    @staticmethod
-    def _get_m007_sql() -> str:
-        """Load M007 migration SQL from file."""
-        # migrations/ is at project root, not inside src/
-        project_root = Path(__file__).parent.parent.parent.parent
-        m007_path = (
-            project_root / "migrations" / "kanban" / "M007_add_workflow_constraints.sql"
-        )
-        if m007_path.exists():
-            return m007_path.read_text()
-        return ""
-
-    # Migration definitions
-    _MIGRATIONS: List[Migration] = [
-        Migration(
-            from_version=SchemaVersion.V1_0_0,
-            to_version=SchemaVersion.V1_1_0,
-            description="Add technical_artifacts table for expanded specs",
-            sql="""
-                CREATE TABLE IF NOT EXISTS technical_artifacts (
-                    id INTEGER PRIMARY KEY AUTOINCREMENT,
-                    card_id TEXT REFERENCES cards(id) ON DELETE SET NULL,
-                    epic_id TEXT REFERENCES epics(id) ON DELETE SET NULL,
-                    sprint_id TEXT REFERENCES sprints(id) ON DELETE SET NULL,
-                    type TEXT NOT NULL CHECK(type IN (
-                        'scope_doc', 'diagram', 'wireframe', 'api_spec',
-                        'data_model', 'test_plan', 'technical_spec', 'algorithm',
-                        'architecture_decision', 'data_schema', 'interface_contract',
-                        'implementation_guide', 'validation_rules', 'migration_plan', 'other'
-                    )),
-                    title TEXT NOT NULL,
-                    description TEXT,
-                    content TEXT NOT NULL,
-                    format TEXT DEFAULT 'markdown' CHECK(format IN (
-                        'markdown', 'mermaid', 'json', 'yaml', 'sql', 'python', 'toon'
-                    )),
-                    created_by TEXT NOT NULL,
-                    owner_role TEXT CHECK(owner_role IN (
-                        'tech_lead', 'data_engineer', 'solution_architect',
-                        'product_owner', 'developer', 'other'
-                    )),
-                    version INTEGER DEFAULT 1,
-                    supersedes_id INTEGER REFERENCES technical_artifacts(id),
-                    status TEXT DEFAULT 'active' CHECK(status IN (
-                        'draft', 'active', 'deprecated', 'archived'
-                    )),
-                    tags TEXT,
-                    indexed INTEGER DEFAULT 0,
-                    created_at TEXT DEFAULT (datetime('now', 'utc') || 'Z'),
-                    updated_at TEXT DEFAULT (datetime('now', 'utc') || 'Z'),
-                    CHECK (card_id IS NOT NULL OR epic_id IS NOT NULL OR sprint_id IS NOT NULL)
-                );
-
-                CREATE INDEX IF NOT EXISTS idx_tech_artifacts_card ON technical_artifacts(card_id);
-                CREATE INDEX IF NOT EXISTS idx_tech_artifacts_epic ON technical_artifacts(epic_id);
-                CREATE INDEX IF NOT EXISTS idx_tech_artifacts_type ON technical_artifacts(type);
-            """,
-        ),
-        Migration(
-            from_version=SchemaVersion.V1_1_0,
-            to_version=SchemaVersion.V1_2_0,
-            description="Add user_story_id to cards, file_path to artifacts",
-            sql="""
-                ALTER TABLE cards ADD COLUMN user_story_id TEXT;
-                CREATE INDEX IF NOT EXISTS idx_cards_user_story ON cards(user_story_id);
-
-                ALTER TABLE artifacts ADD COLUMN file_path TEXT;
-                CREATE INDEX IF NOT EXISTS idx_artifacts_file_path ON artifacts(file_path);
-
-                ALTER TABLE technical_artifacts ADD COLUMN file_path TEXT;
-                CREATE INDEX IF NOT EXISTS idx_tech_artifacts_file_path ON technical_artifacts(file_path);
-            """,
-        ),
-        Migration(
-            from_version=SchemaVersion.V1_2_0,
-            to_version=SchemaVersion.V1_3_0,
-            description="Add grooming tracking fields to cards",
-            sql="""
-                ALTER TABLE cards ADD COLUMN grooming_completed INTEGER DEFAULT 0;
-                ALTER TABLE cards ADD COLUMN grooming_artifacts_count INTEGER DEFAULT 0;
-                ALTER TABLE cards ADD COLUMN grooming_at TEXT;
-            """,
-        ),
-        Migration(
-            from_version=SchemaVersion.V1_3_0,
-            to_version=SchemaVersion.V1_4_0,
-            description="Add token_usage table for agent metrics tracking",
-            sql="""
-                CREATE TABLE IF NOT EXISTS token_usage (
-                    id TEXT PRIMARY KEY,
-                    workspace TEXT NOT NULL,
-                    card_id TEXT REFERENCES cards(id) ON DELETE SET NULL,
-                    sprint_id TEXT REFERENCES sprints(id) ON DELETE SET NULL,
-                    agent TEXT NOT NULL,
-                    operation TEXT NOT NULL CHECK(operation IN (
-                        'implementation', 'review', 'fix', 'planning', 'grooming', 'other'
-                    )),
-                    input_tokens INTEGER NOT NULL DEFAULT 0,
-                    output_tokens INTEGER NOT NULL DEFAULT 0,
-                    total_tokens INTEGER GENERATED ALWAYS AS (input_tokens + output_tokens) STORED,
-                    model TEXT,
-                    cost_usd REAL,
-                    session_id TEXT,
-                    status TEXT DEFAULT 'active' CHECK(status IN (
-                        'active', 'deprecated', 'archived'
-                    )),
-                    metadata TEXT,
-                    created_at TEXT DEFAULT (datetime('now', 'utc') || 'Z')
-                );
-
-                CREATE INDEX IF NOT EXISTS idx_token_usage_workspace ON token_usage(workspace);
-                CREATE INDEX IF NOT EXISTS idx_token_usage_card ON token_usage(card_id);
-                CREATE INDEX IF NOT EXISTS idx_token_usage_agent ON token_usage(agent);
-                CREATE INDEX IF NOT EXISTS idx_token_usage_sprint ON token_usage(sprint_id);
-                CREATE INDEX IF NOT EXISTS idx_token_usage_operation ON token_usage(operation);
-                CREATE INDEX IF NOT EXISTS idx_token_usage_session ON token_usage(session_id);
-            """,
-        ),
-    ]
-
-    @classmethod
-    def get_current_version(cls) -> SchemaVersion:
-        """Get the current (target) schema version."""
-        return cls.CURRENT_VERSION
-
-    @classmethod
-    def get_schema_path(cls) -> Path:
-        """Get path to the full schema SQL file."""
-        return Path(__file__).parent / "schema.sql"
-
-    @classmethod
-    def get_full_schema(cls) -> str:
-        """Get the complete current schema SQL."""
-        schema_path = cls.get_schema_path()
-        if schema_path.exists():
-            return schema_path.read_text()
-        raise FileNotFoundError(f"Schema file not found: {schema_path}")
-
-    @classmethod
-    def get_migrations(
-        cls, from_version: SchemaVersion, to_version: SchemaVersion
-    ) -> List[Migration]:
-        """
-        Get ordered list of migrations to apply.
-
-        Args:
-            from_version: Current database version
-            to_version: Target version
-
-        Returns:
-            List of Migration objects to apply in order
-        """
-        if from_version >= to_version:
-            return []
-
-        migrations = []
-        current = from_version
-
-        for migration in cls._MIGRATIONS:
-            if (
-                migration.from_version >= from_version
-                and migration.to_version <= to_version
-            ):
-                if migration.from_version == current:
-                    migrations.append(migration)
-                    current = migration.to_version
-
-        return migrations
-
-    @classmethod
-    def detect_version(cls, db_path: Path) -> SchemaVersion:
-        """
-        Detect schema version from existing database.
-
-        Uses schema_meta table if available, otherwise inspects structure.
-
-        Args:
-            db_path: Path to SQLite database
-
-        Returns:
-            Detected SchemaVersion
-        """
-        if not db_path.exists():
-            return SchemaVersion.V1_0_0
-
-        conn = sqlite3.connect(str(db_path))
-        try:
-            # First, check schema_meta table
-            cursor = conn.execute(
-                "SELECT name FROM sqlite_master WHERE type='table' AND name='schema_meta'"
-            )
-            if cursor.fetchone():
-                cursor = conn.execute(
-                    "SELECT version FROM schema_meta ORDER BY applied_at DESC LIMIT 1"
-                )
-                row = cursor.fetchone()
-                if row:
-                    try:
-                        return SchemaVersion.from_string(row[0])
-                    except ValueError:
-                        pass
-
-            # Fallback: detect from structure
-            return cls._detect_version_from_structure(conn)
-        finally:
-            conn.close()
-
-    @classmethod
-    def _detect_version_from_structure(cls, conn: sqlite3.Connection) -> SchemaVersion:
-        """Detect version by inspecting database structure."""
-
-        cursor = conn.execute("PRAGMA table_info(cards)")
-        columns = [row[1] for row in cursor.fetchall()]
-
-        # Check for V1_5_0 features: force_operations table and workflow_validated column
-        cursor = conn.execute(
-            "SELECT name FROM sqlite_master WHERE type='table' AND name='force_operations'"
-        )
-        has_force_operations = cursor.fetchone() is not None
-        has_workflow_validated = "workflow_validated" in columns
-
-        # Check for V1_4_0 features: token_usage table
-        cursor = conn.execute(
-            "SELECT name FROM sqlite_master WHERE type='table' AND name='token_usage'"
-        )
-        has_token_usage = cursor.fetchone() is not None
-
-        # Check for V1_3_0 features: grooming_completed in cards
-        has_grooming_completed = "grooming_completed" in columns
-
-        # Check for V1_2_0 features: user_story_id in cards
-        has_user_story_id = "user_story_id" in columns
-
-        # Check for V1_1_0 features: technical_artifacts table
-        cursor = conn.execute(
-            "SELECT name FROM sqlite_master WHERE type='table' AND name='technical_artifacts'"
-        )
-        has_tech_artifacts = cursor.fetchone() is not None
-
-        if has_force_operations and has_workflow_validated:
-            return SchemaVersion.V1_5_0
-        elif has_token_usage:
-            return SchemaVersion.V1_4_0
-        elif has_grooming_completed:
-            return SchemaVersion.V1_3_0
-        elif has_user_story_id:
-            return SchemaVersion.V1_2_0
-        elif has_tech_artifacts:
-            return SchemaVersion.V1_1_0
-        else:
-            return SchemaVersion.V1_0_0
-
-    @classmethod
-    def get_version_description(cls, version: SchemaVersion) -> str:
-        """Get human-readable description of a schema version."""
-        descriptions = {
-            SchemaVersion.V1_0_0: "Base schema - sprints, epics, cards, artifacts",
-            SchemaVersion.V1_1_0: "Technical artifacts table for expanded specifications",
-            SchemaVersion.V1_2_0: "User story binding (user_story_id) and artifact file tracking (file_path)",
-            SchemaVersion.V1_3_0: "Grooming tracking fields (grooming_completed, grooming_artifacts_count)",
-            SchemaVersion.V1_4_0: "Token usage tracking for agent metrics and cost management",
-            SchemaVersion.V1_5_0: "Workflow enforcement constraints and force_operations audit trail (M007)",
-        }
-        return descriptions.get(version, "Unknown version")
-
-
-# Add M007 migration after class definition using the staticmethod
-SchemaProvider._MIGRATIONS.append(
-    Migration(
-        from_version=SchemaVersion.V1_4_0,
-        to_version=SchemaVersion.V1_5_0,
-        description="Add workflow enforcement constraints and force_operations audit",
-        sql=SchemaProvider._get_m007_sql(),
-    )
-)