@ai-outfitter/outfitter 0.3.0

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

@@ -0,0 +1,54 @@
+import type { CommandObject } from './CommandObject.js';
+export type WelcomeDefaultProfileRoleId = 'engineer' | 'data_analyst';
+export type WelcomeLoadoutItemKind = 'extension' | 'package';
+export interface WelcomeCommandInput {
+    readonly homeDirectory: string;
+    readonly projectDirectory: string;
+}
+export interface WelcomeRoleChoice {
+    readonly id: WelcomeDefaultProfileRoleId;
+    readonly label: string;
+}
+export interface WelcomeLoadoutItem {
+    readonly id: string;
+    readonly label: string;
+    readonly kind: WelcomeLoadoutItemKind;
+    readonly source: string;
+}
+export interface WelcomeLoadout {
+    readonly id: string;
+    readonly label: string;
+    readonly items: readonly WelcomeLoadoutItem[];
+}
+export interface WelcomeLoadoutSelection {
+    readonly id: string;
+    readonly label: string;
+    readonly selectedItems: readonly WelcomeLoadoutItem[];
+}
+export interface WelcomePlan {
+    readonly answerQuestions: boolean;
+    readonly selectedRoleId?: string;
+    readonly loadoutItemIds?: readonly string[];
+}
+export interface WelcomeCommandResult {
+    readonly answered: boolean;
+    readonly selectedRole?: WelcomeRoleChoice;
+    readonly selectedLoadout?: WelcomeLoadoutSelection;
+    readonly warnings: readonly string[];
+    readonly messages: readonly string[];
+}
+export interface WelcomeCommandDependencies {
+    readonly homeDirectory?: string;
+    readonly projectDirectory?: string;
+    readonly input?: {
+        readonly isTTY?: boolean;
+    } & NodeJS.ReadableStream;
+    readonly output?: {
+        readonly isTTY?: boolean;
+    } & NodeJS.WritableStream;
+    readonly interactive?: boolean;
+    readonly writeLine?: (message: string) => void;
+    readonly selectWelcomePlan?: (input: WelcomeCommandInput) => Promise<WelcomePlan>;
+}
+export declare const executeWelcomeCommand: (input: WelcomeCommandInput, dependencies?: WelcomeCommandDependencies) => Promise<WelcomeCommandResult>;
+export declare const createWelcomeCommand: (dependencies?: WelcomeCommandDependencies) => CommandObject;

package/dist/cli/commands/WelcomeCommand.js

