@nforma.ai/nforma 0.28.0 → 0.29.0

package/bin/quorum-preflight.cjs

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * quorum-preflight.cjs — extract quorum config and team identity from nf.json + providers.json
+ *
+ * Replaces three inline `node -e` snippets in quorum.md that caused shell-escaping
+ * failures (LLMs escaping `!` as `\!` inside node -e strings).
+ *
+ * Usage:
+ *   node quorum-preflight.cjs --quorum-active       # → JSON array of active slot names
+ *   node quorum-preflight.cjs --max-quorum-size      # → integer (default 3)
+ *   node quorum-preflight.cjs --team                  # → JSON { slotName: { model } }
+ *   node quorum-preflight.cjs --all                   # → JSON { quorum_active, max_quorum_size, team }
+ *
+ * All modes read from ~/.claude/nf.json (global) merged with $CWD/.claude/nf.json (project).
+ * --team and --all also read providers.json (same search logic as call-quorum-slot.cjs).
+ *
+ * Exit code: always 0. Output: JSON to stdout.
+ */
+
+const fs   = require('fs');
+const path = require('path');
+const os   = require('os');
+
+// ─── Read merged nf.json config ─────────────────────────────────────────────
+function readConfig() {
+  const globalCfg = path.join(os.homedir(), '.claude', 'nf.json');
+  const projCfg   = path.join(process.cwd(), '.claude', 'nf.json');
+  let cfg = {};
+  for (const f of [globalCfg, projCfg]) {
+    try { Object.assign(cfg, JSON.parse(fs.readFileSync(f, 'utf8'))); } catch (_) {}
+  }
+  return cfg;
+}
+
+// ─── Find providers.json (mirrors call-quorum-slot.cjs / probe-quorum-slots.cjs) ──
+function findProviders() {
+  const searchPaths = [
+    path.join(__dirname, 'providers.json'),
+    path.join(os.homedir(), '.claude', 'nf-bin', 'providers.json'),
+  ];
+  try {
+    const claudeJson = JSON.parse(fs.readFileSync(path.join(os.homedir(), '.claude.json'), 'utf8'));
+    const u1args = claudeJson?.mcpServers?.['unified-1']?.args ?? [];
+    const serverScript = u1args.find(a => typeof a === 'string' && a.endsWith('unified-mcp-server.mjs'));
+    if (serverScript) searchPaths.unshift(path.join(path.dirname(serverScript), 'providers.json'));
+  } catch (_) {}
+  for (const p of searchPaths) {
+    try {
+      if (fs.existsSync(p)) return JSON.parse(fs.readFileSync(p, 'utf8')).providers;
+    } catch (_) {}
+  }
+  return [];
+}
+
+// ─── Build team JSON from providers + config ────────────────────────────────
+function buildTeam(providers, active) {
+  const team = {};
+  for (const p of providers) {
+    if (active.length > 0 && !active.includes(p.name)) continue;
+    team[p.name] = { model: p.model };
+  }
+  return team;
+}
+
+// ─── Main ───────────────────────────────────────────────────────────────────
+const mode = process.argv[2] || '--all';
+const cfg  = readConfig();
+
+if (mode === '--quorum-active') {
+  console.log(JSON.stringify(cfg.quorum_active || []));
+} else if (mode === '--max-quorum-size') {
+  console.log(cfg.max_quorum_size ?? 3);
+} else if (mode === '--team') {
+  const providers = findProviders();
+  const active    = cfg.quorum_active || [];
+  console.log(JSON.stringify(buildTeam(providers, active)));
+} else if (mode === '--all') {
+  const providers    = findProviders();
+  const active       = cfg.quorum_active || [];
+  const team         = buildTeam(providers, active);
+  const maxSize      = cfg.max_quorum_size ?? 3;
+  console.log(JSON.stringify({ quorum_active: active, max_quorum_size: maxSize, team }));
+} else {
+  console.error(`Unknown mode: ${mode}`);
+  console.error('Usage: node quorum-preflight.cjs [--quorum-active|--max-quorum-size|--team|--all]');
+  process.exit(1);
+}

package/commands/nf/quorum.md

