loadouts 0.1.11

package/dist/core/schema.d.ts

@@ -0,0 +1,308 @@
+/**
+ * Zod schemas for config file validation.
+ *
+ * Tool and ArtifactKind are open strings (any registered value is valid).
+ * Runtime registry validation happens separately in the render pipeline;
+ * these schemas focus on structural correctness of config files.
+ */
+import { z } from "zod";
+export declare const ToolSchema: z.ZodString;
+export declare const ArtifactKindSchema: z.ZodString;
+export declare const OutputModeSchema: z.ZodEnum<["symlink", "copy", "generate"]>;
+export declare const SourceRefSchema: z.ZodString;
+export declare const RootConfigSchema: z.ZodObject<{
+    version: z.ZodLiteral<"1">;
+    default: z.ZodOptional<z.ZodString>;
+    mode: z.ZodOptional<z.ZodEnum<["symlink", "copy", "generate"]>>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    sources: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    version: "1";
+    default?: string | undefined;
+    mode?: "symlink" | "copy" | "generate" | undefined;
+    tools?: string[] | undefined;
+    sources?: string[] | undefined;
+}, {
+    version: "1";
+    default?: string | undefined;
+    mode?: "symlink" | "copy" | "generate" | undefined;
+    tools?: string[] | undefined;
+    sources?: string[] | undefined;
+}>;
+export declare const LoadoutIncludeSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
+    path: z.ZodString;
+    tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    tools?: string[] | undefined;
+}, {
+    path: string;
+    tools?: string[] | undefined;
+}>]>;
+export declare const LoadoutDefinitionSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    include: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        path: z.ZodString;
+        tools: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        tools?: string[] | undefined;
+    }, {
+        path: string;
+        tools?: string[] | undefined;
+    }>]>, "many">;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    include: (string | {
+        path: string;
+        tools?: string[] | undefined;
+    })[];
+    tools?: string[] | undefined;
+    description?: string | undefined;
+}, {
+    name: string;
+    include: (string | {
+        path: string;
+        tools?: string[] | undefined;
+    })[];
+    tools?: string[] | undefined;
+    description?: string | undefined;
+}>;
+export declare const ManifestEntrySchema: z.ZodObject<{
+    tools: z.ZodArray<z.ZodString, "many">;
+    kind: z.ZodString;
+    sourcePath: z.ZodString;
+    targetPath: z.ZodString;
+    mode: z.ZodEnum<["symlink", "copy", "generate"]>;
+    renderedHash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    mode: "symlink" | "copy" | "generate";
+    tools: string[];
+    kind: string;
+    sourcePath: string;
+    targetPath: string;
+    renderedHash: string;
+}, {
+    mode: "symlink" | "copy" | "generate";
+    tools: string[];
+    kind: string;
+    sourcePath: string;
+    targetPath: string;
+    renderedHash: string;
+}>;
+export declare const LegacyManifestEntrySchema: z.ZodObject<{
+    tool: z.ZodString;
+    kind: z.ZodString;
+    sourcePath: z.ZodString;
+    targetPath: z.ZodString;
+    mode: z.ZodEnum<["symlink", "copy", "generate"]>;
+    renderedHash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    mode: "symlink" | "copy" | "generate";
+    kind: string;
+    sourcePath: string;
+    targetPath: string;
+    renderedHash: string;
+    tool: string;
+}, {
+    mode: "symlink" | "copy" | "generate";
+    kind: string;
+    sourcePath: string;
+    targetPath: string;
+    renderedHash: string;
+    tool: string;
+}>;
+export declare const ShadowedEntrySchema: z.ZodObject<{
+    tool: z.ZodString;
+    kind: z.ZodString;
+    sourcePath: z.ZodString;
+    targetPath: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    kind: string;
+    sourcePath: string;
+    targetPath: string;
+    tool: string;
+}, {
+    kind: string;
+    sourcePath: string;
+    targetPath: string;
+    tool: string;
+}>;
+export declare const AppliedStateSchema: z.ZodObject<{
+    active: z.ZodArray<z.ZodString, "many">;
+    mode: z.ZodEnum<["symlink", "copy", "generate"]>;
+    appliedAt: z.ZodString;
+    entries: z.ZodArray<z.ZodObject<{
+        tools: z.ZodArray<z.ZodString, "many">;
+        kind: z.ZodString;
+        sourcePath: z.ZodString;
+        targetPath: z.ZodString;
+        mode: z.ZodEnum<["symlink", "copy", "generate"]>;
+        renderedHash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        mode: "symlink" | "copy" | "generate";
+        tools: string[];
+        kind: string;
+        sourcePath: string;
+        targetPath: string;
+        renderedHash: string;
+    }, {
+        mode: "symlink" | "copy" | "generate";
+        tools: string[];
+        kind: string;
+        sourcePath: string;
+        targetPath: string;
+        renderedHash: string;
+    }>, "many">;
+    shadowed: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        tool: z.ZodString;
+        kind: z.ZodString;
+        sourcePath: z.ZodString;
+        targetPath: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: string;
+        sourcePath: string;
+        targetPath: string;
+        tool: string;
+    }, {
+        kind: string;
+        sourcePath: string;
+        targetPath: string;
+        tool: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    entries: {
+        mode: "symlink" | "copy" | "generate";
+        tools: string[];
+        kind: string;
+        sourcePath: string;
+        targetPath: string;
+        renderedHash: string;
+    }[];
+    mode: "symlink" | "copy" | "generate";
+    active: string[];
+    appliedAt: string;
+    shadowed: {
+        kind: string;
+        sourcePath: string;
+        targetPath: string;
+        tool: string;
+    }[];
+}, {
+    entries: {
+        mode: "symlink" | "copy" | "generate";
+        tools: string[];
+        kind: string;
+        sourcePath: string;
+        targetPath: string;
+        renderedHash: string;
+    }[];
+    mode: "symlink" | "copy" | "generate";
+    active: string[];
+    appliedAt: string;
+    shadowed?: {
+        kind: string;
+        sourcePath: string;
+        targetPath: string;
+        tool: string;
+    }[] | undefined;
+}>;
+export declare const LegacyAppliedStateSchema: z.ZodObject<{
+    loadout: z.ZodString;
+    mode: z.ZodEnum<["symlink", "copy", "generate"]>;
+    appliedAt: z.ZodString;
+    entries: z.ZodArray<z.ZodObject<{
+        tool: z.ZodString;
+        kind: z.ZodString;
+        sourcePath: z.ZodString;
+        targetPath: z.ZodString;
+        mode: z.ZodEnum<["symlink", "copy", "generate"]>;
+        renderedHash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        mode: "symlink" | "copy" | "generate";
+        kind: string;
+        sourcePath: string;
+        targetPath: string;
+        renderedHash: string;
+        tool: string;
+    }, {
+        mode: "symlink" | "copy" | "generate";
+        kind: string;
+        sourcePath: string;
+        targetPath: string;
+        renderedHash: string;
+        tool: string;
+    }>, "many">;
+    shadowed: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        tool: z.ZodString;
+        kind: z.ZodString;
+        sourcePath: z.ZodString;
+        targetPath: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        kind: string;
+        sourcePath: string;
+        targetPath: string;
+        tool: string;
+    }, {
+        kind: string;
+        sourcePath: string;
+        targetPath: string;
+        tool: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    entries: {
+        mode: "symlink" | "copy" | "generate";
+        kind: string;
+        sourcePath: string;
+        targetPath: string;
+        renderedHash: string;
+        tool: string;
+    }[];
+    mode: "symlink" | "copy" | "generate";
+    appliedAt: string;
+    shadowed: {
+        kind: string;
+        sourcePath: string;
+        targetPath: string;
+        tool: string;
+    }[];
+    loadout: string;
+}, {
+    entries: {
+        mode: "symlink" | "copy" | "generate";
+        kind: string;
+        sourcePath: string;
+        targetPath: string;
+        renderedHash: string;
+        tool: string;
+    }[];
+    mode: "symlink" | "copy" | "generate";
+    appliedAt: string;
+    loadout: string;
+    shadowed?: {
+        kind: string;
+        sourcePath: string;
+        targetPath: string;
+        tool: string;
+    }[] | undefined;
+}>;
+export declare const RuleFrontmatterSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    paths: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    globs: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    alwaysApply: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    description?: string | undefined;
+    paths?: string[] | undefined;
+    globs?: string[] | undefined;
+    alwaysApply?: boolean | undefined;
+}, {
+    description?: string | undefined;
+    paths?: string[] | undefined;
+    globs?: string[] | undefined;
+    alwaysApply?: boolean | undefined;
+}>;
+export type RuleFrontmatter = z.infer<typeof RuleFrontmatterSchema>;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,UAAU,aAAoB,CAAC;AAC5C,eAAO,MAAM,kBAAkB,aAAoB,CAAC;AAEpD,eAAO,MAAM,gBAAgB,4CAA0C,CAAC;AAGxE,eAAO,MAAM,eAAe,aAAa,CAAC;AAE1C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;EAM3B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;IAM/B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAKlC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;EAO9B,CAAC;AAGH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;EAOpC,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;EAK9B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM7B,CAAC;AAGH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAMnC,CAAC;AAGH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/core/schema.js

