@pennixrv/trellis 0.6.39 → 0.6.41

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/migrations/manifests/0.6.41.json

@@ -0,0 +1,9 @@
+{
+  "version": "0.6.41",
+  "description": "Restores active-task visibility when a host context key has no persisted session file.",
+  "breaking": false,
+  "recommendMigrate": false,
+  "changelog": "**Fix:**\n- Projects one unique developer-owned resumable task as read-only workflow context when the host provides a context key whose session file is missing, while still refusing to guess when another 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

@@ -373,10 +373,13 @@ export class TrellisContext {
    *
    * Resolution order (mirrors Python `active_task.resolve_active_task`):
    *   1. Lookup the runtime file for the input-derived context key. A known
-   *      key is authoritative, so a missing or empty context returns no task.
+   *      key is authoritative when it contains a task; a missing or empty
+   *      context may use the guarded unbound-task projection.
    *   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)
@@ -391,6 +394,10 @@ export class TrellisContext {
           stale: !taskDir || !existsSync(taskDir),
         }
       }
+      const unbound = this._resolveUnboundTask()
+      if (unbound) {
+        return unbound
+      }
       return { taskPath: null, source: "none", stale: false }
     }
 
@@ -399,6 +406,11 @@ export class TrellisContext {
       return fallback
     }
 
+    const unbound = this._resolveUnboundTask()
+    if (unbound) {
+      return unbound
+    }
+
     return { taskPath: null, source: "none", stale: false }
   }
 
@@ -440,6 +452,56 @@ 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.some(file => {
+        try {
+          const context = JSON.parse(readFileSync(join(sessionsDir, file), "utf-8"))
+          return Boolean(this.normalizeTaskRef(context?.current_task || ""))
+        } catch {
+          return false
+        }
+      })) 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

@@ -2,8 +2,8 @@
 """Session-scoped active task resolution.
 
 The user-facing concept is a single "active task". Trellis stores that pointer
-per AI session/window under `.trellis/.runtime/sessions/`; without a stable
-session key there is no active task.
+per AI session/window under `.trellis/.runtime/sessions/`; when the pointer is
+missing, a unique developer-owned resumable task may be exposed read-only.
 """
 
 from __future__ import annotations
@@ -654,9 +654,10 @@ def resolve_active_task(
     """Resolve the active task from session runtime state only.
 
     A stale session task is returned as stale. A known context identity is
-    authoritative: a missing or empty context for that identity returns no
-    task. When context identity is unavailable, single-session inference may
-    cover pull-based platform sub-agents (copilot, gemini, qoder) that don't
+    authoritative when it contains a task reference; a missing or empty
+    context may use the guarded unbound-task projection. When context identity
+    is unavailable, single-session inference may cover pull-based platform
+    sub-agents (copilot, gemini, qoder) that don't
     inherit the parent's session id. ≥2 files or 0 files yield
     ActiveTask(None) — refuses to guess across windows.
     """
@@ -671,6 +672,10 @@ def resolve_active_task(
         active = _active_from_ref(task_ref, repo_root, "session", context_key)
         if active:
             return active
+        if allow_single_session_fallback:
+            unbound = _resolve_unbound_task(repo_root)
+            if unbound is not None:
+                return unbound
         return ActiveTask(None, "none", context_key)
 
     if allow_single_session_fallback:
@@ -678,6 +683,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 +715,33 @@ 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():
+        session_files = sorted(sessions_dir.glob("*.json"))
+        if any(_string_value((_read_json(session) or {}).get("current_task")) for session in session_files):
+            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

@@ -76,7 +76,7 @@ python3 ./.trellis/scripts/task.py create-pr [name] [--dry-run]
 
 > Run `python3 ./.trellis/scripts/task.py --help` to see the authoritative, up-to-date list.
 
-**Current-task mechanism**: `task.py create` creates the task directory and (when session identity is available) auto-sets the per-session active-task pointer so the planning breadcrumb fires immediately. `task.py start` writes the same pointer (idempotent if already set) and flips `task.json.status` from `planning` to `in_progress`. State is stored under `.trellis/.runtime/sessions/`. If no context key is available from hook input, `TRELLIS_CONTEXT_ID`, or a platform-native session environment variable, there is no active task and `task.py start` fails with a session identity hint. `task.py finish` deletes the current session file (status unchanged). `task.py archive <task>` writes `status=completed`, moves the directory to `archive/`, and deletes any runtime session files that still point at the archived task.
+**Current-task mechanism**: `task.py create` creates the task directory and (when session identity is available) auto-sets the per-session active-task pointer so the planning breadcrumb fires immediately. `task.py start` writes the same pointer (idempotent if already set) and flips `task.json.status` from `planning` to `in_progress`. State is stored under `.trellis/.runtime/sessions/`. If no context key is available from hook input, `TRELLIS_CONTEXT_ID`, or a platform-native session environment variable, `task.py start` fails with a session identity hint because it cannot persist a session pointer; read-only context may still project one unique developer-owned resumable task. `task.py finish` deletes the current session file (status unchanged). `task.py archive <task>` writes `status=completed`, moves the directory to `archive/`, and deletes any runtime session files that still point at the archived task.
 
 ### Workspace System
 
@@ -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.41",
   "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.41"
   },
   "devDependencies": {
     "@eslint/js": "^9.18.0",