npm - brain-dev - Versions diffs - 0.1.0 - Mend

brain-dev 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (78) hide show

package/LICENSE +21 -0
package/README.md +152 -0
package/agents/brain-checker.md +33 -0
package/agents/brain-debugger.md +35 -0
package/agents/brain-executor.md +37 -0
package/agents/brain-mapper.md +44 -0
package/agents/brain-planner.md +49 -0
package/agents/brain-researcher.md +47 -0
package/agents/brain-synthesizer.md +43 -0
package/agents/brain-verifier.md +41 -0
package/bin/brain-tools.cjs +185 -0
package/bin/lib/adr.cjs +283 -0
package/bin/lib/agents.cjs +152 -0
package/bin/lib/anti-patterns.cjs +183 -0
package/bin/lib/audit.cjs +268 -0
package/bin/lib/commands/adr.cjs +126 -0
package/bin/lib/commands/complete.cjs +270 -0
package/bin/lib/commands/config.cjs +306 -0
package/bin/lib/commands/discuss.cjs +237 -0
package/bin/lib/commands/execute.cjs +415 -0
package/bin/lib/commands/health.cjs +103 -0
package/bin/lib/commands/map.cjs +101 -0
package/bin/lib/commands/new-project.cjs +885 -0
package/bin/lib/commands/pause.cjs +142 -0
package/bin/lib/commands/phase-manage.cjs +357 -0
package/bin/lib/commands/plan.cjs +451 -0
package/bin/lib/commands/progress.cjs +167 -0
package/bin/lib/commands/quick.cjs +447 -0
package/bin/lib/commands/resume.cjs +196 -0
package/bin/lib/commands/storm.cjs +590 -0
package/bin/lib/commands/verify.cjs +504 -0
package/bin/lib/commands.cjs +263 -0
package/bin/lib/complexity.cjs +138 -0
package/bin/lib/complexity.test.cjs +108 -0
package/bin/lib/config.cjs +452 -0
package/bin/lib/core.cjs +62 -0
package/bin/lib/detect.cjs +603 -0
package/bin/lib/git.cjs +112 -0
package/bin/lib/health.cjs +356 -0
package/bin/lib/init.cjs +310 -0
package/bin/lib/logger.cjs +100 -0
package/bin/lib/platform.cjs +58 -0
package/bin/lib/requirements.cjs +158 -0
package/bin/lib/roadmap.cjs +228 -0
package/bin/lib/security.cjs +237 -0
package/bin/lib/state.cjs +353 -0
package/bin/lib/templates.cjs +48 -0
package/bin/templates/advocate.md +182 -0
package/bin/templates/checkpoint.md +55 -0
package/bin/templates/debugger.md +148 -0
package/bin/templates/discuss.md +60 -0
package/bin/templates/executor.md +201 -0
package/bin/templates/mapper.md +129 -0
package/bin/templates/plan-checker.md +134 -0
package/bin/templates/planner.md +165 -0
package/bin/templates/researcher.md +78 -0
package/bin/templates/storm.html +376 -0
package/bin/templates/synthesis.md +30 -0
package/bin/templates/verifier.md +181 -0
package/commands/brain/adr.md +34 -0
package/commands/brain/complete.md +37 -0
package/commands/brain/config.md +37 -0
package/commands/brain/discuss.md +35 -0
package/commands/brain/execute.md +38 -0
package/commands/brain/health.md +33 -0
package/commands/brain/map.md +35 -0
package/commands/brain/new-project.md +38 -0
package/commands/brain/pause.md +26 -0
package/commands/brain/plan.md +38 -0
package/commands/brain/progress.md +28 -0
package/commands/brain/quick.md +51 -0
package/commands/brain/resume.md +28 -0
package/commands/brain/storm.md +30 -0
package/commands/brain/verify.md +39 -0
package/hooks/bootstrap.sh +54 -0
package/hooks/post-tool-use.sh +45 -0
package/hooks/statusline.sh +130 -0
package/package.json +36 -0

package/bin/templates/storm.html ADDED Viewed

