@backendkit-labs/agent-core 0.14.0

package/dist/shared/utils/atomic-write.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @description Escritura atomica de archivos: escribe a .tmp y luego rename.
+ * Garantiza que un crash durante la escritura no deja el archivo corrupto.
+ */
+export declare function atomicWriteSync(filePath: string, content: string): void;
+export declare function atomicWrite(filePath: string, content: string): Promise<void>;
+//# sourceMappingURL=atomic-write.d.ts.map

package/dist/shared/utils/atomic-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/atomic-write.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAcvE;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAclF"}

package/dist/shared/utils/atomic-write.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * @description Escritura atomica de archivos: escribe a .tmp y luego rename.
+ * Garantiza que un crash durante la escritura no deja el archivo corrupto.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.atomicWriteSync = atomicWriteSync;
+exports.atomicWrite = atomicWrite;
+const fs_1 = require("fs");
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+function atomicWriteSync(filePath, content) {
+    const tmp = `${filePath}.tmp`;
+    (0, fs_1.writeFileSync)(tmp, content, 'utf-8');
+    try {
+        (0, fs_1.renameSync)(tmp, filePath);
+    }
+    catch (e) {
+        if (e.code === 'EPERM') {
+            (0, fs_1.mkdirSync)((0, path_1.dirname)(filePath), { recursive: true });
+            (0, fs_1.copyFileSync)(tmp, filePath);
+            try {
+                (0, fs_1.unlinkSync)(tmp);
+            }
+            catch { /* ignorar */ }
+        }
+        else {
+            throw e;
+        }
+    }
+}
+async function atomicWrite(filePath, content) {
+    const tmp = `${filePath}.tmp`;
+    await (0, promises_1.writeFile)(tmp, content, 'utf-8');
+    try {
+        await (0, promises_1.rename)(tmp, filePath);
+    }
+    catch (e) {
+        if (e.code === 'EPERM') {
+            await (0, promises_1.mkdir)((0, path_1.dirname)(filePath), { recursive: true });
+            await (0, promises_1.copyFile)(tmp, filePath);
+            try {
+                await (0, promises_1.unlink)(tmp);
+            }
+            catch { /* ignorar */ }
+        }
+        else {
+            throw e;
+        }
+    }
+}
+//# sourceMappingURL=atomic-write.js.map

package/dist/shared/utils/atomic-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../../../src/shared/utils/atomic-write.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAMH,0CAcC;AAED,kCAcC;AAlCD,2BAAoF;AACpF,0CAAyE;AACzE,+BAA+B;AAE/B,SAAgB,eAAe,CAAC,QAAgB,EAAE,OAAe;IAC/D,MAAM,GAAG,GAAG,GAAG,QAAQ,MAAM,CAAC;IAC9B,IAAA,kBAAa,EAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACrC,IAAI,CAAC;QACH,IAAA,eAAU,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAA2B,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAClD,IAAA,cAAS,EAAC,IAAA,cAAO,EAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,IAAA,iBAAY,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YAC5B,IAAI,CAAC;gBAAC,IAAA,eAAU,EAAC,GAAG,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,OAAe;IACjE,MAAM,GAAG,GAAG,GAAG,QAAQ,MAAM,CAAC;IAC9B,MAAM,IAAA,oBAAS,EAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,IAAA,iBAAM,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAK,CAA2B,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAClD,MAAM,IAAA,gBAAK,EAAC,IAAA,cAAO,EAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,MAAM,IAAA,mBAAQ,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YAC9B,IAAI,CAAC;gBAAC,MAAM,IAAA,iBAAM,EAAC,GAAG,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/shared/utils/git.d.ts

@@ -0,0 +1,2 @@
+export declare function getGitDiff(): string;
+//# sourceMappingURL=git.d.ts.map

package/dist/shared/utils/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/git.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,IAAI,MAAM,CAUnC"}