@@ -0,0 +1,214 @@
+// Provides the command object for first-run Outfitter welcome onboarding.
+import { createInterface } from 'node:readline/promises';
+import { homedir } from 'node:os';
+const welcomeIntroLines = [
+    String.raw `    _                _        ____  _`,
+    String.raw `   / \   _ __  _ __ | | ___  |  _ \(_)`,
+    String.raw `  / _ \ | '_ \| '_ \| |/ _ \ | |_) | |`,
+    String.raw ` / ___ \| |_) | |_) | |  __/ |  __/| |`,
+    String.raw `/_/   \_\ .__/| .__/|_|\___| |_|   |_|`,
+    String.raw `        |_|   |_|`,
+    '',
+    'Welcome to Outfitter.',
+    'Pi is a heavily customizable coding harness. The next few questions will configure Outfitter to best suit your workflow.',
+];
+const defaultProfileRoleChoices = [
+    { id: 'engineer', label: 'Engineer' },
+    { id: 'data_analyst', label: 'Data Analyst' },
+];
+const fallbackRoleId = 'engineer';
+const recommendedPiLoadout = {
+    id: 'recommended-pi',
+    label: 'Recommended Pi productivity loadout',
+    items: [
+        {
+            id: 'ulta-tasklist',
+            label: 'Ulta Tasklist',
+            kind: 'extension',
+            source: 'git:github.com/ai-outfitter/ulta-tasklist',
+        },
+        {
+            id: 'deepwork',
+            label: 'DeepWork',
+            kind: 'extension',
+            source: 'git:github.com/ai-outfitter/deepwork',
+        },
+        {
+            id: 'pi-subagents',
+            label: 'Pi Subagents',
+            kind: 'package',
+            source: 'npm:pi-subagents',
+        },
+        {
+            id: 'pi-mcp-adapter',
+            label: 'Pi MCP Adapter',
+            kind: 'package',
+            source: 'npm:pi-mcp-adapter',
+        },
+    ],
+};
+export const executeWelcomeCommand = async (input, dependencies = {}) => {
+    requireInteractiveTerminalIfNeeded(dependencies);
+    const plan = await selectWelcomePlan(input, dependencies);
+    if (!plan.answerQuestions) {
+        return {
+            answered: false,
+            warnings: [],
+            messages: ['Skipped Outfitter welcome questions. Run `outfitter welcome` any time to revisit them.'],
+        };
+    }
+    const roleResolution = resolveSelectedRole(plan.selectedRoleId);
+    const loadoutResolution = resolveSelectedLoadout(plan.loadoutItemIds);
+    const warnings = [...roleResolution.warnings, ...loadoutResolution.warnings];
+    return {
+        answered: true,
+        selectedRole: roleResolution.role,
+        selectedLoadout: loadoutResolution.loadout,
+        warnings,
+        messages: buildWelcomeMessages(roleResolution.role, loadoutResolution.loadout, warnings),
+    };
+};
+export const createWelcomeCommand = (dependencies = {}) => {
+    const command = {
+        name: 'welcome',
+        description: 'Run Outfitter welcome onboarding prompts.',
+        register(program) {
+            program
+                .command(command.name)
+                .description(command.description)
+                .action(async () => {
+                const result = await executeWelcomeCommand({
+                    /* v8 ignore next -- default process home is exercised by the direct CLI entrypoint, not unit tests. */
+                    homeDirectory: dependencies.homeDirectory ?? homedir(),
+                    /* v8 ignore next -- default process cwd is exercised by the direct CLI entrypoint, not unit tests. */
+                    projectDirectory: dependencies.projectDirectory ?? process.cwd(),
+                }, { ...dependencies, interactive: true });
+                for (const message of result.messages) {
+                    /* v8 ignore next -- console fallback is direct CLI behavior; tests inject a writer. */
+                    (dependencies.writeLine ?? console.log)(message);
+                }
+            });
+        },
+    };
+    return command;
+};
+const selectWelcomePlan = async (input, dependencies) => {
+    if (dependencies.selectWelcomePlan !== undefined) {
+        return dependencies.selectWelcomePlan(input);
+    }
+    return promptForWelcomePlan(dependencies);
+};
+const promptForWelcomePlan = async (dependencies) => {
+    /* v8 ignore next -- default process streams are direct terminal behavior; tests inject streams. */
+    const output = dependencies.output ?? process.stdout;
+    /* v8 ignore next -- default process streams are direct terminal behavior; tests inject streams. */
+    const readline = createInterface({ input: dependencies.input ?? process.stdin, output });
+    try {
+        output.write(`\n${welcomeIntroLines.join('\n')}\n`);
+        const answerQuestions = await promptForYesNo(readline, 'Choose a role and recommended Pi loadout now? [Y/n]: ', true);
+        if (!answerQuestions) {
+            return { answerQuestions: false };
+        }
+        const selectedRoleId = await promptForRole(readline, output);
+        const loadoutItemIds = await promptForLoadout(readline, output);
+        return { answerQuestions: true, selectedRoleId, loadoutItemIds };
+    }
+    finally {
+        readline.close();
+    }
+};
+const promptForYesNo = async (readline, query, defaultValue) => {
+    const answer = (await readline.question(query)).trim().toLowerCase();
+    if (answer === '') {
+        return defaultValue;
+    }
+    return ['y', 'yes'].includes(answer);
+};
+const promptForRole = async (readline, output) => {
+    output.write('\nChoose your initial Outfitter role/profile:\n');
+    defaultProfileRoleChoices.forEach((role, index) => output.write(`${index + 1}. ${role.id} - ${role.label}\n`));
+    return defaultProfileRoleChoices[await promptForSelectionIndex(readline, 'Role [1]: ', 0)]?.id ?? fallbackRoleId;
+};
+const promptForLoadout = async (readline, output) => {
+    output.write(`\n${recommendedPiLoadout.label}:\n`);
+    recommendedPiLoadout.items.forEach((item, index) => {
+        output.write(`${index + 1}. ${item.label} (${item.kind}) - ${item.source}\n`);
+    });
+    const mode = (await readline.question('Install recommended loadout? [Y=all/c=choose/n=skip]: ')).trim().toLowerCase();
+    if (['n', 'no', 'skip'].includes(mode)) {
+        return [];
+    }
+    if (!['c', 'choose', 'custom', 's', 'select'].includes(mode)) {
+        return recommendedPiLoadout.items.map((item) => item.id);
+    }
+    const answer = (await readline.question('Loadout items [1,2,3,4 or blank for all]: ')).trim();
+    if (answer === '') {
+        return recommendedPiLoadout.items.map((item) => item.id);
+    }
+    return answer
+        .split(',')
+        .map((part) => Number.parseInt(part.trim(), 10) - 1)
+        .filter((index) => index >= 0 && index < recommendedPiLoadout.items.length)
+        .map((index) => recommendedPiLoadout.items[index].id);
+};
+const promptForSelectionIndex = async (readline, query, defaultIndex) => {
+    const answer = (await readline.question(query)).trim();
+    if (answer === '') {
+        return defaultIndex;
+    }
+    return Math.max(Number.parseInt(answer, 10) - 1, 0);
+};
+const resolveSelectedRole = (selectedRoleId) => {
+    const roleId = selectedRoleId ?? fallbackRoleId;
+    const selectedRole = defaultProfileRoleChoices.find((role) => role.id === roleId);
+    if (selectedRole !== undefined) {
+        return { role: selectedRole, warnings: [] };
+    }
+    return {
+        role: defaultProfileRoleChoices.find((role) => role.id === fallbackRoleId),
+        warnings: [`Welcome role '${roleId}' is not available; using fallback role '${fallbackRoleId}'.`],
+    };
+};
+const resolveSelectedLoadout = (loadoutItemIds) => {
+    const selectedItemIds = loadoutItemIds ?? recommendedPiLoadout.items.map((item) => item.id);
+    const availableItems = new Map(recommendedPiLoadout.items.map((item) => [item.id, item]));
+    const selectedItems = [];
+    const warnings = [];
+    for (const itemId of selectedItemIds) {
+        const item = availableItems.get(itemId);
+        if (item === undefined) {
+            warnings.push(`Loadout item '${itemId}' is not available for ${recommendedPiLoadout.id}; skipping it.`);
+            continue;
+        }
+        if (selectedItems.every((selectedItem) => selectedItem.id !== item.id)) {
+            selectedItems.push(item);
+        }
+    }
+    return {
+        loadout: { id: recommendedPiLoadout.id, label: recommendedPiLoadout.label, selectedItems },
+        warnings,
+    };
+};
+const buildWelcomeMessages = (selectedRole, selectedLoadout, warnings) => {
+    const loadoutMessage = selectedLoadout.selectedItems.length === 0
+        ? `Skipped ${selectedLoadout.label}.`
+        : `Selected ${selectedLoadout.label}: ${selectedLoadout.selectedItems.map((item) => item.source).join(', ')}.`;
+    return [
+        `Selected Outfitter role: ${selectedRole.id} (${selectedRole.label}).`,
+        loadoutMessage,
+        ...warnings.map((warning) => `Warning: ${warning}`),
+    ];
+};
+const requireInteractiveTerminalIfNeeded = (dependencies) => {
+    if (dependencies.interactive !== true) {
+        return;
+    }
+    /* v8 ignore next -- default process streams are direct terminal behavior; tests inject streams. */
+    const inputIsTty = (dependencies.input ?? process.stdin).isTTY === true;
+    /* v8 ignore next -- default process streams are direct terminal behavior; tests inject streams. */
+    const outputIsTty = (dependencies.output ?? process.stdout).isTTY === true;
+    if (!inputIsTty || !outputIsTty) {
+        throw new Error('`outfitter welcome` requires an interactive TTY on both stdin and stdout.');
+    }
+};
+//# sourceMappingURL=WelcomeCommand.js.map

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

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

