@blxzer/pactile 0.5.0

package/dist/commands/workflow.js.map

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

package/dist/configurators/cursor.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Configure Cursor (commands-only default policy):
+ *
+ * Pactile's Cursor adaptation is commands-only: the `/` palette shows
+ * only the user-facing slash commands, keeping the surface controlled and the
+ * entrypoints unambiguous. Internal workflow skills are NOT shipped to
+ * `.cursor/skills/` on Cursor (they remain available to Claude/Codex/Gemini
+ * via their own configurators, and their core rules reach the Cursor agent
+ * through `.cursor/rules` + `AGENTS.md` instead). This is a policy choice for
+ * palette hygiene and workflow reliability, not a statement about Agent Skills.
+ *
+ * - commands/pactile-{continue,finish-work}.md — common command templates
+ * - rules/*.mdc — always-apply / glob-scoped Cursor rules (Triage hard gate etc.)
+ * - agents/{name}.md — sub-agent definitions
+ * - hooks/*.py — shared hook scripts
+ * - hooks.json — hook configuration (separate file, not settings.json)
+ *
+ * Retired alternate-client setup assets are no longer shipped.
+ */
+export declare function configureCursor(cwd: string): Promise<void>;
+//# sourceMappingURL=cursor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/configurators/cursor.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0ChE"}

package/dist/configurators/cursor.js

@@ -0,0 +1,51 @@
+import path from "node:path";
+import { AI_TOOLS } from "../types/ai-tools.js";
+import { ensureDir, writeFile } from "../utils/file-writer.js";
+import { resolvePlaceholders, resolveCommands, writeAgents, writeSharedHooks, } from "./shared.js";
+import { getAllAgents, getAllRules, getCursorCommands, getHooksConfig, getWorktreesConfig, } from "../templates/cursor/index.js";
+/**
+ * Configure Cursor (commands-only default policy):
+ *
+ * Pactile's Cursor adaptation is commands-only: the `/` palette shows
+ * only the user-facing slash commands, keeping the surface controlled and the
+ * entrypoints unambiguous. Internal workflow skills are NOT shipped to
+ * `.cursor/skills/` on Cursor (they remain available to Claude/Codex/Gemini
+ * via their own configurators, and their core rules reach the Cursor agent
+ * through `.cursor/rules` + `AGENTS.md` instead). This is a policy choice for
+ * palette hygiene and workflow reliability, not a statement about Agent Skills.
+ *
+ * - commands/pactile-{continue,finish-work}.md — common command templates
+ * - rules/*.mdc — always-apply / glob-scoped Cursor rules (Triage hard gate etc.)
+ * - agents/{name}.md — sub-agent definitions
+ * - hooks/*.py — shared hook scripts
+ * - hooks.json — hook configuration (separate file, not settings.json)
+ *
+ * Retired alternate-client setup assets are no longer shipped.
+ */
+export async function configureCursor(cwd) {
+    const config = AI_TOOLS.cursor;
+    const ctx = config.templateContext;
+    const configRoot = path.join(cwd, config.configDir);
+    // .cursor/commands/ — user-facing slash commands (commands-only policy).
+    // Common commands (continue, finish-work). Cursor-only extras come from
+    // getCursorCommands() when present (no retired alternate-client assets).
+    const commandsDir = path.join(configRoot, "commands");
+    ensureDir(commandsDir);
+    for (const cmd of resolveCommands(ctx)) {
+        await writeFile(path.join(commandsDir, `pactile-${cmd.name}.md`), resolvePlaceholders(cmd.content, ctx));
+    }
+    for (const cmd of getCursorCommands()) {
+        await writeFile(path.join(commandsDir, `pactile-${cmd.name}.md`), resolvePlaceholders(cmd.content, ctx));
+    }
+    // .cursor/rules/*.mdc — the reliable context-injection channel on Cursor.
+    const rulesDir = path.join(configRoot, "rules");
+    ensureDir(rulesDir);
+    for (const rule of getAllRules()) {
+        await writeFile(path.join(rulesDir, rule.name), rule.content);
+    }
+    await writeAgents(path.join(configRoot, "agents"), getAllAgents());
+    await writeSharedHooks(path.join(configRoot, "hooks"), "cursor");
+    await writeFile(path.join(configRoot, "hooks.json"), resolvePlaceholders(getHooksConfig()));
+    await writeFile(path.join(configRoot, "worktrees.json"), resolvePlaceholders(getWorktreesConfig()));
+}
+//# sourceMappingURL=cursor.js.map

