@mediaproc/core 1.2.2 → 1.4.0

package/dist/{explainFlag.js → explain/explainFlag.js}

@@ -1,12 +1,15 @@
 import chalk from 'chalk';
-import { explainFormatter } from './formatters/explainFormatter.js';
-import { getCliVersion, getVersion } from './branding/branding.js';
+import { explainFormatter } from '../formatters/explainFormatter.js';
+import { getCliVersion, getVersion } from '../branding/branding.js';
+import { ExplainMode } from '../types/explainTypes.js';
 import os from 'os';
+import fs from 'fs';
+import path from 'path';
 /**
  * explainFlag - Automatically gathers command context, prints explanation, then runs the handler.
  * @param params - { commandName, args, options, handler }
  */
-export function explainFlag({ command, args = {}, options = {}, inputKeys = ['input', 'inputPath'], outputKeys = ['output', 'outputPath', 'o'], format = 'human', }) {
+export function explainFlag({ command, args = {}, options = {}, inputKeys = ['input', 'inputPath'], outputKeys = ['output', 'outputPath', 'o'], mode = ExplainMode.Human, }) {
     // Auto-detect command name
     const commandName = command?.name?.() || command?._name || 'unknown';
     const environment = {
@@ -15,35 +18,61 @@ export function explainFlag({ command, args = {}, options = {}, inputKeys = ['in
         nodeVersion: process.version,
         shell: process.env.SHELL || process.env.TERM || 'unknown',
     };
-    // Detect input/output paths
+    // Detect input/output paths and gather all input/output arguments
     let inputPath = '';
     let outputPath = '';
+    let allInputs = {};
+    let allOutputs = {};
     for (const k of inputKeys) {
-        if (args[k])
+        if (args[k]) {
             inputPath = args[k];
-        if (options[k])
+            allInputs[k] = args[k];
+        }
+        if (options[k]) {
             inputPath = options[k];
+            allInputs[k] = options[k];
+        }
     }
     for (const k of outputKeys) {
-        if (args[k])
+        if (args[k]) {
             outputPath = args[k];
-        if (options[k])
+            allOutputs[k] = args[k];
+        }
+        if (options[k]) {
             outputPath = options[k];
+            allOutputs[k] = options[k];
+        }
     }
     // Gather used flags
     let explainValue = undefined;
+    let explainOnly = false;
     if (typeof options.explain === 'string') {
         explainValue = options.explain;
+        if (explainValue === 'only')
+            explainOnly = true;
     }
     else if (Array.isArray(args._) && args._.length > 0) {
         // Check for --explain details as positional
         const idx = args._.findIndex((v) => v === 'explain');
         if (idx !== -1 && args._[idx + 1]) {
             explainValue = args._[idx + 1];
+            if (explainValue === 'only')
+                explainOnly = true;
         }
     }
-    if (explainValue === 'details' || explainValue === 'json' || explainValue === 'human') {
-        format = explainValue;
+    if (explainValue === 'details') {
+        mode = ExplainMode.Details;
+    }
+    else if (explainValue === 'json') {
+        mode = ExplainMode.Json;
+    }
+    else if (explainValue === 'human') {
+        mode = ExplainMode.Human;
+    }
+    else if (explainValue) {
+        // fallback for unknown explain values
+        console.warn(chalk.yellow(`warn: unknown explain mode "${explainValue}", falling back to "human"`));
+        mode = ExplainMode.Human;
     }
     // Gather all possible flags from command (Commander.js API)
     const usedFlags = {};
@@ -53,13 +82,24 @@ export function explainFlag({ command, args = {}, options = {}, inputKeys = ['in
             const flagName = opt.attributeName || opt.long?.replace(/^--/, '') || opt.short?.replace(/^-/, '');
             if (!flagName)
                 continue;
-            const userValue = options[flagName];
+            let userValue = options[flagName];
+            // Handle boolean flags
+            if (typeof userValue === 'boolean')
+                userValue = userValue ? 'enabled' : 'disabled';
+            // Handle array flags
+            if (Array.isArray(userValue))
+                userValue = userValue.join(', ');
             if (userValue !== undefined) {
                 usedFlags[flagName] = { value: userValue, source: 'user' };
             }
             else if (Object.prototype.hasOwnProperty.call(opt, 'defaultValue')) {
-                usedFlags[flagName] = { value: opt.defaultValue, source: 'default' };
-                omittedFlags[flagName] = { defaultValue: opt.defaultValue, source: 'default' };
+                let defVal = opt.defaultValue;
+                if (typeof defVal === 'boolean')
+                    defVal = defVal ? 'enabled' : 'disabled';
+                if (Array.isArray(defVal))
+                    defVal = defVal.join(', ');
+                usedFlags[flagName] = { value: defVal, source: 'default' };
+                omittedFlags[flagName] = { defaultValue: defVal, source: 'default' };
             }
             else {
                 usedFlags[flagName] = { value: undefined, source: 'system' };
@@ -70,7 +110,12 @@ export function explainFlag({ command, args = {}, options = {}, inputKeys = ['in
         for (const [key, value] of Object.entries(options)) {
             if (key === 'explain')
                 continue;
-            usedFlags[key] = { value, source: value !== undefined ? 'user' : 'system' };
+            let val = value;
+            if (typeof val === 'boolean')
+                val = val ? 'enabled' : 'disabled';
+            if (Array.isArray(val))
+                val = val.join(', ');
+            usedFlags[key] = { value: val, source: val !== undefined ? 'user' : 'system' };
         }
     }
     // Build ExplainContext with plugin/command info and version
@@ -91,17 +136,28 @@ export function explainFlag({ command, args = {}, options = {}, inputKeys = ['in
         console.error(chalk.red('Error retrieving version information:'), error);
     }
     const context = {
+        schemaVersion: '1.0', // Tier 3 placeholder
         command: commandName,
         plugin: command?.parent?.name?.() || undefined,
         cliVersion,
         pluginVersion,
-        inputs: { inputPath, outputPath },
+        // Context enrichment
+        timestamp: new Date().toISOString(),
+        user: process.env.USER || process.env.USERNAME || 'unknown',
+        platform: `${os.platform()} ${os.arch()}`,
+        mode,
+        summary: outputPath
+            ? `Resize/Process file(s) and write result to ${outputPath}`
+            : `Operation will complete (no output path specified)`,
+        inputs: { inputPath, outputPath, ...allInputs },
+        outputs: Object.keys(allOutputs).length > 0 ? allOutputs : undefined,
         usedFlags,
         omittedFlags: Object.keys(omittedFlags).length > 0 ? omittedFlags : undefined,
         decisions: Object.entries(usedFlags).map(([key, v]) => ({
             key,
             value: v.value,
             reason: v.source === 'user' ? 'user specified' : (v.source === 'default' ? 'default' : 'system'),
+            provenance: v.source,
         })),
         outcome: {
             result: outputPath ? `A new file will be created at ${outputPath}` : 'Operation will complete',
@@ -113,6 +169,11 @@ export function explainFlag({ command, args = {}, options = {}, inputKeys = ['in
             ],
             errors: [], // Placeholder for error reporting
             warnings: [], // Placeholder for warning reporting
+            confidence: 'high', // Tier 4 placeholder
+            whatWillNotHappen: [
+                'Original files will not be modified',
+                'No network requests will be made'
+            ]
         },
         explainFlow: [
             '1. Parse and validate all user-provided flags and arguments.',
@@ -123,6 +184,7 @@ export function explainFlag({ command, args = {}, options = {}, inputKeys = ['in
             '6. Show summary and any errors encountered.'
         ],
         environment,
+        explainOnly,
         technical: {
             library: 'sharp',
             tool: 'mediaproc',
@@ -132,14 +194,24 @@ export function explainFlag({ command, args = {}, options = {}, inputKeys = ['in
             estimatedTime: 'depends on input size and options',
             memoryUsage: 'depends on batch size and image dimensions',
         },
+        exitCode: 0, // Tier 3 placeholder
     };
     // Print explanation only
-    const explanation = explainFormatter(context, format);
-    if (format === 'json') {
+    const explanation = explainFormatter(context, mode);
+    if (mode === ExplainMode.Json) {
         // Add a styled header for JSON output
-        // Print JSON with a clear header
         console.log(chalk.bold.bgBlueBright.white(' EXPLANATION (JSON) '));
-        console.log(chalk.gray(JSON.stringify(explanation, null, 2)));
+        // Write JSON to file in output/explain/
+        const timestamp = context.timestamp?.replace(/[:.]/g, '-') || Date.now().toString();
+        const outDir = path.resolve(process.cwd(), 'output', 'explain');
+        if (!fs.existsSync(outDir)) {
+            fs.mkdirSync(outDir, { recursive: true });
+        }
+        const outFile = path.join(outDir, `explain-${timestamp}.json`);
+        fs.writeFileSync(outFile, JSON.stringify(context, null, 2), 'utf-8');
+        console.log(chalk.green(`Explanation JSON written to: ${outFile}`));
+        // Also print a preview to the console
+        console.log(chalk.gray(JSON.stringify(context, null, 2)));
     }
     else {
         console.log(explanation);

package/dist/explain/explainFlag.js.map

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

package/dist/explain/hook/explainPreActionHook.d.ts

@@ -0,0 +1,7 @@
+import type { Command } from 'commander';
+/**
+ * Global preAction hook for Commander.js to support --explain and --explain=only.
+ * Prints explanation before command runs. If --explain=only, exits after explanation.
+ */
+export declare function explainPreActionHook(thisCmd: Command, actionCmd?: Command): void;
+//# sourceMappingURL=explainPreActionHook.d.ts.map

package/dist/explain/hook/explainPreActionHook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainPreActionHook.d.ts","sourceRoot":"","sources":["../../../src/explain/hook/explainPreActionHook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,OAAO,GAAG,IAAI,CAsBhF"}

package/dist/explain/hook/explainPreActionHook.js

@@ -0,0 +1,29 @@
+import { explainFlag } from '../explainFlag.js';
+/**
+ * Global preAction hook for Commander.js to support --explain and --explain=only.
+ * Prints explanation before command runs. If --explain=only, exits after explanation.
+ */
+export function explainPreActionHook(thisCmd, actionCmd) {
+    // Commander passes the command instance as 'thisCmd', and the subcommand as 'actionCmd'.
+    // We'll use 'actionCmd' if available (for subcommands), otherwise 'thisCmd'.
+    const cmd = actionCmd || thisCmd;
+    const opts = cmd.opts ? cmd.opts() : {};
+    // Gather positional arguments if available (Commander stores them in cmd.args or cmd._args)
+    let positionalArgs = {};
+    if (Array.isArray(cmd.args) && cmd.args.length > 0) {
+        positionalArgs = { _: cmd.args };
+    }
+    // Support --explain, --explain=details, --explain=only, etc.
+    if (opts.explain) {
+        explainFlag({
+            command: cmd,
+            args: positionalArgs,
+            options: opts,
+        });
+        // If --explain=only, do not execute the command
+        if (opts.explain === 'only') {
+            process.exit(0);
+        }
+    }
+}
+//# sourceMappingURL=explainPreActionHook.js.map

package/dist/explain/hook/explainPreActionHook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainPreActionHook.js","sourceRoot":"","sources":["../../../src/explain/hook/explainPreActionHook.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAgB,EAAE,SAAmB;IACxE,yFAAyF;IACzF,6EAA6E;IAC7E,MAAM,GAAG,GAAY,SAAS,IAAI,OAAO,CAAC;IAC1C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACxC,4FAA4F;IAC5F,IAAI,cAAc,GAAwB,EAAE,CAAC;IAC7C,IAAI,KAAK,CAAC,OAAO,CAAE,GAAW,CAAC,IAAI,CAAC,IAAK,GAAW,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrE,cAAc,GAAG,EAAE,CAAC,EAAG,GAAW,CAAC,IAAI,EAAE,CAAC;IAC5C,CAAC;IACD,6DAA6D;IAC7D,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,WAAW,CAAC;YACV,OAAO,EAAE,GAAG;YACZ,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QACH,gDAAgD;QAChD,IAAI,IAAI,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;YAC5B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/explain/index.d.ts

@@ -0,0 +1,5 @@
+export * from './templates/explainHumanTemplate.js';
+export * from './templates/explainDetailsTemplate.js';
+export * from './explainFlag.js';
+export * from './hook/explainPreActionHook.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/explain/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/explain/index.ts"],"names":[],"mappings":"AACA,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,kBAAkB,CAAC;AACjC,cAAc,gCAAgC,CAAC"}

package/dist/explain/index.js

@@ -0,0 +1,6 @@
+// Explain System (Templates, Flag, Hook)
+export * from './templates/explainHumanTemplate.js';
+export * from './templates/explainDetailsTemplate.js';
+export * from './explainFlag.js';
+export * from './hook/explainPreActionHook.js';
+//# sourceMappingURL=index.js.map

package/dist/explain/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/explain/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,kBAAkB,CAAC;AACjC,cAAc,gCAAgC,CAAC"}

package/dist/explain/templates/explainDetailsTemplate.d.ts

@@ -0,0 +1,3 @@
+import { ExplainContext } from '../../types/explainTypes.js';
+export declare function explainDetailsTemplate(context: ExplainContext): string;
+//# sourceMappingURL=explainDetailsTemplate.d.ts.map

package/dist/explain/templates/explainDetailsTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainDetailsTemplate.d.ts","sourceRoot":"","sources":["../../../src/explain/templates/explainDetailsTemplate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAI7D,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CA6JtE"}

package/dist/explain/templates/explainDetailsTemplate.js

@@ -0,0 +1,139 @@
+import chalk from 'chalk';
+import boxen from 'boxen';
+export function explainDetailsTemplate(context) {
+    function safe(val) {
+        if (val === null || val === undefined || (typeof val === 'number' && Number.isNaN(val)))
+            return 'N/A';
+        if (typeof val === 'function')
+            return '[function]';
+        return String(val);
+    }
+    let lines = [];
+    // Gradient header
+    lines.push(chalk.bgMagentaBright.white.bold('  EXPLANATION (DETAILS)  '));
+    // Explain-only mode
+    if (context.explainOnly) {
+        lines.push(chalk.bgYellow.black.bold(' [explain-only] No command will be executed '));
+    }
+    // Context enrichment
+    lines.push(chalk.bgWhiteBright.gray(` Timestamp: ${safe(context.timestamp)} | User: ${safe(context.user)} | Platform: ${safe(context.platform)} | Mode: ${safe(context.mode)} `));
+    // Plugin/command info
+    if (context.plugin || context.cliVersion || context.pluginVersion) {
+        lines.push(chalk.bgWhiteBright.magenta.bold(` Plugin: ${safe(context.plugin)} | CLI Version: ${safe(context.cliVersion)} | Plugin Version: ${safe(context.pluginVersion)} `));
+    }
+    // Inputs/Outputs
+    if ((context.inputs && Object.keys(context.inputs).length > 0) || (context.outputs && Object.keys(context.outputs).length > 0)) {
+        lines.push('');
+        lines.push(chalk.bgGray.white.bold(' Inputs & Outputs: '));
+        if (context.inputs && Object.keys(context.inputs).length > 0) {
+            lines.push(chalk.whiteBright('  Inputs:'));
+            for (const [k, v] of Object.entries(context.inputs)) {
+                lines.push(chalk.gray(`    - ${k}: ${safe(v)}`));
+            }
+        }
+        if (context.outputs && Object.keys(context.outputs).length > 0) {
+            lines.push(chalk.whiteBright('  Outputs:'));
+            for (const [k, v] of Object.entries(context.outputs)) {
+                lines.push(chalk.gray(`    - ${k}: ${safe(v)}`));
+            }
+        }
+    }
+    // Technical workflow
+    if (context.explainFlow && Array.isArray(context.explainFlow) && context.explainFlow.length > 0) {
+        lines.push('');
+        lines.push(chalk.bgCyanBright.black.bold(' Technical Workflow: '));
+        for (const step of context.explainFlow) {
+            let safeStep = (typeof step === 'function') ? '[function]' : safe(step);
+            lines.push(chalk.greenBright(`  • ${safeStep}`));
+        }
+    }
+    // Flags used
+    if (context.usedFlags && Object.keys(context.usedFlags).length > 0) {
+        lines.push('');
+        lines.push(chalk.bgGray.white.bold(' Flags Used: '));
+        const userFlags = Object.entries(context.usedFlags).filter(([_, v]) => v.source === 'user');
+        const defaultFlags = Object.entries(context.usedFlags).filter(([_, v]) => v.source === 'default');
+        const systemFlags = Object.entries(context.usedFlags).filter(([_, v]) => v.source === 'system');
+        if (userFlags.length > 0) {
+            lines.push(chalk.bold('  User Flags:'));
+            for (const [k, v] of userFlags) {
+                let valueStr = safe(v.value);
+                lines.push(chalk.gray(`    - ${k}: ${valueStr}`));
+            }
+        }
+        if (defaultFlags.length > 0) {
+            lines.push(chalk.bold('  Default Flags:'));
+            for (const [k, v] of defaultFlags) {
+                let valueStr = safe(v.value);
+                lines.push(chalk.gray(`    - ${k}: ${valueStr}`));
+            }
+        }
+        if (systemFlags.length > 0) {
+            lines.push(chalk.bold('  System Flags:'));
+            for (const [k, v] of systemFlags) {
+                let valueStr = safe(v.value);
+                lines.push(chalk.gray(`    - ${k}: ${valueStr}`));
+            }
+        }
+    }
+    // Errors and warnings
+    if (context.outcome && Array.isArray(context.outcome.errors) && context.outcome.errors.length > 0) {
+        lines.push('');
+        lines.push(chalk.bgRedBright.white.bold(' Errors: '));
+        for (const err of context.outcome.errors) {
+            lines.push(chalk.redBright(`  - ${safe(err)}`));
+        }
+    }
+    if (context.outcome && Array.isArray(context.outcome.warnings) && context.outcome.warnings.length > 0) {
+        lines.push('');
+        lines.push(chalk.bgYellowBright.black.bold(' Warnings: '));
+        for (const warn of context.outcome.warnings) {
+            lines.push(chalk.yellowBright(`  - ${safe(warn)}`));
+        }
+    }
+    // Developer/technical info
+    if (context.technical && typeof context.technical === 'object' && Object.keys(context.technical).length > 0) {
+        lines.push('');
+        lines.push(chalk.bgMagentaBright.white.bold(' Technical Details: '));
+        for (const [k, v] of Object.entries(context.technical)) {
+            let valueStr = safe(v);
+            lines.push(chalk.gray(`  - ${k}: ${valueStr}`));
+        }
+    }
+    // Environment info
+    if (context.environment && typeof context.environment === 'object') {
+        lines.push('');
+        lines.push(chalk.bgGray.white.bold(' Environment: '));
+        lines.push(chalk.bold(`  cwd: ${safe(context.environment.cwd)}`));
+        lines.push(chalk.bold(`  OS: ${safe(context.environment.os)}`));
+        lines.push(chalk.bold(`  Node: ${safe(context.environment.nodeVersion)}`));
+        lines.push(chalk.bold(`  Shell: ${safe(context.environment.shell)}`));
+    }
+    // Custom plugin sections
+    if (context.customSections && Array.isArray(context.customSections)) {
+        for (const section of context.customSections) {
+            if (section.items && section.items.length > 0) {
+                lines.push('');
+                lines.push(chalk.bgMagentaBright.white.bold(` ${section.title} `));
+                for (const item of section.items) {
+                    let safeItem = (typeof item === 'function') ? '[function]' : safe(item);
+                    lines.push(chalk.magentaBright(`  • ${safeItem}`));
+                }
+            }
+        }
+    }
+    // Diagram placeholder
+    lines.push('');
+    lines.push(chalk.bgWhiteBright.gray(' Diagram: [future diagram rendering here] '));
+    // Tip
+    lines.push('');
+    lines.push(chalk.bgWhiteBright.gray(' Tip: Use --explain for a simple summary. '));
+    // Wrap all in a single box with a magenta border
+    return boxen(lines.join('\n'), {
+        padding: 1,
+        borderColor: 'magenta',
+        borderStyle: 'round',
+        backgroundColor: 'black',
+    });
+}
+//# sourceMappingURL=explainDetailsTemplate.js.map

package/dist/explain/templates/explainDetailsTemplate.js.map

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

package/dist/explain/templates/explainHumanTemplate.d.ts

@@ -0,0 +1,3 @@
+import { ExplainContext } from '../../types/explainTypes.js';
+export declare function explainHumanTemplate(context: ExplainContext): string;
+//# sourceMappingURL=explainHumanTemplate.d.ts.map

package/dist/explain/templates/explainHumanTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainHumanTemplate.d.ts","sourceRoot":"","sources":["../../../src/explain/templates/explainHumanTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAI7D,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAoHpE"}

package/dist/explain/templates/explainHumanTemplate.js

@@ -0,0 +1,111 @@
+import chalk from 'chalk';
+import boxen from 'boxen';
+export function explainHumanTemplate(context) {
+    let lines = [];
+    // Header
+    lines.push(chalk.bgBlueBright.white.bold('  EXPLANATION  '));
+    // Summary
+    if (context.summary) {
+        lines.push(chalk.bgCyanBright.black.bold(' Summary: ') + chalk.bgCyanBright.white(' ' + context.summary + ' '));
+    }
+    // Explain-only mode
+    if (context.explainOnly) {
+        lines.push(chalk.bgYellow.black.bold(' [explain-only] No files were modified. '));
+    }
+    // Context enrichment
+    function safe(val) {
+        if (val === null || val === undefined || (typeof val === 'number' && Number.isNaN(val)))
+            return 'N/A';
+        if (typeof val === 'function')
+            return '[function]';
+        return String(val);
+    }
+    lines.push(chalk.bgWhiteBright.gray(` Timestamp: ${safe(context.timestamp)} | User: ${safe(context.user)} | Platform: ${safe(context.platform)} | Mode: ${safe(context.mode)} `));
+    // Plugin/command info
+    if (context.plugin) {
+        lines.push(chalk.bgWhiteBright.blue.bold(` This command uses the "${context.plugin}" plugin. `));
+    }
+    // What will happen
+    lines.push('');
+    lines.push(chalk.bgGreenBright.black.bold(' What will happen: '));
+    if (context.decisions && context.decisions.length > 0) {
+        for (const d of context.decisions) {
+            let valueStr = safe(d.value);
+            if (typeof valueStr === 'function')
+                valueStr = '[function]';
+            let src = d.provenance || d.reason || '';
+            lines.push(chalk.greenBright(`  • ${d.key}: ${valueStr} (${src})`));
+        }
+    }
+    else {
+        lines.push(chalk.greenBright('  • The command will use default settings.'));
+    }
+    // Why these choices were made
+    if (context.decisions && context.decisions.length > 0) {
+        lines.push('');
+        lines.push(chalk.bgCyanBright.black.bold(' Why these choices were made: '));
+        for (const d of context.decisions) {
+            let src = d.provenance || d.reason || '';
+            lines.push(chalk.cyanBright(`  • ${d.key}: ${src}`));
+        }
+    }
+    // Result/Outcome
+    if (context.outcome && context.outcome.result) {
+        lines.push('');
+        lines.push(chalk.bgYellowBright.black.bold(' Result: '));
+        let resultValue = safe(context.outcome.result);
+        if (typeof resultValue === 'function')
+            resultValue = '[function]';
+        lines.push(chalk.yellowBright(`  • ${resultValue}`));
+        if (context.outcome.sideEffects && Array.isArray(context.outcome.sideEffects) && context.outcome.sideEffects.length > 0) {
+            for (const s of context.outcome.sideEffects) {
+                let side = safe(s);
+                if (typeof side === 'function')
+                    side = '[function]';
+                lines.push(chalk.yellowBright(`  • ${side}`));
+            }
+        }
+    }
+    // Placeholders for Tier 3/4
+    if (context.schemaVersion) {
+        lines.push(chalk.bgGray.white(`[schemaVersion: ${context.schemaVersion}]`));
+    }
+    if (context.exitCode !== undefined) {
+        lines.push(chalk.bgGray.white(`[exitCode: ${context.exitCode} // placeholder for future validation logic]`));
+    }
+    if (context.outcome && context.outcome.confidence) {
+        lines.push(chalk.bgGray.white(`[confidence: ${context.outcome.confidence} // placeholder for future confidence logic]`));
+    }
+    // What will NOT happen
+    if (context.outcome && context.outcome.whatWillNotHappen) {
+        lines.push('');
+        lines.push(chalk.bgRedBright.white.bold(' What will NOT happen: '));
+        for (const n of context.outcome.whatWillNotHappen) {
+            lines.push(chalk.redBright(`  • ${n}`));
+        }
+    }
+    // Custom plugin sections
+    if (context.customSections && Array.isArray(context.customSections)) {
+        for (const section of context.customSections) {
+            if (section.items && section.items.length > 0) {
+                lines.push('');
+                lines.push(chalk.bgMagentaBright.white.bold(` ${section.title} `));
+                for (const item of section.items) {
+                    let safeItem = (typeof item === 'function') ? '[function]' : item;
+                    lines.push(chalk.magentaBright(`  • ${safeItem}`));
+                }
+            }
+        }
+    }
+    // Tip
+    lines.push('');
+    lines.push(chalk.bgWhiteBright.gray(' Tip: Use --explain=details for a technical breakdown. '));
+    // Wrap all in a single box with a blue gradient border
+    return boxen(lines.join('\n'), {
+        padding: 1,
+        borderColor: 'blueBright',
+        borderStyle: 'round',
+        backgroundColor: 'black',
+    });
+}
+//# sourceMappingURL=explainHumanTemplate.js.map

package/dist/explain/templates/explainHumanTemplate.js.map

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

package/dist/formatters/explainFormatter.d.ts

@@ -1,7 +1,6 @@
-import { ExplainContext } from '../types/explainTypes.js';
-export type ExplainFormat = 'human' | 'details' | 'json';
+import { ExplainContext, ExplainMode } from '../types/explainTypes.js';
 /**
- * Main explain formatter. Returns a string (or JSON) for the given context and format.
+ * Main explain formatter. Returns a string (or JSON) for the given context and mode.
  */
-export declare function explainFormatter(context: ExplainContext, format?: ExplainFormat, tense?: 'will' | 'would' | 'did'): string | object;
+export declare function explainFormatter(context: ExplainContext, mode?: ExplainMode): string | object;
 //# sourceMappingURL=explainFormatter.d.ts.map

package/dist/formatters/explainFormatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"explainFormatter.d.ts","sourceRoot":"","sources":["../../src/formatters/explainFormatter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG1D,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,cAAc,EACvB,MAAM,GAAE,aAAuB,EAC/B,KAAK,GAAE,MAAM,GAAG,OAAO,GAAG,KAAc,GACtC,MAAM,GAAG,MAAM,CAwMjB"}
+{"version":3,"file":"explainFormatter.d.ts","sourceRoot":"","sources":["../../src/formatters/explainFormatter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAOvE;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,cAAc,EACvB,IAAI,GAAE,WAA+B,GACpC,MAAM,GAAG,MAAM,CAYjB"}