@context-forge/cli 0.8.5 → 0.9.0

package/dist/commands/check.js

@@ -0,0 +1,250 @@
+import * as readline from 'node:readline';
+import { join } from 'node:path';
+import { FileProjectStore, ArtifactIntrospector, ConsistencyChecker, ConfigManager, detectDocuments, updateFrontmatterField, } from '@context-forge/core/node';
+import { resolveProjectWorktree } from '../utils/project.js';
+import { withJsonOption, withProjectOption, withYesOption, withFixOption } from '../options.js';
+import { applyWorktreeOverlay } from '../utils/worktree-overlay.js';
+import { handleError, UserError } from '../utils/errors.js';
+import { printJson } from '../output/formatter.js';
+import { label, dim, error as errorStyle, warn as warnStyle } from '../output/styles.js';
+const SEVERITY_ICON = {
+    error: '✗',
+    warning: '⚠',
+    info: 'ℹ',
+};
+/** 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');
+        });
+    });
+}
+function isFixResult(result) {
+    return 'fixLog' in result;
+}
+/** Merge findings from multiple checkAll runs, deduplicating by rule+location+description. */
+function mergeCheckResults(results) {
+    if (results.length === 1)
+        return results[0];
+    const seen = new Set();
+    const allFindings = [];
+    for (const result of results) {
+        for (const finding of result.findings) {
+            const key = `${finding.rule}|${finding.location}|${finding.description}`;
+            if (!seen.has(key)) {
+                seen.add(key);
+                allFindings.push(finding);
+            }
+        }
+    }
+    const projectPath = results[0].projectPath;
+    const errors = allFindings.filter((f) => f.severity === 'error').length;
+    const warnings = allFindings.filter((f) => f.severity === 'warning').length;
+    const infos = allFindings.filter((f) => f.severity === 'info').length;
+    const total = allFindings.length;
+    const parts = [];
+    if (errors > 0)
+        parts.push(`${errors} error${errors !== 1 ? 's' : ''}`);
+    if (warnings > 0)
+        parts.push(`${warnings} warning${warnings !== 1 ? 's' : ''}`);
+    if (infos > 0)
+        parts.push(`${infos} info${infos !== 1 ? 's' : ''}`);
+    const summary = total === 0 ? 'No inconsistencies found' : `${total} finding${total !== 1 ? 's' : ''}: ${parts.join(', ')}`;
+    return { projectPath, findings: allFindings, totalFindings: total, errors, warnings, infos, summary };
+}
+function formatFinding(finding, fixResult) {
+    const icon = SEVERITY_ICON[finding.severity] ?? '?';
+    const colorFn = finding.severity === 'error' ? errorStyle : finding.severity === 'warning' ? warnStyle : dim;
+    const lines = [];
+    lines.push(colorFn(`  ${icon} ${finding.description}`));
+    if (fixResult && finding.fixable) {
+        const logEntry = fixResult.fixLog.find((e) => e.rule === finding.rule);
+        if (logEntry) {
+            lines.push(dim(`    → Fixed: ${logEntry.before} → ${logEntry.after} in ${logEntry.filePath}`));
+        }
+    }
+    else {
+        lines.push(dim(`    → ${finding.suggestedFix}`));
+    }
+    return lines.join('\n');
+}
+/** Extract slice index prefix from a finding description like "[175] ..." */
+function extractFindingSliceIndex(description) {
+    const match = /^\[(\d+)\]\s/.exec(description);
+    return match ? match[1] : null;
+}
+/** Group findings by slice index prefix, with non-prefixed in a "Project-level" group */
+function groupFindings(findings) {
+    const groups = new Map();
+    for (const finding of findings) {
+        const idx = extractFindingSliceIndex(finding.description);
+        const key = idx ?? 'project';
+        const group = groups.get(key) ?? [];
+        group.push(finding);
+        groups.set(key, group);
+    }
+    return groups;
+}
+/**
+ * Declare a slice docs-only (#57): writes codeReview: none to its slice-design
+ * frontmatter, so evaluateReviewGate() skips the pre-advance code-review gate
+ * for it. A direct, single-purpose mutation — not part of the check/fix
+ * pipeline, since it doesn't depend on any finding having been detected first.
+ */
+async function setReviewNoneAction(indexArg, opts) {
+    const index = parseInt(indexArg, 10);
+    if (isNaN(index)) {
+        throw new UserError(`Invalid slice index: '${indexArg}'`);
+    }
+    const store = new FileProjectStore();
+    const { id } = await resolveProjectWorktree({ project: 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 (!project.projectPath) {
+        throw new UserError('No projectPath configured. Set one with: cf set projectPath /path/to/project');
+    }
+    const docs = await detectDocuments(project.projectPath, index);
+    if (!docs.sliceDesign) {
+        throw new UserError(`No slice-design file found for slice ${index}. codeReview: none is set on the slice design, not the task file.`);
+    }
+    const filePath = join(project.projectPath, docs.sliceDesign);
+    const entry = await updateFrontmatterField(filePath, 'codeReview', 'none');
+    if (opts.json) {
+        printJson({ slice: index, filePath: docs.sliceDesign, field: 'codeReview', before: entry.before, after: entry.after });
+        return;
+    }
+    console.log(label(`Set codeReview: none on slice ${index}`));
+    console.log(dim(`  ${docs.sliceDesign}`));
+}
+export function registerCheckCommand(program) {
+    const checkCmd = program
+        .command('check')
+        .description('Run consistency checks on project artifacts');
+    withJsonOption(checkCmd);
+    withProjectOption(checkCmd);
+    withFixOption(checkCmd);
+    checkCmd.option('--slice <index>', 'Check only a specific slice by index');
+    checkCmd.option('--set-review-none <index>', 'Declare a slice docs-only (writes codeReview: none to its slice design)');
+    withYesOption(checkCmd);
+    checkCmd.action(async (opts) => {
+        try {
+            if (opts.setReviewNone !== undefined) {
+                await setReviewNoneAction(opts.setReviewNone, opts);
+                return;
+            }
+            const store = new FileProjectStore();
+            const { id } = await resolveProjectWorktree({ project: 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.`);
+            }
+            const introspector = new ArtifactIntrospector();
+            const config = new ConfigManager(project.projectPath);
+            const checker = new ConsistencyChecker(introspector, config);
+            // Determine fix mode: explicit flag > config key > false
+            let fixMode = opts.fix ?? false;
+            if (!fixMode) {
+                try {
+                    const autoFixResult = await config.get('workflow.auto_fix');
+                    if (autoFixResult.value === true) {
+                        fixMode = true;
+                    }
+                }
+                catch {
+                    // Config read failed — default to check-only
+                }
+            }
+            // Determine scope: --slice narrows to single slice, otherwise all-slices
+            const singleSlice = opts.slice ? parseInt(opts.slice, 10) : null;
+            if (singleSlice !== null && isNaN(singleSlice)) {
+                throw new UserError(`Invalid slice index: '${opts.slice}'`);
+            }
+            // Build project views: one per worktree overlay so all workflow fields are visible.
+            // Findings are merged and deduplicated — aggregate rules (filesystem scan) run per
+            // view but produce the same results, so deduplication collapses them correctly.
+            const worktrees = project.worktrees ?? [];
+            const projectViews = worktrees.length > 0
+                ? worktrees.map((wt) => applyWorktreeOverlay(project, wt.id))
+                : [project];
+            let result;
+            if (singleSlice !== null) {
+                // Narrow to single slice — set fileSlice temporarily and use check()
+                const sliceViews = projectViews.map((v) => ({ ...v, fileSlice: `${singleSlice}-slice` }));
+                const checkResults = await Promise.all(sliceViews.map((v) => checker.check(v)));
+                const merged = mergeCheckResults(checkResults);
+                result = fixMode ? await checker.applyFixes(merged) : merged;
+            }
+            else if (fixMode) {
+                // All-slices fix mode — prompt for confirmation unless --yes
+                const dryRunResults = await Promise.all(projectViews.map((v) => checker.checkAll(v)));
+                const dryRun = mergeCheckResults(dryRunResults);
+                const fixableCount = dryRun.findings.filter((f) => f.fixable).length;
+                if (fixableCount === 0) {
+                    printCheckOutput(dryRun, project.name, false);
+                    console.log(dim('No fixable findings — nothing to apply.'));
+                    return;
+                }
+                else if (!opts.yes) {
+                    printCheckOutput(dryRun, project.name, false);
+                    const confirmed = await askConfirmation(`\nFound ${fixableCount} fixable finding${fixableCount !== 1 ? 's' : ''}. Apply fixes? [y/N] `);
+                    if (!confirmed) {
+                        console.log('Aborted.');
+                        return;
+                    }
+                    result = await checker.applyFixes(dryRun);
+                }
+                else {
+                    result = await checker.applyFixes(dryRun);
+                }
+            }
+            else {
+                const checkResults = await Promise.all(projectViews.map((v) => checker.checkAll(v)));
+                result = mergeCheckResults(checkResults);
+            }
+            if (opts.json) {
+                printJson(result);
+                return;
+            }
+            printCheckOutput(result, project.name, fixMode);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+function printCheckOutput(result, projectName, fixMode) {
+    const modeLabel = fixMode ? ' (fix mode)' : '';
+    console.log(label(`Consistency Check: ${projectName}${modeLabel}`));
+    console.log('');
+    if (result.totalFindings === 0) {
+        console.log('  No inconsistencies found');
+        return;
+    }
+    const fixRes = isFixResult(result) ? result : undefined;
+    const groups = groupFindings(result.findings);
+    for (const [key, findings] of groups) {
+        const groupLabel = key === 'project' ? 'Project-level' : `Slice ${key}`;
+        console.log(label(`  ${groupLabel}`));
+        for (const finding of findings) {
+            console.log(formatFinding(finding, fixRes));
+        }
+        console.log('');
+    }
+    if (fixRes) {
+        console.log(label(`Fixed ${fixRes.fixed} of ${result.totalFindings} findings`));
+        if (fixRes.fixErrors.length > 0) {
+            for (const err of fixRes.fixErrors) {
+                console.log(errorStyle(`  Fix error: ${err}`));
+            }
+        }
+    }
+    else {
+        console.log(dim(result.summary));
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

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

package/dist/commands/commandInstaller.d.ts

@@ -0,0 +1,28 @@
+import { Command } from 'commander';
+/** Resolve the bundled commands/ directory relative to this script's location. */
+export declare function getSourceCommandsDir(): string;
+/**
+ * Copy command files from the bundled commands/cf/ directory to the target.
+ * Creates directories as needed. Overwrites existing files (idempotent).
+ * Removes stale .md files in the target that no longer exist in the source.
+ *
+ * @returns Object with installed and removed filenames.
+ */
+export declare function installCommands(targetDir: string): {
+    installed: string[];
+    removed: string[];
+};
+/**
+ * Remove managed command files from the target.
+ * "Managed" = any .md file that exists in the bundled source directory.
+ * Preserves user-added files not in the source. Removes cf/ if empty.
+ * No error if files or directory don't exist (idempotent).
+ *
+ * @returns List of removed filenames.
+ */
+export declare function uninstallCommands(targetDir: string): string[];
+/** Install commands to the target directory (defaults to ~/.claude/commands). Errors propagate. */
+export declare function installCommandsAction(targetDir?: string): void;
+export declare function registerInstallCommandsCommand(program: Command): void;
+export declare function registerUninstallCommandsCommand(program: Command): void;
+//# sourceMappingURL=commandInstaller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commandInstaller.d.ts","sourceRoot":"","sources":["../../src/commands/commandInstaller.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,kFAAkF;AAClF,wBAAgB,oBAAoB,IAAI,MAAM,CAU7C;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAwB7F;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAuB7D;AAOD,mGAAmG;AACnG,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAU9D;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoBrE;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqBvE"}

package/dist/commands/commandInstaller.js

@@ -0,0 +1,136 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { success, dim } from '../output/styles.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/** Resolve the bundled commands/ directory relative to this script's location. */
+export function getSourceCommandsDir() {
+    // In dist: dist/commands/commandInstaller.js → ../../commands/
+    const resolved = path.resolve(__dirname, '..', '..', 'commands');
+    if (!fs.existsSync(resolved)) {
+        throw new Error(`Cannot locate bundled commands directory at ${resolved}. ` +
+            'Ensure the package includes a commands/ directory.');
+    }
+    return resolved;
+}
+/**
+ * Copy command files from the bundled commands/cf/ directory to the target.
+ * Creates directories as needed. Overwrites existing files (idempotent).
+ * Removes stale .md files in the target that no longer exist in the source.
+ *
+ * @returns Object with installed and removed filenames.
+ */
+export function installCommands(targetDir) {
+    const sourceDir = path.join(getSourceCommandsDir(), 'cf');
+    const targetCfDir = path.join(targetDir, 'cf');
+    fs.mkdirSync(targetCfDir, { recursive: true });
+    const sourceFiles = new Set(fs.readdirSync(sourceDir).filter((f) => f.endsWith('.md')));
+    // Install current files
+    for (const file of sourceFiles) {
+        fs.copyFileSync(path.join(sourceDir, file), path.join(targetCfDir, file));
+    }
+    // Remove stale files (exist in target but not in source)
+    const removed = [];
+    const targetFiles = fs.readdirSync(targetCfDir).filter((f) => f.endsWith('.md'));
+    for (const file of targetFiles) {
+        if (!sourceFiles.has(file)) {
+            fs.rmSync(path.join(targetCfDir, file));
+            removed.push(file);
+        }
+    }
+    return { installed: [...sourceFiles], removed };
+}
+/**
+ * Remove managed command files from the target.
+ * "Managed" = any .md file that exists in the bundled source directory.
+ * Preserves user-added files not in the source. Removes cf/ if empty.
+ * No error if files or directory don't exist (idempotent).
+ *
+ * @returns List of removed filenames.
+ */
+export function uninstallCommands(targetDir) {
+    const sourceDir = path.join(getSourceCommandsDir(), 'cf');
+    const managedFiles = fs.readdirSync(sourceDir).filter((f) => f.endsWith('.md'));
+    const targetCfDir = path.join(targetDir, 'cf');
+    const removed = [];
+    for (const file of managedFiles) {
+        const filePath = path.join(targetCfDir, file);
+        if (fs.existsSync(filePath)) {
+            fs.rmSync(filePath);
+            removed.push(file);
+        }
+    }
+    // Remove cf/ directory if it exists and is now empty
+    if (fs.existsSync(targetCfDir)) {
+        const remaining = fs.readdirSync(targetCfDir);
+        if (remaining.length === 0) {
+            fs.rmdirSync(targetCfDir);
+        }
+    }
+    return removed;
+}
+/** Default target directory for command installation. */
+function defaultTarget() {
+    return path.join(os.homedir(), '.claude', 'commands');
+}
+/** Install commands to the target directory (defaults to ~/.claude/commands). Errors propagate. */
+export function installCommandsAction(targetDir) {
+    const target = targetDir ?? defaultTarget();
+    const { installed, removed } = installCommands(target);
+    console.log(success(`Installed ${installed.length} commands to ${target}/cf/`));
+    for (const file of installed) {
+        console.log(`  ${dim('/cf:' + file.replace('.md', ''))}`);
+    }
+    if (removed.length > 0) {
+        console.log(dim(`Removed ${removed.length} stale command(s): ${removed.map((f) => f.replace('.md', '')).join(', ')}`));
+    }
+}
+export function registerInstallCommandsCommand(program) {
+    program
+        .command('install-commands')
+        .description('Install Claude Code slash commands for Context Forge')
+        .option('--target <dir>', 'Target directory', defaultTarget())
+        .action((opts) => {
+        try {
+            const { installed, removed } = installCommands(opts.target);
+            console.log(success(`Installed ${installed.length} commands to ${opts.target}/cf/`));
+            for (const file of installed) {
+                console.log(`  ${dim('/cf:' + file.replace('.md', ''))}`);
+            }
+            if (removed.length > 0) {
+                console.log(dim(`Removed ${removed.length} stale command(s): ${removed.map((f) => f.replace('.md', '')).join(', ')}`));
+            }
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            process.exit(1);
+        }
+    });
+}
+export function registerUninstallCommandsCommand(program) {
+    program
+        .command('uninstall-commands')
+        .description('Remove Claude Code slash commands for Context Forge')
+        .option('--target <dir>', 'Target directory', defaultTarget())
+        .action((opts) => {
+        try {
+            const removed = uninstallCommands(opts.target);
+            if (removed.length === 0) {
+                console.log(dim('No commands found to remove.'));
+            }
+            else {
+                console.log(success(`Removed ${removed.length} commands from ${opts.target}/cf/`));
+                for (const file of removed) {
+                    console.log(`  ${dim('/cf:' + file.replace('.md', ''))}`);
+                }
+            }
+        }
+        catch (err) {
+            console.error(`Error: ${err.message}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=commandInstaller.js.map

package/dist/commands/commandInstaller.js.map

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

package/dist/commands/config.d.ts

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

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

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

package/dist/commands/config.js

@@ -0,0 +1,116 @@
+import { existsSync, statSync } from 'node:fs';
+import { ConfigManager, FileProjectStore, CONFIG_KEYS } from '@context-forge/core/node';
+import { resolveProject } from '@context-forge/core';
+import { resolveProjectWorktree } from '../utils/project.js';
+import { handleError, UserError } from '../utils/errors.js';
+import { withJsonOption, withProjectOption } from '../options.js';
+import { printJson } from '../output/formatter.js';
+import { label, value as valueStyle, dim, success } from '../output/styles.js';
+/**
+ * Resolves --project to the project's actual projectPath, so ConfigManager reads/writes
+ * the real .context-forge.toml at the project root rather than treating a bare registered
+ * project name as a literal directory (the bug this fixes). Tries registry resolution
+ * (name/id, then CWD) first; if that fails and the value is itself an existing directory,
+ * falls back to using it directly — config is the one CLI surface that supports pointing
+ * at an unregistered scratch directory, unlike next/status which require a full ProjectData.
+ * Returns undefined (user-scope config) when no project can be resolved and none was requested.
+ */
+async function resolveConfigProjectPath(project) {
+    try {
+        const store = new FileProjectStore();
+        const { id, worktreeId } = await resolveProjectWorktree({ project }, store);
+        const resolved = await resolveProject(store, id, worktreeId);
+        if (resolved?.projectPath)
+            return resolved.projectPath;
+    }
+    catch (err) {
+        // resolveProjectWorktree throws UserError when no project matches — expected when
+        // --project is a raw directory rather than a registered name; fall through to the
+        // raw-path fallback below. Any other error (e.g. a corrupt project store) propagates.
+        if (!(err instanceof UserError))
+            throw err;
+    }
+    if (project && existsSync(project) && statSync(project).isDirectory()) {
+        return project;
+    }
+    if (project) {
+        throw new Error(`Project '${project}' not found and is not an existing directory.`);
+    }
+    return undefined;
+}
+export function registerConfigCommand(program) {
+    const cmd = program
+        .command('config')
+        .description('Manage Context Forge configuration (get, set)');
+    const getCmd = cmd.command('get [key]').description('Get a configuration key, or show all keys if none specified');
+    withJsonOption(getCmd);
+    withProjectOption(getCmd);
+    getCmd.action(async (key, opts) => {
+        try {
+            const projectPath = await resolveConfigProjectPath(opts.project);
+            const cm = new ConfigManager(projectPath);
+            if (!key) {
+                // No key — show all config keys
+                const entries = await cm.list();
+                if (opts.json) {
+                    printJson(entries);
+                    return;
+                }
+                const maxKey = Math.max(...entries.map((e) => e.key.length));
+                const maxVal = Math.max(...entries.map((e) => String(e.value ?? '').length), 5);
+                for (const e of entries) {
+                    const val = String(e.value ?? '');
+                    console.log(`  ${e.key.padEnd(maxKey)}  ${valueStyle(val.padEnd(maxVal))}  ${dim(e.source)}`);
+                }
+                return;
+            }
+            const result = await cm.get(key);
+            if (opts.json) {
+                printJson(result);
+                return;
+            }
+            console.log(`${label('Key:')}     ${result.key}`);
+            console.log(`${label('Value:')}   ${valueStyle(String(result.value ?? ''))}`);
+            console.log(`${label('Source:')}  ${result.source}`);
+            if (result.description) {
+                console.log(`${label('About:')}   ${result.description}`);
+            }
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+    const setCmd = cmd.command('set <key> <value>').description('Set a configuration value');
+    withProjectOption(setCmd);
+    setCmd.action(async (key, val, opts) => {
+        try {
+            const scope = opts.project ? 'project' : 'user';
+            const projectPath = await resolveConfigProjectPath(opts.project);
+            const cm = new ConfigManager(projectPath);
+            // Coerce the raw string argument to the key's declared type. The shell
+            // strips quotes, so an all-digit string like a YYYYMMDD date reaches us
+            // indistinguishable from a numeric literal — blind Number() coercion would
+            // reject it against a string-typed key. Consult the registry and coerce
+            // only toward the declared type. Unknown keys are left as-is so cm.set
+            // produces its normal "unknown key" error rather than a mis-coerced value.
+            const declaredType = CONFIG_KEYS[key]?.type;
+            let coerced = val;
+            if (declaredType === 'boolean') {
+                if (val === 'true')
+                    coerced = true;
+                else if (val === 'false')
+                    coerced = false;
+            }
+            else if (declaredType === 'number') {
+                if (/^\d+(\.\d+)?$/.test(val))
+                    coerced = Number(val);
+            }
+            await cm.set(key, coerced, scope);
+            console.log(success(`Set ${key} = ${String(coerced)} (${scope})`));
+        }
+        catch (err) {
+            handleError(err);
+        }
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

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

package/dist/commands/future.d.ts

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

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

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