@pennixrv/trellis 0.6.39 → 0.6.40

package/dist/migrations/manifests/0.6.39.json

@@ -1,9 +1,9 @@
 {
   "version": "0.6.39",
-  "description": "Adds direct completion guidance for explicitly classified analysis-only tasks.",
+  "description": "Restores active-task visibility and adds direct completion guidance for analysis-only tasks.",
   "breaking": false,
   "recommendMigrate": false,
-  "changelog": "**Feature:**\n- Analysis-only research, audit, and design tasks can complete declared evidence work directly from planning and archive without entering implementation.",
+  "changelog": "**Fixes:**\n- Projects one unique developer-owned resumable task as read-only workflow context when no session pointer exists.\n- Analysis-only research, audit, and design tasks can complete declared evidence work directly from planning and archive without entering implementation.",
   "migrations": [],
   "notes": "No project migration is required. Existing projects can run the normal trellis update flow."
 }

package/dist/migrations/manifests/0.6.40.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.6.40",
+  "description": "Restores active-task visibility when a session pointer is unavailable.",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Fix:**\n- Projects one unique developer-owned resumable task as read-only workflow context when no Trellis session pointer exists.",
+  "migrations": [],
+  "notes": "No project migration is required. Existing projects can run the normal trellis update flow."
+}

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

@@ -377,6 +377,8 @@ export class TrellisContext {
    *   2. If no context key is available and exactly one session runtime file
    *      exists locally, use it (`_resolveSingleSessionFallback`). Refuses to
    *      guess when 0 or ≥2 files exist so multi-window isolation holds.
+   *   3. If no session file exists, expose one resumable task assigned to the
+   *      current developer as a read-only unbound projection.
    */
   getActiveTask(platformInput = null) {
     const contextKey = this.getContextKey(platformInput)
@@ -399,6 +401,11 @@ export class TrellisContext {
       return fallback
     }
 
+    const unbound = this._resolveUnboundTask()
+    if (unbound) {
+      return unbound
+    }
+
     return { taskPath: null, source: "none", stale: false }
   }
 
@@ -440,6 +447,49 @@ export class TrellisContext {
     }
   }
 
+  _resolveUnboundTask() {
+    const sessionsDir = join(this.directory, ".trellis", ".runtime", "sessions")
+    if (existsSync(sessionsDir)) {
+      let sessionFiles
+      try {
+        sessionFiles = readdirSync(sessionsDir).filter(name => name.endsWith(".json"))
+      } catch {
+        return null
+      }
+      if (sessionFiles.length > 0) return null
+    }
+
+    const developer = (process.env.TRELLIS_DEVELOPER || "").trim() || (() => {
+      try {
+        const content = readFileSync(join(this.directory, ".trellis", ".developer"), "utf-8")
+        return content.split(/\r?\n/).find(line => line.startsWith("name="))?.slice(5).trim() || ""
+      } catch {
+        return ""
+      }
+    })()
+    if (!developer) return null
+
+    const tasksDir = join(this.directory, ".trellis", "tasks")
+    let taskNames
+    try {
+      taskNames = readdirSync(tasksDir).filter(name => name !== "archive")
+    } catch {
+      return null
+    }
+
+    const candidates = taskNames.flatMap(name => {
+      try {
+        const data = JSON.parse(readFileSync(join(tasksDir, name, "task.json"), "utf-8"))
+        if (data.assignee !== developer || !["planning", "in_progress", "review"].includes(data.status)) return []
+        return [`.trellis/tasks/${name}`]
+      } catch {
+        return []
+      }
+    })
+    if (candidates.length !== 1) return null
+    return { taskPath: candidates[0], source: "unbound", stale: false }
+  }
+
   getCurrentTask(platformInput = null) {
     return this.getActiveTask(platformInput).taskPath
   }

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

