devloom 1.0.0 → 1.1.0

package/commands/devloom-agents.md

@@ -0,0 +1,49 @@
+---
+description: "DevLoom Agents: list all available agents and their current models"
+agent: devloom-orchestrator
+model: opencode-go/deepseek-v4-flash
+subtask: false
+---
+
+# DevLoom Agents
+
+List all DevLoom agents, their roles, and current model assignments.
+
+```bash
+PROFILE_MJS="$(node -e 'const fs=require("fs"),p=require("path");console.log(p.join(p.dirname(fs.realpathSync(process.argv[1])),"profile.mjs"))' "$0" 2>/dev/null)"
+[ -f "$PROFILE_MJS" ] || PROFILE_MJS="$HOME/.config/opencode/devloom-scripts/profile.mjs"
+[ -f "$PROFILE_MJS" ] || PROFILE_MJS="$HOME/.config/opencode/commands/profile.mjs"
+[ -f "$PROFILE_MJS" ] || { echo "profile.mjs not found - reinstall DevLoom"; exit 1; }
+node "$PROFILE_MJS" current 2>&1
+```
+
+## Agent Reference
+
+| Agent | Role | Description |
+|-------|------|-------------|
+| devloom-orchestrator | Strategic coordinator | Plans, dispatches specialists, reconciles results |
+| devloom-planner | Architecture | Requirements, specs, technical plans |
+| devloom-developer | Implementation | Code, features, defect fixes |
+| devloom-qa | Verification | Tests, lint, code review, regression |
+| devloom-verifier | Runtime checks | Routes, forms, a11y, API contracts |
+| devloom-security | Security | CRUD endpoint security, data exposure |
+| devloom-documenter | Documentation | README, docs, state persistence |
+| devloom-vision | Visual analysis | Image/screenshot analysis |
+| devloom-visual-director | Design direction | Classifies visual domain, writes DESIGN_FILE brief (read-only) |
+| devloom-visual-critic | Visual review | Scores screenshots against the design contract (read-only) |
+
+## Usage
+
+- `@devloom-planner` — ask for architecture or specs
+- `@devloom-developer` — ask to implement or fix code
+- `@devloom-qa` — ask for review or testing
+- `@devloom-verifier` — ask for runtime verification
+- `@devloom-security` — ask for security audit
+- `@devloom-documenter` — ask for documentation
+- `@devloom-vision` — attach image for analysis
+- `@devloom-visual-director` — ask for UI visual direction / a design brief
+- `@devloom-visual-critic` — ask for an independent screenshot critique
+
+Switch profiles: `/devloom-go`, `/devloom-go-economy`, `/devloom-free`, `/devloom-mimo`
+
+After switching profiles, restart opencode (or continue with `opencode --continue`) to see the updated profile and agents in the sidebar. If the sidebar does not reflect the current DevLoom code, run `/devloom-refresh`.

package/commands/devloom-auto.md

@@ -0,0 +1,11 @@
+---
+description: "DevLoom Auto: detect and apply the best profile"
+---
+
+# DevLoom Auto
+
+Detect available models and apply the best profile automatically.
+
+!`PM="$HOME/.config/opencode/commands/profile.mjs"; [ -f "$PM" ] || PM="$HOME/.config/opencode/devloom-scripts/profile.mjs"; [ -f "$PM" ] || { echo "profile.mjs not found - reinstall DevLoom"; exit 1; }; node "$PM" set auto 2>&1; node "$PM" current 2>&1`
+
+DevLoom profile set automatically. Profile applied — restart opencode (or continue with `opencode --continue`) to see the updated profile and agents in the sidebar.

package/commands/devloom-context.md