package/dist/cli/commands/profile/Command.d.ts

@@ -0,0 +1,6 @@
+import type { CommandObject } from '../CommandObject.js';
+import type { ProfileCommandDependencies } from './Shared.js';
+export declare const createProfileCommands: (dependencies?: ProfileCommandDependencies) => CommandObject[];
+export declare const createProfileCommand: () => CommandObject;
+export { executeCreateProfileCommand } from './CreateCommand.js';
+export { executeListProfilesCommand } from './ListCommand.js';

package/dist/cli/commands/profile/Command.js

@@ -0,0 +1,21 @@
+import { createProfileCreateCommand } from './CreateCommand.js';
+import { createProfileListCommand } from './ListCommand.js';
+import { getOrCreateProfileCommander, profileCommandDescription, profileCommandName } from './Shared.js';
+export const createProfileCommands = (dependencies = {}) => [
+    createProfileCommand(),
+    createProfileListCommand(dependencies),
+    createProfileCreateCommand(dependencies),
+];
+export const createProfileCommand = () => {
+    const command = {
+        name: profileCommandName,
+        description: profileCommandDescription,
+        register(program) {
+            getOrCreateProfileCommander(program);
+        },
+    };
+    return command;
+};
+export { executeCreateProfileCommand } from './CreateCommand.js';
+export { executeListProfilesCommand } from './ListCommand.js';
+//# sourceMappingURL=Command.js.map

