monomind 1.16.6 → 1.16.8

package/packages/@monomind/cli/.claude/skills/mastermind/monotask.md

@@ -0,0 +1,350 @@
+---
+name: mastermind-monotask
+description: Authoritative monotask CLI reference for mastermind agents — boards, columns, cards (with filters, subtasks, prerequisites, scoring, attachments), spaces, GitHub/Linear sync, and common agent workflows. Version 1.1.4.
+type: reference-skill
+---
+
+# Monotask CLI — Agent Reference (v1.1.4)
+
+Monotask is a P2P local-first task manager. All data is stored in SQLite (`~/.local/share/monotask/monotask.db`). Always use `--json` for machine-readable output.
+
+---
+
+## Global Flags
+
+```
+--data-dir <PATH>   Override storage directory (must be consistent per instance)
+```
+
+---
+
+## Board
+
+```bash
+# Create — returns {id, title, deep_link}
+monotask board create "Sprint 42" --json
+
+# List — returns [{id, title}] (search by title with jq .title)
+monotask board list --json
+
+# Rename
+monotask board rename <BOARD_ID> "New Title" --json
+```
+
+---
+
+## Column
+
+```bash
+# Create — returns {id, board_id}
+monotask column create <BOARD_ID> "Todo" --json
+
+# List — returns [{id, title, card_ids:[]}]  ← field is "title", NOT "name"
+monotask column list <BOARD_ID> --json
+
+# Rename
+monotask column rename <BOARD_ID> <COL_ID> "New Title" --json
+
+# Delete (soft-deletes all cards in it)
+monotask column delete <BOARD_ID> <COL_ID> --json
+```
+
+---
+
+## Card
+
+### Listing
+
+```bash
+# All cards in board (flat, includes col_id + col_title per card)
+monotask card list <BOARD_ID> --json
+
+# Filter by column (server-side, fast)
+monotask card list <BOARD_ID> --col <COL_ID> --json
+
+# Filter by label (server-side, exact match)
+monotask card list <BOARD_ID> --label "role:writer" --json
+
+# Combine filters
+monotask card list <BOARD_ID> --col <TODO_COL> --label "role:reviewer" --json
+```
+
+JSON schema per item from `card list`:
+```json
+{ "id":"<uuid>", "title":"<str>", "col_id":"<uuid>", "col_title":"<str>",
+  "labels":[], "due_date":null, "impact":null, "effort":null, "direct_priority":null }
+```
+
+### Create / View / Move
+
+```bash
+# Create — returns {id, title, board_id, number}
+CARD=$(monotask card create <BOARD_ID> <COL_ID> "Task title" --json | jq -r .id)
+
+# View full card (includes parent + subtasks)
+monotask card view <BOARD_ID> <CARD_ID> --json
+
+# Move to different column (auto-detects current column)
+monotask card move <BOARD_ID> <CARD_ID> <TO_COL_ID> --json
+
+# Copy to another column (same board)
+monotask card copy <BOARD_ID> <CARD_ID> <TARGET_COL_ID> --json
+
+# Rename
+monotask card rename <BOARD_ID> <CARD_ID> "New title" --json
+
+# Soft-delete (hidden from all views)
+monotask card delete <BOARD_ID> <CARD_ID> --json
+
+# Soft-archive (hidden from normal views)
+monotask card archive <BOARD_ID> <CARD_ID> --json
+```
+
+### Metadata
+
+```bash
+monotask card set-description <BOARD_ID> <CARD_ID> "Markdown text" --json
+monotask card set-due-date    <BOARD_ID> <CARD_ID> "2026-06-01" --json  # "none" to clear
+monotask card set-cover       <BOARD_ID> <CARD_ID> "#e74c3c" --json     # "none" to clear
+```
+
+### Priority / Scoring
+
+```bash
+# ICE scoring: priority = floor((impact + 10 - effort) / 2), range 0–10
+monotask card set-impact  <BOARD_ID> <CARD_ID> 8 --json
+monotask card set-effort  <BOARD_ID> <CARD_ID> 3 --json
+
+# Direct priority (bypasses impact/effort)
+monotask card set-direct-priority <BOARD_ID> <CARD_ID> 9 --json
+monotask card set-direct-priority <BOARD_ID> <CARD_ID> --clear --json
+
+# Clear all scoring
+monotask card clear-priority <BOARD_ID> <CARD_ID> --json
+```
+
+### Labels
+
+```bash
+monotask card label add    <BOARD_ID> <CARD_ID> "role:writer" --json
+monotask card label remove <BOARD_ID> <CARD_ID> "role:writer" --json
+monotask card label list   <BOARD_ID> <CARD_ID> --json  # → ["str",...]
+```
+
+**Convention for org agents:**
+- `role:<role_id>` — which role should handle this card
+- `claimed` — card has been picked up by an agent (in Doing column)
+
+### Assignee
+
+```bash
+# PUBKEY = 64-char hex (get via: monotask profile show)
+monotask card set-assignee <BOARD_ID> <CARD_ID> <PUBKEY> --json
+monotask card set-assignee <BOARD_ID> <CARD_ID> none --json  # clear
+```
+
+### Comments
+
+```bash
+monotask card comment add    <BOARD_ID> <CARD_ID> "text" --json
+monotask card comment list   <BOARD_ID> <CARD_ID> --json
+monotask card comment delete <BOARD_ID> <CARD_ID> <COMMENT_ID> --json
+```
+
+### Subtasks (parent/child hierarchy)
+
+```bash
+# Create a subtask (new card linked as child of PARENT_CARD)
+monotask card subtask add <PARENT_BOARD> <PARENT_CARD> <CHILD_BOARD> <COL_ID> "Subtask title" --json
+# → returns {id, title, board_id}
+
+# List subtasks of a card
+monotask card subtask list <BOARD_ID> <CARD_ID> --json
+# → [{board_id, card_id},...]
+
+# card view includes "subtasks" and "parent" fields automatically
+```
+
+### Prerequisites (dependency ordering)
+
+```bash
+# PREREQ_CARD must be Done before CARD can be claimed
+monotask card prerequisite add    <BOARD_ID> <CARD_ID> <PREREQ_BOARD> <PREREQ_CARD_ID> --json
+monotask card prerequisite list   <BOARD_ID> <CARD_ID> --json  # → [{board_id, card_id},...]
+monotask card prerequisite remove <BOARD_ID> <CARD_ID> <PREREQ_BOARD> <PREREQ_CARD_ID> --json
+```
+
+### Attachments
+
+```bash
+# Attach image (stored as base64; returns img:<6char-id> token for markdown)
+ATT=$(monotask card attach-image <BOARD_ID> <CARD_ID> screenshot.png --json | jq -r .token)
+monotask card set-description <BOARD_ID> <CARD_ID> "See: ![$ATT]($ATT)"
+
+monotask card list-attachments <BOARD_ID> <CARD_ID> --json
+monotask card save-attachment  <BOARD_ID> <CARD_ID> <ATTACHMENT_ID> --output ./out.png
+```
+
+### Checklists
+
+```bash
+CL=$(monotask checklist add      <BOARD_ID> <CARD_ID> "Definition of Done" --json | jq -r .id)
+ITEM=$(monotask checklist item-add   <BOARD_ID> <CARD_ID> $CL "Write tests" --json | jq -r .id)
+monotask checklist item-check   <BOARD_ID> <CARD_ID> $CL $ITEM
+monotask checklist item-uncheck <BOARD_ID> <CARD_ID> $CL $ITEM
+```
+
+---
+
+## Space (Collaboration)
+
+```bash
+# Create / list
+monotask space create "Team Name"
+monotask space list   # → "<id> | <name> | <N> members"
+monotask space info <SPACE_ID>
+
+# Associate boards
+monotask space boards add    <SPACE_ID> <BOARD_ID>
+monotask space boards remove <SPACE_ID> <BOARD_ID>
+monotask space boards list   <SPACE_ID>
+
+# Invite / join
+monotask space invite export  <SPACE_ID> invite.space  # preferred (includes space doc)
+monotask space invite generate <SPACE_ID>               # token only
+monotask space invite revoke   <SPACE_ID>
+monotask space join invite.space                        # or raw token
+
+# Members
+monotask space members list <SPACE_ID>
+monotask space members kick <SPACE_ID> <PUBKEY>
+```
+
+---
+
+## GitHub Integration
+
+```bash
+monotask github connect ghp_yourtoken           # save token
+monotask github repos                           # list accessible repos
+monotask github link <BOARD_ID> <ORG> <REPO> --done-col <COL_ID>  # link repo
+monotask github unlink <BOARD_ID>
+monotask github sync <BOARD_ID>                 # bidirectional sync
+```
+
+---
+
+## Linear Integration
+
+```bash
+monotask linear connect lin_api_yourkey         # save key
+monotask linear status
+monotask linear teams                           # list teams
+monotask linear projects <TEAM_ID>
+monotask linear link <BOARD_ID> --team <TEAM_ID> --project <PROJECT_ID> [--done-col <COL_ID>]
+monotask linear unlink <BOARD_ID>
+monotask linear sync <BOARD_ID>                 # bidirectional sync
+```
+
+---
+
+## P2P Sync Daemon
+
+```bash
+monotask sync --detach --port 7272              # start background daemon
+monotask sync --status
+monotask sync --stop
+monotask sync --peer /ip4/192.168.1.10/tcp/7272 # connect to known peer
+```
+
+---
+
+## Profile
+
+```bash
+monotask profile show
+monotask profile set-name "Alice"
+monotask profile set-avatar ~/avatar.png
+monotask profile import-ssh-key ~/.ssh/id_ed25519  # changes pubkey — run before joining spaces
+```
+
+---
+
+## Common Agent Workflows
+
+### Set up an org task board
+```bash
+BOARD=$(monotask board create "org-tasks" --json | jq -r .id)
+TODO=$(monotask column create $BOARD "Todo"  --json | jq -r .id)
+DOING=$(monotask column create $BOARD "Doing" --json | jq -r .id)
+DONE=$(monotask column create $BOARD "Done"  --json | jq -r .id)
+```
+
+### Task assignment loop (boss agent pattern)
+```bash
+# List unclaimed Todo cards
+monotask card list $BOARD --col $TODO --json | jq '[.[] | select(.labels | index("claimed") | not)]'
+
+# Claim a card for a role agent
+monotask card move $BOARD $CARD_ID $DOING
+monotask card label add $BOARD $CARD_ID "claimed"
+
+# Complete a card
+monotask card move $BOARD $CARD_ID $DONE
+
+# Find all cards for a specific role across all columns
+monotask card list $BOARD --label "role:writer" --json
+```
+
+### Check prerequisites before claiming
+```bash
+# Get prereqs of a card
+PREREQS=$(monotask card prerequisite list $BOARD $CARD_ID --json)
+# Check all prereqs are in Done column
+echo "$PREREQS" | jq -r '.[].card_id' | while read PREREQ_ID; do
+  COL=$(monotask card list $BOARD --json | jq -r --arg id "$PREREQ_ID" '.[] | select(.id==$id) | .col_id')
+  [ "$COL" != "$DONE" ] && echo "BLOCKED: $PREREQ_ID not done" && exit 1
+done
+```
+
+### Find board by title
+```bash
+BOARD_ID=$(monotask board list --json | jq -r '.[] | select(.title=="org-tasks") | .id')
+```
+
+### Find column by title  (field is "title", NOT "name")
+```bash
+COLS=$(monotask column list $BOARD --json)
+TODO=$(echo "$COLS" | jq -r '.[] | select(.title=="Todo") | .id')
+DONE=$(echo "$COLS" | jq -r '.[] | select(.title=="Done") | .id')
+```
+
+---
+
+## ID Formats
+
+| Type | Format |
+|---|---|
+| Board / Column / Card / Space / Comment / Checklist | UUID v4 |
+| Attachment | 6-char hex (reference as `img:<id>` in markdown) |
+| Card number | `<prefix>-<seq>` — human display only; CLI requires full UUID |
+
+## HLC Timestamps
+
+All `created_at` fields use Hybrid Logical Clock format `<wall_ms_hex>-<logical_hex>`.
+
+```js
+ms = parseInt(hlc.split('-')[0], 16)     // → Unix ms
+new Date(ms).toISOString()               // → ISO date
+```
+
+## Error Handling
+
+All commands exit 0 on success, non-zero on error. Errors go to stderr (never mixed into `--json` stdout). Common causes: ID not found, invalid UUID, corrupted board file, invalid invite token.
+
+## Key Limitations
+
+- CLI operates on **local data only** — P2P sync requires the desktop app or `sync --detach`
+- `card create` uses placeholder prefix `"aaaa"` for card numbers (full identity wiring planned)
+- No `board delete` command — orphaned boards must be removed via SQLite directly
+- `card move` auto-detects current column — no need to specify source column

