@blxzer/cursor-trellis 0.1.0

package/dist/templates/template-utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Shared utilities for platform template modules.
+ * Eliminates boilerplate across qoder/, codebuddy/, droid/, cursor/, gemini/, kiro/ index.ts files.
+ */
+export interface AgentTemplate {
+    name: string;
+    content: string;
+}
+export interface HookTemplate {
+    targetPath: string;
+    content: string;
+}
+export interface TemplateReader {
+    readTemplate: (relativePath: string) => string;
+    listFiles: (dir: string) => string[];
+    listMdAgents: (dir?: string) => AgentTemplate[];
+    listMdCommands: (dir?: string) => AgentTemplate[];
+    listJsonAgents: (dir?: string) => AgentTemplate[];
+    listMdcRules: (dir?: string) => AgentTemplate[];
+    getSettings: (filename?: string) => HookTemplate;
+    getConfig: (filename: string) => string;
+}
+/**
+ * Create a template reader bound to the caller's directory.
+ * Usage: `const { readTemplate, listMdAgents, getSettings } = createTemplateReader(import.meta.url);`
+ */
+export declare function createTemplateReader(importMetaUrl: string): TemplateReader;
+//# sourceMappingURL=template-utils.d.ts.map

package/dist/templates/template-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-utils.d.ts","sourceRoot":"","sources":["../../src/templates/template-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACrC,YAAY,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,aAAa,EAAE,CAAC;IAChD,cAAc,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,aAAa,EAAE,CAAC;IAClD,cAAc,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,aAAa,EAAE,CAAC;IAClD,YAAY,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,aAAa,EAAE,CAAC;IAChD,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,KAAK,YAAY,CAAC;IACjD,SAAS,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CA8E1E"}

package/dist/templates/template-utils.js

