@mediaproc/core 1.4.0 → 1.5.1

package/dist/branding/branding.d.ts

@@ -1,19 +1,22 @@
 /**
- * Get version from package.json
+ * Get plugin version from package.json
+ * @param packageJsonPath - Path to the package json file
  */
-export declare function getVersion(packagePath: string): string;
+export declare function getVersion(packageJsonPath: string): string;
 /**
  * Get CLI version from root package.json
+ * @param packageJsonPath - Path to the package json file
  */
-export declare function getCliVersion(): string;
+export declare function getCliVersion(packageJsonPath: string): string;
 /**
  * Show CLI branding footer with documentation and GitHub links
+ * @param packageJsonPath - Path to main cli's package json
  */
-export declare function showBranding(): void;
+export declare function showBranding(packageJsonPath: string): void;
 /**
  * Show plugin branding footer with version
  * @param pluginName - Name of the plugin (e.g., 'image', 'video', 'audio')
- * @param pluginPath - Path to plugin's package.json
+ * @param pluginPackageJsonPath - Path to plugin's package.json
  */
-export declare function showPluginBranding(pluginName: string, pluginPath: string): void;
+export declare function showPluginBranding(pluginName: string, pluginPackageJsonPath: string): void;
 //# sourceMappingURL=branding.d.ts.map

