model-orchestrator 0.1.35 → 1.0.1

package/scripts/gen-catalog.js

@@ -1,81 +0,0 @@
-#!/usr/bin/env node
-// Regenerates docs/catalog.md and the README's vendor compatibility table from
-// src/catalog.js. The test suite checks they agree, so neither can drift (#23).
-import { writeFileSync, readFileSync } from 'node:fs';
-import { AIS, LEVELS, TOOLS, IMAGES, npmSpec } from '../src/catalog.js';
-import { readdirSync } from 'node:fs';
-
-export function protocolCount() {
-  return readdirSync(new URL('../templates/common/protocols/', import.meta.url)).filter((f) => f.endsWith('.md') && f !== 'README.md').length;
-}
-
-export function catalogMarkdown() {
-  let md = '# Catalog\n\nGenerated from `src/catalog.js`. Do not hand-edit; `npm run gen:catalog` rewrites it. Protocols shipped at every level: ' + protocolCount() + ' (counted from `templates/common/protocols/`).\n\n## Levels\n\n| Level | Name | Tagline | Gives |\n|---|---|---|---|\n';
-  for (const l of LEVELS) md += `| ${l.id} | ${l.name} | ${l.tagline} | ${l.gives} |\n`;
-  md += '\n## AIs\n\n';
-  for (const a of AIS) {
-    const how = a.install.npm
-      ? '`npm install -g ' + npmSpec(a) + '`'
-      : a.install.script
-        ? 'vendor script (read it first): `' + a.install.script + '`'
-        : a.install.url + (a.install.brew ? ' (or `brew install ' + a.install.brew + '`)' : '');
-    md += `### \`${a.id}\` · ${a.name}\n\n- **Kind:** ${a.kind} · **Access:** ${a.access} · **Lane:** ${a.lane} · **Level:** ${a.minLevel}+\n- **Wins at:** ${a.role}\n- **Install:** ${how}\n- **Sign in:** ${a.auth}\n`;
-    if (a.rulesFile) md += `- **Reads rules from:** \`${a.rulesFile}\`` + (a.agentsDir ? ` · subagents in \`${a.agentsDir}/\`` : '') + '\n';
-    if (a.cliRun) md += '- **cli-run lane:** yes\n';
-    if (a.plans) {
-      md += '- **Plans:**\n';
-      for (const p of a.plans) md += `  - ${p.name} (${p.headroom} headroom, checked ${p.checked}): ${p.source}\n`;
-    }
-    if (a.builtAgainst) md += `- **Built against:** ${a.builtAgainst}` + (a.install.npm ? ' (the same number the npm pin uses)' : '') + '\n';
-    if (a.note) md += `- **Note:** ${a.note}\n`;
-    md += '\n';
-  }
-  md += '## Companion tools\n\n';
-  for (const t of TOOLS) {
-    md += `### \`${t.id}\` · ${t.name}\n\n- **Repo:** ${t.repo}\n- **Gives:** ${t.role}\n- **Install:** \`${t.install}\` (needs ${t.requires})\n- **Registers itself with:** ${t.autoClients.join(', ')}; snippets for the rest are written to \`mcp/\`\n- **Default:** ${t.recommended ? 'selected' : 'not selected'}\n\n`;
-  }
-  return md;
-}
-
-export const VENDOR_TABLE_START = '<!-- vendor-table:start -->';
-export const VENDOR_TABLE_END = '<!-- vendor-table:end -->';
-
-export function fixtureManifest() {
-  return JSON.parse(readFileSync(new URL('../test/fixtures/manifest.json', import.meta.url), 'utf8'));
-}
-
-// The compatibility table in README.md. Every number comes from `builtAgainst`
-// in src/catalog.js, which is also the npm pin where there is one, so "built
-// against" and "pinned to" are the same number by construction (#23).
-export function vendorTableMarkdown() {
-  const fx = fixtureManifest();
-  const byLane = Object.fromEntries(fx.fixtures.map((f) => [f.lane, f]));
-  let md = VENDOR_TABLE_START + '\n\n| Lane | Vendor | Version this release was built against | Where that number is proved |\n|---|---|---|---|\n';
-  for (const a of AIS) {
-    if (!a.bin || !a.builtAgainst) continue;
-    const proof = byLane[a.id]
-      ? '`test/fixtures/' + byLane[a.id].file + '`, a recorded run'
-      : a.install.npm
-        ? 'the npm pin the installer writes, `' + npmSpec(a) + '`'
-        : a.id === 'ollama'
-          ? 'the pinned image the level 3 box runs, `' + IMAGES.ollama + '`'
-          : "the maintainer's own install";
-    md += `| \`${a.bin}\` | ${a.vendor} | ${a.builtAgainst} | ${proof} |\n`;
-  }
-  md += `\nGenerated from \`src/catalog.js\` by \`npm run gen:catalog\`; \`npm test\` fails if this table and the catalog disagree. Fixtures were captured ${fx.capturedAt}.\n\n` + VENDOR_TABLE_END;
-  return md;
-}
-
-export function readmeWithVendorTable(current) {
-  const a = current.indexOf(VENDOR_TABLE_START);
-  const b = current.indexOf(VENDOR_TABLE_END);
-  if (a === -1 || b === -1) throw new Error('README.md has no vendor-table markers');
-  return current.slice(0, a) + vendorTableMarkdown() + current.slice(b + VENDOR_TABLE_END.length);
-}
-
-if (process.argv[1] && process.argv[1].endsWith('gen-catalog.js')) {
-  writeFileSync(new URL('../docs/catalog.md', import.meta.url), catalogMarkdown());
-  const readmeUrl = new URL('../README.md', import.meta.url);
-  writeFileSync(readmeUrl, readmeWithVendorTable(readFileSync(readmeUrl, 'utf8')));
-  console.log('docs/catalog.md and the README vendor table regenerated');
-}

