prodex 2.0.0 → 2.0.1

package/README.md

@@ -45,11 +45,11 @@ They are one of Prodex's most useful workflow features: instead of rebuilding th
 ```bash
 prodex run --profile dashboard
 prodex run --profile auth,billing
-prodex run --all-profiles
+prodex run --all
 prodex profiles
 ```
 
-Use profiles when a project has recurring review surfaces or ownership areas. A profile can define its own entries, includes, excludes, and optional output name; when no output name is set, the profile key becomes the trace basename. This makes context extraction repeatable across debugging, reviews, documentation, handoffs, and release work. Run one profile, a comma-separated set of profiles, or all profiles when you need a broader pass.
+Use profiles when a project has recurring review surfaces or ownership areas. A profile can define its own entries, includes, excludes, and optional output name; when no output name is set, the profile key becomes the trace basename. This makes context extraction repeatable across debugging, reviews, documentation, handoffs, and release work. Run one profile, a comma-separated set of profiles, or all profiles with `--all` when you need a broader pass.
 
 Example:
 
@@ -106,7 +106,9 @@ Versioned filenames are enabled by default so repeated runs do not overwrite ear
 
 Prodex's broader identity is controlled context extraction, not a single-framework tool.
 
-Today it works best with projects that use JavaScript, TypeScript, PHP, React, and Laravel-aware structures. Current tracing support includes JS/TS imports, dynamic imports, CommonJS `require`, re-exports, static PHP include/require statements, PHP namespace imports, PSR-4 resolution, and some Laravel binding awareness.
+Include-only extraction is language-agnostic: any source or text file matched by `--include` or a profile `include` rule can be added to a trace.
+
+Dependency tracing is resolver-based. Today Prodex traces JavaScript, TypeScript, TSX, declaration files, and PHP entrypoints. Current tracing support includes JS/TS imports, dynamic imports, CommonJS `require`, re-exports, static PHP include/require statements, PHP namespace imports, PSR-4 resolution, and some Laravel binding awareness.
 
 Unsupported or dynamic relationships may need to be added with `--include` or profile `include` rules. That is expected: Prodex favors a focused, readable trace over pretending to understand every runtime edge in a project.
 
@@ -135,7 +137,7 @@ prodex run [root] --entry src/index.ts
 prodex run [root] --entry routes/web.php --include "**/*.d.ts"
 prodex run [root] --profile dashboard
 prodex run [root] --profile dashboard,api
