loadouts 0.1.11

package/dist/cli/commands/create.js

@@ -0,0 +1,113 @@
+/**
+ * loadout create — Create a new loadout definition.
+ *
+ * Scope flags:
+ *   -l / --local   → create in project .loadouts/
+ *   -g / --global  → create in ~/.config/loadouts
+ *   (none)         → project if in one, else global
+ */
+import { Command } from "commander";
+import * as path from "node:path";
+import { findNearestLoadoutRoot, getGlobalConfigPath } from "../../core/discovery.js";
+import { inProject, hasGlobal, SCOPE_FLAGS } from "../../core/scope.js";
+import { writeFile, fileExists } from "../../lib/fs.js";
+import { log, heading } from "../../lib/output.js";
+import { openInEditor } from "../../lib/editor.js";
+export const createCommand = new Command("create")
+    .description("Create a new loadout definition")
+    .argument("<name>", "Loadout name")
+    .option("-d, --description <desc>", "Loadout description")
+    .option("--no-edit", "Don't open in editor after creating")
+    .option(...SCOPE_FLAGS.local)
+    .option(...SCOPE_FLAGS.global)
+    .action(async (name, options) => {
+    const cwd = process.cwd();
+    // Resolve scope
+    let scope;
+    let rootPath;
+    if (options.local) {
+        const projectRoot = await findNearestLoadoutRoot(cwd);
+        if (!projectRoot) {
+            log.error("Not in a loadout project. Run 'loadout init' first.");
+            process.exit(1);
+        }
+        scope = "project";
+        rootPath = projectRoot.path;
+    }
+    else if (options.global) {
+        if (!hasGlobal()) {
+            log.error("No global loadout found. Run 'loadout init --global' first.");
+            process.exit(1);
+        }
+        scope = "global";
+        rootPath = getGlobalConfigPath();
+    }
+    else {
+        // Auto-detect: prefer project if in one
+        if (await inProject(cwd)) {
+            const projectRoot = await findNearestLoadoutRoot(cwd);
+            scope = "project";
+            rootPath = projectRoot.path;
+        }
+        else if (hasGlobal()) {
+            scope = "global";
+            rootPath = getGlobalConfigPath();
+        }
+        else {
+            log.error("No loadout found. Run 'loadout init' or 'loadout init --global' first.");
+            process.exit(1);
+        }
+    }
+    const loadoutPath = path.join(rootPath, "loadouts", `${name}.yaml`);
+    if (fileExists(loadoutPath)) {
+        log.error(`Loadout '${name}' already exists in ${scope} scope.`);
+        process.exit(1);
+    }
+    // Build a documented template for the loadout
+    const description = options.description || `${name} loadout`;
+    const template = `# yaml-language-server: $schema=loadout-schema.json
+#
+# Loadout: ${name}
+# ${description}
+#
+# A loadout defines which artifacts (rules, skills, prompts, etc.) are
+# activated together. Use 'include' to add artifacts from this .loadouts/
+# directory.
+#
+# Examples:
+#   include:
+#     - rules/coding-standards.md    # A single rule file
+#     - skills/debugging             # A skill directory
+#     - prompts/review.md            # A prompt template
+#
+# Per-item tool overrides:
+#   include:
+#     - path: rules/cursor-only.md
+#       tools: [cursor]              # Only render for Cursor
+#
+# Tool targeting (default: all tools):
+#   tools: [claude-code, cursor]     # Only target specific tools
+
+name: ${name}
+description: ${description}
+
+# Add your artifacts here:
+include: []
+`;
+    writeFile(loadoutPath, template);
+    const scopeLabel = scope === "global" ? "global" : "project";
+    heading(`Created ${scopeLabel} loadout: ${name}`);
+    log.success(`Written to: ${loadoutPath}`);
+    // Open in editor unless --no-edit
+    if (!options.noEdit) {
+        await openInEditor(loadoutPath, { cwd: rootPath });
+    }
+    else {
+        console.log();
+        log.info("Next steps:");
+        log.dim(`  1. Edit ${loadoutPath} to add includes`);
+        const flag = scope === "global" ? " -g" : "";
+        log.dim(`  2. Activate with: loadout activate ${name}${flag}`);
+    }
+});
+//# sourceMappingURL=create.js.map