@@ -75,16 +75,7 @@ Any server with `available: false` must be marked UNAVAIL immediately — skip i
 
 3. **`$QUORUM_ACTIVE`**: read from `~/.claude/nf.json` (project config takes precedence over global):
 ```bash
-node -e "
-const fs = require('fs'), os = require('os'), path = require('path');
-const globalCfg = path.join(os.homedir(), '.claude', 'nf.json');
-const projCfg   = path.join(process.cwd(), '.claude', 'nf.json');
-let cfg = {};
-for (const f of [globalCfg, projCfg]) {
-  try { Object.assign(cfg, JSON.parse(fs.readFileSync(f, 'utf8'))); } catch(_){}
-}
-console.log(JSON.stringify(cfg.quorum_active || []));
-"
+node "$HOME/.claude/nf-bin/quorum-preflight.cjs" --quorum-active
 ```
 If `$QUORUM_ACTIVE` is empty (`[]`), all entries in `$CLAUDE_MCP_SERVERS` participate.
 If non-empty, intersect: only servers whose `serverName` appears in `$QUORUM_ACTIVE` are called.
@@ -98,16 +89,7 @@ A server in `$QUORUM_ACTIVE` but absent from `$CLAUDE_MCP_SERVERS` = skip silent
 
 **max_quorum_size check:** Read `max_quorum_size` from `~/.claude/nf.json` (project config takes precedence; default: 3 if absent):
 ```bash
-node -e "
-const fs = require('fs'), os = require('os'), path = require('path');
-const globalCfg = path.join(os.homedir(), '.claude', 'nf.json');
-const projCfg   = path.join(process.cwd(), '.claude', 'nf.json');
-let cfg = {};
-for (const f of [globalCfg, projCfg]) {
-  try { Object.assign(cfg, JSON.parse(fs.readFileSync(f, 'utf8'))); } catch(_){}
-}
-console.log(cfg.max_quorum_size ?? 3);
-"
+node "$HOME/.claude/nf-bin/quorum-preflight.cjs" --max-quorum-size
 ```
 Count available slots (those not marked UNAVAIL and passing $QUORUM_ACTIVE filter). Include Claude itself as +1.
 If `availableCount < max_quorum_size`:
@@ -132,39 +114,7 @@ Provider pre-flight: <providerName>=✓/✗ ...  (<N> claude-mcp servers found)
 Before any quorum round, capture the active team fingerprint. Build TEAM_JSON directly from `providers.json` — no MCP calls needed for identity.
 
 ```bash
-node -e "
-const fs = require('fs'), path = require('path'), os = require('os');
-
-const searchPaths = [
-  path.join(os.homedir(), '.claude', 'nf-bin', 'providers.json'),
-];
-try {
-  const cj = JSON.parse(fs.readFileSync(path.join(os.homedir(), '.claude.json'), 'utf8'));
-  const u1args = cj?.mcpServers?.['unified-1']?.args ?? [];
-  const srv = u1args.find(a => typeof a === 'string' && a.endsWith('unified-mcp-server.mjs'));
-  if (srv) searchPaths.unshift(path.join(path.dirname(srv), 'providers.json'));
-} catch(_) {}
-
-let providers = [];
-for (const p of searchPaths) {
-  try { providers = JSON.parse(fs.readFileSync(p, 'utf8')).providers; break; } catch(_) {}
-}
-
-const globalCfg = path.join(os.homedir(), '.claude', 'nf.json');
-const projCfg   = path.join(process.cwd(), '.claude', 'nf.json');
-let cfg = {};
-for (const f of [globalCfg, projCfg]) {
-  try { Object.assign(cfg, JSON.parse(fs.readFileSync(f, 'utf8'))); } catch(_) {}
-}
-const active = cfg.quorum_active || [];
-
-const team = {};
-for (const p of providers) {
-  if (active.length > 0 && !active.includes(p.name)) continue;
-  team[p.name] = { model: p.model };
-}
-console.log(JSON.stringify(team));
-"
+node "$HOME/.claude/nf-bin/quorum-preflight.cjs" --team
 ```
 
 Store result as `TEAM_JSON`. Also build three lookup maps from `providers.json` for use during dispatch:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nforma.ai/nforma",