@@ -0,0 +1,82 @@
+---
+description: "DevLoom Context: show, clear, or regenerate auto-detected project patterns"
+agent: devloom-orchestrator
+subtask: false
+---
+
+# DevLoom Context
+
+Context is **auto-generated** by the plugin from your codebase (package.json, file structure, existing code). Agents load it automatically before generating code. No command needed — it just works.
+
+This command is for manual override only:
+
+```
+/devloom-context --show          # display current context files
+/devloom-context --regenerate    # force regenerate from codebase (overwrites)
+/devloom-context --clear         # remove all context files
+```
+
+```bash
+ACTION="${ARGUMENTS:---show}"
+DIR=".opencode/devloom/context"
+
+case "$ACTION" in
+  --show)
+    if [ ! -d "$DIR" ]; then
+      echo "No context directory. Context auto-generates when the plugin loads."
+      exit 0
+    fi
+    for f in "$DIR"/project.md "$DIR"/conventions.md "$DIR"/security.md "$DIR"/examples.md; do
+      if [ -f "$f" ]; then
+        echo "=== $(basename "$f") ==="
+        cat "$f"
+        echo ""
+      fi
+    done
+    ;;
+  --regenerate)
+    mkdir -p "$DIR"
+    node -e "
+      const fs = require('fs');
+      const path = require('path');
+      const dir = '.opencode/devloom/context';
+      fs.mkdirSync(dir, { recursive: true });
+      const now = new Date().toISOString();
+      let pkg = {};
+      try { pkg = JSON.parse(fs.readFileSync('package.json', 'utf8')); } catch {}
+      const deps = { ...(pkg.dependencies || {}), ...(pkg.devDependencies || {}) };
+      const has = (f) => fs.existsSync(f);
+      const lang = has('tsconfig.json') ? 'TypeScript' : has('go.mod') ? 'Go' : has('pyproject.toml') ? 'Python' : has('Cargo.toml') ? 'Rust' : pkg.name ? 'JavaScript' : 'Unknown';
+      const fw = deps.next ? 'Next.js' : deps.react ? 'React' : deps.vue ? 'Vue' : deps.fastify ? 'Fastify' : deps.express ? 'Express' : deps.hono ? 'Hono' : 'Unknown';
+      const orm = deps.drizzle ? 'Drizzle' : deps.prisma || has('prisma/schema.prisma') ? 'Prisma' : deps.typeorm ? 'TypeORM' : deps.mongoose ? 'Mongoose' : 'Unknown';
+      const val = deps.zod ? 'Zod' : deps.yup ? 'Yup' : deps.joi ? 'Joi' : 'Unknown';
+      const test = deps.jest || has('jest.config.mjs') ? 'Jest' : deps.vitest ? 'Vitest' : 'Unknown';
+      const linter = deps.eslint ? 'ESLint' : deps.biome ? 'Biome' : 'Unknown';
+      const pm = has('bun.lock') ? 'bun' : has('pnpm-lock.yaml') ? 'pnpm' : has('yarn.lock') ? 'yarn' : has('package-lock.json') ? 'npm' : 'Unknown';
+      const libs = Object.keys(deps).filter(k => ['next-auth','jsonwebtoken','bcryptjs','argon2','stripe','twilio','sendgrid','nodemailer','ioredis','openai','winston','pino','dotenv','lodash','date-fns','dayjs','zod','drizzle-orm'].includes(k));
+
+      fs.writeFileSync(dir + '/project.md', '# Project Patterns\n> Auto-generated: ' + now + '\n> MVI: keep under 200 lines. Edit manually to override.\n\n## Tech Stack\n- Language: ' + lang + '\n- Framework: ' + fw + '\n- ORM: ' + orm + '\n- Validation: ' + val + '\n- Testing: ' + test + '\n- Linter: ' + linter + '\n- Package manager: ' + pm + '\n\n## Architecture\n- Follow existing project structure\n- SOLID + Clean Architecture\n- Dependency inversion\n- Surgical changes: smallest correct diff\n\n## Key Libraries\n' + (libs.length ? libs.map(l => '- ' + l).join('\n') : '- (none detected)') + '\n');
+
+      fs.writeFileSync(dir + '/conventions.md', '# Coding Conventions\n> Auto-generated: ' + now + '\n> MVI: keep under 200 lines.\n\n## Naming\n- Files: kebab-case\n- Components: PascalCase\n- Functions: camelCase\n- Constants: UPPER_SNAKE_CASE\n\n## Code Standards\n' + (lang === 'TypeScript' ? '- TypeScript strict mode\n- No any types\n- Explicit return types on public APIs\n' : '') + '- Prefer early returns\n- No magic numbers\n- Co-locate tests next to source\n- One component/module per file\n');
+
+      fs.writeFileSync(dir + '/security.md', '# Security Requirements\n> Auto-generated: ' + now + '\n> MVI: keep under 200 lines.\n\n## Detected Patterns\n' + (deps.zod ? '- Input validation with Zod\n' : '') + (deps.bcryptjs || deps.argon2 ? '- Password hashing\n' : '') + (deps.jsonwebtoken ? '- JWT auth\n' : deps['next-auth'] ? '- NextAuth\n' : '') + (deps.helmet ? '- Helmet headers\n' : '') + (deps.cors ? '- CORS configured\n' : '') + '\n## Universal Rules\n- Never trust user input\n- Parameterized queries only\n- Secrets in environment variables\n- .env in .gitignore\n- Auth checks on every protected route\n');
+
+      fs.writeFileSync(dir + '/examples.md', '# Code Examples\n> Auto-generated: ' + now + '\n> MVI: keep examples under 80 lines.\n\n## API Endpoint Pattern\n\`\`\`typescript\n// Follow your framework convention. Validate input, handle errors.\n\`\`\`\n\n## Component Pattern\n\`\`\`typescript\n// Follow your framework component convention.\n\`\`\`\n');
+
+      console.log('Context regenerated in ' + dir);
+    "
+    ;;
+  --clear)
+    rm -rf "$DIR"
+    echo "Context cleared. Will auto-generate on next plugin load."
+    ;;
+  *)
+    echo "Usage: /devloom-context [--show|--regenerate|--clear]"
+    echo "Context auto-generates from your codebase — no command needed."
+    ;;
+esac
+```
+
+OUT:
+- context shown, regenerated, or cleared
+- agents always auto-load context — this command is optional override only

