@chinhae/atw-cli 0.1.0

package/dist/configurators/shared.js

@@ -0,0 +1,600 @@
+/**
+ * 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 with the fixed `atw-` prefix instead of the platform's own. This
+ * is the only placeholder that varies between platforms in the auto-triggered
+ * skill templates from `common/skills/`, so pinning it makes the rendered
+ * SKILL.md files byte-identical regardless of which ATW configurator wrote
+ * them — eliminating the "last-writer-wins" collision when both Codex and
+ * Gemini target `.agents/skills/`.
+ *
+ * `atw-<name>` is not a placeholder-shaped compromise: it is what the command
+ * is actually called under `.agents/skills/` (`atw-continue/SKILL.md`, …), so
+ * the neutral rendering names a thing that exists.
+ *
+ * Like the platform form, it emits a **bare token** and leaves formatting to
+ * the template. An earlier version emitted `` `name` (ATW command) `` —
+ * self-formatted — and every call site that (correctly) wrapped it in
+ * backticks produced ``` ``name` (ATW command)` ```, malformed markdown that
+ * shipped in four files. Inside a fenced diagram it was noise on top. A
+ * resolver cannot know its own context; the template can.
+ *
+ * `{{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. `atw-continue/SKILL.md`,
+ * `atw-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. Bare token, no
+    // backticks — the template decides the formatting (see the doc comment).
+    result = result.replace(RE_CMD_REF, (_match, name) => `atw-${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 (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 .atw/. 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 .atw/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, asks high-value questions one at a time, researches technical choices, and converges on MVP scope. 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.",
+    "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 .atw/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 atw- prefix)
+    const baseName = name.replace(/^atw-/, "");
+    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 an ATW 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(/^atw-/, "");
+    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(/^atw-/, "");
+    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 `atw-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 atw- 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: `atw-${tmpl.name}`,
+        content: wrapWithSkillFrontmatter(`atw-${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 atw- prefix + SKILL.md frontmatter.
+ * Used by "both" platforms for the auto-triggered skills.
+ */
+export function resolveSkills(ctx) {
+    return getSkillTemplates().map((tmpl) => ({
+        name: `atw-${tmpl.name}`,
+        content: wrapWithSkillFrontmatter(`atw-${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: `atw-${tmpl.name}`,
+        content: wrapWithSkillFrontmatter(`atw-${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: `atw-${tmpl.name}`,
+        content: wrapWithSkillFrontmatter(`atw-${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. `atw update` diffs that map and
+// `configure` writes it through `writeTemplateMap`. Nothing else enumerates a
+// platform's files — two descriptions that disagree is how `atw update`
+// silently stops managing a file — which has happened, and needed a
+// migration manifest to repair.
+// ---------------------------------------------------------------------------
+/** 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 ATW 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 === "atw-review" ? "check.jsonl" : "implement.jsonl";
+    return replacePythonCommandLiterals(`## Required: Load ATW 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: .atw/tasks/04-17-foo\`), use that path. The main agent is required to include this line on class-2 platforms.
+2. **Run** \`python3 ./.atw/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": "..."}\` placeholder rows left over from an older \`task.py create\`).
+3. Read the task's \`prd.md\` (requirements).
+
+If \`${jsonl}\` has no curated entries (empty, only a placeholder row, or the file is missing), fall back to: read the task artifacts, list available specs with \`python3 ./.atw/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\`, plus the task's tickets under \`issues/\` when it has been sliced.
+
+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 ("atw-review.md" → "atw-review").
+ *  Returns null for unknown names — they skip the prelude.
+ */
+export function detectSubAgentType(name) {
+    const base = name.replace(/\.(md|toml|prompt\.md)$/, "");
+    if (base === "atw-implement-agent" || base === "atw-review") {
+        return base;
+    }
+    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 — lets an agent template 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.
+        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":"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"}

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/atw-*.json` — custom prompt slash commands (no atw-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.atw.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 `atw 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"}