package/dist/shared/utils/git.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGitDiff = getGitDiff;
+const child_process_1 = require("child_process");
+function getGitDiff() {
+    try {
+        return (0, child_process_1.execSync)('git diff --cached', {
+            cwd: process.cwd(),
+            timeout: 10_000,
+            stdio: 'pipe',
+        }).toString();
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/shared/utils/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../../src/shared/utils/git.ts"],"names":[],"mappings":";;AAEA,gCAUC;AAZD,iDAAyC;AAEzC,SAAgB,UAAU;IACtB,IAAI,CAAC;QACD,OAAO,IAAA,wBAAQ,EAAC,mBAAmB,EAAE;YACjC,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;YAClB,OAAO,EAAE,MAAM;YACf,KAAK,EAAE,MAAM;SAChB,CAAC,CAAC,QAAQ,EAAE,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,EAAE,CAAC;IACd,CAAC;AACL,CAAC"}

package/dist/shared/utils/project-key.d.ts

@@ -0,0 +1,4 @@
+export declare function cwdToProjectKey(cwd: string): string;
+export declare function getFrameworkDir(appName: string): string;
+export declare function getProjectDir(appName: string, cwd?: string): string;
+//# sourceMappingURL=project-key.d.ts.map

package/dist/shared/utils/project-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-key.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/project-key.ts"],"names":[],"mappings":"AAGA,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,CAElF"}

package/dist/shared/utils/project-key.js

@@ -0,0 +1,54 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cwdToProjectKey = cwdToProjectKey;
+exports.getFrameworkDir = getFrameworkDir;
+exports.getProjectDir = getProjectDir;
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+function cwdToProjectKey(cwd) {
+    return cwd
+        .replace(/[/\\]$/, '')
+        .replace(/:[/\\]/g, '--')
+        .replace(/[^a-zA-Z0-9-]/g, '-');
+}
+function getFrameworkDir(appName) {
+    const home = process.env.USERPROFILE ?? process.env.HOME ?? os.homedir();
+    return path.join(home, `.${appName}`);
+}
+function getProjectDir(appName, cwd = process.cwd()) {
+    return path.join(getFrameworkDir(appName), 'projects', cwdToProjectKey(cwd));
+}
+//# sourceMappingURL=project-key.js.map

package/dist/shared/utils/project-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-key.js","sourceRoot":"","sources":["../../../src/shared/utils/project-key.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAGA,0CAKC;AAED,0CAGC;AAED,sCAEC;AAjBD,uCAAyB;AACzB,2CAA6B;AAE7B,SAAgB,eAAe,CAAC,GAAW;IACvC,OAAO,GAAG;SACL,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC;SACxB,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,SAAgB,eAAe,CAAC,OAAe;IAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IACzE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,OAAO,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,SAAgB,aAAa,CAAC,OAAe,EAAE,MAAc,OAAO,CAAC,GAAG,EAAE;IACtE,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;AACjF,CAAC"}

package/dist/shared/utils/string-utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Sanitiza un string para usarlo como nombre de archivo (multiplataforma).
+ *
+ * - Convierte a minúsculas
+ * - Reemplaza espacios por guiones
+ * - Elimina caracteres inválidos en Windows: < > : " / \ | ? *
+ * - Normaliza caracteres acentuados a su versión sin tilde (ó → o, í → i, etc.)
+ * - Preserva puntos para versiones (ej: "2.1") pero limpia adyacentes a guiones
+ * - Colapsa guiones múltiples en uno solo
+ * - Recorta guiones al inicio y final
+ * - Si el resultado está vacío, retorna "untitled"
+ *
+ * @param input - String a sanitizar
+ * @returns Nombre de archivo seguro
+ */
+export declare function sanitizeFilename(input: string): string;
+//# sourceMappingURL=string-utils.d.ts.map

package/dist/shared/utils/string-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../../src/shared/utils/string-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBtD"}

package/dist/shared/utils/string-utils.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeFilename = sanitizeFilename;
+/**
+ * Sanitiza un string para usarlo como nombre de archivo (multiplataforma).
+ *
+ * - Convierte a minúsculas
+ * - Reemplaza espacios por guiones
+ * - Elimina caracteres inválidos en Windows: < > : " / \ | ? *
+ * - Normaliza caracteres acentuados a su versión sin tilde (ó → o, í → i, etc.)
+ * - Preserva puntos para versiones (ej: "2.1") pero limpia adyacentes a guiones
+ * - Colapsa guiones múltiples en uno solo
+ * - Recorta guiones al inicio y final
+ * - Si el resultado está vacío, retorna "untitled"
+ *
+ * @param input - String a sanitizar
+ * @returns Nombre de archivo seguro
+ */
+function sanitizeFilename(input) {
+    if (!input || input.trim().length === 0)
+        return 'untitled';
+    // Normalización Unicode: descompone caracteres acentuados (NFD)
+    // y elimina los diacríticos (tildes, diéresis, etc.)
+    // Luego aplica las reglas de sanitización estándar
+    const sanitized = input
+        .toLowerCase()
+        .trim()
+        .normalize('NFD')
+        .replace(/[\u0300-\u036f]/g, '') // Elimina acentos: ó→o, í→i, é→e, etc.
+        .replace(/\s+/g, '-') // Espacios → guiones
+        .replace(/[<>:"/\\|?*,;!¡¿?@#$%^&()+=[\]{}~`]/g, '') // Caracteres especiales inválidos (preserva puntos)
+        .replace(/\.(?=-)|(?<=-)\./g, '') // Limpia puntos adyacentes a guiones: "3.-probar" → "3-probar"
+        .replace(/-+/g, '-') // Colapsa guiones múltiples
+        .replace(/^-+|-+$/g, ''); // Recorta guiones al inicio/final
+    return sanitized.length > 0 ? sanitized : 'untitled';
+}
+//# sourceMappingURL=string-utils.js.map

package/dist/shared/utils/string-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.js","sourceRoot":"","sources":["../../../src/shared/utils/string-utils.ts"],"names":[],"mappings":";;AAeA,4CAkBC;AAjCD;;;;;;;;;;;;;;GAcG;AACH,SAAgB,gBAAgB,CAAC,KAAa;IAC5C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IAE3D,gEAAgE;IAChE,qDAAqD;IACrD,mDAAmD;IACnD,MAAM,SAAS,GAAG,KAAK;SACpB,WAAW,EAAE;SACb,IAAI,EAAE;SACN,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAS,uCAAuC;SAC/E,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAqB,qBAAqB;SAC9D,OAAO,CAAC,sCAAsC,EAAE,EAAE,CAAC,CAAE,oDAAoD;SACzG,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAS,+DAA+D;SACxG,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAsB,4BAA4B;SACrE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAiB,kCAAkC;IAE9E,OAAO,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;AACvD,CAAC"}

package/dist/skills/activator.d.ts

@@ -0,0 +1,27 @@
+import type { Skill } from './types';
+export declare class SkillActivator {
+    /**
+     * Returns the subset of skills whose triggers match the user input.
+     * Language-agnostic skills (no `language` field) always pass the stack filter.
+     * Pack skills are included only if their language matches the detected stack.
+     */
+    activate(input: string, skills: Skill[], detectedStack?: string[]): Skill[];
+    /**
+     * Returns all skills that should always be active for a given agent,
+     * regardless of user input (skills with `agents` field containing the agentId).
+     */
+    getAgentSkills(agentId: string, skills: Skill[], detectedStack?: string[]): Skill[];
+    /** Detects project stack by checking for indicator files in cwd */
+    detectStack(cwd: string): Promise<string[]>;
+    /**
+     * Builds the combined systemPromptAddition for a set of active skills.
+     *
+     * Deduplicates by skill name. On a name collision the LAST occurrence wins,
+     * so that higher-priority scopes override lower ones — matching the documented
+     * precedence (project > pack > global > builtin), since callers merge skills
+     * in that ascending order. Output position follows first appearance to keep
+     * the prompt order stable.
+     */
+    buildSystemPromptAddition(activeSkills: Skill[]): string;
+}
+//# sourceMappingURL=activator.d.ts.map

package/dist/skills/activator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activator.d.ts","sourceRoot":"","sources":["../../src/skills/activator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAiBrC,qBAAa,cAAc;IACvB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,aAAa,GAAE,MAAM,EAAO,GAAG,KAAK,EAAE;IAiB/E;;;OAGG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,aAAa,GAAE,MAAM,EAAO,GAAG,KAAK,EAAE;IAUvF,mEAAmE;IAC7D,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAajD;;;;;;;;OAQG;IACH,yBAAyB,CAAC,YAAY,EAAE,KAAK,EAAE,GAAG,MAAM;CAiB3D"}

package/dist/skills/activator.js

@@ -0,0 +1,127 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SkillActivator = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const result_1 = require("@backendkit-labs/result");
+/** Detectable stacks mapped to their indicator files */
+const STACK_INDICATORS = [
+    { file: 'package.json', stack: 'node' },
+    { file: 'tsconfig.json', stack: 'typescript' },
+    { file: 'requirements.txt', stack: 'python' },
+    { file: 'pyproject.toml', stack: 'python' },
+    { file: 'pom.xml', stack: 'java' },
+    { file: 'build.gradle', stack: 'java' },
+    { file: 'Cargo.toml', stack: 'rust' },
+    { file: 'go.mod', stack: 'go' },
+    { file: 'composer.json', stack: 'php' },
+    { file: 'Gemfile', stack: 'ruby' },
+    { file: 'mix.exs', stack: 'elixir' },
+];
+class SkillActivator {
+    /**
+     * Returns the subset of skills whose triggers match the user input.
+     * Language-agnostic skills (no `language` field) always pass the stack filter.
+     * Pack skills are included only if their language matches the detected stack.
+     */
+    activate(input, skills, detectedStack = []) {
+        const lower = input.toLowerCase();
+        return skills.filter(skill => {
+            // Stack gate — skip pack skills that don't match the project stack
+            if (skill.language && skill.language.length > 0) {
+                const matches = skill.language.some(lang => detectedStack.includes(lang.toLowerCase()));
+                if (!matches)
+                    return false;
+            }
+            // Trigger match
+            return Array.isArray(skill.triggers) && skill.triggers.some(trigger => lower.includes(trigger.toLowerCase()));
+        });
+    }
+    /**
+     * Returns all skills that should always be active for a given agent,
+     * regardless of user input (skills with `agents` field containing the agentId).
+     */
+    getAgentSkills(agentId, skills, detectedStack = []) {
+        return skills.filter(skill => {
+            if (!skill.agents?.includes(agentId))
+                return false;
+            if (skill.language && skill.language.length > 0) {
+                return skill.language.some(lang => detectedStack.includes(lang.toLowerCase()));
+            }
+            return true;
+        });
+    }
+    /** Detects project stack by checking for indicator files in cwd */
+    async detectStack(cwd) {
+        const stacks = [];
+        await Promise.all(STACK_INDICATORS.map(async ({ file, stack }) => {
+            const result = await (0, result_1.run)(() => fs.access(path.join(cwd, file)));
+            if ((0, result_1.isOk)(result) && !stacks.includes(stack)) {
+                stacks.push(stack);
+            }
+        }));
+        return stacks;
+    }
+    /**
+     * Builds the combined systemPromptAddition for a set of active skills.
+     *
+     * Deduplicates by skill name. On a name collision the LAST occurrence wins,
+     * so that higher-priority scopes override lower ones — matching the documented
+     * precedence (project > pack > global > builtin), since callers merge skills
+     * in that ascending order. Output position follows first appearance to keep
+     * the prompt order stable.
+     */
+    buildSystemPromptAddition(activeSkills) {
+        // Last write wins: a project skill overrides a global/builtin with the same name.
+        const contentByName = new Map();
+        for (const skill of activeSkills) {
+            if (!skill.systemPromptAddition)
+                continue;
+            contentByName.set(skill.name, skill.systemPromptAddition.trim());
+        }
+        const seen = new Set();
+        const parts = [];
+        for (const skill of activeSkills) {
+            if (seen.has(skill.name) || !contentByName.has(skill.name))
+                continue;
+            seen.add(skill.name);
+            parts.push(contentByName.get(skill.name));
+        }
+        return parts.join('\n\n');
+    }
+}
+exports.SkillActivator = SkillActivator;
+//# sourceMappingURL=activator.js.map

package/dist/skills/activator.js.map

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

package/dist/skills/builtins/global.d.ts

@@ -0,0 +1,7 @@
+import type { Skill } from '../types';
+/**
+ * Language-agnostic skills built into the framework.
+ * These are always available regardless of project stack.
+ */
+export declare const GLOBAL_BUILTIN_SKILLS: Skill[];
+//# sourceMappingURL=global.d.ts.map

package/dist/skills/builtins/global.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.d.ts","sourceRoot":"","sources":["../../../src/skills/builtins/global.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAAK,EAuMxC,CAAC"}

package/dist/skills/builtins/global.js

@@ -0,0 +1,208 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GLOBAL_BUILTIN_SKILLS = void 0;
+/**
+ * Language-agnostic skills built into the framework.
+ * These are always available regardless of project stack.
+ */
+exports.GLOBAL_BUILTIN_SKILLS = [
+    {
+        name: 'conventional-commits',
+        version: '1.0.0',
+        description: 'Conventional Commits specification for any language or stack',
+        scope: 'global',
+        triggers: [
+            'commit', 'conventional commit', 'commit message', 'mensaje de commit',
+            'changelog', 'semantic versioning', 'semver', 'release notes',
+        ],
+        systemPromptAddition: `## Conventional Commits
+
+Formato obligatorio para todos los commits:
+\`<type>(<scope>): <description>\`
+
+### Tipos
+| Tipo | Cuando usarlo |
+|---|---|
+| feat | Nueva funcionalidad |
+| fix | Correccion de bug |
+| refactor | Refactor sin cambio de comportamiento |
+| test | Tests nuevos o modificados |
+| docs | Solo documentacion |
+| chore | Mantenimiento, dependencias, config |
+| perf | Mejora de rendimiento |
+| ci | Cambios en CI/CD |
+
+### Reglas
+- Descripcion en imperativo: "add", "fix", "update" — no "added", "fixed"
+- Sin punto al final
+- Breaking change: agrega "!" antes de ":" o pie de pagina "BREAKING CHANGE:"
+- Scope opcional: nombre del modulo o dominio afectado`,
+    },
+    {
+        name: 'code-review',
+        version: '1.0.0',
+        description: 'Code review checklist and best practices for any language',
+        scope: 'global',
+        triggers: [
+            'code review', 'revisar codigo', 'revisión de codigo', 'pull request',
+            'pr review', 'review checklist', 'revisión', 'code quality',
+        ],
+        systemPromptAddition: `## Code Review
+
+Al revisar codigo, evalua en este orden:
+
+### 1. Correctitud
+- El codigo hace lo que dice que hace?
+- Maneja edge cases y errores?
+- Hay race conditions o problemas de concurrencia?
+
+### 2. Legibilidad
+- Los nombres son descriptivos y consistentes?
+- La logica es facil de seguir sin comentarios?
+- Las funciones hacen una sola cosa?
+
+### 3. Mantenibilidad
+- Hay duplicacion que deberia extraerse?
+- Las abstracciones son las correctas (ni muy pocas ni demasiadas)?
+- Los tests cubren el comportamiento, no la implementacion?
+
+### 4. Seguridad
+- Hay inputs del usuario sin validar?
+- Se expone informacion sensible en logs o errores?
+- Las dependencias tienen vulnerabilidades conocidas?
+
+### 5. Rendimiento
+- Hay N+1 queries o loops innecesarios?
+- Se cachea lo que deberia cachearse?
+- El impacto en memoria y CPU es razonable?
+
+Formato de feedback: especifica archivo, linea y razon. Separa bloqueantes de sugerencias.`,
+    },
+    {
+        name: 'tdd',
+        version: '1.0.0',
+        description: 'Test-Driven Development discipline for any language',
+        scope: 'global',
+        triggers: [
+            'tdd', 'test driven', 'test-driven development', 'red green refactor',
+            'escribir tests primero', 'tests antes', 'coverage', 'cobertura',
+        ],
+        systemPromptAddition: `## Test-Driven Development
+
+### Ciclo obligatorio: Red → Green → Refactor
+1. **Red** — escribe el test que falla primero. El test define el comportamiento esperado.
+2. **Green** — escribe el minimo codigo para que el test pase. No sobredisenes.
+3. **Refactor** — mejora el codigo sin cambiar el comportamiento. Los tests deben seguir pasando.
+
+### Que testear
+- Comportamiento observable, no implementacion interna
+- Edge cases: nulo, vacio, maximo, minimo
+- Casos de error: que pasa cuando algo falla
+
+### Que NO testear
+- Detalles de implementacion que pueden cambiar
+- Librerias de terceros (confiar en sus propios tests)
+- Codigo trivial sin logica de negocio
+
+### Estructura de un buen test (AAA)
+\`\`\`
+// Arrange — preparar el estado inicial
+// Act     — ejecutar la accion bajo prueba
+// Assert  — verificar el resultado esperado
+\`\`\`
+
+### Reglas
+- Un test = una assertion logica (puede tener varias lineas de expect)
+- Nombre del test: describe QUE hace, no COMO lo hace
+- Tests deben ser deterministicos: mismo input = mismo output siempre`,
+    },
+    {
+        name: 'adr',
+        version: '1.0.0',
+        description: 'Architecture Decision Records — document significant design choices',
+        scope: 'global',
+        triggers: [
+            'adr', 'architecture decision', 'decision de arquitectura', 'architectural record',
+            'decision record', 'doc arquitectura', 'documentar decision',
+        ],
+        systemPromptAddition: `## Architecture Decision Records (ADR)
+
+Usa este formato para documentar decisiones de arquitectura significativas.
+
+### Cuando crear un ADR
+- Cambias una tecnologia o framework
+- Adoptas un patron arquitectonico
+- Rechazas una alternativa que alguien podria proponer en el futuro
+- La decision tiene consecuencias a largo plazo o es dificil de revertir
+
+### Formato
+\`\`\`markdown
+# ADR-{numero}: {titulo breve}
+
+**Fecha:** YYYY-MM-DD
+**Estado:** Propuesto | Aceptado | Rechazado | Deprecado | Supersedido por ADR-{n}
+
+## Contexto
+Por que necesitamos tomar esta decision? Cual es el problema o necesidad?
+
+## Decision
+Que decidimos hacer?
+
+## Consecuencias
+### Positivas
+- ...
+
+### Negativas / Trade-offs
+- ...
+
+## Alternativas consideradas
+- **{Alternativa A}** — por que fue descartada
+- **{Alternativa B}** — por que fue descartada
+\`\`\`
+
+Guarda los ADRs en \`docs/adr/\` o \`architecture/decisions/\`.`,
+    },
+    {
+        name: 'security-checklist',
+        version: '1.0.0',
+        description: 'OWASP-based security checklist for any stack',
+        scope: 'global',
+        triggers: [
+            'seguridad', 'security', 'owasp', 'vulnerabilidad', 'vulnerability',
+            'pentest', 'auditoria de seguridad', 'security audit', 'hardening',
+            'sql injection', 'xss', 'csrf', 'autenticacion', 'autorizacion',
+        ],
+        systemPromptAddition: `## Security Checklist (OWASP Top 10)
+
+Al revisar o implementar codigo, verifica:
+
+### Inputs y validacion
+- Todo input del usuario se valida y sanitiza antes de usarse
+- Nunca se construyen queries con concatenacion de strings (usar parametrized queries)
+- Los archivos subidos se validan en tipo, tamanio y contenido
+
+### Autenticacion y sesiones
+- Passwords hasheados con bcrypt/argon2/scrypt (nunca MD5/SHA1)
+- Tokens JWT validados en firma, expiracion y claims
+- Sesiones invalidadas al logout
+
+### Autorizacion
+- Cada endpoint verifica permisos, no solo autenticacion
+- IDOR: no se puede acceder a recursos de otro usuario cambiando el ID
+
+### Datos sensibles
+- Secretos en variables de entorno, nunca en codigo o logs
+- HTTPS obligatorio en produccion
+- Datos sensibles no se logean (tokens, passwords, PII)
+
+### Headers y configuracion
+- CORS configurado restrictivamente (no "*" en produccion)
+- CSP, X-Frame-Options, HSTS configurados
+- Dependencias sin vulnerabilidades conocidas (npm audit, pip audit)
+
+### Errores
+- Mensajes de error genericos al cliente (no exponer stack traces)
+- Errores detallados solo en logs internos`,
+    },
+];
+//# sourceMappingURL=global.js.map

package/dist/skills/builtins/global.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.js","sourceRoot":"","sources":["../../../src/skills/builtins/global.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACU,QAAA,qBAAqB,GAAY;IAC1C;QACI,IAAI,EAAE,sBAAsB;QAC5B,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,8DAA8D;QAC3E,KAAK,EAAE,QAAQ;QACf,QAAQ,EAAE;YACN,QAAQ,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,mBAAmB;YACtE,WAAW,EAAE,qBAAqB,EAAE,QAAQ,EAAE,eAAe;SAChE;QACD,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;uDAqByB;KAClD;IACD;QACI,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,2DAA2D;QACxE,KAAK,EAAE,QAAQ;QACf,QAAQ,EAAE;YACN,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,cAAc;YACrE,WAAW,EAAE,kBAAkB,EAAE,UAAU,EAAE,cAAc;SAC9D;QACD,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2FA6B6D;KACtF;IACD;QACI,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,qDAAqD;QAClE,KAAK,EAAE,QAAQ;QACf,QAAQ,EAAE;YACN,KAAK,EAAE,aAAa,EAAE,yBAAyB,EAAE,oBAAoB;YACrE,wBAAwB,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW;SACnE;QACD,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;sEA2BwC;KACjE;IACD;QACI,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,qEAAqE;QAClF,KAAK,EAAE,QAAQ;QACf,QAAQ,EAAE;YACN,KAAK,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,sBAAsB;YAClF,iBAAiB,EAAE,kBAAkB,EAAE,qBAAqB;SAC/D;QACD,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gEAmCkC;KAC3D;IACD;QACI,IAAI,EAAE,oBAAoB;QAC1B,OAAO,EAAE,OAAO;QAChB,WAAW,EAAE,8CAA8C;QAC3D,KAAK,EAAE,QAAQ;QACf,QAAQ,EAAE;YACN,WAAW,EAAE,UAAU,EAAE,OAAO,EAAE,gBAAgB,EAAE,eAAe;YACnE,SAAS,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,WAAW;YAClE,eAAe,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc;SAClE;QACD,oBAAoB,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2CA8Ba;KACtC;CACJ,CAAC"}

package/dist/skills/builtins/go-pack.d.ts

@@ -0,0 +1,7 @@
+import type { Skill } from '../types';
+/**
+ * Go skill pack (@bk-go).
+ * Activated for projects with go.mod.
+ */
+export declare const GO_PACK_SKILLS: Skill[];
+//# sourceMappingURL=go-pack.d.ts.map

package/dist/skills/builtins/go-pack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"go-pack.d.ts","sourceRoot":"","sources":["../../../src/skills/builtins/go-pack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,EA8PjC,CAAC"}