package/commands/devloom-deepseek.md

@@ -0,0 +1,11 @@
+---
+description: "DevLoom DeepSeek: switch all agents to DeepSeek V4 Pro/Flash"
+---
+
+# DevLoom DeepSeek
+
+Switch all DevLoom agents to DeepSeek V4 models: Pro for reasoning agents, Flash for verifiers and recovery.
+
+!`PM="$HOME/.config/opencode/commands/profile.mjs"; [ -f "$PM" ] || PM="$HOME/.config/opencode/devloom-scripts/profile.mjs"; [ -f "$PM" ] || { echo "profile.mjs not found - reinstall DevLoom"; exit 1; }; node "$PM" set deepseek 2>&1; node "$PM" current 2>&1`
+
+DevLoom switched to DeepSeek V4 models. Profile applied — restart opencode (or continue with `opencode --continue`) to see the updated profile and agents in the sidebar.

package/commands/devloom-free.md

@@ -0,0 +1,11 @@
+---
+description: "DevLoom Free: switch to free models only"
+---
+
+# DevLoom Free
+
+Switch DevLoom to the free profile. Uses only available free models.
+
+!`PM="$HOME/.config/opencode/commands/profile.mjs"; [ -f "$PM" ] || PM="$HOME/.config/opencode/devloom-scripts/profile.mjs"; [ -f "$PM" ] || { echo "profile.mjs not found - reinstall DevLoom"; exit 1; }; node "$PM" set free 2>&1; node "$PM" current 2>&1`
+
+DevLoom switched to free models. Profile applied — restart opencode (or continue with `opencode --continue`) to see the updated profile and agents in the sidebar.

package/commands/devloom-go-economy.md

@@ -0,0 +1,11 @@
+---
+description: "DevLoom Go Economy: switch to cheaper OpenCode Go models"
+---
+
+# DevLoom Go Economy
+
+Switch DevLoom to the OpenCode Go economy profile. Uses cheaper Go models.
+
+!`PM="$HOME/.config/opencode/commands/profile.mjs"; [ -f "$PM" ] || PM="$HOME/.config/opencode/devloom-scripts/profile.mjs"; [ -f "$PM" ] || { echo "profile.mjs not found - reinstall DevLoom"; exit 1; }; node "$PM" set go-economy 2>&1; node "$PM" current 2>&1`
+
+DevLoom switched to OpenCode Go economy. Profile applied — restart opencode (or continue with `opencode --continue`) to see the updated profile and agents in the sidebar.

package/commands/devloom-go-flash.md

@@ -0,0 +1,11 @@
+---
+description: "DevLoom Go Flash: use DeepSeek V4 Flash for all agents"
+---
+
+# DevLoom Go Flash
+
+Switch all agents to the cheapest DeepSeek V4 Flash model.
+
+!`PM="$HOME/.config/opencode/commands/profile.mjs"; [ -f "$PM" ] || PM="$HOME/.config/opencode/devloom-scripts/profile.mjs"; [ -f "$PM" ] || { echo "profile.mjs not found - reinstall DevLoom"; exit 1; }; node "$PM" set go-flash 2>&1; node "$PM" current 2>&1`
+
+DevLoom switched to DeepSeek V4 Flash for all agents. Profile applied — restart opencode (or continue with `opencode --continue`) to see the updated profile and agents in the sidebar.

package/commands/devloom-go.md

@@ -0,0 +1,11 @@
+---
+description: "DevLoom Go: switch to OpenCode Go premium models"
+---
+
+# DevLoom Go
+
+Switch DevLoom to the OpenCode Go premium profile. Uses the highest quality Go models.
+
+!`PM="$HOME/.config/opencode/commands/profile.mjs"; [ -f "$PM" ] || PM="$HOME/.config/opencode/devloom-scripts/profile.mjs"; [ -f "$PM" ] || { echo "profile.mjs not found - reinstall DevLoom"; exit 1; }; node "$PM" set go 2>&1; node "$PM" current 2>&1`
+
+DevLoom switched to OpenCode Go premium. Profile applied — restart opencode (or continue with `opencode --continue`) to see the updated profile and agents in the sidebar.