package/dist/configurators/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/configurators/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,WAAW,EACX,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,YAAY,EACZ,WAAW,EACX,iBAAiB,EACjB,cAAc,EACd,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAEtC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW;IAC/C,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,eAAe,CAAC;IACnC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAEpD,yEAAyE;IACzE,wEAAwE;IACxE,yEAAyE;IACzE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACtD,SAAS,CAAC,WAAW,CAAC,CAAC;IACvB,KAAK,MAAM,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,MAAM,SAAS,CACb,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,CAAC,IAAI,KAAK,CAAC,EAChD,mBAAmB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CACtC,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE,EAAE,CAAC;QACtC,MAAM,SAAS,CACb,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,CAAC,IAAI,KAAK,CAAC,EAChD,mBAAmB,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CACtC,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAChD,SAAS,CAAC,QAAQ,CAAC,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,EAAE,CAAC;QACjC,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC;IACnE,MAAM,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC;IAEjE,MAAM,SAAS,CACb,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,EACnC,mBAAmB,CAAC,cAAc,EAAE,CAAC,CACtC,CAAC;IAEF,MAAM,SAAS,CACb,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,EACvC,mBAAmB,CAAC,kBAAkB,EAAE,CAAC,CAC1C,CAAC;AACJ,CAAC"}

package/dist/configurators/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Platform Registry — Single source of truth for platform functions and derived helpers
+ *
+ * All platform-specific lists (backup dirs, template dirs, configured platforms, etc.)
+ * are derived from AI_TOOLS in types/ai-tools.js.
+ *
+ * Cursor-only fork: only the Cursor configurator and templates are wired.
+ */
+import { type AITool, type CliFlag } from "../types/ai-tools.js";
+/** All platform IDs */
+export declare const PLATFORM_IDS: AITool[];
+/** Actively targeted platform IDs for this fork. */
+export declare const FIRST_CLASS_PLATFORM_IDS: "cursor"[];
+/** Legacy adapter IDs retained for explicit compatibility, not default targeting. */
+export declare const LEGACY_PLATFORM_IDS: "cursor"[];
+/** All platform config directory names (e.g., [".cursor"]) */
+export declare const CONFIG_DIRS: string[];
+/** All managed paths for every platform (primary configDir + extra managed paths). */
+export declare const PLATFORM_MANAGED_DIRS: string[];
+/** All directories managed by the canonical Pactile template path. */
+export declare const ALL_MANAGED_DIRS: string[];
+/**
+ * Detect which platforms are configured by checking for configDir existence.
+ *
+ * Note: Detection uses only `configDir` (the platform-specific directory),
+ * NOT shared layers like `.agents/skills/`. This prevents false positives
+ * where a shared directory triggers detection of a specific platform.
+ */
+export declare function getConfiguredPlatforms(cwd: string): Set<AITool>;
+/**
+ * Get platform IDs that have Python hooks (for Windows encoding detection)
+ */
+export declare function getPlatformsWithPythonHooks(): AITool[];
+/**
+ * Check if a path starts with any managed directory
+ */
+export declare function isManagedPath(dirPath: string): boolean;
+/**
+ * Check if a directory name is a managed root directory (should not be deleted)
+ */
+export declare function isManagedRootDir(dirName: string): boolean;
+/**
+ * Get all managed paths for a platform.
+ */
+export declare function getPlatformManagedPaths(platformId: AITool): string[];
+/**
+ * Get the configure function for a platform
+ */
+export declare function configurePlatform(platformId: AITool, cwd: string): Promise<void>;
+/**
+ * Collect template files for a specific platform (for update tracking).
+ * Returns undefined if the platform doesn't support template tracking.
+ */
+export declare function collectPlatformTemplates(platformId: AITool): Map<string, string> | undefined;
+/**
+ * Build TOOLS array for interactive init prompt, derived from AI_TOOLS registry
+ */
+export declare function getInitToolChoices(): {
+    key: CliFlag;
+    name: string;
+    defaultChecked: boolean;
+    platformId: AITool;
+}[];
+/**
+ * Resolve CLI flag name to AITool id (e.g., "cursor" → "cursor")
+ */
+export declare function resolveCliFlag(flag: string): AITool | undefined;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/configurators/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAGL,KAAK,MAAM,EACX,KAAK,OAAO,EACb,MAAM,sBAAsB,CAAC;AAiH9B,uBAAuB;AACvB,eAAO,MAAM,YAAY,EAA4B,MAAM,EAAE,CAAC;AAE9D,oDAAoD;AACpD,eAAO,MAAM,wBAAwB,YAEpC,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,YAE/B,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,WAAW,UAAmD,CAAC;AAE5E,sFAAsF;AACtF,eAAO,MAAM,qBAAqB,UAEjC,CAAC;AAEF,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,UAAkD,CAAC;AAEhF;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAQ/D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,EAAE,CAEtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAMtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAEpE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,GACjB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAGjC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI;IACpC,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,OAAO,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB,EAAE,CAgBF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/D"}

