@blulotus/trellis 0.7.0 → 0.7.2

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

@@ -119,32 +119,14 @@ def _repo_relative_path(path: Path, repo_root: Path) -> str:
 # Keep in sync with src/types/ai-tools.ts AI_TOOLS entries — these are the
 # platforms listed in workflow.md's "agent-capable" Skill Routing block.
 # Codex is checked separately because explicit inline mode does not consume
-# JSONL. Kilo / Antigravity / Devin are NOT in this list either: they load
-# specs through skills instead of JSONL.
-_SUBAGENT_CONFIG_DIRS: tuple[str, ...] = (
-    ".claude",
-    ".cursor",
-    ".kiro",
-    ".gemini",
-    ".opencode",
-    ".qoder",
-    ".codebuddy",
-    ".factory",   # Factory Droid
-    ".github/copilot",
-    ".pi",        # Pi Agent
-    ".trae",      # Trae IDE
-    ".omp",       # Oh My Pi
-    ".zcode",     # ZCode
-    ".grok",      # Grok Build
-    ".kimi-code", # Kimi Code
-    ".dsh",       # DeepSeek Harness
-)
+# JSONL.
+_SUBAGENT_CONFIG_DIRS: tuple[str, ...] = (".claude",)
 _CODEX_CONFIG_DIR = ".codex"
 
 _SEED_EXAMPLE = (
     "Fill with {\"file\": \"<path>\", \"reason\": \"<why>\"}. "
     "Put spec/research files only — no code paths. "
-    "Run `python3 .trellis/scripts/get_context.py --mode packages` to list available specs. "
+    "Run `python .trellis/scripts/get_context.py --mode packages` to list available specs. "
     "Delete this line once real entries are added."
 )
 
@@ -428,8 +410,6 @@ def cmd_create(args: argparse.Namespace) -> int:
 
     # Seed implement.jsonl / check.jsonl for sub-agent-capable platforms.
     # Agent curates real entries during planning when the task needs them.
-    # Agent-less platforms (Kilo / Antigravity / Devin) skip this — they
-    # load specs via the trellis-before-dev skill instead of JSONL.
     seeded_jsonl = False
     if _has_subagent_platform(repo_root):
         for jsonl_name in ("implement.jsonl", "check.jsonl"):
@@ -871,7 +851,7 @@ def cmd_set_branch(args: argparse.Namespace) -> int:
 
     if not branch:
         print(colored("Error: Missing arguments", Colors.RED))
-        print("Usage: python3 task.py set-branch <task-dir> <branch-name>")
+        print("Usage: python task.py set-branch <task-dir> <branch-name>")
         return 1
 
     if not target_dir:
@@ -908,8 +888,8 @@ def cmd_set_base_branch(args: argparse.Namespace) -> int:
 
     if not base_branch:
         print(colored("Error: Missing arguments", Colors.RED))
-        print("Usage: python3 task.py set-base-branch <task-dir> <base-branch>")
-        print("Example: python3 task.py set-base-branch <dir> develop")
+        print("Usage: python task.py set-base-branch <task-dir> <base-branch>")
+        print("Example: python task.py set-base-branch <dir> develop")
         print()
         print("This sets the target branch for PR (the branch your feature will merge into).")
         return 1
@@ -949,7 +929,7 @@ def cmd_set_scope(args: argparse.Namespace) -> int:
 
     if not scope:
         print(colored("Error: Missing arguments", Colors.RED))
-        print("Usage: python3 task.py set-scope <task-dir> <scope>")
+        print("Usage: python task.py set-scope <task-dir> <scope>")
         return 1
 
     if not target_dir:
@@ -987,7 +967,7 @@ def cmd_set_meta(args: argparse.Namespace) -> int:
 
     if not key:
         print(colored("Error: Missing arguments", Colors.RED))
-        print("Usage: python3 task.py set-meta <task-dir> <key> <value>")
+        print("Usage: python task.py set-meta <task-dir> <key> <value>")
         return 1
 
     if not target_dir:

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

@@ -8,9 +8,9 @@ platform-specific blocks.
 
 Platform marker syntax in workflow.md:
 
-    [Claude Code, Cursor, ...]
+    [Claude Code, ...]
     agent-capable content
-    [/Claude Code, Cursor, ...]
+    [/Claude Code, ...]
 
 Provides:
     get_phase_index   - Extract the Phase Index section (no --step)