@@ -0,0 +1,81 @@
+/**
+ * Zod schemas for config file validation.
+ *
+ * Tool and ArtifactKind are open strings (any registered value is valid).
+ * Runtime registry validation happens separately in the render pipeline;
+ * these schemas focus on structural correctness of config files.
+ */
+import { z } from "zod";
+// Tool and kind are open strings — new tools/kinds registered via plugins
+// are automatically accepted without schema changes.
+export const ToolSchema = z.string().min(1);
+export const ArtifactKindSchema = z.string().min(1);
+export const OutputModeSchema = z.enum(["symlink", "copy", "generate"]);
+// Source reference — path to another .loadouts/ directory
+export const SourceRefSchema = z.string();
+export const RootConfigSchema = z.object({
+    version: z.literal("1"),
+    default: z.string().optional(),
+    mode: OutputModeSchema.optional(),
+    tools: z.array(ToolSchema).optional(),
+    sources: z.array(SourceRefSchema).optional(),
+});
+export const LoadoutIncludeSchema = z.union([
+    z.string(),
+    z.object({
+        path: z.string(),
+        tools: z.array(ToolSchema).optional(),
+    }),
+]);
+export const LoadoutDefinitionSchema = z.object({
+    name: z.string(),
+    description: z.string().optional(),
+    tools: z.array(ToolSchema).optional(),
+    include: z.array(LoadoutIncludeSchema),
+});
+export const ManifestEntrySchema = z.object({
+    tools: z.array(ToolSchema),
+    kind: ArtifactKindSchema,
+    sourcePath: z.string(),
+    targetPath: z.string(),
+    mode: OutputModeSchema,
+    renderedHash: z.string(),
+});
+// Legacy schema for single-tool entries (pre-multi-tool format)
+export const LegacyManifestEntrySchema = z.object({
+    tool: ToolSchema,
+    kind: ArtifactKindSchema,
+    sourcePath: z.string(),
+    targetPath: z.string(),
+    mode: OutputModeSchema,
+    renderedHash: z.string(),
+});
+export const ShadowedEntrySchema = z.object({
+    tool: ToolSchema,
+    kind: ArtifactKindSchema,
+    sourcePath: z.string(),
+    targetPath: z.string(),
+});
+export const AppliedStateSchema = z.object({
+    active: z.array(z.string()), // Set of active loadout names
+    mode: OutputModeSchema,
+    appliedAt: z.string(),
+    entries: z.array(ManifestEntrySchema),
+    shadowed: z.array(ShadowedEntrySchema).default([]),
+});
+// Legacy schema for migration from single-loadout format
+export const LegacyAppliedStateSchema = z.object({
+    loadout: z.string(),
+    mode: OutputModeSchema,
+    appliedAt: z.string(),
+    entries: z.array(LegacyManifestEntrySchema),
+    shadowed: z.array(ShadowedEntrySchema).default([]),
+});
+// Rule frontmatter
+export const RuleFrontmatterSchema = z.object({
+    description: z.string().optional(),
+    paths: z.array(z.string()).optional(),
+    globs: z.array(z.string()).optional(),
+    alwaysApply: z.boolean().optional(),
+});
+//# sourceMappingURL=schema.js.map

