vskill 1.0.16 → 1.0.18

package/dist/installer/canonical.d.ts

@@ -1,18 +1,24 @@
 import type { AgentDefinition } from "../agents/agents-registry.js";
-/**
- * Filter agents by target-agents frontmatter.
- * When targetAgents is undefined or empty, returns all agents (existing behavior).
- * When targetAgents is specified, returns only agents whose IDs are in the list.
- */
-export declare function filterAgentsByTargetAgents(agents: AgentDefinition[], targetAgents: string[] | undefined): AgentDefinition[];
 export interface InstallOptions {
     global: boolean;
     projectRoot: string;
 }
+/**
+ * 0845 T-002 (AC-US3-03): per-agent env-var overrides for global skills dirs.
+ *
+ * Only Antigravity is wired today (`VSKILL_ANTIGRAVITY_SKILLS_DIR`); the table
+ * structure is reusable when future agents need an analogous escape hatch.
+ * Returns null when no override applies so callers fall back to the
+ * registry-declared `globalSkillsDir`.
+ */
+export declare function resolveGlobalSkillsDirEnvOverride(agent: AgentDefinition): string | null;
 /**
  * Resolve the skills directory for an agent given the install scope.
  *
  * Global: uses agent.globalSkillsDir (e.g. ~/.claude/skills)
+ *         Honors per-agent env-var overrides via
+ *         `resolveGlobalSkillsDirEnvOverride()` — currently
+ *         `VSKILL_ANTIGRAVITY_SKILLS_DIR` for Antigravity.
  * Local:  uses projectRoot + agent.localSkillsDir (e.g. ./project/.claude/skills)
  */
 export declare function resolveAgentSkillsDir(agent: AgentDefinition, opts: InstallOptions): string;
