sentinelayer-cli 0.1.2 → 0.3.0

package/src/agents/jules/stream.js

@@ -1,186 +1,186 @@
-import { PERSONA_VISUALS, resolvePersonaVisual } from "./config/definition.js";
-
-/**
- * Jules Tanaka — Streaming Event Formatter
- *
- * Formats NDJSON events for external agent consumption and terminal display.
- * Universal envelope: every event carries agent identity, usage snapshot, timestamp.
- */
-
-const SCHEMA_VERSION = 1;
-
-/**
- * Build an NDJSON event envelope.
- *
- * @param {string} event - Event type (agent_start, tool_call, finding, heartbeat, etc.)
- * @param {object} agentIdentity - { id, persona, color?, avatar? }
- * @param {object} payload - Event-specific data
- * @param {object} [usage] - Running usage totals
- * @param {string} [runId] - Run identifier
- * @returns {object} Complete event envelope
- */
-export function buildStreamEvent(event, agentIdentity, payload, usage, runId) {
-  const visual = resolvePersonaVisual(agentIdentity?.id) || {};
-  return {
-    stream: "sl_event",
-    version: SCHEMA_VERSION,
-    command: "audit.deep",
-    runId: runId || null,
-    timestamp: new Date().toISOString(),
-    agent: {
-      id: agentIdentity?.id || "unknown",
-      persona: agentIdentity?.persona || visual.fullName || "unknown",
-      color: agentIdentity?.color || visual.color || "white",
-      avatar: agentIdentity?.avatar || visual.avatar || "",
-    },
-    event,
-    payload: payload || {},
-    usage: usage || {},
-  };
-}
-
-/**
- * Create a streaming emitter bound to a specific agent and run.
- *
- * @param {object} config
- * @param {object} config.agentIdentity - { id, persona }
- * @param {string} config.runId
- * @param {function} [config.onEvent] - Callback for each event
- * @param {boolean} [config.stdoutNdjson] - Also write to stdout as NDJSON
- * @returns {{ emit(event, payload, usage), close() }}
- */
-export function createStreamEmitter({ agentIdentity, runId, onEvent, stdoutNdjson = false }) {
-  let closed = false;
-  const usageRef = { costUsd: 0, outputTokens: 0, toolCalls: 0, durationMs: 0 };
-
-  return {
-    /**
-     * Emit a streaming event.
-     */
-    emit(event, payload, usage) {
-      if (closed) return;
-      const merged = { ...usageRef, ...usage };
-      Object.assign(usageRef, merged);
-      const evt = buildStreamEvent(event, agentIdentity, payload, merged, runId);
-      if (onEvent) onEvent(evt);
-      if (stdoutNdjson) console.log(JSON.stringify(evt));
-      return evt;
-    },
-
-    /**
-     * Update accumulated usage without emitting.
-     */
-    updateUsage(delta) {
-      if (delta.costUsd !== undefined) usageRef.costUsd = delta.costUsd;
-      if (delta.outputTokens !== undefined) usageRef.outputTokens = delta.outputTokens;
-      if (delta.toolCalls !== undefined) usageRef.toolCalls = delta.toolCalls;
-      if (delta.durationMs !== undefined) usageRef.durationMs = delta.durationMs;
-    },
-
-    /**
-     * Mark emitter as closed (no more events).
-     */
-    close() {
-      closed = true;
-    },
-
-    /**
-     * Get current usage snapshot.
-     */
-    getUsage() {
-      return { ...usageRef };
-    },
-  };
-}
-
-/**
- * Format a terminal display line for a persona event (non-JSON mode).
- *
- * @param {object} evt - Stream event
- * @returns {string} Formatted line for stderr
- */
-export function formatTerminalLine(evt) {
-  const agent = evt.agent || {};
-  const avatar = agent.avatar || "";
-  const name = agent.persona || agent.id || "Agent";
-  const p = evt.payload || {};
-
-  switch (evt.event) {
-    case "agent_start":
-      return `${avatar} ${name} starting (mode: ${p.mode || "primary"})...`;
-
-    case "progress":
-      return `${avatar} ${name}: ${p.message || p.phase || "working..."}`;
-
-    case "tool_call":
-      return `${avatar} ${name} [${p.tool}] ${formatToolInput(p.input)}`;
-
-    case "tool_result":
-      return `${avatar} ${name} [${p.tool}] ${p.durationMs || 0}ms ${p.success === false ? "FAILED" : "ok"}`;
-
-    case "finding": {
-      const sev = p.severity || "P3";
-      const sevColor = sev === "P0" ? "!!!" : sev === "P1" ? "!!" : sev === "P2" ? "!" : "";
-      return `${avatar} [${sev}${sevColor}] ${p.file || ""}:${p.line || ""} ${p.title || ""}`;
-    }
-
-    case "reasoning":
-      return `${avatar} ${name}: ${(p.summary || "").slice(0, 120)}`;
-
-    case "heartbeat": {
-      const h = p;
-      const budgetPct = h.budgetRemaining?.pct?.toFixed(0) || "?";
-      return `${avatar} ${name} [${h.turnsCompleted || 0}/${h.turnsMax || "?"} turns, ${budgetPct}% budget, ${h.findingsSoFar || 0} findings]`;
-    }
-
-    case "budget_warning":
-      return `${avatar} ${name} BUDGET WARNING: ${(p.warnings || []).map(w => w.code).join(", ")}`;
-
-    case "budget_stop":
-      return `${avatar} ${name} BUDGET STOP: ${(p.reasons || []).map(r => r.code || r).join(", ")}`;
-
-    case "swarm_start":
-      return `${avatar} ${name} spawning sub-agents (${p.scannerCount || 0} scanners, ${p.hunterCount || 0} hunters)...`;
-
-    case "swarm_complete":
-      return `${avatar} ${name} swarm complete: ${p.totalFindings || 0} findings from ${p.totalAgents || 0} agents ($${(p.totalCostUsd || 0).toFixed(2)})`;
-
-    case "phase_start":
-      return `${avatar} ${name} phase: ${p.phase || "unknown"}`;
-
-    case "agent_complete": {
-      const s = p;
-      return `${avatar} ${name} complete: ${s.total || 0} findings (P0=${s.P0 || 0} P1=${s.P1 || 0} P2=${s.P2 || 0}) $${(s.costUsd || 0).toFixed(2)} ${s.durationMs ? (s.durationMs / 1000).toFixed(1) + "s" : ""}`;
-    }
-
-    case "agent_abort":
-      return `${avatar} ${name} ABORTED: ${p.reason || "unknown"}`;
-
-    default:
-      return `${avatar} ${name} [${evt.event}]`;
-  }
-}
-
-function formatToolInput(input) {
-  if (!input) return "";
-  if (input.file_path) return input.file_path;
-  if (input.pattern) return `/${input.pattern}/`;
-  if (input.operation) return input.operation;
-  if (input.command) return input.command.slice(0, 60);
-  return "";
-}
-
-/**
- * List all valid event types.
- */
-export const EVENT_TYPES = Object.freeze([
-  "agent_start", "agent_complete", "agent_abort", "agent_error",
-  "progress", "heartbeat",
-  "tool_call", "tool_result",
-  "finding", "reasoning",
-  "budget_warning", "budget_stop",
-  "swarm_start", "swarm_complete",
-  "phase_start", "phase_complete",
-  "convergence_expansion", "coverage_gap",
-  "llm_error",
-]);
+import { PERSONA_VISUALS, resolvePersonaVisual } from "./config/definition.js";
+
+/**
+ * Jules Tanaka — Streaming Event Formatter
+ *
+ * Formats NDJSON events for external agent consumption and terminal display.
+ * Universal envelope: every event carries agent identity, usage snapshot, timestamp.
+ */
+
+const SCHEMA_VERSION = 1;
+
+/**
+ * Build an NDJSON event envelope.
+ *
+ * @param {string} event - Event type (agent_start, tool_call, finding, heartbeat, etc.)
+ * @param {object} agentIdentity - { id, persona, color?, avatar? }
+ * @param {object} payload - Event-specific data
+ * @param {object} [usage] - Running usage totals
+ * @param {string} [runId] - Run identifier
+ * @returns {object} Complete event envelope
+ */
+export function buildStreamEvent(event, agentIdentity, payload, usage, runId) {
+  const visual = resolvePersonaVisual(agentIdentity?.id) || {};
+  return {
+    stream: "sl_event",
+    version: SCHEMA_VERSION,
+    command: "audit.deep",
+    runId: runId || null,
+    timestamp: new Date().toISOString(),
+    agent: {
+      id: agentIdentity?.id || "unknown",
+      persona: agentIdentity?.persona || visual.fullName || "unknown",
+      color: agentIdentity?.color || visual.color || "white",
+      avatar: agentIdentity?.avatar || visual.avatar || "",
+    },
+    event,
+    payload: payload || {},
+    usage: usage || {},
+  };
+}
+
+/**
+ * Create a streaming emitter bound to a specific agent and run.
+ *
+ * @param {object} config
+ * @param {object} config.agentIdentity - { id, persona }
+ * @param {string} config.runId
+ * @param {function} [config.onEvent] - Callback for each event
+ * @param {boolean} [config.stdoutNdjson] - Also write to stdout as NDJSON
+ * @returns {{ emit(event, payload, usage), close() }}
+ */
+export function createStreamEmitter({ agentIdentity, runId, onEvent, stdoutNdjson = false }) {
+  let closed = false;
+  const usageRef = { costUsd: 0, outputTokens: 0, toolCalls: 0, durationMs: 0 };
+
+  return {
+    /**
+     * Emit a streaming event.
+     */
+    emit(event, payload, usage) {
+      if (closed) return;
+      const merged = { ...usageRef, ...usage };
+      Object.assign(usageRef, merged);
+      const evt = buildStreamEvent(event, agentIdentity, payload, merged, runId);
+      if (onEvent) onEvent(evt);
+      if (stdoutNdjson) console.log(JSON.stringify(evt));
+      return evt;
+    },
+
+    /**
+     * Update accumulated usage without emitting.
+     */
+    updateUsage(delta) {
+      if (delta.costUsd !== undefined) usageRef.costUsd = delta.costUsd;
+      if (delta.outputTokens !== undefined) usageRef.outputTokens = delta.outputTokens;
+      if (delta.toolCalls !== undefined) usageRef.toolCalls = delta.toolCalls;
+      if (delta.durationMs !== undefined) usageRef.durationMs = delta.durationMs;
+    },
+
+    /**
+     * Mark emitter as closed (no more events).
+     */
+    close() {
+      closed = true;
+    },
+
+    /**
+     * Get current usage snapshot.
+     */
+    getUsage() {
+      return { ...usageRef };
+    },
+  };
+}
+
+/**
+ * Format a terminal display line for a persona event (non-JSON mode).
+ *
+ * @param {object} evt - Stream event
+ * @returns {string} Formatted line for stderr
+ */
+export function formatTerminalLine(evt) {
+  const agent = evt.agent || {};
+  const avatar = agent.avatar || "";
+  const name = agent.persona || agent.id || "Agent";
+  const p = evt.payload || {};
+
+  switch (evt.event) {
+    case "agent_start":
+      return `${avatar} ${name} starting (mode: ${p.mode || "primary"})...`;
+
+    case "progress":
+      return `${avatar} ${name}: ${p.message || p.phase || "working..."}`;
+
+    case "tool_call":
+      return `${avatar} ${name} [${p.tool}] ${formatToolInput(p.input)}`;
+
+    case "tool_result":
+      return `${avatar} ${name} [${p.tool}] ${p.durationMs || 0}ms ${p.success === false ? "FAILED" : "ok"}`;
+
+    case "finding": {
+      const sev = p.severity || "P3";
+      const sevColor = sev === "P0" ? "!!!" : sev === "P1" ? "!!" : sev === "P2" ? "!" : "";
+      return `${avatar} [${sev}${sevColor}] ${p.file || ""}:${p.line || ""} ${p.title || ""}`;
+    }
+
+    case "reasoning":
+      return `${avatar} ${name}: ${(p.summary || "").slice(0, 120)}`;
+
+    case "heartbeat": {
+      const h = p;
+      const budgetPct = h.budgetRemaining?.pct?.toFixed(0) || "?";
+      return `${avatar} ${name} [${h.turnsCompleted || 0}/${h.turnsMax || "?"} turns, ${budgetPct}% budget, ${h.findingsSoFar || 0} findings]`;
+    }
+
+    case "budget_warning":
+      return `${avatar} ${name} BUDGET WARNING: ${(p.warnings || []).map(w => w.code).join(", ")}`;
+
+    case "budget_stop":
+      return `${avatar} ${name} BUDGET STOP: ${(p.reasons || []).map(r => r.code || r).join(", ")}`;
+
+    case "swarm_start":
+      return `${avatar} ${name} spawning sub-agents (${p.scannerCount || 0} scanners, ${p.hunterCount || 0} hunters)...`;
+
+    case "swarm_complete":
+      return `${avatar} ${name} swarm complete: ${p.totalFindings || 0} findings from ${p.totalAgents || 0} agents ($${(p.totalCostUsd || 0).toFixed(2)})`;
+
+    case "phase_start":
+      return `${avatar} ${name} phase: ${p.phase || "unknown"}`;
+
+    case "agent_complete": {
+      const s = p;
+      return `${avatar} ${name} complete: ${s.total || 0} findings (P0=${s.P0 || 0} P1=${s.P1 || 0} P2=${s.P2 || 0}) $${(s.costUsd || 0).toFixed(2)} ${s.durationMs ? (s.durationMs / 1000).toFixed(1) + "s" : ""}`;
+    }
+
+    case "agent_abort":
+      return `${avatar} ${name} ABORTED: ${p.reason || "unknown"}`;
+
+    default:
+      return `${avatar} ${name} [${evt.event}]`;
+  }
+}
+
+function formatToolInput(input) {
+  if (!input) return "";
+  if (input.file_path) return input.file_path;
+  if (input.pattern) return `/${input.pattern}/`;
+  if (input.operation) return input.operation;
+  if (input.command) return input.command.slice(0, 60);
+  return "";
+}
+
+/**
+ * List all valid event types.
+ */
+export const EVENT_TYPES = Object.freeze([
+  "agent_start", "agent_complete", "agent_abort", "agent_error",
+  "progress", "heartbeat",
+  "tool_call", "tool_result",
+  "finding", "reasoning",
+  "budget_warning", "budget_stop",
+  "swarm_start", "swarm_complete",
+  "phase_start", "phase_complete",
+  "convergence_expansion", "coverage_gap",
+  "llm_error",
+]);