package/dist/cli/commands/profile/Command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Command.js","sourceRoot":"","sources":["../../../../src/cli/commands/profile/Command.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,2BAA2B,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEzG,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,eAA2C,EAAE,EAAmB,EAAE,CAAC;IACvG,oBAAoB,EAAE;IACtB,wBAAwB,CAAC,YAAY,CAAC;IACtC,0BAA0B,CAAC,YAAY,CAAC;CACzC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAkB,EAAE;IACtD,MAAM,OAAO,GAAkB;QAC7B,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,yBAAyB;QACtC,QAAQ,CAAC,OAAgB;YACvB,2BAA2B,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;KACF,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/cli/commands/profile/CreateCommand.d.ts

@@ -0,0 +1,19 @@
+import type { CommandObject } from '../CommandObject.js';
+import type { ProfileCommandDependencies } from './Shared.js';
+export type CreateProfileScope = 'user' | 'project' | 'project-local';
+export interface CreateProfileInput {
+    readonly name: string;
+    readonly scope?: CreateProfileScope;
+    readonly path?: string;
+    readonly homeDirectory: string;
+    readonly projectDirectory: string;
+}
+export interface CreateProfileResult {
+    readonly profileDirectory: string;
+    readonly profilePath: string;
+    readonly createdDirectories: readonly string[];
+    readonly createdProfile: boolean;
+    readonly messages: readonly string[];
+}
+export declare const createProfileCreateCommand: (dependencies: ProfileCommandDependencies) => CommandObject;
+export declare const executeCreateProfileCommand: (input: CreateProfileInput) => CreateProfileResult;

package/dist/cli/commands/profile/CreateCommand.js