package/dist/configurators/index.js

@@ -0,0 +1,170 @@
+/**
+ * Platform Registry — Single source of truth for platform functions and derived helpers
+ *
+ * All platform-specific lists (backup dirs, template dirs, configured platforms, etc.)
+ * are derived from AI_TOOLS in types/ai-tools.js.
+ *
+ * Cursor-only fork: only the Cursor configurator and templates are wired.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { AI_TOOLS, getManagedPaths, } from "../types/ai-tools.js";
+// Platform configurators
+import { configureCursor } from "./cursor.js";
+// Shared utilities
+import { replacePythonCommandLiterals, resolvePlaceholders, resolveCommands, } from "./shared.js";
+// Cursor-specific template content (agents, rules, hooks, settings, commands)
+import { getAllAgents as getCursorAgents, getAllRules as getCursorRules, getCursorCommands, getHooksConfig as getCursorHooksConfig, getWorktreesConfig, } from "../templates/cursor/index.js";
+import { getSharedHookScriptsForPlatform, } from "../templates/shared-hooks/index.js";
+/** Helper: collect the shared hook scripts that `platform` actually
+ *  registers. Keyed off SHARED_HOOKS_BY_PLATFORM so runtime install
+ *  (writeSharedHooks) and update diff (collectSharedHooks) never drift.
+ */
+function collectSharedHooks(hooksPath, platform) {
+    const files = new Map();
+    for (const hook of getSharedHookScriptsForPlatform(platform)) {
+        files.set(`${hooksPath}/${hook.name}`, hook.content);
+    }
+    return files;
+}
+/** Apply python3→python replacement to all content in a template map. */
+function replaceInMap(map) {
+    const result = new Map();
+    for (const [key, content] of map) {
+        result.set(key, replacePythonCommandLiterals(content));
+    }
+    return result;
+}
+/**
+ * Platform functions registry — maps each AITool to its behavior.
+ * Cursor-only fork: only the Cursor entry is registered.
+ */
+const PLATFORM_FUNCTIONS = {
+    cursor: {
+        configure: configureCursor,
+        collectTemplates: () => {
+            const ctx = AI_TOOLS.cursor.templateContext;
+            const files = new Map();
+            // commands-only policy: ship common commands (continue, finish-work) as
+            // .cursor/commands/pactile-*.md. Cursor-only extras (if any) come from
+            // getCursorCommands(). No .cursor/skills/ are shipped on Cursor —
+            // internal workflow skills reach the agent via .cursor/rules + AGENTS.md.
+            for (const cmd of resolveCommands(ctx)) {
+                files.set(`.cursor/commands/pactile-${cmd.name}.md`, resolvePlaceholders(cmd.content, ctx));
+            }
+            for (const cmd of getCursorCommands()) {
+                files.set(`.cursor/commands/pactile-${cmd.name}.md`, resolvePlaceholders(cmd.content, ctx));
+            }
+            for (const agent of getCursorAgents()) {
+                files.set(`.cursor/agents/${agent.name}.md`, agent.content);
+            }
+            // Rules: names already carry .mdc (Cursor requires the extension).
+            for (const rule of getCursorRules()) {
+                files.set(`.cursor/rules/${rule.name}`, rule.content);
+            }
+            for (const [k, v] of collectSharedHooks(".cursor/hooks", "cursor")) {
+                files.set(k, v);
+            }
+            files.set(".cursor/hooks.json", resolvePlaceholders(getCursorHooksConfig()));
+            files.set(".cursor/worktrees.json", resolvePlaceholders(getWorktreesConfig()));
+            return files;
+        },
+    },
+};
+// =============================================================================
+// Derived Helpers — all derived from AI_TOOLS registry
+// =============================================================================
+/** All platform IDs */
+export const PLATFORM_IDS = Object.keys(AI_TOOLS);
+/** Actively targeted platform IDs for this fork. */
+export const FIRST_CLASS_PLATFORM_IDS = PLATFORM_IDS.filter((id) => AI_TOOLS[id].tier === "first-class");
+/** Legacy adapter IDs retained for explicit compatibility, not default targeting. */
+export const LEGACY_PLATFORM_IDS = PLATFORM_IDS.filter((id) => AI_TOOLS[id].tier === "legacy");
+/** All platform config directory names (e.g., [".cursor"]) */
+export const CONFIG_DIRS = PLATFORM_IDS.map((id) => AI_TOOLS[id].configDir);
+/** All managed paths for every platform (primary configDir + extra managed paths). */
+export const PLATFORM_MANAGED_DIRS = PLATFORM_IDS.flatMap((id) => getManagedPaths(id));
+/** All directories managed by the canonical Pactile template path. */
+export const ALL_MANAGED_DIRS = [".pactile", ...new Set(PLATFORM_MANAGED_DIRS)];
+/**
+ * Detect which platforms are configured by checking for configDir existence.
+ *
+ * Note: Detection uses only `configDir` (the platform-specific directory),
+ * NOT shared layers like `.agents/skills/`. This prevents false positives
+ * where a shared directory triggers detection of a specific platform.
+ */
+export function getConfiguredPlatforms(cwd) {
+    const platforms = new Set();
+    for (const id of PLATFORM_IDS) {
+        if (fs.existsSync(path.join(cwd, AI_TOOLS[id].configDir))) {
+            platforms.add(id);
+        }
+    }
+    return platforms;
+}
+/**
+ * Get platform IDs that have Python hooks (for Windows encoding detection)
+ */
+export function getPlatformsWithPythonHooks() {
+    return PLATFORM_IDS.filter((id) => AI_TOOLS[id].hasPythonHooks);
+}
+/**
+ * Check if a path starts with any managed directory
+ */
+export function isManagedPath(dirPath) {
+    // Normalize Windows backslashes to forward slashes for consistent matching
+    const normalized = dirPath.replace(/\\/g, "/");
+    return ALL_MANAGED_DIRS.some((d) => normalized.startsWith(d + "/") || normalized === d);
+}
+/**
+ * Check if a directory name is a managed root directory (should not be deleted)
+ */
+export function isManagedRootDir(dirName) {
+    return ALL_MANAGED_DIRS.includes(dirName);
+}
+/**
+ * Get all managed paths for a platform.
+ */
+export function getPlatformManagedPaths(platformId) {
+    return getManagedPaths(platformId);
+}
+/**
+ * Get the configure function for a platform
+ */
+export function configurePlatform(platformId, cwd) {
+    return PLATFORM_FUNCTIONS[platformId].configure(cwd);
+}
+/**
+ * Collect template files for a specific platform (for update tracking).
+ * Returns undefined if the platform doesn't support template tracking.
+ */
+export function collectPlatformTemplates(platformId) {
+    const map = PLATFORM_FUNCTIONS[platformId].collectTemplates?.();
+    return map ? replaceInMap(map) : map;
+}
+/**
+ * Build TOOLS array for interactive init prompt, derived from AI_TOOLS registry
+ */
+export function getInitToolChoices() {
+    const sorted = [...PLATFORM_IDS].sort((a, b) => {
+        const aFirstClass = AI_TOOLS[a].tier === "first-class";
+        const bFirstClass = AI_TOOLS[b].tier === "first-class";
+        if (aFirstClass === bFirstClass) {
+            return 0;
+        }
+        return aFirstClass ? -1 : 1;
+    });
+    return sorted.map((id) => ({
+        key: AI_TOOLS[id].cliFlag,
+        name: AI_TOOLS[id].name,
+        defaultChecked: AI_TOOLS[id].defaultChecked,
+        platformId: id,
+    }));
+}
+/**
+ * Resolve CLI flag name to AITool id (e.g., "cursor" → "cursor")
+ */
+export function resolveCliFlag(flag) {
+    return PLATFORM_IDS.find((id) => AI_TOOLS[id].cliFlag === flag);
+}
+//# sourceMappingURL=index.js.map

