@context-forge/cli 0.2.2

package/dist/commands/next.js

@@ -0,0 +1,80 @@
+import { FileProjectStore, ArtifactIntrospector } from '@context-forge/core/node';
+import { resolveProjectId } from '../utils/project.js';
+import { handleError, UserError } from '../utils/errors.js';
+import { printJson } from '../output/formatter.js';
+import { label, value as valueStyle, dim } from '../output/styles.js';
+/**
+ * Derive a basic "next action" recommendation from project data and introspection.
+ *
+ * NOTE: This is a provisional implementation. Full workflow navigation
+ * (WorkflowNavigator.getNext()) depends on slice 165, which is not yet complete.
+ * This version uses ArtifactIntrospector to provide basic guidance.
+ */
+function deriveRecommendation(project, introspection) {
+    const phase = project.developmentPhase ?? 'Not set';
+    const slice = project.fileSlice;
+    if (introspection?.currentTasks) {
+        const { completedTasks, totalTasks, inferredStatus } = introspection.currentTasks;
+        if (inferredStatus === 'complete') {
+            return {
+                recommendation: 'Advance to next phase or slice',
+                slice,
+                phase,
+                rationale: `All ${totalTasks} tasks complete in current task file.`,
+            };
+        }
+        const remaining = totalTasks - completedTasks;
+        return {
+            recommendation: 'Continue current tasks',
+            slice,
+            phase,
+            rationale: `${remaining} of ${totalTasks} tasks remaining in ${project.fileTasks}.`,
+        };
+    }
+    return {
+        recommendation: 'Review project configuration',
+        slice,
+        phase,
+        rationale: 'No task file data available. Verify fileTasks and projectPath are set.',
+    };
+}
+export function registerNextCommand(program) {
+    program
+        .command('next')
+        .description('Show recommended next action for the active project')
+        .option('--json', 'Output as JSON')
+        .option('--project <id>', 'Project ID (overrides default)')
+        .action(async (opts) => {
+        try {
+            const store = new FileProjectStore();
+            const { id } = await resolveProjectId(opts.project, store);
+            const project = await store.getById(id);
+            if (!project) {
+                throw new UserError(`Project not found: '${id}'. Run cf project list to see available projects.`);
+            }
+            let introspection;
+            if (project.projectPath) {
+                try {
+                    const introspector = new ArtifactIntrospector();
+                    introspection = await introspector.summarize(project);
+                }
+                catch {
+                    // Graceful degradation
+                }
+            }
+            const result = deriveRecommendation(project, introspection);
+            if (opts.json) {
+                printJson(result);
+                return;
+            }
+            console.log(label('Next:      ') + valueStyle(result.recommendation));
+            console.log(label('Slice:     ') + valueStyle(result.slice));
+            console.log(label('Phase:     ') + valueStyle(result.phase));
+            console.log(label('Rationale: ') + dim(result.rationale));
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+//# sourceMappingURL=next.js.map

package/dist/commands/next.js.map

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

package/dist/commands/project.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerProjectCommand(program: Command): void;
+//# sourceMappingURL=project.d.ts.map

package/dist/commands/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/commands/project.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4DpC,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4M7D"}

package/dist/commands/project.js

@@ -0,0 +1,239 @@
+import * as os from 'node:os';
+import * as readline from 'node:readline';
+import { FileProjectStore, ConfigManager } from '@context-forge/core/node';
+import { resolveFieldName, resolvePhaseValue, validateFieldValue, PROJECT_FIELDS, FIELD_GROUPS, } from '@context-forge/core';
+import { resolveProjectId, findByNameOrId } from '../utils/project.js';
+import { handleError, UserError } from '../utils/errors.js';
+import { printJson } from '../output/formatter.js';
+import { renderTable } from '../output/tables.js';
+import { label, value as valueStyle, success, dim } from '../output/styles.js';
+/** Shorten an absolute path by replacing the home directory with ~. */
+function shortenPath(p) {
+    const home = os.homedir();
+    if (p === home)
+        return '~';
+    if (p.startsWith(home + '/'))
+        return '~' + p.slice(home.length);
+    return p;
+}
+/** Display the project schema grouped by category. */
+function displaySchema() {
+    const groupLabels = {
+        identity: 'Identity',
+        artifacts: 'Artifacts',
+        workflow: 'Workflow',
+        metadata: 'Metadata',
+    };
+    console.log(label('\nProject Schema'));
+    console.log('══════════════');
+    for (const group of FIELD_GROUPS) {
+        const groupFields = PROJECT_FIELDS.filter((f) => f.group === group);
+        console.log(`\n${label(groupLabels[group])}`);
+        for (const f of groupFields) {
+            const flags = [];
+            if (f.required)
+                flags.push('required');
+            if (f.readonly)
+                flags.push('readonly');
+            const flagStr = flags.length > 0 ? `  (${flags.join(', ')})` : '';
+            console.log(`  ${f.field.padEnd(18)}${f.type.padEnd(10)}${flagStr}  ${f.description}`);
+            if (f.aliases.length > 0) {
+                console.log(`${''.padEnd(20)}Aliases: ${f.aliases.join(', ')}`);
+            }
+            if (f.enumValues) {
+                console.log(`${''.padEnd(20)}Values: ${f.enumValues.join(', ')}`);
+            }
+        }
+    }
+}
+export function registerProjectCommand(program) {
+    const cmd = program
+        .command('project')
+        .description('Manage Context Forge projects')
+        .option('--schema', 'Display project field schema')
+        .action((opts) => {
+        if (opts.schema) {
+            displaySchema();
+        }
+        else {
+            console.log(`Usage: ${label('cf project')} [options] [command]  —  run ${dim('cf project --help')} for details`);
+        }
+    });
+    cmd
+        .command('list')
+        .description('List all projects')
+        .option('--json', 'Output as JSON')
+        .action(async (opts) => {
+        try {
+            const store = new FileProjectStore();
+            const projects = await store.getAll();
+            // Read default_project config to determine which project is the default
+            const cm = new ConfigManager();
+            const defaultRef = (await cm.get('default_project')).value;
+            let defaultProject = null;
+            if (defaultRef) {
+                defaultProject = await findByNameOrId(defaultRef, store);
+            }
+            if (opts.json) {
+                printJson(projects.map((p) => ({
+                    id: p.id,
+                    name: p.name,
+                    projectPath: p.projectPath,
+                    fileSlice: p.fileSlice,
+                    isDefault: defaultProject?.id === p.id,
+                })));
+                return;
+            }
+            const rows = projects.map((p) => [
+                p.name,
+                shortenPath(p.projectPath ?? ''),
+                p.fileSlice,
+                defaultProject?.id === p.id ? '●' : '',
+            ]);
+            console.log(renderTable(['Name', 'Path', 'Slice', 'Default'], rows));
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    cmd
+        .command('get')
+        .description('Get details for the active project')
+        .option('--json', 'Output as JSON')
+        .option('--project <id>', 'Project ID (overrides default)')
+        .action(async (opts) => {
+        try {
+            const store = new FileProjectStore();
+            const { id } = await resolveProjectId(opts.project, store);
+            const project = await store.getById(id);
+            if (!project) {
+                throw new UserError(`Project not found: '${id}'. Run cf project list to see available projects.`);
+            }
+            if (opts.json) {
+                printJson(project);
+                return;
+            }
+            // Grouped display — iterate by group, skip empty groups
+            const groupLabels = {
+                identity: 'Identity',
+                artifacts: 'Artifacts',
+                workflow: 'Workflow',
+                metadata: 'Metadata',
+            };
+            const projectRecord = project;
+            for (const group of FIELD_GROUPS) {
+                const groupFields = PROJECT_FIELDS.filter((f) => f.group === group);
+                const populated = groupFields.filter((f) => {
+                    const val = projectRecord[f.field];
+                    return val !== undefined && val !== null && val !== '';
+                });
+                if (populated.length === 0)
+                    continue;
+                console.log(`\n${label(groupLabels[group])}`);
+                for (const f of populated) {
+                    const val = String(projectRecord[f.field]);
+                    console.log(`  ${label(`${f.label}:`.padEnd(16))}${valueStyle(val)}`);
+                }
+            }
+            // Display customData sub-fields if populated
+            const custom = project.customData;
+            if (custom) {
+                const customEntries = [
+                    ['Recent Events', custom.recentEvents ?? ''],
+                    ['Notes', custom.additionalNotes ?? ''],
+                    ['Tools', custom.availableTools ?? ''],
+                ];
+                const populated = customEntries.filter(([, v]) => v);
+                if (populated.length > 0) {
+                    console.log(`\n${label('Custom Data')}`);
+                    for (const [k, v] of populated) {
+                        console.log(`  ${label(`${k}:`.padEnd(16))}${valueStyle(v)}`);
+                    }
+                }
+            }
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    cmd
+        .command('set <field> <value>')
+        .description('Update a field on the active project')
+        .option('--project <id>', 'Project ID (overrides default)')
+        .action(async (field, val, opts) => {
+        try {
+            const resolvedField = resolveFieldName(field);
+            if (!resolvedField) {
+                throw new UserError(`Unknown field: '${field}'. Run 'cf project --schema' to see available fields.`);
+            }
+            const fieldDef = PROJECT_FIELDS.find((f) => f.field === resolvedField);
+            if (fieldDef?.readonly) {
+                throw new UserError(`Field '${resolvedField}' is read-only and cannot be set.`);
+            }
+            // Resolve phase/instruction values (number, short name, or full string)
+            let resolvedValue = val;
+            if (resolvedField === 'developmentPhase' || resolvedField === 'instruction') {
+                const phaseVal = resolvePhaseValue(val);
+                if (!phaseVal) {
+                    const allowed = fieldDef?.enumValues?.join(', ') ?? '';
+                    throw new UserError(`Invalid value "${val}" for field "${resolvedField}". Allowed values: ${allowed}`);
+                }
+                resolvedValue = phaseVal;
+            }
+            // Validate against enum constraints
+            const validation = validateFieldValue(resolvedField, resolvedValue);
+            if (!validation.valid) {
+                throw new UserError(validation.error);
+            }
+            const store = new FileProjectStore();
+            const { id } = await resolveProjectId(opts.project, store);
+            const existing = await store.getById(id);
+            if (!existing) {
+                throw new UserError(`Project not found: '${id}'. Run cf project list to see available projects.`);
+            }
+            await store.update(id, { [resolvedField]: resolvedValue });
+            console.log(success(`Updated ${resolvedField} = ${resolvedValue} on project ${existing.name}`));
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    cmd
+        .command('rm [nameOrId]')
+        .description('Remove a project from Context Forge (files on disk are not deleted)')
+        .option('--project <id>', 'Project ID (overrides default)')
+        .option('--yes', 'Skip confirmation prompt')
+        .action(async (nameOrId, opts) => {
+        try {
+            const store = new FileProjectStore();
+            const { id } = await resolveProjectId(nameOrId ?? opts.project, store);
+            const project = await store.getById(id);
+            if (!project) {
+                throw new UserError(`Project not found: '${id}'. Run cf project list to see available projects.`);
+            }
+            if (!opts.yes) {
+                const answer = await askConfirmation(`Remove project '${project.name}' at ${project.projectPath ?? 'unknown'} from Context Forge? (files on disk will not be deleted) [y/N] `);
+                if (!answer) {
+                    console.log('Cancelled.');
+                    return;
+                }
+            }
+            await store.delete(id);
+            console.log(success(`Project '${project.name}' removed.`));
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+/** Prompt user for y/N confirmation via stdin. Returns true if confirmed. */
+function askConfirmation(prompt) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase() === 'y');
+        });
+    });
+}
+//# sourceMappingURL=project.js.map

package/dist/commands/project.js.map

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

package/dist/commands/prompt.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerPromptCommand(program: Command): void;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/commands/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/commands/prompt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA+BpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmG5D"}

package/dist/commands/prompt.js

@@ -0,0 +1,111 @@
+import * as path from 'node:path';
+import { FileProjectStore, SystemPromptParser } from '@context-forge/core/node';
+import { PROMPT_FILE_RELATIVE_PATH } from '@context-forge/core';
+import { resolveProjectId } from '../utils/project.js';
+import { handleError, UserError } from '../utils/errors.js';
+import { printJson, printRaw } from '../output/formatter.js';
+import { renderTable } from '../output/tables.js';
+import { getPhaseShorthands, resolvePhaseInput } from '../utils/phaseShorthand.js';
+/**
+ * Substitute project variables into template content.
+ * Unresolvable variables are preserved as-is.
+ */
+function substituteVariables(content, project) {
+    const vars = {
+        'project': project.name,
+        'slice': project.fileSlice,
+        'task-file': project.fileTasks,
+        'fileArch': project.fileArch,
+        'fileHLD': project.fileHLD,
+        'fileSpec': project.fileSpec,
+        'development-phase': project.developmentPhase,
+    };
+    return content.replace(/\{(\w[\w-]*)}/g, (_match, varName) => {
+        const value = vars[varName];
+        return value !== undefined ? value : `{${varName}}`;
+    });
+}
+export function registerPromptCommand(program) {
+    const cmd = program
+        .command('prompt')
+        .description('Access prompt templates with variable substitution');
+    cmd
+        .command('list')
+        .description('List available prompt templates')
+        .option('--json', 'Output as JSON')
+        .option('--project <id>', 'Project ID (overrides default)')
+        .action(async (opts) => {
+        try {
+            const store = new FileProjectStore();
+            const { id } = await resolveProjectId(opts.project, store);
+            const project = await store.getById(id);
+            if (!project) {
+                throw new UserError(`Project not found: '${id}'.`);
+            }
+            if (!project.projectPath) {
+                throw new UserError(`Project '${project.name}' has no projectPath configured.\n` +
+                    '  cf project set projectPath /path/to/project');
+            }
+            const promptFilePath = path.join(project.projectPath, PROMPT_FILE_RELATIVE_PATH);
+            const parser = new SystemPromptParser(promptFilePath);
+            const prompts = await parser.getAllPrompts();
+            // Build shorthand map for display
+            const shorthands = await getPhaseShorthands(project.projectPath);
+            const shorthandReverse = new Map();
+            for (const [key, name] of shorthands) {
+                shorthandReverse.set(name.toLowerCase(), key);
+            }
+            const templates = prompts.map((p) => {
+                const shorthand = shorthandReverse.get(p.name.replace(/\s*\(Phase \d+(?:\.\d+)?\)\s*/, '').toLowerCase()) ?? '';
+                return {
+                    name: p.name,
+                    key: p.key,
+                    shorthand,
+                    parameterCount: p.parameters.length,
+                };
+            });
+            if (opts.json) {
+                printJson(templates);
+                return;
+            }
+            const rows = templates.map((t) => [t.name, t.key, t.shorthand]);
+            console.log(renderTable(['Name', 'Key', 'Shorthand'], rows));
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    cmd
+        .command('get <phase>')
+        .description('Get a prompt template with project variables substituted')
+        .option('--project <id>', 'Project ID (overrides default)')
+        .option('--raw', 'Output raw template without variable substitution')
+        .action(async (phase, opts) => {
+        try {
+            const store = new FileProjectStore();
+            const { id } = await resolveProjectId(opts.project, store);
+            const project = await store.getById(id);
+            if (!project) {
+                throw new UserError(`Project not found: '${id}'.`);
+            }
+            if (!project.projectPath) {
+                throw new UserError(`Project '${project.name}' has no projectPath configured.\n` +
+                    '  cf project set projectPath /path/to/project');
+            }
+            // Resolve shorthand or name to instruction key
+            const resolvedPhase = await resolvePhaseInput(phase, project.projectPath);
+            const promptFilePath = path.join(project.projectPath, PROMPT_FILE_RELATIVE_PATH);
+            const parser = new SystemPromptParser(promptFilePath);
+            const prompt = await parser.getPromptForInstruction(resolvedPhase);
+            if (!prompt) {
+                throw new UserError(`No prompt found for '${phase}'. Run cf prompt list to see available templates.`);
+            }
+            const output = opts.raw ? prompt.content : substituteVariables(prompt.content, project);
+            printRaw(output);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+//# sourceMappingURL=prompt.js.map

package/dist/commands/prompt.js.map

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

package/dist/commands/status.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerStatusCommand(program: Command): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8E5D"}

package/dist/commands/status.js

@@ -0,0 +1,79 @@
+import { FileProjectStore, ArtifactIntrospector } from '@context-forge/core/node';
+import { resolveProjectId } from '../utils/project.js';
+import { handleError, UserError } from '../utils/errors.js';
+import { printJson } from '../output/formatter.js';
+import { label, value as valueStyle, dim } from '../output/styles.js';
+export function registerStatusCommand(program) {
+    program
+        .command('status')
+        .description('Show workflow status for the active project')
+        .option('--json', 'Output as JSON')
+        .option('--project <id>', 'Project ID (overrides default)')
+        .action(async (opts) => {
+        try {
+            const store = new FileProjectStore();
+            const { id, source } = await resolveProjectId(opts.project, store);
+            const project = await store.getById(id);
+            if (!project) {
+                throw new UserError(`Project not found: '${id}'. Run cf project list to see available projects.`);
+            }
+            // Gather introspection data when projectPath is available
+            let introspection;
+            if (project.projectPath) {
+                try {
+                    const introspector = new ArtifactIntrospector();
+                    introspection = await introspector.summarize(project);
+                }
+                catch {
+                    // Graceful degradation — show project data without introspection
+                }
+            }
+            const sourceLabels = {
+                flag: '(--project flag)',
+                cwd: '(from CWD)',
+                default: '(default)',
+                none: '',
+            };
+            const statusData = {
+                project: project.name,
+                resolutionSource: source,
+                phase: project.developmentPhase ?? 'Not set',
+                slice: project.fileSlice,
+                tasks: project.fileTasks,
+                workType: project.workType ?? 'Not set',
+                slicePlan: introspection?.slicePlan ?? null,
+                currentTasks: introspection?.currentTasks ?? null,
+                artifacts: introspection?.artifacts ?? null,
+            };
+            if (opts.json) {
+                printJson(statusData);
+                return;
+            }
+            const sourceLabel = sourceLabels[source];
+            const projectLine = sourceLabel
+                ? `${valueStyle(statusData.project)}  ${dim(sourceLabel)}`
+                : valueStyle(statusData.project);
+            console.log(label('Project:  ') + projectLine);
+            console.log(label('Phase:    ') + valueStyle(statusData.phase));
+            console.log(label('Slice:    ') + valueStyle(statusData.slice));
+            console.log(label('Tasks:    ') + valueStyle(statusData.tasks));
+            if (statusData.currentTasks) {
+                const { completedTasks, totalTasks, inferredStatus } = statusData.currentTasks;
+                console.log(label('Progress: ') + valueStyle(`${completedTasks}/${totalTasks} tasks (${inferredStatus})`));
+            }
+            if (statusData.slicePlan) {
+                const { completedSlices, totalSlices, summary } = statusData.slicePlan;
+                console.log('');
+                console.log(label('Slice Plan'));
+                console.log(dim(`  ${completedSlices}/${totalSlices} slices complete`));
+                if (summary) {
+                    console.log(dim(`  ${summary}`));
+                }
+            }
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+import { createRequire } from 'node:module';
+import chalk from 'chalk';
+import { Command } from 'commander';
+import { registerConfigCommand } from './commands/config.js';
+import { registerProjectCommand } from './commands/project.js';
+import { registerStatusCommand } from './commands/status.js';
+import { registerNextCommand } from './commands/next.js';
+import { registerBuildCommand } from './commands/build.js';
+import { registerFutureCommand } from './commands/future.js';
+import { registerCheckCommand } from './commands/check.js';
+import { registerPromptCommand } from './commands/prompt.js';
+import { registerInitCommand } from './commands/init.js';
+import { registerGuidesCommand } from './commands/guides.js';
+import { handleError } from './utils/errors.js';
+const require = createRequire(import.meta.url);
+const { version } = require('../package.json');
+const program = new Command();
+program
+    .name('cf')
+    .version(version)
+    .description('Context Forge CLI — terminal access to context assembly, project management, and workflow navigation')
+    .configureHelp({
+    styleTitle: (str) => chalk.bold(str),
+    styleCommandText: (str) => chalk.yellow(str),
+    styleSubcommandText: (str) => chalk.yellow(str),
+    styleOptionText: (str) => chalk.cyan(str),
+    styleArgumentText: (str) => chalk.magenta(str),
+    styleDescriptionText: (str) => str,
+    subcommandTerm: (cmd) => cmd.name(),
+})
+    .addHelpText('after', `\n${chalk.bold('Common options')} (available on most commands):\n  ${chalk.cyan('--project <name|id>')}  Project name or ID (overrides default_project config)\n  ${chalk.cyan('--json')}               Output as JSON (not applicable to build/prompt get)`);
+registerConfigCommand(program);
+registerProjectCommand(program);
+registerStatusCommand(program);
+registerNextCommand(program);
+registerBuildCommand(program);
+registerFutureCommand(program);
+registerCheckCommand(program);
+registerPromptCommand(program);
+registerInitCommand(program);
+registerGuidesCommand(program);
+// Catch unhandled errors at top level
+process.on('uncaughtException', handleError);
+process.on('unhandledRejection', handleError);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,IAAI,CAAC;KACV,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,sGAAsG,CAAC;KACnH,aAAa,CAAC;IACb,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IACpC,gBAAgB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;IAC5C,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC;IAC/C,eAAe,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;IACzC,iBAAiB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;IAC9C,oBAAoB,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG;IAClC,cAAc,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE;CACpC,CAAC;KACD,WAAW,CAAC,OAAO,EAAE,KAAK,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,qCAAqC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,8DAA8D,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,oEAAoE,CAAC,CAAC;AAEvR,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAC9B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAE/B,sCAAsC;AACtC,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAC;AAC7C,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,WAAW,CAAC,CAAC;AAE9C,OAAO,CAAC,KAAK,EAAE,CAAC"}