loadouts 0.2.1 → 0.2.2

package/dist/core/config.d.ts

@@ -1,8 +1,24 @@
 /**
  * Parse source configs and loadout definitions
  */
-import { type RuleFrontmatter } from "./schema.js";
+import { type RuleFrontmatter, type CanonicalRuleFrontmatter, type SkillFrontmatter, type Frontmatter } from "./schema.js";
 import type { RootConfig, LoadoutDefinition, LoadoutRoot } from "./types.js";
+export interface FrontmatterSanitizationResult<T extends Frontmatter> {
+    frontmatter: T;
+    changes: string[];
+}
+export interface FileSanitizationResult {
+    modified: boolean;
+    changes: string[];
+}
+export type RawFrontmatter = Record<string, unknown>;
+/**
+ * Parse markdown frontmatter without schema validation.
+ */
+export declare function parseMarkdownFrontmatter(content: string): {
+    frontmatter: RawFrontmatter;
+    body: string;
+};
 /**
  * Parse the root config from a .loadouts/ directory.
  * Returns default config if file doesn't exist.
@@ -28,37 +44,81 @@ export declare function findLoadoutDefinition(name: string, roots: LoadoutRoot[]
  * Returns the frontmatter object and the body content.
  */
 export declare function parseFrontmatter(content: string): {
-    frontmatter: RuleFrontmatter;
+    frontmatter: Frontmatter;
+    body: string;
+};
+/**
+ * Parse skill frontmatter from a SKILL.md file.
+ */
+export declare function parseSkillFrontmatter(content: string): {
+    frontmatter: SkillFrontmatter;
     body: string;
 };
+/**
+ * Serialize markdown frontmatter without schema constraints.
+ */
+export declare function serializeMarkdownFrontmatter(frontmatter: RawFrontmatter, body: string): string;
 /**
  * Serialize frontmatter and body back to markdown.
  */
-export declare function serializeFrontmatter(frontmatter: RuleFrontmatter, body: string): string;
+export declare function serializeFrontmatter(frontmatter: Frontmatter, body: string): string;
+/**
+ * Sanitize rule frontmatter for canonical v1 portability.
+ */
+export declare function sanitizeRuleFrontmatter(frontmatter: RuleFrontmatter, ruleName?: string): CanonicalRuleFrontmatter;
 /**
- * Sanitize rule frontmatter for maximum cross-tool compatibility.
- *
- * Required fields for portability:
- * - `description` - Cursor "Apply Intelligently" routing
- * - `paths` - Claude Code file scoping
- * - `globs` - Cursor/OpenCode file scoping
- *
- * If paths/globs are set, ensures both are present and equal.
- * If description is missing and we have a rule name, generates one.
+ * Sanitize rule frontmatter and return a concise change summary.
  */
-export declare function sanitizeRuleFrontmatter(frontmatter: RuleFrontmatter, ruleName?: string): RuleFrontmatter;
+export declare function sanitizeRuleFrontmatterWithSummary(frontmatter: RuleFrontmatter, ruleName?: string): FrontmatterSanitizationResult<CanonicalRuleFrontmatter>;
 /**
  * Check if a rule file needs sanitization.
  * Returns true if the file would be modified by sanitization.
  */
 export declare function ruleNeedsSanitization(filePath: string): boolean;
+/**
+ * Return a concise list of rule-frontmatter sanitization changes.
+ */
+export declare function ruleSanitizationChanges(filePath: string): string[];
 /**
  * Sanitize a rule file in place.
  * Returns true if the file was modified.
  */
 export declare function sanitizeRuleFile(filePath: string): boolean;
+/**
+ * Sanitize a rule file in place and return change details.
+ */
+export declare function sanitizeRuleFileWithSummary(filePath: string): FileSanitizationResult;
 /**
  * Find all rules that need sanitization in a loadout root.
  */
 export declare function findUnsanitizedRules(loadoutRoot: string): string[];
