@comfanion/workflow 4.38.2 → 4.38.3-dev.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfanion/workflow",
-  "version": "4.38.2",
+  "version": "4.38.3-dev.0",
   "description": "Initialize OpenCode Workflow system for AI-assisted development with semantic code search",
   "type": "module",
   "bin": {

package/src/build-info.json

@@ -1,6 +1,6 @@
 {
-  "version": "4.38.2",
-  "buildDate": "2026-01-28T10:05:17.810Z",
+  "version": "4.38.3-dev.0",
+  "buildDate": "2026-01-28T10:28:17.932Z",
   "files": [
     ".gitignore",
     "config.yaml",

package/src/opencode/agents/architect.md

@@ -123,7 +123,7 @@ permission:
   </size-awareness>
 
   <phase name="2. Planning">
-    <action>Create tasklist with todowrite()</action>
+    <action>Create tasklist with todowrite() (TODOv2)</action>
     <action>Present plan to user with specific files/changes</action>
     <action>Ask for confirmation with question() tool</action>
     <action>WAIT for user approval before proceeding</action>

package/src/opencode/agents/dev.md

@@ -4,7 +4,7 @@ mode: all            # Can be primary agent or invoked via @dev
 temperature: 0.2
 
 model: anthropic/claude-opus-4-5  # Strong
-#model: z.ai/glm-4.7  # Can break
+#model: zai-coding-plan/glm-4.7  # Can break
 #model: openai/gpt-5.2-codex 
 
 # Tools - FULL ACCESS for implementation
@@ -40,6 +40,7 @@ permission:
   <step n="2">IMMEDIATE: store {user_name}, {communication_language} from .opencode/config.yaml</step>
   <step n="3">Greet user by {user_name}, communicate in {communication_language}</step>
   <step n="4">Understand user request and select appropriate skill</step>
+  <step n="5">Create tasklist with todowrite() (TODOv2)</step>
 
   <search-first critical="MANDATORY - DO THIS BEFORE GLOB/GREP">
     BEFORE using glob or grep, you MUST call search() first:
@@ -68,23 +69,6 @@ permission:
     <r critical="MANDATORY">🔍 SEARCH FIRST: Call search() BEFORE glob when exploring codebase.
        search({ query: "feature pattern", index: "code" }) → THEN glob if needed</r>
   </rules>
-
-  <todo-usage hint="How to use TODO for tracking">
-    <create>
-      todowrite([
-        { id: "story-task-1", content: "Task 1: Create entity", status: "pending", priority: "high" },
-        { id: "story-task-2", content: "Task 2: Add repository", status: "pending", priority: "medium" },
-        ...
-      ])
-    </create>
-    <update-progress>
-      todoread() → get current list
-      todowrite([...list with task.status = "in_progress"])
-    </update-progress>
-    <mark-complete>
-      todowrite([...list with task.status = "completed"])
-    </mark-complete>
-  </todo-usage>
 </activation>
 
 <persona>

package/src/opencode/agents/pm.md

@@ -105,7 +105,7 @@ permission:
   </phase>
 
   <phase name="2. Planning">
-    <action>Create tasklist with todowrite()</action>
+    <action>Create tasklist with todowrite() (TODOv2)</action>
     <action>Present plan to user with specific deliverables</action>
     <action>Ask for confirmation with question() tool</action>
     <action>WAIT for user approval before proceeding</action>

package/src/opencode/config.yaml

@@ -211,7 +211,7 @@ epic_workflow:
   # Run integration tests after each story
   # When true: story done → run integration tests → continue
   # When false: skip per-story integration tests
-  test_after_each_story: false
+  test_after_each_story: true
   
   # Run integration tests after epic complete
   # When true: all stories done → run epic integration tests

package/src/opencode/plugins/__tests__/usethis-todo.test.ts

@@ -2,7 +2,7 @@ import { describe, it, expect, beforeEach, afterEach } from "bun:test"
 import { readFile } from "fs/promises"
 import { join } from "path"
 import { createTempDir, cleanupTempDir } from "./helpers/mock-ctx"
-import { write, update, read } from "../../tools/usethis_todo"
+import { write, update, read, get_by_id } from "../../tools/usethis_todo"
 
 describe("usethis_todo tool", () => {
   let tempDir: string
@@ -28,7 +28,7 @@ describe("usethis_todo tool", () => {
     const output = await write.execute(
       {
         todos: [
-          { id: "A1", content: "First task", status: "ready", priority: "HIGH" },
+          { id: "A1", content: "First task", description: "Longer details", status: "ready", priority: "HIGH" },
           { id: "A2", content: "Second task", status: "pending", priority: "LOW" },
         ],
       },
@@ -41,6 +41,7 @@ describe("usethis_todo tool", () => {
     const enhanced = JSON.parse(await readFile(enhancedPath, "utf-8"))
     expect(enhanced.length).toBe(2)
     expect(enhanced[0].content).toBe("First task")
+    expect(enhanced[0].description).toBe("Longer details")
 
     const nativePath = join(
       process.env.XDG_DATA_HOME!,
@@ -52,6 +53,7 @@ describe("usethis_todo tool", () => {
     const native = JSON.parse(await readFile(nativePath, "utf-8"))
     expect(native.length).toBe(2)
     expect(native[0].content).toContain("First task")
+    expect(native[0].content).toContain("Longer details")
   })
 
   it("update merges by id and can add new tasks", async () => {
@@ -60,7 +62,7 @@ describe("usethis_todo tool", () => {
     await write.execute(
       {
         todos: [
-          { id: "A1", content: "First task", status: "pending", priority: "MED" },
+          { id: "A1", content: "First task", description: "v1", status: "pending", priority: "MED" },
         ],
       },
       ctx
@@ -69,7 +71,7 @@ describe("usethis_todo tool", () => {
     const result = await update.execute(
       {
         todos: [
-          { id: "A1", content: "First task", status: "done", priority: "MED" },
+          { id: "A1", content: "First task", description: "v2", status: "done", priority: "MED" },
           { id: "A2", content: "Second task", status: "ready", priority: "LOW" },
         ],
       },
@@ -82,6 +84,7 @@ describe("usethis_todo tool", () => {
     const enhanced = JSON.parse(await readFile(enhancedPath, "utf-8"))
     expect(enhanced.length).toBe(2)
     expect(enhanced.find((t: any) => t.id === "A1")?.status).toBe("done")
+    expect(enhanced.find((t: any) => t.id === "A1")?.description).toBe("v2")
   })
 
   it("read returns graph with content", async () => {
@@ -99,4 +102,37 @@ describe("usethis_todo tool", () => {
     expect(output).toContain("Task content")
     expect(output).toContain("Available Now")
   })
+
+  it("get_by_id returns single task", async () => {
+    const ctx = { sessionID: "sess-get", directory: tempDir } as any
+    await write.execute(
+      {
+        todos: [
+          {
+            id: "A1",
+            content: "Task content",
+            description: "More details",
+            status: "ready",
+            priority: "HIGH",
+            blockedBy: ["B1"],
+          },
+        ],
+      },
+      ctx
+    )
+
+    const out = await get_by_id.execute({ id: "A1" }, ctx)
+    expect(out).toContain("id: A1")
+    expect(out).toContain("content:")
+    expect(out).toContain("Task content")
+    expect(out).toContain("blockedBy: B1")
+    expect(out).toContain("description:")
+    expect(out).toContain("More details")
+  })
+
+  it("get_by_id returns not found", async () => {
+    const ctx = { sessionID: "sess-miss", directory: tempDir } as any
+    const out = await get_by_id.execute({ id: "NOPE" }, ctx)
+    expect(out).toContain("not found")
+  })
 })

package/src/opencode/tools/usethis_todo.ts

@@ -30,7 +30,8 @@ import fs from "fs/promises"
 
 interface Todo {
   id: string              // E01-S01-T01
-  content: string         // Full task description
+  content: string         // Short task summary
+  description?: string    // Full task description (optional)
   status: string          // pending | ready | in_progress | waiting_review | done | cancelled
   priority: string        // CRIT | HIGH | MED | LOW
   blockedBy?: string[]    // IDs of blocking tasks
@@ -117,10 +118,11 @@ function toNative(todo: Todo): NativeTodo {
   }
   
   const deps = todo.blockedBy?.length ? ` [← ${todo.blockedBy.join(", ")}]` : ""
+  const desc = todo.description?.trim() ? ` — ${todo.description.trim()}` : ""
 
   return {
     id: todo.id,
-    content: `${todo.content}${deps}`,
+    content: `${todo.content}${desc}${deps}`,
     status: statusMap[todo.status] || "pending",
     priority: prioMap[todo.priority] || "medium",
   }
@@ -220,7 +222,8 @@ function formatGraph(graph: TodoGraph): string {
   lines.push("All Tasks:")
   for (const t of todos) {
     const deps = t.blockedBy?.length ? ` ← ${t.blockedBy.join(", ")}` : ""
-    lines.push(`  ${SI(t.status)} ${PE(t.priority)} ${t.id}: ${t.content}${deps}`)
+    const desc = t.description?.trim() ? ` — ${t.description.trim()}` : ""
+    lines.push(`  ${SI(t.status)} ${PE(t.priority)} ${t.id}: ${t.content}${desc}${deps}`)
   }
   lines.push("")
   
@@ -228,7 +231,8 @@ function formatGraph(graph: TodoGraph): string {
     lines.push("Available Now:")
     for (const id of graph.available) {
       const t = todos.find(x => x.id === id)
-      lines.push(`  → ${PE(t?.priority)} ${id}: ${t?.content}`)
+      const desc = t?.description?.trim() ? ` — ${t.description.trim()}` : ""
+      lines.push(`  → ${PE(t?.priority)} ${id}: ${t?.content}${desc}`)
     }
   } else {
     lines.push("Available Now: none")
@@ -246,7 +250,8 @@ function formatGraph(graph: TodoGraph): string {
     lines.push("Blocked:")
     for (const [id, blockers] of Object.entries(graph.blocked)) {
       const t = todos.find(x => x.id === id)
-      lines.push(`  ⊗ ${id}: ${t?.content} ← waiting: ${blockers.join(", ")}`)
+      const desc = t?.description?.trim() ? ` — ${t.description.trim()}` : ""
+      lines.push(`  ⊗ ${id}: ${t?.content}${desc} ← waiting: ${blockers.join(", ")}`)
     }
   }
   
@@ -258,12 +263,13 @@ function formatGraph(graph: TodoGraph): string {
 // ============================================================================
 
 export const write = tool({
-  description: "Create or update TODO list. TODOv2",
+  description: "Create or update TODO list. TODOv2 (Prefer this instead of TODO)",
   args: {
     todos: tool.schema.array(
       tool.schema.object({
         id: tool.schema.string().describe("Task ID in concat format: E01-S01-T01"),
-        content: tool.schema.string().describe("Full task description"),
+        content: tool.schema.string().describe("Short task summary"),
+        description: tool.schema.string().optional().describe("Full task description"),
         status: tool.schema.string().describe("pending | ready | in_progress | waiting_review | done | cancelled"),
         priority: tool.schema.string().describe("CRIT | HIGH | MED | LOW"),
         blockedBy: tool.schema.array(tool.schema.string()).optional().describe("IDs of blocking tasks"),
@@ -272,7 +278,7 @@ export const write = tool({
   },
   async execute(args, context) {
     const now = Date.now()
-    const todos = args.todos.map(t => ({ ...t, createdAt: t.createdAt || now, updatedAt: now }))
+    const todos = args.todos.map((t: any) => ({ ...t, createdAt: t.createdAt || now, updatedAt: now }))
     await writeTodos(todos, context.sessionID, context.directory)
     return formatGraph(analyzeGraph(todos))
   },
@@ -290,7 +296,8 @@ export const read_next_five = tool({
     for (const id of next5) {
       const t = graph.todos.find(x => x.id === id)
       if (t) {
-        lines.push(`${PE(t.priority)} ${id}: ${t.content}`)
+        const desc = t.description?.trim() ? `\n   ${t.description.trim()}` : ""
+        lines.push(`${PE(t.priority)} ${id}: ${t.content}${desc}`)
         lines.push("")
       }
     }
@@ -309,13 +316,37 @@ export const read = tool({
   },
 })
 
+export const get_by_id = tool({
+  description: "Get one task by id.",
+  args: {
+    id: tool.schema.string().describe("Task ID"),
+  },
+  async execute(args, context) {
+    const todos = await readTodos(context.sessionID, context.directory)
+    const todo = todos.find(t => t.id === args.id)
+    if (!todo) return `❌ Task ${args.id} not found`
+
+    const deps = todo.blockedBy?.length ? `\nblockedBy: ${todo.blockedBy.join(", ")}` : ""
+    const desc = todo.description?.trim() ? `\n\ndescription:\n${todo.description.trim()}` : ""
+    return [
+      `id: ${todo.id}`,
+      `priority: ${todo.priority}`,
+      `status: ${todo.status}`,
+      deps,
+      `\ncontent:\n${todo.content}`,
+      desc,
+    ].filter(Boolean).join("\n")
+  },
+})
+
 export const update = tool({
   description: "Update tasks. Same interface as write, but merges by id.",
   args: {
     todos: tool.schema.array(
       tool.schema.object({
         id: tool.schema.string().describe("Task ID in concat format: E01-S01-T01"),
-        content: tool.schema.string().describe("Full task description"),
+        content: tool.schema.string().describe("Short task summary"),
+        description: tool.schema.string().optional().describe("Full task description"),
         status: tool.schema.string().describe("pending | ready | in_progress | waiting_review | done | cancelled"),
         priority: tool.schema.string().describe("CRIT | HIGH | MED | LOW"),
         blockedBy: tool.schema.array(tool.schema.string()).optional().describe("IDs of blocking tasks"),