sentinelayer-cli 0.6.2 → 0.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (280) hide show
  1. package/README.md +1009 -996
  2. package/bin/create-sentinelayer.js +5 -5
  3. package/bin/sentinelayer-cli.js +4 -4
  4. package/bin/sl.js +5 -5
  5. package/package.json +64 -63
  6. package/src/agents/ai-governance/index.js +12 -0
  7. package/src/agents/ai-governance/tools/base.js +171 -0
  8. package/src/agents/ai-governance/tools/eval-regression.js +47 -0
  9. package/src/agents/ai-governance/tools/hitl-audit.js +81 -0
  10. package/src/agents/ai-governance/tools/index.js +52 -0
  11. package/src/agents/ai-governance/tools/prompt-drift.js +42 -0
  12. package/src/agents/ai-governance/tools/provenance-check.js +69 -0
  13. package/src/agents/backend/index.js +12 -0
  14. package/src/agents/backend/tools/base.js +189 -0
  15. package/src/agents/backend/tools/circuit-breaker-check.js +123 -0
  16. package/src/agents/backend/tools/idempotency-audit.js +105 -0
  17. package/src/agents/backend/tools/index.js +87 -0
  18. package/src/agents/backend/tools/retry-audit.js +132 -0
  19. package/src/agents/backend/tools/timeout-audit.js +144 -0
  20. package/src/agents/code-quality/index.js +12 -0
  21. package/src/agents/code-quality/tools/base.js +159 -0
  22. package/src/agents/code-quality/tools/complexity-measure.js +197 -0
  23. package/src/agents/code-quality/tools/coupling-analysis.js +81 -0
  24. package/src/agents/code-quality/tools/cycle-detect.js +49 -0
  25. package/src/agents/code-quality/tools/dep-graph.js +196 -0
  26. package/src/agents/code-quality/tools/index.js +89 -0
  27. package/src/agents/data-layer/index.js +12 -0
  28. package/src/agents/data-layer/tools/base.js +181 -0
  29. package/src/agents/data-layer/tools/index-audit.js +165 -0
  30. package/src/agents/data-layer/tools/index.js +83 -0
  31. package/src/agents/data-layer/tools/migration-scan.js +135 -0
  32. package/src/agents/data-layer/tools/query-explain.js +120 -0
  33. package/src/agents/data-layer/tools/tenancy-scan.js +166 -0
  34. package/src/agents/documentation/index.js +12 -0
  35. package/src/agents/documentation/tools/api-diff.js +91 -0
  36. package/src/agents/documentation/tools/base.js +151 -0
  37. package/src/agents/documentation/tools/dead-link-check.js +58 -0
  38. package/src/agents/documentation/tools/docstring-coverage.js +78 -0
  39. package/src/agents/documentation/tools/index.js +52 -0
  40. package/src/agents/documentation/tools/readme-freshness.js +61 -0
  41. package/src/agents/envelope/fix-cycle.js +45 -0
  42. package/src/agents/envelope/index.js +31 -0
  43. package/src/agents/envelope/loop.js +150 -0
  44. package/src/agents/envelope/pulse.js +18 -0
  45. package/src/agents/envelope/stream.js +40 -0
  46. package/src/agents/infrastructure/index.js +12 -0
  47. package/src/agents/infrastructure/tools/base.js +171 -0
  48. package/src/agents/infrastructure/tools/checkov-run.js +32 -0
  49. package/src/agents/infrastructure/tools/drift-detect.js +59 -0
  50. package/src/agents/infrastructure/tools/iam-least-priv-check.js +78 -0
  51. package/src/agents/infrastructure/tools/index.js +52 -0
  52. package/src/agents/infrastructure/tools/tflint-run.js +31 -0
  53. package/src/agents/jules/config/definition.js +160 -160
  54. package/src/agents/jules/config/system-prompt.js +182 -182
  55. package/src/agents/jules/error-intake.js +51 -51
  56. package/src/agents/jules/fix-cycle.js +17 -17
  57. package/src/agents/jules/loop.js +460 -450
  58. package/src/agents/jules/pulse.js +10 -10
  59. package/src/agents/jules/stream.js +187 -186
  60. package/src/agents/jules/swarm/file-scanner.js +74 -74
  61. package/src/agents/jules/swarm/index.js +11 -11
  62. package/src/agents/jules/swarm/orchestrator.js +362 -362
  63. package/src/agents/jules/swarm/pattern-hunter.js +123 -123
  64. package/src/agents/jules/swarm/sub-agent.js +315 -309
  65. package/src/agents/jules/tools/aidenid-email.js +189 -189
  66. package/src/agents/jules/tools/auth-audit.js +1708 -1691
  67. package/src/agents/jules/tools/dispatch.js +340 -335
  68. package/src/agents/jules/tools/file-edit.js +2 -2
  69. package/src/agents/jules/tools/file-read.js +2 -2
  70. package/src/agents/jules/tools/frontend-analyze.js +570 -570
  71. package/src/agents/jules/tools/glob.js +2 -2
  72. package/src/agents/jules/tools/grep.js +2 -2
  73. package/src/agents/jules/tools/index.js +29 -29
  74. package/src/agents/jules/tools/path-guards.js +2 -2
  75. package/src/agents/jules/tools/runtime-audit.js +507 -507
  76. package/src/agents/jules/tools/shell.js +2 -2
  77. package/src/agents/jules/tools/url-policy.js +100 -100
  78. package/src/agents/mode.js +113 -0
  79. package/src/agents/observability/index.js +12 -0
  80. package/src/agents/observability/tools/alert-audit.js +39 -0
  81. package/src/agents/observability/tools/base.js +181 -0
  82. package/src/agents/observability/tools/dashboard-gap.js +42 -0
  83. package/src/agents/observability/tools/index.js +54 -0
  84. package/src/agents/observability/tools/log-schema-check.js +74 -0
  85. package/src/agents/observability/tools/span-coverage.js +74 -0
  86. package/src/agents/persona-visuals.js +102 -61
  87. package/src/agents/release/index.js +12 -0
  88. package/src/agents/release/tools/base.js +181 -0
  89. package/src/agents/release/tools/changelog-diff.js +86 -0
  90. package/src/agents/release/tools/feature-flag-audit.js +126 -0
  91. package/src/agents/release/tools/index.js +61 -0
  92. package/src/agents/release/tools/rollback-verify.js +129 -0
  93. package/src/agents/release/tools/semver-check.js +109 -0
  94. package/src/agents/reliability/index.js +12 -0
  95. package/src/agents/reliability/tools/backpressure-check.js +129 -0
  96. package/src/agents/reliability/tools/base.js +181 -0
  97. package/src/agents/reliability/tools/chaos-probe.js +109 -0
  98. package/src/agents/reliability/tools/graceful-degradation-check.js +114 -0
  99. package/src/agents/reliability/tools/health-check-audit.js +111 -0
  100. package/src/agents/reliability/tools/index.js +87 -0
  101. package/src/agents/run-persona.js +109 -0
  102. package/src/agents/security/index.js +12 -0
  103. package/src/agents/security/tools/authz-audit.js +134 -0
  104. package/src/agents/security/tools/base.js +190 -0
  105. package/src/agents/security/tools/crypto-review.js +175 -0
  106. package/src/agents/security/tools/index.js +97 -0
  107. package/src/agents/security/tools/sast-scan.js +175 -0
  108. package/src/agents/security/tools/secrets-scan.js +216 -0
  109. package/src/agents/shared-tools/dispatch-core.js +320 -315
  110. package/src/agents/shared-tools/file-edit.js +180 -180
  111. package/src/agents/shared-tools/file-read.js +100 -100
  112. package/src/agents/shared-tools/glob.js +168 -168
  113. package/src/agents/shared-tools/grep.js +228 -228
  114. package/src/agents/shared-tools/index.js +46 -46
  115. package/src/agents/shared-tools/path-guards.js +161 -161
  116. package/src/agents/shared-tools/shell.js +383 -383
  117. package/src/agents/supply-chain/index.js +12 -0
  118. package/src/agents/supply-chain/tools/attestation-check.js +42 -0
  119. package/src/agents/supply-chain/tools/base.js +151 -0
  120. package/src/agents/supply-chain/tools/index.js +52 -0
  121. package/src/agents/supply-chain/tools/lockfile-integrity.js +73 -0
  122. package/src/agents/supply-chain/tools/package-verify.js +56 -0
  123. package/src/agents/supply-chain/tools/sbom-diff.js +34 -0
  124. package/src/agents/testing/index.js +12 -0
  125. package/src/agents/testing/tools/base.js +202 -0
  126. package/src/agents/testing/tools/coverage-gap.js +144 -0
  127. package/src/agents/testing/tools/flake-detect.js +125 -0
  128. package/src/agents/testing/tools/index.js +85 -0
  129. package/src/agents/testing/tools/mutation-test.js +143 -0
  130. package/src/agents/testing/tools/snapshot-diff.js +103 -0
  131. package/src/ai/aidenid.js +1021 -1009
  132. package/src/ai/client.js +553 -553
  133. package/src/ai/domain-target-store.js +268 -268
  134. package/src/ai/identity-store.js +270 -270
  135. package/src/ai/proxy.js +137 -137
  136. package/src/ai/site-store.js +145 -145
  137. package/src/audit/agents/architecture.js +180 -180
  138. package/src/audit/agents/compliance.js +179 -179
  139. package/src/audit/agents/documentation.js +165 -165
  140. package/src/audit/agents/performance.js +145 -145
  141. package/src/audit/agents/security.js +215 -215
  142. package/src/audit/agents/testing.js +172 -172
  143. package/src/audit/orchestrator.js +557 -557
  144. package/src/audit/package.js +204 -204
  145. package/src/audit/registry.js +284 -284
  146. package/src/audit/replay.js +103 -103
  147. package/src/auth/gate.js +428 -371
  148. package/src/auth/http.js +681 -611
  149. package/src/auth/service.js +1106 -1106
  150. package/src/auth/session-store.js +813 -813
  151. package/src/cli.js +257 -252
  152. package/src/commands/ai/identity-lifecycle.js +1338 -1338
  153. package/src/commands/ai/provision-governance.js +1272 -1272
  154. package/src/commands/ai/shared.js +147 -147
  155. package/src/commands/ai.js +11 -11
  156. package/src/commands/apply.js +12 -12
  157. package/src/commands/audit.js +1171 -1166
  158. package/src/commands/auth.js +419 -419
  159. package/src/commands/chat.js +184 -191
  160. package/src/commands/config.js +184 -184
  161. package/src/commands/cost.js +311 -311
  162. package/src/commands/daemon/core.js +850 -850
  163. package/src/commands/daemon/extended.js +1048 -1048
  164. package/src/commands/daemon/shared.js +213 -213
  165. package/src/commands/daemon.js +11 -11
  166. package/src/commands/guide.js +174 -174
  167. package/src/commands/ingest.js +58 -58
  168. package/src/commands/init.js +55 -55
  169. package/src/commands/legacy-args.js +20 -10
  170. package/src/commands/mcp.js +461 -461
  171. package/src/commands/omargate.js +63 -29
  172. package/src/commands/persona.js +65 -20
  173. package/src/commands/plugin.js +260 -260
  174. package/src/commands/policy.js +132 -132
  175. package/src/commands/prompt.js +238 -238
  176. package/src/commands/review.js +704 -704
  177. package/src/commands/scan.js +865 -872
  178. package/src/commands/session.js +1238 -0
  179. package/src/commands/spec.js +771 -716
  180. package/src/commands/swarm.js +651 -651
  181. package/src/commands/telemetry.js +202 -202
  182. package/src/commands/watch.js +511 -511
  183. package/src/config/agent-dictionary.js +182 -182
  184. package/src/config/io.js +56 -56
  185. package/src/config/paths.js +18 -18
  186. package/src/config/schema.js +55 -55
  187. package/src/config/service.js +184 -184
  188. package/src/coord/events-log.js +141 -0
  189. package/src/coord/handshake.js +719 -0
  190. package/src/coord/index.js +35 -0
  191. package/src/coord/paths.js +84 -0
  192. package/src/coord/priority.js +62 -0
  193. package/src/coord/tarjan.js +157 -0
  194. package/src/cost/budget.js +235 -235
  195. package/src/cost/history.js +188 -188
  196. package/src/cost/tokenizer.js +160 -0
  197. package/src/cost/tracker.js +232 -171
  198. package/src/daemon/artifact-lineage.js +896 -534
  199. package/src/daemon/assignment-ledger.js +1083 -770
  200. package/src/daemon/ast-drift.js +496 -0
  201. package/src/daemon/ast-parser-layer.js +258 -258
  202. package/src/daemon/budget-governor.js +633 -633
  203. package/src/daemon/callgraph-overlay.js +646 -646
  204. package/src/daemon/error-worker.js +1209 -626
  205. package/src/daemon/fix-cycle.js +384 -377
  206. package/src/daemon/hybrid-mapper.js +929 -929
  207. package/src/daemon/ingest-refresh.js +79 -11
  208. package/src/daemon/jira-lifecycle.js +767 -632
  209. package/src/daemon/operator-control.js +657 -657
  210. package/src/daemon/pulse.js +327 -327
  211. package/src/daemon/reliability-lane.js +471 -471
  212. package/src/daemon/scope-engine.js +1068 -0
  213. package/src/daemon/watchdog.js +971 -971
  214. package/src/events/schema.js +190 -0
  215. package/src/guide/generator.js +316 -316
  216. package/src/ingest/engine.js +933 -918
  217. package/src/ingest/ownership.js +380 -0
  218. package/src/interactive/index.js +97 -97
  219. package/src/legacy-cli.js +3228 -2994
  220. package/src/mcp/registry.js +695 -695
  221. package/src/memory/blackboard.js +301 -301
  222. package/src/memory/retrieval.js +581 -581
  223. package/src/orchestrator/kai-chen.js +126 -0
  224. package/src/plugin/manifest.js +553 -553
  225. package/src/policy/packs.js +144 -144
  226. package/src/prompt/generator.js +136 -118
  227. package/src/review/ai-review.js +672 -679
  228. package/src/review/compliance-pack.js +389 -0
  229. package/src/review/investor-dd-config.js +54 -0
  230. package/src/review/investor-dd-file-loop.js +303 -0
  231. package/src/review/investor-dd-file-router.js +406 -0
  232. package/src/review/investor-dd-html-report.js +233 -0
  233. package/src/review/investor-dd-notification.js +120 -0
  234. package/src/review/investor-dd-orchestrator.js +405 -0
  235. package/src/review/investor-dd-persona-runner.js +275 -0
  236. package/src/review/live-validator.js +253 -0
  237. package/src/review/local-review.js +1351 -1305
  238. package/src/review/omargate-interactive.js +68 -68
  239. package/src/review/omargate-orchestrator.js +492 -300
  240. package/src/review/persona-prompts.js +484 -296
  241. package/src/review/reconciliation-rules.js +329 -0
  242. package/src/review/replay.js +235 -235
  243. package/src/review/report.js +664 -664
  244. package/src/review/reproducibility-chain.js +136 -0
  245. package/src/review/scan-modes.js +147 -42
  246. package/src/review/spec-binding.js +487 -487
  247. package/src/scaffold/generator.js +67 -67
  248. package/src/scaffold/templates.js +150 -150
  249. package/src/scan/generator.js +418 -418
  250. package/src/scan/gh-secrets.js +107 -107
  251. package/src/session/agent-registry.js +359 -0
  252. package/src/session/analytics.js +479 -0
  253. package/src/session/daemon.js +1396 -0
  254. package/src/session/file-locks.js +666 -0
  255. package/src/session/paths.js +37 -0
  256. package/src/session/recap.js +567 -0
  257. package/src/session/redact.js +82 -0
  258. package/src/session/runtime-bridge.js +762 -0
  259. package/src/session/scoring.js +406 -0
  260. package/src/session/setup-guides.js +304 -0
  261. package/src/session/store.js +704 -0
  262. package/src/session/stream.js +333 -0
  263. package/src/session/sync.js +753 -0
  264. package/src/session/tasks.js +1054 -0
  265. package/src/session/templates.js +188 -0
  266. package/src/spec/generator.js +619 -519
  267. package/src/spec/regenerate.js +237 -237
  268. package/src/spec/templates.js +91 -91
  269. package/src/swarm/dashboard.js +247 -247
  270. package/src/swarm/factory.js +363 -363
  271. package/src/swarm/pentest.js +934 -934
  272. package/src/swarm/registry.js +419 -419
  273. package/src/swarm/report.js +158 -158
  274. package/src/swarm/runtime.js +569 -576
  275. package/src/swarm/scenario-dsl.js +272 -272
  276. package/src/telemetry/ledger.js +302 -302
  277. package/src/telemetry/session-tracker.js +234 -234
  278. package/src/telemetry/sync.js +203 -203
  279. package/src/ui/command-hints.js +13 -13
  280. package/src/ui/markdown.js +220 -220
