devloom 1.1.0 → 1.2.0

package/GUIDE.md

@@ -29,7 +29,7 @@ and skill files to your OpenCode global config directory:
 | OS | Config directory |
 |---|---|
 | Linux | `~/.config/opencode/` |
-| macOS | `~/Library/Application Support/opencode/` |
+| macOS | `~/.config/opencode/` |
 | Windows | `%APPDATA%\opencode\` |
 
 Expected output:
@@ -58,7 +58,7 @@ Installing commands (17 total):
   - /devloom, /devloom-init, /devloom-status, /devloom-resume
   - /devloom-save, /devloom-agents
   - /devloom-go, /devloom-go-economy, /devloom-go-flash, /devloom-deepseek
-  - /devloom-mimo, /devloom-free, /devloom-auto
+  - /devloom-mimo, /devloom-deepseek-mimo, /devloom-free, /devloom-auto
   - /devloom-plan, /devloom-context, /devloom-loop, /devloom-loop-status
 
 Installing skills (21 total):
@@ -128,6 +128,7 @@ Start OpenCode and open the command palette by typing `/`:
 /devloom-go-economy  → Switch to Go economy profile
 /devloom-go-flash    → Switch to Go flash profile (cheapest paid)
 /devloom-mimo        → Switch to the MiMo V2.6 Flash profile (multimodal all-role stack)
+/devloom-deepseek-mimo → Switch to the hybrid profile (DeepSeek V4.1 general, MiMo V2.6 visual)
 /devloom-free        → Switch to free-tier profile
 /devloom-auto        → Auto-detect best profile for your environment
 /devloom-loop        → Start/stop loop engineering patterns
@@ -176,6 +177,7 @@ DevLoom provides model profiles that trade off quality vs cost:
 | `deepseek` | DeepSeek-only stack | Go (paid) |
 | `glm` | GLM-only stack | Go (paid) |
 | `go-flash` | Maximum throughput, minimum cost | Go (paid) |
+| `deepseek-mimo` | Fast general work (DeepSeek V4.1), MiMo V2.6 for graphical/complex roles | Go (paid) |
 | `mimo` | Multimodal all-role stack incl. vision | Go/MiMo |
 | `free` | Zero-cost experimentation | Free |
 
@@ -604,6 +606,28 @@ without starting a weave:
 
 ---
 
+## Incremental Briefing (token savings)
+
+Sub-agents must not re-read the same files on every dispatch. DevLoom solves
+this with a per-ticket briefing plus change-based invalidation:
+
+- **Ticket start:** the orchestrator runs `briefing.mjs init <ticket>` and
+  writes `.opencode/devloom/context/briefing.md` ONCE (goal, constraints,
+  file map with `file:line` refs, decisions).
+- **Every `task()` prompt** starts with `Read .opencode/devloom/context/briefing.md
+  first — do not re-discover` — sub-agents start from the map instead of
+  scanning the repo. A stable prompt prefix also gets provider prompt-caching.
+- **Before each later dispatch:** `briefing.mjs changed` prints only the paths
+  whose content fingerprints differ from the last anchor (sha256, recorded at
+  `init`/`touch` — works inside or outside git and never re-flags a file that
+  was already re-read). The orchestrator re-reads ONLY those, patches the
+  briefing, runs `briefing.mjs touch`, and dispatches. Unchanged files are
+  never re-read.
+
+Script discovery uses the same fallback chain as `profile.mjs`:
+`~/.config/opencode/commands/briefing.mjs` → `~/.config/opencode/devloom-scripts/briefing.mjs`
+→ `scripts/briefing.mjs`.
+
 ## Visual Pipeline
 
 For substantial graphical work, DevLoom routes through an extra visual loop:

package/README.md

@@ -114,6 +114,18 @@ npm install -g devloom
 npm install -g https://github.com/nsrau/devloom.git
 ```
 