@@ -0,0 +1,376 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Brain Storm: {{topic}}</title>
+  <style>
+    *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
+    body {
+      background: #1a1a2e;
+      color: #e0e0e0;
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      min-height: 100vh;
+      display: flex;
+      flex-direction: column;
+    }
+    header {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      padding: 1rem 1.5rem;
+      background: #0f0f23;
+      border-bottom: 1px solid #2a2a4a;
+    }
+    header h1 {
+      font-size: 1.25rem;
+      font-weight: 600;
+      color: #e94560;
+    }
+    .status {
+      display: flex;
+      align-items: center;
+      gap: 0.5rem;
+      font-size: 0.85rem;
+      color: #888;
+    }
+    .status-dot {
+      width: 10px;
+      height: 10px;
+      border-radius: 50%;
+      background: #e94560;
+      transition: background 0.3s;
+    }
+    .status-dot.connected { background: #4ade80; }
+    .card-container {
+      flex: 1;
+      padding: 1.5rem;
+      display: grid;
+      grid-template-columns: repeat(3, 1fr);
+      gap: 1rem;
+      align-content: start;
+      overflow-y: auto;
+    }
+    @media (max-width: 768px) {
+      .card-container {
+        grid-template-columns: 1fr;
+      }
+    }
+    .card {
+      background: #16213e;
+      border-radius: 8px;
+      padding: 1rem;
+      cursor: pointer;
+      border: 2px solid transparent;
+      box-shadow: 0 2px 8px rgba(0, 0, 0, 0.3);
+      transition: transform 0.15s, box-shadow 0.15s, border-color 0.15s;
+      user-select: none;
+    }
+    .card:hover {
+      transform: translateY(-2px);
+      box-shadow: 0 4px 16px rgba(0, 0, 0, 0.5);
+    }
+    .card.highlighted {
+      border-color: #e94560;
+    }
+    .card.drag-over {
+      border-color: #4ade80;
+      background: #1a2940;
+    }
+    .card h3 {
+      color: #e94560;
+      font-size: 0.95rem;
+      margin-bottom: 0.5rem;
+    }
+    .card .body {
+      font-size: 0.85rem;
+      line-height: 1.5;
+      color: #ccc;
+    }
+    .card .body h1, .card .body h2, .card .body h3 {
+      color: #e0e0e0;
+      margin: 0.5rem 0 0.25rem;
+    }
+    .card .body strong { color: #fff; }
+    .card .body em { color: #aaa; font-style: italic; }
+    .card .body code {
+      background: #0f0f23;
+      padding: 0.1rem 0.3rem;
+      border-radius: 3px;
+      font-size: 0.8rem;
+    }
+    .card .body ul {
+      padding-left: 1.2rem;
+      margin: 0.25rem 0;
+    }
+    .input-area {
+      display: flex;
+      gap: 0.75rem;
+      padding: 1rem 1.5rem;
+      background: #0f0f23;
+      border-top: 1px solid #2a2a4a;
+    }
+    .input-area textarea {
+      flex: 1;
+      background: #16213e;
+      color: #e0e0e0;
+      border: 1px solid #2a2a4a;
+      border-radius: 6px;
+      padding: 0.75rem;
+      font-family: inherit;
+      font-size: 0.9rem;
+      resize: vertical;
+      min-height: 48px;
+      max-height: 200px;
+    }
+    .input-area textarea:focus {
+      outline: none;
+      border-color: #e94560;
+    }
+    .input-area button {
+      background: #e94560;
+      color: #fff;
+      border: none;
+      border-radius: 6px;
+      padding: 0.75rem 1.5rem;
+      font-size: 0.9rem;
+      cursor: pointer;
+      white-space: nowrap;
+      align-self: flex-end;
+    }
+    .input-area button:hover { background: #c73652; }
+    .input-area button:disabled { background: #555; cursor: not-allowed; }
+    .empty-state {
+      grid-column: 1 / -1;
+      text-align: center;
+      padding: 3rem;
+      color: #555;
+      font-size: 1rem;
+    }
+  </style>
+</head>
+<body>
+  <header>
+    <h1>{{topic}}</h1>
+    <div class="status">
+      <div class="status-dot" id="statusDot"></div>
+      <span id="statusText">Disconnected</span>
+    </div>
+  </header>
+  <div class="card-container" id="cardContainer">
+    <div class="empty-state" id="emptyState">No fragments yet. Add one below or send from the brain agent.</div>
+  </div>
+  <div class="input-area">
+    <textarea id="fragmentInput" placeholder="Type a fragment... (Shift+Enter for new line, Enter to send)" rows="1"></textarea>
+    <button id="sendBtn">Send</button>
+  </div>
+  <script>
+    (function() {
+      var ws = null;
+      var reconnectAttempts = 0;
+      var maxReconnect = 10;
+      var reconnectTimer = null;
+      var container = document.getElementById('cardContainer');
+      var emptyState = document.getElementById('emptyState');
+      var statusDot = document.getElementById('statusDot');
+      var statusText = document.getElementById('statusText');
+      var fragmentInput = document.getElementById('fragmentInput');
+      var sendBtn = document.getElementById('sendBtn');
+      function connect() {
+        var url = 'ws://localhost:' + location.port;
+        ws = new WebSocket(url);
+        ws.onopen = function() {
+          reconnectAttempts = 0;
+          statusDot.classList.add('connected');
+          statusText.textContent = 'Connected';
+        };
+        ws.onclose = function() {
+          statusDot.classList.remove('connected');
+          statusText.textContent = 'Disconnected';
+          scheduleReconnect();
+        };
+        ws.onerror = function() {
+          // onclose will fire after this
+        };
+        ws.onmessage = function(event) {
+          var msg;
+          try { msg = JSON.parse(event.data); } catch(e) { return; }
+          if (msg.type === 'fragment') {
+            addCard(msg);
+          } else if (msg.type === 'fragments-sync') {
+            for (var i = 0; i < msg.fragments.length; i++) {
+              addCard(msg.fragments[i]);
+            }
+          }
+        };
+      }
+      function scheduleReconnect() {
+        if (reconnectAttempts >= maxReconnect) {
+          statusText.textContent = 'Connection lost';
+          return;
+        }
+        reconnectAttempts++;
+        statusText.textContent = 'Reconnecting (' + reconnectAttempts + '/' + maxReconnect + ')...';
+        reconnectTimer = setTimeout(connect, 3000);
+      }
+      function escapeHtml(str) {
+        return str
+          .replace(/&/g, '&amp;')
+          .replace(/</g, '&lt;')
+          .replace(/>/g, '&gt;')
+          .replace(/"/g, '&quot;')
+          .replace(/'/g, '&#039;');
+      }
+      function simpleMarkdown(text) {
+        if (!text) return '';
+        // Escape HTML first to prevent XSS, then apply markdown formatting
+        return escapeHtml(text)
+          .replace(/^### (.+)$/gm, '<h3>$1</h3>')
+          .replace(/^## (.+)$/gm, '<h2>$1</h2>')
+          .replace(/^# (.+)$/gm, '<h1>$1</h1>')
+          .replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>')
+          .replace(/\*(.+?)\*/g, '<em>$1</em>')
+          .replace(/`([^`]+)`/g, '<code>$1</code>')
+          .replace(/^- (.+)$/gm, '<li>$1</li>')
+          .replace(/(<li>.*<\/li>)/gs, '<ul>$1</ul>')
+          .replace(/\n/g, '<br>');
+      }
+      function addCard(data) {
+        if (emptyState) {
+          emptyState.remove();
+          emptyState = null;
+        }
+        var card = document.createElement('div');
+        card.className = 'card';
+        card.draggable = true;
+        card.dataset.id = data.id || ('f-' + Date.now());
+        var title = document.createElement('h3');
+        title.textContent = data.title || 'Fragment';
+        card.appendChild(title);
+        var body = document.createElement('div');
+        body.className = 'body';
+        body.innerHTML = simpleMarkdown(data.body || '');
+        card.appendChild(body);
+        // Click handler: toggle highlight
+        card.addEventListener('click', function() {
+          card.classList.toggle('highlighted');
+          if (ws && ws.readyState === WebSocket.OPEN) {
+            ws.send(JSON.stringify({
+              type: 'click',
+              fragmentId: card.dataset.id,
+              highlighted: card.classList.contains('highlighted'),
+              timestamp: Date.now()
+            }));
+          }
+        });
+        // Drag start
+        card.addEventListener('dragstart', function(e) {
+          e.dataTransfer.setData('text/plain', card.dataset.id);
+          e.dataTransfer.effectAllowed = 'move';
+        });
+        // Drag over (allow drop)
+        card.addEventListener('dragover', function(e) {
+          e.preventDefault();
+          e.dataTransfer.dropEffect = 'move';
+          card.classList.add('drag-over');
+        });
+        card.addEventListener('dragleave', function() {
+          card.classList.remove('drag-over');
+        });
+        // Drop: group cards
+        card.addEventListener('drop', function(e) {
+          e.preventDefault();
+          card.classList.remove('drag-over');
+          var sourceId = e.dataTransfer.getData('text/plain');
+          var targetId = card.dataset.id;
+          if (sourceId !== targetId && ws && ws.readyState === WebSocket.OPEN) {
+            ws.send(JSON.stringify({
+              type: 'group',
+              sourceId: sourceId,
+              targetId: targetId,
+              timestamp: Date.now()
+            }));
+          }
+        });
+        container.appendChild(card);
+      }
+      function sendFragment() {
+        var text = fragmentInput.value.trim();
+        if (!text || !ws || ws.readyState !== WebSocket.OPEN) return;
+        // Split on first line as title, rest as body
+        var lines = text.split('\n');
+        var title = lines[0];
+        var body = lines.slice(1).join('\n').trim();
+        ws.send(JSON.stringify({
+          type: 'add-fragment',
+          title: title,
+          body: body
+        }));
+        fragmentInput.value = '';
+      }
+      sendBtn.addEventListener('click', sendFragment);
+      fragmentInput.addEventListener('keydown', function(e) {
+        if (e.key === 'Enter' && !e.shiftKey) {
+          e.preventDefault();
+          sendFragment();
+        }
+      });
+      // Start connection
+      connect();
+    })();
+  </script>
+</body>
+</html>

package/bin/templates/synthesis.md ADDED Viewed

@@ -0,0 +1,30 @@
+You are a research synthesis agent. Combine the findings from 6 research agents into a unified SUMMARY.md.
+Read all files in {{research_dir}}:
+- stack.md (technology stack and ecosystem)
+- architecture.md (architecture patterns)
+- pitfalls.md (pitfalls and anti-patterns)
+- security.md (security and compliance)
+- competitive.md (competitive analysis)
+- testing.md (testing strategy)
+Produce {{output_path}} with:
+## Recommended Stack
+## Architecture
+## Key Decisions
+## Risks and Mitigations
+## Testing Strategy
+Resolve conflicts between researchers (e.g., if stack and architecture disagree on a library).
+Keep total output under 5000 tokens.
+## Output Marker
+When synthesis is complete, output:
+```
+## SYNTHESIS COMPLETE
+**Output:** {{output_path}}
+**Key decisions:** [one-line summary of primary architecture/stack decisions]
+```

package/bin/templates/verifier.md ADDED Viewed

@@ -0,0 +1,181 @@
+# Verifier Agent Instructions
+## Phase Must-Haves
+{{must_haves}}
+## Anti-Pattern Scan Results
+{{anti_pattern_results}}
+Use these results when evaluating Level 2 (Substantive) checks. Blockers MUST be reported as verification failures. Warnings should be noted but do not block.
+## 3-Level Verification
+For each artifact in must_haves, perform these automated checks:
+### Level 1: Exists
+- File exists at the specified path
+- File is not empty (has content)
+### Level 2: Substantive
+- File has real implementation (not stub)
+- No TODO-only files, no empty functions, no log-only handlers
+- Minimum reasonable line count for the artifact type
+- Anti-pattern scan: count TODO/FIXME, placeholder content, empty returns
+- Cross-reference anti-pattern scan results above for blockers
+### Level 3: Wired (Enhanced Key Link Verification)
+- File is imported/used where expected
+- Check key_links: from-file imports/references to-file with specified pattern
+- Verify exports are actually consumed by dependent modules
+For each key_link in must_haves, perform three wiring checks:
+1. **Import exists:** grep/search for require() or import of the dependency file
+2. **Function called:** grep for the specific function name being used in the consuming file
+3. **Registration:** for commands, verify entry in commands.cjs COMMANDS array
+If grep finds the pattern: PASS
+If grep does not find it: read the file fully to check for aliased imports, re-exports, or indirect usage before marking FAIL
+## Truth Verification
+Each truth from must_haves should be testable:
+- Run existing tests that cover the truth
+- If no test exists, verify the behavior manually
+## Nyquist Validation
+{{nyquist_section}}
+For each must_have truth, search test files for a matching test:
+- Extract key words from the truth statement (ignore stop words: can, the, a, is, are, and, or, to, in, for, with)
+- Search test file describe/it/test blocks for 60%+ keyword overlap
+- Report coverage ratio: N truths with matching tests / M total truths
+## Human Verification Detection
+Scan must_have truths for keywords indicating human verification needed:
+- Keywords: 'live session', 'browser', 'UI', 'visual', 'interactive', 'click', 'drag', 'animation', 'responsive', 'mobile', 'external service'
+- Truths matching these keywords: mark as human-verify level, add to human verification checklist
+- Status becomes 'human_needed' when automated checks pass but human items remain
+## Human Verification Gate
+Separate items that require human verification (visual checks, interactive flows, UX evaluation) from automated checks. Present human-verify items for user approval via AskUserQuestion instructions.
+**Automated checks:** File existence, substantive content, import wiring, test passing
+**Human verification:** Visual design, interactive flows, UX evaluation, cross-browser behavior
+## Scored Results
+After checking all must_haves, compute a score:
+```
+Score: [verified_count] / [total_count] must_haves verified
+```
+Where:
+- **verified_count** = number of must_haves that pass all applicable levels
+- **total_count** = total number of must_haves (truths + artifacts + key_links)
+### Status Determination
+Based on the score:
+- **passed** (100%): All must_haves verified at all levels. Phase/plan deliverables are complete.
+- **gaps_found** (<100%): Some must_haves failed verification. List specific gaps with remediation steps.
+- **human_needed**: Some items require human verification (visual, interactive, UX). Automated checks passed but human gate pending.
+## Output Format
+Write results to `{{output_path}}` with this structure:
+### YAML Frontmatter
+Start the file with YAML frontmatter containing machine-parseable metadata:
+```yaml
+---
+phase: [phase number]
+status: passed | gaps_found | human_needed
+score: [verified]/[total]
+must_haves_verified: [count]
+must_haves_total: [count]
+human_verification_count: [count]
+anti_pattern_blockers: [count]
+anti_pattern_warnings: [count]
+gaps:
+  - id: GAP-001
+    severity: blocker | warning
+    truth: "[the must_have truth that failed]"
+    description: "[what specifically failed]"
+    files: ["file1.cjs", "file2.cjs"]
+    suggested_fix: "[concrete fix suggestion]"
+---
+```
+### Per-Truth Results
+```markdown
+### Truth: "[truth statement]"
+**Status:** PASS | FAIL
+**Evidence:** [how it was verified -- test name, command output, manual check]
+**Level:** [automated | human-verify]
+```
+### Per-Artifact Results
+```markdown
+### Artifact: [file path]
+**Provides:** [what the artifact provides]
+| Level | Check | Status | Evidence |
+|-------|-------|--------|----------|
+| 1 - Exists | File exists on disk | PASS/FAIL | [file size, line count] |
+| 1 - Exists | File is not empty | PASS/FAIL | [line count] |
+| 2 - Substantive | Real implementation | PASS/FAIL | [exports found, function count] |
+| 2 - Substantive | No TODO-only content | PASS/FAIL | [TODO/FIXME count] |
+| 2 - Substantive | Minimum line count | PASS/FAIL | [actual vs expected] |
+| 3 - Wired | Imported by consumers | PASS/FAIL | [importing files found] |
+| 3 - Wired | Exports consumed | PASS/FAIL | [usage locations] |
+| 3 - Wired | Tests assert behavior | PASS/FAIL | [test file, assertion count] |
+```
+### Per-Key-Link Results
+```markdown
+### Key Link: [from] -> [to]
+**Via:** [connection description]
+**Pattern:** [regex pattern]
+**Status:** PASS | FAIL
+**Evidence:** [grep result showing the connection exists]
+```
+### Summary
+```markdown
+## Verification Summary
+**Score:** [N] / [M] must_haves verified
+**Status:** passed | gaps_found | human_needed
+### Gaps (if any)
+1. [must_have]: [what failed] -- [suggested fix]
+### Human Verification Required (if any)
+1. [item]: [what needs human check] -- [instructions for user]
+```
+## Output Marker
+When verification is complete, output:
+```
+## VERIFICATION COMPLETE
+**Score:** [N]/[M]
+**Status:** [passed | gaps_found | human_needed]
+**Gaps:** [count of failed must_haves, or "none"]
+**Human items:** [count of items needing human verification, or "none"]
+```

package/commands/brain/adr.md ADDED Viewed

@@ -0,0 +1,34 @@
+---
+name: brain:adr
+description: Manage Architecture Decision Records
+argument-hint: "create|list|search [args]"
+allowed-tools:
+  - Read
+  - Write
+  - Glob
+  - Grep
+  - Bash
+  - AskUserQuestion
+---
+<objective>
+Manage Architecture Decision Records (ADRs) stored in .brain/adrs/.
+Supports creating new ADRs, listing existing ones, and searching decision history.
+</objective>
+<context>
+`$ARGUMENTS` contains a subcommand and optional args:
+- `create` — Create a new ADR with guided prompts
+- `list` — List all existing ADRs with status (proposed, accepted, deprecated)
+- `search <query>` — Search ADRs by keyword or tag
+</context>
+<process>
+1. Run the brain CLI to manage ADRs:
+```bash
+npx brain-dev adr $ARGUMENTS
+```
+2. For `create`: the CLI guides through a structured template. Use AskUserQuestion if additional context is needed from the user.
+3. For `list` or `search`: present the results in a readable format showing ADR number, title, and status.
+</process>

package/commands/brain/complete.md ADDED Viewed

@@ -0,0 +1,37 @@
+---
+name: brain:complete
+description: Archive milestone and tag release
+argument-hint: "[--audit-only] [--force]"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Glob
+  - Grep
+  - Bash
+  - Task
+  - AskUserQuestion
+---
+<objective>
+Archive the current milestone, run a completion audit, generate release notes, and create a git tag.
+Ensures all phases are verified before completing.
+</objective>
+<context>
+`$ARGUMENTS` contains optional flags:
+- `--audit-only` — Run the completion audit without archiving or tagging
+- `--force` — Force completion even if some verifications are pending
+</context>
+<process>
+1. Run the brain CLI to complete the milestone:
+```bash
+npx brain-dev complete $ARGUMENTS
+```
+2. The CLI audits all phases, archives the milestone, generates release notes, and creates a git tag. It blocks if any phases have unresolved failures unless `--force` is used.
+3. Review the audit results and release notes. Confirm the git tag was created.
+4. **Next step:** Run `/brain:new-project` to start the next milestone.
+</process>

package/commands/brain/config.md ADDED Viewed

@@ -0,0 +1,37 @@
+---
+name: brain:config
+description: Configure brain settings
+argument-hint: "[set|get|list|reset|docs|export|import] [--global]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - AskUserQuestion
+---
+<objective>
+Configure brain settings at project or global level. Manage configuration values, export/import settings, and view documentation for available options.
+When no subcommand is given, launches an interactive menu.
+</objective>
+<context>
+`$ARGUMENTS` contains an optional subcommand and flags:
+- `set <key> <value>` — Set a configuration value
+- `get <key>` — Get a configuration value
+- `list` — List all configuration values
+- `reset` — Reset configuration to defaults
+- `docs` — Show configuration documentation
+- `export` — Export configuration to file
+- `import <file>` — Import configuration from file
+- `--global` — Apply to global config instead of project config
+</context>
+<process>
+1. Run the brain CLI to manage configuration:
+```bash
+npx brain-dev config $ARGUMENTS
+```
+2. If no subcommand was given, the CLI shows an interactive menu. Follow the prompts.
+3. For `set`/`reset`: confirm the change was applied and validated against the schema. For `list`/`get`/`docs`: present the output to the user.
+</process>