@@ -36,3 +42,22 @@ export declare function installSymlink(skillName: string, content: string, agent
  * Optional agentFiles: additional files (e.g., agents/*.md) to install alongside SKILL.md.
  */
 export declare function installCopy(skillName: string, content: string, agents: AgentDefinition[], opts: InstallOptions, agentFiles?: Record<string, string>): string[];
+/**
+ * 0845 T-012/T-014: Resolve the Tier-2 INSTALL ROOT for an agent —
+ * the parent of `localSkillsDir` / `globalSkillsDir`. Tier-2 transformers
+ * emit relative paths that include their own subfolder layout (e.g.
+ * `rules/<name>.mdc` for Cursor), so the dispatcher joins those onto
+ * this root rather than onto the skills dir itself.
+ *
+ * Win32 (T-014, AC-US4-12): when `process.platform === "win32"` and the
+ * agent declares `win32PathOverride`, that path is the install root
+ * directly (no parent traversal). On POSIX hosts the override is ignored
+ * — agents continue to honor `globalSkillsDir`'s tilde-expanded form.
+ *
+ * Project-scope (`global: false`) keeps the existing path-traversal
+ * guard via `resolveAgentSkillsDir` so projects can't escape via a
+ * crafted `localSkillsDir`. The returned root for project-scope is the
+ * parent of the resolved skills dir, with the same traversal protection
+ * already in force.
+ */
+export declare function resolveAgentInstallRoot(agent: AgentDefinition, opts: InstallOptions): string;

package/dist/installer/canonical.js

@@ -5,25 +5,37 @@ import { join, relative, dirname, sep as pathSep } from "node:path";
 import os from "node:os";
 import { resolveTilde } from "../utils/paths.js";
 import { ensureFrontmatter, stripClaudeFields } from "./frontmatter.js";
+import { resolveBundleTarget } from "./bundle-files.js";
 /**
- * Filter agents by target-agents frontmatter.
- * When targetAgents is undefined or empty, returns all agents (existing behavior).
- * When targetAgents is specified, returns only agents whose IDs are in the list.
+ * 0845 T-002 (AC-US3-03): per-agent env-var overrides for global skills dirs.
+ *
+ * Only Antigravity is wired today (`VSKILL_ANTIGRAVITY_SKILLS_DIR`); the table
+ * structure is reusable when future agents need an analogous escape hatch.
+ * Returns null when no override applies so callers fall back to the
+ * registry-declared `globalSkillsDir`.
  */
-export function filterAgentsByTargetAgents(agents, targetAgents) {
-    if (!targetAgents || targetAgents.length === 0)
-        return agents;
-    const targetSet = new Set(targetAgents);
-    return agents.filter((a) => targetSet.has(a.id));
+export function resolveGlobalSkillsDirEnvOverride(agent) {
+    if (agent.id === "antigravity") {
+        const override = process.env.VSKILL_ANTIGRAVITY_SKILLS_DIR;
+        if (override && override.trim().length > 0)
+            return override.trim();
+    }
+    return null;
 }
 /**
  * Resolve the skills directory for an agent given the install scope.
  *
  * Global: uses agent.globalSkillsDir (e.g. ~/.claude/skills)
+ *         Honors per-agent env-var overrides via
+ *         `resolveGlobalSkillsDirEnvOverride()` — currently
+ *         `VSKILL_ANTIGRAVITY_SKILLS_DIR` for Antigravity.
  * Local:  uses projectRoot + agent.localSkillsDir (e.g. ./project/.claude/skills)
  */
 export function resolveAgentSkillsDir(agent, opts) {
     if (opts.global) {
+        const override = resolveGlobalSkillsDirEnvOverride(agent);
+        if (override)
+            return override;
         return resolveTilde(agent.globalSkillsDir);
     }
     const resolved = join(opts.projectRoot, agent.localSkillsDir);
@@ -105,11 +117,8 @@ const COPY_FALLBACK_AGENTS = new Set(["claude-code"]);
  * Keys are relative paths (e.g., "agents/frontend.md"), values are file contents.
  */
 function writeAgentFiles(targetDir, agentFiles) {
-    const resolvedTarget = join(targetDir, "."); // normalize
     for (const [relPath, fileContent] of Object.entries(agentFiles)) {
-        const fullPath = join(resolvedTarget, relPath);
-        if (!fullPath.startsWith(resolvedTarget))
-            continue; // path traversal guard
+        const fullPath = resolveBundleTarget(targetDir, relPath);
         mkdirSync(dirname(fullPath), { recursive: true });
         writeFileSync(fullPath, fileContent);
     }
@@ -189,4 +198,31 @@ export function installCopy(skillName, content, agents, opts, agentFiles) {
     }
     return installed;
 }
+/**
+ * 0845 T-012/T-014: Resolve the Tier-2 INSTALL ROOT for an agent —
+ * the parent of `localSkillsDir` / `globalSkillsDir`. Tier-2 transformers
+ * emit relative paths that include their own subfolder layout (e.g.
+ * `rules/<name>.mdc` for Cursor), so the dispatcher joins those onto
+ * this root rather than onto the skills dir itself.
+ *
+ * Win32 (T-014, AC-US4-12): when `process.platform === "win32"` and the
+ * agent declares `win32PathOverride`, that path is the install root
+ * directly (no parent traversal). On POSIX hosts the override is ignored
+ * — agents continue to honor `globalSkillsDir`'s tilde-expanded form.
+ *
+ * Project-scope (`global: false`) keeps the existing path-traversal
+ * guard via `resolveAgentSkillsDir` so projects can't escape via a
+ * crafted `localSkillsDir`. The returned root for project-scope is the
+ * parent of the resolved skills dir, with the same traversal protection
+ * already in force.
+ */
+export function resolveAgentInstallRoot(agent, opts) {
+    if (opts.global && process.platform === "win32" && agent.win32PathOverride) {
+        return agent.win32PathOverride;
+    }
+    // Reuse `resolveAgentSkillsDir` so env overrides + project-traversal
+    // guards stay in one place. Then climb one level to the install root.
+    const skillsDir = resolveAgentSkillsDir(agent, opts);
+    return dirname(skillsDir);
+}
 //# sourceMappingURL=canonical.js.map

package/dist/installer/canonical.js.map

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

package/dist/installer/clipboard-export.d.ts

@@ -0,0 +1,19 @@
+import type { ParsedSkill } from "./transformers/index.js";
+export interface ClipboardBlob {
+    /** The text the user will paste into the cloud tool. */
+    blob: string;
+    /** URL of the tool's docs page explaining where to paste. */
+    pasteInstructionsUrl: string;
+    /** Optional landing page for the tool itself. */
+    docsUrl?: string;
+}
+/**
+ * Build a clipboard-ready blob for a Tier-3 agent.
+ *
+ * The blob is a self-contained text payload: skill name, description, and
+ * full body separated by horizontal rules. ChatGPT-style cloud tools all
+ * accept arbitrary markdown into their custom-instruction boxes, so the
+ * same shape works for all current Tier-3 destinations. If a future
+ * destination needs a different shape, branch on `agentId` here.
+ */
+export declare function buildClipboardBlob(skill: ParsedSkill, agentId: string): ClipboardBlob;

package/dist/installer/clipboard-export.js

@@ -0,0 +1,88 @@
+// 0845 T-015 — Clipboard export for Tier-3 agents (ChatGPT, v0, bolt.new).
+//
+// Returns a paste-ready text blob without writing to disk. The Studio
+// renders the blob in `ClipboardExportDialog` and lets the user trigger
+// `navigator.clipboard.writeText` from a click handler (user gesture
+// required, per AC-US5-05).
+//
+// Tier 1/2 agents and unknown ids throw — the caller should already have
+// dispatched to the canonical or transformer path for those.
+import { getAgent } from "../agents/agents-registry.js";
+import { sanitizeSkillBundleFiles } from "./bundle-files.js";
+/**
+ * Build a clipboard-ready blob for a Tier-3 agent.
+ *
+ * The blob is a self-contained text payload: skill name, description, and
+ * full body separated by horizontal rules. ChatGPT-style cloud tools all
+ * accept arbitrary markdown into their custom-instruction boxes, so the
+ * same shape works for all current Tier-3 destinations. If a future
+ * destination needs a different shape, branch on `agentId` here.
+ */
+export function buildClipboardBlob(skill, agentId) {
+    const agent = getAgent(agentId);
+    if (!agent) {
+        throw new Error(`Unknown agentId: ${agentId}`);
+    }
+    if (agent.installMode !== "clipboard") {
+        throw new Error(`Agent "${agentId}" is not a Tier-3 clipboard target (installMode=${agent.installMode ?? "filesystem"})`);
+    }
+    const blob = renderClipboardSkillBlob(skill);
+    const result = {
+        blob,
+        pasteInstructionsUrl: agent.pasteInstructionsUrl ?? "",
+    };
+    if (agent.docsUrl)
+        result.docsUrl = agent.docsUrl;
+    return result;
+}
+function renderClipboardSkillBlob(skill) {
+    const sections = [
+        `# ${skill.name}`,
+        skill.description,
+        "---",
+        skill.body.trimEnd(),
+    ];
+    if (skill.originalFrontmatter.trim().length > 0) {
+        sections.push("## Skill frontmatter", fenceBlock("yaml", skill.originalFrontmatter.trimEnd()));
+    }
+    const bundleFiles = sanitizeSkillBundleFiles(skill.files);
+    const openAiMetadata = bundleFiles["agents/openai.yaml"];
+    if (openAiMetadata !== undefined) {
+        sections.push("## OpenAI agent metadata (`agents/openai.yaml`)", fenceBlock("yaml", openAiMetadata.trimEnd()));
+    }
+    const resourceEntries = Object.entries(bundleFiles)
+        .filter(([path]) => path !== "agents/openai.yaml")
+        .sort(([a], [b]) => a.localeCompare(b));
+    if (resourceEntries.length > 0) {
+        sections.push("## Bundled resources");
+        for (const [path, content] of resourceEntries) {
+            sections.push(`### ${path}`, fenceBlock(languageForPath(path), content.trimEnd()));
+        }
+    }
+    return sections.filter((section) => section.length > 0).join("\n\n") + "\n";
+}
+function fenceBlock(language, content) {
+    const tickRuns = content.match(/`{3,}/g) ?? [];
+    const fenceLength = Math.max(3, ...tickRuns.map((ticks) => ticks.length + 1));
+    const fence = "`".repeat(fenceLength);
+    return `${fence}${language}\n${content}\n${fence}`;
+}
+function languageForPath(path) {
+    if (path.endsWith(".md"))
+        return "markdown";
+    if (path.endsWith(".yaml") || path.endsWith(".yml"))
+        return "yaml";
+    if (path.endsWith(".json"))
+        return "json";
+    if (path.endsWith(".mjs") || path.endsWith(".js") || path.endsWith(".ts")) {
+        return "javascript";
+    }
+    if (path.endsWith(".py"))
+        return "python";
+    if (path.endsWith(".svg") || path.endsWith(".xml"))
+        return "xml";
+    if (path.endsWith(".sh"))
+        return "bash";
+    return "text";
+}
+//# sourceMappingURL=clipboard-export.js.map

package/dist/installer/clipboard-export.js.map

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

package/dist/installer/multi-install.d.ts

@@ -0,0 +1,43 @@
+import { AGENTS_REGISTRY } from "../agents/agents-registry.js";
+import type { ParsedSkill } from "./transformers/index.js";
+export type AgentInstallStatus = "installed" | "exported" | "skipped" | "error";
+export interface AgentInstallResult {
+    agentId: string;
+    status: AgentInstallStatus;
+    /** Installed: absolute path of the written file (or comma list when many).
+     *  Exported:  human-readable label including any downgrade warning.
+     *  Skipped:   reason.
+     *  Error:     error message. */
+    detail: string;
+    /** Tier 3 only: the blob to be copied to clipboard. */
+    blob?: string;
+    /** Tier 3 only: paste-instructions URL. */
+    pasteInstructionsUrl?: string;
+    /** Tier 3 only: docs URL. */
+    docsUrl?: string;
+}
+export interface MultiInstallResult {
+    skill: string;
+    scope: "project" | "user";
+    agents: AgentInstallResult[];
+    installedCount: number;
+    exportedCount: number;
+    errorCount: number;
+}
+export interface MultiInstallOptions {
+    skill: ParsedSkill;
+    agentIds: string[];
+    scope: "project" | "user";
+    /** Project root for project-scoped installs and for Tier-1 canonical writes. */
+    projectRoot: string;
+    /** Optional pre-rendered SKILL.md content. When omitted, the multi-install
+     *  reconstructs it from the parsedSkill (frontmatter + body). */
+    rawSkillContent?: string;
+}
+/**
+ * Install a skill to multiple agents in a single pass. Returns one result
+ * row per agent in the same order as `agentIds`. Never throws — each
+ * agent's outcome is captured in its own result row.
+ */
+export declare function installSkillToMultipleAgents(opts: MultiInstallOptions): Promise<MultiInstallResult>;
+export { AGENTS_REGISTRY };

package/dist/installer/multi-install.js

@@ -0,0 +1,237 @@
+// 0845 T-011/T-016 — installSkillToMultipleAgents.
+//
+// Sequential per-agent dispatcher. Per-agent try/catch isolation so one
+// agent's failure (transformer throw, path-traversal attempt, unknown id)
+// does NOT abort the others (AC-US4-10).
+//
+// Dispatch matrix:
+//   Tier 1 (installMode: "filesystem", no formatTransformer)
+//     → installSymlink() / installCopy() via canonical.ts (zero behavior change)
+//   Tier 2 (installMode: "filesystem", formatTransformer set)
+//     → run transformer, write each TransformedFile under resolveAgentInstallRoot,
+//       with path.relative() guard against traversal (AC-US4-11)
+//     → op:"append-yaml-list" goes through safeAppendYamlList per ADR-0845-03
+//   Tier 3 (installMode: "clipboard")
+//     → buildClipboardBlob — no disk write (AC-US5-07)
+//     → scope: "project" + Tier 3 → graceful downgrade, status "exported" with
+//       warning in detail (T-016, AC-US5-06)
+//
+// FR-002: sequential. The slowest write is ~fs.writeFile (microseconds),
+// so even 12 agents stays well under the 200ms-per-agent latency budget.
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join, dirname, relative, sep as pathSep, isAbsolute } from "node:path";
+import os from "node:os";
+import { AGENTS_REGISTRY, getAgent, } from "../agents/agents-registry.js";
+import { installSymlink, resolveAgentInstallRoot, } from "./canonical.js";
+import { buildClipboardBlob } from "./clipboard-export.js";
+import { safeAppendYamlList } from "./yaml-safe-mutate.js";
+import { sanitizeSkillBundleFiles } from "./bundle-files.js";
+/**
+ * Install a skill to multiple agents in a single pass. Returns one result
+ * row per agent in the same order as `agentIds`. Never throws — each
+ * agent's outcome is captured in its own result row.
+ */
+export async function installSkillToMultipleAgents(opts) {
+    const { skill, agentIds, scope, projectRoot } = opts;
+    const results = [];
+    for (const agentId of agentIds) {
+        try {
+            const agent = getAgent(agentId);
+            if (!agent) {
+                results.push({
+                    agentId,
+                    status: "error",
+                    detail: `unknown agent: ${agentId}`,
+                });
+                continue;
+            }
+            if (agent.installMode === "clipboard") {
+                results.push(dispatchTier3(agent, skill, scope));
+                continue;
+            }
+            if (agent.formatTransformer) {
+                results.push(dispatchTier2(agent, skill, scope, projectRoot));
+                continue;
+            }
+            // Tier 1 — canonical drop-in install.
+            results.push(dispatchTier1(agent, skill, scope, projectRoot, opts.rawSkillContent));
+        }
+        catch (err) {
+            // Defensive catch-all — every dispatch path already wraps its own
+            // errors, but if anything escapes, the multi-install loop must keep
+            // going so other agents still get processed.
+            results.push({
+                agentId,
+                status: "error",
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    const installedCount = results.filter((r) => r.status === "installed").length;
+    const exportedCount = results.filter((r) => r.status === "exported").length;
+    const errorCount = results.filter((r) => r.status === "error").length;
+    return {
+        skill: skill.name,
+        scope,
+        agents: results,
+        installedCount,
+        exportedCount,
+        errorCount,
+    };
+}
+// ---------------------------------------------------------------------------
+// Tier 1 — canonical drop-in via installSymlink
+// ---------------------------------------------------------------------------
+function dispatchTier1(agent, skill, scope, projectRoot, rawContent) {
+    const installOpts = {
+        global: scope === "user",
+        projectRoot,
+    };
+    const content = rawContent ?? reconstructSkillMd(skill);
+    const bundleFiles = sanitizeSkillBundleFiles(skill.files);
+    const writtenPaths = installSymlink(skill.name, content, [agent], installOpts, bundleFiles);
+    return {
+        agentId: agent.id,
+        status: "installed",
+        detail: writtenPaths.join(", "),
+    };
+}
+// ---------------------------------------------------------------------------
+// Tier 2 — transformer + filesystem write
+// ---------------------------------------------------------------------------
+function dispatchTier2(agent, skill, scope, projectRoot) {
+    if (!agent.formatTransformer) {
+        return {
+            agentId: agent.id,
+            status: "error",
+            detail: "internal: tier 2 dispatch without formatTransformer",
+        };
+    }
+    const installOpts = {
+        global: scope === "user",
+        projectRoot,
+    };
+    const installRoot = resolveAgentInstallRoot(agent, installOpts);
+    let files;
+    try {
+        files = [
+            ...agent.formatTransformer(skill),
+            ...buildTier2BundleFiles(skill),
+        ];
+    }
+    catch (err) {
+        return {
+            agentId: agent.id,
+            status: "error",
+            detail: err instanceof Error ? err.message : String(err),
+        };
+    }
+    const writtenPaths = [];
+    try {
+        for (const file of files) {
+            // Join with POSIX-style separator awareness — transformers always
+            // emit forward slashes, Node's path.join handles win32.
+            const joined = join(installRoot, ...file.relativePath.split("/"));
+            // op:"append-yaml-list" is the only sanctioned escape from the
+            // install root — Aider's ~/.aider.conf.yml lives at $HOME, not
+            // inside ~/.aider. Still bound by HOME (or projectRoot for project
+            // scope) so the dispatcher cannot be tricked into writing outside
+            // the user's filesystem boundary.
+            if (file.op === "append-yaml-list") {
+                const boundary = scope === "user" ? os.homedir() : projectRoot;
+                assertNoTraversal(boundary, joined);
+                const key = file.yamlListKey ?? "";
+                // Keep the value verbatim — Aider expects the literal `~/path` in
+                // its conf.yml so the file is portable across machines. The tilde
+                // resolution happens inside Aider itself at load time.
+                const value = file.yamlListValue ?? "";
+                if (!key || !value) {
+                    return {
+                        agentId: agent.id,
+                        status: "error",
+                        detail: "internal: append-yaml-list missing key or value",
+                    };
+                }
+                mkdirSync(dirname(joined), { recursive: true });
+                const r = safeAppendYamlList(joined, key, value);
+                writtenPaths.push(`${joined} (${r.status})`);
+            }
+            else {
+                assertNoTraversal(installRoot, joined);
+                mkdirSync(dirname(joined), { recursive: true });
+                writeFileSync(joined, file.content, { mode: file.mode });
+                writtenPaths.push(joined);
+            }
+        }
+    }
+    catch (err) {
+        return {
+            agentId: agent.id,
+            status: "error",
+            detail: err instanceof Error ? err.message : String(err),
+        };
+    }
+    return {
+        agentId: agent.id,
+        status: "installed",
+        detail: writtenPaths.join(", "),
+    };
+}
+// ---------------------------------------------------------------------------
+// Tier 3 — clipboard export (no disk write)
+// ---------------------------------------------------------------------------
+function dispatchTier3(agent, skill, scope) {
+    const blob = buildClipboardBlob(skill, agent.id);
+    const detailParts = ["clipboard blob ready"];
+    if (scope === "project") {
+        detailParts.push(`${agent.displayName} does not support project-scoped skills; exported as user-scope blob.`);
+    }
+    const result = {
+        agentId: agent.id,
+        status: "exported",
+        detail: detailParts.join(" — "),
+        blob: blob.blob,
+        pasteInstructionsUrl: blob.pasteInstructionsUrl,
+    };
+    if (blob.docsUrl)
+        result.docsUrl = blob.docsUrl;
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function assertNoTraversal(root, target) {
+    // Both paths are absolute (or both relative). path.relative returns
+    // a path that starts with ".." iff target escapes root. Matches the
+    // pre-existing guard at canonical.ts:54-58.
+    if (!isAbsolute(target)) {
+        throw new Error(`internal: install target must be absolute (got ${target})`);
+    }
+    const rel = relative(root, target);
+    if (rel === ".." || rel.startsWith(".." + pathSep) || rel.startsWith("../")) {
+        throw new Error(`Path traversal detected: ${target} escapes install root ${root}`);
+    }
+}
+function reconstructSkillMd(skill) {
+    // installSymlink expects the raw SKILL.md text — frontmatter + body.
+    // The parsedSkill carries `originalFrontmatter`; if absent, fabricate
+    // a minimal name+description block so installSymlink's
+    // `ensureFrontmatter` has something to work with.
+    const fm = skill.originalFrontmatter.trim().length > 0
+        ? skill.originalFrontmatter
+        : `name: ${skill.name}\ndescription: ${skill.description}`;
+    return `---\n${fm}\n---\n\n${skill.body}`;
+}
+function buildTier2BundleFiles(skill) {
+    const bundleFiles = sanitizeSkillBundleFiles(skill.files);
+    return Object.entries(bundleFiles)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([relativePath, content]) => ({
+        relativePath: `skills/${skill.name}/${relativePath}`,
+        content,
+    }));
+}
+// Re-export for ergonomic test access. Not strictly needed but lets
+// integration tests import the same registry the dispatcher sees.
+export { AGENTS_REGISTRY };
+//# sourceMappingURL=multi-install.js.map

package/dist/installer/multi-install.js.map

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

package/dist/installer/transformers/aider.d.ts

@@ -0,0 +1,2 @@
+import type { FormatTransformer } from "./index.js";
+export declare const aiderTransformer: FormatTransformer;

package/dist/installer/transformers/aider.js

@@ -0,0 +1,32 @@
+// 0845 T-010 — Aider transformer (Tier 2).
+//
+// Aider expects "conventions" files referenced from `~/.aider.conf.yml`'s
+// `read:` list. The transformer is pure — it emits two TransformedFiles:
+//
+//   1. conventions/<name>.md    op:"write"    body verbatim
+//   2. ../../.aider.conf.yml    op:"append-yaml-list"  key=read  value=~/.aider/conventions/<name>.md
+//
+// The dispatcher in multi-install.ts handles the conf.yml side effect
+// through safeAppendYamlList() per ADR-0845-03 — backup-write, idempotent
+// append, malformed-input rejection.
+//
+// The conf.yml relativePath ascends ONE level: the Aider install root is
+// `~/.aider` (the parent of `~/.aider/skills`), so `../` from there lands
+// at `$HOME` where `.aider.conf.yml` lives.
+export const aiderTransformer = (skill) => {
+    return [
+        {
+            relativePath: `conventions/${skill.name}.md`,
+            content: skill.body,
+            op: "write",
+        },
+        {
+            relativePath: "../.aider.conf.yml",
+            content: "",
+            op: "append-yaml-list",
+            yamlListKey: "read",
+            yamlListValue: `~/.aider/conventions/${skill.name}.md`,
+        },
+    ];
+};
+//# sourceMappingURL=aider.js.map

package/dist/installer/transformers/aider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aider.js","sourceRoot":"","sources":["../../../src/installer/transformers/aider.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,EAAE;AACF,0EAA0E;AAC1E,yEAAyE;AACzE,EAAE;AACF,4DAA4D;AAC5D,sGAAsG;AACtG,EAAE;AACF,sEAAsE;AACtE,0EAA0E;AAC1E,qCAAqC;AACrC,EAAE;AACF,yEAAyE;AACzE,0EAA0E;AAC1E,4CAA4C;AAI5C,MAAM,CAAC,MAAM,gBAAgB,GAAsB,CAAC,KAAK,EAAqB,EAAE;IAC9E,OAAO;QACL;YACE,YAAY,EAAE,eAAe,KAAK,CAAC,IAAI,KAAK;YAC5C,OAAO,EAAE,KAAK,CAAC,IAAI;YACnB,EAAE,EAAE,OAAO;SACZ;QACD;YACE,YAAY,EAAE,oBAAoB;YAClC,OAAO,EAAE,EAAE;YACX,EAAE,EAAE,kBAAkB;YACtB,WAAW,EAAE,MAAM;YACnB,aAAa,EAAE,wBAAwB,KAAK,CAAC,IAAI,KAAK;SACvD;KACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/installer/transformers/continue-dev.d.ts

@@ -0,0 +1,2 @@
+import type { FormatTransformer } from "./index.js";
+export declare const continueDevTransformer: FormatTransformer;

package/dist/installer/transformers/continue-dev.js

@@ -0,0 +1,6 @@
+// 0845 T-009 — Continue.dev transformer (Tier 2). Plain markdown at rules/<name>.md.
+// AC-US4-06.
+export const continueDevTransformer = (skill) => [
+    { relativePath: `rules/${skill.name}.md`, content: skill.body },
+];
+//# sourceMappingURL=continue-dev.js.map

package/dist/installer/transformers/continue-dev.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"continue-dev.js","sourceRoot":"","sources":["../../../src/installer/transformers/continue-dev.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,aAAa;AAIb,MAAM,CAAC,MAAM,sBAAsB,GAAsB,CAAC,KAAK,EAAqB,EAAE,CAAC;IACrF,EAAE,YAAY,EAAE,SAAS,KAAK,CAAC,IAAI,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE;CAChE,CAAC"}

package/dist/installer/transformers/cursor.d.ts

@@ -0,0 +1,2 @@
+import type { FormatTransformer } from "./index.js";
+export declare const cursorTransformer: FormatTransformer;