+**From GitHub Packages** (mirror `@nsrau/devloom`):
+
+```bash
+# ~/.npmrc
+@nsrau:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=<TOKEN>   # PAT/granular token with read:packages
+```
+
+```bash
+npm install -g @nsrau/devloom
+```
+
 **From source:**
 
 ```bash
@@ -349,6 +361,7 @@ maps every agent to a specific model optimized for its role.
 | **free** | Good | Zero | Evaluation, learning, hobby projects |
 | **glm** | High | Lower | GLM-only stack |
 | **mimo** | High | Low/Fast | MiMo V2.6 multimodal all-role stack |
+| **deepseek-mimo** | High | Fast | DeepSeek V4.1 general + MiMo V2.6 graphical/complex hybrid |
 
 ### go profile (max quality)
 
@@ -482,6 +495,18 @@ same-family fallback such as `mimo-v2.6-pro` is allowed but always reported
 under "Fallbacks applied"). Tier overrides are locked for `mimo` (like
 `go-flash` and `free`). Switch with `/devloom-mimo` (`profile.mjs set mimo`).
 
+### deepseek-mimo profile (hybrid)
+
+Fast everyday work on DeepSeek V4.1, graphical/complex work on MiMo V2.6.
+The 7 general roles (orchestrator, planner, developer, qa, verifier, security,
+documenter) resolve to `opencode-go/deepseek-v4.1-flash`; vision,
+visual-director, and visual-critic resolve through the
+`mimo/mimo-v2.6-flash` → `xiaomi/mimo-v2.6-flash` → `opencode-go/mimo-v2.6-flash`
+chain. Both chains resolve strictly — if either finds nothing the profile exits
+code 1 with the attempted candidates, never an unrelated substitution. Tier
+overrides are allowed (deepseek pattern). Switch with
+`/devloom-deepseek-mimo` (`profile.mjs set deepseek-mimo`).
+
 ### Model-routing table (go)
 
 Each of the 10 agents is assigned a model optimized for its role:
@@ -553,6 +578,7 @@ source first so the cache never receives stale compiled code.
   variants are hidden for every profile. The variants stay registered so
   orchestrator `task()` routing keeps working; they are simply not listed.
 - Switching profiles (`/devloom-go`, `/devloom-go-flash`, `/devloom-mimo`,
+  `/devloom-deepseek-mimo`,
   `/devloom-free`, ...)
   updates the installed agent files immediately; restart opencode to see the
   updated profile and models in the sidebar.

package/agents/devloom-developer-flash.md

@@ -6,12 +6,16 @@ permission:
   edit: allow
   bash: allow
   task: deny
+  external_directory:
+    "~/.config/opencode/**": allow
 ---
 
 # DevLoom Developer Flash
 
 ENGLISH ONLY: All output MUST be in English. Never use any other language.
 
+BEFORE SCANNING: if `.opencode/devloom/context/briefing.md` exists, read it FIRST and start from its file map — never re-read files it already summarizes.
+
 COMPLIANCE: Follow the RULES below + your skill LOAD. No rule may be skipped.
 RULES: EN | SOLID+TDD+CleanArch | tests+regr required | doing<=1 | FILES: use .opencode/devloom/.tmp/ | peer-review for high-risk | degrade on 2x failure
 LOAD: ~/.config/opencode/skills/build/development.md|~/.config/opencode/skills/build/simplify.md

package/agents/devloom-developer-senior.md

@@ -6,12 +6,16 @@ permission:
   edit: allow
   bash: allow
   task: deny
+  external_directory:
+    "~/.config/opencode/**": allow
 ---
 
 # DevLoom Developer Senior
 
 ENGLISH ONLY: All output MUST be in English. Never use any other language.
 
+BEFORE SCANNING: if `.opencode/devloom/context/briefing.md` exists, read it FIRST and start from its file map — never re-read files it already summarizes.
+
 COMPLIANCE: Follow the RULES below + your skill LOAD. No rule may be skipped.
 RULES: EN | SOLID+TDD+CleanArch | tests+regr required | doing<=1 | FILES: use .opencode/devloom/.tmp/ | peer-review for high-risk | degrade on 2x failure
 LOAD: ~/.config/opencode/skills/build/development.md|~/.config/opencode/skills/build/simplify.md

package/agents/devloom-developer.md

@@ -6,12 +6,16 @@ permission:
   edit: allow
   bash: allow
   task: deny
+  external_directory:
+    "~/.config/opencode/**": allow
 ---
 
 # DevLoom Developer
 
 ENGLISH ONLY: All output MUST be in English. Never use any other language.
 
+BEFORE SCANNING: if `.opencode/devloom/context/briefing.md` exists, read it FIRST and start from its file map — never re-read files it already summarizes.
+
 COMPLIANCE: Follow the RULES below + your skill LOAD. No rule may be skipped.
 RULES: EN | SOLID+TDD+CleanArch | tests+regr required | doing<=1 | FILES: use .opencode/devloom/.tmp/ | peer-review for high-risk | degrade on 2x failure
 LOAD: ~/.config/opencode/skills/build/development.md|~/.config/opencode/skills/build/simplify.md

package/agents/devloom-documenter-flash.md

@@ -6,12 +6,16 @@ permission:
   edit: allow
   bash: allow
   task: deny
+  external_directory:
+    "~/.config/opencode/**": allow
 ---
 
 # DevLoom Documenter Flash
 
 ENGLISH ONLY: All output MUST be in English. Never use any other language.
 
+BEFORE SCANNING: if `.opencode/devloom/context/briefing.md` exists, read it FIRST and start from its file map — never re-read files it already summarizes.
+
 COMPLIANCE: Follow the RULES below + your skill LOAD. No rule may be skipped.
 RULES: EN | SOLID+TDD+CleanArch | tests+regr required | doing<=1 | FILES: use .opencode/devloom/.tmp/ | peer-review for high-risk | degrade on 2x failure
 LOAD: ~/.config/opencode/skills/ship/documentation.md

package/agents/devloom-documenter.md

@@ -6,12 +6,16 @@ permission:
   edit: allow
   bash: allow
   task: deny
+  external_directory:
+    "~/.config/opencode/**": allow
 ---
 
 # DevLoom Documenter
 
 ENGLISH ONLY: All output MUST be in English. Never use any other language.
 
+BEFORE SCANNING: if `.opencode/devloom/context/briefing.md` exists, read it FIRST and start from its file map — never re-read files it already summarizes.
+
 COMPLIANCE: Follow the RULES below + your skill LOAD. No rule may be skipped.
 RULES: EN | SOLID+TDD+CleanArch | tests+regr required | doing<=1 | FILES: use .opencode/devloom/.tmp/ | peer-review for high-risk | degrade on 2x failure
 LOAD: ~/.config/opencode/skills/ship/documentation.md

package/agents/devloom-orchestrator.md

@@ -12,6 +12,8 @@ permission:
   bash: allow
   glob: allow
   grep: allow
+  external_directory:
+    "~/.config/opencode/**": allow
 ---
 
 # DevLoom Orchestrator
@@ -103,6 +105,8 @@ TIER DEGRADATION: If a sub-agent fails twice consecutively (timeout, rate-limit,
 
 ARCHITECTURE ATLAS: Before delegating to any sub-agent, check if `.opencode/devloom/context/atlas.md` exists. If it does, pass the `ATLAS:` section to sub-agents so they understand the codebase structure without scanning files. The atlas is auto-generated by the plugin.
 
+INCREMENTAL BRIEFING (never re-read unchanged files): On ticket start, locate `briefing.mjs` with the profile.mjs fallback chain (`~/.config/opencode/commands/briefing.mjs`, else `~/.config/opencode/devloom-scripts/briefing.mjs`, else `scripts/briefing.mjs`) and run `init <ticket>`, then write `.opencode/devloom/context/briefing.md` ONCE (goal, constraints, file map with file:line refs, decisions) — read each file only while building it. Start EVERY task() prompt with: `Read .opencode/devloom/context/briefing.md first — do not re-discover; read other files only for code-level detail beyond it.` Before each subsequent dispatch run `changed`: re-read ONLY the printed paths, patch the briefing, run `touch`, then dispatch. Files not listed must never be re-read; pass the briefing path (not file contents) to keep prompts stable for provider prompt-caching.
+
 VISUAL PIPELINE (UI work with VISUAL_REQUIRED=true only):
 1. visual-director FIRST: `task(subagent_type: "devloom-visual-director", ...)` — emits a `DESIGN_FILE` markdown block (tokens: colors, type, spacing, layout, motion, components).
 2. PERSIST DESIGN: you write the DESIGN_FILE body to `.opencode/devloom/context/design.md` (bash is allowed for this persistence). Pass that file's content as `DESIGN_CONTRACT:` to planner (if planning) and to every developer/critic delegation in the chain.

package/agents/devloom-planner-flash.md

@@ -6,12 +6,16 @@ permission:
   edit: allow
   bash: allow
   task: deny
+  external_directory:
+    "~/.config/opencode/**": allow
 ---
 
 # DevLoom Planner Flash
 
 ENGLISH ONLY: All output MUST be in English. Never use any other language.
 
+BEFORE SCANNING: if `.opencode/devloom/context/briefing.md` exists, read it FIRST and start from its file map — never re-read files it already summarizes.
+
 COMPLIANCE: Follow the RULES below + your skill LOAD. No rule may be skipped.
 RULES: EN | SOLID+TDD+CleanArch | tests+regr required | doing<=1 | FILES: use .opencode/devloom/.tmp/ | peer-review for high-risk | degrade on 2x failure
 LOAD: ~/.config/opencode/skills/plan/planning.md|~/.config/opencode/skills/plan/verification-planning.md

package/agents/devloom-planner-senior.md

@@ -6,12 +6,16 @@ permission:
   edit: allow
   bash: allow
   task: deny
+  external_directory:
+    "~/.config/opencode/**": allow
 ---
 
 # DevLoom Planner Senior
 
 ENGLISH ONLY: All output MUST be in English. Never use any other language.
 
+BEFORE SCANNING: if `.opencode/devloom/context/briefing.md` exists, read it FIRST and start from its file map — never re-read files it already summarizes.
+
 COMPLIANCE: Follow the RULES below + your skill LOAD. No rule may be skipped.
 RULES: EN | SOLID+TDD+CleanArch | tests+regr required | doing<=1 | FILES: use .opencode/devloom/.tmp/ | peer-review for high-risk | degrade on 2x failure
 LOAD: ~/.config/opencode/skills/plan/planning.md|~/.config/opencode/skills/plan/verification-planning.md

package/agents/devloom-planner.md

@@ -6,12 +6,16 @@ permission:
   edit: allow
   bash: allow
   task: deny
+  external_directory:
+    "~/.config/opencode/**": allow
 ---
 
 # DevLoom Planner
 
 ENGLISH ONLY: All output MUST be in English. Never use any other language.
 
+BEFORE SCANNING: if `.opencode/devloom/context/briefing.md` exists, read it FIRST and start from its file map — never re-read files it already summarizes.
+
 COMPLIANCE: Follow the RULES below + your skill LOAD. No rule may be skipped.
 RULES: EN | SOLID+TDD+CleanArch | tests+regr required | doing<=1 | FILES: use .opencode/devloom/.tmp/ | peer-review for high-risk | degrade on 2x failure
 LOAD: ~/.config/opencode/skills/plan/planning.md|~/.config/opencode/skills/plan/verification-planning.md

package/agents/devloom-qa-flash.md

@@ -6,12 +6,16 @@ permission:
   edit: allow
   bash: allow
   task: deny
+  external_directory:
+    "~/.config/opencode/**": allow
 ---
 
 # DevLoom QA Flash
 
 ENGLISH ONLY: All output MUST be in English. Never use any other language.
 
+BEFORE SCANNING: if `.opencode/devloom/context/briefing.md` exists, read it FIRST and start from its file map — never re-read files it already summarizes.
+
 COMPLIANCE: Follow the RULES below + your skill LOAD. No rule may be skipped.
 RULES: EN | SOLID+TDD+CleanArch | tests+regr required | doing<=1 | FILES: use .opencode/devloom/.tmp/ | peer-review for high-risk | degrade on 2x failure
 LOAD: ~/.config/opencode/skills/verify/quality-assurance.md|~/.config/opencode/skills/build/simplify.md

package/agents/devloom-qa.md

@@ -6,12 +6,16 @@ permission:
   edit: allow
   bash: allow
   task: deny
+  external_directory:
+    "~/.config/opencode/**": allow
 ---
 
 # DevLoom QA
 
 ENGLISH ONLY: All output MUST be in English. Never use any other language.
 
+BEFORE SCANNING: if `.opencode/devloom/context/briefing.md` exists, read it FIRST and start from its file map — never re-read files it already summarizes.
+
 COMPLIANCE: Follow the RULES below + your skill LOAD. No rule may be skipped.
 RULES: EN | SOLID+TDD+CleanArch | tests+regr required | doing<=1 | FILES: use .opencode/devloom/.tmp/ | peer-review for high-risk | degrade on 2x failure
 LOAD: ~/.config/opencode/skills/verify/quality-assurance.md|~/.config/opencode/skills/build/simplify.md

package/agents/devloom-security-senior.md

@@ -6,12 +6,16 @@ permission:
   edit: allow
   bash: allow
   task: deny
+  external_directory:
+    "~/.config/opencode/**": allow
 ---
 
 # DevLoom Security Senior
 
 ENGLISH ONLY: All output MUST be in English. Never use any other language.
 
+BEFORE SCANNING: if `.opencode/devloom/context/briefing.md` exists, read it FIRST and start from its file map — never re-read files it already summarizes.
+
 COMPLIANCE: Follow the RULES below + your skill LOAD. No rule may be skipped.
 RULES: EN | SOLID+TDD+CleanArch | tests+regr required | doing<=1 | FILES: use .opencode/devloom/.tmp/ | peer-review for high-risk | degrade on 2x failure
 LOAD: ~/.config/opencode/skills/review/security-review.md

package/agents/devloom-security.md

@@ -6,12 +6,16 @@ permission:
   edit: allow
   bash: allow
   task: deny
+  external_directory:
+    "~/.config/opencode/**": allow
 ---
 
 # DevLoom Security
 
 ENGLISH ONLY: All output MUST be in English. Never use any other language.
 
+BEFORE SCANNING: if `.opencode/devloom/context/briefing.md` exists, read it FIRST and start from its file map — never re-read files it already summarizes.
+
 COMPLIANCE: Follow the RULES below + your skill LOAD. No rule may be skipped.
 RULES: EN | SOLID+TDD+CleanArch | tests+regr required | doing<=1 | FILES: use .opencode/devloom/.tmp/ | peer-review for high-risk | degrade on 2x failure
 LOAD: ~/.config/opencode/skills/review/security-review.md

package/agents/devloom-verifier.md

@@ -6,12 +6,16 @@ permission:
   edit: allow
   bash: allow
   task: deny
+  external_directory:
+    "~/.config/opencode/**": allow
 ---
 
 # DevLoom Verifier
 
 ENGLISH ONLY: All output MUST be in English. Never use any other language.
 
+BEFORE SCANNING: if `.opencode/devloom/context/briefing.md` exists, read it FIRST and start from its file map — never re-read files it already summarizes.
+
 COMPLIANCE: Follow the RULES below + your skill LOAD. No rule may be skipped.
 RULES: EN | SOLID+TDD+CleanArch | tests+regr required | doing<=1 | FILES: use .opencode/devloom/.tmp/ | peer-review for high-risk | degrade on 2x failure
 LOAD: ~/.config/opencode/skills/verify/app-verification.md

package/agents/devloom-vision.md

@@ -12,12 +12,16 @@ permission:
   grep: deny
   webfetch: deny
   task: deny
+  external_directory:
+    "~/.config/opencode/**": allow
 ---
 
 # DevLoom Vision
 
 ENGLISH ONLY: All output MUST be in English. Never use any other language.
 
+BEFORE SCANNING: if `.opencode/devloom/context/briefing.md` exists, read it FIRST and start from its file map — never re-read files it already summarizes.
+
 ## ROLE — STRICT
 
 You are a **read-only image description machine**. Your ONLY job:

package/agents/devloom-visual-critic.md

@@ -12,12 +12,16 @@ permission:
   grep: deny
   webfetch: deny
   task: deny
+  external_directory:
+    "~/.config/opencode/**": allow
 ---
 
 # DevLoom Visual Critic
 
 ENGLISH ONLY: All output MUST be in English. Never use any other language.
 
+BEFORE SCANNING: if `.opencode/devloom/context/briefing.md` exists, read it FIRST and start from its file map — never re-read files it already summarizes.
+
 ## ROLE — STRICT
 
 You are an INDEPENDENT visual judge. You are READ-ONLY. You receive a brief, the design memory, screenshots/rendered state, viewport info, and the user goal. You produce visual judgment — nothing else.

package/agents/devloom-visual-director.md

@@ -12,12 +12,16 @@ permission:
   patch: deny
   webfetch: deny
   task: deny
+  external_directory:
+    "~/.config/opencode/**": allow
 ---
 
 # DevLoom Visual Director
 
 ENGLISH ONLY: All output MUST be in English. Never use any other language.
 
+BEFORE SCANNING: if `.opencode/devloom/context/briefing.md` exists, read it FIRST and start from its file map — never re-read files it already summarizes.
+
 ## ROLE — STRICT
 
 You make VISUAL DECISIONS. You are READ-ONLY regarding application implementation. You may inspect requirements, plans, project code, existing design systems, screenshots, design references, and project context — you must NOT implement, edit, or create any file, and must NOT run shell commands.

package/commands/devloom-agents.md

@@ -44,6 +44,6 @@ node "$PROFILE_MJS" current 2>&1
 - `@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`
+Switch profiles: `/devloom-go`, `/devloom-go-economy`, `/devloom-free`, `/devloom-mimo`, `/devloom-deepseek-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-deepseek-mimo.md

