monomind 2.7.11 → 2.7.13

package/packages/@monomind/cli/.claude/skills/mastermind-wiki/SKILL.md

@@ -1,314 +0,0 @@
----
-name: mastermind-wiki
-description: Mastermind wiki — org-scoped knowledge base with ingest, query, maintain, lint, and distill operations. Stores durable synthesis in .monomind/orgs/<org>/wiki/ with page citations, raw sources, and change log. Port of Paperclip's LLM Wiki plugin skills adapted for mastermind orgs.
-type: domain-skill
-default_mode: auto
----
-
-# Mastermind Wiki
-
-This skill is invoked by `mastermind:wiki` or directly via `/mastermind:wiki`.
-
----
-
-## Inputs
-
-- `brain_context`: BRAIN CONTEXT block (injected by command, or loaded below if standalone)
-- `org_name`: org whose wiki to operate on (required)
-- `action`: query | ingest | list | maintain | lint | distill | page
-- `question`: question or search term (required for query)
-- `source`: path or URL to ingest (required for ingest)
-- `page_slug`: wiki page slug to read/write (required for page)
-- `content`: content to write to a page (required for page write)
-- `caller`: command | master
-
----
-
-## Wiki Structure
-
-```
-.monomind/orgs/<org>/wiki/
-  index.md          ← navigation hub; must be kept current
-  log.md            ← append-only change log
-  concepts/         ← concepts, definitions, architectural decisions
-  projects/         ← per-project knowledge (standup.md + index.md)
-  synthesis/        ← synthesized answers filed from queries
-  raw/              ← raw source material (never modified after ingest)
-```
-
-**Invariants:**
-- Raw sources in `raw/` are NEVER modified after ingest
-- Every durable page write must append a `log.md` entry
-- `index.md` must be updated when pages are added or removed
-- Answers cite wiki pages or raw sources inline, not in footnote blocks
-
----
-
-## Step 0 — Brain Load (standalone only)
-
-If `caller` is not "command", load brain context following mastermind-protocol/SKILL.md Brain Load Procedure with namespace: `ops`.
-
----
-
-## Step 1 — Resolve Wiki Root
-
-```bash
-orgFile=".monomind/orgs/${org_name}.json"
-[ ! -f "$orgFile" ] && { echo "ERROR: Org '${org_name}' not found."; exit 1; }
-
-wikiRoot=".monomind/orgs/${org_name}/wiki"
-mkdir -p "$wikiRoot/concepts" "$wikiRoot/projects" "$wikiRoot/synthesis" "$wikiRoot/raw"
-
-if [ ! -f "$wikiRoot/index.md" ]; then
-  cat > "$wikiRoot/index.md" << EOF
-# Wiki — ${org_name}
-
-This is the org knowledge base. Navigate by category or search with \`/mastermind:wiki --action query\`.
-
-## Concepts
-(none yet)
-
-## Projects
-(none yet)
-
-## Synthesis
-(none yet)
-EOF
-fi
-
-[ ! -f "$wikiRoot/log.md" ] && echo "# Wiki Log — ${org_name}" > "$wikiRoot/log.md"
-```
-
----
-
-## Step 2 — Execute Action
-
-### query (default)
-
-Answer a question from what the wiki contains, with citations.
-
-```bash
-[ -z "$question" ] && { echo "ERROR: --question required."; exit 1; }
-echo "WIKI QUERY — ${org_name}"
-echo "Q: $question"
-echo "────────────────────────────────────────────────────────"
-
-python3 - "$wikiRoot" "$question" <<'PYEOF'
-import os, sys, re
-root, query = sys.argv[1], sys.argv[2].lower()
-hits = []
-
-def scan_dir(d, prefix):
-    if not os.path.isdir(d): return
-    for fname in os.listdir(d):
-        if not fname.endswith(".md"): continue
-        fpath = os.path.join(d, fname)
-        try:
-            text = open(fpath).read()
-            if query in text.lower():
-                snippet = ""
-                for line in text.split("\n"):
-                    if query in line.lower():
-                        snippet = line.strip()[:120]
-                        break
-                hits.append((prefix + "/" + fname, snippet))
-        except: pass
-
-scan_dir(os.path.join(root, "concepts"), "concepts")
-scan_dir(os.path.join(root, "synthesis"), "synthesis")
-scan_dir(os.path.join(root, "projects"), "projects")
-scan_dir(os.path.join(root, "raw"), "raw")
-
-if not hits:
-    print("  No wiki pages match that query.")
-    print("  Use --action ingest to add source material, or --action distill to synthesize from org data.")
-else:
-    print(f"  {len(hits)} page(s) match:")
-    for path, snippet in hits[:10]:
-        print(f"\n  [[{path}]]")
-        if snippet: print(f"    → {snippet}")
-PYEOF
-```
-
-### list
-
-Show all wiki pages.
-
-```bash
-echo "WIKI INDEX — ${org_name}"
-echo "────────────────────────────────────────────────────────"
-cat "$wikiRoot/index.md"
-echo ""
-echo "  Raw sources: $(ls $wikiRoot/raw/ 2>/dev/null | wc -l) file(s)"
-```
-
-### ingest
-
-Add a raw source file to the wiki. Raw sources are immutable after ingest.
-
-```bash
-[ -z "$source" ] && { echo "ERROR: --source required (path to file)."; exit 1; }
-ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
-srcBase=$(basename "$source")
-dstPath="$wikiRoot/raw/$srcBase"
-
-if [ -f "$dstPath" ]; then
-  echo "  Already ingested: $srcBase"
-else
-  cp "$source" "$dstPath" && echo "  Ingested: $srcBase → $wikiRoot/raw/"
-  echo "$(date -u +%Y-%m-%d) | ingest | raw/$srcBase" >> "$wikiRoot/log.md"
-fi
-echo "  To synthesize a page from this source, use: /mastermind:wiki --action distill --source $srcBase"
-```
-
-### page
-
-Read or write a specific wiki page.
-
-```bash
-[ -z "$page_slug" ] && { echo "ERROR: --page-slug required."; exit 1; }
-ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
-
-if [ -n "$content" ]; then
-  # Write/update
-  pageDir="$wikiRoot/$(dirname $page_slug)"
-  mkdir -p "$pageDir"
-  pagePath="$wikiRoot/${page_slug}.md"
-  echo "$content" > "$pagePath"
-  echo "$(date -u +%Y-%m-%d) | update | ${page_slug}" >> "$wikiRoot/log.md"
-  echo "  Page written: $pagePath"
-  echo "  Remember to update index.md if this is a new page."
-else
-  # Read
-  pagePath="$wikiRoot/${page_slug}.md"
-  if [ -f "$pagePath" ]; then
-    cat "$pagePath"
-  else
-    echo "  Page not found: $page_slug"
-    echo "  Available pages:"
-    find "$wikiRoot" -name "*.md" ! -name "index.md" ! -name "log.md" | sed "s|$wikiRoot/||"
-  fi
-fi
-```
-
-### distill
-
-Synthesize a wiki page from raw sources and org data. The AI synthesizes based on context, writes the page, and logs it.
-
-```bash
-[ -z "$page_slug" ] && { echo "ERROR: --page-slug required."; exit 1; }
-ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
-pagePath="$wikiRoot/${page_slug}.md"
-
-echo "WIKI DISTILL — ${org_name}"
-echo "Target: ${page_slug}"
-echo "────────────────────────────────────────────────────────"
-
-if [ -n "$source" ] && [ -f "$wikiRoot/raw/$source" ]; then
-  echo "Source: $wikiRoot/raw/$source"
-  cat "$wikiRoot/raw/$source"
-fi
-
-echo ""
-echo "  Use the above source material to write a synthesis page at $pagePath."
-echo "  The page should: answer the most important questions, cite raw/ sources inline,"
-echo "  use a terse factual voice, and avoid summarizing what is already obvious."
-echo "  After writing, update index.md to link to the new page and append a distill log entry."
-```
-
-### maintain
-
-Check wiki health: stale pages, missing index links, unreferenced raw sources.
-
-```bash
-echo "WIKI HEALTH — ${org_name}"
-echo "────────────────────────────────────────────────────────"
-
-python3 - "$wikiRoot" <<'PYEOF'
-import os, sys
-root = sys.argv[1]
-
-pages = []
-for subdir in ["concepts","projects","synthesis"]:
-    d = os.path.join(root, subdir)
-    if not os.path.isdir(d): continue
-    for f in os.listdir(d):
-        if f.endswith(".md"): pages.append(f"{subdir}/{f}")
-
-raw_sources = os.listdir(os.path.join(root,"raw")) if os.path.isdir(os.path.join(root,"raw")) else []
-
-# Check index.md links
-index_text = open(os.path.join(root,"index.md")).read() if os.path.exists(os.path.join(root,"index.md")) else ""
-missing_links = [p for p in pages if p not in index_text]
-orphan_raw   = [r for r in raw_sources if r not in index_text and not any(r in open(os.path.join(root,p)).read() for p in pages if os.path.exists(os.path.join(root,p)))]
-
-print(f"  Pages: {len(pages)}")
-print(f"  Raw sources: {len(raw_sources)}")
-print()
-if missing_links:
-    print(f"  ⚠ {len(missing_links)} page(s) not in index.md:")
-    for p in missing_links: print(f"    · {p}")
-else:
-    print("  ✓ All pages listed in index.md")
-if orphan_raw:
-    print(f"\n  ⚠ {len(orphan_raw)} raw source(s) not referenced by any page:")
-    for r in orphan_raw: print(f"    · raw/{r}")
-else:
-    print("  ✓ All raw sources referenced")
-PYEOF
-```
-
-### lint
-
-Validate page formatting: headers, citations, no broken links.
-
-```bash
-echo "WIKI LINT — ${org_name}"
-echo "────────────────────────────────────────────────────────"
-
-python3 - "$wikiRoot" <<'PYEOF'
-import os, sys, re
-root = sys.argv[1]
-issues = []
-
-for subdir in ["concepts","projects","synthesis"]:
-    d = os.path.join(root, subdir)
-    if not os.path.isdir(d): continue
-    for fname in os.listdir(d):
-        if not fname.endswith(".md"): continue
-        fpath = os.path.join(d, fname)
-        text = open(fpath).read()
-        path = f"{subdir}/{fname}"
-        if not text.strip().startswith("#"):
-            issues.append(f"  {path}: missing H1 title")
-        wikilinks = re.findall(r'\[\[([^\]]+)\]\]', text)
-        for wl in wikilinks:
-            candidate = os.path.join(root, wl.lstrip("/"))
-            if not os.path.exists(candidate) and not os.path.exists(candidate+".md"):
-                issues.append(f"  {path}: broken wiki-link [[{wl}]]")
-
-if not issues:
-    print("  ✓ No lint issues found.")
-else:
-    print(f"  {len(issues)} issue(s):")
-    for i in issues: print(i)
-PYEOF
-```
-
----
-
-## Step 3 — Return Output
-
-```yaml
-domain: ops
-status: complete
-action: <action>
-org_name: <org_name>
-wiki_root: .monomind/orgs/<org_name>/wiki/
-```
-
----
-
-## Step 4 — Brain Write (standalone only)
-
-If `caller` is not "command", follow mastermind-protocol/SKILL.md Brain Write Procedure for domain `ops`.