package/dist/core/schema.js.map

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

package/dist/core/scope.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Unified scope resolution for all commands.
+ *
+ * Scope flags:
+ *   -l / --local   → project scope only (error if not in a project)
+ *   -g / --global  → global scope only
+ *   -a / --all     → both scopes
+ *   (none)         → both scopes (show everything by default)
+ *
+ * For commands that target a specific loadout by name, collision detection
+ * requires explicit scope when the same name exists in both scopes.
+ */
+import type { Scope, CommandContext } from "./types.js";
+export interface ScopeFlags {
+    local?: boolean;
+    global?: boolean;
+    all?: boolean;
+}
+export interface ScopeResolution {
+    scopes: Scope[];
+    contexts: CommandContext[];
+}
+/**
+ * Check if we're currently in a loadout project.
+ * Returns true only if there's a project-level .loadouts/ directory
+ * (not just global or bundled).
+ */
+export declare function inProject(cwd?: string): Promise<boolean>;
+/**
+ * Check if a global loadout root exists.
+ */
+export declare function hasGlobal(): boolean;
+/**
+ * Resolve scope flags to a list of scopes.
+ * Default (no flags) = all available scopes.
+ */
+export declare function resolveScopes(flags: ScopeFlags, cwd?: string): Promise<Scope[]>;
+/**
+ * Resolve scope flags to CommandContexts.
+ */
+export declare function resolveContexts(flags: ScopeFlags, cwd?: string): Promise<ScopeResolution>;
+/**
+ * Check if a loadout name exists in a given scope.
+ */
+export declare function loadoutExistsInScope(name: string, scope: Scope): boolean;
+/**
+ * Detect if a loadout name exists in multiple scopes (collision).
+ * Returns the scopes where it exists.
+ *
+ * Note: Bundled loadouts are available in both scopes, but we treat them
+ * as "project" scope for resolution purposes when in a project, else "global".
+ */
+export declare function detectCollision(name: string, cwd?: string): Promise<Scope[]>;
+/**
+ * Require explicit scope when a loadout name exists in both scopes.
+ * Throws if ambiguous; returns the single scope to use if unambiguous.
+ */
+export declare function requireScopeForName(name: string, flags: ScopeFlags, cwd?: string): Promise<Scope>;
+/**
+ * For commands that operate on multiple loadouts (activate, deactivate),
+ * validate that all names resolve unambiguously given the scope flags.
+ *
+ * Returns a map of name -> scope for each loadout.
+ */
+export declare function resolveLoadoutScopes(names: string[], flags: ScopeFlags, cwd?: string): Promise<Map<string, Scope>>;
+/**
+ * Standard scope flag definitions for Commander.
+ */
+export declare const SCOPE_FLAGS: {
+    local: readonly ["-l, --local", "Project scope only"];
+    global: readonly ["-g, --global", "Global scope only"];
+    all: readonly ["-a, --all", "All scopes"];
+};
+//# sourceMappingURL=scope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../../src/core/scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,OAAO,CAAC,CAK7E;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,UAAU,EACjB,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,KAAK,EAAE,CAAC,CAgClB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,UAAU,EACjB,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAS1B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAUxE;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,KAAK,EAAE,CAAC,CAqClB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,EACjB,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,KAAK,CAAC,CAoBhB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,EAAE,EACf,KAAK,EAAE,UAAU,EACjB,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAS7B;AAED;;GAEG;AACH,eAAO,MAAM,WAAW;;;;CAIvB,CAAC"}