package/src/agents/jules/swarm/file-scanner.js

@@ -1,74 +1,74 @@
-import { JulesSubAgent } from "./sub-agent.js";
-
-const FILE_SCANNER_PROMPT = `You are a FileScanner sub-agent working for Jules Tanaka (SentinelLayer Frontend Specialist).
-
-Your job: Read each file in your scope and extract a structured summary.
-
-For each file, extract:
-- componentName: the primary exported component/function name
-- useStateCount: number of useState calls
-- useEffectCount: number of useEffect calls
-- imports: list of imported modules (just the module names)
-- exports: list of exported names
-- loc: approximate line count
-- riskSignals: array of any of these detected patterns:
-  - "dangerouslySetInnerHTML" if found
-  - "eval" if found
-  - "window_access_in_render" if window/document/localStorage used outside useEffect
-  - "missing_cleanup" if useEffect has subscription/timer without return
-  - "god_component" if useState count >= 16
-  - "large_file" if LOC > 500
-
-Use the FileRead tool to read each file. Use Grep if you need to search for patterns.
-
-Return your findings as a JSON array in a \`\`\`json code block:
-[
-  {
-    "file": "path/to/file.tsx",
-    "componentName": "Dashboard",
-    "useStateCount": 3,
-    "useEffectCount": 2,
-    "imports": ["react", "zustand", "./Header"],
-    "exports": ["Dashboard"],
-    "loc": 150,
-    "riskSignals": [],
-    "discoveredDependencies": ["./utils/formatDate", "../hooks/useAuth"]
-  }
-]
-
-The discoveredDependencies field is critical: list any imports that point to files NOT in your assigned scope. These will be used to expand the audit coverage.
-
-Be thorough but concise. Do not explain findings — just extract data.`;
-
-/**
- * Create a FileScanner sub-agent for a batch of files.
- *
- * @param {object} config
- * @param {string} config.id - Unique ID (e.g., "scanner-dashboard")
- * @param {string[]} config.files - Files to scan
- * @param {object} config.budget - Budget slice
- * @param {object} config.blackboard - Shared blackboard
- * @param {object} [config.provider] - LLM provider overrides
- * @param {AbortController} [config.parentAbort]
- * @param {function} [config.onEvent]
- */
-export function createFileScanner(config) {
-  return new JulesSubAgent({
-    id: config.id || `scanner-${Date.now()}`,
-    role: "FileScanner",
-    systemPrompt: FILE_SCANNER_PROMPT,
-    allowedTools: ["FileRead", "Grep", "Glob"],
-    scope: { files: config.files },
-    budget: config.budget || {
-      maxCostUsd: 0.5,
-      maxOutputTokens: 3000,
-      maxRuntimeMs: 60000,
-      maxToolCalls: config.files.length * 2 + 5,
-    },
-    blackboard: config.blackboard,
-    maxTurns: Math.min(config.files.length + 3, 15),
-    provider: config.provider,
-    parentAbort: config.parentAbort,
-    onEvent: config.onEvent,
-  });
-}
+import { JulesSubAgent } from "./sub-agent.js";
+
+const FILE_SCANNER_PROMPT = `You are a FileScanner sub-agent working for Jules Tanaka (SentinelLayer Frontend Specialist).
+
+Your job: Read each file in your scope and extract a structured summary.
+
+For each file, extract:
+- componentName: the primary exported component/function name
+- useStateCount: number of useState calls
+- useEffectCount: number of useEffect calls
+- imports: list of imported modules (just the module names)
+- exports: list of exported names
+- loc: approximate line count
+- riskSignals: array of any of these detected patterns:
+  - "dangerouslySetInnerHTML" if found
+  - "eval" if found
+  - "window_access_in_render" if window/document/localStorage used outside useEffect
+  - "missing_cleanup" if useEffect has subscription/timer without return
+  - "god_component" if useState count >= 16
+  - "large_file" if LOC > 500
+
+Use the FileRead tool to read each file. Use Grep if you need to search for patterns.
+
+Return your findings as a JSON array in a \`\`\`json code block:
+[
+  {
+    "file": "path/to/file.tsx",
+    "componentName": "Dashboard",
+    "useStateCount": 3,
+    "useEffectCount": 2,
+    "imports": ["react", "zustand", "./Header"],
+    "exports": ["Dashboard"],
+    "loc": 150,
+    "riskSignals": [],
+    "discoveredDependencies": ["./utils/formatDate", "../hooks/useAuth"]
+  }
+]
+
+The discoveredDependencies field is critical: list any imports that point to files NOT in your assigned scope. These will be used to expand the audit coverage.
+
+Be thorough but concise. Do not explain findings — just extract data.`;
+
+/**
+ * Create a FileScanner sub-agent for a batch of files.
+ *
+ * @param {object} config
+ * @param {string} config.id - Unique ID (e.g., "scanner-dashboard")
+ * @param {string[]} config.files - Files to scan
+ * @param {object} config.budget - Budget slice
+ * @param {object} config.blackboard - Shared blackboard
+ * @param {object} [config.provider] - LLM provider overrides
+ * @param {AbortController} [config.parentAbort]
+ * @param {function} [config.onEvent]
+ */
+export function createFileScanner(config) {
+  return new JulesSubAgent({
+    id: config.id || `scanner-${Date.now()}`,
+    role: "FileScanner",
+    systemPrompt: FILE_SCANNER_PROMPT,
+    allowedTools: ["FileRead", "Grep", "Glob"],
+    scope: { files: config.files },
+    budget: config.budget || {
+      maxCostUsd: 0.5,
+      maxOutputTokens: 3000,
+      maxRuntimeMs: 60000,
+      maxToolCalls: config.files.length * 2 + 5,
+    },
+    blackboard: config.blackboard,
+    maxTurns: Math.min(config.files.length + 3, 15),
+    provider: config.provider,
+    parentAbort: config.parentAbort,
+    onEvent: config.onEvent,
+  });
+}

package/src/agents/jules/swarm/index.js

@@ -1,11 +1,11 @@
-/**
- * Jules Tanaka — Sub-Agent Swarm
- *
- * Parallel isolated agents for frontend audit work.
- * Each sub-agent: own conversation, own budget, shared blackboard.
- */
-
-export { JulesSubAgent, runSubAgentBatch, SubAgentError } from "./sub-agent.js";
-export { createFileScanner } from "./file-scanner.js";
-export { createPatternHunter, HUNT_TYPES } from "./pattern-hunter.js";
-export { shouldSpawnSubAgents, runJulesSwarm } from "./orchestrator.js";
+/**
+ * Jules Tanaka — Sub-Agent Swarm
+ *
+ * Parallel isolated agents for frontend audit work.
+ * Each sub-agent: own conversation, own budget, shared blackboard.
+ */
+
+export { JulesSubAgent, runSubAgentBatch, SubAgentError } from "./sub-agent.js";
+export { createFileScanner } from "./file-scanner.js";
+export { createPatternHunter, HUNT_TYPES } from "./pattern-hunter.js";
+export { shouldSpawnSubAgents, runJulesSwarm } from "./orchestrator.js";