package/dist/configurators/index.js.map

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

package/dist/configurators/shared.d.ts

@@ -0,0 +1,200 @@
+/**
+ * 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";
+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 in a platform-neutral form (`` `name` (Pactile command) ``)
+ * instead of substituting a platform-specific prefix. This is the only
+ * placeholder that varies between platforms in the 5 shared workflow skills
+ * (`brainstorm`, `before-dev`, `check`, `break-loop`, `update-spec`), so
+ * neutralizing it makes the rendered SKILL.md files byte-identical regardless
+ * of which Pactile Adapter 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 5
+ * shared skills do not use those placeholders, so they remain platform-
+ * neutral. Host-specific skill files (e.g. `pactile-continue/SKILL.md`,
+ * `pactile-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;
+/** 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. "pactile-meta/SKILL.md" */
+    relativePath: string;
+    content: string;
+}
+/**
+ * Resolve all templates as skills with the pactile- 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 only the shared skill templates with Pactile frontmatter.
+ * Used by "both" platforms for the auto-triggered skills.
+ */
+export declare function resolveSkills(ctx: TemplateContext): ResolvedTemplate[];
+/**
+ * Emit selected command templates as skills (e.g. `finish-work` for Cursor auto-trigger).
+ * Body comes from `common/commands/`; slash commands stay separate via {@link resolveCommands}.
+ */
+export declare function resolveCommandAsSkills(commandNames: string[], 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 5 shared 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[];
+/**
+ * Codex needs a `pactile-start` skill in `.agents/skills/` so the
+ * `<pactile-bootstrap>` notice from `inject-workflow-state.py` resolves
+ * to an actual skill file (the bootstrap notice tells the AI to invoke
+ * `$pactile-start` once on the first `no_task` turn.
+ * after the Codex SessionStart hook was removed for de-recursion).
+ *
+ * Built from `common/commands/start.md` + skill frontmatter; renders
+ * neutrally so init and update produce byte-identical output. Returns
+ * `null` if the template is missing (defensive — should never happen).
+ *
+ * Used by both `configureCodex()` (init path, file write) and
+ * `collectPlatformTemplates.codex` (update path, manifest map). Both
+ * paths must agree, otherwise upgraded users miss the file (which broke
+ * 0.4.x → 0.5.5/0.5.6 upgrades — see #247-style symptom: AI reports
+ * "no .agents/skills/pactile-start/SKILL.md" because update only ran
+ * `collectTemplates` and never wrote the file).
+ */
+export declare function resolveCodexPactileStartSkill(ctx: TemplateContext): ResolvedTemplate | null;
+/**
+ * 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[];
+/**
+ * Resolve selected optional/experimental skills (e.g. `chrome-cdp`).
+ *
+ * Only the explicitly requested names are resolved — the optional-skills
+ * directory is never installed by default. Unknown names throw, so a typo in
+ * `--with-optional` fails loudly instead of silently installing nothing.
+ */
+export declare function resolveOptionalSkills(names: readonly string[], 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>;
+/** Write skill directories from resolved templates and bundled skill files. */
+export declare function writeSkills(skillsRoot: string, skills: {
+    name: string;
+    content: string;
+}[], bundledSkills?: readonly ResolvedSkillFile[]): Promise<void>;
+/** Write agent/droid definition files */
+export declare function writeAgents(agentsDir: string, agents: {
+    name: string;
+    content: string;
+}[], ext?: string): Promise<void>;
+/** Write the shared hook scripts that `platform` actually registers. */
+export declare function writeSharedHooks(hooksDir: string, platform: import("../templates/shared-hooks/index.js").SharedHookPlatform): Promise<void>;
+export type SubAgentType = "implement" | "check";
+/** Build the standard "load Pactile 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 ("pactile-implement.md" → "implement").
+ *  Returns null for research and 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[];
+/**
+ * Build the only project-level Pactile instructions region.  The caller passes
+ * already validated public Tile metadata; Skill bodies and host details never
+ * enter AGENTS.md.
+ */
+export declare function buildPactileAgentsBlock(tiles: readonly {
+    readonly id: string;
+    readonly summary: string;
+}[]): string;
+//# 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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"}