loadouts 0.1.11

package/dist/cli/index.js

@@ -0,0 +1,134 @@
+/**
+ * CLI setup with Commander
+ *
+ * All commands support scope flags:
+ *   -l / --local   → project scope
+ *   -g / --global  → global scope
+ *   -a / --all     → both scopes (default for status/list/sync/clear)
+ */
+import { Command } from "commander";
+import { createRequire } from "module";
+const require = createRequire(import.meta.url);
+const pkg = require("../../package.json");
+import { initCommand } from "./commands/init.js";
+import { activateCommand } from "./commands/activate.js";
+import { deactivateCommand } from "./commands/deactivate.js";
+import { syncCommand } from "./commands/sync.js";
+import { clearCommand } from "./commands/clear.js";
+import { removeCommand } from "./commands/remove.js";
+import { createCommand } from "./commands/create.js";
+import { listCommand } from "./commands/list.js";
+import { checkCommand } from "./commands/check.js";
+import { statusCommand } from "./commands/status.js";
+import { ruleCommand } from "./commands/rule.js";
+import { skillCommand } from "./commands/skill.js";
+import { instructionsCommand } from "./commands/instructions.js";
+import { infoCommand } from "./commands/info.js";
+import { diffCommand } from "./commands/diff.js";
+import { editCommand } from "./commands/edit.js";
+import { kindsCommand } from "./commands/kinds.js";
+import { docsCommand } from "./commands/docs.js";
+import { sanitizeCommand } from "./commands/sanitize.js";
+import { fallbackCommand } from "./commands/fallback.js";
+import { installCommand } from "./commands/install.js";
+import { updateCommand } from "./commands/update.js";
+// ---------------------------------------------------------------------------
+// Command groups — controls help output order and section headers
+// ---------------------------------------------------------------------------
+const COMMAND_GROUPS = [
+    {
+        title: "Active Configuration",
+        commands: [
+            infoCommand,
+            activateCommand,
+            deactivateCommand,
+            clearCommand,
+            statusCommand,
+            syncCommand,
+            sanitizeCommand,
+        ],
+    },
+    {
+        title: "Bundle Management",
+        commands: [
+            initCommand,
+            installCommand,
+            createCommand,
+            editCommand,
+            removeCommand,
+            listCommand,
+            checkCommand,
+            diffCommand,
+            fallbackCommand,
+        ],
+    },
+    {
+        title: "Artifact Authoring",
+        commands: [
+            ruleCommand,
+            skillCommand,
+            instructionsCommand,
+            kindsCommand,
+        ],
+    },
+    {
+        title: "Help",
+        commands: [
+            docsCommand,
+            updateCommand,
+        ],
+    },
+];
+export const cli = new Command()
+    .name("loadouts")
+    .description("Composable configuration bundles for AI coding agents")
+    .version(pkg.version);
+for (const group of COMMAND_GROUPS) {
+    for (const cmd of group.commands) {
+        cli.addCommand(cmd);
+    }
+}
+// ---------------------------------------------------------------------------
+// Custom help formatter — renders commands in labeled sections
+// ---------------------------------------------------------------------------
+cli.configureHelp({
+    formatHelp(cmd, helper) {
+        const termWidth = helper.padWidth(cmd, helper);
+        const helpWidth = helper.helpWidth || 80;
+        const indent = 2;
+        const sep = 2;
+        function formatItem(term, description) {
+            if (description) {
+                const fullText = `${term.padEnd(termWidth + sep)}${description}`;
+                return helper.wrap(fullText, helpWidth - indent, termWidth + sep);
+            }
+            return term;
+        }
+        function formatList(items) {
+            return items.join("\n").replace(/^/gm, " ".repeat(indent));
+        }
+        let output = [`Usage: ${helper.commandUsage(cmd)}`, ""];
+        const desc = helper.commandDescription(cmd);
+        if (desc)
+            output = output.concat([helper.wrap(desc, helpWidth, 0), ""]);
+        // Grouped commands — build a lookup by command name for membership
+        const allGrouped = new Set(COMMAND_GROUPS.flatMap((g) => g.commands.map((c) => c.name())));
+        const visibleCmds = helper.visibleCommands(cmd);
+        for (const group of COMMAND_GROUPS) {
+            const groupNames = new Set(group.commands.map((c) => c.name()));
+            const items = visibleCmds
+                .filter((c) => groupNames.has(c.name()))
+                .map((c) => formatItem(helper.subcommandTerm(c).replace(/\s*\[options\]/, ""), helper.subcommandDescription(c)));
+            if (items.length > 0) {
+                output = output.concat([`${group.title}:`, formatList(items), ""]);
+            }
+        }
+        // Options (at the bottom — commands are the primary interface)
+        const optionList = helper.visibleOptions(cmd).map((opt) => formatItem(helper.optionTerm(opt), helper.optionDescription(opt)));
+        if (optionList.length > 0) {
+            output = output.concat(["Options:", formatList(optionList), ""]);
+        }
+        return output.join("\n");
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/core/config.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Parse source configs and loadout definitions
+ */
+import { type RuleFrontmatter } from "./schema.js";
+import type { RootConfig, LoadoutDefinition, LoadoutRoot } from "./types.js";
+/**
+ * Parse the root config from a .loadouts/ directory.
+ * Returns default config if file doesn't exist.
+ */
+export declare function parseRootConfig(loadoutRoot: string): RootConfig;
+/**
+ * Parse a loadout definition file.
+ */
+export declare function parseLoadoutDefinition(filePath: string): LoadoutDefinition;
+/**
+ * List available loadouts in a .loadouts/ directory.
+ */
+export declare function listLoadouts(loadoutRoot: string): string[];
+/**
+ * Find a loadout definition by name, searching from nearest root upward.
+ */
+export declare function findLoadoutDefinition(name: string, roots: LoadoutRoot[]): {
+    definition: LoadoutDefinition;
+    rootPath: string;
+} | null;
+/**
+ * Parse frontmatter from a markdown file.
+ * Returns the frontmatter object and the body content.
+ */
+export declare function parseFrontmatter(content: string): {
+    frontmatter: RuleFrontmatter;
+    body: string;
+};
+/**
+ * Serialize frontmatter and body back to markdown.
+ */
+export declare function serializeFrontmatter(frontmatter: RuleFrontmatter, body: string): string;
+/**
+ * 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.
+ */
+export declare function sanitizeRuleFrontmatter(frontmatter: RuleFrontmatter, ruleName?: string): RuleFrontmatter;
+/**
+ * Check if a rule file needs sanitization.
+ * Returns true if the file would be modified by sanitization.
+ */
+export declare function ruleNeedsSanitization(filePath: string): boolean;
+/**
+ * Sanitize a rule file in place.
+ * Returns true if the file was modified.
+ */
+export declare function sanitizeRuleFile(filePath: string): boolean;
+/**
+ * Find all rules that need sanitization in a loadout root.
+ */
+export declare function findUnsanitizedRules(loadoutRoot: string): string[];
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +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"}

package/dist/core/config.js

@@ -0,0 +1,166 @@
+/**
+ * Parse source configs and loadout definitions
+ */
+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";
+const ROOT_CONFIG_FILE = "loadouts.yaml";
+const LOADOUTS_DIR = "loadouts";
+/**
+ * Parse the root config from a .loadouts/ directory.
+ * Returns default config if file doesn't exist.
+ */
+export function parseRootConfig(loadoutRoot) {
+    const configPath = path.join(loadoutRoot, ROOT_CONFIG_FILE);
+    if (!fileExists(configPath)) {
+        return { version: "1" };
+    }
+    const content = readFile(configPath);
+    const parsed = yaml.parse(content);
+    return RootConfigSchema.parse(parsed);
+}
+/**
+ * Parse a loadout definition file.
+ */
+export function parseLoadoutDefinition(filePath) {
+    const content = readFile(filePath);
+    const parsed = yaml.parse(content);
+    return LoadoutDefinitionSchema.parse(parsed);
+}
+/**
+ * List available loadouts in a .loadouts/ directory.
+ */
+export function listLoadouts(loadoutRoot) {
+    const loadoutsDir = path.join(loadoutRoot, LOADOUTS_DIR);
+    if (!isDirectory(loadoutsDir)) {
+        return [];
+    }
+    return listFiles(loadoutsDir)
+        .filter((f) => f.endsWith(".yaml") || f.endsWith(".yml"))
+        .map((f) => f.replace(/\.ya?ml$/, ""));
+}
+/**
+ * Find a loadout definition by name, searching from nearest root upward.
+ */
+export function findLoadoutDefinition(name, roots) {
+    for (const root of roots) {
+        const yamlPath = path.join(root.path, LOADOUTS_DIR, `${name}.yaml`);
+        const ymlPath = path.join(root.path, LOADOUTS_DIR, `${name}.yml`);
+        const filePath = fileExists(yamlPath)
+            ? yamlPath
+            : fileExists(ymlPath)
+                ? ymlPath
+                : null;
+        if (filePath) {
+            return {
+                definition: parseLoadoutDefinition(filePath),
+                rootPath: root.path,
+            };
+        }
+    }
+    return null;
+}
+/**
+ * Parse frontmatter from a markdown file.
+ * 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);
+    return { frontmatter, body };
+}
+/**
+ * Serialize frontmatter and body back to markdown.
+ */
+export function serializeFrontmatter(frontmatter, body) {
+    if (Object.keys(frontmatter).length === 0) {
+        return body;
+    }
+    const frontmatterStr = yaml.stringify(frontmatter).trim();
+    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.
+ */
+export function sanitizeRuleFrontmatter(frontmatter, ruleName) {
+    const result = { ...frontmatter };
+    // Mirror paths <-> globs for Cursor/OpenCode compatibility
+    if (result.paths && !result.globs) {
+        result.globs = result.paths;
+    }
+    else if (result.globs && !result.paths) {
+        result.paths = result.globs;
+    }
+    // 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`;
+    }
+    return result;
+}
+/**
+ * Check if a rule file needs sanitization.
+ * Returns true if the file would be modified by sanitization.
+ */
+export function ruleNeedsSanitization(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);
+}
+/**
+ * Sanitize a rule file in place.
+ * Returns true if the file was modified.
+ */
+export function sanitizeRuleFile(filePath) {
+    const content = readFile(filePath);
+    const { frontmatter, body } = parseFrontmatter(content);
+    const ruleName = path.basename(filePath, ".md");
+    const sanitized = sanitizeRuleFrontmatter(frontmatter, ruleName);
+    // Check if anything changed
+    const originalStr = JSON.stringify(frontmatter);
+    const sanitizedStr = JSON.stringify(sanitized);
+    if (originalStr === sanitizedStr) {
+        return false;
+    }
+    const newContent = serializeFrontmatter(sanitized, body);
+    writeFile(filePath, newContent);
+    return true;
+}
+/**
+ * Find all rules that need sanitization in a loadout root.
+ */
+export function findUnsanitizedRules(loadoutRoot) {
+    const rulesDir = path.join(loadoutRoot, "rules");
+    if (!isDirectory(rulesDir))
+        return [];
+    const unsanitized = [];
+    for (const file of listFiles(rulesDir)) {
+        if (!file.endsWith(".md"))
+            continue;
+        const rulePath = path.join(rulesDir, file);
+        if (ruleNeedsSanitization(rulePath)) {
+            unsanitized.push(file.replace(/\.md$/, ""));
+        }
+    }
+    return unsanitized;
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/core/discovery.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Discovery: Find .loadouts/ directories and resolve source references
+ */
+import { LoadoutRoot, Scope, CommandContext } from "./types.js";
+export declare function getGlobalConfigPath(): string;
+/**
+ * Discover all .loadouts/ directories from cwd up to git root.
+ * Returns them ordered from nearest (depth 0) to furthest.
+ */
+export declare function discoverLoadoutRoots(cwd?: string): Promise<LoadoutRoot[]>;
+/**
+ * Find the nearest .loadouts/ directory.
+ */
+export declare function findNearestLoadoutRoot(cwd?: string): Promise<LoadoutRoot | null>;
+/**
+ * Get the project root (git root or cwd if no git).
+ */
+export declare function getProjectRoot(cwd?: string): Promise<string>;
+/**
+ * Get the command context for a given scope.
+ */
+export declare function getContext(scope: Scope, cwd?: string): Promise<CommandContext>;
+/**
+ * Get global config path if it exists.
+ */
+export declare function getGlobalRoot(): LoadoutRoot | null;
+/**
+ * Get the bundled root (ships with loadouts CLI).
+ * Contains built-in loadouts like 'loadouts' for self-documentation.
+ */
+export declare function getBundledRoot(): LoadoutRoot | null;
+/**
+ * Resolve a source path relative to a .loadouts/ directory.
+ * Handles ~, relative paths, and looks for .loadouts/ within the target.
+ */
+export declare function resolveSourcePath(sourceRef: string, fromLoadoutDir: string): string | null;
+/**
+ * Collect all roots starting from a primary root, following sources transitively.
+ * Missing sources generate warnings but don't fail resolution.
+ *
+ * @param primaryRoot - The starting .loadouts/ directory
+ * @param includeGlobal - Whether to append the global root
+ * @param includeBundled - Whether to append the bundled root (default: true)
+ * @returns Ordered list of roots (primary first, then sources, global, bundled last)
+ */
+export declare function collectRootsWithSources(primaryRoot: LoadoutRoot, includeGlobal?: boolean, includeBundled?: boolean): {
+    roots: LoadoutRoot[];
+    warnings: string[];
+};
+//# sourceMappingURL=discovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../src/core/discovery.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,cAAc,EAAa,MAAM,YAAY,CAAC;AAM3E,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAID;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,WAAW,EAAE,CAAC,CA0CxB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAG7B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,KAAK,EACZ,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,cAAc,CAAC,CAwBzB;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,WAAW,GAAG,IAAI,CAYlD;AAsBD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CASnD;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwB1F;AAmBD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,WAAW,EACxB,aAAa,GAAE,OAAc,EAC7B,cAAc,GAAE,OAAc,GAC7B;IAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA4D9C"}