package/commands/devloom-init.md

@@ -1,60 +1,38 @@
 ---
-description: "DevLoom Init: start fresh execution, clearing any prior state"
+description: "DevLoom Init: reset state and bootstrap project workspace"
 agent: devloom-orchestrator
 subtask: false
 ---
 
-# Force Fresh Start
+# Init
 
 ```bash
-# Create .opencode/devloom directory if not exists
-mkdir -p .opencode/devloom
-
-# Load project config — local config.json overrides global agent models
-# ALL models MUST use opencode/ API prefix (e.g. opencode/deepseek-v4-flash-free)
-if [ -f ".opencode/devloom/config.json" ]; then
-  echo "📋 Applying local model config..."
-  node -e "
-    const c = JSON.parse(require('fs').readFileSync('.opencode/devloom/config.json','utf8'));
-    const m = c.models || {};
-    for (const [agent, model] of Object.entries(m)) {
-      let finalModel = model.trim();
-      if (!finalModel.startsWith('opencode/') && !finalModel.startsWith('opencode-go/')) {
-        finalModel = 'opencode/' + finalModel;
-        console.log('  ⚠️  Added opencode/ prefix to ' + agent + ': ' + model + ' -> ' + finalModel);
-      }
-      const f = require('os').homedir() + '/.config/opencode/agents/devloom-' + agent + '.md';
-      try {
-        const fs = require('fs');
-        let content = fs.readFileSync(f, 'utf8');
-        content = content.replace(/^model:.*/m, 'model: ' + finalModel);
-        fs.writeFileSync(f, content);
-        console.log('  ' + agent + ' -> ' + finalModel);
-      } catch(e) { console.error('  Failed ' + agent + ': ' + e.message); }
-    }
-  "
-fi
-
-# Remove any existing state to force fresh start
-rm -f .opencode/devloom/state.json
-rm -f .opencode/devloom/errors.md
-
-# Clear requirement/plan files if they exist
-rm -f .opencode/devloom/requirements.md
-rm -f .opencode/devloom/plan.md
-
-echo "🔄 Clearing prior state - starting fresh"
+export INIT_PROFILE="${ARGUMENTS:-auto}"
+
+mkdir -p .opencode/devloom/project/{stories,tasks,bugs,decisions,reports}
+rm -f .opencode/devloom/state.json .opencode/devloom/errors.md .opencode/devloom/requirements.md .opencode/devloom/plan.md
+
+node -e "
+  const fs = require('fs');
+  const p = '.opencode/devloom/project';
+  const profile = process.env.INIT_PROFILE || 'auto';
+  fs.writeFileSync(p + '/README.md', '# DevLoom Project Workspace\nAll artifacts in this workspace must be written in English.\nAI-only state files use minified JSON to reduce token usage.\nUse local tracker by default. Use GitHub Project only with explicit user authorization.\nEvery new /devloom prompt is appended as the last task in project/tasks/TODO.md before execution continues.\n');
+  fs.writeFileSync(p + '/config.json', JSON.stringify({ profile: profile, v: 1, lang: 'en', tracker: 'local', gh: { enabled: false, owner: '', repo: '', project: '' }, rules: { flow: ['analysis','documentation','implementation','verification','regression','done'], tests: 'required', regression: 'required', queue: 'single', docs: 'official', delegation: 'required', skills: 'required', memory: 'load', save: 'always', promptTask: 'append-last' } }));
+  fs.writeFileSync(p + '/board.json', JSON.stringify({ v: 1, tracker: 'local', active: '', cols: { backlog: [], ready: [], doing: [], review: [], blocked: [], done: [] }, updatedAt: '' }));
+  fs.writeFileSync(p + '/state.json', JSON.stringify({ v: 1, phase: 'idle', prompt: '', ticket: '', next: 'analysis', updatedAt: '', notes: [] }));
+  fs.writeFileSync(p + '/tasks/TODO.md', '# DevLoom Prompt Tasks\nEvery /devloom prompt is appended here as the last todo before execution routing.\n');
+"
+
+PROFILE_MJS="$(node -e 'const fs=require("fs"),p=require("path");console.log(p.join(p.dirname(fs.realpathSync(process.argv[1])),"profile.mjs"))' "$0" 2>/dev/null)"
+[ -f "$PROFILE_MJS" ] || PROFILE_MJS="$HOME/.config/opencode/devloom-scripts/profile.mjs"
+[ -f "$PROFILE_MJS" ] || PROFILE_MJS="$HOME/.config/opencode/commands/profile.mjs"
+[ -f "$PROFILE_MJS" ] || { echo "profile.mjs not found - reinstall DevLoom"; exit 1; }
+node "$PROFILE_MJS" set "$INIT_PROFILE" 2>&1
+touch .opencode/devloom/project/stories/.keep .opencode/devloom/project/tasks/.keep .opencode/devloom/project/bugs/.keep .opencode/devloom/project/decisions/.keep .opencode/devloom/project/reports/.keep
 ```
 
