@monoes/monomindcli 1.8.0 → 1.9.0

package/.claude/skills/mastermind/_intake.md

@@ -0,0 +1,83 @@
+---
+name: mastermind-intake
+description: Shared intake protocol for mastermind — rich-prompt detection, comprehensive intake questions asked one at a time, and LLM-decide logic. Never invoked directly; called by master and standalone domain commands.
+type: shared
+---
+
+# Mastermind Intake Protocol
+
+This file is referenced by `master.md` and domain commands. Never invoke directly.
+
+---
+
+## Rich Prompt Detection
+
+Count the words in `$ARGUMENTS` and scan for domain signals.
+
+**Rich prompt** (skip all intake questions → proceed to execution):
+- Word count ≥ 20 AND
+- Contains at least one domain signal (build, ship, feature, bug, fix, campaign, marketing, SEO, content, review, audit, research, launch, release, sales, outreach, ops, finance, report) AND
+- Contains a goal or outcome phrase (e.g. "so that", "by end of", "targeting", "for our", "to improve")
+
+**Vague prompt** (run intake): anything that doesn't meet rich-prompt criteria.
+
+Even with a rich prompt, if `--confirm` flag is present: skip to execution but show the plan before spawning agents and wait for "go".
+
+---
+
+## Intake Questions
+
+Ask ONE question at a time. Wait for the answer before asking the next. Stop asking as soon as you have enough to proceed.
+
+**Q1 — Goal:**
+> "What outcome defines success for this run? Be as specific as you can — what will be done or produced when we're finished?"
+
+**Q2 — Scope:**
+> "Which business domains should this touch? Options: build, idea, marketing, review, research, content, release, sales, ops, finance — or should I decide based on the goal?"
+
+**Q3 — Constraints:**
+> "Any constraints I should know about? Examples: don't touch production, stay within this codebase, only content work this week, timeline by end of sprint."
+
+**Q4 — Mode:**
+> "Should I execute automatically once I have a plan, or show you the plan first and wait for your approval before spawning agents?"
+
+**Q5 — Project:**
+> "Which project is this for? I'll create or find a monotask space with that name. (Or I can infer it from context.)"
+
+Skip Q4 if `--auto` or `--confirm` flag was provided. Skip Q5 if `--project <name>` flag was provided.
+
+---
+
+## LLM-Decide Rule
+
+If the user responds with any of: "decide yourself", "you decide", "your call", "whatever you think", "up to you" — to any intake question:
+
+1. Make an explicit decision. State it clearly:
+   > "I'm choosing [X] because [one-sentence reason]."
+2. Log this as a decision in the run's output schema with `confidence: 0.7` and `outcome: pending`.
+3. Continue immediately. Do NOT ask a follow-up on the same question.
+
+---
+
+## Mode Resolution
+
+After intake (or skip), resolve the execution mode:
+
+| Flag / Answer | Mode |
+|---|---|
+| `--auto` flag | auto — spawn immediately after planning |
+| `--confirm` flag | confirm — show plan, wait for "go" |
+| Q4 answer: "auto" or "yes go ahead" | auto |
+| Q4 answer: "show me first" or "confirm" | confirm |
+| No flag, vague prompt | confirm (default for vague) |
+| No flag, rich prompt | auto (default for rich) |
+
+---
+
+## Project Name Resolution
+
+Priority order:
+1. `--project <name>` flag — use exactly as provided
+2. Q5 answer — use as provided
+3. Infer from prompt: extract the most prominent product/project noun
+4. Fallback: use today's date as `session-YYYY-MM-DD`

package/.claude/skills/mastermind/_protocol.md

