@ryuenn3123/agentic-senior-core 4.4.0 → 5.1.0

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 (196) hide show
  1. package/.agents/plugins/marketplace.json +21 -0
  2. package/.agents/rules/agentic-senior-core.md +126 -0
  3. package/.claude-plugin/marketplace.json +17 -0
  4. package/.claude-plugin/plugin.json +17 -0
  5. package/.clinerules/agentic-senior-core.md +94 -0
  6. package/.codex-plugin/plugin.json +24 -0
  7. package/.cursor/rules/agentic-senior-core.mdc +99 -0
  8. package/.devin-plugin/plugin.json +13 -0
  9. package/.github/copilot-instructions.md +94 -0
  10. package/.github/plugin/marketplace.json +20 -0
  11. package/.github/plugin/plugin.json +16 -0
  12. package/.kiro/steering/agentic-senior-core.md +94 -0
  13. package/.openclaw/skills/asc/SKILL.md +23 -0
  14. package/.openclaw/skills/asc-audit/SKILL.md +28 -0
  15. package/.openclaw/skills/asc-review/SKILL.md +54 -0
  16. package/.opencode/plugins/agentic-senior-core.mjs +31 -0
  17. package/.windsurf/rules/agentic-senior-core.md +94 -0
  18. package/AGENTS.md +126 -127
  19. package/CONTRIBUTING.md +93 -63
  20. package/README.md +160 -111
  21. package/__init__.py +61 -0
  22. package/bin/agentic-senior-core.js +42 -41
  23. package/commands/asc-audit.md +1 -0
  24. package/commands/asc-audit.toml +2 -0
  25. package/commands/asc-help.md +9 -0
  26. package/commands/asc-help.toml +2 -0
  27. package/commands/asc-refactor.md +1 -0
  28. package/commands/asc-refactor.toml +2 -0
  29. package/commands/asc-review.md +1 -0
  30. package/commands/asc-review.toml +2 -0
  31. package/gemini-extension.json +10 -0
  32. package/hooks/copilot-hooks.json +21 -0
  33. package/hooks/hooks.json +31 -0
  34. package/hooks/session-start.js +36 -0
  35. package/hooks/subagent-start.js +38 -0
  36. package/lib/cli/commands/adapter.mjs +109 -0
  37. package/lib/cli/commands/clean.mjs +63 -0
  38. package/lib/cli/commands/status.mjs +94 -0
  39. package/package.json +43 -60
  40. package/plugin.yaml +16 -0
  41. package/scripts/uninstall.js +38 -0
  42. package/skills/asc/SKILL.md +16 -0
  43. package/skills/asc-audit/SKILL.md +28 -0
  44. package/skills/asc-refactor/SKILL.md +35 -0
  45. package/skills/asc-review/SKILL.md +54 -0
  46. package/.agent-context/policies/llm-judge-threshold.json +0 -29
  47. package/.agent-context/prompts/bootstrap-design.md +0 -63
  48. package/.agent-context/prompts/compact-natural-mode.md +0 -100
  49. package/.agent-context/prompts/init-project.md +0 -60
  50. package/.agent-context/prompts/refactor.md +0 -38
  51. package/.agent-context/prompts/review-code.md +0 -31
  52. package/.agent-context/review-checklists/architecture-review.md +0 -57
  53. package/.agent-context/review-checklists/pr-checklist.md +0 -134
  54. package/.agent-context/rules/api-docs.md +0 -24
  55. package/.agent-context/rules/api-versioning.md +0 -16
  56. package/.agent-context/rules/architecture.md +0 -38
  57. package/.agent-context/rules/background-jobs.md +0 -17
  58. package/.agent-context/rules/config-and-flags.md +0 -16
  59. package/.agent-context/rules/database-design.md +0 -18
  60. package/.agent-context/rules/docker-runtime.md +0 -17
  61. package/.agent-context/rules/error-handling.md +0 -16
  62. package/.agent-context/rules/event-driven.md +0 -16
  63. package/.agent-context/rules/frontend-architecture.md +0 -54
  64. package/.agent-context/rules/microservices.md +0 -16
  65. package/.agent-context/rules/migrations.md +0 -16
  66. package/.agent-context/rules/observability.md +0 -16
  67. package/.agent-context/rules/performance.md +0 -16
  68. package/.agent-context/rules/realtime.md +0 -16
  69. package/.agent-context/rules/resilience.md +0 -18
  70. package/.agent-context/rules/security.md +0 -18
  71. package/.agent-context/rules/testing.md +0 -16
  72. package/.agent-context/state/README.md +0 -25
  73. package/.agent-context/state/architecture-map.md +0 -40
  74. package/.agent-context/state/benchmark-comparison-schema.json +0 -181
  75. package/.agent-context/state/benchmark-reproducibility.json +0 -87
  76. package/.agent-context/state/benchmark-thresholds.json +0 -10
  77. package/.agent-context/state/benchmark-writer-judge-config.json +0 -58
  78. package/.agent-context/state/dependency-map.md +0 -41
  79. package/.agent-context/state/memory-adapter-contract.json +0 -52
  80. package/.agent-context/state/memory-schema-v1.json +0 -88
  81. package/GEMINI.md +0 -1
  82. package/benchmarks/README.md +0 -60
  83. package/benchmarks/compact-natural-mode/fixtures.mjs +0 -359
  84. package/benchmarks/compact-natural-mode/scorer.mjs +0 -331
  85. package/benchmarks/runtime-token-saver/fixtures.mjs +0 -836
  86. package/lib/cli/adaptive-context/catalog.mjs +0 -394
  87. package/lib/cli/adaptive-context/file-signals.mjs +0 -100
  88. package/lib/cli/adaptive-context/implications.mjs +0 -44
  89. package/lib/cli/adaptive-context.mjs +0 -151
  90. package/lib/cli/audits/typography-palette-anti-repeat/color-utils.mjs +0 -156
  91. package/lib/cli/audits/typography-palette-anti-repeat/file-scanner.mjs +0 -103
  92. package/lib/cli/audits/typography-palette-anti-repeat/typography-utils.mjs +0 -70
  93. package/lib/cli/backup.mjs +0 -210
  94. package/lib/cli/commands/context.mjs +0 -140
  95. package/lib/cli/commands/init/project-context.mjs +0 -60
  96. package/lib/cli/commands/init/runtime-environment.mjs +0 -59
  97. package/lib/cli/commands/init/setup-decisions.mjs +0 -83
  98. package/lib/cli/commands/init.mjs +0 -654
  99. package/lib/cli/commands/launch.mjs +0 -76
  100. package/lib/cli/commands/optimize.mjs +0 -284
  101. package/lib/cli/commands/rollback.mjs +0 -64
  102. package/lib/cli/commands/upgrade/token-optimization-state.mjs +0 -51
  103. package/lib/cli/commands/upgrade.mjs +0 -451
  104. package/lib/cli/compiler.mjs +0 -187
  105. package/lib/cli/constants.mjs +0 -136
  106. package/lib/cli/detector/constants.mjs +0 -135
  107. package/lib/cli/detector/design-evidence/collector.mjs +0 -256
  108. package/lib/cli/detector/design-evidence/constants.mjs +0 -39
  109. package/lib/cli/detector/design-evidence/file-traversal.mjs +0 -83
  110. package/lib/cli/detector/design-evidence/structured-attribute-evidence.mjs +0 -117
  111. package/lib/cli/detector/design-evidence/summary.mjs +0 -109
  112. package/lib/cli/detector/design-evidence/utility-helpers.mjs +0 -122
  113. package/lib/cli/detector/design-evidence.mjs +0 -25
  114. package/lib/cli/detector/stack-detection.mjs +0 -243
  115. package/lib/cli/detector/ui-signals.mjs +0 -150
  116. package/lib/cli/detector/workspace-scan.mjs +0 -177
  117. package/lib/cli/detector.mjs +0 -23
  118. package/lib/cli/init-detection-flow.mjs +0 -48
  119. package/lib/cli/init-options.mjs +0 -237
  120. package/lib/cli/init-selection.mjs +0 -29
  121. package/lib/cli/memory-continuity.mjs +0 -537
  122. package/lib/cli/preflight.mjs +0 -76
  123. package/lib/cli/project-scaffolder/constants.mjs +0 -69
  124. package/lib/cli/project-scaffolder/discovery.mjs +0 -272
  125. package/lib/cli/project-scaffolder/prompt-builders.mjs +0 -171
  126. package/lib/cli/project-scaffolder/storage.mjs +0 -144
  127. package/lib/cli/project-scaffolder/ui-scope-detection.mjs +0 -36
  128. package/lib/cli/project-scaffolder.mjs +0 -29
  129. package/lib/cli/rollback.mjs +0 -66
  130. package/lib/cli/token-optimization.mjs +0 -401
  131. package/lib/cli/utils/filesystem.mjs +0 -81
  132. package/lib/cli/utils/managed-surface.mjs +0 -280
  133. package/lib/cli/utils/prompting.mjs +0 -44
  134. package/lib/cli/utils.mjs +0 -479
  135. package/mcp.json +0 -134
  136. package/scripts/adaptive-context/fixtures.mjs +0 -183
  137. package/scripts/adaptive-context-benchmark.mjs +0 -9
  138. package/scripts/ascx-runtime-token-saver-benchmark.mjs +0 -9
  139. package/scripts/benchmark-evidence-bundle.mjs +0 -645
  140. package/scripts/benchmark-gate.mjs +0 -121
  141. package/scripts/benchmark-intelligence.mjs +0 -33
  142. package/scripts/benchmark-writer-judge-matrix.mjs +0 -379
  143. package/scripts/build-release-benchmark-bundle.mjs +0 -202
  144. package/scripts/bump-version.mjs +0 -103
  145. package/scripts/clean-local-artifacts.mjs +0 -78
  146. package/scripts/compact-natural-mode-benchmark.mjs +0 -9
  147. package/scripts/context-triggered-audit.mjs +0 -391
  148. package/scripts/detection-benchmark.mjs +0 -127
  149. package/scripts/docs-quality-drift-report.mjs +0 -358
  150. package/scripts/documentation-boundary-audit.mjs +0 -305
  151. package/scripts/explain-on-demand-audit.mjs +0 -427
  152. package/scripts/forbidden-content-check.mjs +0 -123
  153. package/scripts/frontend-usability-audit.mjs +0 -243
  154. package/scripts/generate-sbom.mjs +0 -61
  155. package/scripts/governance-weekly-report.mjs +0 -466
  156. package/scripts/llm-judge/checklist-loader.mjs +0 -45
  157. package/scripts/llm-judge/constants.mjs +0 -66
  158. package/scripts/llm-judge/diff-collection.mjs +0 -74
  159. package/scripts/llm-judge/prompting.mjs +0 -78
  160. package/scripts/llm-judge/providers.mjs +0 -111
  161. package/scripts/llm-judge/verdict.mjs +0 -134
  162. package/scripts/llm-judge.mjs +0 -200
  163. package/scripts/memory-continuity-benchmark.mjs +0 -322
  164. package/scripts/quality-trend-report.mjs +0 -289
  165. package/scripts/release-gate/audit-checks.mjs +0 -441
  166. package/scripts/release-gate/constants.mjs +0 -53
  167. package/scripts/release-gate/runtime.mjs +0 -63
  168. package/scripts/release-gate/static-checks.mjs +0 -182
  169. package/scripts/release-gate.mjs +0 -42
  170. package/scripts/rules-guardian-audit.mjs +0 -580
  171. package/scripts/single-source-lazy-loading-audit.mjs +0 -449
  172. package/scripts/sync-thin-adapters.mjs +0 -72
  173. package/scripts/token-optimization-benchmark.mjs +0 -252
  174. package/scripts/ui-design-judge/constants.mjs +0 -13
  175. package/scripts/ui-design-judge/design-execution-summary.mjs +0 -81
  176. package/scripts/ui-design-judge/git-input.mjs +0 -134
  177. package/scripts/ui-design-judge/prompting.mjs +0 -52
  178. package/scripts/ui-design-judge/providers.mjs +0 -102
  179. package/scripts/ui-design-judge/reporting.mjs +0 -183
  180. package/scripts/ui-design-judge/rubric-calibration.mjs +0 -214
  181. package/scripts/ui-design-judge/rubric-goldset.json +0 -188
  182. package/scripts/ui-design-judge.mjs +0 -319
  183. package/scripts/ui-rubric-calibration.mjs +0 -35
  184. package/scripts/validate/audits/cache-layer-contract.mjs +0 -230
  185. package/scripts/validate/audits/caching-scope-hygiene.mjs +0 -235
  186. package/scripts/validate/audits/file-size.mjs +0 -158
  187. package/scripts/validate/audits/reflection-citations.mjs +0 -130
  188. package/scripts/validate/audits/release-bundle.mjs +0 -135
  189. package/scripts/validate/audits/rule-id-uniqueness.mjs +0 -278
  190. package/scripts/validate/config.mjs +0 -501
  191. package/scripts/validate/coverage-checks.mjs +0 -446
  192. package/scripts/validate/file-structure.mjs +0 -158
  193. package/scripts/validate/markdown-content.mjs +0 -109
  194. package/scripts/validate/project-metadata.mjs +0 -166
  195. package/scripts/validate/utils.mjs +0 -52
  196. package/scripts/validate.mjs +0 -267
