mishkan-harness 0.2.6 → 0.2.7

package/README.md

@@ -14,7 +14,7 @@ MISHKAN turns Claude Code into a standing engineering organisation. Quality and
 
 It's personal, opinionated infrastructure built around one engineer's standards. To make it yours, replace `docs/engineer/profile.md` and re-sync — nothing else hardcodes the author.
 
-> **v0.2.6** — agent fleet, rules, hooks, installer are stable. Cognee knowledge stack ready to bring up locally. Observability stack (watchd + TUI) available as two `uv tool`-installable packages.
+> **v0.2.7** — agent fleet, rules, hooks, installer stable. Unified semantic `mishkan <object> <verb>` CLI (D-015) with engineer-gated curated promotion (`knowledge curate`, D-016), user-editable model-tier routing (`model`, D-017), and a confirm-gated `knowledge reset`. Cognee knowledge stack (per-project work · memory `:7777` · curated `:7730`) + Graphify code graph. Observability stack (watchd + TUI) as two `uv tool`-installable packages.
 
 ---
 
@@ -25,7 +25,7 @@ Requires Claude Code + Node ≥ 18.
 ```bash
 npx mishkan-harness install
 mishkan status
-mishkan observability              # optional: daemon + TUI (needs uv)
+mishkan observability install      # optional: daemon + TUI (needs uv)
 ```
 
 Full guide: [`docs/usage/01-installation.md`](docs/usage/01-installation.md).
@@ -46,6 +46,43 @@ claude                    # starts in exploration mode — Nehemiah + Bezalel
 
 **Nehemiah** (PM — scope, delivery, sprint) and **Bezalel** (CTO — architecture, standards, quality bar) route everything. Six teams, each `Lead → Specialists → QA → Reporter`:
 
+```mermaid
+flowchart TD
+    You(["You · the engineer"]) -->|talk| MS[["MAIN SESSION = leadership<br/>Nehemiah · PM + Bezalel · CTO<br/>the one orchestrator — delegates one level deep, then synthesises"]]
+
+    MS -->|Task| CH["Chosheb<br/>Design / UX"]
+    MS -->|Task| PA["Panim<br/>Frontend"]
+    MS -->|Task| YA["Yasad<br/>Backend & data"]
+    MS -->|Task| MI["Migdal<br/>Infrastructure"]
+    MS -->|Task| SE["Sefer<br/>Documentation"]
+    MS -->|Task| RP["Research pipeline<br/>Jakin → Ezra → Caleb → Shaphan → Shemaiah → Baruch"]
+
+    MM["Mishmar · Security<br/>cross-cutting — gates every team"]
+    MM -. gates .-> CH
+    MM -. gates .-> PA
+    MM -. gates .-> YA
+    MM -. gates .-> MI
+    MM -. gates .-> SE
+
+    MS -. reads / writes .-> KN
+    subgraph KN["Knowledge — 4 surfaces"]
+      direction LR
+      GFY[("Graphify<br/>code structure · per-project")]
+      WORK[("cognee work<br/>per-project · isolated")]
+      MEM[("cognee-memory :7777<br/>session memory · shared")]
+      CUR[("cognee-curated :7730<br/>reference library · shared")]
+    end
+
+    MS -. stateful ops stay yours .-> HANDS["your hands<br/>git push · prod · schema migrations"]
+```
+
+*One leadership session (Nehemiah + Bezalel) delegates one level deep to the six teams + the
+research pipeline, then synthesises. Within each team: `Lead → Specialists → QA → Reporter`
+(QA & Reporter structurally separate — no agent grades its own work). Mishmar's security gate
+crosses every team. It reads/writes four knowledge surfaces, and **stateful operations — `git
+push`, production, schema migrations — stay in your hands** (the asymmetric AI/human boundary).
+Diagrams render on GitHub.*
+
 | Team | Hebrew | Domain |
 |------|--------|--------|
 | **Chosheb** | *cunning work* | Design & UX |
@@ -63,13 +100,11 @@ A shared research pipeline (Jakin → Ezra → Caleb → Shaphan → Shemaiah
 
 Wired by `/mishkan-init` into each project's `.mcp.json`:
 
-**Cognee** — semantic knowledge graph. Per-project work store (`:7777`) + cross-project curated reference library (`:7730`). Docker-based, pinned, SOPS-managed secrets.
+**Cognee** — semantic knowledge graph. Per-project isolated work store (own port, Ladybug) + shared session memory (`cognee-memory`, `:7777`) + cross-project curated reference library (`cognee-curated`, `:7730`). Docker-based, pinned, SOPS-managed secrets. Three pillars wired per project by `/mishkan-init` (D-007 + D-012).
 
 ```bash
-mishkan configure-knowledge        # wizard: LLM provider + credentials + .env
-cd ~/.claude/mishkan/cognee
-docker compose -f docker-compose.yml -f docker-compose.hardening.yml up -d --build
-~/.claude/mishkan/scripts/seed-curated-library.sh
+mishkan knowledge configure        # wizard: LLM provider + credentials + .env
+mishkan knowledge-stack up         # memory :7777 + curated :7730 (guided; preflights config, seeds curated)
 ```
 
 Guide: [`payload/mishkan/cognee/README.md`](payload/mishkan/cognee/README.md) · [`docs/usage/04-memory-layer.md`](docs/usage/04-memory-layer.md).
@@ -86,7 +121,7 @@ mishkan code-graph status          # node/edge count, last scan time
 Two Python packages (`uv tool`-installable): a daemon (`mishkan-watchd`) that tails every session's event bus and a Textual TUI (`mishkan-watch`) with 8 tabs — Live, Agents, Workflows, Knowledge, Activity, Org-Ref, Usage, Skills. Cross-session, cross-project, near-zero overhead.
 
 ```bash
-mishkan observability              # install both packages
+mishkan observability install      # install both packages
 mishkan-watch                      # opens TUI, auto-starts daemon if absent
 mishkan-watchd start|stop|status   # manual daemon control
 ```
@@ -129,10 +164,13 @@ mishkan help                                        # full reference
 mishkan install                                     # install/refresh into ~/.claude
 mishkan uninstall                                   # remove harness (keeps CLAUDE.md + rules)
 mishkan uninstall --purge                           # also remove y4nn-standards.md
-mishkan configure-knowledge                         # wizard: LLM provider + Cognee .env
-mishkan observability                               # install daemon + TUI only (needs uv)
+mishkan knowledge configure                         # wizard: LLM provider + Cognee .env
+mishkan knowledge curate                            # approve research-found resources into curated (D-016)
+mishkan knowledge reset                             # wipe stores → re-seed curated baseline (destructive)
+mishkan model show|set|reset                        # re-tier agents per-agent/team/all — survives updates (D-017)
+mishkan observability install                       # install daemon + TUI only (needs uv)
 mishkan status                                      # install state, profile, version
-mishkan org [--json]                                # print the 45-agent org
+mishkan org show [--json]                                # print the 45-agent org
 mishkan code-graph [status|open|scan]               # inspect the project's Graphify graph
 mishkan-watch                                       # open observability TUI (auto-starts daemon)
 mishkan-watch --no-autostart                        # TUI only, no daemon fork