@@ -0,0 +1,115 @@
+// Provides the profile create subcommand and profile skeleton creation behavior.
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { Command } from 'commander';
+import { isValidProfileId } from '../../../profiles/ProfileLoader.js';
+import { getOrCreateProfileCommander } from './Shared.js';
+export const createProfileCreateCommand = (dependencies) => {
+    const command = {
+        name: 'profile create',
+        description: 'Create a new Outfitter profile skeleton.',
+        register(program) {
+            getOrCreateProfileCommander(program).addCommand(createProfileCreateCommander(dependencies));
+        },
+    };
+    return command;
+};
+const createProfileCreateCommander = (dependencies) => new Command('create')
+    .description('Create a new Outfitter profile skeleton.')
+    .argument('<name>', 'filesystem-safe profile name')
+    .option('--scope <scope>', 'destination scope: user, project, or project-local')
+    .option('--path <path>', 'destination profile source directory')
+    .action((name, options) => {
+    const result = executeCreateProfileCommand({
+        name,
+        scope: readCreateProfileScope(options.scope),
+        path: options.path,
+        /* v8 ignore next -- default process home is exercised by the direct CLI entrypoint, not unit tests. */
+        homeDirectory: dependencies.homeDirectory ?? homedir(),
+        /* v8 ignore next -- default process cwd is exercised by the direct CLI entrypoint, not unit tests. */
+        projectDirectory: dependencies.projectDirectory ?? process.cwd(),
+    });
+    emitMessages(result.messages, dependencies.writeLine);
+});
+export const executeCreateProfileCommand = (input) => {
+    assertValidCreateProfileInput(input);
+    const profileRoot = resolveProfileRoot(input);
+    const profileDirectory = join(profileRoot, input.name);
+    const profilePath = join(profileDirectory, 'profile.yml');
+    const resourceDirectories = [
+        'prompts',
+        'skills',
+        'extensions',
+        join('cli_specific', 'pi'),
+        join('cli_specific', 'claude'),
+    ].map((resourcePath) => join(profileDirectory, resourcePath));
+    const createdDirectories = [];
+    if (!existsSync(profileDirectory)) {
+        mkdirSync(profileDirectory, { recursive: true });
+        createdDirectories.push(profileDirectory);
+    }
+    for (const resourceDirectory of resourceDirectories) {
+        if (!existsSync(resourceDirectory)) {
+            mkdirSync(resourceDirectory, { recursive: true });
+            createdDirectories.push(resourceDirectory);
+        }
+    }
+    const createdProfile = !existsSync(profilePath);
+    if (createdProfile) {
+        writeFileSync(profilePath, createPlaceholderProfileYaml(input.name));
+    }
+    return {
+        profileDirectory,
+        profilePath,
+        createdDirectories,
+        createdProfile,
+        messages: [
+            createdProfile
+                ? `Created profile '${input.name}' at ${profileDirectory}.`
+                : `Profile '${input.name}' already exists at ${profileDirectory}; left profile.yml unchanged.`,
+        ],
+    };
+};
+const emitMessages = (messages, writeLine) => {
+    for (const message of messages) {
+        /* v8 ignore next -- console fallback is direct CLI behavior; tests inject a writer. */
+        (writeLine ?? console.log)(message);
+    }
+};
+const assertValidCreateProfileInput = (input) => {
+    if (!isValidProfileId(input.name)) {
+        throw new Error(`Profile name '${input.name}' is not a filesystem-safe Outfitter profile id.`);
+    }
+    if ((input.scope === undefined && input.path === undefined) ||
+        (input.scope !== undefined && input.path !== undefined)) {
+        throw new Error('Create profile requires exactly one destination: --scope or --path.');
+    }
+};
+const resolveProfileRoot = (input) => {
+    if (input.path !== undefined) {
+        return input.path;
+    }
+    switch (input.scope) {
+        case 'user':
+            return join(input.homeDirectory, '.outfitter', 'profiles');
+        case 'project':
+            return join(input.projectDirectory, '.outfitter', 'profiles');
+        case 'project-local':
+            return join(input.projectDirectory, '.outfitter', 'local', 'profiles');
+        /* v8 ignore next 2 -- assertValidCreateProfileInput rejects missing scopes before this exhaustive guard. */
+        default:
+            throw new Error('Create profile requires exactly one destination: --scope or --path.');
+    }
+};
+const createPlaceholderProfileYaml = (profileId) => `id: ${profileId}\nlabel: ${profileId}\ncontrols: {}\n`;
+const readCreateProfileScope = (scope) => {
+    if (scope === undefined) {
+        return undefined;
+    }
+    if (scope === 'user' || scope === 'project' || scope === 'project-local') {
+        return scope;
+    }
+    throw new Error(`Unknown profile scope '${scope}'. Expected user, project, or project-local.`);
+};
+//# sourceMappingURL=CreateCommand.js.map

package/dist/cli/commands/profile/CreateCommand.js.map

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

package/dist/cli/commands/profile/ListCommand.d.ts