@@ -0,0 +1,11 @@
+---
+description: "DevLoom DeepSeek+MiMo: fast general roles on DeepSeek V4.1, graphical/complex roles on MiMo V2.6"
+---
+
+# DevLoom DeepSeek+MiMo
+
+Switch DevLoom to the hybrid profile: the 7 general roles (orchestrator, planner, developer, qa, verifier, security, documenter) resolve to DeepSeek V4.1 Flash for fast everyday work; the graphical/complex roles (vision, visual-director, visual-critic) resolve to the MiMo V2.6 Flash candidate chain (`mimo/mimo-v2.6-flash` → `xiaomi/mimo-v2.6-flash` → `opencode-go/mimo-v2.6-flash`), against `opencode models`. DeepSeek chain: `opencode-go/deepseek-v4.1-flash`.
+
+!`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-mimo 2>&1; node "$PM" current 2>&1`
+
+If either chain resolves to nothing the profile is NOT activated and the attempted candidates are printed — fail fast, 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devloom",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "DevLoom – Autonomous Development Weaver for OpenCode. Transforms a single prompt into fully tested, documented software.",
   "type": "module",
   "main": "dist/index.js",

package/postinstall.mjs

@@ -11,9 +11,8 @@ export function getConfigDir(_platform = platform(), _homedir = homedir()) {
   if (_platform === "win32") {
     return resolve(process.env.APPDATA ?? _homedir, "opencode")
   }
-  if (_platform === "darwin") {
-    return resolve(_homedir, "Library", "Application Support", "opencode")
-  }
+  // OpenCode resolves its global config from the XDG path on macOS too
+  // (~/.config/opencode), not ~/Library/Application Support.
   return resolve(
     process.env.XDG_CONFIG_HOME ?? join(_homedir, ".config"),
     "opencode"
@@ -148,7 +147,7 @@ const AGENTS = [
   "devloom-documenter-flash",
 ]
 
-const COMMANDS = ["devloom", "devloom-status", "devloom-resume", "devloom-init", "devloom-save", "devloom-auto", "devloom-go", "devloom-go-economy", "devloom-go-flash", "devloom-deepseek", "devloom-free", "devloom-mimo", "devloom-plan", "devloom-context", "devloom-agents", "devloom-refresh"]
+const COMMANDS = ["devloom", "devloom-status", "devloom-resume", "devloom-init", "devloom-save", "devloom-auto", "devloom-go", "devloom-go-economy", "devloom-go-flash", "devloom-deepseek", "devloom-free", "devloom-mimo", "devloom-deepseek-mimo", "devloom-plan", "devloom-context", "devloom-agents", "devloom-refresh"]
 
 const SCRIPTS_DIR = resolve(CONFIG_DIR, "devloom-scripts")
 
@@ -200,6 +199,11 @@ function main() {
     resolve(COMMANDS_DIR, "model-capabilities.mjs"),
     "Model capabilities helper"
   )
+  installFile(
+    resolve(__dirname, "scripts", "briefing.mjs"),
+    resolve(COMMANDS_DIR, "briefing.mjs"),
+    "Briefing change tracker"
+  )
   installFile(
     resolve(__dirname, "scripts", "plugin-cache.mjs"),
     resolve(COMMANDS_DIR, "plugin-cache.mjs"),

package/protocol/model-routing.md

@@ -95,6 +95,15 @@ A single multimodal stack: every role — including vision, visual-director, and
 |---|---|
 | all 10 roles | resolved MiMo V2.6 Flash candidate |
 
+### deepseek-mimo (hybrid, tier unlocked)
+
+Fast everyday work on DeepSeek V4.1 Flash; graphical/complex work on MiMo V2.6 Flash. The 7 general roles (orchestrator, planner, developer, qa, verifier, security, documenter) resolve to `opencode-go/deepseek-v4.1-flash`; vision, visual-director, and visual-critic resolve through the `MIMO_V26_FLASH_CANDIDATES` chain. Both chains resolve strictly against `opencode models` — if either finds nothing the profile exits code 1 with the attempted candidates, never an unrelated substitution. Activate with `/devloom-deepseek-mimo`.
+
+| Role | Model |
+|---|---|
+| 7 general roles | opencode-go/deepseek-v4.1-flash |
+| vision, visual-director, visual-critic | resolved MiMo V2.6 Flash candidate |
+
 ## Model Guidance
 
 ### When to Use GLM 5.2
@@ -157,7 +166,7 @@ In `.opencode/devloom/project/config.json`:
 }
 ```
 
-Valid values: `"go"`, `"go-economy"`, `"deepseek"`, `"go-flash"`, `"free"`, `"mimo"`.
+Valid values: `"go"`, `"go-economy"`, `"deepseek"`, `"go-flash"`, `"free"`, `"mimo"`, `"deepseek-mimo"`.
 
 ### Overrides
 

package/scripts/briefing.mjs

@@ -0,0 +1,192 @@
+#!/usr/bin/env node
+// Incremental briefing tracker: answers "what changed since the briefing was
+// written?" so orchestrator/sub-agents re-read ONLY modified files.
+//
+// Signal: sha256 content fingerprints recorded at init/touch — the same
+// content-addressed idea as git, but immune to commit/uncommitted state (a
+// file already re-read after `touch` never reappears until it truly changes).
+// The git baseCommit is kept for provenance/status only.
+//
+// Commands:
+//   briefing.mjs init <ticket>  create briefing.md stub + record fingerprints
+//   briefing.mjs changed        print changed paths (one per line), exit 0
+//   briefing.mjs touch          re-anchor after the briefing was patched
+//   briefing.mjs status         show ticket/base/counters
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from "fs"
+import { execSync } from "child_process"
+import { resolve, dirname, join, relative, sep } from "path"
+import { fileURLToPath } from "url"
+import { createHash } from "crypto"
+
+const DIR = ".opencode/devloom/context"
+export const BRIEFING_MD = `${DIR}/briefing.md`
+export const BRIEFING_JSON = `${DIR}/briefing.json`
+
+const EXCLUDE_DIRS = new Set([
+  "node_modules", ".git", "dist", ".angular", ".next", "build", "coverage",
+  "logs", ".tmp", "tmp", ".opencode", ".idea", ".vscode",
+])
+const EXCLUDE_FILES = /^(package-lock\.json|pnpm-lock\.yaml|yarn\.lock|\.DS_Store|.*\.log)$/
+
+export function walkFiles(root = process.cwd()) {
+  const out = []
+  const stack = [root]
+  while (stack.length > 0) {
+    const dir = stack.pop()
+    let entries = []
+    try {
+      entries = readdirSync(dir, { withFileTypes: true })
+    } catch {
+      continue
+    }
+    for (const entry of entries) {
+      if (entry.name.startsWith(".") && entry.isDirectory() && entry.name !== ".ai") continue
+      const full = join(dir, entry.name)
+      if (entry.isDirectory()) {
+        if (!EXCLUDE_DIRS.has(entry.name)) stack.push(full)
+        continue
+      }
+      if (!entry.isFile() || EXCLUDE_FILES.test(entry.name)) continue
+      const rel = relative(root, full).split(sep).join("/")
+      out.push(rel)
+    }
+  }
+  return out.sort()
+}
+
+export function hashFile(rel, root = process.cwd()) {
+  try {
+    const data = readFileSync(join(root, rel))
+    return createHash("sha256").update(data).digest("hex").slice(0, 12)
+  } catch {
+    return null
+  }
+}
+
+export function computeHashes(paths, root = process.cwd()) {
+  const files = {}
+  for (const p of paths) files[p] = hashFile(p, root)
+  return files
+}
+
+export function diffHashes(previous, paths, root = process.cwd()) {
+  const changed = []
+  const prev = previous || {}
+  for (const p of paths) {
+    if (prev[p] !== hashFile(p, root)) changed.push(p)
+  }
+  for (const p of Object.keys(prev)) {
+    if (!paths.includes(p) && prev[p] !== null) changed.push(p)
+  }
+  return [...new Set(changed)].sort()
+}
+
+function run(cmd, cwd = process.cwd()) {
+  try {
+    return execSync(cmd, { cwd, encoding: "utf8", timeout: 15000 }).trim()
+  } catch {
+    return null
+  }
+}
+
+export function gitAvailable(cwd = process.cwd()) {
+  return run("git rev-parse --is-inside-work-tree", cwd) === "true"
+}
+
+export function gitHead(cwd = process.cwd()) {
+  const out = run("git rev-parse HEAD", cwd)
+  return out && !out.includes("fatal") ? out : null
+}
+
+function readJson() {
+  try {
+    return JSON.parse(readFileSync(BRIEFING_JSON, "utf8"))
+  } catch {
+    return null
+  }
+}
+
+function writeJson(data) {
+  mkdirSync(DIR, { recursive: true })
+  writeFileSync(BRIEFING_JSON, JSON.stringify(data, null, 2) + "\n")
+}
+
+export function init(ticket = "ticket") {
+  mkdirSync(DIR, { recursive: true })
+  const paths = walkFiles()
+  const useGit = gitAvailable()
+  const data = {
+    ticket,
+    baseCommit: useGit ? gitHead() : null,
+    files: computeHashes(paths),
+    updatedAt: new Date().toISOString(),
+  }
+  writeJson(data)
+  if (!existsSync(BRIEFING_MD)) {
+    writeFileSync(
+      BRIEFING_MD,
+      `# Briefing — ${ticket}\n` +
+        `> Created: ${data.updatedAt}\n` +
+        `> Refresh rule: run \`briefing.mjs changed\`, re-read ONLY those paths, patch this file, then \`briefing.mjs touch\`.\n` +
+        `> Every task() prompt starts with: "Read .opencode/devloom/context/briefing.md first — do not re-discover."\n\n` +
+        `## Goal\n\n## Constraints\n\n## File map\n\n## Decisions\n`
+    )
+  }
+  return data
+}
+
+export function changed() {
+  const data = readJson()
+  if (!data) return []
+  return diffHashes(data.files, walkFiles())
+}
+
+export function touch() {
+  const data = readJson() || init("ticket")
+  const paths = walkFiles()
+  data.baseCommit = gitAvailable() ? gitHead() : null
+  data.files = computeHashes(paths)
+  data.updatedAt = new Date().toISOString()
+  writeJson(data)
+  return data
+}
+
+export function status() {
+  const data = readJson()
+  if (!data) {
+    console.log("No briefing recorded. Run: briefing.mjs init <ticket>")
+    return
+  }
+  console.log(`Ticket: ${data.ticket}`)
+  console.log(`Base commit: ${data.baseCommit || "(no git)"}`)
+  console.log(`Tracked files: ${Object.keys(data.files).length}`)
+  console.log(`Updated: ${data.updatedAt}`)
+}
+
+function main() {
+  const args = process.argv.slice(2)
+  const command = args[0] || ""
+  switch (command) {
+    case "init":
+      init(args[1] || "ticket")
+      console.log(`Briefing initialized${args[1] ? ` for ${args[1]}` : ""}: ${BRIEFING_MD}`)
+      break
+    case "changed": {
+      const paths = changed()
+      for (const p of paths) console.log(p)
+      break
+    }
+    case "touch":
+      touch()
+      console.log("Briefing anchors refreshed.")
+      break
+    case "status":
+      status()
+      break
+    default:
+      console.log("Usage: briefing.mjs <init <ticket>|changed|touch|status>")
+  }
+}
+
+const isMain = process.argv[1] ? fileURLToPath(import.meta.url) === resolve(process.argv[1]) : false
+if (isMain) main()