@@ -133,7 +133,7 @@ def get_step(step_id: str) -> str:
 
 
 def _platform_matches(platform: str, block_names: list[str]) -> bool:
-    """Case-insensitive fuzzy match: accept 'cursor', 'Cursor', 'claude-code', 'Claude Code'."""
+    """Case-insensitive fuzzy match: accept 'codex', 'Codex', 'claude-code', 'Claude Code'."""
     needle = platform.lower().replace("-", "").replace("_", "").replace(" ", "")
     for name in block_names:
         hay = name.lower().replace("-", "").replace("_", "").replace(" ", "")
@@ -155,9 +155,6 @@ _PLATFORM_MARKER_LABELS: dict[str, str] = {
     # registry id keeps a non-empty routing section, so a missing entry fails
     # there rather than silently blanking that platform's routing.
     "claude": "Claude Code",
-    "kimi": "Kimi Code",
-    "omp": "Oh My Pi",
-    "dsh": "DeepSeek Harness",
 }
 
 
@@ -168,8 +165,7 @@ def resolve_effective_platform(platform: str, config: dict) -> str:
     default or ``"codex-inline"`` when explicitly configured in
     ``.trellis/config.yaml``. ``sub-agent`` remains an alias for ``auto``.
     ``filter_platform`` then surfaces blocks whose marker lists include the
-    namespaced name (e.g. ``[codex-sub-agent, ...]`` or ``[codex-inline, Kilo,
-    Antigravity, Devin]``).
+    namespaced name (e.g. ``[codex-sub-agent, ...]`` or ``[codex-inline]``).
 
     Native Codex context injection supports the ``auto`` default. Invalid
     explicit values fall back to ``inline`` safely; this renderer deliberately

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

@@ -3,8 +3,8 @@
 Get Session Context for AI Agent.
 
 Usage:
-    python3 get_context.py           Output context in text format
-    python3 get_context.py --json    Output context in JSON format
+    python get_context.py           Output context in text format
+    python get_context.py --json    Output context in JSON format
 """
 
 from __future__ import annotations

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

@@ -3,7 +3,7 @@
 Initialize developer for workflow.
 
 Usage:
-    python3 init_developer.py <developer-name>
+    python init_developer.py <developer-name>
 
 This creates:
     - .trellis/.developer file with developer info

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

@@ -4,23 +4,23 @@
 Task Management Script.
 
 Usage:
-    python3 task.py create "<title>" [--slug <name>] [--assignee <dev>] [--priority P0|P1|P2|P3] [--parent <dir>] [--package <pkg>] [--no-start]
-    python3 task.py add-context <dir> <file> <path> [reason] # Add jsonl entry
-    python3 task.py validate <dir>              # Validate jsonl files
-    python3 task.py list-context <dir>          # List jsonl entries
-    python3 task.py start <dir>                 # Set active task
-    python3 task.py current [--source] [--json] # Show active task
-    python3 task.py finish                      # Clear active task
-    python3 task.py workflow <id>|--clear       # Set/clear per-task workflow selection
-    python3 task.py set-branch <dir> <branch>   # Set git branch
-    python3 task.py set-base-branch <dir> <branch>  # Set PR target branch
-    python3 task.py set-scope <dir> <scope>     # Set scope for PR title
-    python3 task.py set-meta <dir> <key> <value>  # Set a task metadata key
-    python3 task.py archive <task-dir>          # Archive completed task
-    python3 task.py list                        # List active tasks
-    python3 task.py list-archive [month]        # List archived tasks
-    python3 task.py add-subtask <parent-dir> <child-dir>     # Link child to parent
-    python3 task.py remove-subtask <parent-dir> <child-dir>  # Unlink child from parent
+    python task.py create "<title>" [--slug <name>] [--assignee <dev>] [--priority P0|P1|P2|P3] [--parent <dir>] [--package <pkg>] [--no-start]
+    python task.py add-context <dir> <file> <path> [reason] # Add jsonl entry
+    python task.py validate <dir>              # Validate jsonl files
+    python task.py list-context <dir>          # List jsonl entries
+    python task.py start <dir>                 # Set active task
+    python task.py current [--source] [--json] # Show active task
+    python task.py finish                      # Clear active task
+    python task.py workflow <id>|--clear       # Set/clear per-task workflow selection
+    python task.py set-branch <dir> <branch>   # Set git branch
+    python task.py set-base-branch <dir> <branch>  # Set PR target branch
+    python task.py set-scope <dir> <scope>     # Set scope for PR title
+    python task.py set-meta <dir> <key> <value>  # Set a task metadata key
+    python task.py archive <task-dir>          # Archive completed task
+    python task.py list                        # List active tasks
+    python task.py list-archive [month]        # List archived tasks
+    python task.py add-subtask <parent-dir> <child-dir>     # Link child to parent
+    python task.py remove-subtask <parent-dir> <child-dir>  # Unlink child from parent
 """
 
 from __future__ import annotations
