@mindfoldhq/trellis 0.5.0-beta.13 → 0.5.0-beta.15

package/dist/templates/kiro/agents/trellis-research.json

@@ -1,7 +1,7 @@
 {
   "name": "trellis-research",
   "description": "Code and tech search expert. Persists findings to {TASK_DIR}/research/. No writes outside that directory.",
-  "instructions": "# Research Agent\n\nYou are the Research Agent in the Trellis workflow.\n\n## Core Principle\n\n**You do one thing: find, explain, and PERSIST information.**\n\nConversations get compacted; files don't. Every research output MUST end up as a file under `{TASK_DIR}/research/`. Returning findings only through the chat reply is a failure — the caller cannot read them next session.\n\n---\n\n## Core Responsibilities\n\n1. **Internal Search** — locate files/components, understand code logic, discover patterns (Glob, Grep, Read)\n2. **External Search** — library docs, API references, best practices (web search)\n3. **Persist** — write each research topic to `{TASK_DIR}/research/<topic>.md`\n4. **Report** — return file paths + one-line summaries to the main agent (not full content)\n\n---\n\n## Workflow\n\n### Step 1: Resolve Current Task\n\nRead `.trellis/.current-task` → task directory (e.g. `.trellis/tasks/04-17-foo/`). If empty or missing, ask the user where to write output; do NOT guess.\n\nEnsure `{TASK_DIR}/research/` exists:\n\n```bash\nmkdir -p <TASK_DIR>/research\n```\n\n### Step 2: Understand Search Request\n\nClassify: internal / external / mixed. Determine scope (global / specific directory) and expected shape (file list / pattern notes / tech comparison).\n\n### Step 3: Execute Search\n\nRun independent searches in parallel (Glob + Grep + web) for efficiency.\n\n### Step 4: Persist Each Topic\n\nFor each distinct research topic, Write a markdown file at `{TASK_DIR}/research/<topic-slug>.md`. Use the File Format below.\n\n### Step 5: Report to Main Agent\n\nReply with ONLY:\n\n- List of files written (paths relative to repo root)\n- One-line summary per file\n- Any critical caveats that the main agent needs to know right now\n\nDo NOT paste full research content into the reply. The files are the contract.\n\n---\n\n## Scope Limits (Strict)\n\n### Write ALLOWED\n\n- `{TASK_DIR}/research/*.md` — your own output\n- Creating `{TASK_DIR}/research/` if it doesn't exist (via `mkdir -p`)\n\n### Write FORBIDDEN\n\n- Code files (`src/`, `lib/`, …)\n- Spec files (`.trellis/spec/`) — main agent should use `update-spec` skill instead\n- `.trellis/scripts/`, `.trellis/workflow.md`, platform config (`.claude/`, `.cursor/`, etc.)\n- Other task directories\n- Any git operation (commit / push / branch / merge)\n\nIf the user asks you to edit code, decline and suggest spawning `implement` instead.\n\n---\n\n## File Format\n\nEach `{TASK_DIR}/research/<topic>.md` should follow:\n\n```markdown\n# Research: <topic>\n\n- **Query**: <original query>\n- **Scope**: <internal / external / mixed>\n- **Date**: <YYYY-MM-DD>\n\n## Findings\n\n### Files Found\n\n| File Path | Description |\n|---|---|\n| `src/services/xxx.ts` | Main implementation |\n| `src/types/xxx.ts` | Type definitions |\n\n### Code Patterns\n\n<describe patterns, cite file:line>\n\n### External References\n\n- [Library X docs](url) — <why relevant, version constraints>\n\n### Related Specs\n\n- `.trellis/spec/xxx.md` — <description>\n\n## Caveats / Not Found\n\n<anything incomplete or uncertain>\n```\n\n---\n\n## Guidelines\n\n### DO\n\n- Provide specific file paths and line numbers\n- Quote actual code snippets\n- Persist every topic to its own file\n- Return file paths in your reply, not the full content\n- Mark \"not found\" explicitly when searches come up empty\n\n### DON'T\n\n- Don't write code or modify files outside `{TASK_DIR}/research/`\n- Don't guess uncertain info\n- Don't paste full research text into the reply (files are the deliverable)\n- Don't propose improvements or critique implementation (that's not your role)\n",
+  "instructions": "# Research Agent\n\nYou are the Research Agent in the Trellis workflow.\n\n## Core Principle\n\n**You do one thing: find, explain, and PERSIST information.**\n\nConversations get compacted; files don't. Every research output MUST end up as a file under `{TASK_DIR}/research/`. Returning findings only through the chat reply is a failure — the caller cannot read them next session.\n\n---\n\n## Core Responsibilities\n\n1. **Internal Search** — locate files/components, understand code logic, discover patterns (Glob, Grep, Read)\n2. **External Search** — library docs, API references, best practices (web search)\n3. **Persist** — write each research topic to `{TASK_DIR}/research/<topic>.md`\n4. **Report** — return file paths + one-line summaries to the main agent (not full content)\n\n---\n\n## Workflow\n\n### Step 1: Resolve Current Task\n\nRun `python3 ./.trellis/scripts/task.py current --source` → active task path. If no active task is set, ask the user where to write output; do NOT guess.\n\nEnsure `{TASK_DIR}/research/` exists:\n\n```bash\nmkdir -p <TASK_DIR>/research\n```\n\n### Step 2: Understand Search Request\n\nClassify: internal / external / mixed. Determine scope (global / specific directory) and expected shape (file list / pattern notes / tech comparison).\n\n### Step 3: Execute Search\n\nRun independent searches in parallel (Glob + Grep + web) for efficiency.\n\n### Step 4: Persist Each Topic\n\nFor each distinct research topic, Write a markdown file at `{TASK_DIR}/research/<topic-slug>.md`. Use the File Format below.\n\n### Step 5: Report to Main Agent\n\nReply with ONLY:\n\n- List of files written (paths relative to repo root)\n- One-line summary per file\n- Any critical caveats that the main agent needs to know right now\n\nDo NOT paste full research content into the reply. The files are the contract.\n\n---\n\n## Scope Limits (Strict)\n\n### Write ALLOWED\n\n- `{TASK_DIR}/research/*.md` — your own output\n- Creating `{TASK_DIR}/research/` if it doesn't exist (via `mkdir -p`)\n\n### Write FORBIDDEN\n\n- Code files (`src/`, `lib/`, …)\n- Spec files (`.trellis/spec/`) — main agent should use `update-spec` skill instead\n- `.trellis/scripts/`, `.trellis/workflow.md`, platform config (`.claude/`, `.cursor/`, etc.)\n- Other task directories\n- Any git operation (commit / push / branch / merge)\n\nIf the user asks you to edit code, decline and suggest spawning `implement` instead.\n\n---\n\n## File Format\n\nEach `{TASK_DIR}/research/<topic>.md` should follow:\n\n```markdown\n# Research: <topic>\n\n- **Query**: <original query>\n- **Scope**: <internal / external / mixed>\n- **Date**: <YYYY-MM-DD>\n\n## Findings\n\n### Files Found\n\n| File Path | Description |\n|---|---|\n| `src/services/xxx.ts` | Main implementation |\n| `src/types/xxx.ts` | Type definitions |\n\n### Code Patterns\n\n<describe patterns, cite file:line>\n\n### External References\n\n- [Library X docs](url) — <why relevant, version constraints>\n\n### Related Specs\n\n- `.trellis/spec/xxx.md` — <description>\n\n## Caveats / Not Found\n\n<anything incomplete or uncertain>\n```\n\n---\n\n## Guidelines\n\n### DO\n\n- Provide specific file paths and line numbers\n- Quote actual code snippets\n- Persist every topic to its own file\n- Return file paths in your reply, not the full content\n- Mark \"not found\" explicitly when searches come up empty\n\n### DON'T\n\n- Don't write code or modify files outside `{TASK_DIR}/research/`\n- Don't guess uncertain info\n- Don't paste full research text into the reply (files are the deliverable)\n- Don't propose improvements or critique implementation (that's not your role)\n",
   "tools": [
     "read",
     "write",

package/dist/templates/markdown/agents.md

@@ -3,20 +3,19 @@
 
 These instructions are for AI assistants working in this project.
 
-Use the `/trellis:start` command when starting a new session to:
-- Initialize your developer identity
-- Understand current project context
-- Read relevant guidelines
+This project is managed by Trellis. The working knowledge you need lives under `.trellis/`:
 
-Use `@/.trellis/` to learn:
-- Development workflow (`workflow.md`)
-- Project structure guidelines (`spec/`)
-- Developer workspace (`workspace/`)
+- `.trellis/workflow.md` — development phases, when to create tasks, skill routing
+- `.trellis/spec/` — package- and layer-scoped coding guidelines (read before writing code in a given layer)
+- `.trellis/workspace/` — per-developer journals and session traces
+- `.trellis/tasks/` — active and archived tasks (PRDs, research, jsonl context)
 
-If you're using Codex, project-scoped helpers may also live in:
-- `.agents/skills/` for reusable Trellis skills
-- `.codex/agents/` for optional custom subagents
+If a Trellis command is available on your platform (e.g. `/trellis:finish-work`, `/trellis:continue`), prefer it over manual steps. Not every platform exposes every command.
 
-Keep this managed block so 'trellis update' can refresh the instructions.
+If you're using Codex or another agent-capable tool, additional project-scoped helpers may live in:
+- `.agents/skills/` — reusable Trellis skills
+- `.codex/agents/` — optional custom subagents
+
+Managed by Trellis. Edits outside this block are preserved; edits inside may be overwritten by a future `trellis update`.
 
 <!-- TRELLIS:END -->

package/dist/templates/markdown/gitignore.txt

@@ -7,6 +7,9 @@
 # Current task pointer (local state)
 .current-task
 
+# Session/window scoped runtime state
+.runtime/
+
 # Agent runtime files (in worktree)
 .agent-log
 .session-id

package/dist/templates/opencode/agents/trellis-check.md

@@ -21,7 +21,7 @@ You are the Check Agent in the Trellis workflow.
 
 Otherwise, load context yourself:
 
-1. Read `.trellis/.current-task` → get task directory (e.g., `.trellis/tasks/xxx`)
+1. Run `python3 ./.trellis/scripts/task.py current --source` → get active task directory and source (e.g., `Current task: .trellis/tasks/xxx`)
 2. Read `{task_dir}/check.jsonl`
 3. For each entry in JSONL:
    - If `path` is a file → Read it

package/dist/templates/opencode/agents/trellis-implement.md

@@ -21,7 +21,7 @@ You are the Implement Agent in the Trellis workflow.
 
 Otherwise, load context yourself:
 
-1. Read `.trellis/.current-task` → get task directory (e.g., `.trellis/tasks/xxx`)
+1. Run `python3 ./.trellis/scripts/task.py current --source` → get active task directory and source (e.g., `Current task: .trellis/tasks/xxx`)
 2. Read `{task_dir}/implement.jsonl`
 3. For each entry in JSONL (JSON object per line):
    - Skip rows without a `"file"` field (e.g. `{"_example": "..."}` seed rows)

package/dist/templates/opencode/agents/trellis-research.md

@@ -6,7 +6,7 @@ permission:
   read: allow
   write: deny
   edit: deny
-  bash: deny
+  bash: allow
   glob: allow
   grep: allow
   mcp__exa__*: allow
@@ -22,7 +22,7 @@ You are the Research Agent in the Trellis workflow.
 
 Otherwise, if task-specific research is needed:
 
-1. Read `.trellis/.current-task` → get task directory (if exists)
+1. Run `python3 ./.trellis/scripts/task.py current --source` → get active task directory and source (if set)
 2. For each entry in JSONL (if task dir exists):
    - If `path` is a file → Read it
    - If `path` is a directory → Read all `.md` files in it

package/dist/templates/opencode/lib/trellis-context.js

@@ -9,6 +9,8 @@ import { existsSync, readFileSync, appendFileSync, readdirSync } from "fs"
 import { isAbsolute, join } from "path"
 import { platform } from "os"
 import { execSync } from "child_process"
+import { createHash } from "crypto"
+import process from "process"
 
 const PYTHON_CMD = platform() === "win32" ? "python" : "python3"
 // Debug logging
@@ -24,6 +26,43 @@ function debugLog(prefix, ...args) {
   }
 }
 
+function stringValue(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : null
+}
+
+function sanitizeKey(raw) {
+  const safe = raw.trim().replace(/[^A-Za-z0-9._-]+/g, "_").replace(/^[._-]+|[._-]+$/g, "")
+  return safe ? safe.slice(0, 160) : ""
+}
+
+function hashValue(raw) {
+  return createHash("sha256").update(raw).digest("hex").slice(0, 24)
+}
+
+function lookupString(data, keys) {
+  if (!data || typeof data !== "object") return null
+  for (const key of keys) {
+    const value = stringValue(data[key])
+    if (value) return value
+  }
+  for (const nestedKey of ["input", "properties", "event", "hook_input", "hookInput"]) {
+    const nested = data[nestedKey]
+    if (nested && typeof nested === "object") {
+      const value = lookupString(nested, keys)
+      if (value) return value
+    }
+  }
+  return null
+}
+
+function buildContextKey(platformName, kind, value) {
+  if (kind === "transcript") {
+    return `${platformName}_transcript_${hashValue(value)}`
+  }
+  const safeValue = sanitizeKey(value)
+  return safeValue ? `${platformName}_${safeValue}` : `${platformName}_${hashValue(value)}`
+}
+
 /**
  * Trellis Context Manager
  */
@@ -41,23 +80,67 @@ export class TrellisContext {
     return existsSync(join(this.directory, ".trellis"))
   }
 
-  /**
-   * Get current task directory from .trellis/.current-task
-   */
-  getCurrentTask() {
+  getContextKey(platformInput = null) {
+    const override = stringValue(process.env.TRELLIS_CONTEXT_ID)
+    if (override) {
+      return sanitizeKey(override) || hashValue(override)
+    }
+
+    const runID = stringValue(process.env.OPENCODE_RUN_ID)
+    if (runID) return buildContextKey("opencode", "session", runID)
+
+    const input = platformInput && typeof platformInput === "object" ? platformInput : null
+    if (!input) return null
+
+    const sessionID = lookupString(input, ["session_id", "sessionId", "sessionID"])
+    if (sessionID) return buildContextKey("opencode", "session", sessionID)
+
+    const conversationID = lookupString(input, ["conversation_id", "conversationId", "conversationID"])
+    if (conversationID) return buildContextKey("opencode", "conversation", conversationID)
+
+    const transcriptPath = lookupString(input, ["transcript_path", "transcriptPath", "transcript"])
+    if (transcriptPath) return buildContextKey("opencode", "transcript", transcriptPath)
+
+    return null
+  }
+
+  readContext(contextKey) {
     try {
-      const currentTaskPath = join(this.directory, ".trellis", ".current-task")
-      if (!existsSync(currentTaskPath)) {
-        return null
-      }
-      const taskRef = readFileSync(currentTaskPath, "utf-8").trim()
-      const normalized = this.normalizeTaskRef(taskRef)
-      return normalized || null
+      const contextPath = join(this.directory, ".trellis", ".runtime", "sessions", `${contextKey}.json`)
+      if (!existsSync(contextPath)) return null
+      return JSON.parse(readFileSync(contextPath, "utf-8"))
     } catch {
       return null
     }
   }
 
+  /**
+   * Get active task from session runtime context.
+   */
+  getActiveTask(platformInput = null) {
+    const contextKey = this.getContextKey(platformInput)
+    if (!contextKey) {
+      return { taskPath: null, source: "none", stale: false }
+    }
+
+    const context = this.readContext(contextKey)
+    const taskRef = this.normalizeTaskRef(context?.current_task || "")
+    if (taskRef) {
+      const taskDir = this.resolveTaskDir(taskRef)
+      return {
+        taskPath: taskRef,
+        source: `session:${contextKey}`,
+        stale: !taskDir || !existsSync(taskDir),
+      }
+    }
+
+    return { taskPath: null, source: "none", stale: false }
+  }
+
+  getCurrentTask(platformInput = null) {
+    return this.getActiveTask(platformInput).taskPath
+  }
+
   normalizeTaskRef(taskRef) {
     if (!taskRef) {
       return ""
@@ -115,13 +198,17 @@ export class TrellisContext {
     return this.readFile(join(this.directory, relativePath))
   }
 
-  runScript(scriptPath, cwd = null) {
+  runScript(scriptPath, cwd = null, contextKey = null) {
     try {
       const result = execSync(`${PYTHON_CMD} "${scriptPath}"`, {
         cwd: cwd || this.directory,
         timeout: 10000,
         encoding: "utf-8",
-        stdio: ["pipe", "pipe", "pipe"]
+        stdio: ["pipe", "pipe", "pipe"],
+        env: {
+          ...process.env,
+          ...(contextKey ? { TRELLIS_CONTEXT_ID: contextKey } : {}),
+        },
       })
       return result || ""
     } catch {

package/dist/templates/opencode/plugins/inject-subagent-context.js

@@ -255,6 +255,46 @@ ${originalPrompt}
   return templates[agentType] || originalPrompt
 }
 
+function shellQuote(value) {
+  return `'${String(value).replace(/'/g, "'\\''")}'`
+}
+
+function getBashCommandKey(args) {
+  if (!args || typeof args !== "object") return null
+  if (typeof args.command === "string") return "command"
+  if (typeof args.cmd === "string") return "cmd"
+  return null
+}
+
+function commandStartsWithTrellisContext(command) {
+  const firstCommand = command.trimStart().split(/[;&|]/, 1)[0].trimStart()
+  return (
+    /^TRELLIS_CONTEXT_ID\s*=/.test(firstCommand) ||
+    /^export\s+TRELLIS_CONTEXT_ID\s*=/.test(firstCommand) ||
+    /^env\s+(?:[^\s=]+\s+)*TRELLIS_CONTEXT_ID\s*=/.test(firstCommand)
+  )
+}
+
+/**
+ * OpenCode TUI may not expose OPENCODE_RUN_ID to Bash. The plugin hook still
+ * receives session identity, so inject it into Bash commands before execution.
+ */
+function injectTrellisContextIntoBash(ctx, input, output) {
+  const args = output?.args
+  const commandKey = getBashCommandKey(args)
+  if (!commandKey) return false
+
+  const command = args[commandKey]
+  if (!command.trim()) return false
+  if (commandStartsWithTrellisContext(command)) return false
+
+  const contextKey = ctx.getContextKey(input)
+  if (!contextKey) return false
+
+  args[commandKey] = `export TRELLIS_CONTEXT_ID=${shellQuote(contextKey)}; ${command}`
+  return true
+}
+
 // OpenCode plugin factory: `export default async (input) => hooks`.
 // OpenCode 1.2.x iterates every module export and invokes it as a function
 // (packages/opencode/src/plugin/index.ts — `for ([_, fn] of Object.entries(mod)) await fn(input)`);
@@ -270,6 +310,13 @@ export default async ({ directory }) => {
           debugLog("inject", "tool.execute.before called, tool:", input?.tool)
 
           const toolName = input?.tool?.toLowerCase()
+          if (toolName === "bash") {
+            if (injectTrellisContextIntoBash(ctx, input, output)) {
+              debugLog("inject", "Injected TRELLIS_CONTEXT_ID into Bash command")
+            }
+            return
+          }
+
           if (toolName !== "task") {
             return
           }
@@ -277,21 +324,24 @@ export default async ({ directory }) => {
           const args = output?.args
           if (!args) return
 
-          const subagentType = args.subagent_type
+          const rawSubagentType = args.subagent_type
+          // Strip "trellis-" prefix added by v0.5.0-beta.5 agent rename migration
+          const subagentType = (rawSubagentType || "").replace(/^trellis-/, "")
           const originalPrompt = args.prompt || ""
 
-          debugLog("inject", "Task tool called, subagent_type:", subagentType)
+          debugLog("inject", "Task tool called, subagent_type:", rawSubagentType)
 
           if (!AGENTS_ALL.includes(subagentType)) {
             debugLog("inject", "Skipping - unsupported subagent_type")
             return
           }
 
-          // Read current task
-          const taskDir = ctx.getCurrentTask()
+          // Resolve active task through session runtime context.
+          const taskDir = ctx.getCurrentTask(input)
 
           // Agents requiring task directory
           if (AGENTS_REQUIRE_TASK.includes(subagentType)) {
+            // subagentType is already stripped of "trellis-" prefix above
             if (!taskDir) {
               debugLog("inject", "Skipping - no current task")
               return

package/dist/templates/opencode/plugins/inject-workflow-state.js

@@ -17,7 +17,7 @@
  *
  * Silently skips when:
  *   - No .trellis/ directory
- *   - No active task (.trellis/.current-task missing or stale)
+ *   - No active task in the session runtime context
  *   - task.json malformed or missing status
  */
 
@@ -32,25 +32,32 @@ const TAG_RE = /\[workflow-state:([A-Za-z0-9_-]+)\]\s*\n([\s\S]*?)\n\s*\[\/workf
 // Hardcoded defaults for built-in Trellis statuses. Used when workflow.md
 // is missing, malformed, or lacks the tag for this status.
 //
-// `no_task` is a pseudo-status emitted when .current-task is missing — keeps
+// `no_task` is a pseudo-status emitted when no session active task exists — keeps
 // the Next-Action reminder flowing per-turn even without an active task.
 const FALLBACK_BREADCRUMBS = {
   no_task:
     "No active task.\n" +
-    "Trigger words in the user message that REQUIRE creating a task " +
-    "(non-negotiable, do NOT self-exempt): 重构 / 抽成 / 独立 / 分发 / " +
-    "拆出来 / 搞一个 / 做成 / 接入 / 集成 / refactor / rewrite / extract / " +
-    "productize / publish / build X / design Y.\n" +
-    "Task is NOT required ONLY if ALL three hold: (a) zero file writes " +
-    "this turn, (b) answer fits in one reply with no multi-round plan, " +
-    "(c) no research beyond reading 1-2 repo files.\n" +
-    "When in doubt: create task. Over-tasking is cheap; under-tasking " +
-    "leaks plans and research into main context.\n" +
+    "Trigger words in the user message that suggest creating a task: " +
+    "重构 / 抽成 / 独立 / 分发 / 拆出来 / 搞一个 / 做成 / 接入 / 集成 / " +
+    "refactor / rewrite / extract / productize / publish / build X / design Y.\n" +
+    "Task is NOT required if ALL three hold: (a) zero file writes this turn, " +
+    "(b) answer fits in one reply with no multi-round plan, (c) no research " +
+    "beyond reading 1-2 repo files.\n" +
+    "When in doubt and no override below applies: prefer creating a task — " +
+    "over-tasking is cheap; under-tasking leaks plans and research into " +
+    "main context.\n" +
     "Flow: load `trellis-brainstorm` skill → it creates the task via " +
     "`python3 ./.trellis/scripts/task.py create` and drives requirements Q&A. " +
     "For research-heavy work (tool comparison, docs, cross-platform survey), " +
     "spawn `trellis-research` sub-agents via Task tool — NEVER do 3+ inline " +
-    "WebFetch/WebSearch/`gh api` calls in the main conversation.",
+    "WebFetch/WebSearch/`gh api` calls in the main conversation.\n" +
+    "User override (per-turn escape hatch): if the user's CURRENT message " +
+    "contains an explicit opt-out phrase (\"跳过 trellis\" / \"别走流程\" / " +
+    "\"小修一下\" / \"直接改\" / \"先别建任务\" / \"skip trellis\" / " +
+    "\"no task\" / \"just do it\" / \"don't create a task\"), honor it for " +
+    "this turn — briefly acknowledge (\"好，本轮跳过 trellis 流程\") and " +
+    "proceed without creating a task. Per-turn only; does not carry forward; " +
+    "do NOT invent an override the user did not say.",
   planning:
     "Complete prd.md via trellis-brainstorm skill; then run task.py start.\n" +
     "Research belongs in `{task_dir}/research/*.md`, written by " +
@@ -58,7 +65,21 @@ const FALLBACK_BREADCRUMBS = {
     "main session — PRD only links to research files.",
   in_progress:
     "Flow: trellis-implement → trellis-check → trellis-update-spec → finish\n" +
-    "Check conversation history + git status to determine current step; do NOT skip trellis-check.",
+    "Next required action: inspect conversation history + git status, then " +
+    "execute the next uncompleted step in that sequence.\n" +
+    "For agent-capable platforms, the default is to dispatch " +
+    "`trellis-implement` for implementation and `trellis-check` before " +
+    "reporting completion — do not edit code in the main session by default.\n" +
+    "Use the exact Trellis agent type names when spawning sub-agents: " +
+    "`trellis-implement`, `trellis-check`, or `trellis-research`. " +
+    "Generic/default/generalPurpose sub-agents do not receive " +
+    "`implement.jsonl` / `check.jsonl` injection.\n" +
+    "User override (per-turn escape hatch): if the user's CURRENT message " +
+    "explicitly tells the main session to handle it directly (\"你直接改\" / " +
+    "\"别派 sub-agent\" / \"main session 写就行\" / \"do it inline\" / " +
+    "\"不用 sub-agent\"), honor it for this turn and edit code directly. " +
+    "Per-turn only; does not carry forward; do NOT invent an override the " +
+    "user did not say.",
   completed:
     "User commits changes; then run task.py archive.",
 }
@@ -88,11 +109,14 @@ function loadBreadcrumbs(directory) {
 /**
  * Get (taskId, status) from active task, or null if no active task.
  */
-function getActiveTask(ctx) {
-  const taskRef = ctx.getCurrentTask()
+function getActiveTask(ctx, platformInput = null) {
+  const active = ctx.getActiveTask(platformInput)
+  const taskRef = active.taskPath
   if (!taskRef) return null
   const taskDir = ctx.resolveTaskDir(taskRef)
-  if (!taskDir || !existsSync(taskDir)) return null
+  if (active.stale || !taskDir || !existsSync(taskDir)) {
+    return { id: taskRef.split("/").pop(), status: "stale", source: active.source }
+  }
   const taskJsonPath = join(taskDir, "task.json")
   if (!existsSync(taskJsonPath)) return null
   try {
@@ -100,7 +124,7 @@ function getActiveTask(ctx) {
     const status = typeof data.status === "string" ? data.status : ""
     if (!status) return null
     const id = data.id || taskRef.split("/").pop()
-    return { id, status }
+    return { id, status, source: active.source }
   } catch {
     return null
   }
@@ -112,12 +136,15 @@ function getActiveTask(ctx) {
  * - Unknown status → generic "refer to workflow.md"
  * - no_task pseudo-status (id === null) → header omits task info
  */
-function buildBreadcrumb(id, status, templates) {
+function buildBreadcrumb(id, status, templates, source = null) {
   let body = templates[status]
   if (body === undefined) {
     body = "Refer to workflow.md for current step."
   }
-  const header = id === null ? `Status: ${status}` : `Task: ${id} (${status})`
+  let header = id === null ? `Status: ${status}` : `Task: ${id} (${status})`
+  if (source) {
+    header = `${header}\nSource: ${source}`
+  }
   return `<workflow-state>\n${header}\n${body}\n</workflow-state>`
 }
 
@@ -138,9 +165,9 @@ export default async ({ directory }) => {
             return
           }
           const templates = loadBreadcrumbs(directory)
-          const task = getActiveTask(ctx)
+          const task = getActiveTask(ctx, input)
           const breadcrumb = task
-            ? buildBreadcrumb(task.id, task.status, templates)
+            ? buildBreadcrumb(task.id, task.status, templates, task.source)
             : buildBreadcrumb(null, "no_task", templates)
 
           const parts = output?.parts || []
@@ -156,9 +183,9 @@ export default async ({ directory }) => {
           debugLog(
             "workflow-state",
             "Injected breadcrumb for task",
-            task.id,
+            task ? task.id : "none",
             "status",
-            task.status,
+            task ? task.status : "no_task",
           )
         } catch (error) {
           debugLog(