vieval 0.0.4 → 0.0.6

package/README.md

@@ -93,7 +93,8 @@ Use these fields to group and compare runs across models, rubrics, and scenarios
 
 ```mermaid
 flowchart LR
-  CLI["src/cli/index.ts\n(runTopLevelCli)"] --> RUN["src/cli/run.ts\n(runVievalCli + formatter)"]
+  BIN["src/bin/vieval.ts\n(executable shim)"] --> CLI["src/cli/index.ts\n(runTopLevelCli)"]
+  CLI --> RUN["src/cli/run.ts\n(runVievalCli + formatter)"]
   RUN --> CFG["src/cli/config.ts\n(loadVievalCliConfig)"]
   RUN --> DISC["src/cli/discovery.ts\n(discoverEvalFiles)"]
   RUN --> REG["src/dsl/registry.ts\n(module registrations)"]
@@ -131,6 +132,7 @@ flowchart LR
 ```mermaid
 sequenceDiagram
   participant U as User
+  participant B as src/bin/vieval.ts
   participant C as src/cli/index.ts
   participant R as src/cli/run.ts
   participant L as src/cli/config.ts
@@ -139,7 +141,8 @@ sequenceDiagram
   participant T as src/dsl/task.ts
   participant P as src/cli/reporters/*
 
-  U->>C: pnpm run eval:run -- --config ...
+  U->>B: pnpm run eval:run -- --config ...
+  B->>C: runTopLevelCli(argv)
   C->>R: runVievalCli(options)
   R->>L: loadVievalCliConfig()
   R->>D: discoverEvalFiles()
@@ -235,7 +238,7 @@ pnpm -F vieval eval:run
 pnpm -F vieval eval:run -- --config ./vieval.config.ts
 pnpm -F vieval eval:run -- --config ./vieval.config.ts --project chess --project moderation
 pnpm -F vieval eval:run -- --json
-pnpm -F vieval exec tsx src/cli/index.ts compare --config ../../vieval.config.ts --comparison <comparison-id>
+pnpm -F vieval exec tsx src/bin/vieval.ts compare --config ../../vieval.config.ts --comparison <comparison-id>
 pnpm -F vieval eval:run -- --help
 ```
 

package/dist/bin/vieval.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/bin/vieval.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import { n as runTopLevelCli } from "../cli-sanbKtQq.mjs";
+import process from "node:process";
+import { errorMessageFrom } from "@moeru/std";
+//#region src/bin/vieval.ts
+/**
+* Bootstraps the published `vieval` executable.
+*
+* Call stack:
+*
+* package manager shim / direct node execution
+*   -> {@link runTopLevelCli} (`../cli`)
+*     -> subcommand orchestration modules
+*
+* Use when:
+* - the installed `vieval` binary starts from the command line
+* - process-bound startup must stay outside import-safe CLI modules
+*
+* Expects:
+* - `process.argv` contains the raw CLI arguments after the node executable path
+*
+* Returns:
+* - resolves after the selected subcommand finishes and updates `process.exitCode`
+*/
+runTopLevelCli(process.argv.slice(2)).catch((error) => {
+	const errorMessage = errorMessageFrom(error) ?? "Unknown CLI failure.";
+	process.stderr.write(`[vieval] ${errorMessage}\n`);
+	process.exitCode = 1;
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=vieval.mjs.map

package/dist/bin/vieval.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"vieval.mjs","names":[],"sources":["../../src/bin/vieval.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport process from 'node:process'\n\nimport { errorMessageFrom } from '@moeru/std'\n\nimport { runTopLevelCli } from '../cli/index'\n\n/**\n * Bootstraps the published `vieval` executable.\n *\n * Call stack:\n *\n * package manager shim / direct node execution\n *   -> {@link runTopLevelCli} (`../cli`)\n *     -> subcommand orchestration modules\n *\n * Use when:\n * - the installed `vieval` binary starts from the command line\n * - process-bound startup must stay outside import-safe CLI modules\n *\n * Expects:\n * - `process.argv` contains the raw CLI arguments after the node executable path\n *\n * Returns:\n * - resolves after the selected subcommand finishes and updates `process.exitCode`\n */\nrunTopLevelCli(process.argv.slice(2)).catch((error) => {\n  const errorMessage = errorMessageFrom(error) ?? 'Unknown CLI failure.'\n  process.stderr.write(`[vieval] ${errorMessage}\\n`)\n  process.exitCode = 1\n})\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AA2BA,eAAe,QAAQ,KAAK,MAAM,EAAE,CAAC,CAAC,OAAO,UAAU;CACrD,MAAM,eAAe,iBAAiB,MAAM,IAAI;AAChD,SAAQ,OAAO,MAAM,YAAY,aAAa,IAAI;AAClD,SAAQ,WAAW;EACnB"}

package/dist/cli/index.d.mts

@@ -4,7 +4,39 @@ interface ParsedTopLevelCliArguments {
   command: Command | 'help';
   commandArgv: string[];
 }
+/**
+ * Parses top-level `vieval` CLI arguments into one command dispatch payload.
+ *
+ * Use when:
+ * - the executable needs to resolve which subcommand should run
+ * - tests need stable top-level argv normalization without invoking subcommands
+ *
+ * Expects:
+ * - argv excludes the node executable and script path
+ *
+ * Returns:
+ * - the normalized top-level command plus subcommand argv
+ */
 declare function parseTopLevelCliArguments(argv: readonly string[]): ParsedTopLevelCliArguments;
+/**
+ * Dispatches the top-level `vieval` command to one concrete subcommand module.
+ *
+ * Call stack:
+ *
+ * published executable (`../bin/vieval`)
+ *   -> {@link runTopLevelCli}
+ *     -> {@link runEvalRunCli} / report CLI / compare CLI
+ *
+ * Use when:
+ * - the executable or tests need import-safe CLI orchestration
+ * - subcommands should remain reusable without process-bound startup code
+ *
+ * Expects:
+ * - argv excludes the node executable and script path
+ *
+ * Returns:
+ * - resolves after the selected subcommand completes
+ */
 declare function runTopLevelCli(argv: readonly string[]): Promise<void>;
 //#endregion
 export { parseTopLevelCliArguments, runTopLevelCli };