package/scripts/gen-plugin.js

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-// Regenerates the Claude Code plugin bundle under plugin/ from the installer's
-// templates (src/plugin.js has the plan). The test suite checks the committed
-// bundle matches, so an agent or hook edited in templates/ cannot ship to npm
-// users and silently not to plugin users.
-import { writeFileSync, mkdirSync } from 'node:fs';
-import { join, dirname } from 'node:path';
-import { planPluginFiles, PLUGIN_DIR } from '../src/plugin.js';
-
-const files = planPluginFiles();
-for (const f of files) {
-  const abs = join(PLUGIN_DIR, ...f.rel.split('/'));
-  mkdirSync(dirname(abs), { recursive: true });
-  writeFileSync(abs, f.content);
-}
-console.log('plugin/ regenerated: ' + files.length + ' files');

package/scripts/record-demo.sh

@@ -1,45 +0,0 @@
-#!/usr/bin/env bash
-# Re-records docs/demo.gif from the PUBLISHED package, so the frames are the
-# program's own output and anyone can reproduce them.
-#
-#   bash scripts/record-demo.sh            # records the current published version
-#   bash scripts/record-demo.sh 0.1.27     # pins a version
-#
-# Needs asciinema (the recorder) and agg (cast to GIF), both from the asciinema
-# project: brew install asciinema agg
-set -euo pipefail
-
-VERSION="${1:-latest}"
-REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-OUT="$REPO_ROOT/docs/demo.gif"
-WORK="$(mktemp -d)"
-trap 'rm -rf "$WORK"' EXIT
-
-for tool in asciinema agg npm; do
-  command -v "$tool" >/dev/null || { echo "missing: $tool (brew install asciinema agg)" >&2; exit 1; }
-done
-
-# Installed locally first, so the recorded npx call resolves from node_modules
-# and never stops on npx's own "Ok to proceed?" prompt mid-take.
-cd "$WORK"
-npm install --silent "model-orchestrator@$VERSION" >/dev/null
-
-cat > "$WORK/take.sh" <<'TAKE'
-#!/bin/bash
-cd "$(dirname "$0")"
-printf '~/my-app $ '
-sleep 0.8
-cmd='npx model-orchestrator --yes --level 2 --ais claude-code,codex,grok --primary claude-code --dry'
-for (( i=0; i<${#cmd}; i++ )); do printf '%s' "${cmd:$i:1}"; sleep 0.022; done
-sleep 0.6; printf '\n'
-npx model-orchestrator --yes --level 2 --ais claude-code,codex,grok --primary claude-code --dry
-printf '~/my-app $ '
-sleep 2.5
-TAKE
-chmod +x "$WORK/take.sh"
-
-asciinema rec --cols 108 --rows 34 --overwrite --command "$WORK/take.sh" "$WORK/demo.cast"
-agg --theme monokai --font-size 16 --speed 1.3 --idle-time-limit 1.2 --last-frame-duration 3 \
-  "$WORK/demo.cast" "$OUT"
-
-echo "wrote $OUT ($(wc -c < "$OUT") bytes)"

package/templates/common/TASK_BUNDLE.md

@@ -1,56 +0,0 @@
-# Task Bundle: the brief every delegation carries
-
-A subagent, a second CLI, or a fresh chat window may hold none of the rules your main session is holding, and that is the default to assume. One exception: a Claude Code subagent loads the project's CLAUDE.md hierarchy at start, so it already carries the standing rules, just not this task's scope. Either way, it cannot see this task's conventions and will read an unspecified edge as an open one.
-
-> A delegate gets an approved, bounded brief. Absence is not permission.
-
-A brief is under-specified if it is missing **purpose**, **denied actions**, **report contract**, or **exit parameters**.
-
-## Template
-
-Copy this into the delegate's prompt. Delete nothing; write `none` where a field is genuinely empty, so a reader can tell "nothing denied" from "nobody thought about it".
-
-```markdown
-## Task bundle
-
-**Purpose.** <one sentence: what this task is for, and why>
-**Task class.** <read_only | draft_only | mutating>  (draft_only = produce, do not apply)
-
-**Granted scope.**
-- <paths, globs, topics, or record sets this brief covers>
-- Anything outside this list is out of scope. Do not widen it on your own judgment.
-
-**Capabilities.** <the actions you MAY take: read, search, write to <path>, run <cmd>>
-
-**Denied actions.** <explicit list: do not commit, push, deploy, delete, send, publish, close a ticket...>
-- Anything absent from Capabilities is denied. Absence is not permission.
-
-**Conventions you do not have.** <restate every house rule this task needs; even a delegate that loaded the standing rules still needs this task's scope, and a second CLI or a fresh chat window may hold none of it>
-
-**Report contract.** Return: <exactly what to hand back>. State plainly what you did NOT do
-and anything you could not verify. "Unverified" is an acceptable answer; a confident guess is not.
-
-**Exit parameters.** <at least one bound: a wall-clock ceiling, a work ceiling ("at most 20 files"),
-or a stop condition. Plus the partial-result clause: if you hit a bound, report what you have and
-name what you did not cover. Never keep going past a bound, never return nothing.>
-```
-
-## When to skip it
-
-A one-line read-only lookup can say so outright:
-
-```
-Task bundle: none (one-line lookup, read-only, no artifact)
-```
-
-The reason is required. A bare `none` is indistinguishable from "forgot".
-
-Never skip it for anything touching secrets, deletion, bulk mutation, deploys, or someone else's data. Better: do not delegate those at all.
-
-## Field notes
-
-- **Purpose** is what makes the rest checkable. "Fix the thing" has no edge to exceed.
-- **Task class** is the cheapest safety win. Most delegation wants `read_only` or `draft_only`.
-- **Denied actions** must be written even when they feel obvious. Nothing is obvious to a delegate with no context.
-- **Report contract** is what turns a result into evidence rather than a claim.
-- **Exit parameters** exist because a delegate that never returns is more expensive than one that returns wrong. A wrong answer is corrected next turn; a hang burns the session while looking like progress. Bound your own shell calls the same way (pass a timeout; scope recursive searches away from `.git`, `node_modules`, build output).