devloom 1.0.0 → 1.2.0

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

package/commands/devloom.md

@@ -1,81 +1,113 @@
 ---
-description: "DevLoom: weave a full software feature from a single prompt — requirements, code, tests, and docs"
+description: "DevLoom: autonomous delivery from one prompt"
 agent: devloom-orchestrator
 subtask: false
 ---
 
-# Smart Resume Detection
+# Boot
 
 ```bash
-# Create .opencode/devloom directory if not exists
-mkdir -p .opencode/devloom
+mkdir -p .opencode/devloom/project/{stories,tasks,bugs,decisions,reports}
 
-# 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)) {
-      // Ensure model has opencode/ or opencode-go/ prefix
-      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
+export SANITIZED_PROMPT="$(node -e "
+  let p = process.argv[1] || '';
+  p = p.slice(0, 4000).replace(/[\x00-\x08\x0E-\x1F\x7F]/g, '');
+  process.stdout.write(p);
+" -- "$ARGUMENTS")"
 
-# Check if state exists
-if [ -f ".opencode/devloom/state.json" ]; then
-  PHASE=$(grep -o '"phase":"[^"]*"' .opencode/devloom/state.json | cut -d'"' -f4)
-  COMPLETED=$(grep -o '"completed":\[' .opencode/devloom/state.json | wc -l)
-  
-  # If no arguments provided, RESUME existing execution
-  if [ -z "$ARGUMENTS" ]; then
-    echo "📋 Found existing execution at phase: $PHASE"
-    echo "🔄 Resuming from saved state..."
-    
-    # Delegate to orchestrator resume logic (PRE-PHASE 0)
-    echo "RESUMING_FROM_STATE"
-  else
-    # If prompt provided, treat as new execution with same project
-    echo "ℹ️  Existing state found. Starting fresh execution with new prompt..."
-  fi
-else
-  # No prior state
-  if [ -z "$ARGUMENTS" ]; then
-    echo "❌ No prior execution found. Use: /devloom [description]"
-    echo "   Or use: /devloom init [description] to start fresh"
-    exit 1
-  fi
-  
-  echo "✨ Starting fresh DevLoom execution..."
+if [ -z "$SANITIZED_PROMPT" ] && [ -n "$ARGUMENTS" ]; then
+  SANITIZED_PROMPT="$ARGUMENTS"
 fi
-```
 