package/packages/@monomind/cli/.claude/skills/mastermind-workspace-detail/SKILL.md

@@ -1,317 +0,0 @@
----
-name: mastermind-workspace-detail
-description: Mastermind workspace-detail — deep per-execution-workspace inspection and runtime control. Manage services, provision/teardown/cleanup commands, linked issues and routines, runtime logs, and configuration for a single execution workspace.
-type: domain-skill
-default_mode: confirm
----
-
-# Mastermind Workspace Detail
-
-This skill is invoked by `mastermind:workspace-detail` or directly via `/mastermind:workspace-detail`.
-
----
-
-## Inputs
-
-- `brain_context`: BRAIN CONTEXT block (injected by command, or loaded below if standalone)
-- `org_name`: org the workspace belongs to (required)
-- `workspace_id`: execution workspace id (required)
-- `action`: show | services | provision | teardown | cleanup | runtime-logs | issues | routines | config
-- `provision_command`: shell command to provision the workspace (for config action)
-- `teardown_command`: shell command to tear down the workspace (for config action)
-- `cleanup_command`: shell command for workspace cleanup (for config action)
-- `cwd`: working directory override (for config action)
-- `repo_url`: repository URL (for config action)
-- `base_ref`: git base ref/branch (for config action)
-- `branch_name`: branch name for the workspace (for config action)
-- `log_lines`: number of runtime log lines to show (default 50)
-- `caller`: command | master
-
----
-
-## Workspace Tabs (mirrors ExecutionWorkspaceDetail.tsx)
-
-| Tab | Description |
-|-----|-------------|
-| `services` | Running service processes in this workspace |
-| `configuration` | Provision/teardown/cleanup commands, repo, branch, cwd |
-| `runtime_logs` | Live or recent runtime logs from workspace processes |
-| `issues` | Issues currently assigned to or running in this workspace |
-| `routines` | Routines with workspace-specific variable bindings |
-
----
-
-## Step 0 — Brain Load (standalone only)
-
-If `caller` is not "command", load brain context following mastermind-protocol/SKILL.md Brain Load Procedure with namespace: `ops`.
-
----
-
-## Step 1 — Load Workspace Data
-
-```bash
-orgFile=".monomind/orgs/${org_name}.json"
-[ ! -f "$orgFile" ] && { echo "ERROR: Org '${org_name}' not found."; exit 1; }
-
-wsFile=".monomind/orgs/${org_name}-workspaces.json"
-[ ! -f "$wsFile" ] && { echo "ERROR: No workspaces file for org '$org_name'. Create workspaces via /mastermind:workspaces."; exit 1; }
-
-wsDef=$(jq -r --arg id "$workspace_id" '(.workspaces // [])[] | select(.id == $id)' "$wsFile")
-[ -z "$wsDef" ] && { echo "ERROR: Workspace '$workspace_id' not found in org '$org_name'."; exit 1; }
-
-issuesFile=".monomind/orgs/${org_name}-issues.json"
-routinesFile=".monomind/orgs/${org_name}-routines.json"
-logFile=".monomind/orgs/${org_name}-workspace-logs/${workspace_id}.log"
-```
-
----
-
-## Step 2 — Execute Action
-
-### show (default)
-
-```bash
-echo "EXECUTION WORKSPACE — $workspace_id @ $org_name"
-echo "────────────────────────────────────────────────────────"
-
-echo "$wsDef" | jq -r '
-  "  ID:              \(.id)",
-  "  Project:         \(.project_id // "(none)")",
-  "  Agent:           \(.agent_id // "(unassigned)")",
-  "  Status:          \(.status // "unknown")",
-  "  Branch:          \(.branch // "?")",
-  "  Base ref:        \(.base_ref // "?")",
-  "  Repo URL:        \(.repo_url // "(local)")",
-  "  CWD:             \(.cwd // .worktree_path // "(none)")",
-  "  Created:         \(.createdAt // "-")",
-  "  Last active:     \(.lastActiveAt // "-")"
-'
-
-# Services
-svcCount=$(echo "$wsDef" | jq -r '(.services // []) | length')
-echo ""
-echo "  Services running:  $svcCount"
-echo "$wsDef" | jq -r '(.services // [])[] | "    · \(.)"'
-
-# Config summary
-hasProvision=$(echo "$wsDef" | jq -r 'if .config.provisionCommand then "yes" else "no" end')
-hasTeardown=$(echo "$wsDef" | jq -r 'if .config.teardownCommand then "yes" else "no" end')
-echo ""
-echo "  Provision cmd:     $hasProvision"
-echo "  Teardown cmd:      $hasTeardown"
-```
-
-### services
-
-```bash
-echo "SERVICES — $workspace_id"
-echo "────────────────────────────────────────────────────────"
-
-services=$(echo "$wsDef" | jq -r '(.services // [])[]')
-if [ -z "$services" ]; then
-  echo "  No services running."
-else
-  echo "$wsDef" | jq -r '.services // [] | to_entries[] |
-    "  [\(.key)] \(.value)"' 2>/dev/null || \
-  echo "$wsDef" | jq -r '(.services // [])[] | "  · \(.)"'
-fi
-
-echo ""
-echo "  Workspace path: $(echo "$wsDef" | jq -r '.worktree_path // "(none)"')"
-echo "  Status:         $(echo "$wsDef" | jq -r '.status // "unknown"')"
-```
-
-### provision
-
-```bash
-echo "PROVISION — $workspace_id"
-echo "────────────────────────────────────────────────────────"
-
-provCmd=$(echo "$wsDef" | jq -r '.config.provisionCommand // ""')
-wsPath=$(echo "$wsDef" | jq -r '.worktree_path // .cwd // ""')
-
-if [ -z "$provCmd" ]; then
-  echo "  No provision command configured."
-  echo "  Set one: --action config --provision-command 'npm install && npm run build'"
-else
-  echo "  Command: $provCmd"
-  echo "  CWD:     $wsPath"
-  echo ""
-  echo "  To run: cd '$wsPath' && $provCmd"
-  echo ""
-  if [ -d "$wsPath" ] && [ -n "$provCmd" ]; then
-    echo "  Executing provision command…"
-    (cd "$wsPath" && eval "$provCmd") && {
-      ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
-      tmp="${wsFile}.tmp"
-      jq --arg id "$workspace_id" --arg ts "$ts" \
-        '.workspaces = [(.workspaces // [])[] | if .id == $id then .last_provisioned = $ts else . end]' \
-        "$wsFile" > "$tmp" && mv "$tmp" "$wsFile"
-      echo "  Provision complete."
-    } || echo "  Provision command exited with error."
-  else
-    [ -z "$wsPath" ] && echo "  ERROR: No worktree_path set — cannot execute provision command automatically."
-  fi
-fi
-```
-
-### teardown
-
-```bash
-echo "TEARDOWN — $workspace_id"
-echo "────────────────────────────────────────────────────────"
-
-tdCmd=$(echo "$wsDef" | jq -r '.config.teardownCommand // ""')
-wsPath=$(echo "$wsDef" | jq -r '.worktree_path // .cwd // ""')
-
-if [ -z "$tdCmd" ]; then
-  echo "  No teardown command configured."
-else
-  echo "  Command: $tdCmd"
-  echo "  CWD:     $wsPath"
-  if [ -d "$wsPath" ]; then
-    echo "  Executing teardown command…"
-    (cd "$wsPath" && eval "$tdCmd") && echo "  Teardown complete." || echo "  Teardown command exited with error."
-  fi
-fi
-```
-
-### cleanup
-
-```bash
-echo "CLEANUP — $workspace_id"
-echo "────────────────────────────────────────────────────────"
-
-cleanCmd=$(echo "$wsDef" | jq -r '.config.cleanupCommand // ""')
-wsPath=$(echo "$wsDef" | jq -r '.worktree_path // .cwd // ""')
-
-if [ -z "$cleanCmd" ]; then
-  echo "  No cleanup command configured."
-else
-  echo "  Command: $cleanCmd"
-  if [ -d "$wsPath" ]; then
-    (cd "$wsPath" && eval "$cleanCmd") && echo "  Cleanup complete." || echo "  Cleanup exited with error."
-  fi
-fi
-```
-
-### runtime-logs
-
-```bash
-lines=${log_lines:-50}
-echo "RUNTIME LOGS — $workspace_id (last $lines lines)"
-echo "────────────────────────────────────────────────────────"
-
-if [ -f "$logFile" ]; then
-  tail -${lines} "$logFile"
-else
-  # Try workspace path stderr/stdout logs
-  wsPath=$(echo "$wsDef" | jq -r '.worktree_path // ""')
-  found=false
-  for logPath in "${wsPath}/.monomind/runtime.log" "${wsPath}/logs/runtime.log" "${wsPath}/output.log"; do
-    if [ -f "$logPath" ]; then
-      tail -${lines} "$logPath"
-      found=true
-      break
-    fi
-  done
-  "$found" || echo "  No runtime logs found. Logs are written to .monomind/workspace-logs/$workspace_id.log during runs."
-fi
-```
-
-### issues
-
-```bash
-echo "ISSUES — workspace: $workspace_id"
-echo "────────────────────────────────────────────────────────"
-printf "%-24s %-12s %-10s %s\n" "ID" "STATUS" "PRIORITY" "TITLE"
-echo "────────────────────────────────────────────────────────"
-
-if [ ! -f "$issuesFile" ]; then
-  echo "  No issues file found."
-else
-  jq -r --arg wid "$workspace_id" '(.issues // [])[] |
-    select(.workspace_id == $wid or (.assigned_workspace == $wid)) |
-    [.id, (.status // "open"), (.priority // "medium"), (.title // "(no title)")] | @tsv' \
-    "$issuesFile" | while IFS=$'\t' read -r id st pri title; do
-    printf "%-24s %-12s %-10s %s\n" "$id" "$st" "$pri" "$title"
-  done || echo "  No issues assigned to this workspace."
-fi
-```
-
-### routines
-
-```bash
-echo "ROUTINES — workspace: $workspace_id"
-echo "────────────────────────────────────────────────────────"
-
-if [ ! -f "$routinesFile" ]; then
-  echo "  No routines file found."
-else
-  # Show routines that have workspace-specific variable bindings
-  jq -r --arg wid "$workspace_id" \
-    '(.routines // [])[] | select((.variables // {}) | to_entries[] | .key | startswith("WS_") or contains("workspace")) |
-    "\(.id)  \(.name // "(no name)")  vars: \((.variables // {}) | keys | join(", "))"' \
-    "$routinesFile" 2>/dev/null || echo "  No routines with workspace-specific variables."
-fi
-
-echo ""
-echo "To run a routine with workspace vars: /mastermind:routine-detail --org $org_name --routine-id <id> --action variables"
-```
-
-### config
-
-```bash
-echo "WORKSPACE CONFIG — $workspace_id"
-echo "────────────────────────────────────────────────────────"
-
-if [ -n "$provision_command" ] || [ -n "$teardown_command" ] || [ -n "$cleanup_command" ] || \
-   [ -n "$cwd" ] || [ -n "$repo_url" ] || [ -n "$base_ref" ] || [ -n "$branch_name" ]; then
-
-  ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
-  tmp="${wsFile}.tmp"
-  jq --arg id "$workspace_id" \
-     --arg prov "${provision_command:-}" \
-     --arg td "${teardown_command:-}" \
-     --arg clean "${cleanup_command:-}" \
-     --arg cwd_ "${cwd:-}" \
-     --arg repo "${repo_url:-}" \
-     --arg base "${base_ref:-}" \
-     --arg branch "${branch_name:-}" \
-     --arg ts "$ts" \
-    '.workspaces = [(.workspaces // [])[] | if .id == $id then
-       if .config == null then .config = {} else . end |
-       (if $prov != "" then .config.provisionCommand = $prov else . end) |
-       (if $td != "" then .config.teardownCommand = $td else . end) |
-       (if $clean != "" then .config.cleanupCommand = $clean else . end) |
-       (if $cwd_ != "" then .cwd = $cwd_ else . end) |
-       (if $repo != "" then .repo_url = $repo else . end) |
-       (if $base != "" then .base_ref = $base else . end) |
-       (if $branch != "" then .branch = $branch else . end) |
-       .lastActiveAt = $ts
-     else . end]' \
-    "$wsFile" > "$tmp" && mv "$tmp" "$wsFile"
-  echo "Config updated for workspace '$workspace_id'."
-else
-  echo "$wsDef" | jq '{id, project_id, agent_id, status, branch, base_ref, repo_url, cwd, config}'
-fi
-```
-
----
-
-## Step 3 — Return Output
-
-```yaml
-domain: ops
-status: complete
-action: <action>
-org: <org_name>
-workspace_id: <workspace_id>
-workspace_status: <status>
-```
-
----
-
-## Step 4 — Brain Write (standalone only)
-
-If `caller` is not "command", follow mastermind-protocol/SKILL.md Brain Write Procedure for domain `ops`.