-# Fresh DevLoom Orchestration
-
-$ARGUMENTS
-
-IMPORTANT: Run full workflow from PHASE 0.
+# Run
 
-1. Run PHASE 0 — detect models, ask user preference, update agent files
-2. Invoke @devloom-analyst to create requirements
-3. Invoke @devloom-architect to create plan
-4. Loop through every task: developer → QA → (fix if needed) → mark [x]
-5. Invoke @devloom-documenter and run final quality gate
-6. Output DEVLOOM_DONE only when all tasks are [x] and build passes
+LOAD: `.opencode/devloom/project/config.json|board.json|state.json`
+FLOW: Triage>MinimalChain>Verify>Regr>Done
+RULES: EnglishOnly|SingleActive|PersistAll|TDDReq|RegrReq

package/commands/devloom-loop-status.md

@@ -0,0 +1,25 @@
+# DevLoom Loop Status Command
+> /devloom-loop-status
+
+## Usage
+- `/devloom-loop-status` — Show loop health, recent runs, budget status
+
+## Output
+- Active pattern and cadence
+- Last run timestamp and outcome
+- Next scheduled run
+- Budget: spent/limit, remaining, reset time
+- Run count and success rate
+- Paused status with reason if applicable
+- Last 5 run log entries summary
+
+## Example output
+```
+Loop: daily-triage (L1)
+Cadence: 0 6 * * *
+Status: active
+Last run: 2026-07-08T06:00:00Z (success)
+Budget: 50000/500000 (450000 remaining, resets at midnight)
+Run count: 12 (100% success)
+Last 5: all success
+```

package/commands/devloom-loop.md

@@ -0,0 +1,36 @@
+# DevLoom Loop Command
+> /devloom-loop start [pattern]|stop|status [--cadence <cron>] [--level L1|L2|L3] [--mode audit|fix] [--url <urls>]
+
+## Usage
+- `/devloom-loop start` — Start default loop (daily-triage, cadence "0 6 * * *", level L1)
+- `/devloom-loop start ci-sweeper` — Start ci-sweeper (default cadence "0 6 * * *", level L1)
+- `/devloom-loop start ci-sweeper --cadence "*/10 * * * *" --level L2` — Start with explicit config
+- `/devloom-loop start pr-babysitter --cadence "*/15 * * * *" --level L2`
+- `/devloom-loop start design-audit --mode audit --url "https://example.com"` — Run full audit (UI + functional: broken actions, missing actions, dead-ends, API issues), L1 report-only
+- `/devloom-loop start design-audit --mode audit --url "https://site.com/page1,https://site.com/page2"` — Audit multiple pages
+- `/devloom-loop start design-audit --mode fix` — Run fix loop (L2, worktree+verifier, run-until-done) — fixes both UI + functional issues, loops until all verified
+- `/devloom-loop stop` — Pause all loop patterns
+- `/devloom-loop status` — Show loop health, run history, budget
+
+## What it does
+1. Reads/creates loop-config.json with the specified pattern, cadence, level
+2. Sets up budget.json with default daily limit 500K tokens
+3. Logs the command to run-log.json
+4. Outputs the cron/systemd timer command for the cadence
+
+## Cron setup
+To schedule the loop, add to crontab:
+```
+# DevLoom loop: daily-triage at 6 AM daily (pattern defaults to daily-triage)
+0 6 * * * cd /path/to/repo && node scripts/loop-run.mjs --pattern daily-triage --cadence "0 6 * * *" --level L1 >> .opencode/devloom/loop/cron.log 2>&1
+```
+
+Simplified form (defaults to daily-triage, "0 0 * * *", L1):
+```
+0 0 * * * cd /path/to/repo && node scripts/loop-run.mjs >> .opencode/devloom/loop/cron.log 2>&1
+```
+
+## Output
+- Loop started/stopped confirmation
+- Cron command to schedule
+- Budget status

package/commands/devloom-mimo.md

