@monoes/monomindcli 1.8.0 → 1.9.0

package/.claude/commands/mastermind/architect.md

@@ -0,0 +1,49 @@
+---
+name: mastermind-architect
+description: Mastermind architect domain — architecture review, file structure deduplication, coupling analysis, design pattern audit, DDD mapping, and system design. Default mode: confirm.
+---
+
+Parse `$ARGUMENTS` for:
+- `--auto` flag → mode = auto
+- `--confirm` flag → mode = confirm (default)
+- `--project <name>` → project_name = <name> (if omitted, default to `basename "$PWD"`)
+- `--scope <scope>` → scope = review | design | deduplicate | migrate | all (default: infer from prompt using these keyword rules: "review"/"audit"/"check"/"assess" → review; "deduplicate"/"dedup"/"consolidate" → deduplicate; "design"/"architect"/"model"/"bounded context" → design; "migrate"/"migration"/"port to"/"convert" → migrate; no keyword match → all; if more than one scope keyword matches, use `all`)
+- `--stack <stack>` → stack hint (e.g. typescript, python, react, go) — auto-detected if omitted
+- `--iterate <N>` → iterate = N (integer ≥ 1; default 0 = no iteration) — run N autonomous fix+review cycles after the initial architect pass
+- Remaining text = prompt
+
+If prompt is empty: ask "What would you like the architect to do? (e.g. 'review the codebase structure', 'deduplicate files', 'design the API layer', 'map bounded contexts')"
+
+Load brain context for the `architect` domain (follow _protocol.md Brain Load Procedure).
+
+Run intake if prompt is vague (follow _intake.md — stop at Q3, domain is already known as `architect`).
+
+Default mode for this command: **confirm** (show architecture plan before executing, unless `--auto` flag present).
+
+Generate a session ID: take the current UTC datetime formatted as `YYYYMMDDTHHmmss` and prefix with `mm-` (e.g. `mm-20260506T142345`)
+
+Emit `session:start` before invoking the skill using WebFetch (handles prompt encoding safely for any characters):
+```javascript
+WebFetch({
+  url: "http://localhost:4242/api/mastermind/event",
+  method: "POST",
+  headers: { "Content-Type": "application/json" },
+  body: JSON.stringify({ type: "session:start", session: sessionId, domain: "architect", prompt: prompt, ts: Date.now() })
+})
+```
+
+Emit `domain:dispatch` immediately after session:start. Before executing the curl below, substitute the generated sessionId for `<sessionId>`:
+```bash
+curl -s -X POST "http://localhost:4242/api/mastermind/event" \
+  -H "Content-Type: application/json" \
+  -d '{"type":"domain:dispatch","session":"<sessionId>","domain":"architect","ts":'"$(date +%s)"'000}' || true
+```
+
+Invoke `Skill("mastermind:architect")` passing: brain_context, prompt, project_name, board_id (create board named "architect" inside the project_name monotask space if not already present), mode, scope, stack, sessionId, iterate, caller: "command".
+
+After skill returns: note the status from the skill's output (`complete`, `partial`, or `blocked`). Emit `session:complete` using that status, then follow _protocol.md Brain Write Procedure for domain `architect`. Before executing the curl below, substitute the generated sessionId for `<sessionId>` and the skill's actual status for `<status>`:
+```bash
+curl -s -X POST "http://localhost:4242/api/mastermind/event" \
+  -H "Content-Type: application/json" \
+  -d '{"type":"session:complete","session":"<sessionId>","domain":"architect","status":"<status>","domains":["architect"],"ts":'"$(date +%s)"'000}' || true
+```

package/.claude/commands/mastermind/brain.md