@@ -41,6 +41,7 @@ from common.paths import (
 )
 from common.active_task import (
     clear_active_task,
+    mark_session_engaged,
     resolve_active_task,
     resolve_context_key,
     set_active_task,
@@ -69,9 +70,36 @@ from common.task_context import (
 
 
 # =============================================================================
-# Command: start / finish
+# Command: engage / start / finish
 # =============================================================================
 
+def cmd_engage(args: argparse.Namespace) -> int:
+    """Opt this session into the Trellis workflow."""
+    repo_root = get_repo_root()
+    context_key = mark_session_engaged(repo_root)
+
+    if context_key:
+        print(colored(f"✓ Trellis engaged for this session: {context_key}", Colors.GREEN))
+        return 0
+
+    # Unlike `start`, engage has no useful degraded mode: without a persisted
+    # flag both context-injection hooks stay silent for the whole session, so
+    # every later phase would run without the per-turn breadcrumb that enforces
+    # the planning and commit gates. Fail loudly instead of half-working.
+    print(colored("Error: cannot engage — no session identity available", Colors.RED))
+    print(colored(
+        "The engaged flag is keyed by session, so without an identity the "
+        "context-injection hooks cannot tell this session opted in.",
+        Colors.YELLOW,
+    ))
+    print(colored(
+        "Hint: run inside an AI session whose hooks are active, or set "
+        "TRELLIS_CONTEXT_ID before running task.py engage.",
+        Colors.YELLOW,
+    ))
+    return 1
+
+
 def cmd_start(args: argparse.Namespace) -> int:
     """Set active task."""
     repo_root = get_repo_root()
@@ -229,7 +257,7 @@ def cmd_workflow(args: argparse.Namespace) -> int:
         return 1
     if not args.clear and not args.id:
         print(colored("Error: workflow id required (or --clear)", Colors.RED))
-        print("Usage: python3 task.py workflow <id> | --clear")
+        print("Usage: python task.py workflow <id> | --clear")
         return 1
 
     active = resolve_active_task(repo_root)
@@ -456,28 +484,29 @@ def show_usage() -> None:
     print("""Task Management Script
 
 Usage:
-  python3 task.py create <title>                     Create new task directory
-  python3 task.py create <title> --package <pkg>     Create task for a specific package
-  python3 task.py create <title> --parent <dir>      Create task as child of parent
-  python3 task.py create <title> --no-start          Create without making it active in this session
-  python3 task.py create <title> --workflow <id>     Create task pinned to a workflow variant
-  python3 task.py add-context <dir> <jsonl> <path> [reason]  Add entry to jsonl
-  python3 task.py validate <dir>                     Validate jsonl files
-  python3 task.py list-context <dir>                 List jsonl entries
-  python3 task.py start <dir>                        Set active task
-  python3 task.py current [--source]                 Show active task
-  python3 task.py finish                             Clear active task
-  python3 task.py workflow <id>                      Select workflow variant for active task
-  python3 task.py workflow --clear                   Clear selection (use default resolution)
-  python3 task.py set-branch <dir> <branch>          Set git branch
-  python3 task.py set-base-branch <dir> <branch>     Set PR target branch
-  python3 task.py set-scope <dir> <scope>            Set scope for PR title
-  python3 task.py set-meta <dir> <key> <value>       Set/overwrite a task metadata key
-  python3 task.py archive <task-dir>                 Archive completed task
-  python3 task.py add-subtask <parent> <child>       Link child task to parent
-  python3 task.py remove-subtask <parent> <child>    Unlink child from parent
-  python3 task.py list [--mine] [--status <status>] [--json]  List tasks
-  python3 task.py list-archive [YYYY-MM]             List archived tasks
+  python task.py create <title>                     Create new task directory
+  python task.py create <title> --package <pkg>     Create task for a specific package
+  python task.py create <title> --parent <dir>      Create task as child of parent
+  python task.py create <title> --no-start          Create without making it active in this session
+  python task.py create <title> --workflow <id>     Create task pinned to a workflow variant
+  python task.py add-context <dir> <jsonl> <path> [reason]  Add entry to jsonl
+  python task.py validate <dir>                     Validate jsonl files
+  python task.py list-context <dir>                 List jsonl entries
+  python task.py engage                             Opt this session into the Trellis workflow
+  python task.py start <dir>                        Set active task
+  python task.py current [--source]                 Show active task
+  python task.py finish                             Clear active task
+  python task.py workflow <id>                      Select workflow variant for active task
+  python task.py workflow --clear                   Clear selection (use default resolution)
+  python task.py set-branch <dir> <branch>          Set git branch
+  python task.py set-base-branch <dir> <branch>     Set PR target branch
+  python task.py set-scope <dir> <scope>            Set scope for PR title
+  python task.py set-meta <dir> <key> <value>       Set/overwrite a task metadata key
+  python task.py archive <task-dir>                 Archive completed task
+  python task.py add-subtask <parent> <child>       Link child task to parent
+  python task.py remove-subtask <parent> <child>    Unlink child from parent
+  python task.py list [--mine] [--status <status>] [--json]  List tasks
+  python task.py list-archive [YYYY-MM]             List archived tasks
 
 Monorepo options:
   --package <pkg>      Package name (validated against config.yaml packages)
@@ -488,21 +517,21 @@ List options:
   --json               Output machine-readable JSON (also available on `current`)
 
 Examples:
-  python3 task.py create "Add login feature" --slug add-login
-  python3 task.py create "Add login feature" --slug add-login --package cli
-  python3 task.py create "Add login feature" --meta linear=ENG-123 --meta epic=auth
-  python3 task.py create "Child task" --slug child --parent .trellis/tasks/01-21-parent
-  python3 task.py add-context <dir> implement .trellis/spec/cli/backend/auth.md "Auth guidelines"
-  python3 task.py set-branch <dir> task/add-login
-  python3 task.py start .trellis/tasks/01-21-add-login
-  python3 task.py current --source
-  python3 task.py finish
-  python3 task.py archive add-login
-  python3 task.py add-subtask parent-task child-task  # Link existing tasks
-  python3 task.py remove-subtask parent-task child-task
-  python3 task.py list                               # List all active tasks
-  python3 task.py list --mine                        # List my tasks only
-  python3 task.py list --mine --status in_progress   # List my in-progress tasks
+  python task.py create "Add login feature" --slug add-login
+  python task.py create "Add login feature" --slug add-login --package cli
+  python task.py create "Add login feature" --meta linear=ENG-123 --meta epic=auth
+  python task.py create "Child task" --slug child --parent .trellis/tasks/01-21-parent
+  python task.py add-context <dir> implement .trellis/spec/cli/backend/auth.md "Auth guidelines"
+  python task.py set-branch <dir> task/add-login
+  python task.py start .trellis/tasks/01-21-add-login
+  python task.py current --source
+  python task.py finish
+  python task.py archive add-login
+  python task.py add-subtask parent-task child-task  # Link existing tasks
+  python task.py remove-subtask parent-task child-task
+  python task.py list                               # List all active tasks
+  python task.py list --mine                        # List my tasks only
+  python task.py list --mine --status in_progress   # List my in-progress tasks
 """)
 
 
@@ -533,7 +562,7 @@ def main() -> int:
         )
         print("See .trellis/workflow.md planning artifact guidance or run:", file=sys.stderr)
         print(
-            "  python3 ./.trellis/scripts/get_context.py --mode phase --step 1",
+            "  python ./.trellis/scripts/get_context.py --mode phase --step 1",
             file=sys.stderr,
         )
         print(
@@ -591,6 +620,9 @@ def main() -> int:
     p_listctx = subparsers.add_parser("list-context", help="List context entries")
     p_listctx.add_argument("dir", help="Task directory")
 
+    # engage
+    subparsers.add_parser("engage", help="Opt this session into the Trellis workflow")
+
     # start
     p_start = subparsers.add_parser("start", help="Set active task")
     p_start.add_argument("dir", help="Task directory")
@@ -668,6 +700,7 @@ def main() -> int:
         "add-context": cmd_add_context,
         "validate": cmd_validate,
         "list-context": cmd_list_context,
+        "engage": cmd_engage,
         "start": cmd_start,
         "current": cmd_current,
         "finish": cmd_finish,