@@ -0,0 +1,11 @@
+---
+description: "DevLoom MiMo: switch all agents to MiMo V2.6 Flash (multimodal all-role stack)"
+---
+
+# DevLoom MiMo
+
+Switch every DevLoom agent — including vision, visual-director, and visual-critic — to the first available MiMo V2.6 Flash model. Candidate chain (no hardcoded provider): `mimo/mimo-v2.6-flash` → `xiaomi/mimo-v2.6-flash` → `opencode-go/mimo-v2.6-flash`, resolved against `opencode models`. Tier overrides are locked for this profile.
+
+!`PM="$HOME/.config/opencode/commands/profile.mjs"; [ -f "$PM" ] || PM="$HOME/.config/opencode/devloom-scripts/profile.mjs"; [ -f "$PM" ] || { echo "profile.mjs not found - reinstall DevLoom"; exit 1; }; node "$PM" set mimo 2>&1; node "$PM" current 2>&1`
+
+If no MiMo V2.6 Flash candidate is available the profile is NOT activated and the attempted candidates are printed — no unrelated substitution. On success: profile applied — restart opencode (or continue with `opencode --continue`) to see the updated profile and agents in the sidebar.

package/commands/devloom-plan.md

@@ -0,0 +1,13 @@
+---
+description: "DevLoom Plan: show current profile and resolved models"
+---
+
+# DevLoom Plan
+
+Show the current DevLoom profile, resolved models, overrides, and any fallbacks.
+
+!`PM="$HOME/.config/opencode/commands/profile.mjs"; [ -f "$PM" ] || PM="$HOME/.config/opencode/devloom-scripts/profile.mjs"; [ -f "$PM" ] || { echo "profile.mjs not found - reinstall DevLoom"; exit 1; }; node "$PM" current 2>&1; echo ""; echo "--- Validation ---"; node "$PM" validate 2>&1 || echo "Some models may be unavailable. Run /devloom-auto to re-detect."`
+
+Current profile shown above.
+
+Profile applied — restart opencode (or continue with `opencode --continue`) to see the updated profile and agents in the sidebar.

package/commands/devloom-refresh.md

@@ -0,0 +1,22 @@
+---
+description: "DevLoom Refresh: reinstall global assets and refresh the OpenCode plugin cache"
+---
+
+# DevLoom Refresh
+
+Re-syncs DevLoom's installed agents/commands/skills and refreshes the OpenCode
+plugin cache so the current profile and all DevLoom agents show correctly in the
+OpenCode sidebar. The refresh **rebuilds dist/ from source first** (`npm run
+build`, best-effort), so the cache always receives freshly compiled plugin code —
+never a stale build.
+
+Run this after updating DevLoom (`npm install -g devloom`) or whenever the
+sidebar does not reflect the profile you switched to.
+
+!`DEVLOOM_ROOT="$(npm root -g 2>/dev/null)/devloom"; if [ ! -d "$DEVLOOM_ROOT" ]; then echo "DevLoom global package not found. Install it first: npm install -g devloom"; exit 1; fi; node "$DEVLOOM_ROOT/postinstall.mjs" 2>&1; PM="$HOME/.config/opencode/commands/profile.mjs"; [ -f "$PM" ] || PM="$HOME/.config/opencode/devloom-scripts/profile.mjs"; [ -f "$PM" ] || PM="$HOME/.config/opencode/commands/profile.mjs"; [ -f "$PM" ] || { echo "profile.mjs not found - reinstall DevLoom"; exit 1; }; node "$PM" apply 2>&1`
+
+DevLoom assets are re-synced and the OpenCode plugin cache now contains the
+current plugin code (the config hook that surfaces the profile and agents).
+
+Restart opencode (or continue with `opencode --continue`) to see the updated
+profile and agents in the sidebar.

package/commands/devloom-resume.md

@@ -1,58 +1,39 @@
 ---
-description: "Resume DevLoom from last execution point"
+description: "Resume DevLoom from saved state"
 agent: devloom-orchestrator
 subtask: false
 ---
 