@@ -0,0 +1,98 @@
+---
+name: mastermind-brain
+description: Mastermind brain management — inspect, compact, refresh, and control the three-tier business memory (AgentDB + Monograph)
+---
+
+Parse `$ARGUMENTS` to determine the sub-command and flags.
+
+## Sub-Commands
+
+### `status` (default if no sub-command given)
+
+Show the current state of all brain tiers across all domains.
+
+For each domain that has data, call:
+- `mcp__monomind__agentdb_health` on namespace `mastermind:<domain>:raw` → Tier 1 entry count, last write date, archived count
+- `mcp__monomind__agentdb_health` on namespace `mastermind:<domain>:weekly` → Tier 2 summary count, last compaction date
+- `mcp__monomind__agentdb_health` on namespace `mastermind:principles` → Tier 3 principle count
+
+Display as a table:
+
+```
+MASTERMIND BRAIN STATUS
+════════════════════════════════════════════════
+Domain     │ Tier 1 (raw) │ Tier 2 (weekly) │ Tier 3 (principles)
+───────────┼──────────────┼─────────────────┼────────────────────
+build      │ 14 entries   │ 2 summaries     │ shared (see below)
+marketing  │ 8 entries    │ 1 summary       │
+...        │              │                 │
+───────────┼──────────────┼─────────────────┼────────────────────
+PRINCIPLES │              │                 │ 7 core principles
+════════════════════════════════════════════════
+Last compaction: 2026-04-28 | Next due: 2026-05-05
+Avg memory score: 0.64 | Entries below archive threshold: 3
+```
+
+---
+
+### `compact`
+
+Force immediate weekly distillation across all domains (or `--domain <name>` for one domain).
+
+For each domain (or the specified domain):
+1. Retrieve all Tier 1 raw entries since last compaction via `mcp__monomind__agentdb_hierarchical-recall` (namespace `mastermind:<domain>:raw`)
+2. Produce per-domain weekly summary: synthesize decisions, patterns, and lessons into ≤300 words
+3. Store to Tier 2 via `mcp__monomind__agentdb_hierarchical-store` (namespace `mastermind:<domain>:weekly`)
+4. Archive Tier 1 entries with score < 0.1 (update metadata: `{ archived: true }`)
+5. Report: "Compacted <domain>: <N> entries → <M> summary, <K> archived"
+
+---
+
+### `refresh --domain <name>`
+
+Re-cluster the knowledge graph for a specific domain and rebuild Tier 3 principles from it.
+
+1. Call `mcp__monomind__monograph_community` for nodes matching `mastermind:<domain>`
+2. For any cluster of 3+ similar nodes: merge into a single principle (LLM synthesis)
+3. Store merged principle: `mcp__monomind__agentdb_hierarchical-store` namespace `mastermind:principles`
+4. For conflicting nodes: add `EXCEPTION` edge via `mcp__monomind__monograph_add_fact`
+5. Report: "Refreshed <domain>: <N> clusters found, <M> principles updated, <K> exceptions noted"
+
+---
+
+### `inspect --tier <1|2|3> [--domain <name>] [--limit <N>]`
+
+Show raw contents of a specific brain tier.
+
+- Tier 1: Call `mcp__monomind__agentdb_hierarchical-recall` on `mastermind:<domain>:raw`, display each entry with its score and date.
+- Tier 2: Call `mcp__monomind__agentdb_hierarchical-recall` on `mastermind:<domain>:weekly`, display summaries with dates.
+- Tier 3: Call `mcp__monomind__agentdb_hierarchical-recall` on `mastermind:principles`, display all principles.
+
+Default limit: 10. Use `--limit N` to override.
+
+---
+
+### `forget --query "<text>"`
+
+Find and archive all brain entries semantically matching the query.
+
+1. Call `mcp__monomind__agentdb_pattern-search` with query text across all mastermind namespaces
+2. Display matching entries with their scores and domains
+3. Ask: "Archive these N entries? (yes/no)"
+4. If yes: update each entry's metadata to `{ archived: true }`
+5. Report: "Archived N entries matching '<query>'"
+
+---
+
+### `reset --domain <name> --confirm`
+
+**Destructive.** Wipes all brain data for a specific domain. Requires `--confirm` flag explicitly — refuse if missing.
+
+If `--confirm` is present:
+1. Delete all Tier 1 entries: `mcp__monomind__memory_delete` on namespace `mastermind:<domain>:raw`
+2. Delete all Tier 2 entries: `mcp__monomind__memory_delete` on namespace `mastermind:<domain>:weekly`
+3. Remove domain nodes from Monograph graph
+4. Report: "Reset complete for domain <name>. All memory wiped."
+
+If `--confirm` is missing:
+> "This will permanently delete all brain memory for domain '<name>'. To confirm, run: `/mastermind:brain reset --domain <name> --confirm`"

package/.claude/commands/mastermind/build.md