@@ -0,0 +1,275 @@
+---
+name: mastermind-protocol
+description: Shared protocol for all mastermind domain skills — brain-load, brain-write, output schema, memory scoring, and task briefing standard. Never invoked directly; referenced by domain skills and master.
+type: shared
+---
+
+# Mastermind Protocol
+
+This file is a reference loaded by mastermind domain skills and master. It is NEVER invoked directly via the Skill tool.
+
+---
+
+## Brain Load Procedure
+
+Execute at the START of every mastermind run (master or standalone domain command). Load in this order:
+
+**Step A — Tier 3 core principles (all domains):**
+Call `mcp__monomind__agentdb_hierarchical-recall` with:
+- namespace: `mastermind:principles`
+- limit: 20
+
+**Step B — Tier 2 weekly summary for this domain:**
+Call `mcp__monomind__agentdb_context-synthesize` with:
+- namespace: `mastermind:<domain>:weekly`
+- query: [current prompt keywords]
+
+**Step C — Relevant graph nodes:**
+Call `mcp__monomind__monograph_query` with:
+- query: [3-5 keywords extracted from current prompt]
+
+Combine all results into a **BRAIN CONTEXT** block. Insert this block before any planning, decomposition, or agent spawning step. Format:
+
+```
+=== BRAIN CONTEXT ===
+[Tier 3 principles]
+[Tier 2 domain summary]
+[Relevant graph nodes]
+=====================
+```
+
+If any MCP call fails or returns empty, continue without that tier — do not abort the run.
+
+---
+
+## Brain Write Procedure
+
+Execute at the END of every mastermind run. Always runs even if execution was partial or blocked.
+
+**Step 1 — Score this run:**
+```
+score = confidence × (1 / (days_since_run + 1)) × log(uses + 1)
+```
+- `confidence`: average of all decision confidence values from the unified output schema
+- `days_since_run`: 0 (this is a fresh run)
+- `uses`: 1 (first write)
+
+**Step 2 — Append to Tier 1 raw log:**
+Call `mcp__monomind__agentdb_hierarchical-store` with:
+- namespace: `mastermind:<domain>:raw`
+- content: [full unified output schema YAML from this run, as a string]
+- metadata: `{ score, project, run_id, date: ISO8601, domain }`
+
+**Step 3 — Check weekly compaction trigger:**
+Call `mcp__monomind__agentdb_health` on namespace `mastermind:<domain>:raw`.
+If `entry_count >= 20` OR `days_since_last_compaction >= 7`:
+1. Retrieve all Tier 1 entries since last compaction
+2. Produce a per-domain weekly summary (use LLM synthesis: "Summarize the key decisions, patterns, and lessons from these run logs in under 300 words")
+3. Store summary: `mcp__monomind__agentdb_hierarchical-store` namespace `mastermind:<domain>:weekly`
+4. Archive (do not delete) Tier 1 entries with score < 0.1 by updating their metadata: `{ archived: true }`
+
+**Step 4 — Check graph consolidation trigger:**
+Call `mcp__monomind__monograph_community` for nodes matching `mastermind:<domain>`.
+If 3+ similar memory nodes are detected in a cluster:
+1. Merge into a single principle via LLM: "Distill these memories into one clear principle in 1-2 sentences"
+2. Store principle: `mcp__monomind__agentdb_hierarchical-store` namespace `mastermind:principles`
+3. Add `EXCEPTION` edge in Monograph for any conflicting memory: `mcp__monomind__monograph_add_fact`
+
+---
+
+## Unified Output Schema
+
+Every domain skill MUST return exactly this YAML to its caller. No extra fields. No missing fields.
+
+```yaml
+domain: <build|marketing|review|research|content|release|sales|ops|finance|idea>
+status: complete | partial | blocked
+artifacts:
+  - path: /absolute/path/to/file
+    type: code | copy | report | config
+decisions:
+  - what: "description of the decision"
+    why: "reasoning behind it"
+    confidence: 0.0-1.0
+    outcome: shipped | pending | reverted
+lessons:
+  - what_worked: "description"
+  - what_didnt: "description"
+next_actions:
+  - "suggested follow-up command"
+board_url: "monotask://<project>/<domain>"
+run_id: "<ISO8601-timestamp>"
+```
+
+Empty fields use `[]`. The `status` field reflects the highest-level result: `complete` = all tasks done, `partial` = some tasks done, `blocked` = could not proceed (include reason in `lessons.what_didnt`).
+
+---
+
+## Memory Scoring Formula
+
+```
+score = confidence × (1 / (days_since_run + 1)) × log(uses + 1)
+```
+
+| Variable | Source |
+|---|---|
+| `confidence` | Average of `decisions[].confidence` from output schema |
+| `days_since_run` | 0 on day of run, increases 1 per calendar day |
+| `uses` | Incremented each time this memory is returned by brain load |
+| Archive threshold | score < 0.1 |
+| Reinforcement | Increment `uses` on every brain load hit |
+
+---
+
+## Real-Time Dashboard Event Logging
+
+Every mastermind run MUST emit structured events to the live dashboard via WebFetch. The dashboard at `docs/mastermind-diagram.html` listens on SSE and animates each event in real time.
+
+**Dashboard endpoint:** `http://localhost:4242/api/mastermind/event`
+**Method:** POST, `Content-Type: application/json`
+
+### Event Types and When to Emit
+
+**1. session:start** — emit at the very start of Step 3 (Intake) once the prompt is resolved:
+```json
+{
+  "type": "session:start",
+  "session": "<uuid-v4>",
+  "prompt": "<resolved user prompt>",
+  "mode": "auto|confirm",
+  "ts": 1234567890000
+}
+```
+
+**2. domain:dispatch** — emit once per domain BEFORE spawning the domain manager agent:
+```json
+{
+  "type": "domain:dispatch",
+  "session": "<same-uuid>",
+  "domain": "build|marketing|review|research|content|release|sales|ops|finance|idea",
+  "cmd": "<one-line description of what this domain will do>",
+  "ts": 1234567890000
+}
+```
+
+**3. agent:spawn** — domain managers MUST emit this when they spawn each specialized agent:
+```json
+{
+  "type": "agent:spawn",
+  "session": "<same-uuid>",
+  "domain": "<domain-id>",
+  "agent": "<agent-slug, e.g. backend-dev>",
+  "task": "<task description>",
+  "ts": 1234567890000
+}
+```
+
+**4. intercom** — emit when a domain manager or agent sends output/context to another domain:
+```json
+{
+  "type": "intercom",
+  "session": "<same-uuid>",
+  "from": "<domain-id>",
+  "to": "<domain-id>",
+  "msg": "<one-line summary of what was transferred>",
+  "ts": 1234567890000
+}
+```
+
+**5. domain:complete** — emit when a domain manager returns its unified output schema:
+```json
+{
+  "type": "domain:complete",
+  "session": "<same-uuid>",
+  "domain": "<domain-id>",
+  "status": "complete|partial|blocked",
+  "artifacts": ["<path1>", "<path2>"],
+  "decisions": [{"what": "...", "confidence": 0.9}],
+  "ts": 1234567890000
+}
+```
+
+**6. session:complete** — emit at the end of Step 9 (Synthesize) after all domains have reported:
+```json
+{
+  "type": "session:complete",
+  "session": "<same-uuid>",
+  "status": "complete|partial|blocked",
+  "domains": ["build", "marketing"],
+  "ts": 1234567890000
+}
+```
+
+### How to Emit (WebFetch pattern)
+
+```javascript
+WebFetch({
+  url: "http://localhost:4242/api/mastermind/event",
+  method: "POST",
+  headers: { "Content-Type": "application/json" },
+  body: JSON.stringify({
+    type: "session:start",
+    session: crypto.randomUUID(),   // or generate a timestamp-based ID
+    prompt: resolvedPrompt,
+    mode: mode,
+    ts: Date.now()
+  })
+})
+```
+
+**If the server is not running** (WebFetch returns an error), log a warning and continue — event logging is non-blocking and MUST NOT abort the run.
+
+**Session ID:** Generate once at session:start and reuse across all subsequent events for this run. A simple ID format: `mm-<ISO8601-compact>` (e.g. `mm-20260505T142300`).
+
+### Where Each Role Emits
+
+| Role | Events to emit |
+|---|---|
+| **Master** (master.md Step 3) | `session:start` |
+| **Master** (master.md Step 7, per domain) | `domain:dispatch` × N |
+| **Master** (master.md Step 9) | `session:complete` |
+| **Domain Manager** (on agent spawn) | `agent:spawn` × M |
+| **Domain Manager** (on cross-domain handoff) | `intercom` |
+| **Domain Manager** (on return) | `domain:complete` |
+
+---
+
+## Monotask Task Briefing Standard
+
+Every monotask card MUST include ALL fields below in its description and comment. Agents read task cards cold — no back-channel context exists.
+
+Create each card using `monotask card create`, then populate it. First resolve column IDs:
+```bash
+columns=$(monotask column list "$BOARD_ID" --json)
+COL_TODO_ID=$(echo "$columns" | jq -r '.[] | select(.name == "Todo" or .name == "Backlog") | .id' | head -1)
+COL_DONE_ID=$(echo "$columns" | jq -r '.[] | select(.name == "Done") | .id' | head -1)
+```
+Then create the card:
+```bash
+result=$(monotask card create "$BOARD_ID" "$COL_TODO_ID" "<short title ≤80 chars: summary of GOAL>" --json)
+CARD_ID=$(echo "$result" | jq -r '.id // empty')
+monotask card set-description "$BOARD_ID" "$CARD_ID" "[One measurable objective — what success looks like]"
+monotask card comment add "$BOARD_ID" "$CARD_ID" "CONTEXT: [ISO date] | Project: [name] | Created by: [domain] Manager
+
+BRAIN MEMORY:
+[Paste the most relevant 3-5 excerpts from the loaded BRAIN CONTEXT block]
+
+SCOPE:
+- Files/dirs in scope: [explicit paths]
+- Files/dirs out of scope: [explicit exclusions if relevant]
+
+CONSTRAINTS:
+- [Must-not-break items]
+- [Existing APIs to preserve]
+- [Timeline if applicable]
+
+SUCCESS CRITERIA:
+- [ ] [Concrete checkable item 1]
+- [ ] [Concrete checkable item 2]
+
+AGENT: [agent slug, e.g. backend-dev | sparc-coder | frontend-dev]
+SWARM: [topology agent-count consensus, e.g. \"hierarchical 4 raft\"]
+
+DEPENDENCIES: [task IDs, or \"none\"]
+OUTPUT FORMAT: Unified output schema (see mastermind _protocol.md)"
+```