-# Initialize & Dashboard Setup
+# Resume
 
 ```bash
-# Load project config — local config.json overrides global agent models
-# ALL models MUST use opencode/ API prefix (e.g. opencode/deepseek-v4-flash-free)
-if [ -f ".opencode/devloom/config.json" ]; then
-  echo "📋 Applying local model config..."
-  node -e "
-    const c = JSON.parse(require('fs').readFileSync('.opencode/devloom/config.json','utf8'));
-    const m = c.models || {};
-    for (const [agent, model] of Object.entries(m)) {
-      let finalModel = model.trim();
-      if (!finalModel.startsWith('opencode/') && !finalModel.startsWith('opencode-go/')) {
-        finalModel = 'opencode/' + finalModel;
-        console.log('  ⚠️  Added opencode/ prefix to ' + agent + ': ' + model + ' -> ' + finalModel);
-      }
-      const f = require('os').homedir() + '/.config/opencode/agents/devloom-' + agent + '.md';
-      try {
-        const fs = require('fs');
-        let content = fs.readFileSync(f, 'utf8');
-        content = content.replace(/^model:.*/m, 'model: ' + finalModel);
-        fs.writeFileSync(f, content);
-        console.log('  ' + agent + ' -> ' + finalModel);
-      } catch(e) { console.error('  Failed ' + agent + ': ' + e.message); }
-    }
-  "
-fi
-
-# Check state file
-STATE_FILE=".opencode/devloom/state.json"
-
-if [ -f "$STATE_FILE" ]; then
-  PHASE=$(grep -o '"phase":"[^"]*"' "$STATE_FILE" | cut -d'"' -f4)
-  echo "Resuming from $PHASE"
-else
-  echo "No execution state found. Use /devloom [prompt] to start new execution."
-  exit 1
-fi
+mkdir -p .opencode/devloom/project/{stories,tasks,bugs,decisions,reports}
+test -f .opencode/devloom/state.json || { echo "No execution state found."; exit 1; }
+test -f .opencode/devloom/project/board.json || { echo "Project board missing. Run /devloom-init first."; exit 1; }
+node -e "
+  const fs = require('fs');
+  const p = '.opencode/devloom/project';
+  const readJson = (f, fb) => {
+    try { return JSON.parse(fs.readFileSync(f, 'utf8')); } catch { return fb; }
+  };
+  const cfg = readJson(p + '/config.json', {});
+  const board = readJson(p + '/board.json', {});
+  const state = readJson(p + '/state.json', {});
+  const now = new Date().toISOString();
+  fs.writeFileSync(p + '/README.md', '# DevLoom Project Workspace\\nAll artifacts in this workspace must be written in English.\\nAI-only state files use minified JSON to reduce token usage.\\n');
+  fs.writeFileSync(p + '/config.json', JSON.stringify({ v: 1, lang: 'en', tracker: cfg.tracker === 'github' ? 'github' : 'local', gh: { enabled: !!cfg.gh?.enabled, owner: cfg.gh?.owner || '', repo: cfg.gh?.repo || '', project: cfg.gh?.project || '' }, rules: { flow: ['analysis','documentation','implementation','verification','regression','done'], tests: 'required', regression: 'required', queue: 'single', docs: 'official', delegation: 'required', skills: 'required', memory: 'load', save: 'always', promptTask: 'append-last' } }));
+  fs.writeFileSync(p + '/board.json', JSON.stringify({ v: 1, tracker: cfg.tracker === 'github' ? 'github' : 'local', active: board.active || '', cols: { backlog: Array.isArray(board.cols?.backlog) ? board.cols.backlog : [], ready: Array.isArray(board.cols?.ready) ? board.cols.ready : [], doing: Array.isArray(board.cols?.doing) ? board.cols.doing.slice(0, 1) : (board.active ? [board.active] : []), review: Array.isArray(board.cols?.review) ? board.cols.review : [], blocked: Array.isArray(board.cols?.blocked) ? board.cols.blocked : [], done: Array.isArray(board.cols?.done) ? board.cols.done : [] }, updatedAt: now }));
+  fs.writeFileSync(p + '/state.json', JSON.stringify({ v: 1, phase: typeof state.phase === 'string' ? state.phase : 'idle', prompt: typeof state.prompt === 'string' ? state.prompt : '', ticket: typeof state.ticket === 'string' ? state.ticket : (board.active || ''), next: typeof state.next === 'string' ? state.next : 'analysis', updatedAt: now, notes: Array.isArray(state.notes) ? state.notes : [] }));
+"
 ```
 
-# Resume DevLoom Orchestration
-
-RESUME MODE ACTIVE: Execute PRE-PHASE 0 resume detection.
-
-1. Check for existing `.opencode/devloom/state.json`
-2. If found: Load phase, completedPhases, tasks.completed, requirements, plan
-3. Skip all completed phases
-4. Jump to next pending phase
-5. Resume execution from that point with existing models and configuration
-6. Do NOT run PHASE 0 (model selection) during resume
-
-Execute all remaining tasks until complete, then PHASE 3 delivery and quality gate.
+LOAD: `.opencode/devloom/state.json|.opencode/devloom/project/board.json|.opencode/devloom/project/state.json`
+MODE: Resume
+RULES:
+- skip completed phases
+- keep existing config/models
+- normalize legacy project files before resume
+- reload memory and relevant skills before continuing work
+- continue from the saved ticket/todo/plan state
+- if state.phase == "queued": dequeue the next item from board.cols.backlog into board.cols.doing, set phase to the item's saved phase, and resume
+- continue active/pending ticket first (if no queued items)