@@ -0,0 +1,17 @@
+import type { CommandObject } from '../CommandObject.js';
+import type { ProfileCommandDependencies } from './Shared.js';
+export interface ListedProfile {
+    readonly id: string;
+    readonly label?: string;
+    readonly profilePath: string;
+}
+export interface ListProfilesInput {
+    readonly homeDirectory: string;
+    readonly projectDirectory: string;
+}
+export interface ListProfilesResult {
+    readonly profiles: readonly ListedProfile[];
+    readonly messages: readonly string[];
+}
+export declare const createProfileListCommand: (dependencies: ProfileCommandDependencies) => CommandObject;
+export declare const executeListProfilesCommand: (input: ListProfilesInput) => ListProfilesResult;

package/dist/cli/commands/profile/ListCommand.js

@@ -0,0 +1,85 @@
+// Provides the profile list subcommand and profile discovery behavior.
+import { homedir } from 'node:os';
+import { Command } from 'commander';
+import { createProfileSourceCachePath, createRemoteRepositoryCachePath, resolveRemoteRepositorySubpath, } from '../../../profiles/ProfileCache.js';
+import { loadLocalProfileSource } from '../../../profiles/ProfileLoader.js';
+import { loadSettingsWithCachedRemoteSettings } from '../../../settings/SettingsLoader.js';
+import { getOrCreateProfileCommander } from './Shared.js';
+export const createProfileListCommand = (dependencies) => {
+    const command = {
+        name: 'profile list',
+        description: 'List available Outfitter profiles.',
+        register(program) {
+            getOrCreateProfileCommander(program).addCommand(createProfileListCommander(dependencies));
+        },
+    };
+    return command;
+};
+const createProfileListCommander = (dependencies) => new Command('list').description('List available Outfitter profiles.').action(() => {
+    const result = executeListProfilesCommand({
+        /* v8 ignore next -- default process home is exercised by the direct CLI entrypoint, not unit tests. */
+        homeDirectory: dependencies.homeDirectory ?? homedir(),
+        /* v8 ignore next -- default process cwd is exercised by the direct CLI entrypoint, not unit tests. */
+        projectDirectory: dependencies.projectDirectory ?? process.cwd(),
+    });
+    emitMessages(result.messages, dependencies.writeLine);
+});
+export const executeListProfilesCommand = (input) => {
+    const loadedSettings = loadSettingsWithCachedRemoteSettings(input);
+    if (loadedSettings.issues.length > 0) {
+        throw new Error(`Cannot list profiles with invalid settings: ${loadedSettings.issues.map(formatSettingsIssue).join('; ')}`);
+    }
+    const profileLoadResult = loadProfileSources(input.homeDirectory, loadedSettings.settings.profileSources);
+    if (profileLoadResult.issues.length > 0) {
+        throw new Error(`Cannot list profiles with invalid profiles: ${profileLoadResult.issues.map(formatProfileIssue).join('; ')}`);
+    }
+    const profiles = listHighestPrecedenceProfiles(profileLoadResult.profiles);
+    return {
+        profiles,
+        messages: profiles.length === 0 ? ['No profiles found.'] : profiles.map((profile) => profile.id),
+    };
+};
+const emitMessages = (messages, writeLine) => {
+    for (const message of messages) {
+        /* v8 ignore next -- console fallback is direct CLI behavior; tests inject a writer. */
+        (writeLine ?? console.log)(message);
+    }
+};
+const loadProfileSources = (homeDirectory, sources) => {
+    const profiles = [];
+    const issues = [];
+    for (const source of sources) {
+        const materializedSource = materializeSource(homeDirectory, source);
+        const result = loadLocalProfileSource(materializedSource);
+        profiles.push(...result.profiles.map((profile) => ({ ...profile, source })));
+        issues.push(...result.issues);
+    }
+    return { profiles, issues };
+};
+const materializeSource = (homeDirectory, source) => {
+    if (source.uri === undefined && source.github === undefined) {
+        return source;
+    }
+    if (source.uri !== undefined && source.ref === undefined && source.path === undefined) {
+        return { path: createProfileSourceCachePath(homeDirectory, source.uri), only: source.only, except: source.except };
+    }
+    return {
+        path: resolveRemoteRepositorySubpath(createRemoteRepositoryCachePath(homeDirectory, source), source.path),
+        only: source.only,
+        except: source.except,
+    };
+};
+const listHighestPrecedenceProfiles = (loadedProfiles) => {
+    const profilesById = new Map();
+    for (const loadedProfile of loadedProfiles) {
+        profilesById.set(loadedProfile.profile.id, {
+            id: loadedProfile.profile.id,
+            label: loadedProfile.profile.label,
+            profilePath: loadedProfile.profilePath,
+        });
+    }
+    return [...profilesById.values()].sort((left, right) => left.id.localeCompare(right.id));
+};
+const formatSettingsIssue = (issue) => `${issue.filePath}#${issue.path} ${issue.message}`;
+const formatProfileIssue = (issue) => `${issue.path} ${issue.message}`;
+//# sourceMappingURL=ListCommand.js.map