package/dist/cli/commands/create.js.map

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

package/dist/cli/commands/deactivate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * loadout deactivate — Remove loadout(s) from the active set.
+ *
+ * Scope flags:
+ *   -l / --local   → project scope only
+ *   -g / --global  → global scope only
+ *   -a / --all     → deactivate in both scopes
+ *   (none)         → auto-detect; error if name exists in both
+ */
+import { Command } from "commander";
+export declare const deactivateCommand: Command;
+//# sourceMappingURL=deactivate.d.ts.map

package/dist/cli/commands/deactivate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deactivate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/deactivate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,eAAO,MAAM,iBAAiB,SAuD1B,CAAC"}

package/dist/cli/commands/deactivate.js

@@ -0,0 +1,67 @@
+/**
+ * loadout deactivate — Remove loadout(s) from the active set.
+ *
+ * Scope flags:
+ *   -l / --local   → project scope only
+ *   -g / --global  → global scope only
+ *   -a / --all     → deactivate in both scopes
+ *   (none)         → auto-detect; error if name exists in both
+ */
+import { Command } from "commander";
+import { getContext } from "../../core/discovery.js";
+import { loadState } from "../../core/manifest.js";
+import { resolveContexts, requireScopeForName, SCOPE_FLAGS, } from "../../core/scope.js";
+import { computeDeactivateSet } from "./policy.js";
+import { applyTargetSet } from "./render-engine.js";
+import { log } from "../../lib/output.js";
+export const deactivateCommand = new Command("deactivate")
+    .description("Deactivate loadout(s) (remove from active set)")
+    .argument("<names...>", "Loadout names to deactivate")
+    .option(...SCOPE_FLAGS.local)
+    .option(...SCOPE_FLAGS.global)
+    .option(...SCOPE_FLAGS.all)
+    .option("--dry-run", "Preview changes without applying")
+    .action(async (names, options) => {
+    const cwd = process.cwd();
+    // If --all, deactivate in both scopes
+    if (options.all) {
+        const { contexts } = await resolveContexts(options, cwd);
+        for (const ctx of contexts) {
+            const current = loadState(ctx.configPath)?.active ?? [];
+            const { targets, earlyExit } = computeDeactivateSet(current, names);
+            if (earlyExit) {
+                // Not an error for deactivate — just nothing to do
+                log.dim(`[${ctx.scope}] ${earlyExit}`);
+                continue;
+            }
+            await applyTargetSet(ctx, targets, {
+                dryRun: options.dryRun,
+                verb: "Deactivated",
+            });
+        }
+        return;
+    }
+    // Otherwise, resolve each name to its scope
+    let targetScope;
+    if (options.local) {
+        targetScope = "project";
+    }
+    else if (options.global) {
+        targetScope = "global";
+    }
+    else {
+        targetScope = await requireScopeForName(names[0], options, cwd);
+    }
+    const ctx = await getContext(targetScope, cwd);
+    const current = loadState(ctx.configPath)?.active ?? [];
+    const { targets, earlyExit } = computeDeactivateSet(current, names);
+    if (earlyExit) {
+        log.warn(earlyExit);
+        return;
+    }
+    await applyTargetSet(ctx, targets, {
+        dryRun: options.dryRun,
+        verb: "Deactivated",
+    });
+});
+//# sourceMappingURL=deactivate.js.map

package/dist/cli/commands/deactivate.js.map

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

package/dist/cli/commands/diff.d.ts

@@ -0,0 +1,16 @@
+/**
+ * loadout diff — Show what would change if a loadout were applied.
+ *
+ * Scope flags:
+ *   -l / --local   → project scope only
+ *   -g / --global  → global scope only
+ *   -a / --all     → show diff for both scopes
+ *   (none)         → auto-detect; error if name exists in both without flag
+ *
+ * Output follows unified visual language (see docs/visual-language.md).
+ */
+import { Command } from "commander";
+import type { CommandContext } from "../../core/types.js";
+export declare function executeDiff(ctx: CommandContext, name?: string): Promise<void>;
+export declare const diffCommand: Command;
+//# sourceMappingURL=diff.d.ts.map