package/dist/branding/branding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"branding.d.ts","sourceRoot":"","sources":["../../src/branding/branding.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CActC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAOnC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAO/E"}
+{"version":3,"file":"branding.d.ts","sourceRoot":"","sources":["../../src/branding/branding.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,UAAU,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAO1D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAc7D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAO1D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAO1F"}

package/dist/branding/branding.js

@@ -2,11 +2,12 @@ import { readFileSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 /**
- * Get version from package.json
+ * Get plugin version from package.json
+ * @param packageJsonPath - Path to the package json file
  */
-export function getVersion(packagePath) {
+export function getVersion(packageJsonPath) {
     try {
-        const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
         return packageJson.version || '0.0.0';
     }
     catch {
@@ -15,17 +16,18 @@ export function getVersion(packagePath) {
 }
 /**
  * Get CLI version from root package.json
+ * @param packageJsonPath - Path to the package json file
  */
-export function getCliVersion() {
+export function getCliVersion(packageJsonPath) {
     try {
         // For ES modules, use import.meta.url
         if (typeof import.meta.url !== 'undefined') {
             const currentDir = dirname(fileURLToPath(import.meta.url));
-            const packagePath = join(currentDir, '../../package.json');
+            const packagePath = join(currentDir, packageJsonPath);
             return getVersion(packagePath);
         }
         // Fallback: try from process.cwd()
-        const packagePath = join(process.cwd(), 'package.json');
+        const packagePath = join(process.cwd(), packageJsonPath);
         return getVersion(packagePath);
     }
     catch {
@@ -34,26 +36,27 @@ export function getCliVersion() {
 }
 /**
  * Show CLI branding footer with documentation and GitHub links
+ * @param packageJsonPath - Path to main cli's package json
  */
-export function showBranding() {
-    const version = getCliVersion();
+export function showBranding(packageJsonPath) {
+    const version = getCliVersion(packageJsonPath);
     console.log('\n' + '─'.repeat(60));
     console.log(`  💙 Powered by MediaProc CLI v${version}`);
     console.log('  📚 Documentation: \x1b[36mhttps://docs-mediaproc.vercel.app/\x1b[0m');
-    console.log('  ⭐ Star us: \x1b[36mhttps://github.com/0xshariq/mediaproc-cli\x1b[0m');
+    console.log('  ⭐ Star us: \x1b[36mhttps://github.com/0xshariq/mediaproc\x1b[0m');
     console.log('─'.repeat(60) + '\n');
 }
 /**
  * Show plugin branding footer with version
  * @param pluginName - Name of the plugin (e.g., 'image', 'video', 'audio')
- * @param pluginPath - Path to plugin's package.json
+ * @param pluginPackageJsonPath - Path to plugin's package.json
  */
-export function showPluginBranding(pluginName, pluginPath) {
-    const version = getVersion(pluginPath);
+export function showPluginBranding(pluginName, pluginPackageJsonPath) {
+    const version = getVersion(pluginPackageJsonPath);
     console.log('\n' + '─'.repeat(60));
     console.log(`  💙 ${pluginName.charAt(0).toUpperCase() + pluginName.slice(1)} Plugin v${version} · Powered by MediaProc`);
     console.log('  📚 Documentation: \x1b[36mhttps://docs-mediaproc.vercel.app/\x1b[0m');
-    console.log('  ⭐ Star us: \x1b[36mhttps://github.com/0xshariq/mediaproc-cli\x1b[0m');
+    console.log('  ⭐ Star us: \x1b[36mhttps://github.com/0xshariq/mediaproc\x1b[0m');
     console.log('─'.repeat(60) + '\n');
 }
 //# sourceMappingURL=branding.js.map

package/dist/branding/branding.js.map

@@ -1 +1 @@
-{"version":3,"file":"branding.js","sourceRoot":"","sources":["../../src/branding/branding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;QACnE,OAAO,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC;QACH,sCAAsC;QACtC,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,WAAW,EAAE,CAAC;YAC3C,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;YAC3D,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;QACjC,CAAC;QACD,mCAAmC;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;QACxD,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,CAAC,mBAAmB;IACrC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAG,aAAa,EAAE,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,UAAkB;IACvE,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,QAAQ,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,OAAO,yBAAyB,CAAC,CAAC;IAC1H,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;AACrC,CAAC"}
+{"version":3,"file":"branding.js","sourceRoot":"","sources":["../../src/branding/branding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,eAAuB;IAChD,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;QACvE,OAAO,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,eAAuB;IACnD,IAAI,CAAC;QACH,sCAAsC;QACtC,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,WAAW,EAAE,CAAC;YAC3C,MAAM,UAAU,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;YACtD,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;QACjC,CAAC;QACD,mCAAmC;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,eAAe,CAAC,CAAC;QACzD,OAAO,UAAU,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,CAAC,mBAAmB;IACrC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,eAAuB;IAClD,MAAM,OAAO,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;IACjF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAkB,EAAE,qBAA6B;IAClF,MAAM,OAAO,GAAG,UAAU,CAAC,qBAAqB,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,QAAQ,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,OAAO,yBAAyB,CAAC,CAAC;IAC1H,OAAO,CAAC,GAAG,CAAC,uEAAuE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC;IACjF,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;AACrC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"explainFlag.d.ts","sourceRoot":"","sources":["../../src/explain/explainFlag.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAMvE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,IAAS,EACT,OAAY,EACZ,SAAkC,EAClC,UAA0C,EAC1C,IAAwB,GACzB,EAAE;IACD,OAAO,EAAE,GAAG,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB,QAoLA"}
+{"version":3,"file":"explainFlag.d.ts","sourceRoot":"","sources":["../../src/explain/explainFlag.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAOvE;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,IAAS,EACT,OAAY,EACZ,SAAkC,EAClC,UAA0C,EAC1C,IAAwB,GACzB,EAAE;IACD,OAAO,EAAE,GAAG,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB,QAsOA"}

package/dist/explain/explainFlag.js

@@ -5,6 +5,7 @@ import { ExplainMode } from '../types/explainTypes.js';
 import os from 'os';
 import fs from 'fs';
 import path from 'path';
+import { getPhrase } from './phrases.js';
 /**
  * explainFlag - Automatically gathers command context, prints explanation, then runs the handler.
  * @param params - { commandName, args, options, handler }
@@ -12,6 +13,7 @@ import path from 'path';
 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';
+    // Must remove from human and details mode not from json mode
     const environment = {
         cwd: process.cwd(),
         os: `${os.type()} ${os.release()} (${os.platform()})`,
@@ -79,8 +81,24 @@ export function explainFlag({ command, args = {}, options = {}, inputKeys = ['in
     const omittedFlags = {};
     if (command && typeof command.options === 'object') {
         for (const opt of command.options) {
-            const flagName = opt.attributeName || opt.long?.replace(/^--/, '') || opt.short?.replace(/^-/, '');
-            if (!flagName)
+            let flagName;
+            if (typeof opt.attributeName === 'function') {
+                try {
+                    const attr = opt.attributeName();
+                    flagName = typeof attr === 'string' ? attr : undefined;
+                }
+                catch {
+                    flagName = undefined;
+                }
+            }
+            else if (typeof opt.attributeName === 'string') {
+                flagName = opt.attributeName;
+            }
+            else {
+                flagName = opt.long?.replace(/^--/, '') || opt.short?.replace(/^-/, '');
+            }
+            // Only allow string flag names, skip if not a string
+            if (!flagName || typeof flagName !== 'string')
                 continue;
             let userValue = options[flagName];
             // Handle boolean flags
@@ -122,33 +140,87 @@ export function explainFlag({ command, args = {}, options = {}, inputKeys = ['in
     // Get CLI and plugin version using branding utilities
     let cliVersion = undefined;
     let pluginVersion = undefined;
+    let plugin = undefined;
     try {
-        cliVersion = getCliVersion();
+        cliVersion = getCliVersion('../../../cli/package.json');
         // Try to get plugin version from parent command's package.json if available
         if (command?.parent?.name?.()) {
             // Assume plugin package.json is at ../../plugins/<plugin>/package.json
-            const pluginName = command.parent.name();
-            const pluginPath = `../../plugins/${pluginName}/package.json`;
+            plugin = command.parent.name();
+            const pluginPath = `../../plugins/${plugin}/package.json`;
             pluginVersion = getVersion(pluginPath);
         }
     }
     catch (error) {
         console.error(chalk.red('Error retrieving version information:'), error);
     }
-    const context = {
-        schemaVersion: '1.0', // Tier 3 placeholder
+    // Step 1: Add effects/primitives to context (plugin-agnostic)
+    const effects = [];
+    if (inputPath)
+        effects.push('inputRead');
+    if (outputPath)
+        effects.push('outputWrite');
+    if (usedFlags['width'] || usedFlags['height'])
+        effects.push('dimensionsChange');
+    if (usedFlags['quality'])
+        effects.push('qualityChange');
+    if (usedFlags['format'])
+        effects.push('formatConversion');
+    if (usedFlags['metadata'])
+        effects.push('metadataPreserved');
+    if (usedFlags['tool'] || command?.parent?.name?.())
+        effects.push('externalTool');
+    if (usedFlags['noNetwork'])
+        effects.push('noNetwork');
+    // Add more effects for other plugin types as needed
+    // Dynamic summary using enhanced phrases
+    // Build ExplainContext with plugin/command info and version
+    // (moved summary logic after context is built)
+    // Dynamic outcome and flow using enhanced phrases
+    const sideEffects = [];
+    if (usedFlags['noNetwork'])
+        sideEffects.push(getPhrase('noNetwork', plugin)());
+    if (usedFlags['metadata'])
+        sideEffects.push(getPhrase('metadataPreserved', plugin)());
+    if (usedFlags['validation'])
+        sideEffects.push(getPhrase('validation', plugin)());
+    if (usedFlags['logging'])
+        sideEffects.push(getPhrase('logging', plugin)());
+    if (usedFlags['cleanup'])
+        sideEffects.push(getPhrase('cleanup', plugin)());
+    // Add more side effects as needed
+    // Dynamic explainFlow for any plugin
+    // Will Deprecate after v1 release in favor of more detailed plugin-specific flows
+    const explainFlow = [
+        getPhrase('validation', plugin)(),
+        'Check input and output paths for validity and existence.',
+        'Prepare configuration for processing (flags/options).',
+        'Execute main processing logic for each input.',
+        getPhrase('logging', plugin)(),
+        getPhrase('cleanup', plugin)(),
+        'Show summary and any errors encountered.'
+    ];
+    // Technical details (plugin-agnostic)
+    const technical = {
+        tool: command?.parent?.name?.() || 'unknown',
+        library: options.library || 'unknown',
+        performance: options.performance || 'optimized for batch processing',
+        fileFormats: options.fileFormats || [],
+        compressionRatio: options.compressionRatio || '',
+        estimatedTime: options.estimatedTime || '',
+        memoryUsage: options.memoryUsage || '',
+    };
+    let context = {
+        schemaVersion: '1.0',
         command: commandName,
-        plugin: command?.parent?.name?.() || undefined,
+        plugin,
         cliVersion,
         pluginVersion,
-        // 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)`,
+        summary: '', // will set below
         inputs: { inputPath, outputPath, ...allInputs },
         outputs: Object.keys(allOutputs).length > 0 ? allOutputs : undefined,
         usedFlags,
@@ -159,43 +231,35 @@ export function explainFlag({ command, args = {}, options = {}, inputKeys = ['in
             reason: v.source === 'user' ? 'user specified' : (v.source === 'default' ? 'default' : 'system'),
             provenance: v.source,
         })),
+        effects,
         outcome: {
-            result: outputPath ? `A new file will be created at ${outputPath}` : 'Operation will complete',
-            sideEffects: [
-                'Input validation is performed to ensure correct file types and dimensions.',
-                'Output paths are resolved and checked for conflicts.',
-                'Image processing is performed using the selected options and flags.',
-                'Results and logs are displayed after processing each file.'
-            ],
-            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'
-            ]
+            result: '', // will set below
+            sideEffects,
+            errors: [],
+            warnings: [],
+            confidence: 'high',
+            whatWillNotHappen: [getPhrase('noNetwork', plugin)()],
         },
-        explainFlow: [
-            '1. Parse and validate all user-provided flags and arguments.',
-            '2. Check input and output paths for validity and existence.',
-            '3. Prepare configuration for image processing (width, height, quality, etc.).',
-            '4. For each input file, process and apply transformations.',
-            '5. Save output files and display results.',
-            '6. Show summary and any errors encountered.'
-        ],
-        environment,
+        explainFlow, // Will Deprecate after v1 release in favor of more detailed plugin-specific flows
+        environment, // Will Deprecate aftbeforeer v1 release
         explainOnly,
-        technical: {
-            library: 'sharp',
-            tool: 'mediaproc',
-            performance: 'optimized for batch image processing',
-            fileFormats: ['jpg', 'png', 'webp'],
-            compressionRatio: 'varies by format and quality',
-            estimatedTime: 'depends on input size and options',
-            memoryUsage: 'depends on batch size and image dimensions',
-        },
-        exitCode: 0, // Tier 3 placeholder
+        technical,
+        exitCode: 0,
     };
+    // Now set summary and result using the full context
+    if (inputPath && outputPath) {
+        context.summary = `${getPhrase('inputRead', plugin)({ context })} ${getPhrase('outputWrite', plugin)({ context })}`;
+    }
+    else if (inputPath) {
+        context.summary = getPhrase('inputRead', plugin)({ context });
+    }
+    else if (outputPath) {
+        context.summary = getPhrase('outputWrite', plugin)({ context });
+    }
+    else {
+        context.summary = getPhrase('summarySuccess', plugin);
+    }
+    context.outcome.result = outputPath ? getPhrase('outputWrite', plugin)({ context }) : 'Operation will complete';
     // Print explanation only
     const explanation = explainFormatter(context, mode);
     if (mode === ExplainMode.Json) {

package/dist/explain/explainFlag.js.map

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

package/dist/explain/phrases.d.ts

@@ -0,0 +1,15 @@
+import { CommonPhrases } from '../types/explainTypes.js';
+/**
+ * Register or override phrases for a plugin.
+ * @param pluginName The plugin name (string)
+ * @param phrases An object of phrase overrides (same shape as COMMON_PHRASES)
+ */
+export declare function registerPluginPhrases(pluginName: string, phrases: Partial<CommonPhrases>): void;
+/**
+ * Lookup a phrase, checking plugin overrides first.
+ * @param key The phrase key (string)
+ * @param pluginName Optional plugin name for override lookup
+ */
+export declare function getPhrase<K extends keyof CommonPhrases>(key: K, pluginName?: string): CommonPhrases[K];
+export declare const COMMON_PHRASES: CommonPhrases;
+//# sourceMappingURL=phrases.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"phrases.d.ts","sourceRoot":"","sources":["../../src/explain/phrases.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,0BAA0B,CAAC;AAKzE;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,QAKxF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,aAAa,EAAE,GAAG,EAAE,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,CAKtG;AAED,eAAO,MAAM,cAAc,EAAE,aA0E5B,CAAC"}

package/dist/explain/phrases.js

@@ -0,0 +1,101 @@
+// Plugin-specific phrase overrides
+const PLUGIN_PHRASES = {};
+/**
+ * Register or override phrases for a plugin.
+ * @param pluginName The plugin name (string)
+ * @param phrases An object of phrase overrides (same shape as COMMON_PHRASES)
+ */
+export function registerPluginPhrases(pluginName, phrases) {
+    PLUGIN_PHRASES[pluginName] = {
+        ...(PLUGIN_PHRASES[pluginName] || {}),
+        ...phrases,
+    };
+}
+/**
+ * Lookup a phrase, checking plugin overrides first.
+ * @param key The phrase key (string)
+ * @param pluginName Optional plugin name for override lookup
+ */
+export function getPhrase(key, pluginName) {
+    if (pluginName && PLUGIN_PHRASES[pluginName] && PLUGIN_PHRASES[pluginName][key]) {
+        return PLUGIN_PHRASES[pluginName][key];
+    }
+    return COMMON_PHRASES[key];
+}
+// Centralized reusable phrases for explain engine
+export const COMMON_PHRASES = {
+    // Section headers and static text for templates
+    header: '  EXPLANATION  ',
+    detailsHeader: '  EXPLANATION (DETAILS)  ',
+    summaryHeader: ' Summary: ',
+    commandType: 'Command Type:',
+    commandCategory: 'Command Category:',
+    commandPurpose: 'Purpose:',
+    commandInputs: 'Inputs:',
+    commandOutputs: 'Outputs:',
+    commandFlags: 'Flags:',
+    commandOptions: 'Options:',
+    commandPerformance: 'Performance:',
+    commandSecurity: 'Security:',
+    commandDependencies: 'Dependencies:',
+    commandSideEffects: 'Side Effects:',
+    commandWarnings: 'Warnings:',
+    commandLimitations: 'Limitations:',
+    commandExamples: 'Examples:',
+    commandDocs: 'Documentation:',
+    commandAuthor: 'Author:',
+    commandVersion: 'Version:',
+    commandLastModified: 'Last Modified:',
+    commandRelated: 'Related Commands:',
+    explainOnly: ' [explain-only] No files were modified. ',
+    contextEnrichmentPrefix: ' Timestamp: ',
+    user: 'User:',
+    platform: 'Platform:',
+    mode: 'Mode:',
+    pluginInfoPrefix: ' This command uses the ',
+    pluginInfoSuffix: ' plugin. ',
+    whatWillHappenHeader: ' What will happen: ',
+    whyChoicesHeader: ' Why these choices were made: ',
+    resultHeader: ' Result: ',
+    schemaVersionPrefix: '[schemaVersion: ',
+    exitCodePrefix: '[exitCode: ',
+    confidencePrefix: '[confidence: ',
+    whatWillNotHappenHeader: ' What will NOT happen: ',
+    inputsOutputsHeader: ' Inputs & Outputs: ',
+    effectsHeader: ' Effects & Primitives: ',
+    technicalWorkflowHeader: ' Technical Workflow: ',
+    flagsUsedHeader: ' Flags Used: ',
+    errorsHeader: ' Errors: ',
+    warningsHeader: ' Warnings: ',
+    technicalDetailsHeader: ' Technical Details: ',
+    environmentHeader: ' Environment: ',
+    diagramPlaceholder: ' Diagram: (visual summary or workflow will appear here) ',
+    inputRead: ({ context }) => `The input file "${context?.inputs?.inputPath ?? context?.inputs?.input ?? 'unknown'}" will be read from disk, ensuring the correct format and accessibility.`,
+    outputWrite: ({ context }) => `A new file will be written to the output path "${context?.outputs?.outputPath ?? context?.outputs?.output ?? 'unknown'}", with all changes applied.`,
+    noNetwork: () => 'No network requests will be made, guaranteeing local-only processing.',
+    externalTool: ({ context }) => `Processing will be performed using the external tool: ${context?.technical?.tool ?? 'unknown'}.`,
+    dimensionsChange: ({ context }) => `The dimensions will be changed to width=${context?.usedFlags?.width?.value ?? '?'} and height=${context?.usedFlags?.height?.value ?? '?'}.`,
+    formatConversion: ({ context }) => `Format will be converted to ${context?.usedFlags?.format?.value ?? 'unknown'}, ensuring compatibility and optimal quality.`,
+    qualityChange: ({ context }) => `Quality will be set to ${context?.usedFlags?.quality?.value ?? '?'} for optimal output fidelity.`,
+    metadataPreserved: () => 'Metadata will be preserved in the output file, retaining important information.',
+    audioProcessing: ({ context }) => `Audio will be processed with effects: ${context?.usedFlags?.effects?.value ?? 'none'}.`,
+    videoProcessing: ({ context }) => `Video will be processed with codec: ${context?.usedFlags?.codec?.value ?? 'default'}.`,
+    documentProcessing: ({ context }) => `Document will be processed with format: ${context?.usedFlags?.format?.value ?? 'default'}.`,
+    streamProcessing: ({ context }) => `Stream will be processed in real-time with protocol: ${context?.usedFlags?.protocol?.value ?? 'default'}.`,
+    pipelineExecution: ({ context }) => `Pipeline will be executed with ${Array.isArray(context?.steps) ? context.steps.length : 0} steps, orchestrating multiple plugin actions for advanced workflows.`,
+    pluginAction: ({ context }) => `Action will be performed by plugin: ${context?.plugin ?? 'unknown'}, leveraging its specialized capabilities.`,
+    errorHandling: () => 'Errors will be handled gracefully, with clear reporting and recovery strategies.',
+    validation: () => 'Validation will be performed on all inputs, ensuring correctness and safety.',
+    outputPreview: () => 'A preview of the output will be generated for user review before finalization.',
+    logging: () => 'Detailed logs will be generated for this operation, aiding in troubleshooting and auditing.',
+    cleanup: () => 'Temporary files and resources will be cleaned up after processing to maintain system hygiene.',
+    summarySuccess: 'Operation completed successfully.',
+    summaryFailure: 'Operation failed. Please review the logs and errors.',
+    summaryPartial: 'Operation completed with some warnings or errors.',
+    warningDeprecated: (flag) => `Warning: The flag "${flag}" is deprecated and may be removed in future versions.`,
+    warningIgnored: (flag) => `Warning: The flag "${flag}" was ignored due to incompatibility or redundancy.`,
+    tipDetails: 'Tip: Use --explain=details for a technical breakdown of the operation.',
+    tipJson: 'Tip: Use --explain=json to get a machine-readable explanation.',
+    tipHuman: 'Tip: Use --explain=human for a user-friendly summary.'
+};
+//# sourceMappingURL=phrases.js.map

package/dist/explain/phrases.js.map

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

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

@@ -1 +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"}
+{"version":3,"file":"explainDetailsTemplate.d.ts","sourceRoot":"","sources":["../../../src/explain/templates/explainDetailsTemplate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAK7D,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAmMtE"}