package/dist/core/scope.js

@@ -0,0 +1,176 @@
+/**
+ * Unified scope resolution for all commands.
+ *
+ * Scope flags:
+ *   -l / --local   → project scope only (error if not in a project)
+ *   -g / --global  → global scope only
+ *   -a / --all     → both scopes
+ *   (none)         → both scopes (show everything by default)
+ *
+ * For commands that target a specific loadout by name, collision detection
+ * requires explicit scope when the same name exists in both scopes.
+ */
+import { getContext, findNearestLoadoutRoot, getGlobalRoot, getBundledRoot } from "./discovery.js";
+import { isProjectScope } from "../lib/artifact-paths.js";
+import { listLoadouts } from "./config.js";
+/**
+ * Check if we're currently in a loadout project.
+ * Returns true only if there's a project-level .loadouts/ directory
+ * (not just global or bundled).
+ */
+export async function inProject(cwd = process.cwd()) {
+    const root = await findNearestLoadoutRoot(cwd);
+    // Only count as "in project" if we found a project-level root
+    // (global and bundled roots don't count)
+    return root !== null && isProjectScope(root.level);
+}
+/**
+ * Check if a global loadout root exists.
+ */
+export function hasGlobal() {
+    return getGlobalRoot() !== null;
+}
+/**
+ * Resolve scope flags to a list of scopes.
+ * Default (no flags) = all available scopes.
+ */
+export async function resolveScopes(flags, cwd = process.cwd()) {
+    const hasProject = await inProject(cwd);
+    const hasGlobalRoot = hasGlobal();
+    // Explicit --local
+    if (flags.local) {
+        if (!hasProject) {
+            throw new Error("Not in a loadout project. Run 'loadouts init' first.");
+        }
+        return ["project"];
+    }
+    // Explicit --global
+    if (flags.global) {
+        if (!hasGlobalRoot) {
+            throw new Error("No global loadout found at ~/.config/loadouts");
+        }
+        return ["global"];
+    }
+    // Explicit --all, or default (no flags) = everything available
+    const scopes = [];
+    if (hasProject)
+        scopes.push("project");
+    if (hasGlobalRoot)
+        scopes.push("global");
+    if (scopes.length === 0) {
+        throw new Error("No loadout found. Run 'loadouts init' or 'loadouts init --global'.");
+    }
+    return scopes;
+}
+/**
+ * Resolve scope flags to CommandContexts.
+ */
+export async function resolveContexts(flags, cwd = process.cwd()) {
+    const scopes = await resolveScopes(flags, cwd);
+    const contexts = [];
+    for (const scope of scopes) {
+        contexts.push(await getContext(scope, cwd));
+    }
+    return { scopes, contexts };
+}
+/**
+ * Check if a loadout name exists in a given scope.
+ */
+export function loadoutExistsInScope(name, scope) {
+    if (scope === "global") {
+        const globalRoot = getGlobalRoot();
+        if (!globalRoot)
+            return false;
+        return listLoadouts(globalRoot.path).includes(name);
+    }
+    else {
+        // For project scope, we need to check synchronously
+        // This is a simplified check - full resolution happens in commands
+        return true; // Let the command handle the actual check
+    }
+}
+/**
+ * Detect if a loadout name exists in multiple scopes (collision).
+ * Returns the scopes where it exists.
+ *
+ * Note: Bundled loadouts are available in both scopes, but we treat them
+ * as "project" scope for resolution purposes when in a project, else "global".
+ */
+export async function detectCollision(name, cwd = process.cwd()) {
+    const found = [];
+    const hasProjectRoot = await inProject(cwd);
+    // Check project scope
+    if (hasProjectRoot) {
+        const projectRoot = await findNearestLoadoutRoot(cwd);
+        if (projectRoot) {
+            const projectLoadouts = listLoadouts(projectRoot.path);
+            if (projectLoadouts.includes(name)) {
+                found.push("project");
+            }
+        }
+    }
+    // Check global scope
+    const globalRoot = getGlobalRoot();
+    if (globalRoot) {
+        const globalLoadouts = listLoadouts(globalRoot.path);
+        if (globalLoadouts.includes(name)) {
+            found.push("global");
+        }
+    }
+    // Check bundled root - bundled loadouts are always global scope
+    // (they're tools that ship with loadout, not project-specific)
+    if (found.length === 0) {
+        const bundledRoot = getBundledRoot();
+        if (bundledRoot) {
+            const bundledLoadouts = listLoadouts(bundledRoot.path);
+            if (bundledLoadouts.includes(name)) {
+                found.push("global");
+            }
+        }
+    }
+    return found;
+}
+/**
+ * Require explicit scope when a loadout name exists in both scopes.
+ * Throws if ambiguous; returns the single scope to use if unambiguous.
+ */
+export async function requireScopeForName(name, flags, cwd = process.cwd()) {
+    // If explicit scope given, use it
+    if (flags.local)
+        return "project";
+    if (flags.global)
+        return "global";
+    // Check for collision
+    const collision = await detectCollision(name, cwd);
+    if (collision.length > 1) {
+        throw new Error(`Loadout '${name}' exists in both project and global scope. ` +
+            `Use -l/--local or -g/--global to specify which one.`);
+    }
+    if (collision.length === 0) {
+        throw new Error(`Loadout '${name}' not found in any scope.`);
+    }
+    return collision[0];
+}
+/**
+ * For commands that operate on multiple loadouts (activate, deactivate),
+ * validate that all names resolve unambiguously given the scope flags.
+ *
+ * Returns a map of name -> scope for each loadout.
+ */
+export async function resolveLoadoutScopes(names, flags, cwd = process.cwd()) {
+    const result = new Map();
+    for (const name of names) {
+        const scope = await requireScopeForName(name, flags, cwd);
+        result.set(name, scope);
+    }
+    return result;
+}
+/**
+ * Standard scope flag definitions for Commander.
+ */
+export const SCOPE_FLAGS = {
+    local: ["-l, --local", "Project scope only"],
+    global: ["-g, --global", "Global scope only"],
+    all: ["-a, --all", "All scopes"],
+};
+//# sourceMappingURL=scope.js.map

package/dist/core/scope.js.map

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