package/dist/cli/commands/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC,OAAO,KAAK,EAAE,cAAc,EAAQ,MAAM,qBAAqB,CAAC;AAEhE,wBAAsB,WAAW,CAC/B,GAAG,EAAE,cAAc,EACnB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CA6Ff;AAED,eAAO,MAAM,WAAW,SA0CpB,CAAC"}

package/dist/cli/commands/diff.js

@@ -0,0 +1,144 @@
+/**
+ * loadout diff — Show what would change if a loadout were applied.
+ *
+ * Scope flags:
+ *   -l / --local   → project scope only
+ *   -g / --global  → global scope only
+ *   -a / --all     → show diff for both scopes
+ *   (none)         → auto-detect; error if name exists in both without flag
+ *
+ * Output follows unified visual language (see docs/visual-language.md).
+ */
+import { Command } from "commander";
+import { getContext } from "../../core/discovery.js";
+import { loadResolvedLoadout } from "../../core/resolve.js";
+import { planRender } from "../../core/render.js";
+import { loadState } from "../../core/manifest.js";
+import { resolveContexts, requireScopeForName, SCOPE_FLAGS, } from "../../core/scope.js";
+import { log, heading } from "../../lib/output.js";
+import { groupOutputsByArtifact, renderChangeTable, } from "../../lib/artifact-table.js";
+export async function executeDiff(ctx, name) {
+    const result = await loadResolvedLoadout(ctx, name);
+    const { loadout, loadoutName } = result;
+    const plan = await planRender(loadout, ctx.projectRoot, ctx.scope, ctx.configPath);
+    const state = loadState(ctx.configPath);
+    heading(`Diff: ${loadoutName} (${ctx.scope})`);
+    // Build sets for change detection
+    const stateTargets = new Set(state?.entries.map((e) => e.targetPath) || []);
+    const planTargets = new Set(plan.outputs.map((o) => o.spec.targetPath));
+    // Collect all tools
+    const toolSet = new Set();
+    for (const { spec } of plan.outputs) {
+        toolSet.add(spec.tool);
+    }
+    if (state) {
+        for (const entry of state.entries) {
+            for (const tool of entry.tools) {
+                toolSet.add(tool);
+            }
+        }
+    }
+    const tools = Array.from(toolSet).sort();
+    // Build outputs with change types
+    const outputs = [];
+    // Current plan outputs: create or update
+    for (const { spec } of plan.outputs) {
+        const change = stateTargets.has(spec.targetPath) ? "updated" : "added";
+        outputs.push({ spec, change });
+    }
+    // Deleted entries from state
+    if (state) {
+        for (const entry of state.entries) {
+            if (!planTargets.has(entry.targetPath)) {
+                // Use first tool for display (all tools share the same output)
+                outputs.push({
+                    spec: {
+                        tool: entry.tools[0],
+                        kind: entry.kind,
+                        sourcePath: entry.sourcePath,
+                        targetPath: entry.targetPath,
+                        mode: entry.mode,
+                    },
+                    change: "removed",
+                });
+            }
+        }
+    }
+    // Shadowed entries
+    for (const s of plan.shadowed) {
+        outputs.push({
+            spec: {
+                tool: s.tool,
+                kind: s.kind,
+                sourcePath: s.sourcePath,
+                targetPath: s.targetPath,
+                mode: "symlink", // Default, doesn't matter for display
+            },
+            change: "shadowed",
+        });
+    }
+    if (outputs.length === 0) {
+        log.success("No changes");
+        return;
+    }
+    const artifacts = groupOutputsByArtifact(outputs);
+    renderChangeTable(artifacts, tools, { showAction: true });
+    // Summary counts
+    const added = outputs.filter((o) => o.change === "added").length;
+    const updated = outputs.filter((o) => o.change === "updated").length;
+    const removed = outputs.filter((o) => o.change === "removed").length;
+    const shadowed = outputs.filter((o) => o.change === "shadowed").length;
+    console.log();
+    const parts = [];
+    if (added > 0)
+        parts.push(`${added} to create`);
+    if (updated > 0)
+        parts.push(`${updated} to update`);
+    if (removed > 0)
+        parts.push(`${removed} to remove`);
+    if (shadowed > 0)
+        parts.push(`${shadowed} shadowed`);
+    log.dim(`  ${parts.join(" • ")}`);
+}
+export const diffCommand = new Command("diff")
+    .description("Show what would change if loadout were applied")
+    .argument("[name]", "Loadout name (uses default if not specified)")
+    .option(...SCOPE_FLAGS.local)
+    .option(...SCOPE_FLAGS.global)
+    .option(...SCOPE_FLAGS.all)
+    .action(async (name, options) => {
+    const cwd = process.cwd();
+    // If a name is given and no explicit scope, check for collisions
+    if (name && !options.local && !options.global && !options.all) {
+        try {
+            const scope = await requireScopeForName(name, options, cwd);
+            const ctx = await getContext(scope, cwd);
+            await executeDiff(ctx, name);
+            return;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (msg.includes("exists in both")) {
+                log.error(msg);
+                process.exit(1);
+            }
+        }
+    }
+    // Show diff for all resolved scopes
+    const { contexts } = await resolveContexts(options, cwd);
+    let hasAny = false;
+    for (const ctx of contexts) {
+        try {
+            await executeDiff(ctx, name);
+            hasAny = true;
+        }
+        catch {
+            // Scope doesn't have this loadout — skip silently
+        }
+    }
+    if (!hasAny) {
+        log.warn("No loadout found.");
+        log.dim("Run 'loadouts init' to set up a loadout.");
+    }
+});
+//# sourceMappingURL=diff.js.map

