chore: bump version to 0.11.1; merge develop; add esdb/skills commands

- Bump pyproject.toml + __init__.py to 0.11.1
- Merge origin/develop: adds skills deactivate/delete and esdb
  export/import/backup/rollback/compact subcommands
- Resolve cli.py merge conflict (both branches added new subcommands;
  keep all of them — channel/esdb/skills from both sides)

Co-Authored-By: Oz <oz-agent@warp.dev>

Author: tbitcs

.specsmith/requirements.json

@@ -1720,5 +1720,110 @@
     "description": "The context window MUST NEVER be allowed to reach 100% fill. A hard reservation of 15% (or MIN_FREE_TOKENS=2048, whichever is more restrictive) MUST remain free. When fill reaches the hard ceiling (default 85%), ContextFullError MUST be raised and emergency compression triggered regardless of the auto-compress toggle.",
     "source": "Plan 0ca40db4 [CTX-004]",
     "status": "defined"
+  },
+  {
+    "id": "REQ-248",
+    "title": "Dev/Stable Update Channel Persistence",
+    "description": "specsmith MUST persist a user-chosen update channel (stable or dev) to ~/.specsmith/channel. specsmith channel set {stable|dev} writes the file; channel clear removes it. effective_channel_with_source() MUST return (channel, source) where source is user when the file exists, otherwise",
+    "source": "ARCHITECTURE.md [Update Channel Selection]",
+    "status": "implemented"
+  },
+  {
+    "id": "REQ-249",
+    "title": "ESDB JSON Export Command",
+    "description": "specsmith esdb export [--output PATH] [--json] MUST dump all ESDB records (requirements and testcases) to a versioned JSON payload at the specified path, or default to <project>/.specsmith/esdb_export.json. Output includes esdb_version, \backend,",
+    "source": "ARCHITECTURE.md [ESDB Extended Management]",
+    "status": "implemented"
+  },
+  {
+    "id": "REQ-250",
+    "title": "ESDB JSON Import Command",
+    "description": "specsmith esdb import <source> [--json] MUST validate a JSON export file (checking for",
+    "source": "ARCHITECTURE.md [ESDB Extended Management]",
+    "status": "implemented"
+  },
+  {
+    "id": "REQ-251",
+    "title": "ESDB Timestamped Backup Command",
+    "description": "specsmith esdb backup [--dir DIR] [--json] MUST create a timestamped snapshot at <dir>/esdb_backup_<YYYYMMDDTHHMMSSZ>.json (default dir: .specsmith/backups/). The snapshot payload MUST include esdb_version, \timestamp, \backend,",
+    "source": "ARCHITECTURE.md [ESDB Extended Management]",
+    "status": "implemented"
+  },
+  {
+    "id": "REQ-252",
+    "title": "ESDB WAL Rollback Command",
+    "description": "specsmith esdb rollback [--steps N] [--json] MUST report the number of WAL events that would be undone. In stub mode (ChronoMemory native engine not linked) it MUST return {ok: true, steps_requested: N, records_before: N, note: \"...\"} without modifying state.",
+    "source": "ARCHITECTURE.md [ESDB Extended Management]",
+    "status": "implemented"
+  },
+  {
+    "id": "REQ-253",
+    "title": "ESDB WAL Compact Command",
+    "description": "specsmith esdb compact [--json] MUST request WAL compaction. In stub mode it MUST return {ok: true, backend: \"...\", records: N, note: \"...\"} without error.",
+    "source": "ARCHITECTURE.md [ESDB Extended Management]",
+    "status": "implemented"
+  },
+  {
+    "id": "REQ-254",
+    "title": "Skills Deactivate Command",
+    "description": "specsmith skills deactivate <skill-id> [--project-dir DIR] MUST set \u0007ctive: false in the skill's skill.json, return True on success, and exit non-zero with an error message if the skill is not found.",
+    "source": "ARCHITECTURE.md [AI Skills Builder]",
+    "status": "implemented"
+  },
+  {
+    "id": "REQ-255",
+    "title": "Skills Delete Command",
+    "description": "specsmith skills delete <skill-id> [--project-dir DIR] [--yes] MUST prompt for confirmation unless --yes is provided, then permanently remove the skill directory under .specsmith/skills/. Returns non-zero if the skill is not found.",
+    "source": "ARCHITECTURE.md [AI Skills Builder]",
+    "status": "implemented"
+  },
+  {
+    "id": "REQ-256",
+    "title": "MCP Server Config Generation Command",
+    "description": "specsmith mcp generate <description> [--json] MUST produce a deterministic MCP server configuration stub with id,",
+    "source": "ARCHITECTURE.md [MCP Server Generator]",
+    "status": "implemented"
+  },
+  {
+    "id": "REQ-257",
+    "title": "Agent Ask Keyword Dispatcher",
+    "description": "specsmith agent ask <prompt> [--project-dir DIR] [--json-output] MUST route prompts to the appropriate subsystem by keyword matching (compliance, audit, skill, esdb, mcp, session) without requiring an LLM. It MUST return {reply, action, prompt} and print human-readable output unless --json-output is set.",
+    "source": "ARCHITECTURE.md [Agent Ask Dispatcher]",
+    "status": "implemented"
+  },
+  {
+    "id": "REQ-258",
+    "title": "Kairos ESDB Settings Page",
+    "description": "The Kairos settings sidebar MUST include an ESDB page under the Specsmith umbrella group. The page MUST display current ESDB status (record count, backend, chain validity) and provide action buttons for Refresh, Export JSON, Import, Backup, Rollback, and Compact.",
+    "source": "ARCHITECTURE.md [Kairos Settings Extensions]",
+    "status": "implemented"
+  },
+  {
+    "id": "REQ-259",
+    "title": "Kairos Skills Settings Page",
+    "description": "The Kairos settings sidebar MUST include a Skills page under the Specsmith umbrella group. The page MUST display a description of the Skills system and instructions for using specsmith skills build and related commands.",
+    "source": "ARCHITECTURE.md [Kairos Settings Extensions]",
+    "status": "implemented"
+  },
+  {
+    "id": "REQ-260",
+    "title": "Kairos Eval Settings Page",
+    "description": "The Kairos settings sidebar MUST include an Eval page under the Specsmith umbrella group. The page MUST describe the evaluation tracking system and direct users to specsmith eval run for generating reports.",
+    "source": "ARCHITECTURE.md [Kairos Settings Extensions]",
+    "status": "implemented"
+  },
+  {
+    "id": "REQ-261",
+    "title": "Kairos AI Providers Table Without Column Overflow",
+    "description": "The Kairos Agents > Providers settings page MUST display AI models in a table with fixed-width columns (Name: 200px, Model ID: 220px, Context: 80px, Output: 80px) using ConstrainedBox + Clipped elements. Long model names such as o4-mini-deep-research MUST NOT overflow into adjacent columns.",
+    "source": "ARCHITECTURE.md [Kairos Settings Extensions]",
+    "status": "implemented"
+  },
+  {
+    "id": "REQ-262",
+    "title": "Kairos MCP AI Builder Card",
+    "description": "The Kairos Agents > MCP servers list page MUST include a collapsible AI Builder card that accepts a natural-language server description, calls specsmith mcp generate <description> --json, displays the generated JSON stub, and offers an 'Add to ~/.specsmith/mcp.json' button that appends the stub to the user's MCP config file.",
+    "source": "ARCHITECTURE.md [Kairos Settings Extensions]",
+    "status": "implemented"
   }
 ]

