@monoes/monomindcli 1.9.17 → 1.10.0

package/.claude/skills/mastermind/plugins.md

@@ -0,0 +1,190 @@
+---
+name: mastermind-plugins
+description: Mastermind plugins — install, enable, disable, uninstall, and inspect plugins for an org. Plugins extend agent capabilities with workers, events, and custom tools. Supports npm packages and local paths.
+type: domain-skill
+default_mode: confirm
+---
+
+# Mastermind Plugins
+
+This skill is invoked by `mastermind:plugins` or directly via `/mastermind:plugins`.
+
+---
+
+## Inputs
+
+- `brain_context`: BRAIN CONTEXT block (injected by command, or loaded below if standalone)
+- `org_name`: org to manage plugins for (optional — uses global plugin registry if omitted)
+- `action`: list | install | uninstall | enable | disable | status | examples
+- `plugin_id`: plugin id or package name (required for uninstall/enable/disable/status)
+- `package_name`: npm package or local path (required for install)
+- `caller`: command | master
+
+---
+
+## Step 0 — Brain Load (standalone only)
+
+If `caller` is not "command", load brain context following _protocol.md Brain Load Procedure with namespace: `ops`.
+
+---
+
+## Step 1 — Load Plugin Registry
+
+```bash
+pluginsDir=".monomind/plugins"
+mkdir -p "$pluginsDir"
+registryFile="${pluginsDir}/registry.json"
+[ ! -f "$registryFile" ] && echo '{"plugins":[]}' > "$registryFile"
+
+# If org scoped, also check org-level plugin overrides
+if [ -n "$org_name" ]; then
+  orgPluginsFile=".monomind/orgs/${org_name}-plugins.json"
+  [ ! -f "$orgPluginsFile" ] && echo '{"plugins":[]}' > "$orgPluginsFile"
+fi
+```
+
+---
+
+## Step 2 — Execute Action
+
+### list (default)
+
+```bash
+echo "PLUGINS"
+echo "──────────────────────────────────────────────────────────"
+printf "%-28s %-12s %-10s %-10s %s\n" "ID / PACKAGE" "VERSION" "STATUS" "CATEGORY" "ERROR"
+echo "──────────────────────────────────────────────────────────"
+
+count=$(jq '.plugins | length' "$registryFile")
+if [ "$count" -eq 0 ]; then
+  echo "  No plugins installed. Use --action install --package-name <pkg> to add one."
+else
+  jq -r '.plugins[] |
+    [
+      (.id // .packageName // "unknown"),
+      (.version // "-"),
+      (.status // "unknown"),
+      (.category // "general"),
+      (if .lastError then (.lastError | split("\n")[0] | .[0:40]) else "-" end)
+    ] | @tsv' "$registryFile" | while IFS=$'\t' read -r id ver status cat err; do
+    statusColor=""
+    printf "%-28s %-12s %-10s %-10s %s\n" "$id" "$ver" "$status" "$cat" "$err"
+  done
+fi
+
+echo ""
+echo "Total: $count plugin(s)"
+[ -n "$org_name" ] && echo "Org overrides: $(jq '.plugins | length' "$orgPluginsFile" 2>/dev/null || echo 0)"
+```
+
+### examples
+
+Show example/available plugins from the monomind registry:
+
+```bash
+echo "AVAILABLE PLUGINS (monomind registry)"
+echo "──────────────────────────────────────"
+cat <<'EXAMPLES'
+  @monomind/plugin-sentry      — Error tracking and alerting
+  @monomind/plugin-github      — GitHub issue/PR sync
+  @monomind/plugin-slack       — Slack notifications and commands
+  @monomind/plugin-linear      — Linear issue sync
+  @monomind/plugin-datadog     — Metrics and monitoring
+  @monomind/plugin-vault       — HashiCorp Vault secrets integration
+  @monomind/plugin-webhook     — Generic inbound/outbound webhooks
+  @monomind/plugin-memory-ext  — Extended memory backend
+
+Install: /mastermind:plugins --action install --package-name @monomind/plugin-<name>
+EXAMPLES
+```
+
+### install
+
+```bash
+[ -z "$package_name" ] && { echo "ERROR: --package-name required."; exit 1; }
+
+isLocal=false
+[[ "$package_name" == /* || "$package_name" == "./"* ]] && isLocal=true
+
+# Generate a stable id
+pluginId=$(echo "$package_name" | sed 's|[/@]|_|g' | tr -cd 'a-z0-9_-')
+ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+
+tmp="${registryFile}.tmp"
+jq --arg id "$pluginId" \
+   --arg pkg "$package_name" \
+   --argjson local "$isLocal" \
+   --arg ts "$ts" \
+   '.plugins = [.plugins[] | select(.id != $id)] +
+    [{"id":$id,"packageName":$pkg,"isLocalPath":$local,
+      "status":"installed","version":"latest","category":"general",
+      "installedAt":$ts,"lastError":null}]' \
+  "$registryFile" > "$tmp" && mv "$tmp" "$registryFile"
+
+echo "Installed: $package_name (id: $pluginId)"
+echo "NOTE: Agents must be restarted to load the new plugin."
+```
+
+Emit `org:plugin:installed` event:
+
+```bash
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd)
+CTRL_URL=$(jq -r '.url // "http://localhost:4242"' "$REPO_ROOT/.monomind/control.json" 2>/dev/null || echo "http://localhost:4242")
+curl -s -X POST "${CTRL_URL}/api/mastermind/event" \
+  -H "Content-Type: application/json" \
+  -d "$(jq -cn --arg org "${org_name:-global}" --arg id "$pluginId" --arg pkg "$package_name" \
+    '{type:"org:plugin:installed",org:$org,plugin:$id,package:$pkg,ts:(now*1000|floor)}')" || true
+```
+
+### uninstall
+
+```bash
+[ -z "$plugin_id" ] && { echo "ERROR: --plugin-id required."; exit 1; }
+echo "Uninstalling plugin '$plugin_id'…"
+
+tmp="${registryFile}.tmp"
+jq --arg id "$plugin_id" '.plugins = [.plugins[] | select(.id != $id)]' \
+  "$registryFile" > "$tmp" && mv "$tmp" "$registryFile"
+echo "Uninstalled: $plugin_id"
+```
+
+### enable / disable
+
+```bash
+[ -z "$plugin_id" ] && { echo "ERROR: --plugin-id required."; exit 1; }
+newStatus=$([ "$action" = "enable" ] && echo "installed" || echo "disabled")
+
+tmp="${registryFile}.tmp"
+jq --arg id "$plugin_id" --arg s "$newStatus" \
+  '.plugins = [.plugins[] | if .id == $id then .status = $s else . end]' \
+  "$registryFile" > "$tmp" && mv "$tmp" "$registryFile"
+echo "Plugin '$plugin_id' → $newStatus"
+```
+
+### status
+
+Show detailed status for a specific plugin:
+
+```bash
+[ -z "$plugin_id" ] && { echo "ERROR: --plugin-id required."; exit 1; }
+jq --arg id "$plugin_id" '.plugins[] | select(.id == $id)' "$registryFile"
+```
+
+---
+
+## Step 3 — Return Output
+
+```yaml
+domain: ops
+status: complete
+action: <action>
+org: <org_name or global>
+plugin_id: <id if applicable>
+plugins_total: <N>
+```
+
+---
+
+## Step 4 — Brain Write (standalone only)
+
+If `caller` is not "command", follow _protocol.md Brain Write Procedure for domain `ops`.