-  "version": "0.28.0",
+  "version": "0.29.0",
   "description": "nForma — Quorum Gets Shit Done. Multi-model quorum enforcement for GSD planning commands via Claude Code hooks.",
   "bin": {
     "nforma": "bin/install.js",
@@ -13,6 +13,7 @@
     "get-shit-done",
     "agents",
     "hooks/dist",
+    "!hooks/dist/*.test.*",
     "scripts",
     "!scripts/generate-logo-svg.js",
     "!scripts/generate-terminal-svg.js",
@@ -88,7 +89,8 @@
     "secrets:history": "bash scripts/secret-audit.sh",
     "test": "npm run test:ci && npm run test:formal",
     "test:changed": "node bin/test-changed.cjs",
-    "test:ci": "node scripts/lint-isolation.js && node scripts/verify-hooks-sync.cjs && node --test hooks/nf-precompact.test.js hooks/gsd-context-monitor.test.js hooks/nf-session-start.test.js bin/conformance-schema.test.cjs bin/resolve-cli.test.cjs bin/secrets.test.cjs bin/verify-quorum-health.test.cjs hooks/nf-stop.test.js hooks/config-loader.test.js core/bin/gsd-tools.test.cjs hooks/nf-circuit-breaker.test.js hooks/nf-prompt.test.js bin/update-scoreboard.test.cjs hooks/nf-statusline.test.js bin/review-mcp-logs.test.cjs bin/migrate-to-slots.test.cjs bin/validate-traces.test.cjs bin/write-check-result.test.cjs bin/check-results-exit.test.cjs bin/check-trace-redaction.test.cjs bin/check-trace-schema-drift.test.cjs bin/nf.test.cjs bin/set-secret.test.cjs bin/issue-classifier.test.cjs bin/generate-tla-cfg.test.cjs bin/ccr-secure-config.test.cjs bin/gsd-quorum-slot-worker-improvements.test.cjs bin/quorum-improvements-signal.test.cjs bin/claude-md-references.test.cjs hooks/nf-spec-regen.test.js bin/propose-debug-invariants.test.cjs bin/aggregate-requirements.test.cjs bin/validate-requirements-haiku.test.cjs bin/call-quorum-slot-retry.test.cjs bin/provider-mapping.test.cjs",
+    "test:ci": "node scripts/lint-isolation.js && node scripts/verify-hooks-sync.cjs && node --test hooks/nf-precompact.test.js hooks/gsd-context-monitor.test.js hooks/nf-session-start.test.js bin/conformance-schema.test.cjs bin/resolve-cli.test.cjs bin/secrets.test.cjs bin/verify-quorum-health.test.cjs hooks/nf-stop.test.js hooks/config-loader.test.js core/bin/gsd-tools.test.cjs hooks/nf-circuit-breaker.test.js hooks/nf-prompt.test.js bin/update-scoreboard.test.cjs hooks/nf-statusline.test.js bin/review-mcp-logs.test.cjs bin/migrate-to-slots.test.cjs bin/validate-traces.test.cjs bin/write-check-result.test.cjs bin/check-results-exit.test.cjs bin/check-trace-redaction.test.cjs bin/check-trace-schema-drift.test.cjs bin/nForma.test.cjs bin/set-secret.test.cjs bin/issue-classifier.test.cjs bin/generate-tla-cfg.test.cjs bin/ccr-secure-config.test.cjs bin/gsd-quorum-slot-worker-improvements.test.cjs bin/quorum-improvements-signal.test.cjs bin/claude-md-references.test.cjs hooks/nf-spec-regen.test.js bin/propose-debug-invariants.test.cjs bin/aggregate-requirements.test.cjs bin/validate-requirements-haiku.test.cjs bin/call-quorum-slot-retry.test.cjs bin/provider-mapping.test.cjs",
+    "test:install": "node --test test/install-virgin.test.cjs",
     "test:formal": "node --test bin/run-tlc.test.cjs bin/run-alloy.test.cjs bin/export-prism-constants.test.cjs bin/generate-petri-net.test.cjs bin/run-breaker-tlc.test.cjs bin/run-oscillation-tlc.test.cjs bin/run-protocol-tlc.test.cjs bin/run-audit-alloy.test.cjs bin/run-transcript-alloy.test.cjs bin/run-installer-alloy.test.cjs bin/run-formal-verify.test.cjs bin/xstate-to-tla.test.cjs bin/run-account-manager-tlc.test.cjs bin/run-account-pool-alloy.test.cjs bin/run-oauth-rotation-prism.test.cjs bin/run-prism.test.cjs bin/check-spec-sync.test.cjs bin/sensitivity-sweep-feedback.test.cjs bin/roadmapper-formal-integration.test.cjs bin/test-formal-integration.test.cjs test/alloy-headless.test.cjs",
     "prepare": "husky"
   }