monomind 1.10.0 → 1.10.1

package/.claude/commands/monomind/memory.md

@@ -1,230 +0,0 @@
----
-name: monomind-memory
-description: AgentDB memory system — store, search, retrieve, list, delete, and manage cross-session persistent memory with vector embeddings
----
-
-# Monomind Memory System
-
-Persistent memory backed by AgentDB with HNSW vector indexing for semantic search (150x-12,500x faster than brute-force). Supports cross-session and cross-agent collaboration.
-
-## Subcommands
-
-| Subcommand | Alias | Description |
-|---|---|---|
-| `init` | — | Initialize memory database (sql.js + AgentDB) |
-| `store` | — | Store a key/value entry |
-| `edit` | — | Edit an existing entry |
-| `retrieve` | `get` | Retrieve entry by key |
-| `search` | — | Semantic/vector search |
-| `list` | `ls` | List memory entries |
-| `delete` | `rm` | Delete an entry |
-| `templates` | — | Show best-practice entry templates |
-| `stats` | — | Show memory statistics |
-| `configure` | `config` | Configure memory backend |
-| `cleanup` | — | Clean expired/stale entries |
-| `compress` | — | Compress and optimize storage |
-| `export` | — | Export memory to file |
-| `import` | — | Import memory from file |
-
-## init — Initialize Database
-
-```bash
-npx monomind memory init
-npx monomind memory init --backend agentdb --verbose --verify
-npx monomind memory init --force  # Overwrite existing
-```
-
-**Flags:** `--backend hybrid|sqlite|agentdb` (default: `hybrid`), `--path`, `--force`, `--verbose`, `--verify` (default: true), `--load-embeddings`
-
-## store — Store Data
-
-```bash
-# Store with specific namespace
-npx monomind memory store --key "arch/api-design" --value "RESTful microservices" --namespace arch
-
-# With tags and TTL
-npx monomind memory store --key "pattern/auth" --value "JWT + refresh tokens" --namespace patterns --tags "auth,security" --ttl 86400
-
-# Upsert (update if exists)
-npx monomind memory store --key "bug/null-check" --value "Fixed null check in parser" --upsert
-```
-
-**Flags:**
-
-| Flag | Short | Default | Description |
-|---|---|---|---|
-| `--key` | `-k` | — | Storage key (required) |
-| `--value` | — | — | Value to store (required) |
-| `--namespace` | `-n` | `default` | Memory namespace |
-| `--ttl` | — | — | Time to live in seconds |
-| `--tags` | — | — | Comma-separated tags |
-| `--vector` | — | `false` | Store as vector embedding |
-| `--upsert` | `-u` | `false` | Update if key exists |
-
-## search — Semantic Search
-
-```bash
-# Semantic search (default)
-npx monomind memory search --query "authentication patterns"
-
-# Keyword search
-npx monomind memory search --query "JWT" --type keyword
-
-# Hybrid search with namespace filter
-npx monomind memory search --query "error handling" --namespace patterns --limit 5
-
-# Build HNSW index first for max speed
-npx monomind memory search --query "API design" --build-hnsw
-```
-
-**Flags:**
-
-| Flag | Short | Default | Description |
-|---|---|---|---|
-| `--query` | `-q` | — | Search query (required) |
-| `--namespace` | `-n` | all | Filter by namespace |
-| `--limit` | `-l` | `10` | Maximum results |
-| `--threshold` | — | `0.7` | Similarity threshold (0-1) |
-| `--type` | `-t` | `semantic` | `semantic`, `keyword`, `hybrid` |
-| `--build-hnsw` | — | `false` | Rebuild HNSW index before search |
-
-## retrieve — Get by Key
-
-```bash
-npx monomind memory retrieve --key "arch/api-design"
-npx monomind memory retrieve --key "pattern/auth" --namespace patterns
-```
-
-**Flags:** `--key/-k` (required), `--namespace/-n` (default: `default`)
-
-## list — Browse Entries
-
-```bash
-npx monomind memory list
-npx monomind memory list --namespace patterns --limit 20
-```
-
-**Flags:** `--namespace/-n`, `--limit/-l` (default: `20`)
-
-## delete — Remove Entry
-
-```bash
-npx monomind memory delete --key "old-pattern"
-npx monomind memory delete --key "temp-key" --namespace temp --force
-```
-
-**Flags:** `--key/-k` (required), `--namespace/-n` (default: `default`), `--force/-f` (skip confirmation)
-
-## templates — Entry Templates
-
-```bash
-npx monomind memory templates
-npx monomind memory templates --type feedback
-```
-
-Types: `user`, `feedback`, `project`, `reference` — scaffolds for the auto-memory format.
-
-## stats — Storage Overview
-
-```bash
-npx monomind memory stats
-```
-
-Shows backend, total entries, storage size, oldest/newest entry.
-
-## configure — Backend Settings
-
-```bash
-npx monomind memory configure --backend agentdb
-npx monomind memory configure --backend hybrid --cache-size 512 --hnsw-m 16 --hnsw-ef 200
-```
-
-**Flags:** `--backend/-b`, `--path`, `--cache-size`, `--hnsw-m`, `--hnsw-ef`
-
-## cleanup — Remove Stale Entries
-
-```bash
-# Preview without deleting
-npx monomind memory cleanup --dry-run
-
-# Delete entries older than 30 days
-npx monomind memory cleanup --older-than 30d
-
-# Remove expired TTL entries only
-npx monomind memory cleanup --expired-only
-
-# Clean specific namespace
-npx monomind memory cleanup --namespace temp --older-than 7d --force
-```
-
-**Flags:** `--dry-run/-d`, `--older-than/-o` (e.g., `7d`, `30d`), `--expired-only/-e`, `--namespace/-n`, `--force/-f`
-
-## compress — Optimize Storage
-
-```bash
-npx monomind memory compress
-npx monomind memory compress --quantize --bits 4  # 32x size reduction
-npx monomind memory compress --level max --target vectors
-```
-
-**Flags:** `--level fast|balanced|max` (default: `balanced`), `--target vectors|text|patterns|all`, `--quantize/-z`, `--bits 4|8|16`, `--rebuild-index/-r` (default: true)
-
-## export / import
-
-```bash
-# Export all to JSON
-npx monomind memory export --output ./backup.json
-
-# Export specific namespace to CSV
-npx monomind memory export --output ./patterns.csv --format csv --namespace patterns
-
-# Import
-npx monomind memory import --input ./backup.json
-npx monomind memory import --input ./backup.json --namespace archive
-```
-
-## Namespaces
-
-`default`, `agents`, `tasks`, `sessions`, `swarm`, `project`, `spec`, `arch`, `impl`, `test`, `debug`, `patterns`, `solutions`
-
-## MCP Tools
-
-```javascript
-// Store
-mcp__monomind__memory_store({ key: "pattern/auth", value: "JWT + refresh", namespace: "patterns" })
-
-// Search
-mcp__monomind__memory_search({ query: "authentication", namespace: "patterns" })
-
-// Retrieve
-mcp__monomind__memory_retrieve({ key: "pattern/auth", namespace: "patterns" })
-
-// List
-mcp__monomind__memory_list({ namespace: "patterns" })
-
-// Delete
-mcp__monomind__memory_delete({ key: "pattern/auth", namespace: "patterns" })
-
-// Stats
-mcp__monomind__memory_stats({})
-```
-
-## Common Workflows
-
-### Store successful pattern after completing a task
-
-```bash
-npx monomind memory store --key "pattern/oauth-integration" --value "Use PKCE flow, store tokens in httpOnly cookies" --namespace patterns --tags "auth,oauth"
-```
-
-### Search before starting a task
-
-```bash
-npx monomind memory search --query "OAuth integration patterns" --namespace patterns --limit 5
-```
-
-### Backup before major refactor
-
-```bash
-npx monomind memory export --output "./backups/memory-$(date +%Y%m%d).json"
-```

