llm-orchestrator 1.0.5 → 1.0.7

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "llm-orchestrator",
   "description": "Write /task once — it plans the work, shards it across parallel subagents, gates every phase and verifies before claiming done. Claude Code, Codex, OpenCode, Kilo.",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "author": {
     "name": "Bogdan-Gabriel Torcescu",
     "url": "https://www.linkedin.com/in/bogdantorcescu/"

package/README.md

@@ -282,7 +282,7 @@ Same five steps for every harness; only the skills root and the reload differ.
    node bin/llm-orchestrator.mjs install --project /path/to/app --harness <harness>
    ```
 3. **Apply** the same command with `--apply`. Re-running is idempotent; a file you edited by hand is reported as a conflict, never overwritten.
-4. **Add project bindings** to `/path/to/app/AGENTS.md` (template below, or run `init --apply` to append it automatically when the section is missing). The core reads this section on every task; without it the core still runs with its generic matrix.
+4. **Add project bindings** to `/path/to/app/AGENTS.md` (template below, or run `init --apply` to append it automatically when the section is missing). `install` reports `bindings.present` and, when false, the exact `init --apply` command. The core reads this section on every task; without it the core still runs with its generic matrix.
 5. **Verify and reload**: `node bin/llm-orchestrator.mjs doctor --project /path/to/app --harness <harness>` must list every mandatory core tool as `present` (or as a declared gap with an install hint). Then reload the harness session so the skill catalog is refreshed.
 
 `node bin/llm-orchestrator.mjs init --project /path/to/app` runs steps 2, 4 (report only) and 5 together, before you commit to a harness — it proposes `--harness` from what it detects, shows the same dry-run plan, and lists exactly which of the 8 mandatory tools are missing with an install command for each.

package/bin/install.mjs

@@ -39,7 +39,15 @@ try {
     if (options.apply && options.linkClaude && (!result.conflicts || result.conflicts.length === 0) && options.harnesses.includes('claude')) {
       claudeSymlink = await linkClaudeSkillsRoot(options.skillsRoot);
     }
-    process.stdout.write(`${JSON.stringify({...result, files: result.files?.map(({absolutePath, content, ...file}) => file), ...(claudeSymlink ? {claudeSymlink} : {})}, null, 2)}\n`);
+    // `install` never writes the project bindings section — only `init --apply`
+    // does — so say so here, or a user who only ever runs `install` never learns
+    // the section exists and the core runs on its generic matrix forever.
+    const {agentsMdHasBindings, cliInvocation, BINDINGS_HEADING} = await import('../lib/first-run.mjs');
+    const bindingsPresent = await agentsMdHasBindings(options.project);
+    const bindings = bindingsPresent
+      ? {present: true}
+      : {present: false, section: BINDINGS_HEADING, next: `${cliInvocation()} init --project ${options.project} --apply`};
+    process.stdout.write(`${JSON.stringify({...result, files: result.files?.map(({absolutePath, content, ...file}) => file), ...(claudeSymlink ? {claudeSymlink} : {}), bindings}, null, 2)}\n`);
     if (result.conflicts?.length) process.exitCode = 2;
   }
 } catch (error) {

package/lib/first-run.mjs

@@ -197,7 +197,7 @@ Generic rules live in \`orchestrate-core\`; this section only adds or tightens.
 **Agent defaults:** \`<role>\` → \`<tier>\` (W T0–T1 / S T2 / S T3 / X T3 …).
 `;
 
-async function agentsMdHasBindings(project) {
+export async function agentsMdHasBindings(project) {
   try {
     const text = await readFile(join(project, 'AGENTS.md'), 'utf8');
     return text.includes(BINDINGS_HEADING);
@@ -215,8 +215,10 @@ async function agentsMdHasBindings(project) {
  * clone, the bare bin name when installed from npm (global or `npx`).
  */
 export function cliInvocation(argv = process.argv) {
+  // The unified CLI forwards by rewriting argv[1] to the subcommand script, so
+  // any script under this checkout's bin/ counts as "run from the clone".
   const script = argv[1] ? resolve(argv[1]) : '';
-  const fromClone = script === resolve(process.cwd(), 'bin', 'llm-orchestrator.mjs');
+  const fromClone = script.startsWith(resolve(process.cwd(), 'bin') + '/');
   return fromClone ? 'node bin/llm-orchestrator.mjs' : 'llm-orchestrator';
 }
 

package/lib/installation.mjs

@@ -447,7 +447,7 @@ export async function planUninstall(input) {
   const runtimeManifestPath = runtimeManifestPathFor({stateRoot, skillsRoot});
   const manifest = await readManifest(manifestPath);
   const runtimeManifest = await readRuntimeManifest(runtimeManifestPath);
-  if (!manifest) return {conflicts: [], changes: [], preserved: [], retained_runtime: (runtimeManifest?.files ?? []).map(({path}) => path), manifestPath};
+  if (!manifest) return {conflicts: [], changes: [], preserved: [], retained_shared_runtime: (runtimeManifest?.files ?? []).map(({path}) => path), manifestPath};
   const changes = [];
   const preserved = [];
   for (const span of manifest.spans) {
@@ -472,7 +472,7 @@ export async function planUninstall(input) {
     conflicts: [],
     changes,
     preserved: [...new Set(preserved)],
-    retained_runtime: [...new Set([...(runtimeManifest?.files ?? []).map(({path}) => path), ...manifest.files.filter(({scope}) => scope === 'skills').map(({path}) => path)])],
+    retained_shared_runtime: [...new Set([...(runtimeManifest?.files ?? []).map(({path}) => path), ...manifest.files.filter(({scope}) => scope === 'skills').map(({path}) => path)])],
     manifestPath,
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "llm-orchestrator",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Write /task once — it plans the work, shards it across parallel subagents, gates every phase and verifies before claiming done. Claude Code, Codex, OpenCode, Kilo.",
   "type": "module",
   "engines": {