.specsmith/testcases.json

@@ -2462,5 +2462,170 @@
     "input": {},
     "expected_behavior": {},
     "confidence": 1.0
+  },
+  {
+    "id": "TEST-248",
+    "title": "Dev/Stable Channel Persistence CLI Round-trip",
+    "description": "specsmith channel set dev persists the preference; channel get --json returns channel==dev source==user; channel clear reverts source to version.",
+    "requirement_id": "REQ-248",
+    "type": "cli",
+    "verification_method": "pytest (test_req_248_262.py::TestREQ248ChannelCLI, test_channel.py)",
+    "input": {},
+    "expected_behavior": {},
+    "confidence": 1.0
+  },
+  {
+    "id": "TEST-249",
+    "title": "ESDB Export Creates Versioned JSON File",
+    "description": "specsmith esdb export --json exits 0, returns ok==true + path; the written file contains esdb_version==1, backend, record_count, requirements, testcases.",
+    "requirement_id": "REQ-249",
+    "type": "cli",
+    "verification_method": "pytest (test_req_248_262.py::TestREQ249EsdbExport)",
+    "input": {},
+    "expected_behavior": {},
+    "confidence": 1.0
+  },
+  {
+    "id": "TEST-250",
+    "title": "ESDB Import Validates and Stages JSON",
+    "description": "specsmith esdb import <file> --json exits 0 for valid JSON export, staging it at .specsmith/esdb_import.json. Exits non-zero for missing or invalid JSON files.",
+    "requirement_id": "REQ-250",
+    "type": "cli",
+    "verification_method": "pytest (test_req_248_262.py::TestREQ250EsdbImport)",
+    "input": {},
+    "expected_behavior": {},
+    "confidence": 1.0
+  },
+  {
+    "id": "TEST-251",
+    "title": "ESDB Backup Creates Timestamped Snapshot",
+    "description": "specsmith esdb backup --json exits 0, creates a file matching esdb_backup_\\d{8}T\\d{6}Z.json with all required payload keys.",
+    "requirement_id": "REQ-251",
+    "type": "cli",
+    "verification_method": "pytest (test_req_248_262.py::TestREQ251EsdbBackup)",
+    "input": {},
+    "expected_behavior": {},
+    "confidence": 1.0
+  },
+  {
+    "id": "TEST-252",
+    "title": "ESDB Rollback Reports Steps Without State Change",
+    "description": "specsmith esdb rollback --steps N --json exits 0 and returns ok==true, steps_requested==N, records_before. State is unchanged (stub mode).",
+    "requirement_id": "REQ-252",
+    "type": "cli",
+    "verification_method": "pytest (test_req_248_262.py::TestREQ252EsdbRollback)",
+    "input": {},
+    "expected_behavior": {},
+    "confidence": 1.0
+  },
+  {
+    "id": "TEST-253",
+    "title": "ESDB Compact Returns OK With Note",
+    "description": "specsmith esdb compact --json exits 0 and returns ok==true, backend, records, note. Human-readable output contains \"compact\".",
+    "requirement_id": "REQ-253",
+    "type": "cli",
+    "verification_method": "pytest (test_req_248_262.py::TestREQ253EsdbCompact)",
+    "input": {},
+    "expected_behavior": {},
+    "confidence": 1.0
+  },
+  {
+    "id": "TEST-254",
+    "title": "Skills Deactivate Sets active=false",
+    "description": "After skills activate <id>, skills deactivate <id> exits 0 and the skill's skill.json has active==false. Non-existent skill exits non-zero.",
+    "requirement_id": "REQ-254",
+    "type": "cli",
+    "verification_method": "pytest (test_req_248_262.py::TestREQ254SkillsDeactivate, TestSkillsBuilderDeactivateDelete)",
+    "input": {},
+    "expected_behavior": {},
+    "confidence": 1.0
+  },
+  {
+    "id": "TEST-255",
+    "title": "Skills Delete Removes Directory",
+    "description": "skills delete <id> --yes exits 0 and permanently removes the skill directory. Non-existent skill exits non-zero. Sibling skills are preserved.",
+    "requirement_id": "REQ-255",
+    "type": "cli",
+    "verification_method": "pytest (test_req_248_262.py::TestREQ255SkillsDelete, TestSkillsBuilderDeactivateDelete)",
+    "input": {},
+    "expected_behavior": {},
+    "confidence": 1.0
+  },
+  {
+    "id": "TEST-256",
+    "title": "MCP Generate Produces Stub With Required Fields",
+    "description": "mcp generate <desc> --json exits 0 and returns a dict containing id, name, command, args (in server sub-object or flat). Description field is stable; different descriptions produce different descriptions.",
+    "requirement_id": "REQ-256",
+    "type": "cli",
+    "verification_method": "pytest (test_req_248_262.py::TestREQ256McpGenerate)",
+    "input": {},
+    "expected_behavior": {},
+    "confidence": 1.0
+  },
+  {
+    "id": "TEST-257",
+    "title": "Agent Ask Routes By Keyword And Returns Structured Output",
+    "description": "\u0007gent ask <prompt> --json-output exits 0 and returns {reply, action, prompt}. Keywords esdb/mcp/skill/compliance route to appropriate actions. Unknown prompt routes to action==\"unknown\".",
+    "requirement_id": "REQ-257",
+    "type": "cli",
+    "verification_method": "pytest (test_req_248_262.py::TestREQ257AgentAsk)",
+    "input": {},
+    "expected_behavior": {},
+    "confidence": 1.0
+  },
+  {
+    "id": "TEST-258",
+    "title": "Kairos ESDB Settings Page Renders Without Overflow",
+    "description": "The Kairos Settings > Specsmith > ESDB page renders the status row, action buttons (Refresh, Export JSON, Import, Backup, Rollback, Compact) without layout errors.",
+    "requirement_id": "REQ-258",
+    "type": "integration",
+    "verification_method": "manual (Rust UI build required)",
+    "input": {},
+    "expected_behavior": {},
+    "confidence": 1.0
+  },
+  {
+    "id": "TEST-259",
+    "title": "Kairos Skills Settings Page Renders",
+    "description": "The Kairos Settings > Specsmith > Skills page renders header, description, and CLI hint without errors.",
+    "requirement_id": "REQ-259",
+    "type": "integration",
+    "verification_method": "manual (Rust UI build required)",
+    "input": {},
+    "expected_behavior": {},
+    "confidence": 1.0
+  },
+  {
+    "id": "TEST-260",
+    "title": "Kairos Eval Settings Page Renders",
+    "description": "The Kairos Settings > Specsmith > Eval page renders header, description, and CLI hint without errors.",
+    "requirement_id": "REQ-260",
+    "type": "integration",
+    "verification_method": "manual (Rust UI build required)",
+    "input": {},
+    "expected_behavior": {},
+    "confidence": 1.0
+  },
+  {
+    "id": "TEST-261",
+    "title": "Kairos AI Providers Table Does Not Overflow Long Model Names",
+    "description": "In the Kairos Agents > Providers table, the model name \"o4-mini-deep-research\" is clipped to its column width (200px) and does not bleed into the Model ID column.",
+    "requirement_id": "REQ-261",
+    "type": "integration",
+    "verification_method": "manual (Rust UI build + visual inspection)",
+    "input": {},
+    "expected_behavior": {},
+    "confidence": 1.0
+  },
+  {
+    "id": "TEST-262",
+    "title": "Kairos MCP AI Builder Card Generates And Saves Stub",
+    "description": "In the Kairos Agents > MCP servers list, the AI Builder card accepts a description, generates a stub via specsmith, displays JSON, and appends to ~/.specsmith/mcp.json on 'Add to config' click.",
+    "requirement_id": "REQ-262",
+    "type": "integration",
+    "verification_method": "manual (Rust UI build required)",
+    "input": {},
+    "expected_behavior": {},
+    "confidence": 1.0
   }
 ]