package/.claude/skills/mastermind/profile.md

@@ -0,0 +1,187 @@
+---
+name: mastermind-profile
+description: Mastermind profile — view and edit the current operator profile (display name, preferences) and inspect any user's activity statistics, completion rate, and token usage. Merges ProfileSettings.tsx and UserProfile.tsx.
+type: domain-skill
+default_mode: confirm
+---
+
+# Mastermind Profile
+
+This skill is invoked by `mastermind:profile` or directly via `/mastermind:profile`.
+
+---
+
+## Inputs
+
+- `brain_context`: BRAIN CONTEXT block (injected by command, or loaded below if standalone)
+- `action`: show | edit | view-user | stats
+- `user_id`: user id to view (for view-user/stats; defaults to current operator)
+- `org_name`: org context for per-org stats (optional)
+- `display_name`: new display name (for edit)
+- `email`: new email (for edit)
+- `theme`: light | dark | system (for edit)
+- `caller`: command | master
+
+---
+
+## Step 0 — Brain Load (standalone only)
+
+If `caller` is not "command", load brain context following _protocol.md Brain Load Procedure with namespace: `ops`.
+
+---
+
+## Step 1 — Load Profile File
+
+```bash
+profileFile=".monomind/operator-profile.json"
+[ ! -f "$profileFile" ] && cat > "$profileFile" <<'EOF'
+{
+  "id": "local-operator",
+  "displayName": "Operator",
+  "email": "",
+  "theme": "system",
+  "avatarInitials": "OP",
+  "keyboardShortcutsEnabled": true,
+  "createdAt": null
+}
+EOF
+```
+
+---
+
+## Step 2 — Execute Action
+
+### show (default)
+
+```bash
+echo "OPERATOR PROFILE"
+echo "────────────────────────────────────────────────────────"
+jq -r '
+  "  ID:            \(.id // "local-operator")",
+  "  Display name:  \(.displayName // "(not set)")",
+  "  Email:         \(.email // "(not set)")",
+  "  Theme:         \(.theme // "system")",
+  "  Initials:      \(.avatarInitials // "OP")",
+  "  Shortcuts:     \(.keyboardShortcutsEnabled // true)",
+  "  Created:       \(.createdAt // "(local)")"
+' "$profileFile"
+
+echo ""
+echo "  To edit: --action edit --display-name 'New Name'"
+echo "  To view stats: --action stats"
+```
+
+### edit
+
+```bash
+if [ -z "$display_name" ] && [ -z "$email" ] && [ -z "$theme" ]; then
+  echo "ERROR: Provide at least one of: --display-name, --email, --theme (light|dark|system)"
+  exit 1
+fi
+
+case "${theme:-}" in
+  light|dark|system|"") : ;;
+  *) echo "ERROR: --theme must be light, dark, or system"; exit 1 ;;
+esac
+
+tmp="${profileFile}.tmp"
+jq \
+  --arg name "${display_name:-}" \
+  --arg email "${email:-}" \
+  --arg theme "${theme:-}" \
+  '(if $name != "" then .displayName = $name else . end) |
+   (if $email != "" then .email = $email else . end) |
+   (if $theme != "" then .theme = $theme else . end) |
+   (if $name != "" then .avatarInitials = ($name | split(" ") |
+     map(select(length > 0) | .[0:1] | ascii_upcase) | .[0:2] | join(""))
+   else . end)' \
+  "$profileFile" > "$tmp" && mv "$tmp" "$profileFile"
+
+echo "Profile updated."
+jq -r '"  displayName: \(.displayName)  email: \(.email)  theme: \(.theme)"' "$profileFile"
+```
+
+### view-user
+
+```bash
+targetId="${user_id:-local-operator}"
+echo "USER PROFILE — $targetId"
+echo "────────────────────────────────────────────────────────"
+
+# Try to find in instance access file
+accessFile=".monomind/instance-access.json"
+if [ -f "$accessFile" ]; then
+  userEntry=$(jq -r --arg id "$targetId" '.users[] | select(.id == $id)' "$accessFile")
+  if [ -n "$userEntry" ]; then
+    isAdmin=$(echo "$userEntry" | jq -r '.isInstanceAdmin // false')
+    orgs=$(echo "$userEntry" | jq -r '(.companyAccess // []) | join(", ")')
+    echo "  ID:              $targetId"
+    echo "  Instance admin:  $isAdmin"
+    echo "  Org access:      ${orgs:-(none)}"
+  else
+    echo "  ID: $targetId"
+    echo "  (User not found in instance access registry)"
+  fi
+else
+  echo "  ID: $targetId  (no instance access file)"
+fi
+
+echo ""
+echo "  For activity stats: --action stats --user-id $targetId"
+```
+
+### stats
+
+```bash
+targetId="${user_id:-local-operator}"
+echo "ACTIVITY STATS — $targetId"
+echo "────────────────────────────────────────────────────────"
+
+# Scan activity files for user contributions
+totalRuns=0; successRuns=0; totalInputTokens=0; totalOutputTokens=0
+
+for actFile in data/mastermind-sessions.json .monomind/orgs/*-activity.jsonl; do
+  [ -f "$actFile" ] || continue
+  if echo "$actFile" | grep -q "\.jsonl$"; then
+    cnt=$(grep -c "\"actorId\":\"${targetId}\"" "$actFile" 2>/dev/null || echo 0)
+    succ=$(grep "\"actorId\":\"${targetId}\"" "$actFile" 2>/dev/null | grep -c '"outcome":"success"' || echo 0)
+    totalRuns=$((totalRuns + cnt))
+    successRuns=$((successRuns + succ))
+  fi
+done
+
+# Per-org if org_name set
+if [ -n "$org_name" ]; then
+  issuesFile=".monomind/orgs/${org_name}-issues.json"
+  if [ -f "$issuesFile" ]; then
+    assigned=$(jq --arg uid "$targetId" '[.issues[] | select(.assigneeId == $uid)] | length' "$issuesFile")
+    echo "  Issues assigned (org $org_name): $assigned"
+  fi
+fi
+
+completionRate=0
+[ "$totalRuns" -gt 0 ] && completionRate=$((successRuns * 100 / totalRuns))
+
+echo "  Total runs tracked:   $totalRuns"
+echo "  Successful runs:      $successRuns"
+echo "  Completion rate:      ${completionRate}%"
+echo ""
+echo "  (Token usage stats require agent run logs with token tracking enabled)"
+```
+
+---
+
+## Step 3 — Return Output
+
+```yaml
+domain: ops
+status: complete
+action: <action>
+user_id: <user_id or local-operator>
+```
+
+---
+
+## Step 4 — Brain Write (standalone only)
+
+If `caller` is not "command", follow _protocol.md Brain Write Procedure for domain `ops`.