@@ -0,0 +1,83 @@
+/**
+ * Shared utilities for platform template modules.
+ * Eliminates boilerplate across qoder/, codebuddy/, droid/, cursor/, gemini/, kiro/ index.ts files.
+ */
+import { readdirSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+/**
+ * Create a template reader bound to the caller's directory.
+ * Usage: `const { readTemplate, listMdAgents, getSettings } = createTemplateReader(import.meta.url);`
+ */
+export function createTemplateReader(importMetaUrl) {
+    const __dirname = dirname(fileURLToPath(importMetaUrl));
+    function readTemplate(relativePath) {
+        return readFileSync(join(__dirname, relativePath), "utf-8");
+    }
+    function listFiles(dir) {
+        try {
+            return readdirSync(join(__dirname, dir)).sort();
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Read all .md agent files from a subdirectory */
+    function listMdAgents(dir = "agents") {
+        return listFiles(dir)
+            .filter((f) => f.endsWith(".md"))
+            .map((f) => ({
+            name: f.replace(".md", ""),
+            content: readTemplate(`${dir}/${f}`),
+        }));
+    }
+    /** Read all .md command files from a subdirectory (e.g. cursor/commands).
+     * Unlike listMdAgents, the name keeps no prefix transformation — callers
+     * decide the output filename (e.g. `trellis-${name}.md`). */
+    function listMdCommands(dir = "commands") {
+        return listFiles(dir)
+            .filter((f) => f.endsWith(".md"))
+            .map((f) => ({
+            name: f.replace(".md", ""),
+            content: readTemplate(`${dir}/${f}`),
+        }));
+    }
+    /** Read all .json agent files from a subdirectory (Kiro) */
+    function listJsonAgents(dir = "agents") {
+        return listFiles(dir)
+            .filter((f) => f.endsWith(".json"))
+            .map((f) => ({
+            name: f.replace(".json", ""),
+            content: readTemplate(`${dir}/${f}`),
+        }));
+    }
+    /** Read all .mdc rule files from a subdirectory (Cursor .cursor/rules) */
+    function listMdcRules(dir = "rules") {
+        return listFiles(dir)
+            .filter((f) => f.endsWith(".mdc"))
+            .map((f) => ({
+            // Keep the .mdc extension in the name — Cursor requires it.
+            name: f,
+            content: readTemplate(`${dir}/${f}`),
+        }));
+    }
+    /** Read settings.json and return as HookTemplate */
+    function getSettings(filename = "settings.json") {
+        return { targetPath: filename, content: readTemplate(filename) };
+    }
+    /** Read a config file and return raw string */
+    function getConfig(filename) {
+        return readTemplate(filename);
+    }
+    return {
+        readTemplate,
+        listFiles,
+        listMdAgents,
+        listMdCommands,
+        listJsonAgents,
+        listMdcRules,
+        getSettings,
+        getConfig,
+    };
+}
+//# sourceMappingURL=template-utils.js.map

package/dist/templates/template-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-utils.js","sourceRoot":"","sources":["../../src/templates/template-utils.ts"],"names":[],"mappings":"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"}

package/dist/templates/trellis/config.yaml

@@ -0,0 +1,132 @@
+# Trellis Configuration
+# Project-level settings for the Trellis workflow system
+#
+# All values have sensible defaults. Only override what you need.
+
+#-------------------------------------------------------------------------------
+# Session Recording
+#-------------------------------------------------------------------------------
+
+# Commit message used when auto-committing journal/index changes
+# after running add_session.py
+session_commit_message: "chore: record journal"
+
+# Maximum lines per journal file before rotating to a new one
+max_journal_lines: 2000
+
+#-------------------------------------------------------------------------------
+# Session Auto-Commit
+#-------------------------------------------------------------------------------
+
+# Auto-commit behavior for session journal + task archive operations.
+# - true (default): scripts auto-stage and auto-commit journal / task changes
+#   after add_session.py / task.py archive runs.
+# - false: scripts do not touch git. Files (journal-*.md, task archive moves)
+#   are still written to disk; you decide whether to git add / commit.
+#
+# Use `false` if your project's .gitignore intentionally excludes `.trellis/`
+# and you want session data kept local-only, or if you prefer to review
+# staged changes manually before each commit.
+#
+# Accepts: true / false / yes / no / 1 / 0 / on / off (case-insensitive).
+#
+# session_auto_commit: true
+
+#-------------------------------------------------------------------------------
+# Task Lifecycle Hooks
+#-------------------------------------------------------------------------------
+
+# Shell commands to run after task lifecycle events.
+# Each hook receives TASK_JSON_PATH environment variable pointing to task.json.
+# Hook failures print a warning but do not block the main operation.
+#
+# hooks:
+#   after_create:
+#     - "echo 'Task created'"
+#   after_start:
+#     - "echo 'Task started'"
+#   after_finish:
+#     - "echo 'Task finished'"
+#   after_archive:
+#     - "echo 'Task archived'"
+
+#-------------------------------------------------------------------------------
+# Monorepo / Packages
+#-------------------------------------------------------------------------------
+
+# Declare packages for monorepo projects.
+# Trellis auto-detects workspaces during `trellis init`, but you can also
+# configure them manually here.
+#
+# packages:
+#   frontend:
+#     path: packages/frontend
+#   backend:
+#     path: packages/backend
+#   docs:
+#     path: docs-site
+#     type: submodule
+#   # For polyrepo / meta-repo layouts (independent .git in each subdir),
+#   # mark the package with `git: true`. The runtime treats it as an
+#   # independent repository for things like git-context display.
+#   webapp:
+#     path: ./webapp
+#     git: true
+
+# Default package used when --package is not specified.
+# default_package: frontend
+
+#-------------------------------------------------------------------------------
+# Smart Search CLI (optional per-machine override)
+#-------------------------------------------------------------------------------
+# run_smart_search.py resolves: env TRELLIS_SMART_SEARCH_COMMAND, then this
+# setting, then PATH, then node_modules/.bin and repo wrappers. No .runtime cache.
+#
+# smart_search:
+#   command: smart-search
+
+#-------------------------------------------------------------------------------
+# Cursor subagent dispatch (documentation only — not Cursor product settings)
+#-------------------------------------------------------------------------------
+# See .trellis/spec/guides/cursor-subagent-policy.md
+#
+# cursor:
+#   subagent_dispatch:
+#     mode: agent
+#     model_policy: cursor-configured
+#   child_worker:
+#     mode: separate_writable_agent_session
+#     reuse_policy: true
+
+#-------------------------------------------------------------------------------
+# Channel worker OOM guard
+#-------------------------------------------------------------------------------
+# Default safeguards for `trellis channel spawn` workers. The guard runs
+# at spawn time (cleans expired idle workers, then enforces the live-worker
+# budget) and inside each supervisor (self-terminates a worker that stays
+# continuously idle past `idle_timeout`).
+#
+# Precedence: CLI flag > env var (TRELLIS_CHANNEL_WORKER_IDLE_TIMEOUT /
+# TRELLIS_CHANNEL_MAX_LIVE_WORKERS) > this config > built-in default.
+#
+# `idle_timeout: 0` disables idle cleanup (workers can sit idle forever
+# unless explicitly killed or given `--timeout`).
+# `max_live_workers: 0` disables the spawn-time budget check.
+#
+channel:
+  worker_guard:
+    idle_timeout: 5m
+    max_live_workers: 6
+
+#-------------------------------------------------------------------------------
+# Codex (dispatch behavior)
+#-------------------------------------------------------------------------------
+# Codex-only knob; other platforms ignore it. Default ("inline") makes the
+# main Codex agent edit code directly because Codex sub-agents run with
+# `fork_turns="none"` isolation and can't inherit the parent session's
+# task context. Set to "sub-agent" to opt into the legacy dispatch model
+# (main agent spawns trellis-implement / trellis-check / trellis-research
+# sub-agents).
+#
+# codex:
+#   dispatch_mode: inline  # or "sub-agent" to dispatch trellis-* sub-agents

package/dist/templates/trellis/gitignore.txt

@@ -0,0 +1,39 @@
+# Developer identity (local only)
+.developer
+
+# Legacy current task pointer (ignored; selected_task lives under .runtime/)
+.current-task
+
+# Session/window scoped runtime state
+.runtime/
+
+# Parent/Child linked Git worktrees
+worktrees/
+
+# Ralph Loop state file
+.ralph-state.json
+
+# Agent runtime files
+.agents/
+.agent-log
+.session-id
+
+# Task directory runtime files
+.plan-log
+
+# Atomic update temp files
+*.tmp
+
+# Update backup directories
+.backup-*
+
+# Conflict resolution temp files
+*.new
+
+# Python cache
+**/__pycache__/
+**/*.pyc
+
+# Cursor++ BYOK local routing (operator machine; not team-shared)
+local/cursor2plus/config.local.json
+local/subagent-models.json

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

@@ -0,0 +1,80 @@
+/**
+ * Trellis workflow templates
+ *
+ * These are GENERIC templates for user projects.
+ * Do NOT use Trellis project's own .trellis/ directory (which may be customized).
+ *
+ * Directory structure:
+ *   trellis/
+ *   ├── scripts/
+ *   │   ├── __init__.py
+ *   │   ├── common/           # Shared utilities (Python)
+ *   │   └── *.py              # Main scripts (Python)
+ *   ├── scripts-shell-archive/ # Archived shell scripts (for reference)
+ *   ├── workflow.md           # Workflow guide
+ *   ├── config.yaml            # Trellis configuration
+ *   └── gitignore.txt         # .gitignore content
+ */
+export declare const scriptsInit: string;
+export declare const commonInit: string;
+export declare const commonPaths: string;
+export declare const commonDeveloper: string;
+export declare const commonGitContext: string;
+export declare const commonTaskQueue: string;
+export declare const commonTaskUtils: string;
+export declare const commonActiveTask: string;
+export declare const commonCliAdapter: string;
+export declare const commonCliEnvironment: string;
+export declare const commonConfig: string;
+export declare const commonIo: string;
+export declare const commonLog: string;
+export declare const commonGit: string;
+export declare const commonTypes: string;
+export declare const commonTasks: string;
+export declare const commonTaskContext: string;
+export declare const commonTaskStore: string;
+export declare const commonTaskDashboard: string;
+export declare const commonTaskGates: string;
+export declare const commonTaskMap: string;
+export declare const commonParentOrchestration: string;
+export declare const commonArtifactSearch: string;
+export declare const commonSessionMemory: string;
+export declare const commonSmartSearchEvidence: string;
+export declare const commonSmartSearchResolve: string;
+export declare const commonRetrievalEvidence: string;
+export declare const commonCodebaseRetrievalRouter: string;
+export declare const commonRetrievalAdapterMetadata: string;
+export declare const commonContextPack: string;
+export declare const commonRetrievalPack: string;
+export declare const commonRetrievalPackContext: string;
+export declare const commonTestRetrievalArbitration: string;
+export declare const commonSessionContext: string;
+export declare const commonPackagesContext: string;
+export declare const commonWorkflowPhase: string;
+export declare const commonTrellisConfig: string;
+export declare const commonSafeCommit: string;
+export declare const getDeveloperScript: string;
+export declare const initDeveloperScript: string;
+export declare const taskScript: string;
+export declare const getContextScript: string;
+export declare const addSessionScript: string;
+export declare const searchArtifactsScript: string;
+export declare const searchMemoryScript: string;
+export declare const runSmartSearchScript: string;
+export declare const buildContextPackScript: string;
+export declare const buildRetrievalPackScript: string;
+export declare const routeCodebaseRetrievalScript: string;
+export declare const workflowMdTemplate: string;
+export declare const configYamlTemplate: string;
+export declare const gitignoreTemplate: string;
+/**
+ * Optional task artifact templates (under `.trellis/tasks/templates/`).
+ * Not applied by `task.py create`; copy into a new task directory when starting
+ * release-readiness or release-execution work.
+ */
+export declare function getAllTaskTemplates(): Map<string, string>;
+/**
+ * Get all script templates as a map of relative path to content
+ */
+export declare function getAllScripts(): Map<string, string>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/trellis/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAcH,eAAO,MAAM,WAAW,QAAsC,CAAC;AAG/D,eAAO,MAAM,UAAU,QAA6C,CAAC;AACrE,eAAO,MAAM,WAAW,QAA0C,CAAC;AACnE,eAAO,MAAM,eAAe,QAA8C,CAAC;AAC3E,eAAO,MAAM,gBAAgB,QAAgD,CAAC;AAC9E,eAAO,MAAM,eAAe,QAA+C,CAAC;AAC5E,eAAO,MAAM,eAAe,QAA+C,CAAC;AAC5E,eAAO,MAAM,gBAAgB,QAAgD,CAAC;AAC9E,eAAO,MAAM,gBAAgB,QAAgD,CAAC;AAC9E,eAAO,MAAM,oBAAoB,QAEhC,CAAC;AACF,eAAO,MAAM,YAAY,QAA2C,CAAC;AACrE,eAAO,MAAM,QAAQ,QAAuC,CAAC;AAC7D,eAAO,MAAM,SAAS,QAAwC,CAAC;AAC/D,eAAO,MAAM,SAAS,QAAwC,CAAC;AAC/D,eAAO,MAAM,WAAW,QAA0C,CAAC;AACnE,eAAO,MAAM,WAAW,QAA0C,CAAC;AACnE,eAAO,MAAM,iBAAiB,QAAiD,CAAC;AAChF,eAAO,MAAM,eAAe,QAA+C,CAAC;AAC5E,eAAO,MAAM,mBAAmB,QAE/B,CAAC;AACF,eAAO,MAAM,eAAe,QAA+C,CAAC;AAC5E,eAAO,MAAM,aAAa,QAA6C,CAAC;AACxE,eAAO,MAAM,yBAAyB,QAErC,CAAC;AACF,eAAO,MAAM,oBAAoB,QAEhC,CAAC;AACF,eAAO,MAAM,mBAAmB,QAE/B,CAAC;AACF,eAAO,MAAM,yBAAyB,QAErC,CAAC;AACF,eAAO,MAAM,wBAAwB,QAEpC,CAAC;AACF,eAAO,MAAM,uBAAuB,QAEnC,CAAC;AACF,eAAO,MAAM,6BAA6B,QAEzC,CAAC;AACF,eAAO,MAAM,8BAA8B,QAE1C,CAAC;AACF,eAAO,MAAM,iBAAiB,QAAiD,CAAC;AAChF,eAAO,MAAM,mBAAmB,QAAmD,CAAC;AACpF,eAAO,MAAM,0BAA0B,QAEtC,CAAC;AACF,eAAO,MAAM,8BAA8B,QAE1C,CAAC;AACF,eAAO,MAAM,oBAAoB,QAEhC,CAAC;AACF,eAAO,MAAM,qBAAqB,QAEjC,CAAC;AACF,eAAO,MAAM,mBAAmB,QAE/B,CAAC;AACF,eAAO,MAAM,mBAAmB,QAE/B,CAAC;AACF,eAAO,MAAM,gBAAgB,QAAgD,CAAC;AAG9E,eAAO,MAAM,kBAAkB,QAA2C,CAAC;AAC3E,eAAO,MAAM,mBAAmB,QAA4C,CAAC;AAC7E,eAAO,MAAM,UAAU,QAAkC,CAAC;AAC1D,eAAO,MAAM,gBAAgB,QAAyC,CAAC;AACvE,eAAO,MAAM,gBAAgB,QAAyC,CAAC;AACvE,eAAO,MAAM,qBAAqB,QAA8C,CAAC;AACjF,eAAO,MAAM,kBAAkB,QAA2C,CAAC;AAC3E,eAAO,MAAM,oBAAoB,QAA8C,CAAC;AAChF,eAAO,MAAM,sBAAsB,QAAgD,CAAC;AACpF,eAAO,MAAM,wBAAwB,QAAkD,CAAC;AACxF,eAAO,MAAM,4BAA4B,QAExC,CAAC;AAGF,eAAO,MAAM,kBAAkB,QAA8B,CAAC;AAC9D,eAAO,MAAM,kBAAkB,QAA8B,CAAC;AAC9D,eAAO,MAAM,iBAAiB,QAAgC,CAAC;AAoB/D;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAezD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA2DnD"}

package/dist/templates/trellis/index.js

@@ -0,0 +1,171 @@
+/**
+ * Trellis workflow templates
+ *
+ * These are GENERIC templates for user projects.
+ * Do NOT use Trellis project's own .trellis/ directory (which may be customized).
+ *
+ * Directory structure:
+ *   trellis/
+ *   ├── scripts/
+ *   │   ├── __init__.py
+ *   │   ├── common/           # Shared utilities (Python)
+ *   │   └── *.py              # Main scripts (Python)
+ *   ├── scripts-shell-archive/ # Archived shell scripts (for reference)
+ *   ├── workflow.md           # Workflow guide
+ *   ├── config.yaml            # Trellis configuration
+ *   └── gitignore.txt         # .gitignore content
+ */
+import { 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");
+}
+// Python scripts - package init
+export const scriptsInit = readTemplate("scripts/__init__.py");
+// Python scripts - common
+export const commonInit = readTemplate("scripts/common/__init__.py");
+export const commonPaths = readTemplate("scripts/common/paths.py");
+export const commonDeveloper = readTemplate("scripts/common/developer.py");
+export const commonGitContext = readTemplate("scripts/common/git_context.py");
+export const commonTaskQueue = readTemplate("scripts/common/task_queue.py");
+export const commonTaskUtils = readTemplate("scripts/common/task_utils.py");
+export const commonActiveTask = readTemplate("scripts/common/active_task.py");
+export const commonCliAdapter = readTemplate("scripts/common/cli_adapter.py");
+export const commonCliEnvironment = readTemplate("scripts/common/cli_environment.py");
+export const commonConfig = readTemplate("scripts/common/config.py");
+export const commonIo = readTemplate("scripts/common/io.py");
+export const commonLog = readTemplate("scripts/common/log.py");
+export const commonGit = readTemplate("scripts/common/git.py");
+export const commonTypes = readTemplate("scripts/common/types.py");
+export const commonTasks = readTemplate("scripts/common/tasks.py");
+export const commonTaskContext = readTemplate("scripts/common/task_context.py");
+export const commonTaskStore = readTemplate("scripts/common/task_store.py");
+export const commonTaskDashboard = readTemplate("scripts/common/task_dashboard.py");
+export const commonTaskGates = readTemplate("scripts/common/task_gates.py");
+export const commonTaskMap = readTemplate("scripts/common/task_map.py");
+export const commonParentOrchestration = readTemplate("scripts/common/parent_orchestration.py");
+export const commonArtifactSearch = readTemplate("scripts/common/artifact_search.py");
+export const commonSessionMemory = readTemplate("scripts/common/session_memory.py");
+export const commonSmartSearchEvidence = readTemplate("scripts/common/smart_search_evidence.py");
+export const commonSmartSearchResolve = readTemplate("scripts/common/smart_search_resolve.py");
+export const commonRetrievalEvidence = readTemplate("scripts/common/retrieval_evidence.py");
+export const commonCodebaseRetrievalRouter = readTemplate("scripts/common/codebase_retrieval_router.py");
+export const commonRetrievalAdapterMetadata = readTemplate("scripts/common/retrieval_adapter_metadata.py");
+export const commonContextPack = readTemplate("scripts/common/context_pack.py");
+export const commonRetrievalPack = readTemplate("scripts/common/retrieval_pack.py");
+export const commonRetrievalPackContext = readTemplate("scripts/common/retrieval_pack_context.py");
+export const commonTestRetrievalArbitration = readTemplate("scripts/common/test_retrieval_arbitration.py");
+export const commonSessionContext = readTemplate("scripts/common/session_context.py");
+export const commonPackagesContext = readTemplate("scripts/common/packages_context.py");
+export const commonWorkflowPhase = readTemplate("scripts/common/workflow_phase.py");
+export const commonTrellisConfig = readTemplate("scripts/common/trellis_config.py");
+export const commonSafeCommit = readTemplate("scripts/common/safe_commit.py");
+// Python scripts - main
+export const getDeveloperScript = readTemplate("scripts/get_developer.py");
+export const initDeveloperScript = readTemplate("scripts/init_developer.py");
+export const taskScript = readTemplate("scripts/task.py");
+export const getContextScript = readTemplate("scripts/get_context.py");
+export const addSessionScript = readTemplate("scripts/add_session.py");
+export const searchArtifactsScript = readTemplate("scripts/search_artifacts.py");
+export const searchMemoryScript = readTemplate("scripts/search_memory.py");
+export const runSmartSearchScript = readTemplate("scripts/run_smart_search.py");
+export const buildContextPackScript = readTemplate("scripts/build_context_pack.py");
+export const buildRetrievalPackScript = readTemplate("scripts/build_retrieval_pack.py");
+export const routeCodebaseRetrievalScript = readTemplate("scripts/route_codebase_retrieval.py");
+// Configuration files
+export const workflowMdTemplate = readTemplate("workflow.md");
+export const configYamlTemplate = readTemplate("config.yaml");
+export const gitignoreTemplate = readTemplate("gitignore.txt");
+const RELEASE_READINESS_TASK_TEMPLATE_FILES = [
+    "prd.md",
+    "design.md",
+    "implement.md",
+    "handoff-template.md",
+];
+const RELEASE_EXECUTION_TASK_TEMPLATE_FILES = [
+    "prd.md",
+    "design.md",
+    "implement.md",
+    "handoff-template.md",
+];
+function readTaskTemplate(relativePath) {
+    return readTemplate(join("tasks", "templates", relativePath));
+}
+/**
+ * Optional task artifact templates (under `.trellis/tasks/templates/`).
+ * Not applied by `task.py create`; copy into a new task directory when starting
+ * release-readiness or release-execution work.
+ */
+export function getAllTaskTemplates() {
+    const templates = new Map();
+    for (const file of RELEASE_READINESS_TASK_TEMPLATE_FILES) {
+        templates.set(`tasks/templates/release-readiness/${file}`, readTaskTemplate(`release-readiness/${file}`));
+    }
+    for (const file of RELEASE_EXECUTION_TASK_TEMPLATE_FILES) {
+        templates.set(`tasks/templates/release-execution/${file}`, readTaskTemplate(`release-execution/${file}`));
+    }
+    return templates;
+}
+/**
+ * Get all script templates as a map of relative path to content
+ */
+export function getAllScripts() {
+    const scripts = new Map();
+    // Package init
+    scripts.set("__init__.py", scriptsInit);
+    // Common
+    scripts.set("common/__init__.py", commonInit);
+    scripts.set("common/paths.py", commonPaths);
+    scripts.set("common/developer.py", commonDeveloper);
+    scripts.set("common/git_context.py", commonGitContext);
+    scripts.set("common/task_queue.py", commonTaskQueue);
+    scripts.set("common/task_utils.py", commonTaskUtils);
+    scripts.set("common/active_task.py", commonActiveTask);
+    scripts.set("common/cli_adapter.py", commonCliAdapter);
+    scripts.set("common/cli_environment.py", commonCliEnvironment);
+    scripts.set("common/config.py", commonConfig);
+    scripts.set("common/io.py", commonIo);
+    scripts.set("common/log.py", commonLog);
+    scripts.set("common/git.py", commonGit);
+    scripts.set("common/types.py", commonTypes);
+    scripts.set("common/tasks.py", commonTasks);
+    scripts.set("common/task_context.py", commonTaskContext);
+    scripts.set("common/task_store.py", commonTaskStore);
+    scripts.set("common/task_dashboard.py", commonTaskDashboard);
+    scripts.set("common/task_gates.py", commonTaskGates);
+    scripts.set("common/task_map.py", commonTaskMap);
+    scripts.set("common/parent_orchestration.py", commonParentOrchestration);
+    scripts.set("common/artifact_search.py", commonArtifactSearch);
+    scripts.set("common/session_memory.py", commonSessionMemory);
+    scripts.set("common/smart_search_evidence.py", commonSmartSearchEvidence);
+    scripts.set("common/smart_search_resolve.py", commonSmartSearchResolve);
+    scripts.set("common/retrieval_evidence.py", commonRetrievalEvidence);
+    scripts.set("common/codebase_retrieval_router.py", commonCodebaseRetrievalRouter);
+    scripts.set("common/retrieval_adapter_metadata.py", commonRetrievalAdapterMetadata);
+    scripts.set("common/context_pack.py", commonContextPack);
+    scripts.set("common/retrieval_pack.py", commonRetrievalPack);
+    scripts.set("common/retrieval_pack_context.py", commonRetrievalPackContext);
+    scripts.set("common/test_retrieval_arbitration.py", commonTestRetrievalArbitration);
+    scripts.set("common/session_context.py", commonSessionContext);
+    scripts.set("common/packages_context.py", commonPackagesContext);
+    scripts.set("common/workflow_phase.py", commonWorkflowPhase);
+    scripts.set("common/trellis_config.py", commonTrellisConfig);
+    scripts.set("common/safe_commit.py", commonSafeCommit);
+    // Main
+    scripts.set("get_developer.py", getDeveloperScript);
+    scripts.set("init_developer.py", initDeveloperScript);
+    scripts.set("task.py", taskScript);
+    scripts.set("get_context.py", getContextScript);
+    scripts.set("add_session.py", addSessionScript);
+    scripts.set("search_artifacts.py", searchArtifactsScript);
+    scripts.set("search_memory.py", searchMemoryScript);
+    scripts.set("run_smart_search.py", runSmartSearchScript);
+    scripts.set("build_context_pack.py", buildContextPackScript);
+    scripts.set("build_retrieval_pack.py", buildRetrievalPackScript);
+    scripts.set("route_codebase_retrieval.py", routeCodebaseRetrievalScript);
+    return scripts;
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/trellis/index.ts"],"names":[],"mappings":"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"}

package/dist/templates/trellis/local/README.md

@@ -0,0 +1,59 @@
+# Cursor++ BYOK — Trellis subagent model routing
+
+**Who needs this:** Cursor IDE with [Cursor++](https://ccursor.cometix.dev) (BYOK proxy). **Native Cursor API users can ignore this directory.**
+
+## Agent-led setup (recommended)
+
+In **Cursor Agent**, run skill **`trellis-cursor2plus-setup`** (after `trellis init` with Cursor, or anytime `providers.json` changes). The agent lists models, writes commented **`~/.ccursor/trellis-task-models.json5`** with **primary** and **fallback** per role, runs `patch_wpelc8.py`, and reports WARN/ERROR from the resolver.
+
+Copy `../trellis-task-models.json5.example` only if you prefer a manual starting point.
+
+## What to put in `trellis-task-models.json5`
+
+| JSON key (under `models`) | Meaning |
+|-----------------|--------|
+| `trellis-research` | Trellis research Task subagent |
+| `trellis-implement` | Trellis implement (+ Parent/Child default Task) |
+| `trellis-check` | Trellis check Task subagent |
+| `generalPurpose` / `shell` / `best-of-n-runner` | Cursor built-in Task types |
+
+Each role: `{ "primary": "<name>", "fallback": "<name>" }`. **Names:** use **apiModel** or **displayName** from Cursor++ (not `model-xxxxx` unless you want to). Patch time resolves against `providers.json`; missing primary → WARN + fallback; ERROR only if both fail.
+
+```bash
+python patch_wpelc8.py --explain      # key meanings
+python patch_wpelc8.py --list-models  # current catalog from providers.json
+```
+
+**Explore** is not in this file — use the Cursor++ panel.
+
+## When Cursor++ models change
+
+`providers.json` is the live catalog. Slugs (`model-xxxxx`) can change when you add/remove models in Cursor++.
+
+1. Re-run skill **`trellis-cursor2plus-setup`**, or `python patch_wpelc8.py --list-models` and fix JSON5
+2. `python patch_wpelc8.py` → Reload Window only if you had not patched yet or reverted
+
+You may **omit** keys for Task types you never use.
+
+## Two-layer JSON (project overrides user)
+
+| File | Scope |
+|------|--------|
+| `~/.ccursor/trellis-task-models.json5` (or `.json`) | User — all repos |
+| `{repo}/.trellis/local/subagent-models.json` | Project overrides (optional) |
+
+## Paths
+
+`providers.json` default: `~/.ccursor/providers.json`. Override: `config.local.json` → `providersJson`, or env `TRELLIS_CCURSOR_PROVIDERS`.
+
+## Apply / revert
+
+```bash
+cd .trellis/local/cursor2plus
+python patch_wpelc8.py --print-map
+python patch_wpelc8.py
+```
+
+**Developer: Reload Window** after patch.
+
+Policy: `.trellis/spec/guides/cursor-subagent-policy.md` (Method 2.5 / 2.6).

package/dist/templates/trellis/local/config.local.json.example

@@ -0,0 +1,6 @@
+{
+  "ccursorHome": "",
+  "extensionJs": "",
+  "userModelsJson": "",
+  "projectModelsJson": ""
+}

package/dist/templates/trellis/local/index.d.ts

@@ -0,0 +1,7 @@
+export declare const cursor2plusPatchScript: string;
+export declare const cursor2plusReadme: string;
+export declare const cursor2plusConfigExample: string;
+export declare const subagentModelsExample: string;
+export declare const trellisTaskModelsJson5Example: string;
+export declare const trellisTaskModelsConfigPy: string;
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/trellis/local/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/templates/trellis/local/index.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,sBAAsB,QAA+B,CAAC;AACnE,eAAO,MAAM,iBAAiB,QAAyB,CAAC;AACxD,eAAO,MAAM,wBAAwB,QAAyC,CAAC;AAC/E,eAAO,MAAM,qBAAqB,QAA4C,CAAC;AAC/E,eAAO,MAAM,6BAA6B,QAEzC,CAAC;AACF,eAAO,MAAM,yBAAyB,QAA6C,CAAC"}