@chinhae/atw-cli 0.1.0

package/dist/configurators/shared.d.ts

@@ -0,0 +1,196 @@
+/**
+ * Shared utilities for platform configurators.
+ *
+ * Extracted here to avoid circular dependencies (index.ts imports configurators,
+ * configurators cannot import from index.ts).
+ */
+import type { TemplateContext } from "../types/ai-tools.js";
+/**
+ * Per-platform configure options threaded from `atw init` flags.
+ * Defined here (not in index.ts) so configurators can reference it without
+ * a circular import.
+ */
+export interface PlatformConfigureOptions {
+    /**
+     * Claude Code only: install the opt-in ATW statusLine
+     * (`atw init --with-statusline`). Off by default — see
+     * `configureClaude` in `claude.ts`.
+     */
+    withStatusline?: boolean;
+}
+export declare function setResolvedPythonCommand(cmd: string): void;
+/** Test helper — clear the resolved cache between unit tests. */
+export declare function resetResolvedPythonCommand(): void;
+/**
+ * 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 declare function getPythonCommandForPlatform(platform?: NodeJS.Platform): string;
+/**
+ * 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 declare function replacePythonCommandLiterals(content: string): string;
+export declare function resolvePlaceholders(content: string, context?: TemplateContext): string;
+/**
+ * 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 declare function resolvePlaceholdersNeutral(content: string, context?: TemplateContext): string;
+/**
+ * Wrap resolved template content with YAML frontmatter for skill format.
+ * Used by platforms that use SKILL.md (Codex, Kiro, Qoder, etc.).
+ */
+export declare function wrapWithSkillFrontmatter(name: string, content: string): string;
+/** Wrap resolved command content with YAML frontmatter (name + description). */
+export declare function wrapWithCommandFrontmatter(name: string, content: string): string;
+/**
+ * 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 declare function wrapWithOmpFrontmatter(name: string, content: string): string;
+import { type SharedHookPlatform } from "../templates/shared-hooks/index.js";
+/** A resolved template ready to be written to disk. */
+export interface ResolvedTemplate {
+    name: string;
+    content: string;
+}
+/** A resolved file inside a multi-file skill directory. */
+export interface ResolvedSkillFile {
+    /** POSIX path relative to the skills root, e.g. "atw-meta/SKILL.md" */
+    relativePath: string;
+    content: string;
+}
+/**
+ * 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 declare function resolveAllAsSkills(ctx: TemplateContext): ResolvedTemplate[];
+/**
+ * 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 declare function resolveCommands(ctx: TemplateContext): ResolvedTemplate[];
+/**
+ * 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 declare function resolveSkills(ctx: TemplateContext): ResolvedTemplate[];
+/**
+ * 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 declare function resolveSkillsNeutral(ctx: TemplateContext): ResolvedTemplate[];
+/**
+ * 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 declare function resolveAllAsSkillsNeutral(ctx: TemplateContext): ResolvedTemplate[];
+/**
+ * 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 declare function resolveBundledSkills(ctx: TemplateContext): ResolvedSkillFile[];
+/** Collect skill files under a target root for update hash tracking. */
+export declare function collectSkillTemplates(skillsRoot: string, skills: readonly {
+    name: string;
+    content: string;
+}[], bundledSkills?: readonly ResolvedSkillFile[]): Map<string, string>;
+/** Apply the python3 → python rewrite to every entry of a template map. */
+export declare function renderTemplateMap(files: Map<string, string>): Map<string, string>;
+/**
+ * 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 declare function writeTemplateMap(cwd: string, files: Map<string, string>): Promise<void>;
+/**
+ * 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 declare function collectSharedHooks(hooksPath: string, platform: SharedHookPlatform): Map<string, string>;
+/** Collect commands + skills for "both" platforms (a commands directory plus
+ *  a skills root). */
+export declare function collectBothTemplates(ctx: TemplateContext, cmdPath: (name: string) => string, skillRoot: string, wrapCmd?: (filePath: string, content: string) => string): Map<string, string>;
+export type SubAgentType = "atw-implement-agent" | "atw-review";
+/** Build the standard "load ATW context first" prelude block. */
+export declare function buildPullBasedPrelude(agentType: SubAgentType): string;
+/** Insert prelude into a markdown agent definition (after YAML frontmatter). */
+export declare function injectPullBasedPreludeMarkdown(content: string, agentType: SubAgentType): string;
+/** Insert prelude into a TOML agent (codex `developer_instructions`). */
+export declare function injectPullBasedPreludeToml(content: string, agentType: SubAgentType): string;
+/** Best-effort detect agent type from filename ("atw-review.md" → "atw-review").
+ *  Returns null for unknown names — they skip the prelude.
+ */
+export declare function detectSubAgentType(name: string): SubAgentType | null;
+/** Shared transform: given a list of agents, prepend pull-based prelude to
+ *  implement/check definitions. Used by both configurator (init-time write)
+ *  and collectPlatformTemplates (update-time hash comparison) so the two
+ *  code paths always agree on what's on disk.
+ */
+export interface AgentContent {
+    name: string;
+    content: string;
+}
+export declare function applyPullBasedPreludeMarkdown(agents: readonly AgentContent[]): AgentContent[];
+export declare function normalizeCopilotMarkdownAgents(agents: readonly AgentContent[]): AgentContent[];
+export declare function applyPullBasedPreludeToml(agents: readonly AgentContent[]): AgentContent[];
+//# sourceMappingURL=shared.d.ts.map

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

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