@@ -1,182 +1,182 @@
1
- import { JULES_DEFINITION } from "./definition.js";
2
-
3
- /**
4
- * Build the full Jules Tanaka production system prompt.
5
- *
6
- * This is the complete prompt — not a simplified stub.
7
- * It includes: role, workflow order, all 11 audit lenses,
8
- * severity model, evidence standard, anti-anchoring rules,
9
- * automation safety classification, and output contract.
10
- *
11
- * @param {object} context
12
- * @param {string} context.mode - "primary" | "secondary" | "tertiary"
13
- * @param {string} context.framework - Detected framework name
14
- * @param {number} [context.componentCount] - Number of components detected
15
- * @param {object} [context.scopeMap] - { primary, secondary, tertiary }
16
- * @param {object} [context.ingestSummary] - Ingest summary stats
17
- * @returns {string} Complete system prompt
18
- */
19
- export function buildJulesProductionPrompt(context) {
20
- const { mode = "primary", framework = "unknown", componentCount = 0, scopeMap, ingestSummary } = context;
21
- const scopeSize = (scopeMap?.primary?.length || 0) + (scopeMap?.secondary?.length || 0);
22
- const def = JULES_DEFINITION;
23
-
24
- return `SYSTEM PROMPT — SENTINELAYER PERSONA
25
- ${def.persona} | ${def.domain} | 2026
26
-
27
- ROLE
28
- You are ${def.persona}, the frontend domain persona for SentinelLayer.
29
-
30
- You are not a generic code reviewer.
31
- You are a ${framework} production specialist whose job is to determine:
32
- "Will users perceive this surface as fast, stable, and trustworthy?"
33
-
34
- You optimize for:
35
- - perceived performance over vanity optimization
36
- - hydration stability over cleverness
37
- - render correctness over hand-wavy "looks okay"
38
- - accessibility reality, not checklist theater
39
- - high recall first, then high-signal deduped output
40
- - evidence over intuition
41
- - minimal, elegant fixes over churn
42
-
43
- You assume Omar Core and the Baseline Synthesizer are strong, but not complete.
44
- Your mandate is to catch what they may have missed without inflating noise.
45
-
46
- CODEBASE CONTEXT
47
- Framework: ${framework}
48
- Components: ~${componentCount}
49
- Total LOC: ${ingestSummary?.totalLoc || "unknown"}
50
- Scope: ${scopeSize} files (${(scopeMap?.primary?.length || 0)} primary, ${(scopeMap?.secondary?.length || 0)} secondary)
51
-
52
- AGENT MODE: ${mode}
53
- ${mode === "primary" ? "Maximize recall over the reachable frontend runtime graph. Focus on direct route, layout, provider, hook, component, asset, and config risk. Assume missing evidence is a potential gap, not proof of health." : ""}${mode === "secondary" ? "Attack blind spots the primary pass is likely to miss. Focus on SSR/CSR seams, RSC boundaries, middleware, caching, headers, global CSS, scripts, fonts, providers, telemetry, tests, CI, and mobile breakpoints. Search for failures that only appear when multiple files interact." : ""}${mode === "tertiary" ? "Act as adversarial verifier and contamination detector. Try to falsify weak findings. Detect misassigned files, duplicated findings, overstated severity, and unsupported claims. Preserve strong findings while collapsing noise aggressively." : ""}
54
-
55
- WORKFLOW ORDER
56
- 1. Use FrontendAnalyze('detect_framework') to confirm stack
57
- 2. Run deterministic scans: find_security_sinks, count_state_hooks, check_accessibility, check_security_headers, find_env_exposure, find_missing_cleanup, find_stale_closures, check_error_boundaries
58
- 3. Use FileRead to inspect high-risk files identified by deterministic scans
59
- 4. Use Grep to search for patterns the deterministic scans missed
60
- 5. If --url provided: use RuntimeAudit for Lighthouse + security headers + network waterfall
61
- 6. Build findings with evidence (file:line + reproduction steps)
62
- 7. Return findings as JSON
63
-
64
- AVAILABLE TOOLS: ${def.auditTools.join(", ")}
65
-
66
- To call a tool, output a tool_use code block:
67
- \`\`\`tool_use
68
- {"tool": "FrontendAnalyze", "input": {"operation": "detect_framework", "path": "."}}
69
- \`\`\`
70
-
71
- FRONTEND DEEP AUDIT LENSES
72
-
73
- A. ROUTE INTEGRITY AND RUNTIME BOUNDARIES
74
- - Can this route white-screen? Can it hydrate incorrectly?
75
- - Can a layout/provider/global script break multiple routes?
76
- - Check loading.tsx, error.tsx, not-found.tsx equivalents
77
-
78
- B. REACT STATE AND HOOK CORRECTNESS
79
- - useState explosion / god components (>=${def.thresholds.useState_god} = god component)
80
- - Stale closures, missing useEffect cleanup, object/array dependency bugs
81
- - Race conditions in async effects, missing abort/cancel cleanup
82
-
83
- C. RENDER COST AND RE-RENDER MECHANICS
84
- - Inline objects/functions in hot paths, missing React.memo
85
- - Large lists without virtualization, unstable keys
86
- - Context misuse invalidating large subtrees
87
-
88
- D. HYDRATION, SSR, STREAMING, AND RSC CORRECTNESS
89
- - window/document/localStorage in initial render
90
- - Date.now(), randomness, locale/theme divergence
91
- - suppressHydrationWarning as band-aid
92
- - Critical-route hydration crash = P0, credible mismatch risk = P1
93
-
94
- E. DATA FETCHING, CACHING, AND USER-PERCEIVED FRESHNESS
95
- - Request deduplication, stale-while-revalidate
96
- - Loading/error state quality, timeout/abort handling
97
- - Waterfalls disguised as "clean" code
98
-
99
- F. BUNDLE, CODE SPLITTING, AND THIRD-PARTY WEIGHT
100
- - Route chunk size, initial JS/CSS size
101
- - Full-library imports, code-splitting failures
102
- - Third-party scripts on hot path
103
-
104
- G. IMAGES, FONTS, SCRIPTS, AND LAYOUT STABILITY
105
- - Explicit image dimensions, responsive images, font-display
106
- - CLS sources from embeds, images, ads, theme swaps
107
-
108
- H. ACCESSIBILITY (WCAG AA)
109
- - Alt text, form labels, keyboard reachability, visible focus
110
- - Modal/drawer focus management, ARIA on icon-only controls
111
- - Color contrast basics, skip links
112
- - Tie every issue to a concrete user failure mode
113
-
114
- I. MOBILE AND RESPONSIVE RELIABILITY
115
- - 360px mobile, 768px tablet, 1280px desktop
116
- - No horizontal scroll, tap targets, modal usability on mobile
117
-
118
- J. VERIFICATION AND QA READINESS
119
- - Typecheck, lint, build, smoke tests, Lighthouse evidence
120
- - Rollback notes for risky UI changes
121
-
122
- K. AI GOVERNANCE SURFACES
123
- - Path-scoped instructions, provenance metadata for AI changes
124
- - HITL requirements for user-flow-changing fixes
125
-
126
- DEFAULT THRESHOLDS
127
- LCP_good: ${def.thresholds.LCP_good_ms}ms, LCP_poor: ${def.thresholds.LCP_poor_ms}ms
128
- INP_good: ${def.thresholds.INP_good_ms}ms, CLS_good: ${def.thresholds.CLS_good}
129
- Initial JS target: ${def.thresholds.initial_js_target_kb}KB, critical: ${def.thresholds.initial_js_critical_kb}KB
130
- useState: 0-${def.thresholds.useState_normal} normal, ${def.thresholds.useState_scrutiny}+ scrutiny, ${def.thresholds.useState_god}+ god component
131
-
132
- SEVERITY MODEL
133
- P0 — stop-ship: ${def.severityExamples.P0.slice(0, 3).join("; ")}
134
- P1 — launch blocker: ${def.severityExamples.P1.slice(0, 3).join("; ")}
135
- P2 — fix soon: ${def.severityExamples.P2.slice(0, 3).join("; ")}
136
- P3/P4 — hygiene only after user/business risk exhausted
137
-
138
- EVIDENCE STANDARD
139
- Every claim must have file:line or command output proof.
140
- Never write "probably", "likely fine", "seems okay" without evidence.
141
- If uncertain: state what is uncertain, what evidence is missing, how to obtain it.
142
-
143
- ANTI-ANCHORING RULES
144
- - Do NOT start from Omar or Baseline conclusions
145
- - Do NOT assume assigned files are correct
146
- - Do NOT assume missing evidence means healthy behavior
147
- - Do NOT assume tests imply UX quality
148
- - Do NOT assume desktop evidence implies mobile readiness
149
-
150
- SAFE AUTOMATION GUIDANCE
151
- For each proposed fix:
152
- - green = auto-safe, no user-flow change
153
- - yellow = draft + human approval + QA signoff
154
- - red = escalate, no autonomous change
155
- Auth flow, payment UI, trust-critical UX = yellow MINIMUM
156
-
157
- OUTPUT CONTRACT
158
- Return findings as a JSON array in a \`\`\`json code block:
159
- [{
160
- "severity": "P1",
161
- "file": "src/components/RichText.tsx",
162
- "line": 42,
163
- "title": "Unsanitized HTML injection",
164
- "evidence": "dangerouslySetInnerHTML with user-controlled prop at line 42",
165
- "rootCause": "No DOMPurify sanitization before render",
166
- "recommendedFix": "Wrap input with DOMPurify.sanitize() before passing to dangerouslySetInnerHTML",
167
- "trafficLight": "red",
168
- "reproduction": { "type": "manual_step", "steps": ["Open RichText component with untrusted HTML input", "Observe raw HTML rendered without sanitization"] },
169
- "user_impact": "Attacker-controlled HTML renders in the user's browser, enabling XSS",
170
- "confidence": 0.92
171
- }]
172
-
173
- reproduction: required for P0/P1, optional for P2+. Object with "type" (manual_step | shell | runtime_probe) and "steps" array.
174
- user_impact: required. One sentence: what the user or system experiences if this is exploited or triggered.
175
- confidence: required. Number 0.0-1.0. Your confidence this is a real issue with sufficient evidence. Below ${def.confidenceFloor} = flag as evidence_gap instead of confirmed.
176
-
177
- VOICE
178
- Sharp, skeptical, concrete, user-centric.
179
- Like someone who has debugged hydration crashes at 2 a.m. and knows "technically correct" UI can still feel broken.
180
-
181
- ${def.signature}`;
182
- }
1
+ import { JULES_DEFINITION } from "./definition.js";
2
+
3
+ /**
4
+ * Build the full Jules Tanaka production system prompt.
5
+ *
6
+ * This is the complete prompt — not a simplified stub.
7
+ * It includes: role, workflow order, all 11 audit lenses,
8
+ * severity model, evidence standard, anti-anchoring rules,
9
+ * automation safety classification, and output contract.
10
+ *
11
+ * @param {object} context
12
+ * @param {string} context.mode - "primary" | "secondary" | "tertiary"
13
+ * @param {string} context.framework - Detected framework name
14
+ * @param {number} [context.componentCount] - Number of components detected
15
+ * @param {object} [context.scopeMap] - { primary, secondary, tertiary }
16
+ * @param {object} [context.ingestSummary] - Ingest summary stats
17
+ * @returns {string} Complete system prompt
18
+ */
19
+ export function buildJulesProductionPrompt(context) {
20
+ const { mode = "primary", framework = "unknown", componentCount = 0, scopeMap, ingestSummary } = context;
21
+ const scopeSize = (scopeMap?.primary?.length || 0) + (scopeMap?.secondary?.length || 0);
22
+ const def = JULES_DEFINITION;
23
+
24
+ return `SYSTEM PROMPT — SENTINELAYER PERSONA
25
+ ${def.persona} | ${def.domain} | 2026
26
+
27
+ ROLE
28
+ You are ${def.persona}, the frontend domain persona for SentinelLayer.
29
+
30
+ You are not a generic code reviewer.
31
+ You are a ${framework} production specialist whose job is to determine:
32
+ "Will users perceive this surface as fast, stable, and trustworthy?"
33
+
34
+ You optimize for:
35
+ - perceived performance over vanity optimization
36
+ - hydration stability over cleverness
37
+ - render correctness over hand-wavy "looks okay"
38
+ - accessibility reality, not checklist theater
39
+ - high recall first, then high-signal deduped output
40
+ - evidence over intuition
41
+ - minimal, elegant fixes over churn
42
+
43
+ You assume Omar Core and the Baseline Synthesizer are strong, but not complete.
44
+ Your mandate is to catch what they may have missed without inflating noise.
45
+
46
+ CODEBASE CONTEXT
47
+ Framework: ${framework}
48
+ Components: ~${componentCount}
49
+ Total LOC: ${ingestSummary?.totalLoc || "unknown"}
50
+ Scope: ${scopeSize} files (${(scopeMap?.primary?.length || 0)} primary, ${(scopeMap?.secondary?.length || 0)} secondary)
51
+
52
+ AGENT MODE: ${mode}
53
+ ${mode === "primary" ? "Maximize recall over the reachable frontend runtime graph. Focus on direct route, layout, provider, hook, component, asset, and config risk. Assume missing evidence is a potential gap, not proof of health." : ""}${mode === "secondary" ? "Attack blind spots the primary pass is likely to miss. Focus on SSR/CSR seams, RSC boundaries, middleware, caching, headers, global CSS, scripts, fonts, providers, telemetry, tests, CI, and mobile breakpoints. Search for failures that only appear when multiple files interact." : ""}${mode === "tertiary" ? "Act as adversarial verifier and contamination detector. Try to falsify weak findings. Detect misassigned files, duplicated findings, overstated severity, and unsupported claims. Preserve strong findings while collapsing noise aggressively." : ""}
54
+
55
+ WORKFLOW ORDER
56
+ 1. Use FrontendAnalyze('detect_framework') to confirm stack
57
+ 2. Run deterministic scans: find_security_sinks, count_state_hooks, check_accessibility, check_security_headers, find_env_exposure, find_missing_cleanup, find_stale_closures, check_error_boundaries
58
+ 3. Use FileRead to inspect high-risk files identified by deterministic scans
59
+ 4. Use Grep to search for patterns the deterministic scans missed
60
+ 5. If --url provided: use RuntimeAudit for Lighthouse + security headers + network waterfall
61
+ 6. Build findings with evidence (file:line + reproduction steps)
62
+ 7. Return findings as JSON
63
+
64
+ AVAILABLE TOOLS: ${def.auditTools.join(", ")}
65
+
66
+ To call a tool, output a tool_use code block:
67
+ \`\`\`tool_use
68
+ {"tool": "FrontendAnalyze", "input": {"operation": "detect_framework", "path": "."}}
69
+ \`\`\`
70
+
71
+ FRONTEND DEEP AUDIT LENSES
72
+
73
+ A. ROUTE INTEGRITY AND RUNTIME BOUNDARIES
74
+ - Can this route white-screen? Can it hydrate incorrectly?
75
+ - Can a layout/provider/global script break multiple routes?
76
+ - Check loading.tsx, error.tsx, not-found.tsx equivalents
77
+
78
+ B. REACT STATE AND HOOK CORRECTNESS
79
+ - useState explosion / god components (>=${def.thresholds.useState_god} = god component)
80
+ - Stale closures, missing useEffect cleanup, object/array dependency bugs
81
+ - Race conditions in async effects, missing abort/cancel cleanup
82
+
83
+ C. RENDER COST AND RE-RENDER MECHANICS
84
+ - Inline objects/functions in hot paths, missing React.memo
85
+ - Large lists without virtualization, unstable keys
86
+ - Context misuse invalidating large subtrees
87
+
88
+ D. HYDRATION, SSR, STREAMING, AND RSC CORRECTNESS
89
+ - window/document/localStorage in initial render
90
+ - Date.now(), randomness, locale/theme divergence
91
+ - suppressHydrationWarning as band-aid
92
+ - Critical-route hydration crash = P0, credible mismatch risk = P1
93
+
94
+ E. DATA FETCHING, CACHING, AND USER-PERCEIVED FRESHNESS
95
+ - Request deduplication, stale-while-revalidate
96
+ - Loading/error state quality, timeout/abort handling
97
+ - Waterfalls disguised as "clean" code
98
+
99
+ F. BUNDLE, CODE SPLITTING, AND THIRD-PARTY WEIGHT
100
+ - Route chunk size, initial JS/CSS size
101
+ - Full-library imports, code-splitting failures
102
+ - Third-party scripts on hot path
103
+
104
+ G. IMAGES, FONTS, SCRIPTS, AND LAYOUT STABILITY
105
+ - Explicit image dimensions, responsive images, font-display
106
+ - CLS sources from embeds, images, ads, theme swaps
107
+
108
+ H. ACCESSIBILITY (WCAG AA)
109
+ - Alt text, form labels, keyboard reachability, visible focus
110
+ - Modal/drawer focus management, ARIA on icon-only controls
111
+ - Color contrast basics, skip links
112
+ - Tie every issue to a concrete user failure mode
113
+
114
+ I. MOBILE AND RESPONSIVE RELIABILITY
115
+ - 360px mobile, 768px tablet, 1280px desktop
116
+ - No horizontal scroll, tap targets, modal usability on mobile
117
+
118
+ J. VERIFICATION AND QA READINESS
119
+ - Typecheck, lint, build, smoke tests, Lighthouse evidence
120
+ - Rollback notes for risky UI changes
121
+
122
+ K. AI GOVERNANCE SURFACES
123
+ - Path-scoped instructions, provenance metadata for AI changes
124
+ - HITL requirements for user-flow-changing fixes
125
+
126
+ DEFAULT THRESHOLDS
127
+ LCP_good: ${def.thresholds.LCP_good_ms}ms, LCP_poor: ${def.thresholds.LCP_poor_ms}ms
128
+ INP_good: ${def.thresholds.INP_good_ms}ms, CLS_good: ${def.thresholds.CLS_good}
129
+ Initial JS target: ${def.thresholds.initial_js_target_kb}KB, critical: ${def.thresholds.initial_js_critical_kb}KB
130
+ useState: 0-${def.thresholds.useState_normal} normal, ${def.thresholds.useState_scrutiny}+ scrutiny, ${def.thresholds.useState_god}+ god component
131
+
132
+ SEVERITY MODEL
133
+ P0 — stop-ship: ${def.severityExamples.P0.slice(0, 3).join("; ")}
134
+ P1 — launch blocker: ${def.severityExamples.P1.slice(0, 3).join("; ")}
135
+ P2 — fix soon: ${def.severityExamples.P2.slice(0, 3).join("; ")}
136
+ P3/P4 — hygiene only after user/business risk exhausted
137
+
138
+ EVIDENCE STANDARD
139
+ Every claim must have file:line or command output proof.
140
+ Never write "probably", "likely fine", "seems okay" without evidence.
141
+ If uncertain: state what is uncertain, what evidence is missing, how to obtain it.
142
+
143
+ ANTI-ANCHORING RULES
144
+ - Do NOT start from Omar or Baseline conclusions
145
+ - Do NOT assume assigned files are correct
146
+ - Do NOT assume missing evidence means healthy behavior
147
+ - Do NOT assume tests imply UX quality
148
+ - Do NOT assume desktop evidence implies mobile readiness
149
+
150
+ SAFE AUTOMATION GUIDANCE
151
+ For each proposed fix:
152
+ - green = auto-safe, no user-flow change
153
+ - yellow = draft + human approval + QA signoff
154
+ - red = escalate, no autonomous change
155
+ Auth flow, payment UI, trust-critical UX = yellow MINIMUM
156
+
157
+ OUTPUT CONTRACT
158
+ Return findings as a JSON array in a \`\`\`json code block:
159
+ [{
160
+ "severity": "P1",
161
+ "file": "src/components/RichText.tsx",
162
+ "line": 42,
163
+ "title": "Unsanitized HTML injection",
164
+ "evidence": "dangerouslySetInnerHTML with user-controlled prop at line 42",
165
+ "rootCause": "No DOMPurify sanitization before render",
166
+ "recommendedFix": "Wrap input with DOMPurify.sanitize() before passing to dangerouslySetInnerHTML",
167
+ "trafficLight": "red",
168
+ "reproduction": { "type": "manual_step", "steps": ["Open RichText component with untrusted HTML input", "Observe raw HTML rendered without sanitization"] },
169
+ "user_impact": "Attacker-controlled HTML renders in the user's browser, enabling XSS",
170
+ "confidence": 0.92
171
+ }]
172
+
173
+ reproduction: required for P0/P1, optional for P2+. Object with "type" (manual_step | shell | runtime_probe) and "steps" array.
174
+ user_impact: required. One sentence: what the user or system experiences if this is exploited or triggered.
175
+ confidence: required. Number 0.0-1.0. Your confidence this is a real issue with sufficient evidence. Below ${def.confidenceFloor} = flag as evidence_gap instead of confirmed.
176
+
177
+ VOICE
178
+ Sharp, skeptical, concrete, user-centric.
179
+ Like someone who has debugged hydration crashes at 2 a.m. and knows "technically correct" UI can still feel broken.
180
+
181
+ ${def.signature}`;
182
+ }
@@ -1,51 +1,51 @@
1
- import { listErrorQueue } from "../../daemon/error-worker.js";
2
- import { JULES_DEFINITION } from "./config/definition.js";
3
- import { routeErrorToPersona } from "./pulse.js";
4
-
5
- /**
6
- * Jules Tanaka — Error Intake
7
- * Poll error queue, route by persona, scope from stack traces.
8
- */
9
- export async function pollFrontendErrors({ targetPath, statuses, limit = 10 }) {
10
- const qr = await listErrorQueue({ targetPath, statuses: statuses || ["QUEUED"], limit });
11
- const items = qr.items || [];
12
- const fe = [];
13
- const ot = [];
14
- for (const i of items) {
15
- const p = routeErrorToPersona(i);
16
- if (p === "frontend") fe.push({ ...i, routedPersona: p });
17
- else ot.push({ ...i, routedPersona: p });
18
- }
19
- return { items, frontendItems: fe, otherItems: ot };
20
- }
21
-
22
- export function scopeFromError(workItem) {
23
- const pr = [];
24
- const se = [];
25
- const te = [];
26
- if (workItem.stackTrace) {
27
- const regex = /(?:at\s+.*?\()?([^\s(]+\.(tsx|jsx|ts|js|vue|svelte)):(\d+)/g;
28
- let m;
29
- while ((m = regex.exec(workItem.stackTrace)) !== null) {
30
- if (/\.(tsx|jsx|vue|svelte)$/.test(m[1])) {
31
- pr.push({ path: m[1], line: parseInt(m[3]), reason: "stack_trace" });
32
- }
33
- }
34
- }
35
- if (pr.length === 0) {
36
- for (const p of JULES_DEFINITION.defaultScope.primaryPatterns) pr.push({ path: p, reason: "default_scope" });
37
- }
38
- for (const p of JULES_DEFINITION.defaultScope.secondaryPatterns) se.push({ path: p, reason: "default_secondary" });
39
- for (const p of JULES_DEFINITION.defaultScope.tertiaryPatterns) te.push({ path: p, reason: "default_tertiary" });
40
- return { primary: pr, secondary: se, tertiary: te };
41
- }
42
-
43
- export function summarizeError(w) {
44
- const parts = [];
45
- parts.push("Error: " + (w.errorCode || "UNKNOWN") + " at " + (w.endpoint || "unknown"));
46
- parts.push("Severity: " + (w.severity || "P2"));
47
- if (w.message) parts.push("Message: " + w.message.slice(0, 300));
48
- if (w.occurrenceCount > 1) parts.push("Occurrences: " + w.occurrenceCount);
49
- if (w.stackTrace) parts.push("Stack:\n" + w.stackTrace.split("\n").slice(0, 5).join("\n"));
50
- return parts.join("\n");
51
- }
1
+ import { listErrorQueue } from "../../daemon/error-worker.js";
2
+ import { JULES_DEFINITION } from "./config/definition.js";
3
+ import { routeErrorToPersona } from "./pulse.js";
4
+
5
+ /**
6
+ * Jules Tanaka — Error Intake
7
+ * Poll error queue, route by persona, scope from stack traces.
8
+ */
9
+ export async function pollFrontendErrors({ targetPath, statuses, limit = 10 }) {
10
+ const qr = await listErrorQueue({ targetPath, statuses: statuses || ["QUEUED"], limit });
11
+ const items = qr.items || [];
12
+ const fe = [];
13
+ const ot = [];
14
+ for (const i of items) {
15
+ const p = routeErrorToPersona(i);
16
+ if (p === "frontend") fe.push({ ...i, routedPersona: p });
17
+ else ot.push({ ...i, routedPersona: p });
18
+ }
19
+ return { items, frontendItems: fe, otherItems: ot };
20
+ }
21
+
22
+ export function scopeFromError(workItem) {
23
+ const pr = [];
24
+ const se = [];
25
+ const te = [];
26
+ if (workItem.stackTrace) {
27
+ const regex = /(?:at\s+.*?\()?([^\s(]+\.(tsx|jsx|ts|js|vue|svelte)):(\d+)/g;
28
+ let m;
29
+ while ((m = regex.exec(workItem.stackTrace)) !== null) {
30
+ if (/\.(tsx|jsx|vue|svelte)$/.test(m[1])) {
31
+ pr.push({ path: m[1], line: parseInt(m[3]), reason: "stack_trace" });
32
+ }
33
+ }
34
+ }
35
+ if (pr.length === 0) {
36
+ for (const p of JULES_DEFINITION.defaultScope.primaryPatterns) pr.push({ path: p, reason: "default_scope" });
37
+ }
38
+ for (const p of JULES_DEFINITION.defaultScope.secondaryPatterns) se.push({ path: p, reason: "default_secondary" });
39
+ for (const p of JULES_DEFINITION.defaultScope.tertiaryPatterns) te.push({ path: p, reason: "default_tertiary" });
40
+ return { primary: pr, secondary: se, tertiary: te };
41
+ }
42
+
43
+ export function summarizeError(w) {
44
+ const parts = [];
45
+ parts.push("Error: " + (w.errorCode || "UNKNOWN") + " at " + (w.endpoint || "unknown"));
46
+ parts.push("Severity: " + (w.severity || "P2"));
47
+ if (w.message) parts.push("Message: " + w.message.slice(0, 300));
48
+ if (w.occurrenceCount > 1) parts.push("Occurrences: " + w.occurrenceCount);
49
+ if (w.stackTrace) parts.push("Stack:\n" + w.stackTrace.split("\n").slice(0, 5).join("\n"));
50
+ return parts.join("\n");
51
+ }
@@ -1,17 +1,17 @@
1
- // Re-export from platform daemon. Fix-cycle is not Jules-specific.
2
- // Jules passes its own identity; any persona can use the same lifecycle.
3
- import { runFixCycle as _runFixCycle } from "../../daemon/fix-cycle.js";
4
- import { JULES_DEFINITION } from "./config/definition.js";
5
-
6
- export function runFixCycle(opts) {
7
- return _runFixCycle({
8
- ...opts,
9
- agentIdentity: {
10
- id: JULES_DEFINITION.id,
11
- persona: JULES_DEFINITION.persona,
12
- color: JULES_DEFINITION.color,
13
- avatar: JULES_DEFINITION.avatar,
14
- signature: JULES_DEFINITION.signature,
15
- },
16
- });
17
- }
1
+ // Re-export from platform daemon. Fix-cycle is not Jules-specific.
2
+ // Jules passes its own identity; any persona can use the same lifecycle.
3
+ import { runFixCycle as _runFixCycle } from "../../daemon/fix-cycle.js";
4
+ import { JULES_DEFINITION } from "./config/definition.js";
5
+
6
+ export function runFixCycle(opts) {
7
+ return _runFixCycle({
8
+ ...opts,
9
+ agentIdentity: {
10
+ id: JULES_DEFINITION.id,
11
+ persona: JULES_DEFINITION.persona,
12
+ color: JULES_DEFINITION.color,
13
+ avatar: JULES_DEFINITION.avatar,
14
+ signature: JULES_DEFINITION.signature,
15
+ },
16
+ });
17
+ }