@@ -0,0 +1,22 @@
+---
+name: mastermind-build
+description: Mastermind build domain — ship features, fix bugs, refactor code. Spawns a Development Manager who creates monotask tasks and coordinates specialized dev agents. Default mode: auto.
+---
+
+Parse `$ARGUMENTS` for:
+- `--auto` flag → mode = auto
+- `--confirm` flag → mode = confirm
+- `--project <name>` → project_name = <name>
+- Remaining text = prompt
+
+If prompt is empty: ask "What would you like to build or fix?"
+
+Load brain context for the `build` domain (follow _protocol.md Brain Load Procedure).
+
+Run intake if prompt is vague (follow _intake.md — stop at Q3, domain is already known as `build`).
+
+Default mode for this command: **auto** (unless `--confirm` flag present or intake Q4 says confirm).
+
+Invoke `Skill("mastermind:build")` passing: brain_context, prompt, project_name, board_id (create if needed), mode.
+
+After skill returns: follow _protocol.md Brain Write Procedure for domain `build`.

package/.claude/commands/mastermind/content.md

@@ -0,0 +1,22 @@
+---
+name: mastermind-content
+description: Mastermind content domain — blog posts, threads, docs, newsletters. Default mode: confirm.
+---
+
+Parse `$ARGUMENTS` for:
+- `--auto` flag → mode = auto
+- `--confirm` flag → mode = confirm
+- `--project <name>` → project_name = <name>
+- Remaining text = prompt
+
+If prompt is empty: ask "What content would you like created?"
+
+Load brain context for the `content` domain (follow _protocol.md Brain Load Procedure).
+
+Run intake if prompt is vague (follow _intake.md — stop at Q3, domain is already known as `content`).
+
+Default mode for this command: **confirm** (unless `--auto` flag present or intake Q4 says auto).
+
+Invoke `Skill("mastermind:content")` passing: brain_context, prompt, project_name, board_id (create if needed), mode.
+
+After skill returns: follow _protocol.md Brain Write Procedure for domain `content`.

package/.claude/commands/mastermind/createorg.md

@@ -0,0 +1,94 @@
+---
+name: mastermind-createorg
+description: Define and save an autonomous agent organization — roles, hierarchy, and communication topology. Suggest or confirm roles, then persist the org for use with runorg.
+---
+
+**If $ARGUMENTS is empty:** Output the following and wait.
+
+---
+
+**MASTERMIND: CREATE ORG**
+
+An org is a named, persistent agent team — not a one-shot Mastermind run. Once created, the org runs autonomously across sessions: a boss agent coordinates specialists who pick up tasks from a shared board, execute them, and loop until stopped.
+
+Use orgs when the work is ongoing, not single-shot. A content team that ships 10 posts a month. A research squad that runs competitive scans weekly. A dev team with a permanent backlog.
+
+**What you provide:**
+- A goal — what should this org continuously accomplish?
+- Optional roles — or let Mastermind suggest them from the goal
+
+**Examples:**
+
+```
+/mastermind:createorg A content team that publishes 3 blog posts per week — writer, editor, SEO reviewer, publisher
+
+/mastermind:createorg --name research-pod Weekly competitor intelligence: researcher, analyst, summarizer
+
+/mastermind:createorg --auto An engineering team for ongoing feature development on my SaaS product
+```
+
+**Options:**
+`--name <slug>` — org identifier used with `/mastermind:runorg` (derived from goal if omitted)
+`--roles <list>` — explicit role list (e.g. "boss, writer, reviewer, marketer")
+`--auto` — skip confirmation, create immediately
+`--confirm` — always ask before saving (default)
+
+Once created, start the org with `/mastermind:runorg --org <name>`.
+
+---
+
+**If $ARGUMENTS is non-empty:** Execute the flow below.
+
+---
+
+Parse `$ARGUMENTS` for:
+- `--auto` flag → mode = auto (no confirmation prompt)
+- `--confirm` flag → mode = confirm
+- `--name <name>` → org_name = <name> (must match `^[a-z0-9][a-z0-9-]{0,63}$`; if omitted, derived from goal)
+- `--roles <desc>` → roles_desc = <desc> (explicit role list, e.g. "boss, writer, reviewer, marketer")
+- Remaining text = prompt (goal description)
+
+If neither `--auto` nor `--confirm` was provided, default: **mode = confirm**.
+
+If prompt is empty: ask "Describe your org's goal and optionally list the roles you want (e.g. 'a content team with a boss, writer, reviewer, and marketer to produce 10 blog posts per month')."
+
+Load brain context for the `ops` domain (follow _protocol.md Brain Load Procedure, namespace: `ops`).
+
+Generate a session ID as a real shell variable:
+```bash
+session_id="mm-$(date -u +%Y%m%dT%H%M%S)"
+```
+
+Emit `session:start` to dashboard:
+```bash
+curl -s -X POST "http://localhost:4242/api/mastermind/event" \
+  -H "Content-Type: application/json" \
+  -d "$(jq -cn \
+    --arg session "$session_id" \
+    --arg prompt "$prompt" \
+    --arg mode "$mode" \
+    '{type:"session:start",session:$session,domain:"ops",prompt:$prompt,mode:$mode,ts:(now*1000|floor)}')" || true
+```
+
+Emit `domain:dispatch`:
+```bash
+curl -s -X POST "http://localhost:4242/api/mastermind/event" \
+  -H "Content-Type: application/json" \
+  -d "$(jq -cn \
+    --arg session "$session_id" \
+    '{type:"domain:dispatch",session:$session,domain:"ops",cmd:"Designing and saving org definition",ts:(now*1000|floor)}')" || true
+```
+
+Invoke `Skill("mastermind:createorg")` passing: brain_context, prompt, org_name, roles_desc, mode, session_id: `$session_id`, caller: "command".
+
+After skill returns: note the status (`complete`, `partial`, or `blocked`). Emit `session:complete`:
+```bash
+curl -s -X POST "http://localhost:4242/api/mastermind/event" \
+  -H "Content-Type: application/json" \
+  -d "$(jq -cn \
+    --arg session "$session_id" \
+    --arg status "<status>" \
+    '{type:"session:complete",session:$session,domain:"ops",status:$status,domains:["ops"],ts:(now*1000|floor)}')" || true
+```
+
+Follow _protocol.md Brain Write Procedure for domain `ops`.

