model-orchestrator 0.1.7 → 0.1.9

package/CHANGELOG.md

@@ -4,6 +4,28 @@ All notable changes to this project are documented here. The format follows [Kee
 
 ## [Unreleased]
 
+## [0.1.9] - 2026-09-06
+
+### Added
+
+- `--version` and `-v` on the installer, printing the package version and exiting before anything else is validated, so it answers from a broken or half-configured directory.
+- A "Vendor version compatibility" section in the README, naming the exact vendor CLI version each lane was built against, and saying plainly that the installer checks a binary's presence and never its version. Closes the compatibility-statement item on #11.
+
+### Fixed
+
+- `-h` and `-v` are now parsed. Both were listed in the flag table but unreachable, because parsing required a `--` prefix and rejected every single-dash argument. Strictness is unchanged: `-x` is still `unexpected argument`, `--versionn` still `unknown flag`.
+
+### Changed
+
+- The live-canary question on #11 is answered by design rather than left open: the canary is `cli-run --doctor --run`, which runs on the user's machine against the user's own sign-ins. A maintainer-credential canary in CI would prove one machine works and bill per run, so it is documented as deliberately absent.
+
+## [0.1.8] - 2026-09-06
+
+### Added
+
+- `author` in `package.json`, so npm shows a byline: `aunysillyme (https://github.com/aunysillyme)`.
+- The installer's last line now points at the repository, on the reasoning that the end of a successful install is the moment a user is most likely to act on it.
+
 ## [0.1.7] - 2026-09-05
 
 ### Fixed
@@ -122,6 +144,8 @@ First release.
 - Adversarial audit: two Codex rounds plus a two-engine review (Codex, Antigravity); findings and fixes in `docs/audit-brief.md`. After the review: subagents go to the project root (`--project`), snippet paths computed from `--dir`, lane sections rendered from the selection, a primary agent required, level 3 asks for API keys separately from CLIs, images and CLI installs pinned, an activation summary at the end of every install.
 
 [Unreleased]: https://github.com/aunysillyme/model-orchestrator/compare/v0.1.7...HEAD
+[0.1.9]: https://github.com/aunysillyme/model-orchestrator/compare/v0.1.8...v0.1.9
+[0.1.8]: https://github.com/aunysillyme/model-orchestrator/compare/v0.1.7...v0.1.8
 [0.1.7]: https://github.com/aunysillyme/model-orchestrator/compare/v0.1.6...v0.1.7
 [0.1.6]: https://github.com/aunysillyme/model-orchestrator/compare/v0.1.5...v0.1.6
 [0.1.5]: https://github.com/aunysillyme/model-orchestrator/compare/v0.1.4...v0.1.5

package/README.md

@@ -108,6 +108,28 @@ Most of what this package ships is text an agent is asked to follow. Be clear ab
 
 If you need a property in the third row to be enforced, that is a router, a policy engine or a sandbox, and this package does not claim to be one.
 
+### Vendor version compatibility
+
+**This package detects that a binary exists. It does not check its version, and a present binary is not a working lane.** `--doctor` reports presence, and with `--run` sends one lane a one-word canary; neither validates that the vendor's flags, output shape or auth still match what the generated files assume.
+
+The lane wiring and the output judges were written against these versions, which are the ones this release was exercised on:
+
+| Lane | Vendor | Version this release was built against |
+|---|---|---|
+| `claude` | Anthropic | 2.1.226 |
+| `codex` | OpenAI | codex-cli 0.153.4 |
+| `agy` | Google | 1.1.27 |
+| `grok` | xAI | 1.0.5 |
+| `hermes` | Nous Research | 0.20.0 |
+| `qwen` | Alibaba | 0.22.3 |
+| `ollama` | local | 0.33.3 |
+
+Recorded on 2026-09-06 from the maintainer's own installs, by running each CLI's own version flag. Nothing here is pinned: these CLIs ship breaking flag changes on their own schedules, so a newer version may work perfectly, or may change a flag the generated wiring passes. When a lane starts failing after a vendor upgrade, compare against this table first.
+
+**The live canary runs on your machine, with your credentials.** That is what `node bin/cli-run.mjs --doctor --run` is: it sends every enabled lane one tiny prompt through your own sign-ins and reports `canary ok` or `canary FAILED rc=` per lane. Run it after install, and again after any vendor upgrade.
+
+It deliberately does not run in this repository's CI. A canary is only meaningful against real credentials, and there are no credentials a maintainer could supply that would tell **you** anything about **your** lanes: your sign-ins, your quota, your vendor versions. A maintainer-credential canary in CI would prove one machine works and bill someone per run to do it. So CI runs the full suite against stub lanes on Ubuntu and macOS, Node 18/20/22, plus a packaged install into a clean consumer, and the live check ships to you instead.
+
 ## Principles the whole thing rests on
 
 1. **Route by capability tier, not model name.** Default down, escalate on evidence.

package/bin/cli.js

@@ -17,13 +17,18 @@ import { planFiles, writeFiles, resolveSelection, resolveTools, resolveApis, dir
 // turn a dry run into a real one.
 const SPEC = {
   level: 'value', ais: 'value', primary: 'value', dir: 'value', project: 'value', tools: 'value', apis: 'value',
-  yes: 'bool', force: 'bool', dry: 'bool', 'dry-run': 'bool', 'no-install': 'bool', 'no-tools': 'bool', 'no-apis': 'bool', 'upgrade-runtime': 'bool', 'update-docs': 'bool', list: 'bool', help: 'bool', h: 'bool'
+  yes: 'bool', force: 'bool', dry: 'bool', 'dry-run': 'bool', 'no-install': 'bool', 'no-tools': 'bool', 'no-apis': 'bool', 'upgrade-runtime': 'bool', 'update-docs': 'bool', list: 'bool', help: 'bool', h: 'bool', version: 'bool', v: 'bool'
 };
 export function parseArgs(argv) {
   const out = {};
   const errors = [];
   for (let i = 0; i < argv.length; i++) {
-    const a = argv[i];
+    let a = argv[i];
+    // The only single-dash forms, both bool: everything else stays strict, so a
+    // typo cannot be silently absorbed as a short flag. `-h`/`-v` were listed in
+    // SPEC before 0.1.9 but unreachable, because parsing required a `--` prefix.
+    if (a === '-h') a = '--help';
+    else if (a === '-v') a = '--version';
     if (!a.startsWith('--')) {
       errors.push(`unexpected argument: ${a}`);
       continue;
@@ -69,6 +74,14 @@ if (parsed.errors.length) {
 const flag = (name) => parsed.out[name] === true;
 const opt = (name) => (typeof parsed.out[name] === 'string' ? parsed.out[name] : null);
 
+// Answered before anything else is validated, so `--version` works from a
+// broken or half-configured directory: the one question a user asks when they
+// are about to file a bug must never depend on the rest of the run.
+if (flag('version') || flag('v')) {
+  console.log(GENERATOR_VERSION);
+  process.exit(0);
+}
+
 if (flag('help') || flag('h')) {
   console.log(`model-orchestrator: set up a model orchestrator for the AIs you actually have.
 
@@ -96,6 +109,8 @@ Flags
   --dry, --dry-run   print the plan, write nothing
   --no-install       never offer to run npm installs
   --list             print the catalog
+  --version, -v      print the version and exit
+  --help, -h         print this and exit
 `);
   process.exit(0);
 }
@@ -359,7 +374,8 @@ async function main() {
   if (level >= 3) steps.push(`box: read ${join(dir, 'vm', 'README.md')}; keys named in vm/ENVIRONMENT.md go in your secrets manager, never a file`);
   console.log('\nTo activate, in order:');
   steps.forEach((st, i) => console.log(`  ${i + 1}. ${st}`));
-  console.log(`\nStart here: ${join(dir, 'README.md')} (written for level ${level} and the AIs you picked).\n`);
+  console.log(`\nStart here: ${join(dir, 'README.md')} (written for level ${level} and the AIs you picked).`);
+  console.log('\nIf this saved you time, a star helps people find it: https://github.com/aunysillyme/model-orchestrator\n');
   rl && rl.close();
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "model-orchestrator",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "A model orchestrator you can npm run: route every task to the cheapest AI that does it well, across one agent, many CLIs, or a whole virtual machine. Three levels, one installer that asks what you have access to.",
   "type": "module",
   "bin": {
@@ -48,5 +48,6 @@
     "multi-agent",
     "cli"
   ],
+  "author": "aunysillyme (https://github.com/aunysillyme)",
   "license": "MIT"
 }