-prodex run [root] --all-profiles
+prodex run [root] --all
 prodex profiles [root]
 prodex migrate [root]
 ```
@@ -150,12 +152,11 @@ prodex migrate [root]
 | `--include` | `-i` | list | Extra file or glob to add without dependency tracing. Repeatable and comma-aware. |
 | `--exclude` | `-x` | list | File or glob to skip during traversal. Repeatable and comma-aware. |
 | `--profile` | `-p` | list | Named profile to run. Comma-aware and repeatable. |
-| `--all-profiles` |  | boolean | Run every configured profile. |
+| `--all` | `-a` | boolean | Run every configured profile. `--all-profiles` remains available as an explicit alias. |
 | `--name` | `-n` | string | Output basename for this run. |
 | `--format` | `-F` | `md`/`txt` | Output format. Markdown is the default. |
 | `--max-depth` |  | number | Maximum dependency traversal depth. |
 | `--max-files` |  | number | Maximum traced file count. |
-| `--debug` | `-d` | boolean | Emit debug logs during traversal. |
 
 Global metadata flags:
 
@@ -229,8 +230,9 @@ prodex migrate --write
 
 ## Requirements
 
-- Node.js 18+
-- A project with resolvable JS, TS, or PHP entry files
+- Node.js 22+
+- A project with JS, TS, TSX, declaration-file, or PHP entrypoints for dependency tracing
+- Any file type can be added through include-only extraction
 - Optional `prodex.json` for saved defaults and profiles
 
 ## License

package/dist/app/execute-run.js

@@ -52,6 +52,7 @@ async function executeRun(plan) {
         root: plan.root,
         mode,
         outputPath: result.outputPath,
+        outputName: plan.outputName,
         entries,
         includes,
         files: result.files,

package/dist/cli/flag-specs.js

@@ -7,7 +7,7 @@ exports.FLAGS = [
     { long: "include", short: "i", type: "list" },
     { long: "exclude", short: "x", type: "list" },
     { long: "profile", short: "p", type: "list" },
-    { long: "allProfiles", type: "boolean" },
+    { long: "allProfiles", short: "a", type: "boolean" },
     { long: "name", short: "n", type: "string" },
     { long: "format", short: "F", type: "string" },
     { long: "maxDepth", type: "number" },
@@ -19,6 +19,7 @@ exports.FLAGS = [
     { long: "version", short: "v", type: "boolean" },
 ];
 exports.FLAG_ALIASES = {
+    all: "allProfiles",
     "all-profiles": "allProfiles",
     "max-depth": "maxDepth",
     "max-files": "maxFiles",

package/dist/cli/help.js

@@ -42,12 +42,12 @@ function renderRunHelp() {
         "  -i, --include <glob>      Extra file/glob to append. Repeatable and comma-aware.",
         "  -x, --exclude <glob>      File/glob to skip. Repeatable and comma-aware.",
         "  -p, --profile <name>      Run a named profile. Repeatable.",
-        "  --all-profiles            Run every configured profile.",
+        "  -a, --all                 Run every configured profile.",
+        "  --all-profiles            Alias for --all.",
         "  -n, --name <name>         Output basename for this run.",
         "  -F, --format <md|txt>     Output format.",
         "  --max-depth <number>      Maximum dependency traversal depth.",
         "  --max-files <number>      Maximum traced file count.",
-        "  -d, --debug               Enable debug logs.",
         "  -h, --help                Show run help.",
     ].join("\n");
 }

package/dist/cli/report-command.js

@@ -17,20 +17,34 @@ function reportCommandResult(result) {
         reportProfiles(result.profiles);
     if (result.migration)
         reportMigration(result.migration);
-    for (const run of result.runs)
-        reportRun(run);
+    reportRuns(result.runs);
 }
-function reportRun(run) {
+function reportRuns(runs) {
+    for (const run of runs) {
+        reportRunWarningsAndErrors(run);
+    }
+    const successfulRuns = runs.filter((run) => run.outputPath);
+    if (!successfulRuns.length)
+        return;
+    const rows = successfulRuns.map((run) => ({
+        label: formatRunLabel(run),
+        mode: run.mode,
+        files: String(run.files.length),
+        output: formatPath(run.outputPath, run.root),
+    }));
+    const labelWidth = maxWidth(rows.map((row) => row.label));
+    const modeWidth = maxWidth(rows.map((row) => row.mode));
+    const filesWidth = maxWidth(rows.map((row) => row.files));
+    for (const row of rows) {
+        console.log(`✓ ${row.label.padEnd(labelWidth)}  ${row.mode.padEnd(modeWidth)}  ${row.files.padStart(filesWidth)}  ${row.output}`);
+    }
+}
+function reportRunWarningsAndErrors(run) {
     const label = run.profile ? ` [${run.profile}]` : "";
     for (const warning of run.warnings)
         console.warn(`Warning${label}: ${warning}`);
     for (const error of run.errors)
         console.error(`Error${label}: ${error}`);
-    if (!run.outputPath)
-        return;
-    console.log(`Created${label}: ${formatPath(run.outputPath, run.root)}`);
-    console.log(`Mode${label}: ${formatMode(run)}`);
-    console.log(`Files${label}: ${run.files.length} total`);
 }
 function reportMigration(migration) {
     if (migration.errors.length)
@@ -64,6 +78,17 @@ function reportProfiles(profiles) {
     for (const profile of profiles)
         console.log(`  ${profile}`);
 }
+function formatRunLabel(run) {
+    if (run.profile)
+        return run.profile;
+    if (run.outputName)
+        return run.outputName;
+    if (!run.outputPath)
+        return "run";
+    const ext = path_1.default.extname(run.outputPath);
+    const base = path_1.default.basename(run.outputPath, ext);
+    return base.replace(/-trace(?:_\d{6}-\d{4})?$/, "") || "run";
+}
 function formatPath(filePath, root) {
     const absolute = path_1.default.resolve(filePath);
     const relative = path_1.default.relative(root, absolute);
@@ -71,10 +96,6 @@ function formatPath(filePath, root) {
         return (0, path_2.normalizePath)(relative);
     return (0, path_2.normalizePath)(absolute);
 }
-function formatMode(run) {
-    if (run.mode === "include-only")
-        return `include-only (${run.includes.length} include patterns)`;
-    if (run.mode === "mixed")
-        return `trace + includes (${run.entries.length} entries, ${run.includes.length} include patterns)`;
-    return `trace (${run.entries.length} entries)`;
+function maxWidth(values) {
+    return values.reduce((max, value) => Math.max(max, value.length), 0);
 }

package/dist/types/app.types.d.ts

@@ -41,6 +41,7 @@ export interface RunResult {
     root: string;
     mode: "trace" | "include-only" | "mixed";
     outputPath?: string;
+    outputName?: string;
     entries: string[];
     includes: string[];
     files: string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prodex",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Focused code-context extractor for large projects.",
   "type": "commonjs",
   "packageManager": "npm@11.12.1",