package/.claude/commands/mastermind/finance.md

@@ -0,0 +1,22 @@
+---
+name: mastermind-finance
+description: Mastermind finance domain — invoicing, budget tracking, financial forecasting. Default mode: confirm.
+---
+
+Parse `$ARGUMENTS` for:
+- `--auto` flag → mode = auto
+- `--confirm` flag → mode = confirm
+- `--project <name>` → project_name = <name>
+- Remaining text = prompt
+
+If prompt is empty: ask "What financial task would you like to handle?"
+
+Load brain context for the `finance` domain (follow _protocol.md Brain Load Procedure).
+
+Run intake if prompt is vague (follow _intake.md — stop at Q3, domain is already known as `finance`).
+
+Default mode for this command: **confirm** (unless `--auto` flag present or intake Q4 says auto).
+
+Invoke `Skill("mastermind:finance")` passing: brain_context, prompt, project_name, board_id (create if needed), mode.
+
+After skill returns: follow _protocol.md Brain Write Procedure for domain `finance`.

package/.claude/commands/mastermind/idea.md

@@ -0,0 +1,22 @@
+---
+name: mastermind-idea
+description: Mastermind idea domain — brainstorm products, features, pivots. Default mode: confirm.
+---
+
+Parse `$ARGUMENTS` for:
+- `--auto` flag → mode = auto
+- `--confirm` flag → mode = confirm
+- `--project <name>` → project_name = <name>
+- Remaining text = prompt
+
+If prompt is empty: ask "What would you like to brainstorm or ideate on?"
+
+Load brain context for the `idea` domain (follow _protocol.md Brain Load Procedure).
+
+Run intake if prompt is vague (follow _intake.md — stop at Q3, domain is already known as `idea`).
+
+Default mode for this command: **confirm** (unless `--auto` flag present or intake Q4 says auto).
+
+Invoke `Skill("mastermind:idea")` passing: brain_context, prompt, project_name, board_id (create if needed), mode.
+
+After skill returns: follow _protocol.md Brain Write Procedure for domain `idea`.

package/.claude/commands/mastermind/marketing.md

@@ -0,0 +1,22 @@
+---
+name: mastermind-marketing
+description: Mastermind marketing domain — campaigns, copy, SEO, social media. Default mode: confirm.
+---
+
+Parse `$ARGUMENTS` for:
+- `--auto` flag → mode = auto
+- `--confirm` flag → mode = confirm
+- `--project <name>` → project_name = <name>
+- Remaining text = prompt
+
+If prompt is empty: ask "What marketing task would you like to tackle?"
+
+Load brain context for the `marketing` domain (follow _protocol.md Brain Load Procedure).
+
+Run intake if prompt is vague (follow _intake.md — stop at Q3, domain is already known as `marketing`).
+
+Default mode for this command: **confirm** (unless `--auto` flag present or intake Q4 says auto).
+
+Invoke `Skill("mastermind:marketing")` passing: brain_context, prompt, project_name, board_id (create if needed), mode.
+
+After skill returns: follow _protocol.md Brain Write Procedure for domain `marketing`.