@ryuenn3123/agentic-senior-core 3.0.15 → 3.0.17

package/lib/cli/utils.mjs

@@ -28,7 +28,7 @@ export function printUsage() {
   console.log('');
   console.log('Usage:');
   console.log('  agentic-senior-core launch');
-  console.log('  agentic-senior-core init [target-directory] [--preset <name>] [--profile <beginner|balanced|strict>] [--profile-pack <name>] [--stack <name>] [--blueprint <name>] [--project-description <text>] [--architect-token-budget <number>] [--architect-timeout-ms <number>] [--architect-research-mode <snapshot|realtime>] [--enable-realtime-research] [--architect-realtime-signal-file <path>] [--ci <true|false>] [--newbie] [--token-optimize] [--no-token-optimize] [--token-agent <name>] [--memory-continuity] [--no-memory-continuity] [--scaffold-docs] [--no-scaffold-docs] [--docs-lang <en|id>] [--project-config <path>] [--runtime-env <auto|linux-wsl|linux|windows|macos>]');
+  console.log('  agentic-senior-core init [target-directory] [--preset <name>] [--stack <name>] [--blueprint <name>] [--project-description <text>] [--ci <true|false>] [--token-optimize] [--no-token-optimize] [--token-agent <name>] [--memory-continuity] [--no-memory-continuity] [--scaffold-docs] [--no-scaffold-docs] [--docs-lang <en|id>] [--project-config <path>] [--runtime-env <auto|linux-wsl|linux|windows|macos>]');
   console.log('  agentic-senior-core upgrade [target-directory] [--dry-run] [--yes] [--mcp-template] [--no-mcp-template] [--prune] [--no-prune]');
   console.log('  agentic-senior-core optimize [target-directory] [--agent <copilot|claude|cursor|windsurf|gemini|codex|cline>] [--enable|--disable] [--show]');
   console.log('  agentic-senior-core mcp');
@@ -38,19 +38,10 @@ export function printUsage() {
   console.log('Options:');
   console.log('  --help       Show help');
   console.log('  --version    Show CLI version');
-  console.log('  --profile    Legacy override for beginner, balanced, or strict (default init path is Golden Standard)');
   console.log(`  --preset     Use a plug-and-play starter preset (${presetNames})`);
-  console.log('  --profile-pack  Apply a team profile pack (startup, regulated, platform)');
-  console.log('  --newbie     Legacy alias for --profile beginner');
   console.log('  --stack      Override stack selection');
   console.log('  --blueprint  Override blueprint selection');
-  console.log('  --project-description  Architecture intent text used for stack/blueprint recommendation');
-  console.log('  --architect-token-budget  Max token estimate used by recommendation research (default: 900)');
-  console.log('  --architect-timeout-ms  Max recommendation research time in milliseconds (default: 1500)');
-  console.log('  --architect-research-mode  Recommendation evidence mode (snapshot or realtime; default: realtime in init)');
-  console.log('  --enable-realtime-research  Allow trusted realtime evidence ingestion (enabled by default in init)');
-  console.log('  --disable-realtime-research  Force deterministic snapshot-only baseline in init');
-  console.log('  --architect-realtime-signal-file  Optional JSON payload path for trusted realtime stack/design signals');
+  console.log('  --project-description  Project intent text used to build an offline architecture brief before agent-led live research');
   console.log('  --ci         Override CI/CD quality checks (guardrails) (true|false)');
   console.log('  --token-optimize  Explicitly enable token optimization policy during init (default behavior)');
   console.log('  --token-agent     Set token optimization agent target (copilot, claude, cursor, windsurf, gemini, codex, cline)');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryuenn3123/agentic-senior-core",
-  "version": "3.0.15",
+  "version": "3.0.17",
   "type": "module",
   "description": "Force your AI Agent to code like a Staff Engineer, not a Junior.",
   "bin": {

package/scripts/documentation-boundary-audit.mjs

@@ -53,7 +53,10 @@ const BOUNDARY_RULES = [
     ],
     trigger(filePath) {
       return !isDocumentationFilePath(filePath)
-        && /(api|openapi|contract|controller|route|endpoint)/i.test(filePath);
+        && (
+          /(api|openapi|controller|route|endpoint)/i.test(filePath)
+          || /api[-_/]?contract/i.test(filePath)
+        );
     },
     docsMatcher(filePath) {
       return filePath === '.agent-context/rules/api-docs.md'
@@ -285,4 +288,4 @@ function runDocumentationBoundaryAudit() {
   process.exit(reportPayload.passed ? 0 : 1);
 }
 
-runDocumentationBoundaryAudit();
+runDocumentationBoundaryAudit();

package/scripts/frontend-usability-audit.mjs

@@ -26,6 +26,7 @@ const REQUIRED_FILES = [
   '.agent-context/rules/frontend-architecture.md',
   '.agent-context/review-checklists/pr-checklist.md',
   '.agent-context/review-checklists/architecture-review.md',
+  'lib/cli/detector/design-evidence.mjs',
 ];
 
 const REQUIRED_ROADMAP_SNIPPETS = [
@@ -53,6 +54,14 @@ const REQUIRED_FRONTEND_RULE_SNIPPETS = [
   'UI scope trigger signals',
   'visual intent, interaction quality, and conversion clarity',
   'template-only repetitive outputs',
+  'Context Hygiene and Reference Boundaries (Mandatory)',
+  'Accessibility Split (Mandatory)',
+  'Design continuity is opt-in.',
+  'repo evidence wins',
+  'WCAG 2.2 AA as the hard compliance floor',
+  'APCA as an advisory readability model',
+  'Hybrid Visual QA Boundaries (Mandatory)',
+  'Visual QA must be deterministic-first.',
   'UI Consistency Guardrails (Mandatory)',
   'Content language must stay consistent per screen and flow unless user requests multilingual output.',
   'Text color must remain contrast-safe against its background; no color collisions.',
@@ -62,10 +71,19 @@ const REQUIRED_FRONTEND_RULE_SNIPPETS = [
 const REQUIRED_BOOTSTRAP_DESIGN_SNIPPETS = [
   'UI Design Mode is context-isolated by default:',
   'Responsive Strategy and Cross-Viewport Adaptation Matrix',
+  'Token Architecture and Alias Strategy',
+  'tokenSystem',
   'colorTruth.format',
   'crossViewportAdaptation.mutationRules.mobile/tablet/desktop',
   'motionSystem',
   'componentMorphology',
+  'accessibilityPolicy',
+  'visualQaPolicy',
+  'contextHygiene',
+  'Design continuity is opt-in.',
+  'WCAG 2.2 AA as the blocking baseline',
+  'APCA only as advisory perceptual tuning',
+  'Hybrid visual QA must stay deterministic-first',
 ];
 
 const REQUIRED_UI_DESIGN_JUDGE_SNIPPETS = [
@@ -74,6 +92,9 @@ const REQUIRED_UI_DESIGN_JUDGE_SNIPPETS = [
   'Runs only in advisory mode for this repository workflow.',
   'Do not reward generic SaaS defaults or popular template patterns.',
   'UI design judge only evaluates changed UI surfaces.',
+  'Deterministic visual diff reported no meaningful drift, so semantic review was skipped.',
+  'UI_VISUAL_DIFF_REPORT_JSON',
+  'meaningfulDiffViewportCount',
 ];
 
 const REQUIRED_INSTRUCTIONS_SNIPPETS = [
@@ -81,6 +102,24 @@ const REQUIRED_INSTRUCTIONS_SNIPPETS = [
   'bootstrap-design.md',
   'frontend-architecture.md',
   'do not eagerly load unrelated backend-only rules',
+  'valid style context',
+  'explicitly approved reference systems',
+  'WCAG 2.2 AA as the hard compliance floor',
+  'APCA as advisory perceptual tuning only',
+  'deterministic screenshot or diff evidence as the first layer',
+];
+
+const REQUIRED_DESIGN_EVIDENCE_SNIPPETS = [
+  'summaryVersion',
+  "source: 'lightweight-static-scan'",
+  'cssVariables',
+  'componentInventory',
+  'tokenBypassSignals',
+];
+
+const REQUIRED_COMPILER_UI_EVIDENCE_SNIPPETS = [
+  'frontendEvidenceMetrics',
+  'designEvidenceSummary',
 ];
 
 function assertFileExists(relativeFilePath, failures) {
@@ -111,6 +150,8 @@ function runAudit() {
   const instructionsPath = '.instructions.md';
   const prChecklistPath = '.agent-context/review-checklists/pr-checklist.md';
   const architectureChecklistPath = '.agent-context/review-checklists/architecture-review.md';
+  const designEvidenceExtractorPath = 'lib/cli/detector/design-evidence.mjs';
+  const compilerPath = 'lib/cli/compiler.mjs';
 
   if (existsSync(resolve(REPOSITORY_ROOT, roadmapPath))) {
     const roadmapContent = readFileSync(resolve(REPOSITORY_ROOT, roadmapPath), 'utf8');
@@ -165,12 +206,47 @@ function runAudit() {
     );
   }
 
+  let designEvidenceExtractorContent = '';
+  let compilerContent = '';
+
+  if (existsSync(resolve(REPOSITORY_ROOT, designEvidenceExtractorPath))) {
+    designEvidenceExtractorContent = readFileSync(resolve(REPOSITORY_ROOT, designEvidenceExtractorPath), 'utf8');
+    assertContains(
+      'Design evidence extractor',
+      designEvidenceExtractorPath,
+      designEvidenceExtractorContent,
+      REQUIRED_DESIGN_EVIDENCE_SNIPPETS,
+      failures
+    );
+  }
+
+  if (existsSync(resolve(REPOSITORY_ROOT, compilerPath))) {
+    compilerContent = readFileSync(resolve(REPOSITORY_ROOT, compilerPath), 'utf8');
+    assertContains(
+      'Compiler UI evidence projection',
+      compilerPath,
+      compilerContent,
+      REQUIRED_COMPILER_UI_EVIDENCE_SNIPPETS,
+      failures
+    );
+  }
+
   const reportPayload = {
     generatedAt: new Date().toISOString(),
     auditName: 'frontend-usability-audit',
     passed: failures.length === 0,
     failureCount: failures.length,
     failures,
+    phase2DesignEvidenceCoverage: {
+      extractorFilePath: designEvidenceExtractorPath,
+      compilerFilePath: compilerPath,
+      extractorIncludesSummaryVersion: designEvidenceExtractorContent.includes('summaryVersion'),
+      extractorIncludesCssVariables: designEvidenceExtractorContent.includes('cssVariables'),
+      extractorIncludesComponentInventory: designEvidenceExtractorContent.includes('componentInventory'),
+      extractorIncludesTokenBypassSignals: designEvidenceExtractorContent.includes('tokenBypassSignals'),
+      compilerProjectsFrontendEvidenceMetrics: compilerContent.includes('frontendEvidenceMetrics'),
+      compilerProjectsDesignEvidenceSummary: compilerContent.includes('designEvidenceSummary'),
+    },
   };
 
   console.log(JSON.stringify(reportPayload, null, 2));

package/scripts/release-gate.mjs

@@ -747,6 +747,28 @@ function runReleaseGate() {
         'UI design judge unexpectedly ran in blocking mode during release gate'
       );
     }
+
+    const hasHybridVisualQaDiagnostics = typeof uiDesignJudgeExecution.report?.summary?.meaningfulDiffViewportCount === 'number'
+      && typeof uiDesignJudgeExecution.report?.deterministicVisual?.reportPresent === 'boolean'
+      && Array.isArray(uiDesignJudgeExecution.report?.deterministicVisual?.requiredViewports)
+      && typeof uiDesignJudgeExecution.report?.semanticJudge?.attempted === 'boolean'
+      && typeof uiDesignJudgeExecution.report?.semanticJudge?.skipped === 'boolean';
+
+    if (hasHybridVisualQaDiagnostics) {
+      pushResult(
+        results,
+        true,
+        'ui-design-judge-hybrid-diagnostics',
+        'UI design judge reports deterministic visual QA summary and semantic-review state together'
+      );
+    } else {
+      pushResult(
+        results,
+        false,
+        'ui-design-judge-hybrid-diagnostics',
+        'UI design judge is missing deterministic visual QA or semantic-review machine-readable fields'
+      );
+    }
   }
 
   const benchmarkGateExecution = runMachineReadableScript(BENCHMARK_GATE_SCRIPT_PATH);

package/scripts/sync-thin-adapters.mjs

@@ -36,6 +36,18 @@ Canonical Snapshot SHA256: ${canonicalHash}
 This file is an adapter entrypoint for agent discovery.
 The canonical policy source is [.instructions.md](.instructions.md).
 
+If your host stops at this file instead of following the full chain, obey the Critical Bootstrap Floor below before coding.
+
+## Critical Bootstrap Floor
+
+- If \`.agent-instructions.md\` exists, prefer it immediately after this file because it is the compiled project-specific snapshot.
+- Memory continuity does not replace bootstrap loading. It is host-dependent project memory, not a guarantee that instructions were reloaded for this session.
+- For UI, UX, layout, screen, tailwind, frontend, or redesign requests: load [.agent-context/prompts/bootstrap-design.md](.agent-context/prompts/bootstrap-design.md) and [.agent-context/rules/frontend-architecture.md](.agent-context/rules/frontend-architecture.md) before editing code.
+- For UI scope: if \`docs/DESIGN.md\` or \`docs/design-intent.json\` is missing, materialize or refine them before implementing UI changes.
+- For refactor, improve, clean up, or fix requests: inspect the active rules and propose a plan before editing.
+- For new project or module requests: propose architecture before generating code.
+- For ecosystem, framework, dependency, or Docker claims: perform live web research instead of relying on stale local heuristics.
+
 ## Mandatory Bootstrap Chain
 
 1. Load [.instructions.md](.instructions.md) first as the canonical baseline.
@@ -66,6 +78,12 @@ Canonical Snapshot SHA256: ${canonicalHash}
 
 The canonical policy source for this repository is [.instructions.md](../.instructions.md).
 
+If your host stops at this file, follow this minimum floor:
+- Read \`.agent-instructions.md\` next when it exists.
+- For UI or redesign requests, load [.agent-context/prompts/bootstrap-design.md](../.agent-context/prompts/bootstrap-design.md) and [.agent-context/rules/frontend-architecture.md](../.agent-context/rules/frontend-architecture.md) before coding.
+- If UI scope and \`docs/DESIGN.md\` or \`docs/design-intent.json\` is missing, materialize them before UI implementation.
+- Memory continuity is host-dependent project memory and does not replace bootstrap loading.
+
 ## Required Load Order
 
 1. Read [.instructions.md](../.instructions.md) first as the canonical baseline.
@@ -91,6 +109,12 @@ Canonical Snapshot SHA256: ${canonicalHash}
 
 Canonical policy source: [.instructions.md](../.instructions.md).
 
+If your host stops at this file, follow this minimum floor:
+- Read \`.agent-instructions.md\` next when it exists.
+- For UI or redesign requests, load [.agent-context/prompts/bootstrap-design.md](../.agent-context/prompts/bootstrap-design.md) and [.agent-context/rules/frontend-architecture.md](../.agent-context/rules/frontend-architecture.md) before coding.
+- If UI scope and \`docs/DESIGN.md\` or \`docs/design-intent.json\` is missing, materialize them before UI implementation.
+- Memory continuity is host-dependent project memory and does not replace bootstrap loading.
+
 ## Bootstrap Sequence
 
 1. Load [.instructions.md](../.instructions.md) first as the canonical baseline.