@aperant/framework 0.6.2

package/dist/cli/install/transforms/cursor.mjs

@@ -0,0 +1,34 @@
+/**
+ * install/transforms/cursor.mjs — Cursor transform.
+ *
+ * Cursor quirks:
+ *   - strip `color` and `skills` from frontmatter.
+ *   - skills land under .cursor/rules/<name>.mdc (Cursor uses .mdc for
+ *     rule files), agents under .cursor/commands/<name>.md.
+ */
+import { basename, dirname } from 'node:path';
+import { parseFrontmatter, serializeFrontmatter, stripFields, substituteVersion, } from './_shared.mjs';
+const STRIP = ['color', 'skills'];
+/**
+ * @param {import('../pipeline.mjs').TransformInput} input
+ * @returns {import('../pipeline.mjs').TransformOutput[]}
+ */
+export function transform({ canonicalContent, canonicalRelPath, version, fileType }) {
+    const subbed = substituteVersion(canonicalContent, version);
+    const parsed = parseFrontmatter(subbed);
+    let payload = subbed;
+    if (parsed.hasFrontmatter && parsed.fm) {
+        stripFields(parsed.fm, STRIP);
+        payload = serializeFrontmatter(parsed);
+    }
+    if (fileType === 'skill') {
+        const folder = basename(dirname(canonicalRelPath));
+        return [{ outputPath: `rules/${folder}.mdc`, content: payload }];
+    }
+    if (fileType === 'agent') {
+        const file = basename(canonicalRelPath, '.md');
+        return [{ outputPath: `commands/${file}.md`, content: payload }];
+    }
+    return [];
+}
+//# sourceMappingURL=cursor.mjs.map

package/dist/cli/install/transforms/cursor.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.mjs","sourceRoot":"","sources":["../../../../src/cli/install/transforms/cursor.mjs"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EACN,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,EACX,iBAAiB,GACjB,MAAM,eAAe,CAAA;AAEtB,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;AAEjC;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE;IAClF,MAAM,MAAM,GAAG,iBAAiB,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAA;IAC3D,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACvC,IAAI,OAAO,GAAG,MAAM,CAAA;IACpB,IAAI,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACxC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;QAC7B,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAA;IACvC,CAAC;IAED,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAA;QAClD,OAAO,CAAC,EAAE,UAAU,EAAE,SAAS,MAAM,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;IACjE,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAA;QAC9C,OAAO,CAAC,EAAE,UAAU,EAAE,YAAY,IAAI,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;IACjE,CAAC;IACD,OAAO,EAAE,CAAA;AACV,CAAC"}

package/dist/cli/install/transforms/gemini.d.mts

@@ -0,0 +1,14 @@
+/**
+ * Escape ${...} interpolation in body text. Already-escaped (\${) sequences
+ * are left alone so we don't double-escape on re-runs.
+ *
+ * @param {string} body
+ * @returns {string}
+ */
+export function escapeTemplateVars(body: string): string;
+/**
+ * @param {import('../pipeline.mjs').TransformInput} input
+ * @returns {import('../pipeline.mjs').TransformOutput[]}
+ */
+export function transform({ canonicalContent, canonicalRelPath, version, fileType }: import("../pipeline.mjs").TransformInput): import("../pipeline.mjs").TransformOutput[];
+//# sourceMappingURL=gemini.d.mts.map

package/dist/cli/install/transforms/gemini.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.mts","sourceRoot":"","sources":["../../../../src/cli/install/transforms/gemini.mjs"],"names":[],"mappings":"AAqBA;;;;;;GAMG;AACH,yCAHW,MAAM,GACJ,MAAM,CAKlB;AAED;;;GAGG;AACH,qFAHW,OAAO,iBAAiB,EAAE,cAAc,GACtC,OAAO,iBAAiB,EAAE,eAAe,EAAE,CA0BvD"}

package/dist/cli/install/transforms/gemini.mjs

