@ryuenn3123/agentic-senior-core 3.0.19 → 3.0.20

package/scripts/documentation-boundary-audit.mjs

@@ -29,7 +29,7 @@ const BOUNDARY_RULES = [
   {
     boundaryName: 'public-surface',
     requirement: 'Public surface changes must update README.md, CHANGELOG.md, or docs/* in the same scope.',
-    suggestedDocumentationUpdates: [
+    requiredDocumentationUpdates: [
       'README.md',
       'CHANGELOG.md',
       'docs/architecture-decision-record.md',
@@ -45,7 +45,7 @@ const BOUNDARY_RULES = [
   {
     boundaryName: 'api-contract',
     requirement: 'API endpoint or contract changes must update API/OpenAPI documentation in the same scope.',
-    suggestedDocumentationUpdates: [
+    requiredDocumentationUpdates: [
       'docs/api-contract.md',
       'docs/flow-overview.md',
       '.agent-context/rules/api-docs.md',
@@ -67,7 +67,7 @@ const BOUNDARY_RULES = [
   {
     boundaryName: 'database-structure',
     requirement: 'Database structure changes must update schema or migration documentation in the same scope.',
-    suggestedDocumentationUpdates: [
+    requiredDocumentationUpdates: [
       'docs/database-schema.md',
       'docs/flow-overview.md',
       '.agent-context/rules/database-design.md',
@@ -163,8 +163,8 @@ function isDocumentationFilePath(filePath) {
 
 function evaluateBoundary(boundaryRule, changedFiles, changedDocumentationFiles) {
   const boundaryChangedFiles = changedFiles.filter((filePath) => boundaryRule.trigger(filePath));
-  const expectedDocumentationPaths = Array.isArray(boundaryRule.suggestedDocumentationUpdates)
-    ? boundaryRule.suggestedDocumentationUpdates
+  const expectedDocumentationPaths = Array.isArray(boundaryRule.requiredDocumentationUpdates)
+    ? boundaryRule.requiredDocumentationUpdates
     : [];
 
   if (boundaryChangedFiles.length === 0) {
@@ -177,14 +177,14 @@ function evaluateBoundary(boundaryRule, changedFiles, changedDocumentationFiles)
       documentationFiles: [],
       expectedDocumentationPaths,
       missingDocumentationUpdates: false,
-      suggestedActions: [],
+      requiredActions: [],
       details: 'Boundary not triggered by changed scope.',
     };
   }
 
   const matchingDocumentationFiles = changedDocumentationFiles.filter((filePath) => boundaryRule.docsMatcher(filePath));
   const boundaryPassed = matchingDocumentationFiles.length > 0;
-  const suggestedActions = boundaryPassed
+  const requiredActions = boundaryPassed
     ? []
     : [
       `Update one or more boundary docs: ${expectedDocumentationPaths.join(', ')}`,
@@ -204,7 +204,7 @@ function evaluateBoundary(boundaryRule, changedFiles, changedDocumentationFiles)
     documentationFiles: matchingDocumentationFiles,
       expectedDocumentationPaths,
       missingDocumentationUpdates: !boundaryPassed,
-      suggestedActions,
+      requiredActions,
     details,
   };
 }
@@ -225,7 +225,7 @@ function runDocumentationBoundaryAudit() {
       requirement: boundaryResult.requirement,
       changedFiles: boundaryResult.changedFiles,
       expectedDocumentationPaths: boundaryResult.expectedDocumentationPaths,
-      suggestedActions: boundaryResult.suggestedActions,
+      requiredActions: boundaryResult.requiredActions,
       diagnosticCode: `BOUNDARY_${boundaryResult.boundaryName.toUpperCase().replace(/-/g, '_')}_DOCS_SYNC_REQUIRED`,
     }));
 

package/scripts/explain-on-demand-audit.mjs

@@ -39,7 +39,7 @@ const REQUIRED_PR_CHECKLIST_SNIPPETS = [
 ];
 
 const REQUIRED_REVIEW_PROMPT_SNIPPETS = [
-  'Enforce explain-on-demand state visibility: default responses must avoid unnecessary state-file internals, state internals are exposed only on explicit request, and diagnostic mode must explain relevant state decisions when needed.',
+  'Review the code with a production-risk mindset.',
 ];
 
 const INTERNAL_STATE_SIGNAL_PATTERNS = [
@@ -225,11 +225,11 @@ function assertSnippetCoverage(sourceLabel, sourcePath, requiredSnippets, failur
 }
 
 function buildDefaultResponseSummary(onboardingReport) {
-  const selectedStack = String(onboardingReport?.selectedStack || 'unknown-stack').trim() || 'unknown-stack';
-  const selectedBlueprint = String(onboardingReport?.selectedBlueprint || 'unknown-blueprint').trim() || 'unknown-blueprint';
+  const runtimeDecision = String(onboardingReport?.runtimeDecision?.mode || onboardingReport?.selectedStack || 'unknown-runtime-decision').trim() || 'unknown-runtime-decision';
+  const architectureDecision = String(onboardingReport?.architectureDecision?.mode || onboardingReport?.selectedBlueprint || 'unknown-architecture-decision').trim() || 'unknown-architecture-decision';
   const selectedProfile = String(onboardingReport?.selectedProfile || 'unknown-profile').trim() || 'unknown-profile';
 
-  return `Active setup summary: stack=${selectedStack}, blueprint=${selectedBlueprint}, profile=${selectedProfile}.`;
+  return `Active setup summary: runtimeDecision=${runtimeDecision}, architectureDecision=${architectureDecision}, profile=${selectedProfile}.`;
 }
 
 function detectInternalSignals(textValue) {
@@ -240,14 +240,14 @@ function detectInternalSignals(textValue) {
 function buildDiagnosticDecisionSummaries(onboardingReport) {
   const explanations = [];
 
-  const selectedStack = String(onboardingReport?.selectedStack || '').trim();
-  if (selectedStack) {
-    explanations.push(`Stack decision: selectedStack=${selectedStack}.`);
+  const runtimeDecision = String(onboardingReport?.runtimeDecision?.mode || onboardingReport?.selectedStack || '').trim();
+  if (runtimeDecision) {
+    explanations.push(`Runtime decision: ${runtimeDecision}.`);
   }
 
-  const selectedBlueprint = String(onboardingReport?.selectedBlueprint || '').trim();
-  if (selectedBlueprint) {
-    explanations.push(`Blueprint decision: selectedBlueprint=${selectedBlueprint}.`);
+  const architectureDecision = String(onboardingReport?.architectureDecision?.mode || onboardingReport?.selectedBlueprint || '').trim();
+  if (architectureDecision) {
+    explanations.push(`Architecture decision: ${architectureDecision}.`);
   }
 
   const selectedProfile = String(onboardingReport?.selectedProfile || '').trim();
@@ -423,4 +423,4 @@ function runAudit() {
   process.exit(reportPayload.passed ? 0 : 1);
 }
 
-runAudit();
+runAudit();

package/scripts/forbidden-content-check.mjs

@@ -15,22 +15,22 @@ const FORBIDDEN_PATTERNS = [
   {
     name: 'Hardcoded API Key',
     regex: /api_?key\s*[:=]\s*['"][a-zA-Z0-9_\-]{16,}['"]/i,
-    suggestion: 'API Keys must be provided via environment variables (process.env) or config files, never hardcoded.'
+    requiredAction: 'API Keys must be provided via environment variables (process.env) or config files, never hardcoded.'
   },
   {
     name: 'Hardcoded Password',
     regex: /password\s*[:=]\s*['"][^'"]+['"]/i,
-    suggestion: 'Passwords must be injected via secret managers or environment variables.'
+    requiredAction: 'Passwords must be injected via secret managers or environment variables.'
   },
   {
     name: 'Absolute Local Desktop Path',
     regex: /file:\/\/\/?([c-zC-Z]:|\/Users\/|\/home\/)/,
-    suggestion: 'Do not commit local absolute file paths (e.g. file:///C:/Users). Use relative paths or process.cwd().'
+    requiredAction: 'Do not commit local absolute file paths. Use relative paths or process.cwd().'
   },
   {
     name: 'Stray Breakpoint (debugger)',
     regex: /\bdebugger\s*;?/,
-    suggestion: 'Remove debug breakpoints before publishing to production.'
+    requiredAction: 'Remove debug breakpoints before publishing to production.'
   }
 ];
 
@@ -48,7 +48,7 @@ function scanFile(filePath) {
           line: i + 1,
           content: line.trim().substring(0, 80), // truncate long lines
           rule: pattern.name,
-          suggestion: pattern.suggestion
+          requiredAction: pattern.requiredAction
         });
       }
     }
@@ -97,12 +97,12 @@ async function runCheck() {
 
       if (violations.length > 0) {
         const relPath = relative(ROOT_DIR, file);
-        console.error(`\n❌ FORBIDDEN CONTENT DETECTED IN: ${relPath}`);
+        console.error(`\nFORBIDDEN CONTENT DETECTED IN: ${relPath}`);
 
         for (const v of violations) {
           console.error(`   Line ${v.line}: [${v.rule}]`);
           console.error(`   > ${v.content}`);
-          console.error(`   Action required: ${v.suggestion}`);
+          console.error(`   Action required: ${v.requiredAction}`);
           totalViolations++;
         }
       }
@@ -112,10 +112,10 @@ async function runCheck() {
   console.log(`\nScanned ${filesScanned.length} files across ${SCAN_DIRECTORIES.length} source directories.`);
 
   if (totalViolations > 0) {
-    console.error(`\n✖ PUBLISH ABORTED: Found ${totalViolations} forbidden content violation(s).`);
+    console.error(`\nPUBLISH ABORTED: Found ${totalViolations} forbidden content violation(s).`);
     process.exit(1);
   } else {
-    console.log('✔ Clean. No forbidden content detected.');
+    console.log('Clean. No forbidden content detected.');
     process.exit(0);
   }
 }

package/scripts/frontend-usability-audit.mjs

@@ -53,49 +53,52 @@ const REQUIRED_ARCHITECTURE_CHECKLIST_SNIPPETS = [
 ];
 
 const REQUIRED_FRONTEND_RULE_SNIPPETS = [
-  'Frontend Designer Mode (Auto Activation)',
-  'UI scope trigger signals',
-  'visual intent, interaction quality, and conversion clarity',
-  'template-only repetitive outputs',
-  'Context Hygiene and Reference Boundaries (Mandatory)',
-  'Accessibility Split (Mandatory)',
+  'Frontend Design and Interaction Boundaries',
+  'UI work must load the smallest relevant surface, not the entire engineering handbook.',
+  '## Auto Activation',
+  'UI scope triggers:',
+  'Do not use this file to teach generic frontend basics the model already knows.',
+  '## Source Hygiene and Source Boundaries',
+  'This rule guides the LLM; it must not choose the final style',
   'Design continuity is opt-in.',
-  'repo evidence wins',
-  'WCAG 2.2 AA as the hard compliance floor',
-  'APCA as an advisory readability model',
-  'Structured Design Execution Boundaries (Mandatory)',
-  'UI review must stay representation-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.',
-  'Responsive quality requires layout mutation and task reprioritization across breakpoints. Shrinking the desktop layout is not enough.',
+  'Repo evidence outranks memory residue every time.',
+  '## Accessibility Split',
+  'Treat WCAG 2.2 AA as the hard compliance floor.',
+  'Treat APCA as advisory perceptual tuning only.',
+  '## Anti-Generic UI Boundaries',
+  'Do not default to interchangeable dashboard chrome',
+  'Do not let repeated surfaces share the same visual treatment by habit.',
+  'Do not use default framework button and input treatment as the final UI language.',
+  '## Responsive Mutation Requirements',
+  'Responsive quality is not allowed to be scale-only.',
+  '## Surface and Morphology Requirements',
+  'Define the primary user task or reading path from current evidence',
+  '## Implementation Boundaries',
+  'Do not hardcode Zustand, React Query, smart/dumb component doctrine',
 ];
 
 const REQUIRED_BOOTSTRAP_DESIGN_SNIPPETS = [
-  'UI Design Mode is context-isolated by default:',
-  'Responsive Strategy and Cross-Viewport Adaptation Matrix',
+  'This contract is a decision scaffold, not a style preset.',
+  'We guide the agent; we do not pick the final style',
+  'Responsive Recomposition Plan',
   'Token Architecture and Alias Strategy',
-  'tokenSystem',
-  'colorTruth.format',
-  'crossViewportAdaptation.mutationRules.mobile/tablet/desktop',
-  'motionSystem',
-  'componentMorphology',
-  'accessibilityPolicy',
-  'designExecutionPolicy',
-  'designExecutionHandoff',
-  'reviewRubric',
-  'contextHygiene',
-  'Design continuity is opt-in.',
-  'WCAG 2.2 AA as the blocking baseline',
-  'APCA only as advisory perceptual tuning',
-  'Structured design execution must stay representation-first',
-  'structured handoff',
+  'repoEvidence.designEvidenceSummary',
+  'research current official docs',
+  'Responsive design means recomposition, not resizing.',
+  'agent-chosen visual direction',
+  'viewport mutation rules',
+  'WCAG 2.2 AA is the hard floor',
+  'APCA may be used only as advisory perceptual tuning',
+  'unresearched dependency choices',
+  'default component-kit styling without product rationale',
+  'genericity findings that cannot name the exact drift signal',
 ];
 
 const REQUIRED_UI_DESIGN_JUDGE_SNIPPETS = [
-  'Advisory-first UI design contract judge.',
+  'Advisory-default UI design contract judge.',
   'Repo-internal workflow audit; no user-facing runtime modes.',
-  'Runs only in advisory mode for this repository workflow.',
+  'genericityAutoFail',
+  'blocking required actions',
   'Do not reward generic SaaS defaults or popular template patterns.',
   'UI design judge only evaluates changed UI surfaces.',
   'Structured design execution summary was supplied to semantic review.',
@@ -106,15 +109,18 @@ const REQUIRED_UI_DESIGN_JUDGE_SNIPPETS = [
   'genericityStatus',
   'handoffReady',
   'calibratedStatus',
+  'structuredInspectionAvailable',
+  'applyGenericityAutoFail',
 ];
 
 const REQUIRED_INSTRUCTIONS_SNIPPETS = [
   'UI Design Mode',
+  'Resolve the smallest relevant layer set for the current request.',
   'bootstrap-design.md',
   'frontend-architecture.md',
   'do not eagerly load unrelated backend-only rules',
   'valid style context',
-  'explicitly approved reference systems',
+  'External references, prior-chat memory, unrelated-project visuals, and remembered screenshots are tainted',
   'WCAG 2.2 AA as the hard compliance floor',
   'APCA as advisory perceptual tuning only',
   'Do not require screenshot capture as a baseline dependency',
@@ -125,6 +131,9 @@ const REQUIRED_DESIGN_EVIDENCE_SNIPPETS = [
   "source: 'lightweight-static-scan'",
   'cssVariables',
   'componentInventory',
+  'structuredInspection',
+  'classAttributeCount',
+  'inlineStyleObjectCount',
   'tokenBypassSignals',
 ];
 
@@ -254,6 +263,7 @@ function runAudit() {
       extractorIncludesSummaryVersion: designEvidenceExtractorContent.includes('summaryVersion'),
       extractorIncludesCssVariables: designEvidenceExtractorContent.includes('cssVariables'),
       extractorIncludesComponentInventory: designEvidenceExtractorContent.includes('componentInventory'),
+      extractorIncludesStructuredInspection: designEvidenceExtractorContent.includes('structuredInspection'),
       extractorIncludesTokenBypassSignals: designEvidenceExtractorContent.includes('tokenBypassSignals'),
       compilerProjectsFrontendEvidenceMetrics: compilerContent.includes('frontendEvidenceMetrics'),
       compilerProjectsDesignEvidenceSummary: compilerContent.includes('designEvidenceSummary'),

package/scripts/llm-judge.mjs

@@ -242,7 +242,7 @@ You must categorize each violation with a severity level: critical, high, medium
 - critical: Security vulnerabilities (hardcoded secrets, SQL/command injection, missing auth checks, CORS), unvalidated external inputs.
 - high: N+1 database queries, swallowed errors (empty catch blocks without re-throw/recovery), layer boundary violations.
 - medium: TypeScript \`any\` type used without justification, missing test coverage, bad architectural patterns.
-- low: Style preferences, minor naming nitpicks, documentation suggestions, performance micro-optimizations.
+- low: Style preferences, minor naming nitpicks, documentation nitpicks, performance micro-optimizations.
 
 ## Mandatory output format:
 You MUST output your findings in EXACTLY this structure:

package/scripts/mcp-server/constants.mjs

@@ -33,9 +33,9 @@ function resolvePackageVersion() {
 export const PACKAGE_VERSION = resolvePackageVersion();
 
 export const TEST_SUITE_ARGS = {
-  full: ['--test', './tests/cli-smoke.test.mjs', './tests/mcp-server.test.mjs', './tests/llm-judge.test.mjs', './tests/enterprise-ops.test.mjs'],
+  full: ['--test', './tests/cli-smoke.test.mjs', './tests/mcp-server.test.mjs', './tests/llm-judge.test.mjs', './tests/operations.test.mjs'],
   cli: ['--test', './tests/cli-smoke.test.mjs'],
-  enterprise: ['--test', './tests/enterprise-ops.test.mjs'],
+  operations: ['--test', './tests/operations.test.mjs'],
   'llm-judge': ['--test', './tests/llm-judge.test.mjs'],
 };
 

package/scripts/mcp-server/tool-registry.mjs

@@ -112,7 +112,7 @@ export function buildToolDefinitions() {
         properties: {
           path: {
             type: 'string',
-            description: 'Path relative to .agent-context/state (for example memory-continuity-benchmark.json).',
+            description: 'Path relative to .agent-context/state, such as memory-continuity-benchmark.json.',
           },
         },
         required: ['path'],

package/scripts/release-gate/audit-checks.mjs

@@ -39,7 +39,7 @@ export function runAuditReleaseChecks(results, diagnostics) {
         typeof boundaryResult?.boundaryName === 'string'
         && typeof boundaryResult?.requirement === 'string'
         && Array.isArray(boundaryResult?.expectedDocumentationPaths)
-        && Array.isArray(boundaryResult?.suggestedActions)
+        && Array.isArray(boundaryResult?.requiredActions)
       ));
 
     if (hasMachineReadableBoundaryDiagnostics) {
@@ -117,10 +117,10 @@ export function runAuditReleaseChecks(results, diagnostics) {
           const changedFiles = Array.isArray(violation?.changedFiles) && violation.changedFiles.length > 0
             ? violation.changedFiles.join(', ')
             : 'unknown-changed-files';
-          const suggestion = Array.isArray(violation?.suggestedActions) && violation.suggestedActions.length > 0
-            ? violation.suggestedActions[0]
+          const requiredAction = Array.isArray(violation?.requiredActions) && violation.requiredActions.length > 0
+            ? violation.requiredActions[0]
             : 'Update matching boundary documentation in the same scope.';
-          return `${failureCode} (${violation?.boundaryName || 'unknown-boundary'}): ${changedFiles}. Action: ${suggestion}`;
+          return `${failureCode} (${violation?.boundaryName || 'unknown-boundary'}): ${changedFiles}. Action: ${requiredAction}`;
         })
         : Array.isArray(documentationBoundaryAuditExecution.report.failures)
           ? documentationBoundaryAuditExecution.report.failures

package/scripts/release-gate/static-checks.mjs

@@ -66,7 +66,7 @@ export function runStaticReleaseChecks(results, diagnostics) {
     pushResult(results, true, 'roadmap-v18', 'Roadmap includes V1.8 release track');
   }
 
-  const requiredEnterpriseFiles = [
+  const requiredOperationsFiles = [
     '.agent-context/review-checklists/architecture-review.md',
     'docs/v1.8-operations-playbook.md',
     '.github/workflows/release-gate.yml',
@@ -75,14 +75,14 @@ export function runStaticReleaseChecks(results, diagnostics) {
     'scripts/governance-weekly-report.mjs',
   ];
 
-  for (const requiredEnterpriseFile of requiredEnterpriseFiles) {
-    const absoluteRequiredPath = resolve(REPOSITORY_ROOT, requiredEnterpriseFile);
+  for (const requiredOperationsFile of requiredOperationsFiles) {
+    const absoluteRequiredPath = resolve(REPOSITORY_ROOT, requiredOperationsFile);
     if (!existsSync(absoluteRequiredPath)) {
-      pushResult(results, false, 'required-enterprise-file', `Missing ${requiredEnterpriseFile}`);
+      pushResult(results, false, 'required-operations-file', `Missing ${requiredOperationsFile}`);
       continue;
     }
 
-    pushResult(results, true, 'required-enterprise-file', `${requiredEnterpriseFile} is present`);
+    pushResult(results, true, 'required-operations-file', `${requiredOperationsFile} is present`);
   }
 
   pushResult(

package/scripts/release-gate.mjs

@@ -3,7 +3,7 @@
 /**
  * release-gate.mjs
  *
- * Enterprise release gate for V1.8.
+ * Operations release gate for V1.8.
  * Produces machine-readable output for CI and fails fast on missing release evidence.
  *
  * Validation anchors kept here intentionally:

package/scripts/rules-guardian-audit.mjs

@@ -36,15 +36,15 @@ const SUPPORTED_WORKFLOWS = new Set([
 const CORE_PATTERN_SIGNALS = [
   {
     pattern: 'layer-separation',
-    snippet: 'Every layer has ONE job.',
+    snippet: '## Layer Boundaries (Mandatory)',
   },
   {
-    pattern: 'modular-monolith-default',
-    snippet: 'Default Architecture: Modular Monolith',
+    pattern: 'agent-decides-topology',
+    snippet: 'Do not force a default architecture label before the repo, delivery model, and boundary evidence are clear.',
   },
   {
     pattern: 'feature-based-grouping',
-    snippet: 'Project Structure: Feature-Based Grouping',
+    snippet: 'Group code by feature or domain',
   },
   {
     pattern: 'rules-as-guardian-cross-session',
@@ -55,7 +55,7 @@ const CORE_PATTERN_SIGNALS = [
 const REQUIRED_ARCHITECTURE_RULE_SNIPPETS = [
   '## Rules as Guardian (Cross-Session Consistency)',
   'Session handoff must include active architecture contract summary.',
-  'Detect drift before changing declared stack or core patterns.',
+  'Detect drift before changing runtime choices, topology, public contracts, or core patterns.',
   'Direction changes require explicit user confirmation before applying changes.',
 ];
 
@@ -66,7 +66,8 @@ const REQUIRED_PR_CHECKLIST_SNIPPETS = [
 ];
 
 const REQUIRED_REVIEW_PROMPT_SNIPPETS = [
-  'Enforce cross-session consistency guardian: session handoff must include active architecture contract summary, drift detection must warn before direction changes, and direction changes require explicit user confirmation.',
+  'Review the code with a production-risk mindset.',
+  'Do not invent stack-specific concerns unless the repo or changed files prove they apply.',
 ];
 
 function pushResult(results, isPassed, checkName, details) {
@@ -295,8 +296,8 @@ function parseBooleanFromEnvironment(rawEnvironmentValue) {
 
 function buildArchitectureContract(onboardingReport, corePatterns) {
   return {
-    stack: String(onboardingReport?.selectedStack || 'unknown').trim() || 'unknown',
-    blueprint: String(onboardingReport?.selectedBlueprint || 'unknown').trim() || 'unknown',
+    runtimeDecision: String(onboardingReport?.runtimeDecision?.mode || onboardingReport?.selectedStack || 'unknown').trim() || 'unknown',
+    architectureDecision: String(onboardingReport?.architectureDecision?.mode || onboardingReport?.selectedBlueprint || 'unknown').trim() || 'unknown',
     profile: String(onboardingReport?.selectedProfile || 'unknown').trim() || 'unknown',
     corePatterns: normalizeCorePatterns(corePatterns),
   };
@@ -312,7 +313,7 @@ function toComparableContractValue(value) {
 
 function detectContractDrift(baseContract, targetContract, driftSource) {
   const driftItems = [];
-  const fieldNames = ['stack', 'blueprint', 'profile', 'corePatterns'];
+  const fieldNames = ['runtimeDecision', 'architectureDecision', 'profile', 'corePatterns'];
 
   for (const fieldName of fieldNames) {
     const baseValue = toComparableContractValue(baseContract?.[fieldName]);
@@ -336,7 +337,7 @@ function buildSessionHandoffSummary(architectureContract) {
     ? architectureContract.corePatterns.join(', ')
     : 'none';
 
-  return `Architecture contract summary: stack=${architectureContract.stack}, blueprint=${architectureContract.blueprint}, profile=${architectureContract.profile}, corePatterns=${corePatternsSummary}.`;
+  return `Architecture contract summary: runtimeDecision=${architectureContract.runtimeDecision}, architectureDecision=${architectureContract.architectureDecision}, profile=${architectureContract.profile}, corePatterns=${corePatternsSummary}.`;
 }
 
 function assertSnippetCoverage(sourceLabel, sourcePath, requiredSnippets, failures, results) {
@@ -468,8 +469,8 @@ function runAudit() {
   );
 
   const proposedContract = {
-    stack: parsedArguments.proposedStack || activeContract.stack,
-    blueprint: parsedArguments.proposedBlueprint || activeContract.blueprint,
+    runtimeDecision: parsedArguments.proposedStack || activeContract.runtimeDecision,
+    architectureDecision: parsedArguments.proposedBlueprint || activeContract.architectureDecision,
     profile: activeContract.profile,
     corePatterns: parsedArguments.proposedCorePatterns.length > 0
       ? parsedArguments.proposedCorePatterns
@@ -573,4 +574,4 @@ function runAudit() {
   process.exit(reportPayload.passed ? 0 : 1);
 }
 
-runAudit();
+runAudit();

package/scripts/single-source-lazy-loading-audit.mjs

@@ -76,8 +76,8 @@ const REQUIRED_REVIEW_PROMPT_SNIPPETS = [
 
 const REQUIRED_COMPILER_SNIPPETS = [
   '## LAYER 2 POLICY: LAZY RULE LOADING',
-  'Load stack guidance only when task scope touches that stack.',
-  'Avoid eager loading unrelated stack profiles to prevent instruction conflicts.',
+  'Load runtime-specific guidance only when task scope touches that runtime.',
+  'Avoid eager loading unrelated runtime guidance to prevent instruction conflicts.',
   "stackLoadingMode: 'lazy'",
 ];
 
@@ -532,4 +532,4 @@ function runAudit() {
   process.exit(reportPayload.passed ? 0 : 1);
 }
 
-runAudit();
+runAudit();

package/scripts/sync-thin-adapters.mjs

@@ -45,7 +45,7 @@ If your host stops at this file instead of following the full chain, obey the Cr
 - 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 new project or module requests: clarify constraints, stack decisions, and required docs before generating code.
 - For ecosystem, framework, dependency, or Docker claims: perform live web research instead of relying on stale local heuristics.
 
 ## Mandatory Bootstrap Chain
@@ -57,11 +57,11 @@ If your host stops at this file instead of following the full chain, obey the Cr
 5. Enforce review contracts from [.agent-context/review-checklists/](.agent-context/review-checklists).
 6. Read change-risk maps and continuity state from [.agent-context/state/](.agent-context/state).
 7. Enforce policy thresholds from [.agent-context/policies/](.agent-context/policies).
-8. Use dynamic stack and architecture reasoning from project context docs and live research signals.
+8. Use dynamic stack, structure, and live research signals from project context docs.
 
 ## Trigger Rules
 
-- New project or module requests: propose architecture first and wait for approval.
+- New project or module requests: propose scope, constraints, and required docs first, then wait for approval.
 - Refactor or fix requests: propose plan first, then execute safely.
 - Completion: run [.agent-context/review-checklists/pr-checklist.md](.agent-context/review-checklists/pr-checklist.md) before declaring done.
 
@@ -92,7 +92,7 @@ If your host stops at this file, follow this minimum floor:
 4. Load request templates from [.agent-context/prompts/](../.agent-context/prompts).
 5. Apply review contracts from [.agent-context/review-checklists/](../.agent-context/review-checklists).
 6. Apply state awareness from [.agent-context/state/](../.agent-context/state) and thresholds from [.agent-context/policies/](../.agent-context/policies).
-7. Resolve stack and architecture choices dynamically from project context docs plus live evidence.
+7. Resolve stack, structure, and dependency choices from project context docs plus live evidence.
 
 ## Completion Gate
 
@@ -123,7 +123,7 @@ If your host stops at this file, follow this minimum floor:
 4. Load request templates from [.agent-context/prompts/](../.agent-context/prompts).
 5. Apply review contracts from [.agent-context/review-checklists/](../.agent-context/review-checklists).
 6. Apply state awareness from [.agent-context/state/](../.agent-context/state) and policy thresholds from [.agent-context/policies/](../.agent-context/policies).
-7. Resolve stack and architecture choices dynamically from project context docs plus live evidence.
+7. Resolve stack, structure, and dependency choices from project context docs plus live evidence.
 
 ## Completion Gate
 

package/scripts/ui-design-judge/design-execution-summary.mjs

@@ -44,6 +44,13 @@ function hasRepoEvidenceSummary(designIntentContent) {
   );
 }
 
+function hasStructuredInspectionEvidence(designIntentContent) {
+  return Boolean(
+    designIntentContent?.repoEvidence?.designEvidenceSummary?.structuredInspection
+    && typeof designIntentContent.repoEvidence.designEvidenceSummary.structuredInspection === 'object'
+  );
+}
+
 function summarizeDesignExecutionHandoff(designIntentContent) {
   const designExecutionHandoff = designIntentContent?.designExecutionHandoff
   && typeof designIntentContent.designExecutionHandoff === 'object'
@@ -72,6 +79,19 @@ function summarizeDesignExecutionHandoff(designIntentContent) {
     ? designExecutionHandoff.viewportMutationPlan
     : {};
 
+  function hasViewportMutationEntry(viewportKey) {
+    const viewportEntry = viewportMutationPlan?.[viewportKey];
+    return Boolean(
+      viewportEntry
+      && typeof viewportEntry === 'object'
+      && String(viewportEntry.primaryOperation || '').trim().length > 0
+      && Array.isArray(viewportEntry.requiredSurfaceActions)
+      && viewportEntry.requiredSurfaceActions.length > 0
+      && Array.isArray(viewportEntry.forbiddenPatterns)
+      && viewportEntry.forbiddenPatterns.length > 0
+    );
+  }
+
   const artifactChecks = [
     { name: 'surfacePlan', present: surfacePlan.length > 0 },
     { name: 'componentGraphNodes', present: componentGraphNodes.length > 1 },
@@ -82,7 +102,7 @@ function summarizeDesignExecutionHandoff(designIntentContent) {
     },
     {
       name: 'viewportMutationPlan',
-      present: ['mobile', 'tablet', 'desktop'].every((viewportKey) => String(viewportMutationPlan?.[viewportKey] || '').trim().length > 0),
+      present: ['mobile', 'tablet', 'desktop'].every((viewportKey) => hasViewportMutationEntry(viewportKey)),
     },
     { name: 'interactionStateMatrix', present: interactionStateMatrix.length > 0 },
     { name: 'taskFlowNarrative', present: taskFlowNarrative.length > 1 },
@@ -131,6 +151,7 @@ export function summarizeDesignExecutionPolicy(designIntentContent) {
     ? designExecutionPolicy.representationStrategy
     : null;
   const repoEvidenceAvailable = hasRepoEvidenceSummary(designIntentContent);
+  const structuredInspectionAvailable = hasStructuredInspectionEvidence(designIntentContent);
   const screenshotDependencyForbidden = designExecutionPolicy.forbidScreenshotDependency === true;
   const handoffFormatVersion = typeof designExecutionPolicy.handoffFormatVersion === 'string'
     ? designExecutionPolicy.handoffFormatVersion
@@ -170,6 +191,8 @@ export function summarizeDesignExecutionPolicy(designIntentContent) {
   }
   if (!repoEvidenceAvailable) {
     notes.push('repoEvidence.designEvidenceSummary is missing or unreadable.');
+  } else if (!structuredInspectionAvailable) {
+    notes.push('repoEvidence.designEvidenceSummary.structuredInspection is missing; class and inline-style evidence will stay lower-confidence.');
   }
   if (notes.length === 0) {
     notes.push('Structured design execution policy is present and ready for contract review.');
@@ -181,6 +204,7 @@ export function summarizeDesignExecutionPolicy(designIntentContent) {
     contractReady,
     screenshotDependencyForbidden,
     repoEvidenceAvailable,
+    structuredInspectionAvailable,
     handoffPresent: handoffSummary.present,
     handoffVersion: handoffSummary.version,
     handoffReady: handoffSummary.handoffReady,
@@ -216,8 +240,10 @@ export function summarizeReviewRubric(designIntentContent) {
   return {
     version: typeof reviewRubric.version === 'string' ? reviewRubric.version : null,
     dimensions,
+    genericityAutoFail: reviewRubric.genericityAutoFail === true,
     genericitySignals: normalizeStringArray(reviewRubric.genericitySignals),
     validBoldSignals: normalizeStringArray(reviewRubric.validBoldSignals),
+    forbiddenPatterns: normalizeStringArray(designIntentContent?.forbiddenPatterns),
     reportingRules: reviewRubric.reportingRules && typeof reviewRubric.reportingRules === 'object'
       ? {
         mustExplainGenericity: reviewRubric.reportingRules.mustExplainGenericity === true,