@@ -156,6 +156,7 @@ function getActiveTask(ctx, platformInput = null) {
     const status = typeof data.status === "string" ? data.status : ""
     if (!status) return null
     const id = data.id || taskRef.split("/").pop()
+    if (active.source === "unbound") return { id, status: "unbound_task", source: active.source }
     return { id, status, source: active.source }
   } catch {
     return null

package/dist/templates/shared-hooks/inject-workflow-state.py

@@ -192,6 +192,8 @@ def get_active_task(
     status = data.get("status", "")
     if not isinstance(status, str) or not status:
         return task_dir.name, "task_error", active.source
+    if active.source_type == "unbound":
+        return task_id, "unbound_task", active.source
     return task_id, status, active.source
 
 

package/dist/templates/trellis/scripts/common/active_task.py

@@ -678,6 +678,10 @@ def resolve_active_task(
         if fallback is not None:
             return fallback
 
+        unbound = _resolve_unbound_task(repo_root)
+        if unbound is not None:
+            return unbound
+
     return ActiveTask(None, "none", context_key)
 
 
@@ -706,6 +710,31 @@ def _resolve_single_session_fallback(repo_root: Path) -> ActiveTask | None:
     return _active_from_ref(task_ref, repo_root, "session-fallback", fallback_key)
 
 
+def _resolve_unbound_task(repo_root: Path) -> ActiveTask | None:
+    """Expose one developer-owned task when no session pointer exists."""
+    sessions_dir = _runtime_sessions_dir(repo_root)
+    if sessions_dir.is_dir() and any(sessions_dir.glob("*.json")):
+        return None
+
+    from .paths import get_developer, get_tasks_dir
+    from .tasks import iter_active_tasks
+
+    developer = get_developer(repo_root)
+    if not developer:
+        return None
+
+    candidates = [
+        task
+        for task in iter_active_tasks(get_tasks_dir(repo_root))
+        if task.assignee == developer and task.status in {"planning", "in_progress", "review"}
+    ]
+    if len(candidates) != 1:
+        return None
+
+    task_path = candidates[0].directory.relative_to(repo_root).as_posix()
+    return ActiveTask(task_path, "unbound", None)
+
+
 def _utc_now() -> str:
     return datetime.now(timezone.utc).replace(microsecond=0).isoformat().replace("+00:00", "Z")
 

package/dist/templates/trellis/scripts/task.py

@@ -308,6 +308,11 @@ def cmd_finish(args: argparse.Namespace) -> int:
         print(colored("No current task set", Colors.YELLOW))
         return 0
 
+    if active.source_type == "unbound":
+        print(colored("Task exists but no direct session is bound; run task.py start first", Colors.YELLOW))
+        print(f"Task: {current}")
+        return 0
+
     try:
         assert_task_mutation_allowed(repo_root, repo_root / current)
     except (OwnershipError, OSError) as exc:

package/dist/templates/trellis/workflow.md

@@ -122,6 +122,7 @@ python3 ./.trellis/scripts/get_context.py --mode phase --step <X.Y>  # detailed
 
   TAG ↔ PHASE scoping:
     [workflow-state:no_task]      → no active task; before Phase 1
+    [workflow-state:unbound_task] → one developer-owned task exists without a session pointer
     [workflow-state:task_error]   → active task record is unreadable; repair it before continuing
     [workflow-state:planning]     → all of Phase 1 (status='planning')
     [workflow-state:planning-inline] → Codex inline variant of Phase 1
@@ -189,6 +190,12 @@ Simple conversation / small task: ask only whether this turn should create a Tre
 Complex task: ask the user if you can create a Trellis task and enter the planning phase. If the user says no, explain, clarify scope, or suggest a smaller split.
 [/workflow-state:no_task]
 
+<!-- Per-turn breadcrumb: shown when one resumable task exists without a direct session binding. -->
+
+[workflow-state:unbound_task]
+An existing task is assigned to the current developer, but this shell has no direct Trellis session binding. Do not create a duplicate task. Continue reading and working from the existing task artifacts; before any lifecycle write or closure, run the native `task.py start <task>` command once a direct session identity is available. Never edit `.trellis/.runtime/sessions/` manually.
+[/workflow-state:unbound_task]
+
 <!-- Per-turn breadcrumb: shown when the active task record cannot be read. -->
 
 [workflow-state:task_error]
@@ -694,6 +701,7 @@ All tag blocks live in the `## Phase Index` section above, immediately after eac
 | Scope | Corresponding tag |
 |---|---|
 | No active task (before Phase 1) | `[workflow-state:no_task]` (after the Phase Index ASCII art) |
+| One developer-owned task without a session binding | `[workflow-state:unbound_task]` (bind before lifecycle writes) |
 | Active task record unreadable | `[workflow-state:task_error]` (repair the existing task before continuing) |
 | All of Phase 1 (task created → ready for implementation) | `[workflow-state:planning]` (after Phase 1 summary) |
 | Codex inline Phase 1 | `[workflow-state:planning-inline]` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pennixrv/trellis",
-  "version": "0.6.39",
+  "version": "0.6.40",
   "description": "AI capabilities grow like ivy — Trellis provides the structure to guide them along a disciplined path",
   "type": "module",
   "main": "./dist/index.js",
@@ -34,7 +34,7 @@
     "inquirer": "^9.3.7",
     "undici": "^6.21.0",
     "zod": "^4.4.2",
-    "@pennixrv/trellis-core": "0.6.39"
+    "@pennixrv/trellis-core": "0.6.40"
   },
   "devDependencies": {
     "@eslint/js": "^9.18.0",