package/dist/cli/commands/diff.js.map

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

package/dist/cli/commands/docs.d.ts

@@ -0,0 +1,12 @@
+/**
+ * loadout docs — Display documentation.
+ *
+ * Usage:
+ *   loadout docs              # Show index/overview
+ *   loadout docs quickstart   # Show specific topic
+ *   loadout docs --list       # List available topics
+ *   loadout docs --raw        # Print without pager
+ */
+import { Command } from "commander";
+export declare const docsCommand: Command;
+//# sourceMappingURL=docs.d.ts.map

package/dist/cli/commands/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/docs.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqFpC,eAAO,MAAM,WAAW,SAqCpB,CAAC"}

package/dist/cli/commands/docs.js

@@ -0,0 +1,115 @@
+/**
+ * loadout docs — Display documentation.
+ *
+ * Usage:
+ *   loadout docs              # Show index/overview
+ *   loadout docs quickstart   # Show specific topic
+ *   loadout docs --list       # List available topics
+ *   loadout docs --raw        # Print without pager
+ */
+import { Command } from "commander";
+import * as path from "node:path";
+import * as fs from "node:fs";
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import chalk from "chalk";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/** Available documentation topics with descriptions. */
+const TOPICS = {
+    index: "Overview and quick reference",
+    quickstart: "Get started in 60 seconds",
+    concepts: "Loadouts, artifacts, scopes, tools",
+    commands: "Full command reference",
+    authoring: "Creating rules, skills, instructions",
+    workflows: "Team setup, git, CI/CD",
+    troubleshooting: "Common issues and solutions",
+};
+/**
+ * Find a docs file by topic name. Tries multiple locations:
+ * 1. Relative to the CLI source (development)
+ * 2. Relative to the installed package (production)
+ */
+function findDocsPath(topic) {
+    const filename = `${topic}.md`;
+    const candidates = [
+        // Development: relative to src/cli/commands/
+        path.resolve(__dirname, "../../../docs", filename),
+        // Production: relative to dist/cli/commands/
+        path.resolve(__dirname, "../../../docs", filename),
+        // Fallback: look in package root
+        path.resolve(__dirname, "../../docs", filename),
+    ];
+    for (const candidate of candidates) {
+        if (fs.existsSync(candidate)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+/** List available topics with descriptions. */
+function listTopics() {
+    console.log(chalk.bold("\nAvailable documentation topics:\n"));
+    const maxLen = Math.max(...Object.keys(TOPICS).map(k => k.length));
+    for (const [topic, description] of Object.entries(TOPICS)) {
+        if (topic === "index")
+            continue; // Skip index in listing
+        const padded = topic.padEnd(maxLen + 2);
+        console.log(`  ${chalk.cyan(padded)} ${chalk.dim(description)}`);
+    }
+    console.log();
+    console.log(chalk.dim("Usage: loadout docs <topic>"));
+    console.log();
+}
+/** Display documentation through pager or stdout. */
+function displayDocs(content, usePager) {
+    if (!usePager || !process.stdout.isTTY) {
+        console.log(content);
+        return;
+    }
+    const pager = process.env.PAGER || "less";
+    const pagerArgs = pager === "less" ? ["-R"] : [];
+    const child = spawn(pager, pagerArgs, {
+        stdio: ["pipe", "inherit", "inherit"],
+    });
+    child.stdin.write(content);
+    child.stdin.end();
+    child.on("error", () => {
+        // Pager not found, print directly
+        console.log(content);
+    });
+}
+export const docsCommand = new Command("docs")
+    .description("Display documentation")
+    .argument("[topic]", "Documentation topic (quickstart, concepts, commands, authoring, workflows, troubleshooting)")
+    .option("--list", "List available topics")
+    .option("--raw", "Print raw markdown without pager")
+    .action(async (topic, options) => {
+    if (options.list) {
+        listTopics();
+        return;
+    }
+    // Default to index if no topic specified
+    const targetTopic = topic || "index";
+    // Validate topic
+    if (!TOPICS[targetTopic]) {
+        console.error(chalk.red(`Unknown topic: ${targetTopic}`));
+        console.error();
+        console.error("Available topics:");
+        for (const t of Object.keys(TOPICS)) {
+            if (t !== "index")
+                console.error(`  ${t}`);
+        }
+        console.error();
+        console.error("Use: loadout docs <topic>");
+        process.exit(1);
+    }
+    const docsPath = findDocsPath(targetTopic);
+    if (!docsPath) {
+        console.error(chalk.red(`Documentation file not found: ${targetTopic}.md`));
+        console.error("Visit: https://github.com/evatths/loadout");
+        process.exit(1);
+    }
+    const content = fs.readFileSync(docsPath, "utf-8");
+    displayDocs(content, !options.raw);
+});
+//# sourceMappingURL=docs.js.map

package/dist/cli/commands/docs.js.map

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

package/dist/cli/commands/edit.d.ts

@@ -0,0 +1,11 @@
+/**
+ * loadout edit — Open a loadout definition in $EDITOR.
+ *
+ * Scope flags:
+ *   -l / --local   → project scope only
+ *   -g / --global  → global scope only
+ *   (none)         → auto-detect; error if name exists in both without flag
+ */
+import { Command } from "commander";
+export declare const editCommand: Command;
+//# sourceMappingURL=edit.d.ts.map

package/dist/cli/commands/edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/edit.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0BpC,eAAO,MAAM,WAAW,SA2CpB,CAAC"}

package/dist/cli/commands/edit.js

@@ -0,0 +1,71 @@
+/**
+ * loadout edit — Open a loadout definition in $EDITOR.
+ *
+ * Scope flags:
+ *   -l / --local   → project scope only
+ *   -g / --global  → global scope only
+ *   (none)         → auto-detect; error if name exists in both without flag
+ */
+import { Command } from "commander";
+import * as path from "node:path";
+import { requireScopeForName, SCOPE_FLAGS, } from "../../core/scope.js";
+import { findNearestLoadoutRoot, getGlobalRoot } from "../../core/discovery.js";
+import { fileExists } from "../../lib/fs.js";
+import { log } from "../../lib/output.js";
+import { openInEditor } from "../../lib/editor.js";
+const LOADOUTS_DIR = "loadouts";
+/**
+ * Find the loadout definition file path for a given name and scope.
+ */
+function findLoadoutPath(loadoutRoot, name) {
+    const yamlPath = path.join(loadoutRoot, LOADOUTS_DIR, `${name}.yaml`);
+    const ymlPath = path.join(loadoutRoot, LOADOUTS_DIR, `${name}.yml`);
+    if (fileExists(yamlPath))
+        return yamlPath;
+    if (fileExists(ymlPath))
+        return ymlPath;
+    return null;
+}
+export const editCommand = new Command("edit")
+    .description("Open a loadout definition in $EDITOR")
+    .argument("<name>", "Loadout name to edit")
+    .option(...SCOPE_FLAGS.local)
+    .option(...SCOPE_FLAGS.global)
+    .action(async (name, options) => {
+    const cwd = process.cwd();
+    try {
+        // Resolve scope — throws if ambiguous or not found
+        const scope = await requireScopeForName(name, options, cwd);
+        // Get the loadout root for the resolved scope
+        let loadoutRoot;
+        if (scope === "global") {
+            const globalRoot = getGlobalRoot();
+            if (!globalRoot) {
+                log.error("No global loadout found at ~/.config/loadouts");
+                process.exit(1);
+            }
+            loadoutRoot = globalRoot.path;
+        }
+        else {
+            const projectRoot = await findNearestLoadoutRoot(cwd);
+            if (!projectRoot) {
+                log.error("Not in a loadout project. Run 'loadouts init' first.");
+                process.exit(1);
+            }
+            loadoutRoot = projectRoot.path;
+        }
+        // Find the loadout definition file
+        const filePath = findLoadoutPath(loadoutRoot, name);
+        if (!filePath) {
+            log.error(`Loadout '${name}' not found in ${scope} scope.`);
+            process.exit(1);
+        }
+        // Open in editor from the loadout root directory
+        await openInEditor(filePath, { cwd: loadoutRoot });
+    }
+    catch (err) {
+        log.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=edit.js.map

package/dist/cli/commands/edit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit.js","sourceRoot":"","sources":["../../../src/cli/commands/edit.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EACL,mBAAmB,EACnB,WAAW,GAEZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,YAAY,GAAG,UAAU,CAAC;AAEhC;;GAEG;AACH,SAAS,eAAe,CAAC,WAAmB,EAAE,IAAY;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;IACtE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;IAEpE,IAAI,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC1C,IAAI,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACxC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;KAC3C,WAAW,CAAC,sCAAsC,CAAC;KACnD,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;KAC1C,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC;KAC5B,MAAM,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC;KAC7B,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,OAAmB,EAAE,EAAE;IAClD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE1B,IAAI,CAAC;QACH,mDAAmD;QACnD,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;QAE5D,8CAA8C;QAC9C,IAAI,WAAmB,CAAC;QACxB,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;YACnC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,GAAG,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;gBAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,MAAM,WAAW,GAAG,MAAM,sBAAsB,CAAC,GAAG,CAAC,CAAC;YACtD,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,GAAG,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;gBAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC;QACjC,CAAC;QAED,mCAAmC;QACnC,MAAM,QAAQ,GAAG,eAAe,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,kBAAkB,KAAK,SAAS,CAAC,CAAC;YAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,iDAAiD;QACjD,MAAM,YAAY,CAAC,QAAQ,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/cli/commands/fallback.d.ts

@@ -0,0 +1,9 @@
+/**
+ * loadout fallback — Regenerate fallback sync scripts.
+ *
+ * Updates .loadouts/sync-fallback.sh and git hooks to the latest version.
+ * Run this after upgrading loadout to get improvements to the fallback logic.
+ */
+import { Command } from "commander";
+export declare const fallbackCommand: Command;
+//# sourceMappingURL=fallback.d.ts.map

package/dist/cli/commands/fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/fallback.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,eAAO,MAAM,eAAe,SAwBxB,CAAC"}