package/.claude/skills/mastermind/project-detail.md

@@ -0,0 +1,249 @@
+---
+name: mastermind-project-detail
+description: Mastermind project-detail — deep per-project inspection and management. Tabs mirror Paperclip's ProjectDetail page: overview (metrics/issues), configuration (color/visibility/description), budget policy, workspaces, and linked issues list.
+type: domain-skill
+default_mode: auto
+---
+
+# Mastermind Project Detail
+
+This skill is invoked by `mastermind:project-detail` or directly via `/mastermind:project-detail`.
+
+---
+
+## Inputs
+
+- `brain_context`: BRAIN CONTEXT block (injected by command, or loaded below if standalone)
+- `org_name`: org the project belongs to (required)
+- `project_id`: project id/slug (required)
+- `action`: show | overview | issues | config | budget | workspaces
+- `field`: config field to edit (name|description|color|visibility)
+- `value`: new field value (for config --field)
+- `budget_policy`: none | soft_limit | hard_limit (for budget action)
+- `budget_limit`: token limit (integer, required if policy != none)
+- `budget_period`: daily | weekly | monthly (default: daily)
+- `caller`: command | master
+
+---
+
+## Project Colors
+
+`red` | `orange` | `yellow` | `green` | `teal` | `blue` | `purple` | `pink` | `gray`
+
+## Visibility
+
+`private` — visible only to org members with access
+`internal` — visible to all org members
+`public` — visible to anyone with the link
+
+---
+
+## Step 0 — Brain Load (standalone only)
+
+If `caller` is not "command", load brain context following _protocol.md Brain Load Procedure with namespace: `ops`.
+
+---
+
+## Step 1 — Load Project Data
+
+```bash
+orgFile=".monomind/orgs/${org_name}.json"
+[ ! -f "$orgFile" ] && { echo "ERROR: Org '${org_name}' not found."; exit 1; }
+
+projectsFile=".monomind/orgs/${org_name}-projects.json"
+[ ! -f "$projectsFile" ] && { echo "ERROR: No projects file for org '$org_name'. Create via /mastermind:projects."; exit 1; }
+
+projectDef=$(jq -r --arg id "$project_id" '.projects[] | select(.id == $id or .slug == $id)' "$projectsFile")
+[ -z "$projectDef" ] && { echo "ERROR: Project '$project_id' not found in org '$org_name'."; exit 1; }
+
+resolvedId=$(echo "$projectDef" | jq -r '.id')
+issuesFile=".monomind/orgs/${org_name}-issues.json"
+wsFile=".monomind/orgs/${org_name}-workspaces.json"
+budgetFile=".monomind/orgs/${org_name}-budgets.json"
+```
+
+---
+
+## Step 2 — Execute Action
+
+### show (default) — same as overview
+
+```bash
+echo "PROJECT — $project_id @ $org_name"
+echo "────────────────────────────────────────────────────────"
+
+echo "$projectDef" | jq -r '
+  "  ID:           \(.id)",
+  "  Name:         \(.name // "(unnamed)")",
+  "  Status:       \(.status // "active")",
+  "  Color:        \(.color // "gray")",
+  "  Visibility:   \(.visibility // "internal")",
+  "  Description:  \(.description // "(none)")",
+  "  Created:      \(.created_at // "-")"
+'
+
+# Issues summary
+if [ -f "$issuesFile" ]; then
+  totalIssues=$(jq --arg pid "$resolvedId" '[.issues[] | select(.project_id == $pid)] | length' "$issuesFile")
+  openIssues=$(jq --arg pid "$resolvedId" '[.issues[] | select(.project_id == $pid and .status == "open")] | length' "$issuesFile")
+  inProgIssues=$(jq --arg pid "$resolvedId" '[.issues[] | select(.project_id == $pid and .status == "in_progress")] | length' "$issuesFile")
+  doneIssues=$(jq --arg pid "$resolvedId" '[.issues[] | select(.project_id == $pid and .status == "done")] | length' "$issuesFile")
+  echo ""
+  echo "ISSUES"
+  echo "  Total:       $totalIssues"
+  echo "  Open:        $openIssues"
+  echo "  In progress: $inProgIssues"
+  echo "  Done:        $doneIssues"
+fi
+
+# Workspaces summary
+if [ -f "$wsFile" ]; then
+  wsCount=$(jq --arg pid "$resolvedId" '[.workspaces[] | select(.project_id == $pid)] | length' "$wsFile")
+  activeWs=$(jq --arg pid "$resolvedId" '[.workspaces[] | select(.project_id == $pid and .status == "active")] | length' "$wsFile")
+  echo ""
+  echo "WORKSPACES"
+  echo "  Total:  $wsCount  |  Active: $activeWs"
+fi
+```
+
+### overview
+
+Alias for `show` — print the overview section above.
+
+### issues
+
+```bash
+echo "ISSUES — project: $project_id"
+echo "────────────────────────────────────────────────────────"
+printf "%-24s %-12s %-10s %s\n" "ID" "STATUS" "PRIORITY" "TITLE"
+echo "────────────────────────────────────────────────────────"
+
+if [ ! -f "$issuesFile" ]; then
+  echo "  No issues file found."
+else
+  count=0
+  jq -r --arg pid "$resolvedId" '.issues[] | select(.project_id == $pid) |
+    [.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"
+    count=$((count + 1))
+  done
+fi
+```
+
+### config
+
+```bash
+echo "PROJECT CONFIG — $project_id"
+echo "────────────────────────────────────────────────────────"
+
+if [ -n "$field" ]; then
+  [ -z "$value" ] && { echo "ERROR: --value required when --field is set."; exit 1; }
+  validFields="name description color visibility status"
+  echo "$validFields" | tr ' ' '\n' | grep -qx "$field" || {
+    echo "ERROR: Unknown field '$field'. Valid: $validFields"; exit 1
+  }
+  if [ "$field" = "color" ]; then
+    case "$value" in red|orange|yellow|green|teal|blue|purple|pink|gray) : ;; *)
+      echo "ERROR: color must be one of: red orange yellow green teal blue purple pink gray"; exit 1 ;;
+    esac
+  fi
+  if [ "$field" = "visibility" ]; then
+    case "$value" in private|internal|public) : ;; *)
+      echo "ERROR: visibility must be one of: private, internal, public"; exit 1 ;;
+    esac
+  fi
+  ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+  tmp="${projectsFile}.tmp"
+  jq --arg id "$resolvedId" --arg f "$field" --arg v "$value" --arg ts "$ts" \
+    '.projects = [.projects[] | if .id == $id then .[$f] = $v | .updated_at = $ts else . end]' \
+    "$projectsFile" > "$tmp" && mv "$tmp" "$projectsFile"
+  echo "Updated: $field = $value"
+else
+  echo "$projectDef" | jq '{name, description, color, visibility, status}'
+fi
+```
+
+### budget
+
+```bash
+echo "BUDGET POLICY — $project_id"
+echo "────────────────────────────────────────────────────────"
+
+[ ! -f "$budgetFile" ] && echo '{"budgets":[]}' > "$budgetFile"
+
+existing=$(jq -r --arg pid "$resolvedId" '.budgets[] | select(.project_id == $pid)' "$budgetFile")
+if [ -z "$existing" ]; then
+  echo "  No budget policy set."
+else
+  echo "$existing" | jq -r '
+    "  Policy:  \(.policy // "none")",
+    "  Limit:   \(.limit_tokens // "unlimited") tokens",
+    "  Period:  \(.period // "daily")"
+  '
+fi
+
+if [ -n "$budget_policy" ]; then
+  case "$budget_policy" in none|soft_limit|hard_limit) : ;; *)
+    echo "ERROR: --budget-policy must be none, soft_limit, or hard_limit"; exit 1 ;;
+  esac
+  [ "$budget_policy" != "none" ] && [ -z "$budget_limit" ] && {
+    echo "ERROR: --budget-limit required for '$budget_policy' policy."; exit 1
+  }
+  ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+  tmp="${budgetFile}.tmp"
+  jq --arg pid "$resolvedId" \
+     --arg policy "$budget_policy" \
+     --argjson limit "${budget_limit:-0}" \
+     --arg period "${budget_period:-daily}" \
+     --arg ts "$ts" \
+    '.budgets = [.budgets[] | select(.project_id != $pid)] +
+     [{"project_id":$pid,"policy":$policy,
+       "limit_tokens":(if $policy != "none" then $limit else null end),
+       "period":$period,"updatedAt":$ts}]' \
+    "$budgetFile" > "$tmp" && mv "$tmp" "$budgetFile"
+  echo ""
+  echo "Budget policy updated: $budget_policy"
+  [ "$budget_policy" != "none" ] && echo "  Limit: $budget_limit tokens / ${budget_period:-daily}"
+fi
+```
+
+### workspaces
+
+```bash
+echo "WORKSPACES — project: $project_id"
+echo "────────────────────────────────────────────────────────"
+
+if [ ! -f "$wsFile" ]; then
+  echo "  No workspaces file."
+else
+  printf "%-20s %-12s %-18s %-8s %s\n" "ID" "STATUS" "AGENT" "BRANCH" "PATH"
+  echo "────────────────────────────────────────────────────────"
+  count=0
+  jq -r --arg pid "$resolvedId" '.workspaces[] | select(.project_id == $pid) |
+    [.id, (.status // "unknown"), (.agent_id // "(none)"), (.branch // "?"), (.worktree_path // "-")] | @tsv' \
+    "$wsFile" | while IFS=$'\t' read -r id st ag br path; do
+    printf "%-20s %-12s %-18s %-8s %s\n" "$id" "$st" "$ag" "$br" "$path"
+    count=$((count + 1))
+  done
+fi
+```
+
+---
+
+## Step 3 — Return Output
+
+```yaml
+domain: ops
+status: complete
+action: <action>
+org: <org_name>
+project_id: <project_id>
+project_status: <status>
+```
+
+---
+
+## Step 4 — Brain Write (standalone only)
+
+If `caller` is not "command", follow _protocol.md Brain Write Procedure for domain `ops`.