package/.claude/commands/monomind/repeat.md

@@ -1,257 +0,0 @@
----
-name: monomind:repeat
-description: "Monomind — Repeat any prompt or slash command on a schedule — default 15 min interval, 10 repetitions. This is the universal loop wrapper for all commands."
----
-
-## Argument Parsing
-
-Parse `$ARGUMENTS` for the following flags. **Everything after the first `--` (double dash) is the prompt — no further flag parsing, even if subsequent `--` tokens appear.** If no `--` is present, extract known flags in any order and treat the remainder as the prompt:
-
-- `--every <minutes>` — interval between repetitions in minutes (default: `15`). Minimum 1.
-- `--times <count>` — total number of repetitions (default: `10`). Ignored when `--tillend` is present.
-- `--tillend` — run until a complete round produces no findings and no actions. Overrides `--times`.
-- `--maxruns <N>` — safety cap for `--tillend` (default: `50`). Stops the loop even if the AI hasn't signaled done.
-- `--rep <N>` — (internal continuation flag injected by ScheduleWakeup; do not expose to user). Must be a positive integer ≤ MAX_REPS+1; reject otherwise.
-- `--loop <id>` — (internal continuation flag; preserves loop identity across runs). Must match format `repeat-[digits]-[digits]-[digits]`; reject otherwise.
-- `--` — end of flags; everything after this is the prompt verbatim
-- Everything else (after flag extraction) is the **prompt** to repeat
-
-If `INTERVAL` is less than 1, set it to 1 and output: `[monomind:repeat] Interval clamped to 1 minute (minimum).`
-
-If `MAX_REPS` is less than 1, set it to 1 and output: `[monomind:repeat] Repetitions clamped to 1 (minimum).`
-
-If `MAX_REPS` is greater than 1000, set it to 1000 and output: `[monomind:repeat] Repetitions clamped to 1000 (maximum).`
-
-If `--every` is present but its value is missing or not a number, use the default (15).
-
-If `--loop` is present but does not match the pattern `repeat-<digits>-<digits>-<digits>`, output `[monomind:repeat] ERROR: invalid loop ID` and STOP.
-
-**Examples:**
-```
-/monomind:repeat --every 5 --times 9 /mastermind:architect --iterate 2 review this project
-/monomind:repeat --every 1 --times 20 /mastermind:review check for security issues
-/monomind:repeat --every 30 /monomind:do --space abc --board def
-/monomind:repeat check deployment status
-```
-
-If `$ARGUMENTS` is empty or contains only flags with no prompt, output this and STOP:
-> **Usage:** `/monomind:repeat [--every <minutes>] [--times <count>] [--tillend [--maxruns <N>]] <prompt>`
->
-> Defaults: every 15 minutes, 10 times.
->
-> **Fixed-count mode** (default): runs the prompt N times, then stops.
-> **Tillend mode** (`--tillend`): runs until a complete round produces no findings and no actions. Safety cap: `--maxruns N` (default 50).
->
-> This is the universal loop wrapper. Wrap any slash command to repeat it:
-> - `/monomind:repeat --every 5 --times 9 /mastermind:architect review this project`
-> - `/monomind:repeat --every 1 --times 20 /mastermind:review check for security issues`
-> - `/monomind:repeat --tillend /mastermind:review 1` ← runs until clean pass
-> - `/monomind:repeat --every 30 /monomind:do --space abc --board def`
-> - `/monomind:repeat check deployment status`
-
----
-
-## Internal Flag: `--rep` and `--loop`
-
-When `--rep <N>` is present in arguments, this is a continuation from a previous wake-up:
-- `INTERVAL`, `MAX_REPS`, and `PROMPT` are already set by argument parsing above (they arrive via the ScheduleWakeup prompt)
-- Set `CURRENT_REP` to `N` instead of `1`
-- Set `LOOP_ID` from `--loop <id>`
-- Skip Step 1 initialization entirely
-- Go directly to Step 2 (execute) with output:
-  - **If `--tillend` active:** `[monomind:repeat] Tillend run N (cap: MAXRUNS) starting...`
-  - **Otherwise:** `[monomind:repeat] Run N/MAX_REPS starting...`
-
----
-
-## Step 1: Initialize
-
-Extract:
-- `INTERVAL` — from `--every` flag, default `15` (minutes), minimum 1
-- `MAX_REPS` — from `--times` flag, default `10`
-- `PROMPT` — everything remaining after flags are removed
-- `CURRENT_REP` — starts at `1`
-
-Write the initial loop state file so the dashboard can track this run. **You MUST run this bash block now via the Bash tool.** Before running, substitute `<INTERVAL>` and `<MAX_REPS>` with the parsed integer values, `<TILLEND_ACTIVE>` with `true` or `false` based on whether `--tillend` was provided, and `<MAXRUNS>` with the safety cap value. For `<PROMPT>`, substitute the raw prompt text inside the heredoc below — the single-quoted delimiter (`'MONOMIND_PROMPT_7x9k2m'`) prevents all bash expansion, and python3 handles JSON encoding. **If the prompt text contains the literal string `MONOMIND_PROMPT_7x9k2m`, replace that string in the prompt with `MONOMIND_PROMPT` before substitution** (this prevents heredoc delimiter collision):
-
-```bash
-mkdir -p .monomind/loops
-NOW_MS=$(python3 -c 'import time;print(int(time.time()*1000))' 2>/dev/null || echo "$(date +%s)000")
-LOOP_ID="repeat-${NOW_MS}-${RANDOM}-$$"
-PROMPT_JSON=$(python3 -c "import sys,json; sys.stdout.write(json.dumps(sys.stdin.read().rstrip(chr(10))))" << 'MONOMIND_PROMPT_7x9k2m'
-<PROMPT>
-MONOMIND_PROMPT_7x9k2m
-)
-if [ -z "$PROMPT_JSON" ]; then PROMPT_JSON='"(prompt unavailable)"'; fi
-LOOP_TYPE=$( [ '<TILLEND_ACTIVE>' = 'true' ] && echo 'tillend' || echo 'repeat' )
-LOOP_MAXREPS=$( [ '<TILLEND_ACTIVE>' = 'true' ] && echo '<MAXRUNS>' || echo '<MAX_REPS>' )
-cat > ".monomind/loops/${LOOP_ID}.json" << EOF
-{
-  "id": "${LOOP_ID}",
-  "sessionId": "${LOOP_ID}",
-  "type": "${LOOP_TYPE}",
-  "command": "/monomind:repeat",
-  "prompt": ${PROMPT_JSON},
-  "interval": <INTERVAL>,
-  "currentRep": 1,
-  "maxReps": ${LOOP_MAXREPS},
-  "startedAt": ${NOW_MS},
-  "lastRunAt": ${NOW_MS},
-  "nextRunAt": ${NOW_MS},
-  "status": "running"
-}
-EOF
-echo "LOOP_ID=${LOOP_ID}"
-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 "{\"type\":\"loop:start\",\"loopId\":\"${LOOP_ID}\",\"command\":\"/monomind:repeat\",\"mode\":\"${LOOP_TYPE}\",\"maxReps\":${LOOP_MAXREPS},\"interval\":<INTERVAL>,\"ts\":$(date +%s)000}" || true
-```
-
-Capture the `LOOP_ID` value echoed by the script — you will need it for all subsequent bash blocks.
-
-Output:
-- **If `--tillend` active:**
-  ```
-  [monomind:repeat] Starting tillend loop: "<PROMPT>"
-    Interval: every INTERVAL minutes
-    Safety cap: MAXRUNS runs
-    Run 1 starting now...
-  ```
-- **Otherwise:**
-  ```
-  [monomind:repeat] Starting: "<PROMPT>"
-    Interval: every INTERVAL minutes
-    Repetitions: MAX_REPS total
-    Run 1/MAX_REPS starting now...
-  ```
-
----
-
-## Step 2: Execute the Prompt
-
-Run the `PROMPT` as if the user typed it directly. This means:
-- If the prompt starts with `/`, invoke it as a slash command via the Skill tool
-- Otherwise, treat it as a normal user message and respond accordingly
-
----
-
-## Step 3: Report and Schedule Next
-
-**IMPORTANT:** In every bash block below, `<LOOP_ID>` must be substituted with the literal LOOP_ID value you captured from Step 1 (or from `--loop` on continuation runs). Shell variables do NOT persist between bash blocks.
-
-Before scheduling the next run, check if a stop was requested:
-```bash
-[ -f ".monomind/loops/<LOOP_ID>.stop" ] && echo "STOP_REQUESTED=true" || echo "STOP_REQUESTED=false"
-```
-If `STOP_REQUESTED=true`, output `[monomind:repeat] Stop requested via dashboard. Halting.` and remove the state files:
-```bash
-rm -f ".monomind/loops/<LOOP_ID>.json" ".monomind/loops/<LOOP_ID>.stop"
-```
-Then STOP.
-
-After execution completes, save the current rep as `PREV_REP`, then increment `CURRENT_REP`. Output:
-- **If `--tillend` active:** `[monomind:repeat] Tillend run PREV_REP complete.`
-- **Otherwise:** `[monomind:repeat] Run PREV_REP/MAX_REPS complete.`
-
-**If `--tillend` was active:** evaluate whether this round produced **zero findings AND zero actions**. Answer these two questions:
-1. Were any findings produced? (issues, problems, errors, tasks, items flagged, anything detected)
-2. Were any actions taken? (files edited, tasks created, commits made, content written, anything changed)
-
-Set `TILLEND_EMPTY=true` only if both answers are "no". **If the round found things and fixed them, `TILLEND_EMPTY=false` — run again to verify.** Only an actually empty round (nothing found, nothing done) stops the loop.
-
-If `TILLEND_EMPTY=true`:
-- Output: `[monomind:repeat] Empty round — nothing found and nothing changed. Tillend loop complete after PREV_REP run(s).`
-- Remove state file and emit loop:complete:
-  ```bash
-  rm -f ".monomind/loops/<LOOP_ID>.json" ".monomind/loops/<LOOP_ID>.stop"
-  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 "{\"type\":\"loop:complete\",\"loopId\":\"<LOOP_ID>\",\"command\":\"/monomind:repeat\",\"mode\":\"tillend\",\"ranReps\":<PREV_REP>,\"reason\":\"empty-round\",\"ts\":$(date +%s)000}" || true
-  ```
-- STOP. Do NOT schedule another wake-up.
-
-If `--tillend` is active AND `CURRENT_REP > MAXRUNS` (safety cap reached):
-- Output: `[monomind:repeat] Safety cap reached (MAXRUNS runs). Stopping tillend loop. If work remains, re-run with a higher --maxruns.`
-- Remove state file and emit loop:complete:
-  ```bash
-  rm -f ".monomind/loops/<LOOP_ID>.json" ".monomind/loops/<LOOP_ID>.stop"
-  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 "{\"type\":\"loop:complete\",\"loopId\":\"<LOOP_ID>\",\"command\":\"/monomind:repeat\",\"mode\":\"tillend\",\"ranReps\":<PREV_REP>,\"reason\":\"safety-cap\",\"ts\":$(date +%s)000}" || true
-  ```
-- STOP.
-
-If `CURRENT_REP > MAX_REPS` (fixed-count: all runs done), output:
-```
-[monomind:repeat] All MAX_REPS repetitions complete.
-```
-Remove the state file and emit loop:complete:
-```bash
-rm -f ".monomind/loops/<LOOP_ID>.json" ".monomind/loops/<LOOP_ID>.stop"
-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 "{\"type\":\"loop:complete\",\"loopId\":\"<LOOP_ID>\",\"command\":\"/monomind:repeat\",\"ranReps\":<MAX_REPS>,\"ts\":$(date +%s)000}" || true
-```
-STOP. Do NOT schedule another wake-up.
-
-Otherwise, update the loop state before scheduling. **Run this bash block** (substitute `<LOOP_ID>`, `<INTERVAL>`, `<CURRENT_REP>`, `<MAX_REPS>`, `<PREV_REP>`, `<TILLEND_ACTIVE>`, and `<MAXRUNS>` with their literal values):
-```bash
-NOW_MS=$(python3 -c 'import time;print(int(time.time()*1000))' 2>/dev/null || echo "$(date +%s)000")
-NEXT_AT=$(( NOW_MS + <INTERVAL> * 60 * 1000 ))
-PROMPT_JSON=$(jq '.prompt' ".monomind/loops/<LOOP_ID>.json" 2>/dev/null \
-  || python3 -c "import json,sys; json.dump(json.load(open('.monomind/loops/<LOOP_ID>.json'))['prompt'], sys.stdout)" 2>/dev/null \
-  || echo '"(prompt unavailable)"')
-STARTED_AT=$(jq '.startedAt' ".monomind/loops/<LOOP_ID>.json" 2>/dev/null \
-  || python3 -c "import json; print(json.load(open('.monomind/loops/<LOOP_ID>.json'))['startedAt'])" 2>/dev/null \
-  || echo "${NOW_MS}")
-LOOP_TYPE=$( [ '<TILLEND_ACTIVE>' = 'true' ] && echo 'tillend' || echo 'repeat' )
-LOOP_MAXREPS=$( [ '<TILLEND_ACTIVE>' = 'true' ] && echo '<MAXRUNS>' || echo '<MAX_REPS>' )
-cat > ".monomind/loops/<LOOP_ID>.json" << EOF
-{
-  "id": "<LOOP_ID>",
-  "sessionId": "<LOOP_ID>",
-  "type": "${LOOP_TYPE}",
-  "command": "/monomind:repeat",
-  "prompt": ${PROMPT_JSON},
-  "interval": <INTERVAL>,
-  "currentRep": <CURRENT_REP>,
-  "maxReps": ${LOOP_MAXREPS},
-  "startedAt": ${STARTED_AT},
-  "lastRunAt": ${NOW_MS},
-  "nextRunAt": ${NEXT_AT},
-  "status": "running"
-}
-EOF
-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 "{\"type\":\"loop:tick\",\"loopId\":\"<LOOP_ID>\",\"command\":\"/monomind:repeat\",\"mode\":\"${LOOP_TYPE}\",\"completedRep\":<PREV_REP>,\"nextRep\":<CURRENT_REP>,\"nextAt\":${NEXT_AT},\"ts\":$(date +%s)000}" || true
-```
-
-Output:
-- **If `--tillend` active:** `[monomind:repeat] Next tillend run in INTERVAL minutes (run CURRENT_REP, cap: MAXRUNS)...`
-- **Otherwise:** `[monomind:repeat] Next run in INTERVAL minutes (run CURRENT_REP/MAX_REPS)...`
-
-Use `ScheduleWakeup` with:
-- `delaySeconds`: `INTERVAL * 60`
-- **If `--tillend` active:** `prompt`: `/monomind:repeat --tillend --maxruns <MAXRUNS> --every <INTERVAL> --rep <CURRENT_REP> --loop <LOOP_ID> -- <PROMPT>`; `reason`: `"tillend run <CURRENT_REP> (cap: <MAXRUNS>) of /monomind:repeat"`
-- **Otherwise:** `prompt`: `/monomind:repeat --every <INTERVAL> --times <MAX_REPS> --rep <CURRENT_REP> --loop <LOOP_ID> -- <PROMPT>`; `reason`: `"repeat run <CURRENT_REP>/<MAX_REPS> of /monomind:repeat"`
-
-The `--` before `<PROMPT>` ensures the prompt text is never parsed as flags, even if it contains `--every` or `--times`. Substitute all angle-bracket values with their literals.
-
----
-
-## Interruption
-
-The user can stop the loop at any time by:
-- Interrupting the session (the next scheduled wake-up simply won't fire)
-- Creating `.monomind/loops/<LOOP_ID>.stop` (or clicking Stop in the dashboard)