@funara/wevr 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Adhi Rahmadian
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,397 @@
+# Wevr
+
+[![npm version](https://img.shields.io/npm/v/wevr)](https://www.npmjs.com/package/wevr)
+[![npm downloads](https://img.shields.io/npm/dm/wevr)](https://www.npmjs.com/package/wevr)
+[![License](https://img.shields.io/npm/l/wevr)](https://github.com/funara/wevr/blob/main/LICENSE)
+
+** Plan - Build - Review ** -- opinionated engineering workflow installer for [OpenCode](https://opencode.ai).
+
+## TL;DR
+
+Wevr installs an opinionated, strict AI-agent workflow (Compose, Debug, and Analyze) with 14 specialized subagents into **OpenCode**. It enforces structured phases (Explore -> Plan -> Build), interactive guardrail gates, and test verification without ad-hoc delegation.
+
+## Quick Start
+
+Get up and running in 3 simple steps:
+
+1. **Install globally:**
+```bash
+npm install -g wevr
+```
+
+2. **Initialize and configure agents:**
+```bash
+wevr init
+```
+*(Select LLM models for reasoning, precision, and fast tiers when prompted)*
+
+3. **Launch OpenCode with Wevr:**
+```bash
+wevr
+```
+
+---
+
+## What is Wevr?
+
+Wevr installs **3 primary agents + 14 subagents** into OpenCode -- each primary agent owns its exclusive subagents, scoped permissions, and enforced workflow rules. No shared subagents. No ad-hoc delegation.
+
+| Primary Agent | Purpose | Subagents |
+|---|---|---|
+| **Compose** | Feature work -- Explore -> Plan -> Build | Researcher, Plan-Writer, Plan-Checker, Coder, Tester, Reviewer, Compose-Reporter |
+| **Debug** | Bug investigation -- Investigate -> Fix -> Report | Inspector, Fixer, Debug-Reporter |
+| **Analyze** | Security audit -- Trace -> Patch -> Audit | Tracer, Patcher, Auditor, Analyze-Reporter |
+
+---
+
+### Parallel Subagent Swarming
+
+To optimize wall-clock execution time, Wevr's primary agents are empowered to **swarm multiple subagents concurrently** (e.g. running multiple researchers, inspectors, tracers, coders, fixers, patchers, testers, or auditors in parallel) for independent directories, files, or API endpoints. This enables non-linear workflow execution and leverages OpenCode's concurrent process engine.
+
+---
+
+## Agent Workflows
+
+### Compose -- Feature Work
+
+Compose is the **single entry point for all feature work**. It runs 3 strict, one-directional phases. Phase direction is one-way -- no going back without explicit user instruction.
+
+```
+You describe a feature / idea
+        |
+        v
+  +-----------------------------------------+
+  |  EXPLORE PHASE  (mandatory start)       |
+  |                                         |
+  |  Delegate: Researcher                   |
+  |  -> deep codebase + web fact-finding    |
+  |  -> confirmed-inferred facts / risks    |
+  |                                         |
+  |  Compose internally assesses:          |
+  |  Is this feature simple or complex?     |
+  +----------+------------------------------+
+             |
+    +--------+---------------+
+    | Simple feature         |  Complex feature
+    v                        v
+GUARDRAIL GATE 1a      GUARDRAIL GATE 1b
+"Build directly?"        "Write a PRD?"
+    |                        |
+    | Yes                    | Yes
+    |                        v
+    |          +------------------------------+
+    |          |  PLAN PHASE                  |
+    |          |                              |
+    |          |  Plan-Writer -> docs/plans/  |
+    |          |  Plan-Checker validates PRD  |
+    |          |  PASS/FAIL + gap list only   |
+    |          |                              |
+    |          |  FAIL -> surface gaps to you |
+    |          |  (max 5 loops)               |
+    |          |                              |
+    |          |  PASS -> GUARDRAIL GATE 2    |
+    |          |  "Build from this PRD?"      |
+    |          +-------------+----------------+
+    |                        | Yes
+    +----------+-------------+
+               v
+  +--------------------------------------------+
+  |  BUILD PHASE                               |
+  |                                            |
+  |  Coder -> implements from PRD / request    |
+  |     |                                      |
+  |     v                                      |
+  |  Tester -> PASS/FAIL/BLOCKED               |
+  |     | FAIL -> back to Coder (max 5 loops)  |
+  |     | PASS v                               |
+  |     v                                      |
+  |  Reviewer -> PASS/FAIL + gap list          |
+  |     | FAIL -> back to Coder (max 5 loops)  |
+  |     | PASS v                               |
+  |     v                                      |
+  |  Compose-Reporter -> docs/reports/         |
+  +--------------------------------------------+
+               |
+               v
+         You review result
+               |
+  Compose resets -> asks: New feature? Debug? Iterate?
+```
+
+**Key rules:**
+- Compose has **no read/write/bash permissions** -- all work delegated to subagents
+- Phase transition only via guardrail gates -- no skipping
+- `Coder -> Coder` loops without Tester verification are forbidden
+- 5 consecutive FAILs from Tester or Reviewer -> surfaces to you
+
+---
+
+### Debug -- Bug Investigation
+
+Debug is a **standalone primary agent** -- does not depend on Compose. Trigger it directly from the Debug tab whenever you find a bug.
+
+```
+You report a bug / defect
+        |
+        v
+GUARDRAIL GATE 1 (question tool):
+"Ready to investigate?"
+        | Yes
+        v
+  +---------------------------------------------+
+  |  INVESTIGATE PHASE  (Inspector subagent)    |
+  |                                             |
+  |  Review mode (Debug selects):            |
+  |  - PR Review        -> classify R1-R6       |
+  |  - Architecture     -> dependency analysis  |
+  |  - Tech Debt        -> Pain x Spread score  |
+  |  - Test Quality     -> classify T1-T6       |
+  |                                             |
+  |  Output: Iron Law chain per finding         |
+  |  Symptom -> Source -> Consequence -> Remedy |
+  +----------+----------------------------------+
+             |
+    Root cause identified?
+    +--------+--------+
+    | Yes             | No / unknowns remain
+    v                 v
+GUARDRAIL GATE 2 (question tool):
+"Ready to apply fix?"
+    | Yes             Halt -- surface to you
+    v                 with specific questions
+  +-------------+
+  |  FIX PHASE  | (Fixer subagent)
+  +------+------+
+         |
+         v
+  +--------------------------------------+
+  |  REPORT PHASE                        |
+  |                                      |
+  |  Delegate: Debug-Reporter            |
+  |  -> Iron Law diagnosis report        |
+  |  -> saved to docs/reports/           |
+  +--------------------------------------+
+         |
+         v
+   You review the diagnosis + fix
+         |
+  Debug resets -> asks (question tool): Finished? Iterate?
+```
+
+**Key rules:**
+- Debug has **no read/write/bash permissions** -- all delegated to subagents
+- Executes only after Gate 1 (Investigation) and Gate 2 (Fix) user confirmations
+- Never delegates Fixer without Inspector confirming root cause first
+- If unknowns remain after investigation -> halts and prompts you, does not guess
+
+---
+
+### Analyze -- Security Audit
+
+Analyze is a **standalone primary agent** -- does not depend on Compose or Debug. Trigger it directly from the Analyze tab to audit any codebase for security vulnerabilities and quality decay.
+
+```
+You trigger a security audit
+        |
+        v
+GUARDRAIL GATE 1 (question tool):
+"Ready to start scan?"
+        | Yes
+        v
+  +---------------------------------------------------+
+  |  TRACE PHASE  (Tracer subagent)                   |
+  |                                                   |
+  |  -> WSTG-guided breadth-first recon               |
+  |  -> trace data flows: input -> path -> sink       |
+  |                                                   |
+  |  Output:                                          |
+  |  - Confirmed Vulnerabilities  (OWASP category,    |
+  |    location, data flow)                           |
+  |  - Suspected Vulnerabilities  (manual verify)     |
+  |  - Quality & Decay Risks      (e.g. hardcoded     |
+  |    secrets, missing input validation)             |
+  +----------+----------------------------------------+
+             |
+             v
+      GUARDRAIL GATE 2 (question tool):
+      "Audit findings ready. How to proceed?"
+      +-- "Patch all confirmed findings"    -> PATCH PHASE
+      +-- "Select specific findings"        -> PATCH PHASE (you pick)
+      +-- "Audit only -- no patches"         -> AUDIT PHASE (skip PATCH)
+      +-- "Re-investigate attack surface"  -> re-delegate Tracer
+             |
+             v
+  +--------------------------------------------------+
+  |  PATCH PHASE  (skipped if audit-only)            |
+  |                                                  |
+  |  Delegate: Patcher                               |
+  |  -> Ponytail mindset: smallest correct diff      |
+  |  -> prefer deleting the cause over wrapping it   |
+  |  -> escalates to you if patch > 10 lines         |
+  +----------+---------------------------------------+
+             |
+             v
+  +--------------------------------------------------+
+  |  AUDIT PHASE  (max 5 loops)                      |
+  |                                                  |
+  |  Delegate: Auditor                               |
+  |  -> verify patch resolved vulnerabilities        |
+  |  -> security regression check                    |
+  |  |  (Auditor subagent)                           |
+  |                                                  |
+  |  PASS -> proceed to report                       |
+  |  FAIL -> re-delegate Patcher with Gap + BLOAT    |
+  |         lists verbatim (max 5 loops, then you)   |
+  |                                                  |
+  |  Delegate: Analyze-Reporter                        |
+  |  -> security audit report -> docs/reports/       |
+  +--------------------------------------------------+
+             |
+             v
+        You review the audit report
+             |
+  Analyze resets -> asks (question tool): Finished? Iterate?
+```
+
+**Key rules:**
+- Analyze has **no read/write/bash permissions** -- all delegated to subagents
+- Never starts scanning/tracing without Gate 1 user confirmation
+- Never patches without a GUARDRAIL GATE 2 user confirmation after TRACE
+- 5 consecutive AUDIT FAILs -> surfaces to you
+
+---
+
+## Subagent Reference
+
+Each subagent belongs to exactly one primary agent and cannot be invoked by anyone else:
+
+| Primary | Phase | Subagent | Model Tier | Role |
+|---------|-------|----------|------------|------|
+| Compose | EXPLORE | Researcher | Reasoning | Fact-finding: confirmed_facts / inferred_facts / unknowns / risks |
+| Compose | PLAN | Plan-Writer | Fast | **Formatter** -- writes PRD to `docs/plans/`, missing input = TBD |
+| Compose | PLAN | Plan-Checker | Reasoning | **Gate** -- PASS/FAIL + gap list only, no suggestions |
+| Compose | BUILD | Coder | Fast | Implements code from PRD |
+| Compose | BUILD | Tester | Precision | PASS/FAIL/BLOCKED + coverage gaps only |
+| Compose | BUILD | Reviewer | Precision | **Gate** -- PASS/FAIL + gap list only, no suggestions |
+| Compose | BUILD | Compose-Reporter | Fast | **Formatter** -- completion report to `docs/reports/` |
+| Debug | INVESTIGATE | Inspector | Reasoning | Brooks-Lint RCA (Iron Law + 6 decay risks + 4 review modes) |
+| Debug | FIX | Fixer | Fast | Minimal, root-cause-targeted fix |
+| Debug | REPORT | Debug-Reporter | Fast | **Formatter** -- Iron Law diagnosis report to `docs/reports/` |
+| Analyze | TRACE | Tracer | Precision | WSTG recon + vuln path tracing, no remedies |
+| Analyze | PATCH | Patcher | Fast | Minimal, security-targeted fix (Ponytail, max 10 lines) |
+| Analyze | AUDIT | Auditor | Precision | **Gate** -- PASS/FAIL + Gap List + BLOAT List only |
+| Analyze | AUDIT | Analyze-Reporter | Fast | **Formatter** -- security audit report to `docs/reports/` |
+
+---
+
+## Flow Rules
+
+| Rule | Detail |
+|------|--------|
+| **Mandatory starts** | Compose always starts in EXPLORE. Analyze always starts in TRACE. No skipping. |
+| **Guardrail gates** | Compose: Gate 1 (EXPLORE->PLAN/BUILD), Gate 2 (PLAN->BUILD). Analyze: Gate after TRACE. All require user confirmation. |
+| **Gate agents** | Plan-Checker, Reviewer, Auditor -- PASS/FAIL + gap list only. No suggestions, no decisions. |
+| **Formatter agents** | Plan-Writer, Compose-Reporter, Debug-Reporter, Analyze-Reporter -- stateless. Missing input = TBD/NA. Never invent content. |
+| **Fact-finding agents** | Researcher, Inspector, Tracer -- facts/inferences/risks only. No recommendations. |
+| **Build gate order** | Coder -> Tester -> Reviewer -> Compose-Reporter. No skipping. No Coder->Coder without verification. |
+| **FAIL loops** | Plan-Checker FAIL: max 5 loops. Build FAIL (Tester/Reviewer): max 5 loops. Analyze AUDIT FAIL: max 5 loops. All surface to you after limit. |
+| **Output directories** | PRDs -> `docs/plans/`. Reports (Compose-Reporter, Debug-Reporter, Analyze-Reporter) -> `docs/reports/`. Enforced by permissions. |
+| **Independence** | Debug and Analyze are fully standalone -- triggered directly, do not flow through Compose. |
+
+---
+
+## Brooks-Lint Methodology (Debug)
+
+The Debug pipeline uses the [Brooks-Lint](https://hyhmrright.github.io/brooks-lint/guide.html) framework:
+
+- **Iron Law** per finding: Symptom -> Source -> Consequence -> Remedy
+- **6 Decay Risks (R1-R6)**: Cognitive Overload, Change Propagation, Knowledge Duplication, Accidental Complexity, Dependency Disorder, Domain Model Distortion
+- **4 Review Modes**: PR Review (R1-R6), Architecture Audit, Tech Debt Assessment (Pain x Spread), Test Quality (T1-T6)
+- **T1-T6 Test Risks**: Test Obscurity, Brittleness, Duplication, Mock Abuse, Coverage Illusion, Architecture Mismatch
+
+## Principle Hierarchy
+
+All agents resolve conflicts using this priority order (defined in `hierarchy.txt`):
+
+1. **PRD / Spec** -- explicit requirement text
+2. **Verdict** -- Reviewer / Plan-Checker / Auditor PASS/FAIL
+3. **Engineering principles** -- Fail Fast, Single Responsibility
+4. **Heuristics** -- KISS, DRY, SOLID, Law of Demeter
+5. **Local optimization** -- style preference
+
+---
+
+## Install
+
+```sh
+npm install -g wevr
+```
+
+## Usage
+
+### `wevr`
+
+The everyday command. Runs three steps in sequence:
+
+1. **Update check** -- compares local version against npm registry; prompts to `npm install -g wevr` if a new version is available
+2. **Doctor check** -- verifies installation health; prompts to repair with `wevr init` if any checks fail
+3. **Launch** -- spawns `opencode`
+
+### `wevr init`
+
+Prompts you to select models for three agent tiers (reasoning, precision, and fast), then:
+
+- Builds a complete `opencode.jsonc` config with the chosen models injected into the right agents
+- Backs up any existing config to `opencode.jsonc.bak.*`
+- Writes the new config to `~/.config/opencode/opencode.jsonc`
+- Copies all 8 agent prompt files into `~/.config/opencode/prompts/`
+- Copies `wevr-flow` and `wevr-squeeze` plugins into `~/.config/opencode/plugins/`
+- Writes a `package.json` declaring `@opencode-ai/plugin` as a dependency
+
+### `wevr doctor`
+
+Checks installation health and reports pass/fail for each component:
+
+- `opencode.jsonc` exists
+- All 8 prompt files present
+- Both plugin files present
+- Theme configured
+- `package.json` with `@opencode-ai/plugin` dependency
+- Config is valid JSON
+
+Exits with code `0` if all pass, `1` if any fail.
+
+### `wevr update`
+
+Checks the npm registry for a newer version of wevr and prompts to automatically install the upgrade globally. If an update is successfully completed, the running CLI process exits to let you start fresh on the new version.
+
+### `wevr uninstall`
+
+Restores your previous configuration:
+
+- Finds the latest timestamped backup and restores it to `opencode.jsonc`
+- Restores `tui.json` from the latest backup (returning the TUI theme to its pre-Wevr state)
+- Removes `prompts/`, `plugins/`, `bin/`, and `themes/wevr-contrast.json` directories and files
+- Preserves `opencode.jsonc` and `package.json`
+
+---
+
+## Bundled Package
+
+### `wevr-flow`
+
+Provides subagents with cross-session context access:
+
+- `parent_session_messages` -- read the parent session's transcript
+- `session_messages(sessionId)` -- read any session by ID
+- `session_messages_batch(sessionIds)` -- read multiple sessions in one call
+
+### `wevr-squeeze`
+
+Monitors context fill limits and session health, calculates ResourceHealth and SessionEfficiency metrics, alerts on loop/retry patterns, and enables seamless session continuity/restores for same-project tasks.
+
+Both plugins and their dependency declaration are installed automatically by `wevr init` -- no extra user action required. On OpenCode's first launch, the bundled Bun runtime installs `@opencode-ai/plugin` from the generated `package.json`.
+
+### Themes & Colors
+
+Wevr comes with a pre-configured OLED high-contrast dark theme called **`wevr-contrast`** that is automatically applied to your OpenCode terminal interface.

package/bin/wevr.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { run } from "../src/cli/index.js"
+
+run(process.argv)

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@funara/wevr",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Opinionated Engineering Workflow for OpenCode — Plan, Build, Review.",
+  "keywords": [
+    "opencode",
+    "workflow",
+    "engineering",
+    "pipeline",
+    "ai-agents",
+    "code-review",
+    "debugging",
+    "security-audit",
+    "security",
+    "planner",
+    "builder",
+    "cli"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "scripts": {
+    "test": "node --test"
+  },
+  "bin": {
+    "wevr": "bin/wevr.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/funara/wevr.git"
+  },
+  "homepage": "https://github.com/funara/wevr#readme",
+  "bugs": {
+    "url": "https://github.com/funara/wevr/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin",
+    "src"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^0.9"
+  }
+}

package/src/cli/commands/doctor.js

@@ -0,0 +1,137 @@
+import { existsSync, readFileSync, readdirSync } from "node:fs"
+import { join } from "node:path"
+import { getConfigDir, getConfigPath, getPromptsDir, getThemesDir, getTuiConfigPath, getCommandsDir } from "../../core/paths.js"
+
+const EXPECTED_PROMPT_COUNT = 8
+const PLUGIN_FILES = ["wevr-flow.js", "wevr-squeeze.js"]
+const EXPECTED_COMMAND_FILES = ["squeeze-quick.md", "squeeze-health.md", "squeeze-dashboard.md"]
+
+export function cleanJsonc(content) {
+  return content.replace(
+    /\\"|"(?:\\"|[^"])*"|(\/\/.*|\/\*[\s\S]*?\*\/)|(,\s*(?=[\]}]))/g,
+    (m, g1, g2) => g1 ? "" : g2 ? "" : m
+  )
+}
+
+export function collectChecks() {
+  const configDir = getConfigDir()
+  const configPath = getConfigPath()
+  const promptsDir = getPromptsDir()
+  const pluginsDir = join(configDir, "plugins")
+  const packageJsonPath = join(configDir, "package.json")
+  const binDir = join(configDir, "bin")
+  const themesDir = getThemesDir()
+
+  const checks = []
+
+  // 1. opencode.jsonc exists
+  const configExists = existsSync(configPath)
+  checks.push({ component: "opencode.jsonc", pass: configExists })
+
+  // 2. All 8 prompt files exist
+  let promptCount = 0
+  if (existsSync(promptsDir)) {
+    try {
+      const files = readdirSync(promptsDir).filter((f) => f.endsWith(".txt"))
+      promptCount = files.length
+    } catch {
+      promptCount = 0
+    }
+  }
+  checks.push({ component: "8 prompt files", pass: promptCount === EXPECTED_PROMPT_COUNT, detail: `${promptCount}/${EXPECTED_PROMPT_COUNT}` })
+
+  // 3. Both plugin files exist
+  let pluginsFound = 0
+  for (const f of PLUGIN_FILES) {
+    if (existsSync(join(pluginsDir, f))) pluginsFound++
+  }
+  checks.push({ component: "plugin files", pass: pluginsFound === PLUGIN_FILES.length, detail: `${pluginsFound}/${PLUGIN_FILES.length}` })
+
+  // 3a. Slash command files exist
+  let commandsFound = 0
+  const commandsDir = getCommandsDir()
+  for (const f of EXPECTED_COMMAND_FILES) {
+    if (existsSync(join(commandsDir, f))) commandsFound++
+  }
+  checks.push({ component: "slash command files", pass: commandsFound === EXPECTED_COMMAND_FILES.length, detail: `${commandsFound}/${EXPECTED_COMMAND_FILES.length}` })
+
+  // 3b. Theme configuration verification (accepts any valid wevr theme)
+  const ALLOWED_THEMES = new Set(["wevr-dark", "wevr-light", "wevr-colorful"])
+  const tuiConfigPath = getTuiConfigPath()
+  let activeTheme = "wevr-dark" // default fallback
+  let tuiConfigValid = false
+  let tuiDetail = "missing mapping"
+  
+  if (existsSync(tuiConfigPath)) {
+    try {
+      const content = readFileSync(tuiConfigPath, "utf-8")
+      const parsed = JSON.parse(content)
+      if (parsed.theme && ALLOWED_THEMES.has(parsed.theme)) {
+        activeTheme = parsed.theme
+        tuiConfigValid = true
+        tuiDetail = ""
+      } else {
+        tuiDetail = `theme: ${parsed.theme || "none"}`
+      }
+    } catch {
+      tuiDetail = "corrupted tui.json"
+    }
+  }
+
+  const themeExists = existsSync(join(themesDir, `${activeTheme}.json`))
+  checks.push({
+    component: themeExists && tuiConfigValid ? `${activeTheme} theme configured` : "theme not configured",
+    pass: themeExists && tuiConfigValid,
+    detail: !themeExists ? `missing theme file ${activeTheme}.json` : tuiDetail
+  })
+
+  // 4. package.json with @opencode-ai/plugin dependency
+  let pkgValid = false
+  if (existsSync(packageJsonPath)) {
+    try {
+      const pkg = JSON.parse(readFileSync(packageJsonPath, "utf-8"))
+      pkgValid = !!(pkg.dependencies && pkg.dependencies["@opencode-ai/plugin"])
+    } catch {
+      pkgValid = false
+    }
+  }
+  checks.push({ component: "package.json + plugin dep", pass: pkgValid })
+
+
+  // 6. Config is valid JSON/JSONC
+  let configValid = false
+  if (configExists) {
+    try {
+      const content = readFileSync(configPath, "utf-8")
+      const cleaned = cleanJsonc(content)
+      JSON.parse(cleaned)
+      configValid = true
+    } catch {
+      configValid = false
+    }
+  }
+  checks.push({ component: "config JSON validity", pass: configValid })
+
+  return checks
+}
+
+export async function runDoctor() {
+  const checks = collectChecks()
+  const allPass = checks.every((c) => c.pass)
+
+  console.log("\nWevr Doctor — Installation Health Check\n")
+  for (const c of checks) {
+    const icon = c.pass ? "\u2713" : "\u2717"
+    const detail = c.detail ? ` (${c.detail})` : ""
+    console.log(`  ${icon} ${c.component}${detail}`)
+  }
+  console.log("")
+
+  if (allPass) {
+    console.log("All checks passed.")
+  } else {
+    console.log("Some checks failed. Re-run `wevr init` to repair.")
+  }
+
+  process.exit(allPass ? 0 : 1)
+}