package/dist/cli/commands/profile/ListCommand.js.map

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

package/dist/cli/commands/profile/Shared.d.ts

@@ -0,0 +1,9 @@
+import { Command } from 'commander';
+export declare const profileCommandName = "profile";
+export declare const profileCommandDescription = "List and manage Outfitter profiles.";
+export interface ProfileCommandDependencies {
+    readonly homeDirectory?: string;
+    readonly projectDirectory?: string;
+    readonly writeLine?: (message: string) => void;
+}
+export declare const getOrCreateProfileCommander: (program: Command) => Command;

package/dist/cli/commands/profile/Shared.js

@@ -0,0 +1,10 @@
+export const profileCommandName = 'profile';
+export const profileCommandDescription = 'List and manage Outfitter profiles.';
+export const getOrCreateProfileCommander = (program) => {
+    const existingProfileCommand = program.commands.find((command) => command.name() === profileCommandName);
+    if (existingProfileCommand !== undefined) {
+        return existingProfileCommand;
+    }
+    return program.command(profileCommandName).description(profileCommandDescription);
+};
+//# sourceMappingURL=Shared.js.map

package/dist/cli/commands/profile/Shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Shared.js","sourceRoot":"","sources":["../../../../src/cli/commands/profile/Shared.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AAC5C,MAAM,CAAC,MAAM,yBAAyB,GAAG,qCAAqC,CAAC;AAQ/E,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,OAAgB,EAAW,EAAE;IACvE,MAAM,sBAAsB,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,kBAAkB,CAAC,CAAC;IAEzG,IAAI,sBAAsB,KAAK,SAAS,EAAE,CAAC;QACzC,OAAO,sBAAsB,CAAC;IAChC,CAAC;IAED,OAAO,OAAO,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;AACpF,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare const createProgram: (commands?: readonly import("./cli/commands/CommandObject.js").CommandObject[]) => import("commander").Command;
+export declare const isDirectCliExecution: (moduleUrl: string, argvPath: string | undefined) => boolean;

package/dist/cli.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+// Defines the initial Outfitter executable entrypoint.
+import { realpathSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { createOutfitterProgram } from './cli/OutfitterCli.js';
+export const createProgram = createOutfitterProgram;
+export const isDirectCliExecution = (moduleUrl, argvPath) => {
+    if (argvPath === undefined) {
+        return false;
+    }
+    try {
+        return realpathSync(fileURLToPath(moduleUrl)) === realpathSync(argvPath);
+    }
+    catch {
+        return false;
+    }
+};
+/* v8 ignore next 3 -- direct bin execution is covered by local install smoke tests. */
+if (isDirectCliExecution(import.meta.url, process.argv[1])) {
+    await createProgram().parseAsync(process.argv);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,uDAAuD;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,CAAC,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAEpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,SAAiB,EAAE,QAA4B,EAAW,EAAE;IAC/F,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,KAAK,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF,uFAAuF;AACvF,IAAI,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,MAAM,aAAa,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACjD,CAAC"}

package/dist/compositeProfile/CompositeProfile.d.ts

@@ -0,0 +1,8 @@
+import type { CompositeProfileStatePath } from './StatePersistence.js';
+import type { CompositeProfileFile } from './CompositeProfileFile.js';
+export interface CompositeProfile {
+    readonly rootDirectory: string;
+    readonly files: readonly CompositeProfileFile[];
+    readonly statePaths: readonly CompositeProfileStatePath[];
+}
+export declare const createCompositeProfile: (rootDirectory: string, files: readonly CompositeProfileFile[], statePaths?: readonly CompositeProfileStatePath[]) => CompositeProfile;