package/packages/@monomind/cli/.claude/skills/mastermind/my-issues.md

@@ -0,0 +1,146 @@
+---
+name: mastermind-my-issues
+description: Mastermind my-issues — filtered issue queue scoped to the current operator or a specific assignee. Lists open and in-progress issues, supports self-assign and unassign. Mirrors MyIssues.tsx.
+type: domain-skill
+default_mode: auto
+---
+
+# Mastermind My Issues
+
+This skill is invoked by `mastermind:my-issues` or directly via `/mastermind:my-issues`.
+
+---
+
+## Inputs
+
+- `brain_context`: BRAIN CONTEXT block (injected by command, or loaded below if standalone)
+- `org_name`: org to query issues from (required)
+- `action`: list | assign-self | unassign | close
+- `assignee_id`: user/agent id to filter by (default: local-operator)
+- `issue_id`: issue id (required for assign-self / unassign / close)
+- `status_filter`: open | in_progress | all (default: open+in_progress)
+- `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 Issues
+
+```bash
+orgFile=".monomind/orgs/${org_name}.json"
+[ ! -f "$orgFile" ] && { echo "ERROR: Org '${org_name}' not found."; exit 1; }
+
+issuesFile=".monomind/orgs/${org_name}-issues.json"
+[ ! -f "$issuesFile" ] && { echo "No issues found for org '${org_name}'."; exit 0; }
+
+assigneeFilter="${assignee_id:-local-operator}"
+```
+
+---
+
+## Step 2 — Execute Action
+
+### list (default)
+
+```bash
+statusFilter="${status_filter:-active}"
+echo "MY ISSUES — org: $org_name  assignee: $assigneeFilter"
+echo "────────────────────────────────────────────────────────"
+printf "%-24s %-12s %-10s %s\n" "ID" "STATUS" "PRIORITY" "TITLE"
+echo "────────────────────────────────────────────────────────"
+
+jq -r --arg uid "$assigneeFilter" --arg sf "$statusFilter" '
+  (.issues // [])[] |
+  select(
+    (.assigneeId == $uid or .assigned_to == $uid) and
+    (if $sf == "active" then (.status == "open" or .status == "in_progress")
+     elif $sf == "all" then true
+     else .status == $sf
+     end)
+  ) |
+  [.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
+
+total=$(jq -r --arg uid "$assigneeFilter" \
+  '[(.issues // [])[] | select(.assigneeId == $uid or .assigned_to == $uid)] | length' \
+  "$issuesFile")
+echo ""
+echo "Total assigned: $total"
+[ "$total" -eq 0 ] && echo "  No issues assigned to '$assigneeFilter'. To assign: --action assign-self --issue-id <id>"
+```
+
+### assign-self
+
+```bash
+[ -z "$issue_id" ] && { echo "ERROR: --issue-id required."; exit 1; }
+
+exists=$(jq -r --arg id "$issue_id" '[(.issues // [])[] | select(.id == $id)] | length' "$issuesFile")
+[ "$exists" -eq 0 ] && { echo "ERROR: Issue '$issue_id' not found."; exit 1; }
+
+ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+tmp="${issuesFile}.tmp"
+jq --arg id "$issue_id" --arg uid "$assigneeFilter" --arg ts "$ts" \
+  '.issues = [(.issues // [])[] | if .id == $id then
+     .assigneeId = $uid | .lastActivityAt = $ts
+   else . end]' \
+  "$issuesFile" > "$tmp" && mv "$tmp" "$issuesFile"
+
+echo "Issue '$issue_id' assigned to '$assigneeFilter'."
+```
+
+### unassign
+
+```bash
+[ -z "$issue_id" ] && { echo "ERROR: --issue-id required."; exit 1; }
+
+ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+tmp="${issuesFile}.tmp"
+jq --arg id "$issue_id" --arg ts "$ts" \
+  '.issues = [(.issues // [])[] | if .id == $id then
+     .assigneeId = null | .lastActivityAt = $ts
+   else . end]' \
+  "$issuesFile" > "$tmp" && mv "$tmp" "$issuesFile"
+
+echo "Issue '$issue_id' unassigned."
+```
+
+### close
+
+```bash
+[ -z "$issue_id" ] && { echo "ERROR: --issue-id required."; exit 1; }
+
+ts=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+tmp="${issuesFile}.tmp"
+jq --arg id "$issue_id" --arg ts "$ts" \
+  '.issues = [(.issues // [])[] | if .id == $id then
+     .status = "done" | .closedAt = $ts | .lastActivityAt = $ts
+   else . end]' \
+  "$issuesFile" > "$tmp" && mv "$tmp" "$issuesFile"
+
+echo "Issue '$issue_id' closed (status: done)."
+```
+
+---
+
+## Step 3 — Return Output
+
+```yaml
+domain: ops
+status: complete
+action: <action>
+org: <org_name>
+assignee: <assignee_id>
+```
+
+---
+
+## Step 4 — Brain Write (standalone only)
+
+If `caller` is not "command", follow _protocol.md Brain Write Procedure for domain `ops`.