ARCHITECTURE.md

@@ -59,8 +59,97 @@ Role-based scoring engine using HuggingFace benchmark data.
 PFW, Citations, FPD, PTAB). All stdlib urllib, no external dependencies.
 See `specsmith.datasources.*`.
 
+## Update Channel Selection
+
+The `specsmith channel` group lets users persist a `stable` or `dev`
+release-channel preference to `~/.specsmith/channel`.
+`effective_channel_with_source()` in `specsmith.channel` resolves the
+active channel from: (1) the persisted file, (2) the installed version
+string (`.devN` suffix → dev, otherwise stable).
+Self-update (`specsmith self-update`) and project-update checks both
+honour the resolved channel.
+
+Subcommands: `channel get [--json]`, `channel set {stable|dev}`, `channel clear`.
+
+## AI Skills Builder (Phase A)
+
+The `specsmith skills` group generates, lists, activates, deactivates,
+tests, and deletes reusable AI agent skills stored as structured SKILL.md
+specifications under `.specsmith/skills/<skill-id>/`.
+
+- `skills build <description>` — deterministic skill spec generation from
+  natural-language description; writes `SKILL.md` + `skill.json`.
+- `skills list [--json]` — enumerate installed skills with active/inactive badge.
+- `skills test <skill-id>` — dry-run validation of skill spec fields.
+- `skills activate <skill-id>` — set `active: true` in `skill.json`.
+- `skills deactivate <skill-id>` — set `active: false` in `skill.json`.
+- `skills delete <skill-id> [--yes]` — permanently remove skill directory.
+
+All read/write operations use `specsmith.skills_builder`.
+
+## ESDB Extended Management
+
+The `specsmith esdb` group provides full lifecycle management for the
+ChronoMemory Epistemic State Database.
+
+**Existing:** `status`, `migrate`, `replay`
+
+**New (Phase ESDB):**
+- `esdb export [--output PATH] [--json]` — dumps all records to a JSON
+  snapshot at `<project>/.specsmith/esdb_export.json`.
+- `esdb import <source> [--json]` — validates and stages a JSON export;
+  run `esdb migrate` to apply.
+- `esdb backup [--dir DIR] [--json]` — creates a timestamped snapshot at
+  `.specsmith/backups/esdb_backup_<UTC>.json`.
+- `esdb rollback [--steps N] [--json]` — reports WAL events that would be
+  undone (stub until ChronoMemory native engine is linked).
+- `esdb compact [--json]` — requests WAL compaction / vacuum.
+
+## MCP Server Generator
+
+`specsmith mcp generate <description> [--json]` produces a deterministic
+MCP server configuration stub from a natural-language description.
+The stub is a JSON object with `id`, `name`, `command`, and `args` fields
+suitable for appending to `~/.specsmith/mcp.json`.
+
+Implemented in `specsmith.cli.main_group → mcp_group → mcp_generate_cmd`.
+
+## Agent Ask Dispatcher
+
+`specsmith agent ask <prompt> [--project-dir DIR] [--json-output]` is a
+keyword-based routing dispatcher that answers settings and status queries
+without an LLM.
+
+Routing table (evaluated in order):
+1. `compliance / coverage / gaps / trace` → `get_compliance_summary()`
+2. `audit / health / governance / drift` → `run_audit()`
+3. `skill / build skill / create skill` → hints to `specsmith skills build`
+4. `esdb / database / backup / export / records` → `EsdbBridge.status()`
+5. `mcp / server / tool server` → hints to `specsmith mcp generate`
+6. `session / phase / status / project` → `init_session()`
+
+Returns `{"reply": "...", "action": "...", "prompt": "..."}`.
+
 ## Kairos Integration
 
-Kairos (BitConcepts/kairos) is the Rust terminal that consumes
+Kairos (layer1labs/kairos) is the Rust terminal that consumes
 `specsmith serve` as its governance backend via HTTP/WebSocket.
 See `specsmith.governance_logic.GovernanceHTTPServer`.
+
+### Kairos Settings Extensions (v0.11.x)
+
+The Kairos settings view now includes Specsmith-specific pages grouped
+under a **Specsmith** umbrella in the sidebar:
+
+- **ESDB** — database status, export/import/backup/rollback/compact actions.
+- **Skills** — skills listing and management instructions.
+- **Eval** — evaluation suite tracking and report access.
+
+The **Agents → Providers** subpage shows a fixed-width model table
+(Name | Model ID | Context | Output columns) with `ConstrainedBox` +
+`Clipped` cells to prevent text overflow on long model names such as
+`o4-mini-deep-research`.
+
+The **Agents → MCP servers** list page includes a collapsible
+**AI Builder** card that invokes `specsmith mcp generate <description>`
+and offers one-click append to `~/.specsmith/mcp.json`.