+/**
+ * Sanitize skill frontmatter for canonical v1 portability.
+ */
+export declare function sanitizeSkillFrontmatter(frontmatter: SkillFrontmatter, skillName?: string): SkillFrontmatter;
+/**
+ * Sanitize skill frontmatter and return a concise change summary.
+ */
+export declare function sanitizeSkillFrontmatterWithSummary(frontmatter: SkillFrontmatter, skillName?: string): FrontmatterSanitizationResult<SkillFrontmatter>;
+/**
+ * Check if a skill file needs sanitization.
+ */
+export declare function skillNeedsSanitization(filePath: string): boolean;
+/**
+ * Return a concise list of skill-frontmatter sanitization changes.
+ */
+export declare function skillSanitizationChanges(filePath: string): string[];
+/**
+ * Sanitize a skill file in place.
+ * Returns true if the file was modified.
+ */
+export declare function sanitizeSkillFile(filePath: string): boolean;
+/**
+ * Sanitize a skill file in place and return change details.
+ */
+export declare function sanitizeSkillFileWithSummary(filePath: string): FileSanitizationResult;
+/**
+ * Find all skills that need sanitization in a loadout root.
+ */
+export declare function findUnsanitizedSkills(loadoutRoot: string): string[];
 //# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,UAAU,EACV,iBAAiB,EACjB,WAAW,EACZ,MAAM,YAAY,CAAC;AAKpB;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,CAU/D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAI1E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAU1D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,WAAW,EAAE,GACnB;IAAE,UAAU,EAAE,iBAAiB,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAoB5D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IACjD,WAAW,EAAE,eAAe,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd,CAYA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,eAAe,EAC5B,IAAI,EAAE,MAAM,GACX,MAAM,CAOR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,eAAe,EAC5B,QAAQ,CAAC,EAAE,MAAM,GAChB,eAAe,CAoBjB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAO/D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAkB1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAalE"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"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"}

package/dist/core/config.js

@@ -4,9 +4,38 @@
 import * as path from "node:path";
 import * as yaml from "yaml";
 import { readFile, writeFile, fileExists, isDirectory, listFiles } from "../lib/fs.js";
-import { RootConfigSchema, LoadoutDefinitionSchema, RuleFrontmatterSchema, } from "./schema.js";
+import { RootConfigSchema, LoadoutDefinitionSchema, FrontmatterSchema, SkillFrontmatterSchema, CanonicalRuleFrontmatterSchema, } from "./schema.js";
 const ROOT_CONFIG_FILE = "loadouts.yaml";
 const LOADOUTS_DIR = "loadouts";
