@maestrofrontier/frontier 1.4.5 → 1.6.0

package/hooks/hooks.json

@@ -1,103 +1,103 @@
-{
-  "hooks": {
-    "PreToolUse": [
-      {
-        "matcher": "Read",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-doctrine-guard.cjs\""
-          }
-        ]
-      }
-    ],
-    "SessionStart": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-terse-mode.cjs\""
-          },
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-statusline-sync.cjs\""
-          }
-        ]
-      }
-    ],
-    "UserPromptSubmit": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-gate-reminder.cjs\""
-          },
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-terse-mode.cjs\""
-          },
-          {
-            "type": "command",
-            "command": "node -e \"require(require('path').join(process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT, 'hooks', 'frontier-autorun.cjs'))\"",
-            "timeout": 300
-          }
-        ]
-      }
-    ],
-    "SubagentStop": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-subagent-guard.cjs\""
-          }
-        ]
-      }
-    ],
-    "Stop": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-loop-guard.cjs\""
-          }
-        ]
-      }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Edit|Write|NotebookEdit|Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-phase-scope.cjs\""
-          }
-        ]
-      },
-      {
-        "matcher": "Edit|Write|NotebookEdit",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-toolbudget-advisory.cjs\""
-          }
-        ]
-      }
-    ],
-    "SessionEnd": [
-      {
-        "matcher": "",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-gate-telemetry.cjs\""
-          }
-        ]
-      }
-    ]
-  }
-}
+{
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Read",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-doctrine-guard.cjs\""
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-terse-mode.cjs\""
+          },
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-statusline-sync.cjs\""
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-gate-reminder.cjs\""
+          },
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-terse-mode.cjs\""
+          },
+          {
+            "type": "command",
+            "command": "node -e \"require(require('path').join(process.env.CLAUDE_PLUGIN_ROOT || process.env.PLUGIN_ROOT, 'hooks', 'frontier-autorun.cjs'))\"",
+            "timeout": 300
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-subagent-guard.cjs\""
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-loop-guard.cjs\""
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "Edit|Write|NotebookEdit|Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-phase-scope.cjs\""
+          }
+        ]
+      },
+      {
+        "matcher": "Edit|Write|NotebookEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-toolbudget-advisory.cjs\""
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/maestro-gate-telemetry.cjs\""
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/maestro-doctrine-guard.cjs

@@ -1,81 +1,81 @@
-#!/usr/bin/env node
-// Maestro PreToolUse doctrine-read guard. Enforces AGENTS.md S7.2
-// structurally: when the doctrine is autoloaded (CLAUDE.md/AGENTS.md
-// present at cwd, which Claude Code injects at session start), a Read
-// of AGENTS.md or CLAUDE.md re-buys tokens for content already in
-// context. This hook replaces the probabilistic S7.2 prose line with a
-// deterministic deny.
-//
-// Modes via MAESTRO_DOCTRINE_GUARD:
-// - "always" (default): deny every doctrine Read while doctrine files
-//   exist at cwd. Safe on Claude Code, where subagents receive the
-//   project doctrine automatically; the deny reason tells the model
-//   to use the in-context copy.
-// - "once": allow the first doctrine Read per session (marker file in
-//   the OS temp dir keyed by session_id), deny repeats. For runtimes
-//   whose subagents genuinely lack the doctrine in context (S7.2:
-//   "a subagent without it in context reads AGENTS.md once").
-// - "0": disabled.
-//
-// When no doctrine file exists at cwd nothing was autoloaded, so reads
-// pass through untouched (e.g. inspecting another repo's AGENTS.md).
-// docs/orchestration.md is never guarded -- it is the on-demand layer
-// and reading it is the intended path. Fails open on any error.
-//
-// Payload fields verified against code.claude.com/docs/en/hooks
-// (PreToolUse input: session_id, cwd, tool_name, tool_input; output:
-// hookSpecificOutput.permissionDecision allow|deny|ask + reason),
-// 2026-06-11.
-//
-// .cjs so Node treats it as CommonJS regardless of any "type": "module"
-// package.json in a parent directory of the install location.
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
-const mode = process.env.MAESTRO_DOCTRINE_GUARD || 'always';
-if (mode === '0') process.exit(0);
-
-let data = {};
-try { data = JSON.parse(fs.readFileSync(0, 'utf8')); } catch { process.exit(0); }
-if (data.tool_name !== 'Read' || !data.tool_input) process.exit(0);
-
-const fp = data.tool_input.file_path;
-if (typeof fp !== 'string') process.exit(0);
-const base = path.basename(fp).toLowerCase();
-if (base !== 'agents.md' && base !== 'claude.md') process.exit(0);
-
-// Guard only when the doctrine was actually autoloaded: a doctrine file
-// at cwd is what Claude Code injects at session start.
-const cwd = typeof data.cwd === 'string' ? data.cwd : process.cwd();
-let autoloaded = false;
-try {
-  autoloaded = fs.existsSync(path.join(cwd, 'CLAUDE.md'))
-    || fs.existsSync(path.join(cwd, 'AGENTS.md'));
-} catch { autoloaded = false; }
-if (!autoloaded) process.exit(0);
-
-if (mode === 'once' && data.session_id) {
-  const marker = path.join(
-    os.tmpdir(),
-    `maestro-doctrine-guard-${String(data.session_id).replace(/[^a-zA-Z0-9-]/g, '_')}`
-  );
-  if (!fs.existsSync(marker)) {
-    try { fs.writeFileSync(marker, '1'); } catch { /* still allow */ }
-    process.exit(0);
-  }
-}
-
-process.stdout.write(JSON.stringify({
-  hookSpecificOutput: {
-    hookEventName: 'PreToolUse',
-    permissionDecision: 'deny',
-    permissionDecisionReason: 'maestro-doctrine-guard: denied Read of '
-      + path.basename(fp) + ' -- the doctrine is autoloaded into context '
-      + 'at session start (AGENTS.md S7.2); use the in-context copy '
-      + 'instead of re-reading it from disk. The on-demand protocol '
-      + 'layer lives in docs/orchestration.md, which is not blocked.'
-  }
-}));
-process.exit(0);
+#!/usr/bin/env node
+// Maestro PreToolUse doctrine-read guard. Enforces AGENTS.md S7.2
+// structurally: when the doctrine is autoloaded (CLAUDE.md/AGENTS.md
+// present at cwd, which Claude Code injects at session start), a Read
+// of AGENTS.md or CLAUDE.md re-buys tokens for content already in
+// context. This hook replaces the probabilistic S7.2 prose line with a
+// deterministic deny.
+//
+// Modes via MAESTRO_DOCTRINE_GUARD:
+// - "always" (default): deny every doctrine Read while doctrine files
+//   exist at cwd. Safe on Claude Code, where subagents receive the
+//   project doctrine automatically; the deny reason tells the model
+//   to use the in-context copy.
+// - "once": allow the first doctrine Read per session (marker file in
+//   the OS temp dir keyed by session_id), deny repeats. For runtimes
+//   whose subagents genuinely lack the doctrine in context (S7.2:
+//   "a subagent without it in context reads AGENTS.md once").
+// - "0": disabled.
+//
+// When no doctrine file exists at cwd nothing was autoloaded, so reads
+// pass through untouched (e.g. inspecting another repo's AGENTS.md).
+// docs/orchestration.md is never guarded -- it is the on-demand layer
+// and reading it is the intended path. Fails open on any error.
+//
+// Payload fields verified against code.claude.com/docs/en/hooks
+// (PreToolUse input: session_id, cwd, tool_name, tool_input; output:
+// hookSpecificOutput.permissionDecision allow|deny|ask + reason),
+// 2026-06-11.
+//
+// .cjs so Node treats it as CommonJS regardless of any "type": "module"
+// package.json in a parent directory of the install location.
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const mode = process.env.MAESTRO_DOCTRINE_GUARD || 'always';
+if (mode === '0') process.exit(0);
+
+let data = {};
+try { data = JSON.parse(fs.readFileSync(0, 'utf8')); } catch { process.exit(0); }
+if (data.tool_name !== 'Read' || !data.tool_input) process.exit(0);
+
+const fp = data.tool_input.file_path;
+if (typeof fp !== 'string') process.exit(0);
+const base = path.basename(fp).toLowerCase();
+if (base !== 'agents.md' && base !== 'claude.md') process.exit(0);
+
+// Guard only when the doctrine was actually autoloaded: a doctrine file
+// at cwd is what Claude Code injects at session start.
+const cwd = typeof data.cwd === 'string' ? data.cwd : process.cwd();
+let autoloaded = false;
+try {
+  autoloaded = fs.existsSync(path.join(cwd, 'CLAUDE.md'))
+    || fs.existsSync(path.join(cwd, 'AGENTS.md'));
+} catch { autoloaded = false; }
+if (!autoloaded) process.exit(0);
+
+if (mode === 'once' && data.session_id) {
+  const marker = path.join(
+    os.tmpdir(),
+    `maestro-doctrine-guard-${String(data.session_id).replace(/[^a-zA-Z0-9-]/g, '_')}`
+  );
+  if (!fs.existsSync(marker)) {
+    try { fs.writeFileSync(marker, '1'); } catch { /* still allow */ }
+    process.exit(0);
+  }
+}
+
+process.stdout.write(JSON.stringify({
+  hookSpecificOutput: {
+    hookEventName: 'PreToolUse',
+    permissionDecision: 'deny',
+    permissionDecisionReason: 'maestro-doctrine-guard: denied Read of '
+      + path.basename(fp) + ' -- the doctrine is autoloaded into context '
+      + 'at session start (AGENTS.md S7.2); use the in-context copy '
+      + 'instead of re-reading it from disk. The on-demand protocol '
+      + 'layer lives in docs/orchestration.md, which is not blocked.'
+  }
+}));
+process.exit(0);

package/hooks/maestro-gate-reminder.cjs

@@ -40,14 +40,29 @@ try { fs.writeFileSync(marker, '1'); } catch { /* still remind */ }
 
 const checklistLines = [
   'Maestro Decision Gate (S1): before the first file edit, output the',
-  'counted verdict line `GATE: files=<n> concerns=<m> -> single-agent',
-  '| multi-agent — <reason>`. files>=5 across 2+ concerns = multi-agent:',
-  'spawn the Planner via the Agent/Task tool BEFORE any edit. A met',
-  'trigger downgrades ONLY on >60% file overlap between subtasks or',
-  '<=3 files total in one dependency chain. Sub-trigger tasks stay',
-  'single-agent.'
+  'counted verdict line `Maestro · frontier <on|off> — files=<n>',
+  'concerns=<m> -> single-agent | multi-agent — <reason>`. files>=5',
+  'across 2+ concerns = multi-agent: spawn the Planner via the',
+  'Agent/Task tool BEFORE any edit. A met trigger downgrades ONLY on',
+  '>60% file overlap between subtasks or <=3 files total in one',
+  'dependency chain. Sub-trigger tasks stay single-agent.'
 ];
-const checklist = checklistLines.join('\n');
+
+// Inject the live frontier engine state so the badge in the verdict
+// line is accurate. Degrades to 'off' on any failure — never throws.
+let badge = 'off';
+try {
+  const cfg = require('../frontier/config.cjs');
+  const cwd = data.cwd || process.env.CLAUDE_PROJECT_DIR || process.cwd();
+  const scope = cfg.resolveScope([], { cwd });
+  const st = cfg.loadState(scope);
+  badge = (!st || st.mode === 'off')
+    ? 'off'
+    : ('on (' + st.mode + '/' + (st.preset || st.model || '') + ')');
+} catch { badge = 'off'; }
+
+const checklist = checklistLines.join('\n') +
+  '\nCurrent frontier state for the badge: frontier ' + badge;
 
 process.stdout.write(JSON.stringify({
   hookSpecificOutput: {

package/hooks/maestro-gate-telemetry.cjs

@@ -1,77 +1,79 @@
-#!/usr/bin/env node
-// Maestro SessionEnd gate telemetry. Strictly opt-in, strictly local.
-//
-// Records one JSON line per session so you can audit your own Decision
-// Gate behavior over time (AGENTS.md S1): did the session route
-// single-agent or multi-agent, how many specialists were spawned, and
-// how the session ended.
-//
-// Privacy: does nothing unless MAESTRO_TELEMETRY=1. Writes only to
-// ~/.claude/maestro-telemetry.jsonl on this machine. No network, ever.
-// Captures counts and the project folder NAME only -- no prompts, no
-// file contents, no paths beyond the basename.
-//
-// Payload fields verified against code.claude.com/docs/en/hooks
-// (SessionEnd input: session_id, transcript_path, cwd, reason;
-// SessionEnd output cannot block), 2026-06-10.
-//
-// .cjs so Node treats it as CommonJS regardless of any "type": "module"
-// package.json in a parent directory of the install location.
-//
-// Install: see README "Claude Code: Gate Telemetry".
-
-const fs = require('fs');
-const os = require('os');
-const path = require('path');
-
-if (process.env.MAESTRO_TELEMETRY !== '1') process.exit(0);
-
-let data = {};
-try { data = JSON.parse(fs.readFileSync(0, 'utf8')); } catch { process.exit(0); }
-
-// Spawn count alone misses the measured failure mode: a multi-agent
-// verdict stated in text but no specialist ever spawned. Parse the S1
-// verdict line too and record verdict vs spawned separately; mismatch
-// flags either direction (multi verdict with 0 spawns, single verdict
-// with spawns). Last verdict line wins (re-gated mid-session).
-const verdictRe = /GATE:\s*files=\S+\s+concerns=\S+\s*->\s*(single|multi)-agent/;
-let agentCount = 0;
-let verdict = null;
-if (data.transcript_path && fs.existsSync(data.transcript_path)) {
-  try {
-    const buf = fs.readFileSync(data.transcript_path, 'utf8');
-    const text = buf.length > 8000000 ? buf.slice(-8000000) : buf;
-    for (const line of text.split(/\r?\n/)) {
-      let e;
-      try { e = JSON.parse(line); } catch { continue; }
-      if (!e || e.type !== 'assistant' || !e.message || !Array.isArray(e.message.content)) continue;
-      for (const item of e.message.content) {
-        if (!item) continue;
-        if (item.type === 'tool_use' && (item.name === 'Task' || item.name === 'Agent')) agentCount++;
-        if (item.type === 'text' && typeof item.text === 'string') {
-          const m = item.text.match(verdictRe);
-          if (m) verdict = m[1];
-        }
-      }
-    }
-  } catch {}
-}
-
-const row = {
-  ts: new Date().toISOString(),
-  session_id: data.session_id || null,
-  gate: agentCount > 0 ? 'multi' : 'single',
-  verdict,
-  agent_count: agentCount,
-  mismatch: verdict !== null && ((verdict === 'multi') !== (agentCount > 0)),
-  reason: data.reason || null,
-  project: data.cwd ? path.basename(data.cwd) : null
-};
-
-try {
-  const dir = path.join(os.homedir(), '.claude');
-  fs.mkdirSync(dir, { recursive: true });
-  fs.appendFileSync(path.join(dir, 'maestro-telemetry.jsonl'), JSON.stringify(row) + '\n');
-} catch {}
-
-process.exit(0);
+#!/usr/bin/env node
+// Maestro SessionEnd gate telemetry. Strictly opt-in, strictly local.
+//
+// Records one JSON line per session so you can audit your own Decision
+// Gate behavior over time (AGENTS.md S1): did the session route
+// single-agent or multi-agent, how many specialists were spawned, and
+// how the session ended.
+//
+// Privacy: does nothing unless MAESTRO_TELEMETRY=1. Writes only to
+// ~/.claude/maestro-telemetry.jsonl on this machine. No network, ever.
+// Captures counts and the project folder NAME only -- no prompts, no
+// file contents, no paths beyond the basename.
+//
+// Payload fields verified against code.claude.com/docs/en/hooks
+// (SessionEnd input: session_id, transcript_path, cwd, reason;
+// SessionEnd output cannot block), 2026-06-10.
+//
+// .cjs so Node treats it as CommonJS regardless of any "type": "module"
+// package.json in a parent directory of the install location.
+//
+// Install: see README "Claude Code: Gate Telemetry".
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+if (process.env.MAESTRO_TELEMETRY !== '1') process.exit(0);
+
+let data = {};
+try { data = JSON.parse(fs.readFileSync(0, 'utf8')); } catch { process.exit(0); }
+
+// Spawn count alone misses the measured failure mode: a multi-agent
+// verdict stated in text but no specialist ever spawned. Parse the S1
+// verdict line too and record verdict vs spawned separately; mismatch
+// flags either direction (multi verdict with 0 spawns, single verdict
+// with spawns). Last verdict line wins (re-gated mid-session).
+// Matches BOTH the legacy `GATE: files=...` line and the rebranded
+// `Maestro · frontier <on|off> — files=...` badge line.
+const verdictRe = /(?:GATE|Maestro)[:\s·].*?files=\S+\s+concerns=\S+\s*->\s*(single|multi)-agent/;
+let agentCount = 0;
+let verdict = null;
+if (data.transcript_path && fs.existsSync(data.transcript_path)) {
+  try {
+    const buf = fs.readFileSync(data.transcript_path, 'utf8');
+    const text = buf.length > 8000000 ? buf.slice(-8000000) : buf;
+    for (const line of text.split(/\r?\n/)) {
+      let e;
+      try { e = JSON.parse(line); } catch { continue; }
+      if (!e || e.type !== 'assistant' || !e.message || !Array.isArray(e.message.content)) continue;
+      for (const item of e.message.content) {
+        if (!item) continue;
+        if (item.type === 'tool_use' && (item.name === 'Task' || item.name === 'Agent')) agentCount++;
+        if (item.type === 'text' && typeof item.text === 'string') {
+          const m = item.text.match(verdictRe);
+          if (m) verdict = m[1];
+        }
+      }
+    }
+  } catch {}
+}
+
+const row = {
+  ts: new Date().toISOString(),
+  session_id: data.session_id || null,
+  gate: agentCount > 0 ? 'multi' : 'single',
+  verdict,
+  agent_count: agentCount,
+  mismatch: verdict !== null && ((verdict === 'multi') !== (agentCount > 0)),
+  reason: data.reason || null,
+  project: data.cwd ? path.basename(data.cwd) : null
+};
+
+try {
+  const dir = path.join(os.homedir(), '.claude');
+  fs.mkdirSync(dir, { recursive: true });
+  fs.appendFileSync(path.join(dir, 'maestro-telemetry.jsonl'), JSON.stringify(row) + '\n');
+} catch {}
+
+process.exit(0);