package/scripts/model-capabilities.mjs

@@ -35,11 +35,36 @@ export const MODEL_FAMILIES = {
       verification: "high",
     },
   },
+  deepseekV41Flash: {
+    id: "deepseekV41Flash",
+    label: "DeepSeek V4.1 Flash",
+    // Fast lane for general roles. Only verified ids enter the chain; the
+    // family pattern still discovers same-family variants at resolution time.
+    candidates: [
+      "opencode-go/deepseek-v4.1-flash",
+    ],
+    familyPattern: /(^|\/)deepseek-v4\.1/i,
+    capabilities: {
+      vision: false,
+      multimodal: false,
+      coding: "high",
+      reasoning: "high",
+      toolUse: true,
+      longContext: true,
+      speed: "fast",
+      costClass: "low",
+      orchestration: true,
+      verification: "high",
+    },
+  },
 }
 
 /** MiMo V2.6 Flash candidate chain (re-exported for profile manager + tests). */
 export const MIMO_V26_FLASH_CANDIDATES = MODEL_FAMILIES.mimoV26Flash.candidates
 
+/** DeepSeek V4.1 Flash candidate chain (general/fast roles). */
+export const DEEPSEEK_V41_FLASH_CANDIDATES = MODEL_FAMILIES.deepseekV41Flash.candidates
+
 /**
  * Vision-capable fallbacks used when a vision-required role (vision,
  * visual-critic) resolves to a text-only model. Ordered by existing DevLoom

package/scripts/plugin-cache.mjs

@@ -20,12 +20,12 @@ export function getOpenCodeCacheDir(_platform = platform(), _homedir = homedir()
     return resolve(_env.LOCALAPPDATA ?? _homedir, "cache", "opencode")
   }
   if (_platform === "darwin") {
+    const xdg = resolve(_env.XDG_CACHE_HOME ?? join(_homedir, ".cache"), "opencode")
     const lib = resolve(_homedir, "Library", "Caches", "opencode")
-    const legacy = resolve(_env.XDG_CACHE_HOME ?? join(_homedir, ".cache"), "opencode")
-    // Some opencode builds keep using ~/.cache/opencode on macOS; prefer the
-    // platform path unless only the legacy one exists on disk.
-    if (!existsSync(lib) && existsSync(legacy)) return legacy
-    return lib
+    // OpenCode uses the XDG cache path on macOS too; only fall back to the
+    // Library path when that is the one present on disk (older builds).
+    if (!existsSync(xdg) && existsSync(lib)) return lib
+    return xdg
   }
   return resolve(_env.XDG_CACHE_HOME ?? join(_homedir, ".cache"), "opencode")
 }

package/scripts/profile.mjs

@@ -16,6 +16,7 @@ import {
   modelMeetsRole,
   roleRequiresVision,
   MIMO_V26_FLASH_CANDIDATES,
+  DEEPSEEK_V41_FLASH_CANDIDATES,
   MODEL_FAMILIES,
   VISION_FALLBACK_CANDIDATES,
 } from "./model-capabilities.mjs"
@@ -30,6 +31,7 @@ export {
   modelMeetsRole,
   roleRequiresVision,
   MIMO_V26_FLASH_CANDIDATES,
+  DEEPSEEK_V41_FLASH_CANDIDATES,
   MODEL_FAMILIES,
   VISION_FALLBACK_CANDIDATES,
 }
@@ -255,6 +257,35 @@ function containsKey(obj, key) {
   return Object.prototype.hasOwnProperty.call(obj, key)
 }
 
+// Strict family resolution used by `deepseek-mimo`: resolves a candidate chain
+// against the live catalog and FAILS FAST with diagnostics when nothing
+// matches. Never substitutes unrelated models — a blocked dispatch is worse
+// than a clear exit the user can act on.
+function resolveStrictCandidate(label, candidates, available, familyPattern, profileName) {
+  const resolved = resolveModelCandidate(candidates, available, { familyPattern })
+  if (!resolved.model) {
+    console.error(`${label} is not available in this environment.`)
+    console.error("")
+    console.error("Attempted candidates:")
+    for (const candidate of resolved.attempted) {
+      console.error(`  ${candidate} (not found)`)
+    }
+    const compatible = familyPattern ? available.filter((m) => familyPattern.test(m)) : []
+    console.error("")
+    if (compatible.length > 0) {
+      console.error(`Available compatible ${label} models:`)
+      for (const m of compatible) console.error(`  ${m}`)
+    } else {
+      console.error(`No compatible ${label} models are available. Run: opencode models`)
+    }
+    console.error("")
+    console.error(`The ${profileName} profile was NOT activated. No unrelated models were substituted.`)
+    console.error("Valid profiles: auto, go, go-economy, deepseek, glm, go-flash, mimo, deepseek-mimo, free")
+    process.exit(1)
+  }
+  return resolved
+}
+
 export function applyFallbacks(models, unavailable, available) {
   const result = { ...models }
   const fallbacks = {}
@@ -367,7 +398,7 @@ export function cmdSet(profileName) {
   const available = detectAvailableModels()
   const hasGo = hasGoModels(available)
 
-  if ((profileName === "go" || profileName === "go-economy" || profileName === "deepseek" || profileName === "glm" || profileName === "go-flash") && !hasGo) {
+  if ((profileName === "go" || profileName === "go-economy" || profileName === "deepseek" || profileName === "glm" || profileName === "go-flash" || profileName === "deepseek-mimo") && !hasGo) {
     console.error("No OpenCode Go models detected. Run: opencode /connect to add OpenCode Go.")
     console.error("Fall back to: /devloom-auto or /devloom-free")
     process.exit(1)
@@ -450,7 +481,7 @@ export function cmdSet(profileName) {
       }
       console.error("")
       console.error("The mimo profile was NOT activated. No unrelated models were substituted.")
-      console.error("Valid profiles: auto, go, go-economy, deepseek, glm, go-flash, mimo, free")
+      console.error("Valid profiles: auto, go, go-economy, deepseek, glm, go-flash, mimo, deepseek-mimo, free")
       process.exit(1)
     }
     models = Object.fromEntries(ALL_AGENTS.map((agent) => [agent, resolved.model]))
@@ -463,6 +494,39 @@ export function cmdSet(profileName) {
         }
       }
     }
+  } else if (profileName === "deepseek-mimo") {
+    // Hybrid: DeepSeek V4.1 Flash is the fast lane for the 7 general roles;
+    // MiMo V2.6 Flash serves the graphical/complex visual roles. Both chains
+    // resolve strictly — exit 1 with diagnostics instead of substituting.
+    const deepseekResolved = resolveStrictCandidate(
+      "DeepSeek V4.1 Flash",
+      DEEPSEEK_V41_FLASH_CANDIDATES,
+      available,
+      MODEL_FAMILIES.deepseekV41Flash.familyPattern,
+      "deepseek-mimo"
+    )
+    const mimoResolved = resolveStrictCandidate(
+      "MiMo V2.6 Flash",
+      MIMO_V26_FLASH_CANDIDATES,
+      available,
+      MODEL_FAMILIES.mimoV26Flash.familyPattern,
+      "deepseek-mimo"
+    )
+    const visualRoles = new Set(["vision", "visual-director", "visual-critic"])
+    models = Object.fromEntries(
+      ALL_AGENTS.map((agent) => [agent, visualRoles.has(agent) ? mimoResolved.model : deepseekResolved.model])
+    )
+    const recordChainFallback = (agent, resolved, chainLabel) => {
+      if (resolved.exact) return
+      fallbacks[agent] = {
+        from: `${chainLabel} (candidate chain)`,
+        to: resolved.model,
+        reason: "family fallback",
+      }
+    }
+    for (const agent of ALL_AGENTS) {
+      recordChainFallback(agent, visualRoles.has(agent) ? mimoResolved : deepseekResolved, visualRoles.has(agent) ? "mimo-v2.6-flash" : "deepseek-v4.1-flash")
+    }
   } else if (profileName === "auto") {
     if (hasGo) {
       models = { ...PROFILES["go-flash"] }
@@ -479,7 +543,7 @@ export function cmdSet(profileName) {
     }
   } else {
     console.error("Unknown profile:", profileName)
-    console.error("Valid profiles: auto, go, go-economy, deepseek, glm, go-flash, mimo, free")
+    console.error("Valid profiles: auto, go, go-economy, deepseek, glm, go-flash, mimo, deepseek-mimo, free")
     process.exit(1)
   }
 
@@ -648,7 +712,7 @@ function main() {
 
   switch (command) {
     case "set":
-      if (!args[1]) { console.error("Usage: devloom profile set <auto|go|go-economy|deepseek|glm|go-flash|mimo|free>"); process.exit(1) }
+      if (!args[1]) { console.error("Usage: devloom profile set <auto|go|go-economy|deepseek|glm|go-flash|mimo|deepseek-mimo|free>"); process.exit(1) }
       cmdSet(args[1])
       console.log(`DevLoom profile changed to: ${args[1]}`)
       if (args[1] !== "free") {
@@ -678,7 +742,7 @@ function main() {
       console.log("DevLoom Profile Manager")
       console.log("")
       console.log("Commands:")
-      console.log("  devloom profile set <auto|go|go-economy|deepseek|glm|go-flash|mimo|free>")
+      console.log("  devloom profile set <auto|go|go-economy|deepseek|glm|go-flash|mimo|deepseek-mimo|free>")
       console.log("  devloom profile tier <senior|standard>")
       console.log("  devloom profile current")
       console.log("  devloom profile validate")