+const RULES_DIR = "rules";
+const SKILLS_DIR = "skills";
+/**
+ * Parse markdown frontmatter without schema validation.
+ */
+export function parseMarkdownFrontmatter(content) {
+    const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!match) {
+        return { frontmatter: {}, body: content };
+    }
+    const [, frontmatterStr, body] = match;
+    const parsed = yaml.parse(frontmatterStr);
+    const frontmatter = parsed && typeof parsed === "object" && !Array.isArray(parsed)
+        ? parsed
+        : {};
+    return { frontmatter, body };
+}
+function stableStringify(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map((v) => stableStringify(v)).join(",")}]`;
+    }
+    if (value && typeof value === "object") {
+        const entries = Object.entries(value).sort(([a], [b]) => a.localeCompare(b));
+        return `{${entries
+            .map(([k, v]) => `${JSON.stringify(k)}:${stableStringify(v)}`)
+            .join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
 /**
  * Parse the root config from a .loadouts/ directory.
  * Returns default config if file doesn't exist.
@@ -66,19 +95,22 @@ export function findLoadoutDefinition(name, roots) {
  * Returns the frontmatter object and the body content.
  */
 export function parseFrontmatter(content) {
-    const match = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
-    if (!match) {
-        return { frontmatter: {}, body: content };
-    }
-    const [, frontmatterStr, body] = match;
-    const parsed = yaml.parse(frontmatterStr) || {};
-    const frontmatter = RuleFrontmatterSchema.parse(parsed);
+    const { frontmatter: parsed, body } = parseMarkdownFrontmatter(content);
+    const frontmatter = FrontmatterSchema.parse(parsed);
     return { frontmatter, body };
 }
 /**
- * Serialize frontmatter and body back to markdown.
+ * Parse skill frontmatter from a SKILL.md file.
  */
-export function serializeFrontmatter(frontmatter, body) {
+export function parseSkillFrontmatter(content) {
+    const { frontmatter: parsed, body } = parseMarkdownFrontmatter(content);
+    const frontmatter = SkillFrontmatterSchema.parse(parsed);
+    return { frontmatter, body };
+}
+/**
+ * Serialize markdown frontmatter without schema constraints.
+ */
+export function serializeMarkdownFrontmatter(frontmatter, body) {
     if (Object.keys(frontmatter).length === 0) {
         return body;
     }
@@ -86,70 +118,120 @@ export function serializeFrontmatter(frontmatter, body) {
     return `---\n${frontmatterStr}\n---\n${body}`;
 }
 /**
- * Sanitize rule frontmatter for maximum cross-tool compatibility.
- *
- * Required fields for portability:
- * - `description` - Cursor "Apply Intelligently" routing
- * - `paths` - Claude Code file scoping
- * - `globs` - Cursor/OpenCode file scoping
- *
- * If paths/globs are set, ensures both are present and equal.
- * If description is missing and we have a rule name, generates one.
+ * Serialize frontmatter and body back to markdown.
+ */
+export function serializeFrontmatter(frontmatter, body) {
+    return serializeMarkdownFrontmatter(frontmatter, body);
+}
+/**
+ * Sanitize rule frontmatter for canonical v1 portability.
  */
 export function sanitizeRuleFrontmatter(frontmatter, ruleName) {
+    return sanitizeRuleFrontmatterWithSummary(frontmatter, ruleName).frontmatter;
+}
+/**
+ * Sanitize rule frontmatter and return a concise change summary.
+ */
+export function sanitizeRuleFrontmatterWithSummary(frontmatter, ruleName) {
     const result = { ...frontmatter };
-    // Mirror paths <-> globs for Cursor/OpenCode compatibility
-    if (result.paths && !result.globs) {
-        result.globs = result.paths;
+    const changes = [];
+    const explicitAlwaysApply = result.alwaysApply;
+    const hadGlobsAlias = "globs" in result;
+    const pathsBeforeAliasHandling = result.paths;
+    const globsBeforeAliasHandling = result.globs;
+    if (Array.isArray(pathsBeforeAliasHandling)
+        && Array.isArray(globsBeforeAliasHandling)
+        && stableStringify(pathsBeforeAliasHandling) !== stableStringify(globsBeforeAliasHandling)) {
+        changes.push("~ conflicting alias ignored: globs (kept paths)");
     }
-    else if (result.globs && !result.paths) {
+    if (result.globs && !result.paths) {
         result.paths = result.globs;
+        changes.push("~ globs -> paths");
+    }
+    if (hadGlobsAlias) {
+        delete result.globs;
+        if (!changes.includes("~ globs -> paths")) {
+            changes.push("~ removed alias: globs");
+        }
+    }
+    if ("alwaysApply" in result) {
+        delete result.alwaysApply;
+        changes.push("~ alwaysApply -> activation");
+    }
+    let canonicalActivation;
+    if (typeof explicitAlwaysApply === "boolean") {
+        canonicalActivation = explicitAlwaysApply || result.paths === undefined
+            ? "always"
+            : "scoped";
+    }
+    else if (result.activation === "always" || result.activation === "scoped") {
+        canonicalActivation = result.activation;
+    }
+    else {
+        canonicalActivation = result.paths === undefined ? "always" : "scoped";
+    }
+    if (result.activation !== canonicalActivation) {
+        result.activation = canonicalActivation;
+        changes.push(`~ activation -> ${canonicalActivation}`);
     }
-    // Ensure description exists for Cursor "Apply Intelligently" mode
     if (!result.description && ruleName) {
-        // Generate a description from the rule name
         const humanName = ruleName
             .replace(/[-_]/g, " ")
             .replace(/\b\w/g, (c) => c.toUpperCase());
         result.description = `${humanName} guidelines`;
+        changes.push("~ added description");
     }
-    return result;
+    return {
+        frontmatter: CanonicalRuleFrontmatterSchema.parse(result),
+        changes,
+    };
 }
 /**
  * Check if a rule file needs sanitization.
  * Returns true if the file would be modified by sanitization.
  */
 export function ruleNeedsSanitization(filePath) {
+    return ruleSanitizationChanges(filePath).length > 0;
+}
+/**
+ * Return a concise list of rule-frontmatter sanitization changes.
+ */
+export function ruleSanitizationChanges(filePath) {
     const content = readFile(filePath);
     const { frontmatter } = parseFrontmatter(content);
     const ruleName = path.basename(filePath, ".md");
-    const sanitized = sanitizeRuleFrontmatter(frontmatter, ruleName);
-    return JSON.stringify(frontmatter) !== JSON.stringify(sanitized);
+    return sanitizeRuleFrontmatterWithSummary(frontmatter, ruleName).changes;
 }
 /**
  * Sanitize a rule file in place.
  * Returns true if the file was modified.
  */
 export function sanitizeRuleFile(filePath) {
+    return sanitizeRuleFileWithSummary(filePath).modified;
+}
+/**
+ * Sanitize a rule file in place and return change details.
+ */
+export function sanitizeRuleFileWithSummary(filePath) {
     const content = readFile(filePath);
     const { frontmatter, body } = parseFrontmatter(content);
     const ruleName = path.basename(filePath, ".md");
-    const sanitized = sanitizeRuleFrontmatter(frontmatter, ruleName);
+    const { frontmatter: sanitized, changes } = sanitizeRuleFrontmatterWithSummary(frontmatter, ruleName);
     // Check if anything changed
-    const originalStr = JSON.stringify(frontmatter);
-    const sanitizedStr = JSON.stringify(sanitized);
+    const originalStr = stableStringify(frontmatter);
+    const sanitizedStr = stableStringify(sanitized);
     if (originalStr === sanitizedStr) {
-        return false;
+        return { modified: false, changes: [] };
     }
     const newContent = serializeFrontmatter(sanitized, body);
     writeFile(filePath, newContent);
-    return true;
+    return { modified: true, changes };
 }
 /**
  * Find all rules that need sanitization in a loadout root.
  */
 export function findUnsanitizedRules(loadoutRoot) {
-    const rulesDir = path.join(loadoutRoot, "rules");
+    const rulesDir = path.join(loadoutRoot, RULES_DIR);
     if (!isDirectory(rulesDir))
         return [];
     const unsanitized = [];
@@ -163,4 +245,112 @@ export function findUnsanitizedRules(loadoutRoot) {
     }
     return unsanitized;
 }
+/**
+ * Sanitize skill frontmatter for canonical v1 portability.
+ */
+export function sanitizeSkillFrontmatter(frontmatter, skillName) {
+    return sanitizeSkillFrontmatterWithSummary(frontmatter, skillName).frontmatter;
+}
+/**
+ * Sanitize skill frontmatter and return a concise change summary.
+ */
+export function sanitizeSkillFrontmatterWithSummary(frontmatter, skillName) {
+    const result = { ...frontmatter };
+    const changes = [];
+    if (!result.name && skillName) {
+        result.name = skillName;
+        changes.push("~ added name");
+    }
+    if (!result.description) {
+        result.description = skillName
+            ? `${skillName} skill for AI coding agents`
+            : "Skill for AI coding agents";
+        changes.push("~ added description");
+    }
+    const disableModelInvocation = result["disable-model-invocation"];
+    const canonicalModelInvocable = result["model-invocable"];
+    if (typeof disableModelInvocation === "boolean") {
+        const aliasModelInvocable = !disableModelInvocation;
+        if (typeof canonicalModelInvocable === "boolean") {
+            if (canonicalModelInvocable !== aliasModelInvocable) {
+                changes.push("~ conflicting alias ignored: disable-model-invocation (kept model-invocable)");
+            }
+        }
+        else {
+            result["model-invocable"] = aliasModelInvocable;
+            changes.push(`~ disable-model-invocation -> model-invocable: ${aliasModelInvocable}`);
+        }
+        delete result["disable-model-invocation"];
+        changes.push("~ removed alias: disable-model-invocation");
+    }
+    if (typeof result["user-invocable"] !== "boolean") {
+        result["user-invocable"] = true;
+        changes.push("~ user-invocable -> true");
+    }
+    if (typeof result["model-invocable"] !== "boolean") {
+        result["model-invocable"] = true;
+        changes.push("~ model-invocable -> true");
+    }
+    return { frontmatter: result, changes };
+}
+/**
+ * Check if a skill file needs sanitization.
+ */
+export function skillNeedsSanitization(filePath) {
+    return skillSanitizationChanges(filePath).length > 0;
+}
+/**
+ * Return a concise list of skill-frontmatter sanitization changes.
+ */
+export function skillSanitizationChanges(filePath) {
+    const content = readFile(filePath);
+    const { frontmatter } = parseSkillFrontmatter(content);
+    const skillName = path.basename(path.dirname(filePath));
+    return sanitizeSkillFrontmatterWithSummary(frontmatter, skillName).changes;
+}
+/**
+ * Sanitize a skill file in place.
+ * Returns true if the file was modified.
+ */
+export function sanitizeSkillFile(filePath) {
+    return sanitizeSkillFileWithSummary(filePath).modified;
+}
+/**
+ * Sanitize a skill file in place and return change details.
+ */
+export function sanitizeSkillFileWithSummary(filePath) {
+    const content = readFile(filePath);
+    const { frontmatter, body } = parseSkillFrontmatter(content);
+    const skillName = path.basename(path.dirname(filePath));
+    const { frontmatter: sanitized, changes } = sanitizeSkillFrontmatterWithSummary(frontmatter, skillName);
+    const originalStr = stableStringify(frontmatter);
+    const sanitizedStr = stableStringify(sanitized);
+    if (originalStr === sanitizedStr) {
+        return { modified: false, changes: [] };
+    }
+    const newContent = serializeFrontmatter(sanitized, body);
+    writeFile(filePath, newContent);
+    return { modified: true, changes };
+}
+/**
+ * Find all skills that need sanitization in a loadout root.
+ */
+export function findUnsanitizedSkills(loadoutRoot) {
+    const skillsDir = path.join(loadoutRoot, SKILLS_DIR);
+    if (!isDirectory(skillsDir))
+        return [];
+    const unsanitized = [];
+    for (const entry of listFiles(skillsDir)) {
+        const skillDir = path.join(skillsDir, entry);
+        if (!isDirectory(skillDir))
+            continue;
+        const skillMdPath = path.join(skillDir, "SKILL.md");
+        if (!fileExists(skillMdPath))
+            continue;
+        if (skillNeedsSanitization(skillMdPath)) {
+            unsanitized.push(entry);
+        }
+    }
+    return unsanitized;
+}
 //# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/import-discovery.d.ts

@@ -37,6 +37,8 @@ export interface DiscoveryOptions {
     tools?: string[];
     /** Filter to specific kinds */
     kinds?: ImportableKind[];
+    /** Restrict discovery to one explicit source file or directory */
+    sourcePath?: string;
     /** Path to .loadouts/ directory (to check for existing artifacts) */
     loadoutPath?: string;
 }

package/dist/core/import-discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"import-discovery.d.ts","sourceRoot":"","sources":["../../src/core/import-discovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAMxC,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,IAAI,EAAE,cAAc,CAAC;IACrB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,KAAK,EAAE,IAAI,CAAC;IACZ,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,8CAA8C;IAC9C,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC7C,oCAAoC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAsaD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CAgDjB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,kBAAkB,EAAE,GAC9B,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAOtC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAWrD"}
+{"version":3,"file":"import-discovery.d.ts","sourceRoot":"","sources":["../../src/core/import-discovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAMxC,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,MAAM,WAAW,kBAAkB;IACjC,oBAAoB;IACpB,IAAI,EAAE,cAAc,CAAC;IACrB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,KAAK,EAAE,IAAI,CAAC;IACZ,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,+BAA+B;IAC/B,SAAS,EAAE,kBAAkB,EAAE,CAAC;IAChC,8CAA8C;IAC9C,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC7C,oCAAoC;IACpC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,sBAAsB;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA6jBD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CA2DjB;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,kBAAkB,EAAE,GAC9B,MAAM,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAOtC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAWrD"}

package/dist/core/import-discovery.js

@@ -84,6 +84,126 @@ function toDisplayPath(scanRoot, absolutePath) {
     }
     return toPosix(absolutePath);
 }
+function isPathWithin(parentPath, childPath) {
+    const rel = path.relative(parentPath, childPath);
+    return rel === "" || (!!rel && !rel.startsWith("..") && !path.isAbsolute(rel));
+}
+function matchesSourcePath(artifact, sourcePath) {
+    if (artifact.kind === "skill" && isPathWithin(artifact.sourcePath, sourcePath)) {
+        return true;
+    }
+    return isPathWithin(sourcePath, artifact.sourcePath) || artifact.sourcePath === sourcePath;
+}
+function sourceAllowsKind(kindId, kinds) {
+    return !kinds || kinds.length === 0 || kinds.includes(kindId);
+}
+function buildSourceArtifact(scanRoot, kind, sourcePath, destPath, name) {
+    const metadata = readArtifactMetadata(sourcePath);
+    if (!metadata)
+        return null;
+    return {
+        kind,
+        name,
+        sourcePath,
+        displayPath: toDisplayPath(scanRoot, sourcePath),
+        tool: "source",
+        size: metadata.size,
+        mtime: metadata.mtime,
+        destPath,
+    };
+}
+function buildRuleSourceArtifact(scanRoot, sourcePath) {
+    const ext = path.extname(sourcePath).toLowerCase();
+    if (ext !== ".md" && ext !== ".mdc")
+        return null;
+    const stem = path.basename(sourcePath, ext);
+    if (!stem || stem === "AGENTS" || stem === "CLAUDE")
+        return null;
+    return buildSourceArtifact(scanRoot, "rule", sourcePath, `rules/${stem}.md`, stem);
+}
+function buildInstructionSourceArtifact(scanRoot, sourcePath) {
+    const basename = path.basename(sourcePath);
+    if (basename !== "AGENTS.md" && basename !== "CLAUDE.md" && !/^AGENTS\.[^.]+\.md$/.test(basename)) {
+        return null;
+    }
+    return buildSourceArtifact(scanRoot, "instruction", sourcePath, "instructions/AGENTS.base.md", "AGENTS.md");
+}
+function buildSkillSourceArtifact(scanRoot, skillDir) {
+    const skillMdPath = path.join(skillDir, "SKILL.md");
+    if (!fileExists(skillMdPath))
+        return null;
+    const name = path.basename(skillDir);
+    return buildSourceArtifact(scanRoot, "skill", skillDir, `skills/${name}`, name);
+}
+function discoverDirectSourceArtifacts(scanRoot, sourcePath, kinds) {
+    const artifacts = [];
+    if (!fileExists(sourcePath))
+        return artifacts;
+    if (!isDirectory(sourcePath)) {
+        if (sourceAllowsKind("instruction", kinds)) {
+            const instruction = buildInstructionSourceArtifact(scanRoot, sourcePath);
+            if (instruction)
+                artifacts.push(instruction);
+        }
+        if (sourceAllowsKind("skill", kinds) && path.basename(sourcePath) === "SKILL.md") {
+            const skill = buildSkillSourceArtifact(scanRoot, path.dirname(sourcePath));
+            if (skill)
+                artifacts.push(skill);
+        }
+        if (sourceAllowsKind("rule", kinds)) {
+            const rule = buildRuleSourceArtifact(scanRoot, sourcePath);
+            if (rule)
+                artifacts.push(rule);
+        }
+        return artifacts;
+    }
+    if (sourceAllowsKind("skill", kinds)) {
+        const directSkill = buildSkillSourceArtifact(scanRoot, sourcePath);
+        if (directSkill)
+            artifacts.push(directSkill);
+    }
+    const basename = path.basename(sourcePath);
+    const rulesRoot = basename === "rules" ? sourcePath : path.join(sourcePath, "rules");
+    if (sourceAllowsKind("rule", kinds) && isDirectory(rulesRoot)) {
+        for (const rel of walkDir(rulesRoot)) {
+            const rule = buildRuleSourceArtifact(scanRoot, path.join(rulesRoot, rel));
+            if (rule)
+                artifacts.push(rule);
+        }
+    }
+    const skillsRoot = basename === "skills" ? sourcePath : path.join(sourcePath, "skills");
+    if (sourceAllowsKind("skill", kinds) && isDirectory(skillsRoot)) {
+        for (const entry of listFiles(skillsRoot)) {
+            const skillDir = path.join(skillsRoot, entry);
+            if (!isDirectory(skillDir))
+                continue;
+            const skill = buildSkillSourceArtifact(scanRoot, skillDir);
+            if (skill)
+                artifacts.push(skill);
+        }
+    }
+    const instructionsRoot = basename === "instructions" ? sourcePath : path.join(sourcePath, "instructions");
+    if (sourceAllowsKind("instruction", kinds) && isDirectory(instructionsRoot)) {
+        for (const rel of walkDir(instructionsRoot)) {
+            const instruction = buildInstructionSourceArtifact(scanRoot, path.join(instructionsRoot, rel));
+            if (instruction)
+                artifacts.push(instruction);
+        }
+    }
+    return artifacts;
+}
+function dedupeArtifacts(artifacts) {
+    const seen = new Set();
+    const deduped = [];
+    for (const artifact of artifacts) {
+        const key = `${artifact.kind}:${artifact.sourcePath}:${artifact.destPath}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        deduped.push(artifact);
+    }
+    return deduped;
+}
 /**
  * Build a regex matcher for a concrete template path.
  * Supported tokens: {base} {home} {stem} {ext} {name} {relative} {kind}
@@ -369,6 +489,7 @@ export function discoverImportableArtifacts(scanRoot, options = {}) {
     const artifacts = [];
     const warnings = [];
     const { scope = "project", tools, kinds, loadoutPath } = options;
+    const sourcePath = options.sourcePath ? path.resolve(options.sourcePath) : undefined;
     const allTools = registry.allToolNames();
     const toolsToScan = tools
         ? allTools.filter((tool) => tools.includes(tool))
@@ -386,10 +507,17 @@ export function discoverImportableArtifacts(scanRoot, options = {}) {
     if (!kinds || kinds.length === 0 || kinds.includes("instruction")) {
         artifacts.push(...discoverInstructions(scanRoot, loadoutPath));
     }
+    if (sourcePath) {
+        artifacts.push(...discoverDirectSourceArtifacts(scanRoot, sourcePath, kinds));
+    }
     // Filter out artifacts already present in .loadouts/.
-    const filteredArtifacts = loadoutPath
+    const existingFilteredArtifacts = loadoutPath
         ? artifacts.filter((artifact) => !artifactExistsInLoadout(loadoutPath, artifact))
         : artifacts;
+    const sourceFilteredArtifacts = sourcePath
+        ? existingFilteredArtifacts.filter((artifact) => matchesSourcePath(artifact, sourcePath))
+        : existingFilteredArtifacts;
+    const filteredArtifacts = dedupeArtifacts(sourceFilteredArtifacts);
     // Detect conflicts by canonical destination path.
     const byDest = new Map();
     for (const artifact of filteredArtifacts) {