@pennixrv/trellis 0.6.40 → 0.6.41

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,7 +373,8 @@ 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.
@@ -393,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 }
     }
 
@@ -456,7 +461,14 @@ export class TrellisContext {
       } catch {
         return null
       }
-      if (sessionFiles.length > 0) 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() || (() => {

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:
@@ -713,8 +718,10 @@ def _resolve_single_session_fallback(repo_root: Path) -> ActiveTask | None:
 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
+    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

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
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pennixrv/trellis",
-  "version": "0.6.40",
+  "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.40"
+    "@pennixrv/trellis-core": "0.6.41"
   },
   "devDependencies": {
     "@eslint/js": "^9.18.0",