-# Orchestrator Direction
+DEVLOOM_PROMPT="$SANITIZED_PROMPT" 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 prompt = (process.env.DEVLOOM_PROMPT || '').trim();
+  const cfg = readJson(p + '/config.json', {});
+  const board = readJson(p + '/board.json', {});
+  const state = readJson(p + '/state.json', {});
+  const now = new Date().toISOString();
+  const taskId = prompt ? 'PROMPT-' + now.replace(/[-:.TZ]/g, '').slice(0, 14) : '';
+  const todoPath = p + '/tasks/TODO.md';
+  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' }
+  };
+  const active = typeof board.active === 'string' ? board.active : '';
+  const backlog = Array.isArray(board.cols?.backlog) ? board.cols.backlog : [];
+  const nextBacklog = taskId ? [...backlog, taskId] : backlog;
+  const todoHeader = '# DevLoom Prompt Tasks\nEvery /devloom prompt is appended here as the last todo before execution routing.\n\n';
+  if (!fs.existsSync(todoPath)) fs.writeFileSync(todoPath, todoHeader);
+  if (taskId) fs.appendFileSync(todoPath, '- [ ] ' + taskId + ' :: ' + prompt.replace(/\\s+/g, ' ') + '\n');
+  const normalizedBoard = {
+    v: 1,
+    tracker: normalizedCfg.tracker,
+    active,
+    cols: {
+      backlog: nextBacklog,
+      ready: Array.isArray(board.cols?.ready) ? board.cols.ready : [],
+      doing: Array.isArray(board.cols?.doing) ? board.cols.doing.slice(0, 1) : (active ? [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
+  };
+  const normalizedState = {
+    v: 1,
+    phase: typeof state.phase === 'string' ? state.phase : 'idle',
+    prompt: prompt || (typeof state.prompt === 'string' ? state.prompt : ''),
+    ticket: typeof state.ticket === 'string' ? state.ticket : active,
+    next: typeof state.next === 'string' ? state.next : 'analysis',
+    updatedAt: now,
+    notes: Array.isArray(state.notes) ? state.notes : []
+  };
+  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(normalizedCfg));
+  fs.writeFileSync(p + '/board.json', JSON.stringify(normalizedBoard));
+  fs.writeFileSync(p + '/state.json', JSON.stringify(normalizedState));
+"
+
+if [ -f ".opencode/devloom/config.json" ]; then
+  echo "Applying local model config..."
 
-$ARGUMENTS
+  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; }
+
+  INIT_PROFILE="$(node -e "const c=require('./.opencode/devloom/config.json'); process.stdout.write(c.profile||'auto')" 2>/dev/null || echo auto)"
+
+  node "$PROFILE_MJS" set "$INIT_PROFILE" 2>&1
+  node "$PROFILE_MJS" apply 2>&1
+fi
+```
 
-IMPORTANT: 
-- If RESUMING_FROM_STATE: Use PRE-PHASE 0 resume detection. Skip completed phases.
-- Otherwise: Run full PHASE 0 → PHASE 1 → PHASE 2 → PHASE 3 workflow.
+# Run
 
-Full workflow:
-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
+PROMPT: `$SANITIZED_PROMPT`
+LOAD: `.opencode/devloom/project/config.json|.opencode/devloom/project/board.json|.opencode/devloom/project/state.json`
+RULES:
+- English-only artifacts
+- normalize existing project files to canonical JSONM/English format before execution
+- load memory and relevant skills before planning new work
+- append every prompt as the last task/todo in `.opencode/devloom/project/tasks/TODO.md`
+- auto-create or update tickets, todos, and plan entries for the prompt
+- persist board+state every phase
+- IF board.cols.doing is non-empty: queue the prompt to backlog, do NOT start new work — the orchestrator will see the queue and exit
+- continue pending work first (only when doing is empty) unless user reprioritizes
+- one active ticket by default — new prompts are queued when doing is occupied
+- delegate specialist work to DevLoom subagents by default
+- triage first: pick the minimal agent chain for the prompt intent (see workflow.dsl CHAINS); never run the full pipeline by default
+- DEVLOOM_DONE only when the chosen chain's gates pass

package/dist/agents.d.ts

@@ -0,0 +1,30 @@
+export interface ActiveProfile {
+    profile?: string;
+    resolvedProfile?: string;
+    models?: Record<string, string>;
+    tier?: string | null;
+}
+export declare function readActiveProfile(rootDir: string): ActiveProfile | null;
+export declare function profileLabel(profile: ActiveProfile | null): string;
+export declare function agentVariantVisible(_profile: ActiveProfile | null, variant: string): boolean;
+export interface DevloomAgentMeta {
+    name: string;
+    role: string;
+    description: string;
+    mode: "subagent" | "primary" | "all";
+    color: string;
+    model: string;
+}
+export declare function listDevloomAgents(profile: ActiveProfile | null): DevloomAgentMeta[];
+export interface DevloomAgentConfig {
+    description?: string;
+    mode?: "subagent" | "primary" | "all";
+    model?: string;
+    color?: string;
+    hidden?: boolean;
+}
+export declare function buildAgentConfigs(rootDir: string): Record<string, DevloomAgentConfig>;
+export declare function injectDevloomAgents(opencodeConfig: {
+    agent?: Record<string, DevloomAgentConfig | undefined>;
+}, rootDir: string): void;
+//# sourceMappingURL=agents.d.ts.map

package/dist/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAQvE;AAKD,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,CAKlE;AAQD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5F;AAeD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,KAAK,CAAA;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAgDD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,gBAAgB,EAAE,CAmBnF;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,KAAK,CAAA;IACrC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAiBrF;AAED,wBAAgB,mBAAmB,CACjC,cAAc,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,SAAS,CAAC,CAAA;CAAE,EAC1E,OAAO,EAAE,MAAM,GACd,IAAI,CAUN"}

package/dist/agents.js

@@ -0,0 +1,139 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+export function readActiveProfile(rootDir) {
+    const p = join(rootDir, ".opencode", "devloom", "config.json");
+    if (!existsSync(p))
+        return null;
+    try {
+        return JSON.parse(readFileSync(p, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+// Human-readable label shown in the sidebar so the current DevLoom profile is
+// visible at a glance (e.g. "DevLoom Orchestrator: ... (profile: go-flash)").
+// With a senior tier override the label is extended to "(profile: go, tier: senior)".
+export function profileLabel(profile) {
+    const name = profile?.resolvedProfile ?? profile?.profile;
+    if (!name)
+        return "";
+    const tier = profile?.tier === "senior" ? ", tier: senior" : "";
+    return ` (profile: ${name}${tier})`;
+}
+// Whether a given agent variant should be surfaced in the sidebar / @-menu.
+// Only base and non-tiered variants (orchestrator, developer, planner, qa,
+// security, verifier, documenter, vision) are shown — flash and senior variants
+// are always hidden regardless of the active profile. Non-matching variants
+// stay registered so orchestrator task() routing keeps working; they are only
+// hidden from the UI. Pure function, no fs access.
+export function agentVariantVisible(_profile, variant) {
+    return !variant.endsWith("-flash") && !variant.endsWith("-senior");
+}
+const AGENT_VARIANTS = {
+    developer: ["developer", "developer-flash", "developer-senior"],
+    planner: ["planner", "planner-flash", "planner-senior"],
+    qa: ["qa", "qa-flash"],
+    verifier: ["verifier"],
+    security: ["security", "security-senior"],
+    documenter: ["documenter", "documenter-flash"],
+    orchestrator: ["orchestrator"],
+    vision: ["vision"],
+    "visual-director": ["visual-director"],
+    "visual-critic": ["visual-critic"],
+};
+const ROLE_COLORS = {
+    orchestrator: "#7fdbca",
+    planner: "#c792ea",
+    developer: "#addb67",
+    qa: "#ecc48d",
+    verifier: "#82aaff",
+    security: "#ff5874",
+    documenter: "#f07178",
+    vision: "#f78c6c",
+    "visual-director": "#c3e88d",
+    "visual-critic": "#89ddff",
+};
+const DESCRIPTIONS = {
+    "devloom-orchestrator": "DevLoom Orchestrator: autonomous multi-agent delivery",
+    "devloom-planner": "DevLoom Planner: callable by the orchestrator for requirements and architecture planning",
+    "devloom-planner-senior": "DevLoom Planner Senior: callable by the orchestrator for complex requirements and architecture planning",
+    "devloom-planner-flash": "DevLoom Planner Flash: callable by the orchestrator for lightweight requirements and planning",
+    "devloom-developer": "DevLoom Developer: callable by the orchestrator for ticket implementation and defect fixes",
+    "devloom-developer-senior": "DevLoom Developer Senior: callable by the orchestrator for complex ticket implementation and defect fixes",
+    "devloom-developer-flash": "DevLoom Developer Flash: callable by the orchestrator for simple ticket implementation and defect fixes",
+    "devloom-qa": "DevLoom QA: callable by the orchestrator for verification, code review, and regression",
+    "devloom-qa-flash": "DevLoom QA Flash: callable by the orchestrator for lightweight verification, code review, and regression",
+    "devloom-verifier": "DevLoom Verifier: callable by the orchestrator for runtime app verification across scopes",
+    "devloom-security": "DevLoom Security: callable by the orchestrator for CRUD endpoint and exposure-surface review",
+    "devloom-security-senior": "DevLoom Security Senior: callable by the orchestrator for deep CRUD endpoint and exposure-surface review",
+    "devloom-documenter": "DevLoom Documenter: callable by the orchestrator for documentation and state updates",
+    "devloom-documenter-flash": "DevLoom Documenter Flash: callable by the orchestrator for lightweight documentation and state updates",
+    "devloom-vision": "DevLoom Vision: read-only image description specialist. Takes an image, returns structured description. Nothing else.",
+    "devloom-visual-director": "DevLoom Visual Director: read-only design brief writer. Emits DESIGN_FILE spec for UI work.",
+    "devloom-visual-critic": "DevLoom Visual Critic: read-only visual reviewer. Scores screenshots against the design contract and issues a delta verdict.",
+};
+const DEFAULT_MODELS = {
+    orchestrator: "opencode-go/deepseek-v4-flash",
+    planner: "opencode-go/qwen3.7-max",
+    developer: "opencode-go/kimi-k2.7-code",
+    qa: "opencode-go/deepseek-v4-flash",
+    verifier: "opencode-go/deepseek-v4-flash",
+    security: "opencode-go/deepseek-v4-flash",
+    documenter: "opencode-go/deepseek-v4-flash",
+    vision: "opencode-go/qwen3.6-plus",
+    "visual-director": "opencode-go/qwen3.6-plus",
+    "visual-critic": "opencode-go/qwen3.6-plus",
+};
+export function listDevloomAgents(profile) {
+    const agents = [];
+    const models = profile?.models ?? {};
+    for (const [role, variants] of Object.entries(AGENT_VARIANTS)) {
+        const color = ROLE_COLORS[role] ?? "#7fdbca";
+        for (const variant of variants) {
+            const name = `devloom-${variant}`;
+            const isOrchestrator = name === "devloom-orchestrator";
+            agents.push({
+                name,
+                role,
+                description: `${DESCRIPTIONS[name] ?? `DevLoom ${variant}`}${isOrchestrator ? profileLabel(profile) : ""}`,
+                mode: isOrchestrator ? "all" : "subagent",
+                color,
+                model: models[role] ?? DEFAULT_MODELS[role] ?? "",
+            });
+        }
+    }
+    return agents;
+}
+export function buildAgentConfigs(rootDir) {
+    const profile = readActiveProfile(rootDir);
+    if (!profile || !profile.models)
+        return {};
+    const configs = {};
+    for (const agent of listDevloomAgents(profile)) {
+        // listDevloomAgents names agents `devloom-${variant}`; recover the variant
+        // so the visibility rule applies to the same string unit tests use.
+        const variant = agent.name.startsWith("devloom-") ? agent.name.slice("devloom-".length) : agent.name;
+        configs[agent.name] = {
+            description: agent.description,
+            mode: agent.mode,
+            model: agent.model,
+            color: agent.color,
+            hidden: !agentVariantVisible(profile, variant),
+        };
+    }
+    return configs;
+}
+export function injectDevloomAgents(opencodeConfig, rootDir) {
+    const configs = buildAgentConfigs(rootDir);
+    if (Object.keys(configs).length === 0)
+        return;
+    opencodeConfig.agent = opencodeConfig.agent ?? {};
+    for (const [name, agent] of Object.entries(configs)) {
+        const existing = opencodeConfig.agent[name];
+        opencodeConfig.agent[name] = existing
+            ? { ...existing, ...agent }
+            : agent;
+    }
+}
+//# sourceMappingURL=agents.js.map

package/dist/agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.js","sourceRoot":"","sources":["../src/agents.ts"],"names":[],"mappings":"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"}

package/dist/bootstrap.d.ts

@@ -0,0 +1,56 @@
+type ProjectState = {
+    v: number;
+    phase: string;
+    prompt: string;
+    ticket: string;
+    next: string;
+    updatedAt: string;
+    notes: string[];
+    sessions: Record<string, string>;
+    degraded: boolean;
+};
+type ProjectBoard = {
+    v: number;
+    tracker: "local" | "github";
+    active: string;
+    cols: {
+        backlog: string[];
+        ready: string[];
+        doing: string[];
+        review: string[];
+        blocked: string[];
+        done: string[];
+    };
+    updatedAt: string;
+};
+type ProjectConfig = {
+    v: number;
+    lang: "en";
+    tracker: "local" | "github";
+    gh: {
+        enabled: boolean;
+        owner: string;
+        repo: string;
+        project: string;
+    };
+    rules: {
+        flow: string[];
+        tests: "required";
+        regression: "required";
+        queue: "single";
+        docs: "official";
+        delegation: "required";
+        skills: "required";
+        memory: "load";
+        save: "always";
+        promptTask: "append-last";
+    };
+};
+export declare function ensureProjectWorkspace(rootDir: string): {
+    config: ProjectConfig;
+    board: ProjectBoard;
+    state: ProjectState;
+    projectRoot: string;
+};
+export {};
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAIA,KAAK,YAAY,GAAG;IAClB,CAAC,EAAE,MAAM,CAAA;IACT,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,QAAQ,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,KAAK,YAAY,GAAG;IAClB,CAAC,EAAE,MAAM,CAAA;IACT,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,EAAE,CAAA;QACjB,KAAK,EAAE,MAAM,EAAE,CAAA;QACf,KAAK,EAAE,MAAM,EAAE,CAAA;QACf,MAAM,EAAE,MAAM,EAAE,CAAA;QAChB,OAAO,EAAE,MAAM,EAAE,CAAA;QACjB,IAAI,EAAE,MAAM,EAAE,CAAA;KACf,CAAA;IACD,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,CAAC,EAAE,MAAM,CAAA;IACT,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC3B,EAAE,EAAE;QACF,OAAO,EAAE,OAAO,CAAA;QAChB,KAAK,EAAE,MAAM,CAAA;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,EAAE,CAAA;QACd,KAAK,EAAE,UAAU,CAAA;QACjB,UAAU,EAAE,UAAU,CAAA;QACtB,KAAK,EAAE,QAAQ,CAAA;QACf,IAAI,EAAE,UAAU,CAAA;QAChB,UAAU,EAAE,UAAU,CAAA;QACtB,MAAM,EAAE,UAAU,CAAA;QAClB,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,QAAQ,CAAA;QACd,UAAU,EAAE,aAAa,CAAA;KAC1B,CAAA;CACF,CAAA;AA8FD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM;;;;;EA+BrD"}

package/dist/bootstrap.js

@@ -0,0 +1,116 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { ensureLoopWorkspace } from "./loop.js";
+const PROJECT_DIRS = ["stories", "tasks", "bugs", "decisions", "reports"];
+const WORKSPACE_README = [
+    "# DevLoom Project Workspace",
+    "All artifacts in this workspace must be written in English.",
+    "AI-only state files use minified JSON to reduce token usage.",
+    "Every new /devloom prompt must be appended as the last task in project/tasks/TODO.md before execution continues.",
+    "Default workflow: load state, inspect memory, use relevant skills, delegate to subagents, keep tickets/todos/plan updated, and save state at every phase boundary.",
+    "",
+].join("\n");
+function ensureDir(path) {
+    if (!existsSync(path))
+        mkdirSync(path, { recursive: true });
+}
+function readJson(path, fallback) {
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return fallback;
+    }
+}
+function normalizeStringArray(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function normalizeTracker(value) {
+    return value === "github" ? "github" : "local";
+}
+function normalizeConfig(value) {
+    const cfg = typeof value === "object" && value ? value : {};
+    return {
+        v: 1,
+        lang: "en",
+        tracker: normalizeTracker(cfg.tracker),
+        gh: {
+            enabled: Boolean(cfg.gh?.enabled),
+            owner: typeof cfg.gh?.owner === "string" ? cfg.gh.owner : "",
+            repo: typeof cfg.gh?.repo === "string" ? cfg.gh.repo : "",
+            project: typeof cfg.gh?.project === "string" ? 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",
+        },
+    };
+}
+function normalizeBoard(value, tracker, now) {
+    const board = typeof value === "object" && value ? value : {};
+    const active = typeof board.active === "string" ? board.active : "";
+    return {
+        v: 1,
+        tracker,
+        active,
+        cols: {
+            backlog: normalizeStringArray(board.cols?.backlog),
+            ready: normalizeStringArray(board.cols?.ready),
+            doing: normalizeStringArray(board.cols?.doing).slice(0, 1),
+            review: normalizeStringArray(board.cols?.review),
+            blocked: normalizeStringArray(board.cols?.blocked),
+            done: normalizeStringArray(board.cols?.done),
+        },
+        updatedAt: now,
+    };
+}
+function normalizeState(value, board, now) {
+    const state = typeof value === "object" && value ? value : {};
+    return {
+        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: normalizeStringArray(state.notes),
+        sessions: typeof state.sessions === "object" && state.sessions ? state.sessions : {},
+        degraded: typeof state.degraded === "boolean" ? state.degraded : false,
+    };
+}
+export function ensureProjectWorkspace(rootDir) {
+    const projectRoot = join(rootDir, ".opencode", "devloom", "project");
+    const devloomRoot = join(rootDir, ".opencode", "devloom");
+    const now = new Date().toISOString();
+    ensureDir(projectRoot);
+    ensureDir(join(devloomRoot, ".tmp"));
+    for (const dir of PROJECT_DIRS)
+        ensureDir(join(projectRoot, dir));
+    const configPath = join(projectRoot, "config.json");
+    const boardPath = join(projectRoot, "board.json");
+    const statePath = join(projectRoot, "state.json");
+    const readmePath = join(projectRoot, "README.md");
+    const config = normalizeConfig(readJson(configPath, {}));
+    const board = normalizeBoard(readJson(boardPath, {}), config.tracker, now);
+    const state = normalizeState(readJson(statePath, {}), board, now);
+    writeFileSync(readmePath, WORKSPACE_README);
+    writeFileSync(configPath, JSON.stringify(config));
+    writeFileSync(boardPath, JSON.stringify(board));
+    writeFileSync(statePath, JSON.stringify(state));
+    ensureLoopWorkspace(rootDir);
+    return {
+        config,
+        board,
+        state,
+        projectRoot,
+    };
+}
+//# sourceMappingURL=bootstrap.js.map