@mindfoldhq/trellis 0.4.0 → 0.5.0-beta.10

package/dist/templates/claude/index.d.ts

@@ -1,54 +1,22 @@
 /**
  * Claude Code templates
  *
- * These are GENERIC templates for user projects.
- * Do NOT use Trellis project's own .claude/ directory (which may be customized).
- *
  * Directory structure:
  *   claude/
- *   ├── commands/       # Slash commands
- *   ├── agents/         # Multi-agent pipeline agents
- *   ├── hooks/          # Context injection hooks
+ *   ├── agents/         # Sub-agent definitions
  *   └── settings.json   # Settings configuration
+ *
+ * Hooks come from shared-hooks/ (unified with other platforms).
  */
 export declare const settingsTemplate: string;
-/**
- * Command template with name and content
- */
-export interface CommandTemplate {
-    name: string;
-    content: string;
-}
-/**
- * Agent template with name and content
- */
 export interface AgentTemplate {
     name: string;
     content: string;
 }
-/**
- * Hook template with target path and content
- */
-export interface HookTemplate {
+export interface SettingsTemplate {
     targetPath: string;
     content: string;
 }
-/**
- * Get all command templates
- * Commands are stored in commands/trellis/ subdirectory
- * This creates commands like /trellis:start, /trellis:finish-work, etc.
- */
-export declare function getAllCommands(): CommandTemplate[];
-/**
- * Get all agent templates
- */
 export declare function getAllAgents(): AgentTemplate[];
-/**
- * Get all hook templates
- */
-export declare function getAllHooks(): HookTemplate[];
-/**
- * Get settings template
- */
-export declare function getSettingsTemplate(): HookTemplate;
+export declare function getSettingsTemplate(): SettingsTemplate;
 //# sourceMappingURL=index.d.ts.map

package/dist/templates/claude/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAsBH,eAAO,MAAM,gBAAgB,QAAgC,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,eAAe,EAAE,CAalD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,aAAa,EAAE,CAa9C;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,YAAY,EAAE,CAU5C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,CAKlD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAqBH,eAAO,MAAM,gBAAgB,QAAgC,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,YAAY,IAAI,aAAa,EAAE,CAa9C;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD"}

package/dist/templates/claude/index.js

@@ -1,15 +1,12 @@
 /**
  * Claude Code templates
  *
- * These are GENERIC templates for user projects.
- * Do NOT use Trellis project's own .claude/ directory (which may be customized).
- *
  * Directory structure:
  *   claude/
- *   ├── commands/       # Slash commands
- *   ├── agents/         # Multi-agent pipeline agents
- *   ├── hooks/          # Context injection hooks
+ *   ├── agents/         # Sub-agent definitions
  *   └── settings.json   # Settings configuration
+ *
+ * Hooks come from shared-hooks/ (unified with other platforms).
  */
 import { readdirSync, readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
@@ -27,28 +24,7 @@ function listFiles(dir) {
         return [];
     }
 }
-// Settings
 export const settingsTemplate = readTemplate("settings.json");
-/**
- * Get all command templates
- * Commands are stored in commands/trellis/ subdirectory
- * This creates commands like /trellis:start, /trellis:finish-work, etc.
- */
-export function getAllCommands() {
-    const commands = [];
-    const files = listFiles("commands/trellis");
-    for (const file of files) {
-        if (file.endsWith(".md")) {
-            const name = file.replace(".md", "");
-            const content = readTemplate(`commands/trellis/${file}`);
-            commands.push({ name, content });
-        }
-    }
-    return commands;
-}
-/**
- * Get all agent templates
- */
 export function getAllAgents() {
     const agents = [];
     const files = listFiles("agents");
@@ -61,21 +37,6 @@ export function getAllAgents() {
     }
     return agents;
 }
-/**
- * Get all hook templates
- */
-export function getAllHooks() {
-    const hooks = [];
-    const files = listFiles("hooks");
-    for (const file of files) {
-        const content = readTemplate(`hooks/${file}`);
-        hooks.push({ targetPath: `hooks/${file}`, content });
-    }
-    return hooks;
-}
-/**
- * Get settings template
- */
 export function getSettingsTemplate() {
     return {
         targetPath: "settings.json",

package/dist/templates/claude/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,WAAW;AACX,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AA0B9D;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,SAAS,CAAC,kBAAkB,CAAC,CAAC;IAE5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrC,MAAM,OAAO,GAAG,YAAY,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;YACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrC,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,SAAS,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,UAAU,EAAE,eAAe;QAC3B,OAAO,EAAE,gBAAgB;KAC1B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AAY9D,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAElC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrC,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,UAAU,EAAE,eAAe;QAC3B,OAAO,EAAE,gBAAgB;KAC1B,CAAC;AACJ,CAAC"}

package/dist/templates/claude/settings.json

@@ -1,4 +1,7 @@
 {
+  "env": {
+    "CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR": "1"
+  },
   "statusLine": {
     "type": "command",
     "command": "{{PYTHON_CMD}} .claude/hooks/statusline.py"
@@ -58,14 +61,13 @@
         ]
       }
     ],
-    "SubagentStop": [
+    "UserPromptSubmit": [
       {
-        "matcher": "check",
         "hooks": [
           {
             "type": "command",
-            "command": "{{PYTHON_CMD}} .claude/hooks/ralph-loop.py",
-            "timeout": 10
+            "command": "{{PYTHON_CMD}} .claude/hooks/inject-workflow-state.py",
+            "timeout": 5
           }
         ]
       }

package/dist/templates/{iflow/agents/check.md → codebuddy/agents/trellis-check.md}

@@ -1,9 +1,8 @@
 ---
-name: check
+name: trellis-check
 description: |
   Code quality check expert. Reviews code changes against specs and self-fixes issues.
 tools: Read, Write, Edit, Bash, Glob, Grep, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa
-color: orange
 ---
 # Check Agent
 
@@ -65,32 +64,6 @@ If failed, fix issues and re-run.
 
 ---
 
-## Completion Markers (Ralph Loop)
-
-**CRITICAL**: You are in a loop controlled by the Ralph Loop system.
-The loop will NOT stop until you output ALL required completion markers.
-
-Completion markers are generated from `check.jsonl` in the task directory.
-Each entry's `reason` field becomes a marker: `{REASON}_FINISH`
-
-For example, if check.jsonl contains:
-```json
-{"file": "...", "reason": "TypeCheck"}
-{"file": "...", "reason": "Lint"}
-{"file": "...", "reason": "CodeReview"}
-```
-
-You MUST output these markers when each check passes:
-- `TYPECHECK_FINISH` - After typecheck passes
-- `LINT_FINISH` - After lint passes
-- `CODEREVIEW_FINISH` - After code review passes
-
-If check.jsonl doesn't exist or has no reasons, output: `ALL_CHECKS_FINISH`
-
-**The loop will block you from stopping until all markers are present in your output.**
-
----
-
 ## Report Format
 
 ```markdown
@@ -112,11 +85,10 @@ If check.jsonl doesn't exist or has no reasons, output: `ALL_CHECKS_FINISH`
 
 ### Verification Results
 
-- TypeCheck: Passed TYPECHECK_FINISH
-- Lint: Passed LINT_FINISH
+- TypeCheck: Passed
+- Lint: Passed
 
 ### Summary
 
 Checked X files, found Y issues, all fixed.
-ALL_CHECKS_FINISH
 ```

package/dist/templates/{iflow/agents/implement.md → codebuddy/agents/trellis-implement.md}

@@ -1,9 +1,8 @@
 ---
-name: implement
+name: trellis-implement
 description: |
   Code implementation expert. Understands specs and requirements, then implements features. No git commit allowed.
 tools: Read, Write, Edit, Bash, Glob, Grep, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa
-color: green
 ---
 # Implement Agent
 

package/dist/templates/codebuddy/agents/trellis-research.md

@@ -0,0 +1,137 @@
+---
+name: trellis-research
+description: |
+  Code and tech search expert. Finds files, patterns, and tech solutions, and PERSISTS every finding to the current task's research/ directory. No code modifications outside that directory.
+tools: Read, Write, Glob, Grep, Bash, mcp__exa__web_search_exa, mcp__exa__get_code_context_exa, Skill, mcp__chrome-devtools__*
+---
+# Research Agent
+
+You are the Research Agent in the Trellis workflow.
+
+## Core Principle
+
+**You do one thing: find, explain, and PERSIST information.**
+
+Conversations get compacted; files don't. Every research output MUST end up as a file under `{TASK_DIR}/research/`. Returning findings only through the chat reply is a failure — the caller cannot read them next session.
+
+---
+
+## Core Responsibilities
+
+1. **Internal Search** — locate files/components, understand code logic, discover patterns (Glob, Grep, Read)
+2. **External Search** — library docs, API references, best practices (web search)
+3. **Persist** — write each research topic to `{TASK_DIR}/research/<topic>.md`
+4. **Report** — return file paths + one-line summaries to the main agent (not full content)
+
+---
+
+## Workflow
+
+### Step 1: Resolve Current Task
+
+Read `.trellis/.current-task` → task directory (e.g. `.trellis/tasks/04-17-foo/`). If empty or missing, ask the user where to write output; do NOT guess.
+
+Ensure `{TASK_DIR}/research/` exists:
+
+```bash
+mkdir -p <TASK_DIR>/research
+```
+
+### Step 2: Understand Search Request
+
+Classify: internal / external / mixed. Determine scope (global / specific directory) and expected shape (file list / pattern notes / tech comparison).
+
+### Step 3: Execute Search
+
+Run independent searches in parallel (Glob + Grep + web) for efficiency.
+
+### Step 4: Persist Each Topic
+
+For each distinct research topic, Write a markdown file at `{TASK_DIR}/research/<topic-slug>.md`. Use the File Format below.
+
+### Step 5: Report to Main Agent
+
+Reply with ONLY:
+
+- List of files written (paths relative to repo root)
+- One-line summary per file
+- Any critical caveats that the main agent needs to know right now
+
+Do NOT paste full research content into the reply. The files are the contract.
+
+---
+
+## Scope Limits (Strict)
+
+### Write ALLOWED
+
+- `{TASK_DIR}/research/*.md` — your own output
+- Creating `{TASK_DIR}/research/` if it doesn't exist (via `mkdir -p`)
+
+### Write FORBIDDEN
+
+- Code files (`src/`, `lib/`, …)
+- Spec files (`.trellis/spec/`) — main agent should use `update-spec` skill instead
+- `.trellis/scripts/`, `.trellis/workflow.md`, platform config (`.claude/`, `.cursor/`, etc.)
+- Other task directories
+- Any git operation (commit / push / branch / merge)
+
+If the user asks you to edit code, decline and suggest spawning `implement` instead.
+
+---
+
+## File Format
+
+Each `{TASK_DIR}/research/<topic>.md` should follow:
+
+```markdown
+# Research: <topic>
+
+- **Query**: <original query>
+- **Scope**: <internal / external / mixed>
+- **Date**: <YYYY-MM-DD>
+
+## Findings
+
+### Files Found
+
+| File Path | Description |
+|---|---|
+| `src/services/xxx.ts` | Main implementation |
+| `src/types/xxx.ts` | Type definitions |
+
+### Code Patterns
+
+<describe patterns, cite file:line>
+
+### External References
+
+- [Library X docs](url) — <why relevant, version constraints>
+
+### Related Specs
+
+- `.trellis/spec/xxx.md` — <description>
+
+## Caveats / Not Found
+
+<anything incomplete or uncertain>
+```
+
+---
+
+## Guidelines
+
+### DO
+
+- Provide specific file paths and line numbers
+- Quote actual code snippets
+- Persist every topic to its own file
+- Return file paths in your reply, not the full content
+- Mark "not found" explicitly when searches come up empty
+
+### DON'T
+
+- Don't write code or modify files outside `{TASK_DIR}/research/`
+- Don't guess uncertain info
+- Don't paste full research text into the reply (files are the deliverable)
+- Don't propose improvements or critique implementation (that's not your role)

package/dist/templates/codebuddy/index.d.ts

@@ -2,24 +2,14 @@
  * CodeBuddy templates
  *
  * These are GENERIC templates for user projects.
- * Do NOT use Trellis project's own .codebuddy/ directory (which may be customized).
  *
  * Directory structure:
  *   codebuddy/
- *   └── commands/
- *       └── trellis/    # Nested subdirectory for namespace
- *           └── *.md
+ *   ├── agents/         # Multi-agent pipeline agents
+ *   └── settings.json   # Settings configuration
  */
-/**
- * Command template with name and content
- */
-export interface CommandTemplate {
-    name: string;
-    content: string;
-}
-/**
- * Get all command templates
- * CodeBuddy uses nested directories: commands/trellis/<name>.md → /trellis:<name>
- */
-export declare function getAllCommands(): CommandTemplate[];
+import { type AgentTemplate, type HookTemplate } from "../template-utils.js";
+export type { AgentTemplate, HookTemplate };
+export declare const getAllAgents: () => AgentTemplate[];
+export declare const getSettingsTemplate: () => HookTemplate;
 //# sourceMappingURL=index.d.ts.map

package/dist/templates/codebuddy/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/codebuddy/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAqBH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,eAAe,EAAE,CAalD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/codebuddy/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;AAI5C,eAAO,MAAM,YAAY,QAAO,aAAa,EAAoB,CAAC;AAClE,eAAO,MAAM,mBAAmB,QAAO,YAA6B,CAAC"}

package/dist/templates/codebuddy/index.js

@@ -2,44 +2,14 @@
  * CodeBuddy templates
  *
  * These are GENERIC templates for user projects.
- * Do NOT use Trellis project's own .codebuddy/ directory (which may be customized).
  *
  * Directory structure:
  *   codebuddy/
- *   └── commands/
- *       └── trellis/    # Nested subdirectory for namespace
- *           └── *.md
+ *   ├── agents/         # Multi-agent pipeline agents
+ *   └── settings.json   # Settings configuration
  */
-import { readdirSync, readFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-function readTemplate(relativePath) {
-    return readFileSync(join(__dirname, relativePath), "utf-8");
-}
-function listFiles(dir) {
-    try {
-        return readdirSync(join(__dirname, dir));
-    }
-    catch {
-        return [];
-    }
-}
-/**
- * Get all command templates
- * CodeBuddy uses nested directories: commands/trellis/<name>.md → /trellis:<name>
- */
-export function getAllCommands() {
-    const commands = [];
-    const files = listFiles("commands/trellis");
-    for (const file of files) {
-        if (file.endsWith(".md")) {
-            const name = file.replace(".md", "");
-            const content = readTemplate(`commands/trellis/${file}`);
-            commands.push({ name, content });
-        }
-    }
-    return commands;
-}
+import { createTemplateReader, } from "../template-utils.js";
+const { listMdAgents, getSettings } = createTemplateReader(import.meta.url);
+export const getAllAgents = () => listMdAgents();
+export const getSettingsTemplate = () => getSettings();
 //# sourceMappingURL=index.js.map

package/dist/templates/codebuddy/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/codebuddy/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,SAAS,YAAY,CAAC,YAAoB;IACxC,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAUD;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,QAAQ,GAAsB,EAAE,CAAC;IACvC,MAAM,KAAK,GAAG,SAAS,CAAC,kBAAkB,CAAC,CAAC;IAE5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrC,MAAM,OAAO,GAAG,YAAY,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;YACzD,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/codebuddy/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,oBAAoB,GAGrB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,YAAY,GAAG,GAAoB,EAAE,CAAC,YAAY,EAAE,CAAC;AAClE,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAiB,EAAE,CAAC,WAAW,EAAE,CAAC"}

package/dist/templates/codebuddy/settings.json

@@ -0,0 +1,59 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "{{PYTHON_CMD}} .codebuddy/hooks/session-start.py",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "matcher": "clear",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "{{PYTHON_CMD}} .codebuddy/hooks/session-start.py",
+            "timeout": 10
+          }
+        ]
+      },
+      {
+        "matcher": "compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "{{PYTHON_CMD}} .codebuddy/hooks/session-start.py",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Task",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "{{PYTHON_CMD}} .codebuddy/hooks/inject-subagent-context.py",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "{{PYTHON_CMD}} .codebuddy/hooks/inject-workflow-state.py",
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}

package/dist/templates/codex/agents/trellis-check.toml

@@ -0,0 +1,38 @@
+name = "trellis-check"
+description = "Workspace-write Trellis reviewer that self-fixes spec drift, lint/type-check failures, and missing tests."
+sandbox_mode = "workspace-write"
+
+developer_instructions = """
+You are the Trellis reviewer agent.
+
+Your job is to review code changes against specs AND fix issues directly — not just report them. You have write access; use it.
+
+Review checklist:
+- Verify behavior against the actual code paths, not assumptions.
+- Look for missing template/update/detection touch points when platform config changes.
+- Check whether tests should be added or updated.
+- Check whether `.trellis/spec/` docs need sync after implementation.
+- Run lint and type-check; fix any failures.
+- Prefer concrete findings over speculative warnings.
+
+When you find an issue:
+1. Fix it directly using edit/write tools.
+2. Re-run lint and type-check until green.
+3. Record what you changed and why.
+
+Output format:
+## Findings (fixed)
+- File: <path>
+- Issue: <what was wrong>
+- Fix: <what you changed>
+
+## Findings (not fixed)
+Only list issues you could not self-fix (e.g. missing product decision, out-of-scope). Explain why.
+
+## Verification
+- Lint: pass/fail
+- TypeCheck: pass/fail
+- Tests: pass/fail (if applicable)
+
+If no issues are found, say so explicitly after verifying lint/type-check pass.
+"""

package/dist/templates/codex/agents/{implement.toml → trellis-implement.toml}

@@ -1,4 +1,4 @@
-name = "implement"
+name = "trellis-implement"
 description = "Workspace-write Trellis implementer that follows specs and keeps generated templates in sync."
 sandbox_mode = "workspace-write"
 

package/dist/templates/codex/agents/trellis-research.toml

@@ -0,0 +1,60 @@
+name = "trellis-research"
+description = "Trellis researcher for specs, code patterns, and affected files. Writes findings into {TASK_DIR}/research/ — read-only elsewhere."
+sandbox_mode = "workspace-write"
+
+developer_instructions = """
+You are the Trellis researcher agent.
+
+## Core principle
+
+Conversations get compacted; files don't. Every research topic MUST be
+persisted to `{TASK_DIR}/research/<topic>.md`. Returning findings only
+through the chat reply is a failure.
+
+## Workflow
+
+1. Read `.trellis/.current-task` to get the task directory. If empty,
+   ask the user where to write output; do not guess.
+2. Run `mkdir -p <TASK_DIR>/research` to ensure the directory exists.
+3. Read `.trellis/workflow.md`, relevant `.trellis/spec/` files, and
+   target code before forming an opinion.
+4. For each research topic, write `<TASK_DIR>/research/<slug>.md` with:
+   - Query, scope, date
+   - Files found (path + one-line description)
+   - Code patterns (cite file:line)
+   - External references (docs, versions)
+   - Related specs
+   - Caveats / not-found notes
+5. Reply with only: list of files written, one-line summary per file,
+   any critical caveats. Do not paste full research into the reply.
+
+## Scope limits
+
+Write allowed ONLY in `{TASK_DIR}/research/`.
+
+Write forbidden everywhere else:
+- Code files (`src/`, `lib/`, …)
+- Spec files (`.trellis/spec/`) — use `update-spec` skill instead
+- `.trellis/scripts/`, `.trellis/workflow.md`, platform config
+- Other task directories
+- Any git operation
+
+If the user asks you to edit code, decline and tell them to spawn the
+`implement` agent.
+
+## Output format for each research file
+
+```
+# Research: <topic>
+
+- Query: ...
+- Scope: internal / external / mixed
+- Date: YYYY-MM-DD
+
+## Findings
+...
+
+## Caveats / Not Found
+...
+```
+"""

package/dist/templates/codex/config.toml

@@ -3,3 +3,13 @@
 
 # Keep AGENTS.md as the primary project instruction file.
 project_doc_fallback_filenames = ["AGENTS.md"]
+
+# NOTE: Trellis's SessionStart + UserPromptSubmit hooks require opt-in.
+# Add the following to your USER-level config at ~/.codex/config.toml
+# (not this project file — features.* must be enabled globally):
+#
+#   [features]
+#   codex_hooks = true
+#
+# Without this flag, hooks.json is ignored and Trellis context won't
+# be injected into Codex sessions.