@blulotus/trellis 0.7.0

package/dist/configurators/shared.js

@@ -0,0 +1,590 @@
+/**
+ * Shared utilities for platform configurators.
+ *
+ * Extracted here to avoid circular dependencies (index.ts imports configurators,
+ * configurators cannot import from index.ts).
+ */
+/**
+ * Module-level resolved Python command, set by the init flow after probing.
+ *
+ * Windows commonly has Python under one of: `python`, `python3`, `py -3` —
+ * which one works varies by installer (python.org / Microsoft Store / py
+ * launcher). `init.ts` detects which is available, then calls
+ * `setResolvedPythonCommand` so all subsequent template / configurator writes
+ * use the resolved value instead of the platform default.
+ *
+ * If unset (e.g. unit tests bypass init), `getPythonCommandForPlatform` falls
+ * back to the static platform default (`python` on Windows, `python3`
+ * elsewhere) — preserving legacy behavior.
+ */
+let resolvedPythonCommand = null;
+export function setResolvedPythonCommand(cmd) {
+    const trimmed = cmd.trim();
+    resolvedPythonCommand = trimmed || null;
+}
+/** Test helper — clear the resolved cache between unit tests. */
+export function resetResolvedPythonCommand() {
+    resolvedPythonCommand = null;
+}
+/**
+ * Get the Python command for the host platform.
+ *
+ * Returns the resolved command if `setResolvedPythonCommand` has been called;
+ * otherwise the static platform default — Windows: `python`, others:
+ * `python3`. Pass an explicit `platform` arg only for unit tests (it bypasses
+ * the resolved cache).
+ */
+export function getPythonCommandForPlatform(platform) {
+    if (platform === undefined && resolvedPythonCommand) {
+        return resolvedPythonCommand;
+    }
+    const target = platform ?? process.platform;
+    return target === "win32" ? "python" : "python3";
+}
+/**
+ * Replace literal `python3` with the resolved Python command, excluding
+ * shebang lines.
+ *
+ * Applied at init/update write time so that all file types (including .py,
+ * .md, .toml, .json) get the correct command for the host platform without
+ * template-level changes.
+ *
+ * No-op when the resolved command is `python3` (the template default).
+ * Idempotent: running it twice produces the same result.
+ */
+export function replacePythonCommandLiterals(content) {
+    const target = getPythonCommandForPlatform();
+    if (target === "python3")
+        return content;
+    return content
+        .split("\n")
+        .map((line) => line.startsWith("#!") ? line : line.replaceAll("python3", target))
+        .join("\n");
+}
+/**
+ * Resolve platform-specific placeholders in template content.
+ *
+ * When called without a context, only resolves {{PYTHON_CMD}} (legacy behavior
+ * for settings.json, hooks.json, etc.).
+ *
+ * When called with a TemplateContext, additionally resolves:
+ * - {{CMD_REF:name}}         → platform-specific command reference
+ * - {{EXECUTOR_AI}}          → AI executor description
+ * - {{USER_ACTION_LABEL}}    → user action label
+ * - {{CLI_FLAG}}             → platform cli flag (e.g. "claude", "codex")
+ * - {{#FLAG}}...{{/FLAG}}    → conditional include (when FLAG is true)
+ * - {{^FLAG}}...{{/FLAG}}    → negated conditional (when FLAG is false)
+ *
+ * Supported conditional flags: AGENT_CAPABLE, HAS_HOOKS
+ */
+// Pre-compiled regexes for placeholder resolution
+const RE_PYTHON_CMD = /\{\{PYTHON_CMD\}\}/g;
+const RE_CMD_REF = /\{\{CMD_REF:([\w][\w-]*)\}\}/g;
+const RE_EXECUTOR_AI = /\{\{EXECUTOR_AI\}\}/g;
+const RE_USER_ACTION_LABEL = /\{\{USER_ACTION_LABEL\}\}/g;
+const RE_CLI_FLAG = /\{\{CLI_FLAG\}\}/g;
+const RE_BLANK_LINES = /\n{3,}/g;
+const CONDITIONAL_FLAGS = ["AGENT_CAPABLE", "HAS_HOOKS"];
+const CONDITIONAL_REGEXES = Object.fromEntries(CONDITIONAL_FLAGS.map((flag) => [
+    flag,
+    {
+        pos: new RegExp(`\\{\\{#${flag}\\}\\}([\\s\\S]*?)\\{\\{/${flag}\\}\\}`, "g"),
+        neg: new RegExp(`\\{\\{\\^${flag}\\}\\}([\\s\\S]*?)\\{\\{/${flag}\\}\\}`, "g"),
+    },
+]));
+export function resolvePlaceholders(content, context) {
+    let result = replacePythonCommandLiterals(content.replace(RE_PYTHON_CMD, getPythonCommandForPlatform()));
+    if (!context)
+        return result;
+    // Simple substitutions
+    result = result.replace(RE_CMD_REF, (_match, name) => `${context.cmdRefPrefix}${name}`);
+    result = result.replace(RE_EXECUTOR_AI, context.executorAI);
+    result = result.replace(RE_USER_ACTION_LABEL, context.userActionLabel);
+    result = result.replace(RE_CLI_FLAG, context.cliFlag);
+    // Conditional blocks
+    const flagValues = {
+        AGENT_CAPABLE: context.agentCapable,
+        HAS_HOOKS: context.hasHooks,
+    };
+    for (const flag of CONDITIONAL_FLAGS) {
+        const value = flagValues[flag];
+        const { pos, neg } = CONDITIONAL_REGEXES[flag];
+        // Reset lastIndex for global regexes reused across calls
+        pos.lastIndex = 0;
+        neg.lastIndex = 0;
+        result = result.replace(pos, value ? "$1" : "");
+        result = result.replace(neg, value ? "" : "$1");
+    }
+    // Clean up blank lines left by removed conditional blocks
+    result = result.replace(RE_BLANK_LINES, "\n\n");
+    return result;
+}
+/**
+ * Resolve placeholders for files written under `.agents/skills/` (the shared
+ * Agent Skills directory consumed by multiple platforms via the upstream
+ * `.agents/skills/` workspace alias — Codex, Gemini CLI 0.40+, etc.).
+ *
+ * Identical to {@link resolvePlaceholders} except that {@link CMD_REF} is
+ * rendered in a platform-neutral form (`` `name` (Trellis command) ``)
+ * instead of substituting a platform-specific prefix. This is the only
+ * placeholder that varies between platforms in the auto-triggered skill templates
+ * from `common/skills/`, so
+ * neutralizing it makes the rendered SKILL.md files byte-identical regardless
+ * of which Trellis configurator wrote them — eliminating the
+ * "last-writer-wins" collision when both Codex and Gemini target
+ * `.agents/skills/`.
+ *
+ * `{{CLI_FLAG}}`, `{{EXECUTOR_AI}}`, `{{USER_ACTION_LABEL}}`, conditionals,
+ * and `{{PYTHON_CMD}}` are still resolved from the platform context. The
+ * shared skills do not use those placeholders, so they remain platform-
+ * neutral. Codex-only skill files (e.g. `trellis-continue/SKILL.md`,
+ * `trellis-finish-work/SKILL.md` written via `resolveAllAsSkillsNeutral`) DO
+ * use `{{CLI_FLAG}}` / `{{PYTHON_CMD}}` and resolve to Codex-correct values
+ * — no other platform writes those files, so byte-identity is not required.
+ */
+export function resolvePlaceholdersNeutral(content, context) {
+    let result = replacePythonCommandLiterals(content.replace(RE_PYTHON_CMD, getPythonCommandForPlatform()));
+    if (!context)
+        return result;
+    // Neutral form for the only collision-causing placeholder
+    result = result.replace(RE_CMD_REF, (_match, name) => `\`${name}\` (Trellis command)`);
+    result = result.replace(RE_EXECUTOR_AI, context.executorAI);
+    result = result.replace(RE_USER_ACTION_LABEL, context.userActionLabel);
+    result = result.replace(RE_CLI_FLAG, context.cliFlag);
+    // Conditional blocks (resolved per platform — none of the auto-triggered
+    // shared skills use conditionals, but Codex-only command-as-skill files might in future).
+    const flagValues = {
+        AGENT_CAPABLE: context.agentCapable,
+        HAS_HOOKS: context.hasHooks,
+    };
+    for (const flag of CONDITIONAL_FLAGS) {
+        const value = flagValues[flag];
+        const { pos, neg } = CONDITIONAL_REGEXES[flag];
+        pos.lastIndex = 0;
+        neg.lastIndex = 0;
+        result = result.replace(pos, value ? "$1" : "");
+        result = result.replace(neg, value ? "" : "$1");
+    }
+    result = result.replace(RE_BLANK_LINES, "\n\n");
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Template wrapping utilities
+// ---------------------------------------------------------------------------
+/** Skill description registry — maps template name to auto-trigger description. */
+const SKILL_DESCRIPTIONS = {
+    start: "Initializes an AI development session by reading workflow guides, developer identity, git status, active tasks, and project guidelines from .trellis/. Classifies incoming tasks and routes to brainstorm, direct edit, or task workflow. Use when beginning a new coding session, resuming work, starting a new task, or re-establishing project context.",
+    continue: "Resume work on the current task. Loads the workflow Phase Index, figures out which phase/step to pick up at, then pulls the step-level detail via get_context.py --mode phase. Use when coming back to an in-progress task and you need to know what to do next.",
+    "finish-work": "Wrap up the current session: verify quality gate passed, remind user to commit, archive completed tasks, and record session progress to the developer journal. Use when done coding and ready to end the session.",
+    "before-dev": "Discovers and injects project-specific coding guidelines from .trellis/spec/ before implementation begins. Reads spec indexes, pre-development checklists, and shared thinking guides for the target package. Use when starting a new coding task, before writing any code, switching to a different package, or needing to refresh project conventions and standards.",
+    brainstorm: "Guides collaborative requirements discovery before implementation. Creates task directory, seeds PRD, models the work as a decision tree and asks each round's whole question frontier at once with recommendations, researches technical choices, and converges on MVP scope plus the test seams or bug reproduction the task will be verified against. Use when requirements are unclear, there are multiple valid approaches, or the user describes a new feature or complex task.",
+    check: "Comprehensive quality verification: spec compliance, lint, type-check, tests, cross-layer data flow, code reuse, and consistency checks. Use when code is written and needs quality verification, before committing changes, or to catch context drift during long sessions.",
+    tdd: "Red-before-green contract for behavior work: build a red-capable command that asserts the exact symptom or desired behavior, watch it fail, then write the minimum code to pass, one slice at a time. Covers bug reproduction and minimisation, test-seam confirmation, and the explicit no-harness fallback. Use when reproducing a reported bug, writing a failing test, or implementing a slice of a feature that changes behavior.",
+    "break-loop": "Deep bug analysis to break the fix-forget-repeat cycle. Analyzes root cause category, why fixes failed, prevention mechanisms, and captures knowledge into specs. Use after fixing a bug to prevent the same class of bugs.",
+    "update-spec": "Captures executable contracts and coding conventions into .trellis/spec/ documents. Use when learning something valuable from debugging, implementing, or discussion that should be preserved for future sessions.",
+};
+/**
+ * Wrap resolved template content with YAML frontmatter for skill format.
+ * Used by platforms that use SKILL.md (Codex, Kiro, Qoder, etc.).
+ */
+export function wrapWithSkillFrontmatter(name, content) {
+    // Look up description by base name (without trellis- prefix)
+    const baseName = name.replace(/^trellis-/, "");
+    const description = SKILL_DESCRIPTIONS[baseName];
+    if (!description) {
+        throw new Error(`Missing skill description for "${baseName}". Add it to SKILL_DESCRIPTIONS in shared.ts.`);
+    }
+    return `---\nname: ${name}\ndescription: "${description}"\n---\n\n${content}`;
+}
+/**
+ * One-line blurbs shown in a `/` command palette — kept separate from
+ * SKILL_DESCRIPTIONS, which is long prose aimed at the skill matcher.
+ */
+const COMMAND_DESCRIPTIONS = {
+    start: "Initialize a Trellis development session.",
+    continue: "Resume work on the current task at the correct phase.",
+    "finish-work": "Wrap up the current session: quality gate, commit reminder, archive, journal.",
+};
+/** Wrap resolved command content with YAML frontmatter (name + description). */
+export function wrapWithCommandFrontmatter(name, content) {
+    const baseName = name.replace(/^trellis-/, "");
+    const description = COMMAND_DESCRIPTIONS[baseName];
+    if (!description) {
+        throw new Error(`Missing command description for "${baseName}". Add it to COMMAND_DESCRIPTIONS in shared.ts.`);
+    }
+    // JSON.stringify produces a double-quoted YAML scalar, which is safe even
+    // when the description contains a colon (an unquoted plain scalar cannot
+    // contain ": " — some parsers reject it outright, e.g. Trae CLI's SlashCommand
+    // schema; others silently truncate at the second colon).
+    return `---\nname: ${name}\ndescription: ${JSON.stringify(description)}\n---\n\n${content}`;
+}
+/**
+ * Argument-hint values for commands that accept positional args.
+ * Used by OMP platform's YAML frontmatter.
+ */
+const COMMAND_ARGUMENT_HINTS = {
+    "finish-work": "[task-name]",
+};
+/**
+ * Wrap resolved command content with OMP-style YAML frontmatter.
+ * OMP uses `description` (required) + optional `argument-hint`.
+ * The leading `# Title` heading from the source template is stripped
+ * because OMP's frontmatter replaces its role.
+ */
+export function wrapWithOmpFrontmatter(name, content) {
+    const baseName = name.replace(/^trellis-/, "");
+    const description = COMMAND_DESCRIPTIONS[baseName];
+    if (!description) {
+        throw new Error(`Missing command description for "${baseName}". Add it to COMMAND_DESCRIPTIONS in shared.ts.`);
+    }
+    // Strip leading H1 + blank line from template body
+    const body = content.replace(/^# [^\n]+\n\n/, "");
+    const hint = COMMAND_ARGUMENT_HINTS[baseName];
+    // JSON.stringify produces a double-quoted YAML scalar, safe even when the
+    // description contains a colon (see wrapWithCommandFrontmatter).
+    const quotedDescription = JSON.stringify(description);
+    const frontmatter = hint
+        ? `---\ndescription: ${quotedDescription}\nargument-hint: ${JSON.stringify(hint)}\n---`
+        : `---\ndescription: ${quotedDescription}\n---`;
+    return `${frontmatter}\n\n${body}`;
+}
+// ---------------------------------------------------------------------------
+// Shared configurator helpers
+// ---------------------------------------------------------------------------
+import path from "node:path";
+import { ensureDir, writeFile } from "../utils/file-writer.js";
+import { getBundledSkillTemplates, getCommandTemplates, getSkillTemplates, } from "../templates/common/index.js";
+import { getSharedHookScriptsForPlatform, } from "../templates/shared-hooks/index.js";
+/**
+ * Filter command templates based on platform capabilities.
+ *
+ * `start.md` is stripped only on platforms that are BOTH `agentCapable` AND
+ * `hasHooks` — those platforms (Claude Code, Cursor, Kiro, Gemini, Qoder,
+ * CodeBuddy, Copilot, Droid, Pi) have a SessionStart-style hook that
+ * auto-injects the workflow overview, so a user-facing `start` would be
+ * redundant.
+ *
+ * `agentCapable && !hasHooks` platforms (Codex, ZCode, OpenCode, Reasonix, Grok)
+ * have no such hook (or use an out-of-band plugin), so they need the
+ * user-invocable `trellis-start` skill / `start.md` command as fallback.
+ * Snow is class-1 (`hasHooks: true`) with auto inject + project agents.
+ * Agent-less platforms (Kilo, Antigravity, Devin) also keep `start` since
+ * they rely entirely on user-triggered workflows.
+ */
+function filterCommands(templates, ctx) {
+    if (ctx.agentCapable && ctx.hasHooks) {
+        return templates.filter((t) => t.name !== "start");
+    }
+    return templates;
+}
+/**
+ * Resolve ALL templates as skills with trellis- prefix.
+ * Used by skill-only platforms (Kiro, Qoder, Codex) where everything is a skill.
+ *
+ * `start` is filtered out on agent-capable platforms — the session-start hook
+ * injects the workflow overview instead.
+ */
+export function resolveAllAsSkills(ctx) {
+    const templates = [
+        ...filterCommands(getCommandTemplates(), ctx),
+        ...getSkillTemplates(),
+    ];
+    return templates.map((tmpl) => ({
+        name: `trellis-${tmpl.name}`,
+        content: wrapWithSkillFrontmatter(`trellis-${tmpl.name}`, resolvePlaceholders(tmpl.content, ctx)),
+    }));
+}
+/**
+ * Resolve command templates as plain commands (no wrapping).
+ * Used by "both" platforms for the user-ritual commands.
+ *
+ * `start` is filtered out on agent-capable platforms.
+ */
+export function resolveCommands(ctx) {
+    return filterCommands(getCommandTemplates(), ctx).map((tmpl) => ({
+        name: tmpl.name,
+        content: resolvePlaceholders(tmpl.content, ctx),
+    }));
+}
+/**
+ * Resolve the auto-triggered skill templates from `common/skills/` with trellis- prefix + SKILL.md frontmatter.
+ * Used by "both" platforms for the auto-triggered skills.
+ */
+export function resolveSkills(ctx) {
+    return getSkillTemplates().map((tmpl) => ({
+        name: `trellis-${tmpl.name}`,
+        content: wrapWithSkillFrontmatter(`trellis-${tmpl.name}`, resolvePlaceholders(tmpl.content, ctx)),
+    }));
+}
+/**
+ * Same as {@link resolveSkills} but uses {@link resolvePlaceholdersNeutral}
+ * so the rendered SKILL.md files are byte-identical across any two platforms
+ * that target `.agents/skills/`. Use this for shared `.agents/skills/`
+ * writes (Gemini); platform-private skill roots should keep
+ * {@link resolveSkills}.
+ */
+export function resolveSkillsNeutral(ctx) {
+    return getSkillTemplates().map((tmpl) => ({
+        name: `trellis-${tmpl.name}`,
+        content: wrapWithSkillFrontmatter(`trellis-${tmpl.name}`, resolvePlaceholdersNeutral(tmpl.content, ctx)),
+    }));
+}
+/**
+ * Same as {@link resolveAllAsSkills} but uses
+ * {@link resolvePlaceholdersNeutral} for the shared common skills. The 2 command
+ * templates (continue, finish-work) folded into the skill set still resolve
+ * `{{CLI_FLAG}}` / `{{PYTHON_CMD}}` per platform — only Codex writes those
+ * files into `.agents/skills/`, so byte-identity isn't required there.
+ */
+export function resolveAllAsSkillsNeutral(ctx) {
+    const templates = [
+        ...filterCommands(getCommandTemplates(), ctx),
+        ...getSkillTemplates(),
+    ];
+    return templates.map((tmpl) => ({
+        name: `trellis-${tmpl.name}`,
+        content: wrapWithSkillFrontmatter(`trellis-${tmpl.name}`, resolvePlaceholdersNeutral(tmpl.content, ctx)),
+    }));
+}
+/**
+ * Resolve multi-file built-in skills.
+ *
+ * Unlike workflow skills, bundled skills already contain their own SKILL.md
+ * frontmatter and may include references/assets. They are still rendered
+ * through placeholder resolution so init and update get byte-identical output.
+ */
+export function resolveBundledSkills(ctx) {
+    return getBundledSkillTemplates().flatMap((skill) => skill.files.map((file) => ({
+        relativePath: `${skill.name}/${file.relativePath}`,
+        content: resolvePlaceholders(file.content, ctx),
+    })));
+}
+// ---------------------------------------------------------------------------
+// Shared collectors
+// ---------------------------------------------------------------------------
+/** Collect skill files under a target root for update hash tracking. */
+export function collectSkillTemplates(skillsRoot, skills, bundledSkills = []) {
+    const files = new Map();
+    for (const skill of skills) {
+        files.set(`${skillsRoot}/${skill.name}/SKILL.md`, skill.content);
+    }
+    for (const skillFile of bundledSkills) {
+        files.set(`${skillsRoot}/${skillFile.relativePath}`, skillFile.content);
+    }
+    return files;
+}
+// ---------------------------------------------------------------------------
+// Template maps — a platform's file set, described once
+//
+// `collect<Platform>Templates()` returns `Map<relPath, content>`: the single
+// description of what a platform installs. `trellis update` diffs that map and
+// `configure` writes it through `writeTemplateMap`. Nothing else enumerates a
+// platform's files — two descriptions that disagree is how `trellis update`
+// silently stops managing a file (manifests/0.5.7.json).
+// ---------------------------------------------------------------------------
+/** Apply the python3 → python rewrite to every entry of a template map. */
+export function renderTemplateMap(files) {
+    const rendered = new Map();
+    for (const [relPath, content] of files) {
+        rendered.set(relPath, replacePythonCommandLiterals(content));
+    }
+    return rendered;
+}
+/**
+ * Write a collected template map into `cwd`.
+ *
+ * Renders through {@link renderTemplateMap} first — the same rewrite
+ * `collectPlatformTemplates` applies on the update path — so a file's
+ * init-time bytes and its update-time expected bytes cannot drift.
+ */
+export async function writeTemplateMap(cwd, files) {
+    for (const [relPath, content] of renderTemplateMap(files)) {
+        const absPath = path.join(cwd, ...relPath.split("/"));
+        ensureDir(path.dirname(absPath));
+        await writeFile(absPath, content);
+    }
+}
+/**
+ * Collect the shared hook scripts that `platform` actually registers, keyed
+ * under `hooksPath`. Driven by SHARED_HOOKS_BY_PLATFORM so a platform's hook
+ * set is never restated per configurator.
+ */
+export function collectSharedHooks(hooksPath, platform) {
+    const files = new Map();
+    for (const hook of getSharedHookScriptsForPlatform(platform)) {
+        files.set(`${hooksPath}/${hook.name}`, hook.content);
+    }
+    return files;
+}
+/** Collect commands + skills for "both" platforms (a commands directory plus
+ *  a skills root). */
+export function collectBothTemplates(ctx, cmdPath, skillRoot, wrapCmd) {
+    const files = new Map();
+    for (const cmd of resolveCommands(ctx)) {
+        const filePath = cmdPath(cmd.name);
+        files.set(filePath, wrapCmd ? wrapCmd(filePath, cmd.content) : cmd.content);
+    }
+    for (const [filePath, content] of collectSkillTemplates(skillRoot, resolveSkills(ctx), resolveBundledSkills(ctx))) {
+        files.set(filePath, content);
+    }
+    return files;
+}
+/** Build the standard "load Trellis context first" prelude block. */
+export function buildPullBasedPrelude(agentType) {
+    // JSONL filenames stay as implement.jsonl / check.jsonl — they are internal
+    // context buckets keyed by role (not by platform-visible agent name).
+    const jsonl = agentType === "check" ? "check.jsonl" : "implement.jsonl";
+    return replacePythonCommandLiterals(`## Required: Load Trellis Context First
+
+This platform does NOT auto-inject task context via hook. Before doing anything else, you MUST load context yourself.
+
+### Step 1: Find the active task path
+
+Try in order — stop at the first one that yields a task path:
+
+1. **Look at the dispatch prompt** you received from the main agent. If its first line is \`Active task: <path>\` (e.g. \`Active task: .trellis/tasks/04-17-foo\`), use that path. The main agent is required to include this line on class-2 platforms.
+2. **Run** \`python3 ./.trellis/scripts/task.py current --source\` and read the \`Current task:\` line.
+3. **If both fail** (no \`Active task:\` line in the prompt and \`task.py current\` returns no task), ask the user which task to work on; do NOT guess.
+
+### Step 2: Load task context from the resolved path
+
+1. Read \`<task-path>/${jsonl}\` — JSONL list of spec/research files relevant to this agent.
+2. For each entry in the JSONL, Read its \`file\` path — these are the specs and research notes you must follow.
+   **Skip rows without a \`"file"\` field** (e.g. \`{"_example": "..."}\` seed rows left over from \`task.py create\` before the curator ran).
+3. Read the task's \`prd.md\` (requirements), then \`design.md\` if present (technical design), then \`implement.md\` if present (execution plan).
+
+If \`${jsonl}\` has no curated entries (only a seed row, or the file is missing), fall back to: read the task artifacts, list available specs with \`python3 ./.trellis/scripts/get_context.py --mode packages\`, and pick the specs that match the task domain yourself. Do NOT block on the missing jsonl — read \`prd.md\`, \`design.md\`, and \`implement.md\` from the task directory instead.
+
+If the resolved task path has no \`prd.md\`, ask the user what to work on; do NOT proceed without context.
+
+---
+
+`);
+}
+/** Insert prelude into a markdown agent definition (after YAML frontmatter). */
+export function injectPullBasedPreludeMarkdown(content, agentType) {
+    const prelude = buildPullBasedPrelude(agentType);
+    const sections = splitMarkdownFrontmatter(content);
+    if (!sections) {
+        return prelude + content;
+    }
+    const head = `---\n${sections.frontmatter}\n---`;
+    const tailTrimmed = sections.body.replace(/^(\r?\n)+/, "");
+    return `${head}\n\n${prelude}${tailTrimmed}`;
+}
+/** Insert prelude into a TOML agent (codex `developer_instructions`). */
+export function injectPullBasedPreludeToml(content, agentType) {
+    const prelude = buildPullBasedPrelude(agentType);
+    // Match: developer_instructions = """  followed by newline
+    const re = /(developer_instructions\s*=\s*""")(\r?\n)/;
+    if (!re.test(content)) {
+        return content;
+    }
+    return content.replace(re, `$1$2${prelude}`);
+}
+/** Best-effort detect agent type from filename ("trellis-implement.md" → "implement").
+ *  Returns null for research and unknown names — they skip the prelude.
+ */
+export function detectSubAgentType(name) {
+    const base = name.replace(/\.(md|toml|prompt\.md)$/, "");
+    if (base === "trellis-implement" || base === "trellis-check") {
+        return base === "trellis-implement" ? "implement" : "check";
+    }
+    return null;
+}
+function splitMarkdownFrontmatter(content) {
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?/);
+    if (!match) {
+        return null;
+    }
+    return {
+        frontmatter: match[1],
+        body: content.slice(match[0].length),
+    };
+}
+export function applyPullBasedPreludeMarkdown(agents) {
+    return agents.map((a) => {
+        const t = detectSubAgentType(a.name);
+        if (!t)
+            return { ...a };
+        return {
+            ...a,
+            content: injectPullBasedPreludeMarkdown(a.content, t),
+        };
+    });
+}
+function mapLegacyToolToCopilot(tool) {
+    switch (tool) {
+        case "Read":
+            return ["read"];
+        case "Write":
+        case "Edit":
+            return ["edit"];
+        case "Glob":
+        case "Grep":
+            return ["search"];
+        case "Bash":
+            return ["execute"];
+        // Generic MCP wildcard — used by trellis-research to opt into "any MCP
+        // tool the user has configured" without locking the source template to a
+        // specific provider. Claude Code parses wildcards as glob-match-at-runtime
+        // (no silent agent-registration skip if nothing matches), so this is the
+        // safe default; explicit `mcp__exa__*` names would silent-skip the agent
+        // when the Exa MCP server is absent (#302).
+        case "mcp__*":
+            return ["web", "exa/*", "chrome-devtools/*"];
+        case "mcp__exa__web_search_exa":
+        case "mcp__exa__get_code_context_exa":
+            return ["web", "exa/*"];
+        case "mcp__chrome-devtools__*":
+            return ["chrome-devtools/*"];
+        case "Skill":
+            return [];
+        default:
+            return [];
+    }
+}
+function normalizeCopilotMarkdownAgentFrontmatter(content) {
+    const sections = splitMarkdownFrontmatter(content);
+    if (!sections) {
+        return content;
+    }
+    const frontmatter = sections.frontmatter.split(/\r?\n/);
+    const body = sections.body;
+    const normalized = [];
+    for (const line of frontmatter) {
+        if (!line.startsWith("tools:")) {
+            normalized.push(line);
+            continue;
+        }
+        const legacyTools = line
+            .slice("tools:".length)
+            .split(",")
+            .map((token) => token.trim())
+            .filter((token) => token.length > 0);
+        const tools = [...new Set(legacyTools.flatMap(mapLegacyToolToCopilot))];
+        normalized.push("tools:");
+        for (const tool of tools) {
+            normalized.push(`  - ${tool}`);
+        }
+    }
+    return `---\n${normalized.join("\n")}\n---\n${body}`;
+}
+export function normalizeCopilotMarkdownAgents(agents) {
+    return agents.map((agent) => ({
+        ...agent,
+        content: normalizeCopilotMarkdownAgentFrontmatter(agent.content),
+    }));
+}
+export function applyPullBasedPreludeToml(agents) {
+    return agents.map((a) => {
+        const t = detectSubAgentType(a.name);
+        if (!t)
+            return { ...a };
+        return {
+            ...a,
+            content: injectPullBasedPreludeToml(a.content, t),
+        };
+    });
+}
+//# sourceMappingURL=shared.js.map

package/dist/configurators/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/configurators/shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH;;;;;;;;;;;;GAYG;AACH,IAAI,qBAAqB,GAAkB,IAAI,CAAC;AAEhD,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,qBAAqB,GAAG,OAAO,IAAI,IAAI,CAAC;AAC1C,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,0BAA0B;IACxC,qBAAqB,GAAG,IAAI,CAAC;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CACzC,QAA0B;IAE1B,IAAI,QAAQ,KAAK,SAAS,IAAI,qBAAqB,EAAE,CAAC;QACpD,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IAC5C,OAAO,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAe;IAC1D,MAAM,MAAM,GAAG,2BAA2B,EAAE,CAAC;IAC7C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IACzC,OAAO,OAAO;SACX,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACZ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,CAClE;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,kDAAkD;AAClD,MAAM,aAAa,GAAG,qBAAqB,CAAC;AAC5C,MAAM,UAAU,GAAG,+BAA+B,CAAC;AACnD,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAC9C,MAAM,oBAAoB,GAAG,4BAA4B,CAAC;AAC1D,MAAM,WAAW,GAAG,mBAAmB,CAAC;AACxC,MAAM,cAAc,GAAG,SAAS,CAAC;AAEjC,MAAM,iBAAiB,GAAG,CAAC,eAAe,EAAE,WAAW,CAAU,CAAC;AAClE,MAAM,mBAAmB,GAAG,MAAM,CAAC,WAAW,CAC5C,iBAAiB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAC9B,IAAI;IACJ;QACE,GAAG,EAAE,IAAI,MAAM,CACb,UAAU,IAAI,4BAA4B,IAAI,QAAQ,EACtD,GAAG,CACJ;QACD,GAAG,EAAE,IAAI,MAAM,CACb,YAAY,IAAI,4BAA4B,IAAI,QAAQ,EACxD,GAAG,CACJ;KACF;CACF,CAAC,CACyE,CAAC;AAE9E,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,OAAyB;IAEzB,IAAI,MAAM,GAAG,4BAA4B,CACvC,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,2BAA2B,EAAE,CAAC,CAC9D,CAAC;IAEF,IAAI,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC;IAE5B,uBAAuB;IACvB,MAAM,GAAG,MAAM,CAAC,OAAO,CACrB,UAAU,EACV,CAAC,MAAM,EAAE,IAAY,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,EAAE,CAC3D,CAAC;IACF,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACvE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtD,qBAAqB;IACrB,MAAM,UAAU,GAAwD;QACtE,aAAa,EAAE,OAAO,CAAC,YAAY;QACnC,SAAS,EAAE,OAAO,CAAC,QAAQ;KAC5B,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC/C,yDAAyD;QACzD,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;QAClB,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;QAClB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAChD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,0DAA0D;IAC1D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAEhD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,0BAA0B,CACxC,OAAe,EACf,OAAyB;IAEzB,IAAI,MAAM,GAAG,4BAA4B,CACvC,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,2BAA2B,EAAE,CAAC,CAC9D,CAAC;IAEF,IAAI,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC;IAE5B,0DAA0D;IAC1D,MAAM,GAAG,MAAM,CAAC,OAAO,CACrB,UAAU,EACV,CAAC,MAAM,EAAE,IAAY,EAAE,EAAE,CAAC,KAAK,IAAI,sBAAsB,CAC1D,CAAC;IACF,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IACvE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtD,yEAAyE;IACzE,0FAA0F;IAC1F,MAAM,UAAU,GAAwD;QACtE,aAAa,EAAE,OAAO,CAAC,YAAY;QACnC,SAAS,EAAE,OAAO,CAAC,QAAQ;KAC5B,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC/C,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;QAClB,GAAG,CAAC,SAAS,GAAG,CAAC,CAAC;QAClB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAChD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAEhD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E,mFAAmF;AACnF,MAAM,kBAAkB,GAA2B;IACjD,KAAK,EACH,4VAA4V;IAC9V,QAAQ,EACN,kQAAkQ;IACpQ,aAAa,EACX,mNAAmN;IACrN,YAAY,EACV,wWAAwW;IAC1W,UAAU,EACR,udAAud;IACzd,KAAK,EACH,8QAA8Q;IAChR,GAAG,EACD,waAAwa;IAC1a,YAAY,EACV,6NAA6N;IAC/N,aAAa,EACX,oNAAoN;CACvN,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAY,EACZ,OAAe;IAEf,6DAA6D;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACjD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,kCAAkC,QAAQ,+CAA+C,CAC1F,CAAC;IACJ,CAAC;IACD,OAAO,cAAc,IAAI,mBAAmB,WAAW,aAAa,OAAO,EAAE,CAAC;AAChF,CAAC;AAED;;;GAGG;AACH,MAAM,oBAAoB,GAA2B;IACnD,KAAK,EAAE,2CAA2C;IAClD,QAAQ,EAAE,uDAAuD;IACjE,aAAa,EACX,+EAA+E;CAClF,CAAC;AAEF,gFAAgF;AAChF,MAAM,UAAU,0BAA0B,CACxC,IAAY,EACZ,OAAe;IAEf,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,oCAAoC,QAAQ,iDAAiD,CAC9F,CAAC;IACJ,CAAC;IACD,0EAA0E;IAC1E,yEAAyE;IACzE,+EAA+E;IAC/E,yDAAyD;IACzD,OAAO,cAAc,IAAI,kBAAkB,IAAI,CAAC,SAAS,CACvD,WAAW,CACZ,YAAY,OAAO,EAAE,CAAC;AACzB,CAAC;AAED;;;GAGG;AACH,MAAM,sBAAsB,GAA2B;IACrD,aAAa,EAAE,aAAa;CAC7B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,OAAe;IAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACnD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,oCAAoC,QAAQ,iDAAiD,CAC9F,CAAC;IACJ,CAAC;IACD,mDAAmD;IACnD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC9C,0EAA0E;IAC1E,iEAAiE;IACjE,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,IAAI;QACtB,CAAC,CAAC,qBAAqB,iBAAiB,oBAAoB,IAAI,CAAC,SAAS,CACtE,IAAI,CACL,OAAO;QACV,CAAC,CAAC,qBAAqB,iBAAiB,OAAO,CAAC;IAClD,OAAO,GAAG,WAAW,OAAO,IAAI,EAAE,CAAC;AACrC,CAAC;AAED,8EAA8E;AAC9E,8BAA8B;AAC9B,8EAA8E;AAE9E,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAEL,wBAAwB,EACxB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,+BAA+B,GAEhC,MAAM,oCAAoC,CAAC;AAe5C;;;;;;;;;;;;;;;GAeG;AACH,SAAS,cAAc,CACrB,SAA2B,EAC3B,GAAoB;IAEpB,IAAI,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QACrC,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAoB;IACrD,MAAM,SAAS,GAAG;QAChB,GAAG,cAAc,CAAC,mBAAmB,EAAE,EAAE,GAAG,CAAC;QAC7C,GAAG,iBAAiB,EAAE;KACvB,CAAC;IACF,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC9B,IAAI,EAAE,WAAW,IAAI,CAAC,IAAI,EAAE;QAC5B,OAAO,EAAE,wBAAwB,CAC/B,WAAW,IAAI,CAAC,IAAI,EAAE,EACtB,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CACvC;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,GAAoB;IAClD,OAAO,cAAc,CAAC,mBAAmB,EAAE,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC/D,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC;KAChD,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,GAAoB;IAChD,OAAO,iBAAiB,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxC,IAAI,EAAE,WAAW,IAAI,CAAC,IAAI,EAAE;QAC5B,OAAO,EAAE,wBAAwB,CAC/B,WAAW,IAAI,CAAC,IAAI,EAAE,EACtB,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CACvC;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAoB;IACvD,OAAO,iBAAiB,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxC,IAAI,EAAE,WAAW,IAAI,CAAC,IAAI,EAAE;QAC5B,OAAO,EAAE,wBAAwB,CAC/B,WAAW,IAAI,CAAC,IAAI,EAAE,EACtB,0BAA0B,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAC9C;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACvC,GAAoB;IAEpB,MAAM,SAAS,GAAG;QAChB,GAAG,cAAc,CAAC,mBAAmB,EAAE,EAAE,GAAG,CAAC;QAC7C,GAAG,iBAAiB,EAAE;KACvB,CAAC;IACF,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC9B,IAAI,EAAE,WAAW,IAAI,CAAC,IAAI,EAAE;QAC5B,OAAO,EAAE,wBAAwB,CAC/B,WAAW,IAAI,CAAC,IAAI,EAAE,EACtB,0BAA0B,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAC9C;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAAoB;IAEpB,OAAO,wBAAwB,EAAE,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAClD,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACzB,YAAY,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE;QAClD,OAAO,EAAE,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC;KAChD,CAAC,CAAC,CACJ,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,wEAAwE;AACxE,MAAM,UAAU,qBAAqB,CACnC,UAAkB,EAClB,MAAoD,EACpD,gBAA8C,EAAE;IAEhD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,CAAC,GAAG,CAAC,GAAG,UAAU,IAAI,KAAK,CAAC,IAAI,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC;IACD,KAAK,MAAM,SAAS,IAAI,aAAa,EAAE,CAAC;QACtC,KAAK,CAAC,GAAG,CAAC,GAAG,UAAU,IAAI,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,wDAAwD;AACxD,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,8EAA8E;AAC9E,4EAA4E;AAC5E,yDAAyD;AACzD,8EAA8E;AAE9E,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB,CAC/B,KAA0B;IAE1B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,KAAK,EAAE,CAAC;QACvC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,4BAA4B,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAW,EACX,KAA0B;IAE1B,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,iBAAiB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QACtD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACjC,MAAM,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAAiB,EACjB,QAA4B;IAE5B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,+BAA+B,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7D,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;sBACsB;AACtB,MAAM,UAAU,oBAAoB,CAClC,GAAoB,EACpB,OAAiC,EACjC,SAAiB,EACjB,OAAuD;IAEvD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,KAAK,MAAM,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC9E,CAAC;IACD,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,qBAAqB,CACrD,SAAS,EACT,aAAa,CAAC,GAAG,CAAC,EAClB,oBAAoB,CAAC,GAAG,CAAC,CAC1B,EAAE,CAAC;QACF,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAcD,qEAAqE;AACrE,MAAM,UAAU,qBAAqB,CAAC,SAAuB;IAC3D,4EAA4E;IAC5E,sEAAsE;IACtE,MAAM,KAAK,GAAG,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAExE,OAAO,4BAA4B,CAAC;;;;;;;;;;;;;;wBAcd,KAAK;;;;;OAKtB,KAAK;;;;;;CAMX,CAAC,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,8BAA8B,CAC5C,OAAe,EACf,SAAuB;IAEvB,MAAM,OAAO,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAEnD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,OAAO,GAAG,OAAO,CAAC;IAC3B,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,QAAQ,CAAC,WAAW,OAAO,CAAC;IACjD,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC3D,OAAO,GAAG,IAAI,OAAO,OAAO,GAAG,WAAW,EAAE,CAAC;AAC/C,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,0BAA0B,CACxC,OAAe,EACf,SAAuB;IAEvB,MAAM,OAAO,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACjD,2DAA2D;IAC3D,MAAM,EAAE,GAAG,2CAA2C,CAAC;IACvD,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACtB,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,OAAO,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,yBAAyB,EAAE,EAAE,CAAC,CAAC;IACzD,IAAI,IAAI,KAAK,mBAAmB,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;QAC7D,OAAO,IAAI,KAAK,mBAAmB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;IAC9D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAiBD,SAAS,wBAAwB,CAC/B,OAAe;IAEf,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACjE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;QACrB,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,MAA+B;IAE/B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACtB,MAAM,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,CAAC;YAAE,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,GAAG,CAAC;YACJ,OAAO,EAAE,8BAA8B,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;SACtD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,sBAAsB,CAAC,IAAY;IAC1C,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,KAAK,OAAO,CAAC;QACb,KAAK,MAAM;YACT,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpB,KAAK,MAAM;YACT,OAAO,CAAC,SAAS,CAAC,CAAC;QACrB,uEAAuE;QACvE,yEAAyE;QACzE,2EAA2E;QAC3E,yEAAyE;QACzE,yEAAyE;QACzE,4CAA4C;QAC5C,KAAK,QAAQ;YACX,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC;QAC/C,KAAK,0BAA0B,CAAC;QAChC,KAAK,gCAAgC;YACnC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC1B,KAAK,yBAAyB;YAC5B,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAC/B,KAAK,OAAO;YACV,OAAO,EAAE,CAAC;QACZ;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,wCAAwC,CAAC,OAAe;IAC/D,MAAM,QAAQ,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,MAAM,UAAU,GAAa,EAAE,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,SAAS;QACX,CAAC;QAED,MAAM,WAAW,GAAG,IAAI;aACrB,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;aACtB,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;aAC5B,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAExE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,UAAU,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,MAA+B;IAE/B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5B,GAAG,KAAK;QACR,OAAO,EAAE,wCAAwC,CAAC,KAAK,CAAC,OAAO,CAAC;KACjE,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,MAA+B;IAE/B,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACtB,MAAM,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,CAAC;YAAE,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,GAAG,CAAC;YACJ,OAAO,EAAE,0BAA0B,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;SAClD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/configurators/snow.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Snow CLI configurator.
+ *
+ * Snow CLI is a class-1 platform (agentCapable + auto context inject +
+ * project agent discovery + beforeSubAgentStart), same capability class as
+ * Claude Code / OMP — host protocol differs, workflow surface matches.
+ *
+ * Output paths:
+ * - `.snow/skills/` — workflow + bundled skills (Claude Code Skills layout)
+ * - `.snow/commands/trellis-*.json` — custom prompt slash commands (no trellis-start)
+ * - `.snow/agents/` — project sub-agents (auto-discovered by Snow; primary path)
+ * - `.snow/hooks/` — inject hooks (session / user / beforeSubAgentStart)
+ * - `.snow/SNOW.md` — operator guide
+ *
+ * Modern Snow does NOT ship `.snow/sub-agents.trellis.json` (legacy merge
+ * fragment for older hosts without project-agent discovery).
+ *
+ * hasHooks=true → filterCommands drops `start`; SessionStart injects context.
+ * Agents are written without class-2 pull-based prelude (hook inject is primary).
+ */
+/**
+ * The Snow CLI file set — written at init and diffed by `trellis update`.
+ */
+export declare function collectSnowTemplates(): Map<string, string>;
+//# sourceMappingURL=snow.d.ts.map

package/dist/configurators/snow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snow.d.ts","sourceRoot":"","sources":["../../src/configurators/snow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AA+CH;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAgC1D"}