package/commands/devloom-save.md

@@ -0,0 +1,69 @@
+---
+description: "DevLoom: persist current project state and pause"
+agent: devloom-orchestrator
+subtask: false
+---
+
+# Save
+
+```bash
+mkdir -p .opencode/devloom/project/{stories,tasks,bugs,decisions,reports}
+
+node -e "
+  const fs = require('fs');
+  const p = '.opencode/devloom/project';
+  const readJson = (f, fb) => {
+    try { return JSON.parse(fs.readFileSync(f, 'utf8')); } catch { return fb; }
+  };
+  const cfg = readJson(p + '/config.json', {});
+  const board = readJson(p + '/board.json', {});
+  const state = readJson(p + '/state.json', {});
+  const now = new Date().toISOString();
+  const next = {
+    v: 1,
+    phase: state.phase || 'paused',
+    prompt: state.prompt || '',
+    ticket: state.ticket || board.active || '',
+    next: 'user-command',
+    updatedAt: now,
+    notes: Array.isArray(state.notes) ? state.notes : []
+  };
+  const normalizedCfg = {
+    v: 1,
+    lang: 'en',
+    tracker: cfg.tracker === 'github' ? 'github' : 'local',
+    gh: {
+      enabled: !!cfg.gh?.enabled,
+      owner: cfg.gh?.owner || '',
+      repo: cfg.gh?.repo || '',
+      project: cfg.gh?.project || ''
+    },
+    rules: { flow: ['analysis','documentation','implementation','verification','regression','done'], tests: 'required', regression: 'required', queue: 'single', docs: 'official', delegation: 'required', skills: 'required', memory: 'load', save: 'always', promptTask: 'append-last' }
+  };
+  fs.writeFileSync(p + '/config.json', JSON.stringify(normalizedCfg));
+  fs.writeFileSync(p + '/board.json', JSON.stringify({
+    v: 1,
+    tracker: normalizedCfg.tracker,
+    active: board.active || next.ticket || '',
+    cols: {
+      backlog: Array.isArray(board.cols?.backlog) ? board.cols.backlog : [],
+      ready: Array.isArray(board.cols?.ready) ? board.cols.ready : [],
+      doing: Array.isArray(board.cols?.doing) ? board.cols.doing.slice(0, 1) : (board.active ? [board.active] : []),
+      review: Array.isArray(board.cols?.review) ? board.cols.review : [],
+      blocked: Array.isArray(board.cols?.blocked) ? board.cols.blocked : [],
+      done: Array.isArray(board.cols?.done) ? board.cols.done : []
+    },
+    updatedAt: now
+  }));
+  fs.writeFileSync(p + '/state.json', JSON.stringify(next));
+  fs.writeFileSync(p + '/README.md', '# DevLoom Project Workspace\\nAll artifacts in this workspace must be written in English.\\nAI-only state files use minified JSON to reduce token usage.\\n');
+"
+```
+
+MODE: Pause
+LOAD: `.opencode/devloom/project/config.json|board.json|state.json`
+OUT:
+- state persisted
+- ticket/todo/plan context preserved for the next prompt
+- next=user-command
+- resume with `/devloom-resume` or new `/devloom ...` prompt

package/commands/devloom-status.md

@@ -1,23 +1,14 @@
 ---
-description: "DevLoom: show the current weaving progress — tasks done, in progress, and any errors"
+description: "DevLoom: show progress, active ticket, and phase"
 agent: devloom-orchestrator
 subtask: false
 ---
 
-# Setup
-
-```bash
-mkdir -p .opencode/devloom
-```
-
-# Status Report
-
-Read `.opencode/devloom/plan.md` and `.opencode/devloom/errors.md` (if they exist) and report:
-
-1. **Progress**: total tasks, completed ([x]), pending ([ ]), completion percentage
-2. **Current task**: the first unchecked task in `.opencode/devloom/plan.md` (if any)
-3. **Errors**: any failed or skipped tasks listed in `.opencode/devloom/errors.md`
-4. **Phase**: which phase the weave is in (Planning / Weaving / Documenting / Done)
-
-Format the output as a clean status report. If `.opencode/devloom/plan.md` does not exist,
-report that no weaving session has been started yet.
+LOAD: `.opencode/devloom/plan.md|.opencode/devloom/errors.md|.opencode/devloom/project/board.json|.opencode/devloom/project/state.json`
+REPORT:
+- progress: total|done|pending|pct
+- active: current ticket (in doing)
+- queued: count of items in backlog (waiting behind active work)
+- blocked: blocked tickets
+- errors: failed/skipped work
+- phase: analysis|documentation|implementation|verification|regression|queued|done