@@ -0,0 +1,54 @@
+/**
+ * install/transforms/gemini.mjs — Gemini transform.
+ *
+ * Gemini quirks:
+ *   - frontmatter strips `color` (validation error in Gemini's schema) and
+ *     `tools`.
+ *   - body escapes `${var}` → `\${var}` so Gemini's templateString
+ *     interpolation does not fire on prose mentions of shell-style vars.
+ *   - output: .gemini/agents/<name>.md and .gemini/commands/<name>.md.
+ */
+import { basename, dirname } from 'node:path';
+import { parseFrontmatter, serializeFrontmatter, stripFields, substituteVersion, } from './_shared.mjs';
+const STRIP = ['color', 'tools'];
+/**
+ * Escape ${...} interpolation in body text. Already-escaped (\${) sequences
+ * are left alone so we don't double-escape on re-runs.
+ *
+ * @param {string} body
+ * @returns {string}
+ */
+export function escapeTemplateVars(body) {
+    // Negative lookbehind: only replace ${ that is NOT preceded by a backslash.
+    return body.replace(/(?<!\\)\$\{/g, '\\${');
+}
+/**
+ * @param {import('../pipeline.mjs').TransformInput} input
+ * @returns {import('../pipeline.mjs').TransformOutput[]}
+ */
+export function transform({ canonicalContent, canonicalRelPath, version, fileType }) {
+    const subbed = substituteVersion(canonicalContent, version);
+    const parsed = parseFrontmatter(subbed);
+    let payload;
+    if (parsed.hasFrontmatter && parsed.fm) {
+        stripFields(parsed.fm, STRIP);
+        const escapedBody = escapeTemplateVars(parsed.body);
+        payload = serializeFrontmatter({ ...parsed, body: escapedBody });
+    }
+    else {
+        payload = escapeTemplateVars(subbed);
+    }
+    if (fileType === 'skill') {
+        const folder = basename(dirname(canonicalRelPath));
+        return [
+            { outputPath: `agents/${folder}.md`, content: payload },
+            { outputPath: `commands/${folder}.md`, content: payload },
+        ];
+    }
+    if (fileType === 'agent') {
+        const file = basename(canonicalRelPath, '.md');
+        return [{ outputPath: `agents/${file}.md`, content: payload }];
+    }
+    return [];
+}
+//# sourceMappingURL=gemini.mjs.map

package/dist/cli/install/transforms/gemini.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.mjs","sourceRoot":"","sources":["../../../../src/cli/install/transforms/gemini.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EACN,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,EACX,iBAAiB,GACjB,MAAM,eAAe,CAAA;AAEtB,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;AAEhC;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAI;IACtC,4EAA4E;IAC5E,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC,CAAA;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE;IAClF,MAAM,MAAM,GAAG,iBAAiB,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAA;IAC3D,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACvC,IAAI,OAAO,CAAA;IACX,IAAI,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACxC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;QAC7B,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACnD,OAAO,GAAG,oBAAoB,CAAC,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAA;IACjE,CAAC;SAAM,CAAC;QACP,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAA;IACrC,CAAC;IAED,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAA;QAClD,OAAO;YACN,EAAE,UAAU,EAAE,UAAU,MAAM,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE;YACvD,EAAE,UAAU,EAAE,YAAY,MAAM,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE;SACzD,CAAA;IACF,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAA;QAC9C,OAAO,CAAC,EAAE,UAAU,EAAE,UAAU,IAAI,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,EAAE,CAAA;AACV,CAAC"}

package/dist/cli/install/transforms/kilo.d.mts

@@ -0,0 +1,6 @@
+/**
+ * @param {import('../pipeline.mjs').TransformInput} input
+ * @returns {import('../pipeline.mjs').TransformOutput[]}
+ */
+export function transform({ canonicalContent, canonicalRelPath, version, fileType }: import("../pipeline.mjs").TransformInput): import("../pipeline.mjs").TransformOutput[];
+//# sourceMappingURL=kilo.d.mts.map

package/dist/cli/install/transforms/kilo.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kilo.d.mts","sourceRoot":"","sources":["../../../../src/cli/install/transforms/kilo.mjs"],"names":[],"mappings":"AAWA;;;GAGG;AACH,qFAHW,OAAO,iBAAiB,EAAE,cAAc,GACtC,OAAO,iBAAiB,EAAE,eAAe,EAAE,CAgBvD"}

package/dist/cli/install/transforms/kilo.mjs

@@ -0,0 +1,29 @@
+/**
+ * install/transforms/kilo.mjs — Kilo transform.
+ *
+ * Same body/frontmatter transform as OpenCode (color → hex, strip the same
+ * agent fields) but writes under .kilo/agent/ + .kilo/command/. We import
+ * the OpenCode transform body and only diverge on output paths.
+ */
+import { basename, dirname } from 'node:path';
+import { applyOpencodeTransform } from './opencode.mjs';
+/**
+ * @param {import('../pipeline.mjs').TransformInput} input
+ * @returns {import('../pipeline.mjs').TransformOutput[]}
+ */
+export function transform({ canonicalContent, canonicalRelPath, version, fileType }) {
+    const payload = applyOpencodeTransform(canonicalContent, version);
+    if (fileType === 'skill') {
+        const folder = basename(dirname(canonicalRelPath));
+        return [
+            { outputPath: `agent/${folder}.md`, content: payload },
+            { outputPath: `command/${folder}.md`, content: payload },
+        ];
+    }
+    if (fileType === 'agent') {
+        const file = basename(canonicalRelPath, '.md');
+        return [{ outputPath: `agent/${file}.md`, content: payload }];
+    }
+    return [];
+}
+//# sourceMappingURL=kilo.mjs.map

package/dist/cli/install/transforms/kilo.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"kilo.mjs","sourceRoot":"","sources":["../../../../src/cli/install/transforms/kilo.mjs"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAEvD;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE;IAClF,MAAM,OAAO,GAAG,sBAAsB,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAA;IACjE,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAA;QAClD,OAAO;YACN,EAAE,UAAU,EAAE,SAAS,MAAM,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE;YACtD,EAAE,UAAU,EAAE,WAAW,MAAM,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE;SACxD,CAAA;IACF,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAA;QAC9C,OAAO,CAAC,EAAE,UAAU,EAAE,SAAS,IAAI,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;IAC9D,CAAC;IACD,OAAO,EAAE,CAAA;AACV,CAAC"}

package/dist/cli/install/transforms/opencode.d.mts

@@ -0,0 +1,16 @@
+/**
+ * Apply the OpenCode body+frontmatter transform. Exported so the kilo
+ * transform (which has the same body invariants but different output paths)
+ * can reuse it.
+ *
+ * @param {string} content
+ * @param {string} version
+ * @returns {string}
+ */
+export function applyOpencodeTransform(content: string, version: string): string;
+/**
+ * @param {import('../pipeline.mjs').TransformInput} input
+ * @returns {import('../pipeline.mjs').TransformOutput[]}
+ */
+export function transform({ canonicalContent, canonicalRelPath, version, fileType }: import("../pipeline.mjs").TransformInput): import("../pipeline.mjs").TransformOutput[];
+//# sourceMappingURL=opencode.d.mts.map

package/dist/cli/install/transforms/opencode.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.mts","sourceRoot":"","sources":["../../../../src/cli/install/transforms/opencode.mjs"],"names":[],"mappings":"AAwBA;;;;;;;;GAQG;AACH,gDAJW,MAAM,WACN,MAAM,GACJ,MAAM,CAalB;AAED;;;GAGG;AACH,qFAHW,OAAO,iBAAiB,EAAE,cAAc,GACtC,OAAO,iBAAiB,EAAE,eAAe,EAAE,CAgBvD"}

package/dist/cli/install/transforms/opencode.mjs

@@ -0,0 +1,59 @@
+/**
+ * install/transforms/opencode.mjs — OpenCode transform.
+ *
+ * OpenCode quirks:
+ *   - color names are converted to hex (`color: cyan` → `color: '#06b6d4'`)
+ *     because OpenCode's UI rejects symbolic names.
+ *   - agents strip `skills`, `memory`, `maxTurns`, `permissionMode`,
+ *     `disallowedTools` (none of these have OpenCode equivalents and they
+ *     trigger validation errors).
+ *   - output: .opencode/agent/<name>.md and .opencode/command/<name>.md
+ *     (note SINGULAR `agent` / `command`, not `agents` / `commands`).
+ */
+import { basename, dirname } from 'node:path';
+import { colorNameToHex, parseFrontmatter, serializeFrontmatter, stripFields, substituteVersion, } from './_shared.mjs';
+const STRIP = ['skills', 'memory', 'maxTurns', 'permissionMode', 'disallowedTools'];
+/**
+ * Apply the OpenCode body+frontmatter transform. Exported so the kilo
+ * transform (which has the same body invariants but different output paths)
+ * can reuse it.
+ *
+ * @param {string} content
+ * @param {string} version
+ * @returns {string}
+ */
+export function applyOpencodeTransform(content, version) {
+    const subbed = substituteVersion(content, version);
+    const parsed = parseFrontmatter(subbed);
+    if (!parsed.hasFrontmatter || !parsed.fm)
+        return subbed;
+    stripFields(parsed.fm, STRIP);
+    if (typeof parsed.fm.color === 'string') {
+        const hex = colorNameToHex(parsed.fm.color);
+        if (hex)
+            parsed.fm.color = hex;
+        else
+            delete parsed.fm.color;
+    }
+    return serializeFrontmatter(parsed);
+}
+/**
+ * @param {import('../pipeline.mjs').TransformInput} input
+ * @returns {import('../pipeline.mjs').TransformOutput[]}
+ */
+export function transform({ canonicalContent, canonicalRelPath, version, fileType }) {
+    const payload = applyOpencodeTransform(canonicalContent, version);
+    if (fileType === 'skill') {
+        const folder = basename(dirname(canonicalRelPath));
+        return [
+            { outputPath: `agent/${folder}.md`, content: payload },
+            { outputPath: `command/${folder}.md`, content: payload },
+        ];
+    }
+    if (fileType === 'agent') {
+        const file = basename(canonicalRelPath, '.md');
+        return [{ outputPath: `agent/${file}.md`, content: payload }];
+    }
+    return [];
+}
+//# sourceMappingURL=opencode.mjs.map

package/dist/cli/install/transforms/opencode.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.mjs","sourceRoot":"","sources":["../../../../src/cli/install/transforms/opencode.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EACN,cAAc,EACd,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,EACX,iBAAiB,GACjB,MAAM,eAAe,CAAA;AAEtB,MAAM,KAAK,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAAE,iBAAiB,CAAC,CAAA;AAEnF;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAO,EAAE,OAAO;IACtD,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAClD,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACvC,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAA;IACvD,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;IAC7B,IAAI,OAAO,MAAM,CAAC,EAAE,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAA;QAC3C,IAAI,GAAG;YAAE,MAAM,CAAC,EAAE,CAAC,KAAK,GAAG,GAAG,CAAA;;YACzB,OAAO,MAAM,CAAC,EAAE,CAAC,KAAK,CAAA;IAC5B,CAAC;IACD,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAA;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE;IAClF,MAAM,OAAO,GAAG,sBAAsB,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAA;IACjE,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAA;QAClD,OAAO;YACN,EAAE,UAAU,EAAE,SAAS,MAAM,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE;YACtD,EAAE,UAAU,EAAE,WAAW,MAAM,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE;SACxD,CAAA;IACF,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAA;QAC9C,OAAO,CAAC,EAAE,UAAU,EAAE,SAAS,IAAI,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;IAC9D,CAAC;IACD,OAAO,EAAE,CAAA;AACV,CAAC"}

package/dist/cli/install/transforms/qwen.d.mts

@@ -0,0 +1,2 @@
+export const transform: (input: import("../pipeline.mjs").TransformInput) => import("../pipeline.mjs").TransformOutput[];
+//# sourceMappingURL=qwen.d.mts.map

package/dist/cli/install/transforms/qwen.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qwen.d.mts","sourceRoot":"","sources":["../../../../src/cli/install/transforms/qwen.mjs"],"names":[],"mappings":"AAUA,yHAGE"}

package/dist/cli/install/transforms/qwen.mjs

@@ -0,0 +1,13 @@
+/**
+ * install/transforms/qwen.mjs — Qwen transform.
+ *
+ * Quirks (per GSD reference):
+ *   - strips color+skills+tools.
+ *   - output: .qwen/agents/<name>.md + .qwen/commands/<name>.md.
+ */
+import { createSimpleTransform } from './_shared.mjs';
+export const transform = createSimpleTransform({
+    strip: ['color', 'skills', 'tools'],
+    rewriteCommands: false,
+});
+//# sourceMappingURL=qwen.mjs.map

package/dist/cli/install/transforms/qwen.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"qwen.mjs","sourceRoot":"","sources":["../../../../src/cli/install/transforms/qwen.mjs"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAErD,MAAM,CAAC,MAAM,SAAS,GAAG,qBAAqB,CAAC;IAC9C,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC;IACnC,eAAe,EAAE,KAAK;CACtB,CAAC,CAAA"}

package/dist/cli/install/transforms/trae.d.mts

@@ -0,0 +1,2 @@
+export const transform: (input: import("../pipeline.mjs").TransformInput) => import("../pipeline.mjs").TransformOutput[];
+//# sourceMappingURL=trae.d.mts.map

package/dist/cli/install/transforms/trae.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trae.d.mts","sourceRoot":"","sources":["../../../../src/cli/install/transforms/trae.mjs"],"names":[],"mappings":"AAUA,yHAGE"}

package/dist/cli/install/transforms/trae.mjs

@@ -0,0 +1,13 @@
+/**
+ * install/transforms/trae.mjs — Trae transform.
+ *
+ * Quirks:
+ *   - strips color+skills+tools.
+ *   - output: .trae/agents/<name>.md + .trae/commands/<name>.md.
+ */
+import { createSimpleTransform } from './_shared.mjs';
+export const transform = createSimpleTransform({
+    strip: ['color', 'skills', 'tools'],
+    rewriteCommands: false,
+});
+//# sourceMappingURL=trae.mjs.map

package/dist/cli/install/transforms/trae.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trae.mjs","sourceRoot":"","sources":["../../../../src/cli/install/transforms/trae.mjs"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAErD,MAAM,CAAC,MAAM,SAAS,GAAG,qBAAqB,CAAC;IAC9C,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC;IACnC,eAAe,EAAE,KAAK;CACtB,CAAC,CAAA"}

package/dist/cli/install/transforms/windsurf.d.mts

@@ -0,0 +1,6 @@
+/**
+ * @param {import('../pipeline.mjs').TransformInput} input
+ * @returns {import('../pipeline.mjs').TransformOutput[]}
+ */
+export function transform({ canonicalContent, canonicalRelPath, version, fileType }: import("../pipeline.mjs").TransformInput): import("../pipeline.mjs").TransformOutput[];
+//# sourceMappingURL=windsurf.d.mts.map

package/dist/cli/install/transforms/windsurf.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.d.mts","sourceRoot":"","sources":["../../../../src/cli/install/transforms/windsurf.mjs"],"names":[],"mappings":"AAmBA;;;GAGG;AACH,qFAHW,OAAO,iBAAiB,EAAE,cAAc,GACtC,OAAO,iBAAiB,EAAE,eAAe,EAAE,CAoBvD"}

package/dist/cli/install/transforms/windsurf.mjs

@@ -0,0 +1,34 @@
+/**
+ * install/transforms/windsurf.mjs — Windsurf transform.
+ *
+ * Windsurf quirks:
+ *   - frontmatter strips color+skills.
+ *   - skills land in .windsurf/rules/<name>.md (Windsurf rule files).
+ *   - agents/invocable land in .windsurf/workflows/<name>.md.
+ */
+import { basename, dirname } from 'node:path';
+import { parseFrontmatter, serializeFrontmatter, stripFields, substituteVersion, } from './_shared.mjs';
+const STRIP = ['color', 'skills'];
+/**
+ * @param {import('../pipeline.mjs').TransformInput} input
+ * @returns {import('../pipeline.mjs').TransformOutput[]}
+ */
+export function transform({ canonicalContent, canonicalRelPath, version, fileType }) {
+    const subbed = substituteVersion(canonicalContent, version);
+    const parsed = parseFrontmatter(subbed);
+    let payload = subbed;
+    if (parsed.hasFrontmatter && parsed.fm) {
+        stripFields(parsed.fm, STRIP);
+        payload = serializeFrontmatter(parsed);
+    }
+    if (fileType === 'skill') {
+        const folder = basename(dirname(canonicalRelPath));
+        return [{ outputPath: `rules/${folder}.md`, content: payload }];
+    }
+    if (fileType === 'agent') {
+        const file = basename(canonicalRelPath, '.md');
+        return [{ outputPath: `workflows/${file}.md`, content: payload }];
+    }
+    return [];
+}
+//# sourceMappingURL=windsurf.mjs.map

package/dist/cli/install/transforms/windsurf.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"windsurf.mjs","sourceRoot":"","sources":["../../../../src/cli/install/transforms/windsurf.mjs"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,EACN,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,EACX,iBAAiB,GACjB,MAAM,eAAe,CAAA;AAEtB,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;AAEjC;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE;IAClF,MAAM,MAAM,GAAG,iBAAiB,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAA;IAC3D,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAA;IACvC,IAAI,OAAO,GAAG,MAAM,CAAA;IACpB,IAAI,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACxC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;QAC7B,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAA;IACvC,CAAC;IAED,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAA;QAClD,OAAO,CAAC,EAAE,UAAU,EAAE,SAAS,MAAM,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;IAChE,CAAC;IACD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAA;QAC9C,OAAO,CAAC,EAAE,UAAU,EAAE,aAAa,IAAI,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAA;IAClE,CAAC;IACD,OAAO,EAAE,CAAA;AACV,CAAC"}

package/dist/cli/install/update-chips.d.mts

@@ -0,0 +1,47 @@
+/**
+ * @typedef {Object} UpdateCache
+ * @property {boolean} not_published
+ * @property {boolean} update_available
+ * @property {boolean} dev_install_ahead
+ * @property {number} stale_files_total
+ * @property {string} checked_at
+ * @property {string|null} [lookup_error]  set when npm view threw a non-404 error
+ */
+/**
+ * Resolve the cache file location. Honors $HOME (tests inject a tmp HOME)
+ * via os.homedir() which respects the env.
+ *
+ * @returns {string}
+ */
+export function updateCachePath(): string;
+/**
+ * Read the worker's cache file. Returns null when missing or malformed —
+ * statusline shows no chips in that case.
+ *
+ * @returns {UpdateCache|null}
+ */
+export function readUpdateCache(): UpdateCache | null;
+/**
+ * Build the chip string array for a given cache. Empty array when there
+ * are no chips to show. Order: stale_files first (most urgent), then
+ * update_available, then dev-ahead, then not-published, then lookup_error.
+ *
+ * @param {UpdateCache|null} cache
+ * @param {{ color: boolean }} opts
+ * @returns {string[]}
+ */
+export function formatUpdateChips(cache: UpdateCache | null, { color }: {
+    color: boolean;
+}): string[];
+export type UpdateCache = {
+    not_published: boolean;
+    update_available: boolean;
+    dev_install_ahead: boolean;
+    stale_files_total: number;
+    checked_at: string;
+    /**
+     * set when npm view threw a non-404 error
+     */
+    lookup_error?: string | null | undefined;
+};
+//# sourceMappingURL=update-chips.d.mts.map

package/dist/cli/install/update-chips.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-chips.d.mts","sourceRoot":"","sources":["../../../src/cli/install/update-chips.mjs"],"names":[],"mappings":"AAwBA;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,mCAFa,MAAM,CAIlB;AAED;;;;;GAKG;AACH,mCAFa,WAAW,GAAC,IAAI,CAY5B;AAED;;;;;;;;GAQG;AACH,yCAJW,WAAW,GAAC,IAAI,aAChB;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAChB,MAAM,EAAE,CA0BpB;;mBArEa,OAAO;sBACP,OAAO;uBACP,OAAO;uBACP,MAAM;gBACN,MAAM"}

package/dist/cli/install/update-chips.mjs

@@ -0,0 +1,94 @@
+/**
+ * install/update-chips.mjs — read the SessionStart worker's cache file
+ * and produce the colored statusline chip(s) for it.
+ *
+ * Color scheme (matches GSD precedent):
+ *   - yellow ⬆ /apt:update          when update_available
+ *   - red    ⚠ stale skills — run /apt:update    when stale_files_total > 0
+ *   - yellow ⚠ dev install — re-run installer    when dev_install_ahead
+ *   - dim    ? /apt:update          when not_published
+ *
+ * NO_COLOR is honored upstream (statusline computes the `color` flag).
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+const ANSI = {
+    yellow: '\x1b[33m',
+    red: '\x1b[31m',
+    dim: '\x1b[2m',
+    reset: '\x1b[0m',
+};
+/**
+ * @typedef {Object} UpdateCache
+ * @property {boolean} not_published
+ * @property {boolean} update_available
+ * @property {boolean} dev_install_ahead
+ * @property {number} stale_files_total
+ * @property {string} checked_at
+ * @property {string|null} [lookup_error]  set when npm view threw a non-404 error
+ */
+/**
+ * Resolve the cache file location. Honors $HOME (tests inject a tmp HOME)
+ * via os.homedir() which respects the env.
+ *
+ * @returns {string}
+ */
+export function updateCachePath() {
+    return join(homedir(), '.cache', 'aperant', 'apt-update-check.json');
+}
+/**
+ * Read the worker's cache file. Returns null when missing or malformed —
+ * statusline shows no chips in that case.
+ *
+ * @returns {UpdateCache|null}
+ */
+export function readUpdateCache() {
+    const path = updateCachePath();
+    if (!existsSync(path))
+        return null;
+    try {
+        const data = JSON.parse(readFileSync(path, 'utf-8'));
+        if (!data || typeof data !== 'object')
+            return null;
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Build the chip string array for a given cache. Empty array when there
+ * are no chips to show. Order: stale_files first (most urgent), then
+ * update_available, then dev-ahead, then not-published, then lookup_error.
+ *
+ * @param {UpdateCache|null} cache
+ * @param {{ color: boolean }} opts
+ * @returns {string[]}
+ */
+export function formatUpdateChips(cache, { color }) {
+    if (!cache)
+        return [];
+    const chips = [];
+    const wrap = (ansi, text) => (color ? `${ansi}${text}${ANSI.reset}` : text);
+    if (cache.stale_files_total && cache.stale_files_total > 0) {
+        chips.push(wrap(ANSI.red, '⚠ stale skills — run /apt:update'));
+    }
+    if (cache.update_available) {
+        chips.push(wrap(ANSI.yellow, '⬆ /apt:update'));
+    }
+    if (cache.dev_install_ahead) {
+        chips.push(wrap(ANSI.yellow, '⚠ dev install — re-run installer'));
+    }
+    if (cache.not_published) {
+        chips.push(wrap(ANSI.dim, '? /apt:update'));
+    }
+    // Show a dim warning chip when the npm lookup failed with a non-404 error
+    // (network timeout, ENOTFOUND, etc.). This distinguishes "genuinely up to
+    // date" from "we don't know because the check failed".
+    if (cache.lookup_error) {
+        chips.push(wrap(ANSI.dim, '⚠ /apt:update — check failed'));
+    }
+    return chips;
+}
+//# sourceMappingURL=update-chips.mjs.map

package/dist/cli/install/update-chips.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-chips.mjs","sourceRoot":"","sources":["../../../src/cli/install/update-chips.mjs"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,IAAI,GAAG;IACZ,MAAM,EAAE,UAAU;IAClB,GAAG,EAAE,UAAU;IACf,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,SAAS;CAChB,CAAA;AAED;;;;;;;;GAQG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC9B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,uBAAuB,CAAC,CAAA;AACrE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe;IAC9B,MAAM,IAAI,GAAG,eAAe,EAAE,CAAA;IAC9B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAClC,IAAI,CAAC;QACJ,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;QACpD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAA;QAClD,OAAO,IAAI,CAAA;IACZ,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAA;IACZ,CAAC;AACF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE;IACjD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IACrB,MAAM,KAAK,GAAG,EAAE,CAAA;IAChB,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAE3E,IAAI,KAAK,CAAC,iBAAiB,IAAI,KAAK,CAAC,iBAAiB,GAAG,CAAC,EAAE,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,kCAAkC,CAAC,CAAC,CAAA;IAC/D,CAAC;IACD,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAAA;IAC/C,CAAC;IACD,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,kCAAkC,CAAC,CAAC,CAAA;IAClE,CAAC;IACD,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAA;IAC5C,CAAC;IACD,0EAA0E;IAC1E,0EAA0E;IAC1E,uDAAuD;IACvD,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,8BAA8B,CAAC,CAAC,CAAA;IAC3D,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC"}

package/dist/cli/install/version-header.d.mts

@@ -0,0 +1,103 @@
+/**
+ * Compute SHA-256 hex digest of a Buffer or string.
+ *
+ * @param {Buffer|string} buf
+ * @returns {string}
+ */
+export function sha256(buf: Buffer | string): string;
+/**
+ * Resolve `entryPath` relative to `installRoot`, asserting containment.
+ * Throws for absolute paths or paths that escape installRoot via '..'.
+ *
+ * @param {string} installRoot  absolute install root directory
+ * @param {string} entryPath    relative path from manifest entry
+ * @returns {string}  resolved absolute path
+ */
+export function safeResolveWithin(installRoot: string, entryPath: string): string;
+/**
+ * Walk a parsed manifest's file list and return an array of stale-file
+ * records. This is the single source of truth for the per-file inspection
+ * loop; both `check-version` and the SessionStart worker delegate here.
+ *
+ * Each entry in the returned array has:
+ *   `{ path: string, reason: 'missing_file'|'hash_mismatch'|'missing_header'|'header_mismatch'|'invalid_path' }`
+ *
+ * @param {object} manifest        parsed apt-file-manifest.json (files[], framework_version)
+ * @param {string} installRoot     absolute path to the runtime install root
+ * @param {{ installedAtMs?: number }} [opts]
+ *   `installedAtMs` — when provided, files whose mtime <= this value skip the
+ *   hash+header check (fast path: no drift since last install).
+ * @returns {Array<{path: string, reason: string}>}
+ */
+export function inspectManifestFiles(manifest: object, installRoot: string, opts?: {
+    installedAtMs?: number;
+}): Array<{
+    path: string;
+    reason: string;
+}>;
+/**
+ * Pre-substitute the canonical `{{APT_VERSION}}` Mustache token with a
+ * YAML-safe placeholder so callers can `yaml.parse` canonical
+ * frontmatter without emitting the flow-map-key warning. Pure string
+ * function; idempotent on already-substituted content.
+ *
+ * Use this at every canonical-file parse site that runs BEFORE install
+ * substitution (e.g. `apt-tools check`, schema-validation tests). The
+ * install pipeline itself does NOT need this — it calls `substituteVersion`
+ * with a real version first (see `transforms/_shared.mjs`).
+ *
+ * @param {string} content
+ * @returns {string}
+ */
+export function sanitizeAptVersionForYamlParse(content: string): string;
+/**
+ * Parse a file's version header. Looks in:
+ *   1. Markdown YAML frontmatter (`apt-skill-version: x.y.z`).
+ *   2. JS/MJS topmost line (`// apt-hook-version: x.y.z`).
+ *   3. SH topmost non-shebang line (`# apt-hook-version: x.y.z`).
+ *
+ * Returns null when no header is found.
+ *
+ * @param {string} content
+ * @returns {string|null}
+ */
+export function parseVersionHeader(content: string): string | null;
+/**
+ * Inject `apt-skill-version: <version>` into a markdown file's frontmatter
+ * if absent. Idempotent. Used by canonical-file injector and by transforms
+ * that need to materialize the header on the fly.
+ *
+ * Insertion point: after `description:` (incl. continuation lines), else
+ * after `name:`, else as the first key.
+ *
+ * @param {string} content
+ * @param {string} version
+ * @returns {string}
+ */
+export function injectMarkdownHeader(content: string, version: string): string;
+/**
+ * Strip `apt-skill-version` / `apt-hook-version` lines entirely. Used by
+ * tests that need to assert "missing_header" reasons without manually
+ * editing files.
+ *
+ * @param {string} content
+ * @returns {string}
+ */
+export function stripVersionHeader(content: string): string;
+/**
+ * Stable placeholder swapped in for the canonical `{{APT_VERSION}}` token
+ * before any code path parses canonical frontmatter with a YAML library.
+ *
+ * `{{APT_VERSION}}` is valid Mustache but invalid YAML: the outer `{...}`
+ * is read as a flow-map and the inner `{APT_VERSION}` as a flow-map used as
+ * a key, which triggers yaml@2's "Keys with collection values will be
+ * stringified due to JS Object restrictions" warning (one per parse).
+ * Silencing via `logLevel: 'silent'` would hide genuine YAML issues, so
+ * instead we pre-substitute with a syntactically harmless semver-shaped
+ * string before parse. Install-time transforms still replace
+ * `{{APT_VERSION}}` with the real framework version — see
+ * `transforms/_shared.mjs#substituteVersion` — so installed files are
+ * unchanged by this helper.
+ */
+export const APT_VERSION_PARSE_PLACEHOLDER: "0.0.0-apt-placeholder";
+//# sourceMappingURL=version-header.d.mts.map

package/dist/cli/install/version-header.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-header.d.mts","sourceRoot":"","sources":["../../../src/cli/install/version-header.mjs"],"names":[],"mappings":"AAyBA;;;;;GAKG;AACH,4BAHW,MAAM,GAAC,MAAM,GACX,MAAM,CAIlB;AAED;;;;;;;GAOG;AACH,+CAJW,MAAM,aACN,MAAM,GACJ,MAAM,CAYlB;AAED;;;;;;;;;;;;;;GAcG;AACH,+CAPW,MAAM,eACN,MAAM,SACN;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,GAGxB,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAAC,CA0CjD;AAwBD;;;;;;;;;;;;;GAaG;AACH,wDAHW,MAAM,GACJ,MAAM,CAKlB;AAED;;;;;;;;;;GAUG;AACH,4CAHW,MAAM,GACJ,MAAM,GAAC,IAAI,CAqBvB;AAED;;;;;;;;;;;GAWG;AACH,8CAJW,MAAM,WACN,MAAM,GACJ,MAAM,CA4ClB;AAED;;;;;;;GAOG;AACH,4CAHW,MAAM,GACJ,MAAM,CAOlB;AAzID;;;;;;;;;;;;;;GAcG;AACH,4CAA6C,uBAAuB,CAAA"}