@@ -1,252 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * token-optimization-benchmark.mjs
5
- *
6
- * Measures token-estimate reduction between baseline commands and
7
- * native optimized command variants. If RTK is installed, it also
8
- * compares RTK command output in the same scenarios.
9
- */
10
-
11
- import { existsSync } from 'node:fs';
12
- import fs from 'node:fs/promises';
13
- import { spawnSync } from 'node:child_process';
14
- import { dirname, join, resolve } from 'node:path';
15
- import { fileURLToPath } from 'node:url';
16
-
17
- const SCRIPT_FILE_PATH = fileURLToPath(import.meta.url);
18
- const SCRIPT_DIR = dirname(SCRIPT_FILE_PATH);
19
- const REPOSITORY_ROOT = resolve(SCRIPT_DIR, '..');
20
- const REPORT_PATH = join(REPOSITORY_ROOT, '.agent-context', 'state', 'token-optimization-benchmark.json');
21
- const LOCAL_RTK_BINARY_PATH = join(REPOSITORY_ROOT, '.benchmarks', 'tools', 'rtk', 'rtk.exe');
22
- const TOKEN_ESTIMATE_DIVISOR = 4;
23
- const ARGUMENT_FLAGS = new Set(process.argv.slice(2));
24
- const isStdoutOnlyMode = ARGUMENT_FLAGS.has('--stdout-only');
25
-
26
- const BENCHMARK_SCENARIOS = [
27
- {
28
- scenarioId: 'git-show',
29
- scenarioName: 'Latest commit detail review',
30
- baselineCommand: { command: 'git', args: ['show', 'HEAD', '--stat', '--patch', '--no-color'] },
31
- nativeOptimizedCommand: { command: 'git', args: ['show', 'HEAD', '--stat', '--no-color'] },
32
- rtkCommand: { command: 'rtk', args: ['git', 'show', 'HEAD', '--stat', '--patch', '--no-color'] },
33
- },
34
- {
35
- scenarioId: 'git-log',
36
- scenarioName: 'Commit history review',
37
- baselineCommand: { command: 'git', args: ['log', '-n', '50'] },
38
- nativeOptimizedCommand: { command: 'git', args: ['log', '--oneline', '-n', '50'] },
39
- rtkCommand: { command: 'rtk', args: ['git', 'log', '-n', '50'] },
40
- },
41
- {
42
- scenarioId: 'search-token',
43
- scenarioName: 'Search result scan',
44
- baselineCommand: { command: 'git', args: ['grep', '-n', 'token'] },
45
- nativeOptimizedCommand: { command: 'git', args: ['grep', '-n', 'token', 'README.md', 'docs'] },
46
- rtkCommand: { command: 'rtk', args: ['git', 'grep', '-n', 'token'] },
47
- },
48
- ];
49
-
50
- function estimateTokenCount(outputText) {
51
- if (!outputText || outputText.length === 0) {
52
- return 0;
53
- }
54
-
55
- return Math.ceil(outputText.length / TOKEN_ESTIMATE_DIVISOR);
56
- }
57
-
58
- function formatCommandLine(commandDefinition) {
59
- return [commandDefinition.command, ...commandDefinition.args].join(' ');
60
- }
61
-
62
- function executeCommand(commandDefinition) {
63
- const commandResult = spawnSync(commandDefinition.command, commandDefinition.args, {
64
- cwd: REPOSITORY_ROOT,
65
- encoding: 'utf8',
66
- maxBuffer: 1024 * 1024 * 20,
67
- });
68
-
69
- const standardOutput = commandResult.stdout || '';
70
- const standardError = commandResult.stderr || '';
71
- const combinedOutput = `${standardOutput}${standardError}`;
72
- const normalizedOutput = combinedOutput.trimEnd();
73
-
74
- const outputLineCount = normalizedOutput.length === 0
75
- ? 0
76
- : normalizedOutput.split(/\r?\n/u).length;
77
-
78
- return {
79
- command: formatCommandLine(commandDefinition),
80
- exitCode: typeof commandResult.status === 'number' ? commandResult.status : 1,
81
- outputChars: normalizedOutput.length,
82
- outputLines: outputLineCount,
83
- estimatedTokens: estimateTokenCount(normalizedOutput),
84
- };
85
- }
86
-
87
- function resolveRtkBinaryPath() {
88
- const configuredRtkBinaryPath = process.env.RTK_BINARY_PATH;
89
-
90
- if (configuredRtkBinaryPath && existsSync(configuredRtkBinaryPath)) {
91
- return {
92
- executablePath: configuredRtkBinaryPath,
93
- source: 'env',
94
- };
95
- }
96
-
97
- if (existsSync(LOCAL_RTK_BINARY_PATH)) {
98
- return {
99
- executablePath: LOCAL_RTK_BINARY_PATH,
100
- source: 'local-tools',
101
- };
102
- }
103
-
104
- return {
105
- executablePath: 'rtk',
106
- source: 'system-path',
107
- };
108
- }
109
-
110
- function detectRtkAvailability() {
111
- const rtkBinary = resolveRtkBinaryPath();
112
-
113
- const versionResult = spawnSync(rtkBinary.executablePath, ['--version'], {
114
- cwd: REPOSITORY_ROOT,
115
- encoding: 'utf8',
116
- maxBuffer: 1024 * 1024,
117
- });
118
-
119
- if (versionResult.error || versionResult.status !== 0) {
120
- return {
121
- isAvailable: false,
122
- version: null,
123
- source: rtkBinary.source,
124
- executablePath: rtkBinary.executablePath,
125
- reason: versionResult.error
126
- ? versionResult.error.message
127
- : (versionResult.stderr || versionResult.stdout || 'RTK command unavailable').trim(),
128
- };
129
- }
130
-
131
- const versionMatch = (versionResult.stdout || '').match(/\d+\.\d+\.\d+/u);
132
- return {
133
- isAvailable: true,
134
- version: versionMatch ? versionMatch[0] : null,
135
- source: rtkBinary.source,
136
- executablePath: rtkBinary.executablePath,
137
- reason: null,
138
- };
139
- }
140
-
141
- function buildRtkCommand(commandDefinition, rtkAvailability) {
142
- return {
143
- command: rtkAvailability.executablePath || commandDefinition.command,
144
- args: commandDefinition.args,
145
- };
146
- }
147
-
148
- function computeSavingsSummary(baselineTokens, optimizedTokens) {
149
- if (baselineTokens <= 0) {
150
- return {
151
- tokenDelta: 0,
152
- savingsPercent: 0,
153
- };
154
- }
155
-
156
- const tokenDelta = baselineTokens - optimizedTokens;
157
- const savingsPercent = Number(((tokenDelta / baselineTokens) * 100).toFixed(2));
158
-
159
- return {
160
- tokenDelta,
161
- savingsPercent,
162
- };
163
- }
164
-
165
- function calculateAverageSavings(benchmarkRows, savingsKeyName) {
166
- const availableSavings = benchmarkRows
167
- .map((benchmarkRow) => benchmarkRow[savingsKeyName]?.savingsPercent)
168
- .filter((savingsPercent) => typeof savingsPercent === 'number');
169
-
170
- if (availableSavings.length === 0) {
171
- return null;
172
- }
173
-
174
- const totalSavings = availableSavings.reduce((runningTotal, savingsPercent) => runningTotal + savingsPercent, 0);
175
- return Number((totalSavings / availableSavings.length).toFixed(2));
176
- }
177
-
178
- async function runTokenOptimizationBenchmark() {
179
- const rtkAvailability = detectRtkAvailability();
180
- const scenarioResults = [];
181
-
182
- for (const benchmarkScenario of BENCHMARK_SCENARIOS) {
183
- const baselineRun = executeCommand(benchmarkScenario.baselineCommand);
184
- const nativeOptimizedRun = executeCommand(benchmarkScenario.nativeOptimizedCommand);
185
- const nativeSavings = computeSavingsSummary(
186
- baselineRun.estimatedTokens,
187
- nativeOptimizedRun.estimatedTokens
188
- );
189
-
190
- let rtkRun = null;
191
- let rtkSavings = null;
192
-
193
- if (rtkAvailability.isAvailable) {
194
- rtkRun = executeCommand(buildRtkCommand(benchmarkScenario.rtkCommand, rtkAvailability));
195
- if (rtkRun.exitCode === 0) {
196
- rtkSavings = computeSavingsSummary(baselineRun.estimatedTokens, rtkRun.estimatedTokens);
197
- }
198
- }
199
-
200
- scenarioResults.push({
201
- scenarioId: benchmarkScenario.scenarioId,
202
- scenarioName: benchmarkScenario.scenarioName,
203
- baseline: baselineRun,
204
- nativeOptimized: nativeOptimizedRun,
205
- nativeSavings,
206
- rtk: rtkRun,
207
- rtkSavings,
208
- });
209
- }
210
-
211
- const benchmarkReport = {
212
- generatedAt: new Date().toISOString(),
213
- reportName: 'token-optimization-benchmark',
214
- methodology: {
215
- tokenEstimate: `estimated_tokens = ceil(output_chars / ${TOKEN_ESTIMATE_DIVISOR})`,
216
- scope: 'command-output estimate only; model-specific tokenization differs by provider',
217
- repositoryRoot: REPOSITORY_ROOT,
218
- },
219
- environment: {
220
- nodeVersion: process.version,
221
- platform: process.platform,
222
- rtk: rtkAvailability,
223
- },
224
- scenarios: scenarioResults,
225
- summary: {
226
- scenarioCount: scenarioResults.length,
227
- averageNativeSavingsPercent: calculateAverageSavings(scenarioResults, 'nativeSavings'),
228
- averageRtkSavingsPercent: calculateAverageSavings(scenarioResults, 'rtkSavings'),
229
- },
230
- artifact: {
231
- path: REPORT_PATH,
232
- writeMode: isStdoutOnlyMode ? 'stdout-only' : 'stdout-and-file',
233
- },
234
- };
235
-
236
- if (!isStdoutOnlyMode) {
237
- await fs.mkdir(dirname(REPORT_PATH), { recursive: true });
238
- await fs.writeFile(REPORT_PATH, JSON.stringify(benchmarkReport, null, 2) + '\n', 'utf8');
239
- }
240
-
241
- return benchmarkReport;
242
- }
243
-
244
- runTokenOptimizationBenchmark()
245
- .then((benchmarkReport) => {
246
- console.log(JSON.stringify(benchmarkReport, null, 2));
247
- })
248
- .catch((benchmarkError) => {
249
- const errorMessage = benchmarkError instanceof Error ? benchmarkError.message : String(benchmarkError);
250
- console.error(`Token benchmark failed: ${errorMessage}`);
251
- process.exit(1);
252
- });
@@ -1,13 +0,0 @@
1
- // @ts-check
2
-
3
- import { resolve, dirname } from 'node:path';
4
- import { fileURLToPath } from 'node:url';
5
-
6
- const __filename = fileURLToPath(import.meta.url);
7
- const __dirname = dirname(__filename);
8
-
9
- export const REPOSITORY_ROOT = resolve(__dirname, '..', '..');
10
- export const DESIGN_GUIDE_PATH = resolve(REPOSITORY_ROOT, 'docs', 'DESIGN.md');
11
- export const MAX_DIFF_CHARS = 12000;
12
- export const UI_FILE_EXTENSIONS = new Set(['.js', '.jsx', '.ts', '.tsx', '.vue', '.css', '.scss', '.sass']);
13
-
@@ -1,81 +0,0 @@
1
- // @ts-check
2
-
3
- import { existsSync, readFileSync } from 'node:fs';
4
- import {
5
- DESIGN_GUIDE_PATH,
6
- } from './constants.mjs';
7
-
8
- /**
9
- * Legacy design-intent.json is no longer generated.
10
- * Returns null unconditionally.
11
- */
12
- export function loadDesignIntent() {
13
- return null;
14
- }
15
-
16
- export function loadDesignGuide() {
17
- if (!existsSync(DESIGN_GUIDE_PATH)) {
18
- return '';
19
- }
20
-
21
- return readFileSync(DESIGN_GUIDE_PATH, 'utf8');
22
- }
23
-
24
- export function normalizeStringArray(rawValue) {
25
- if (!Array.isArray(rawValue)) {
26
- return [];
27
- }
28
-
29
- return rawValue
30
- .map((entryValue) => String(entryValue || '').trim())
31
- .filter(Boolean);
32
- }
33
-
34
- /**
35
- * Simplified design execution policy summary.
36
- * With the design-intent.json contract removed, this returns
37
- * a minimal stub that downstream consumers (main judge, reporting)
38
- * can safely consume without null checks.
39
- */
40
- export function summarizeDesignExecutionPolicy(designIntentContent) {
41
- return {
42
- policyPresent: false,
43
- representationStrategy: null,
44
- contractReady: false,
45
- screenshotDependencyForbidden: false,
46
- repoEvidenceAvailable: false,
47
- structuredInspectionAvailable: false,
48
- handoffPresent: false,
49
- handoffVersion: null,
50
- handoffReady: false,
51
- handoffArtifactCount: 0,
52
- presentHandoffArtifacts: [],
53
- missingHandoffArtifacts: [],
54
- repoEvidenceSummaryVersion: null,
55
- requiredCapabilities: [],
56
- enabledCapabilities: [],
57
- missingCapabilities: [],
58
- semanticReviewFocus: [],
59
- notes: ['Design execution policy is not applicable under the compact token file architecture.'],
60
- };
61
- }
62
-
63
- /**
64
- * Simplified review rubric summary.
65
- * Returns a minimal stub since the JSON contract rubric system was removed.
66
- */
67
- export function summarizeReviewRubric(designIntentContent) {
68
- return {
69
- version: null,
70
- dimensions: [],
71
- genericityAutoFail: false,
72
- genericitySignals: [],
73
- validBoldSignals: [],
74
- forbiddenPatterns: [],
75
- reportingRules: {
76
- mustExplainGenericity: false,
77
- mustSeparateTasteFromFailure: false,
78
- contractFidelityOverridesPersonalTaste: false,
79
- },
80
- };
81
- }
@@ -1,134 +0,0 @@
1
- // @ts-check
2
-
3
- import { execSync } from 'node:child_process';
4
- import { extname } from 'node:path';
5
- import { REPOSITORY_ROOT, UI_FILE_EXTENSIONS } from './constants.mjs';
6
-
7
- export function detectCiProvider() {
8
- if (process.env.GITHUB_ACTIONS === 'true') {
9
- return 'github';
10
- }
11
-
12
- if (process.env.GITLAB_CI === 'true') {
13
- return 'gitlab';
14
- }
15
-
16
- return 'local';
17
- }
18
-
19
- function collectGitDiff(baseSha, headSha) {
20
- const execOptions = {
21
- cwd: REPOSITORY_ROOT,
22
- encoding: /** @type {'utf-8'} */ ('utf-8'),
23
- maxBuffer: 1024 * 1024 * 8,
24
- };
25
-
26
- return execSync(`git diff "${baseSha}...${headSha}"`, execOptions);
27
- }
28
-
29
- function collectGitChangedFiles(baseSha, headSha) {
30
- const execOptions = {
31
- cwd: REPOSITORY_ROOT,
32
- encoding: /** @type {'utf-8'} */ ('utf-8'),
33
- maxBuffer: 1024 * 1024 * 2,
34
- };
35
-
36
- const output = execSync(`git diff --name-only "${baseSha}...${headSha}"`, execOptions);
37
- return output
38
- .split(/\r?\n/u)
39
- .map((filePath) => filePath.trim())
40
- .filter(Boolean);
41
- }
42
-
43
- export function collectPullRequestDiff() {
44
- if (process.env.PR_DIFF) {
45
- return process.env.PR_DIFF;
46
- }
47
-
48
- const githubBaseSha = process.env.GITHUB_BASE_SHA;
49
- const githubHeadSha = process.env.GITHUB_HEAD_SHA ?? 'HEAD';
50
- if (githubBaseSha) {
51
- return collectGitDiff(githubBaseSha, githubHeadSha);
52
- }
53
-
54
- const gitlabBaseSha = process.env.CI_MERGE_REQUEST_DIFF_BASE_SHA;
55
- const gitlabHeadSha = process.env.CI_COMMIT_SHA ?? 'HEAD';
56
- if (gitlabBaseSha) {
57
- return collectGitDiff(gitlabBaseSha, gitlabHeadSha);
58
- }
59
-
60
- try {
61
- return execSync('git diff HEAD~1 HEAD', {
62
- cwd: REPOSITORY_ROOT,
63
- encoding: /** @type {'utf-8'} */ ('utf-8'),
64
- maxBuffer: 1024 * 1024 * 8,
65
- stdio: ['ignore', 'pipe', 'ignore'],
66
- });
67
- } catch {
68
- try {
69
- const emptyTreeSha = '4b825dc642cb6eb9a060e54bf8d69288fbee4904';
70
- return execSync(`git diff "${emptyTreeSha}" HEAD`, {
71
- cwd: REPOSITORY_ROOT,
72
- encoding: /** @type {'utf-8'} */ ('utf-8'),
73
- maxBuffer: 1024 * 1024 * 8,
74
- stdio: ['ignore', 'pipe', 'ignore'],
75
- });
76
- } catch {
77
- return '';
78
- }
79
- }
80
- }
81
-
82
- export function collectChangedFiles() {
83
- if (process.env.PR_DIFF) {
84
- const filePathSet = new Set();
85
- for (const diffHeaderMatch of process.env.PR_DIFF.matchAll(/^diff --git a\/(.+?) b\/(.+)$/gm)) {
86
- filePathSet.add(diffHeaderMatch[2]);
87
- }
88
- return Array.from(filePathSet);
89
- }
90
-
91
- const githubBaseSha = process.env.GITHUB_BASE_SHA;
92
- const githubHeadSha = process.env.GITHUB_HEAD_SHA ?? 'HEAD';
93
- if (githubBaseSha) {
94
- return collectGitChangedFiles(githubBaseSha, githubHeadSha);
95
- }
96
-
97
- const gitlabBaseSha = process.env.CI_MERGE_REQUEST_DIFF_BASE_SHA;
98
- const gitlabHeadSha = process.env.CI_COMMIT_SHA ?? 'HEAD';
99
- if (gitlabBaseSha) {
100
- return collectGitChangedFiles(gitlabBaseSha, gitlabHeadSha);
101
- }
102
-
103
- try {
104
- const output = execSync('git diff --name-only HEAD~1 HEAD', {
105
- cwd: REPOSITORY_ROOT,
106
- encoding: /** @type {'utf-8'} */ ('utf-8'),
107
- maxBuffer: 1024 * 1024 * 2,
108
- stdio: ['ignore', 'pipe', 'ignore'],
109
- });
110
- return output.split(/\r?\n/u).map((filePath) => filePath.trim()).filter(Boolean);
111
- } catch {
112
- return [];
113
- }
114
- }
115
-
116
- export function isUiRelevantFilePath(filePath) {
117
- const normalizedFilePath = String(filePath || '').replace(/\\/g, '/').toLowerCase();
118
- const fileExtension = extname(normalizedFilePath);
119
-
120
- if (!UI_FILE_EXTENSIONS.has(fileExtension)) {
121
- return false;
122
- }
123
-
124
- return (
125
- normalizedFilePath.startsWith('src/')
126
- || normalizedFilePath.startsWith('app/')
127
- || normalizedFilePath.startsWith('pages/')
128
- || normalizedFilePath.startsWith('components/')
129
- || normalizedFilePath.startsWith('styles/')
130
- || normalizedFilePath.includes('/components/')
131
- || normalizedFilePath.includes('/screens/')
132
- || normalizedFilePath.includes('/layouts/')
133
- );
134
- }
@@ -1,52 +0,0 @@
1
- // @ts-check
2
-
3
- import { MAX_DIFF_CHARS } from './constants.mjs';
4
-
5
- export function buildSystemPrompt() {
6
- return [
7
- 'You are a Principal UI/UX Design Reviewer.',
8
- 'Compare the changed UI code against the provided design contract.',
9
- 'Treat docs/DESIGN.md as the design contract source of truth.',
10
- 'Use repoEvidence.designEvidenceSummary as implementation evidence when deciding whether the diff follows the intended system.',
11
- 'Do not reward generic SaaS defaults or popular template patterns.',
12
- 'Do not penalize originality when the implementation still aligns with the contract.',
13
- 'Treat purposeful motion as a first-class quality signal for modern UI work. Flag missing or timid motion when the contract calls for expressive interaction, and only flag motion itself when it drifts from the contract, ignores reduced-motion expectations, or adds avoidable performance/accessibility risk.',
14
- 'Only flag drift when there is a clear mismatch with the contract, accessibility non-negotiables, or cross-viewport adaptation rules.',
15
- 'Treat WCAG 2.2 AA failures as hard accessibility drift.',
16
- 'Treat APCA as advisory perceptual tuning only. Do not set blocking solely because APCA indicates a stronger readability adjustment when WCAG hard requirements still pass.',
17
- 'Check focus visibility, focus appearance, target size, keyboard access, accessible authentication, and status or dynamic state access when the diff touches those surfaces.',
18
- 'Check the optional reviewRubric.genericityAutoFail flag when structured context is present. If true and forbiddenPatterns or genericitySignals are detected in the changed UI, this audit is no longer merely advisory for that finding: set blockingRecommended to true, mark the relevant rubric dimension as blocking, and require rebuilding the drifted surface instead of polishing it.',
19
- 'Focus on color intent, typographic hierarchy, responsive re-layout, purposeful motion, component morphology across states, interaction behavior, and genericity drift.',
20
- 'If you call something generic, explain the specific genericity signal or anti-pattern that caused that judgment.',
21
- 'Separate taste from failure. A bold design that follows the contract must not be penalized only because it is unusual.',
22
- 'Return ONLY one JSON object on a single line prefixed with JSON_VERDICT:.',
23
- 'Schema:',
24
- '{"alignmentScore": number|null, "genericityAssessment": {"status": "distinctive|mixed|generic|unclear", "reason": string}, "tasteVsFailureSeparated": boolean, "rubricBreakdown": [{"dimension": string, "score": number|null, "verdict": "strong|acceptable|weak|unclear", "reason": string, "blocking": boolean}], "notes": string[], "findings": [{"area": string, "severity": "high|medium|low", "problem": string, "evidence": string, "requiredAction": string, "blockingRecommended": boolean}]}',
25
- ].join('\n');
26
- }
27
-
28
- export function buildUserMessage(designIntentContent, designGuideContent, diffContent, changedUiFiles, designExecutionSummary) {
29
- const truncatedDiff = diffContent.length > MAX_DIFF_CHARS
30
- ? `${diffContent.slice(0, MAX_DIFF_CHARS)}\n\n[DIFF TRUNCATED - ${diffContent.length - MAX_DIFF_CHARS} additional characters omitted]`
31
- : diffContent;
32
-
33
- return [
34
- '## Changed UI Files',
35
- changedUiFiles.length > 0 ? changedUiFiles.map((filePath) => `- ${filePath}`).join('\n') : '- none',
36
- '',
37
- '## Design Contract',
38
- '',
39
- '## DESIGN.md',
40
- '```md',
41
- designGuideContent.trim() || '(missing DESIGN.md)',
42
- '```',
43
-
44
- '',
45
- '## UI Diff',
46
- '```diff',
47
- truncatedDiff.trim() || '(no UI diff)',
48
- '```',
49
- '',
50
- 'Judge alignment to the contract. Avoid aesthetic bias toward generic web trends or toward motionless/static outputs.',
51
- ].join('\n');
52
- }
@@ -1,102 +0,0 @@
1
- // @ts-check
2
-
3
- async function callOpenAiProvider(systemPrompt, userMessage) {
4
- const selectedModel = process.env.LLM_JUDGE_MODEL ?? 'gpt-4o-mini';
5
- const apiResponse = await fetch('https://api.openai.com/v1/chat/completions', {
6
- method: 'POST',
7
- headers: {
8
- 'Content-Type': 'application/json',
9
- Authorization: `Bearer ${process.env.OPENAI_API_KEY}`,
10
- },
11
- body: JSON.stringify({
12
- model: selectedModel,
13
- max_tokens: 2048,
14
- temperature: 0,
15
- messages: [
16
- { role: 'system', content: systemPrompt },
17
- { role: 'user', content: userMessage },
18
- ],
19
- }),
20
- });
21
-
22
- if (!apiResponse.ok) {
23
- const errorBody = await apiResponse.text();
24
- throw new Error(`OpenAI API returned ${apiResponse.status}: ${errorBody}`);
25
- }
26
-
27
- const responsePayload = await apiResponse.json();
28
- return responsePayload.choices[0].message.content;
29
- }
30
-
31
- async function callAnthropicProvider(systemPrompt, userMessage) {
32
- const selectedModel = process.env.LLM_JUDGE_MODEL ?? 'claude-3-5-haiku-latest';
33
- const apiResponse = await fetch('https://api.anthropic.com/v1/messages', {
34
- method: 'POST',
35
- headers: {
36
- 'Content-Type': 'application/json',
37
- 'x-api-key': process.env.ANTHROPIC_API_KEY ?? '',
38
- 'anthropic-version': '2023-06-01',
39
- },
40
- body: JSON.stringify({
41
- model: selectedModel,
42
- max_tokens: 2048,
43
- system: systemPrompt,
44
- messages: [{ role: 'user', content: userMessage }],
45
- }),
46
- });
47
-
48
- if (!apiResponse.ok) {
49
- const errorBody = await apiResponse.text();
50
- throw new Error(`Anthropic API returned ${apiResponse.status}: ${errorBody}`);
51
- }
52
-
53
- const responsePayload = await apiResponse.json();
54
- return responsePayload.content[0].text;
55
- }
56
-
57
- async function callGeminiProvider(systemPrompt, userMessage) {
58
- const selectedModel = process.env.LLM_JUDGE_MODEL ?? 'gemini-2.0-flash';
59
- const apiKey = process.env.GEMINI_API_KEY ?? '';
60
- const endpointUrl = `https://generativelanguage.googleapis.com/v1beta/models/${selectedModel}:generateContent?key=${apiKey}`;
61
-
62
- const apiResponse = await fetch(endpointUrl, {
63
- method: 'POST',
64
- headers: { 'Content-Type': 'application/json' },
65
- body: JSON.stringify({
66
- system_instruction: { parts: [{ text: systemPrompt }] },
67
- contents: [{ role: 'user', parts: [{ text: userMessage }] }],
68
- generationConfig: { temperature: 0, maxOutputTokens: 2048 },
69
- }),
70
- });
71
-
72
- if (!apiResponse.ok) {
73
- const errorBody = await apiResponse.text();
74
- throw new Error(`Gemini API returned ${apiResponse.status}: ${errorBody}`);
75
- }
76
-
77
- const responsePayload = await apiResponse.json();
78
- return responsePayload.candidates[0].content.parts[0].text;
79
- }
80
-
81
- export function selectAvailableProvider() {
82
- if (process.env.UI_DESIGN_JUDGE_MOCK_RESPONSE) {
83
- return {
84
- providerName: 'mock',
85
- invokeProvider: async () => process.env.UI_DESIGN_JUDGE_MOCK_RESPONSE,
86
- };
87
- }
88
-
89
- if (process.env.OPENAI_API_KEY) {
90
- return { providerName: 'openai', invokeProvider: callOpenAiProvider };
91
- }
92
-
93
- if (process.env.ANTHROPIC_API_KEY) {
94
- return { providerName: 'anthropic', invokeProvider: callAnthropicProvider };
95
- }
96
-
97
- if (process.env.GEMINI_API_KEY) {
98
- return { providerName: 'gemini', invokeProvider: callGeminiProvider };
99
- }
100
-
101
- return null;
102
- }