@ryuenn3123/agentic-senior-core 3.0.17 → 3.0.20

package/scripts/ui-rubric-calibration.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+// @ts-check
+
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { buildRubricCalibrationReport } from './ui-design-judge/rubric-calibration.mjs';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const GOLDSET_PATH = resolve(__dirname, 'ui-design-judge', 'rubric-goldset.json');
+const REPORT_NAME = 'ui-rubric-calibration';
+
+function loadGoldset() {
+  return JSON.parse(readFileSync(GOLDSET_PATH, 'utf8'));
+}
+
+function main() {
+  const goldset = loadGoldset();
+  const report = buildRubricCalibrationReport({
+    cases: goldset.cases,
+    reviewRubricSummary: goldset.reviewRubric,
+  });
+  report.reportName = REPORT_NAME;
+  // Keep the report surface explicit so static validation can detect the machine-readable payload contract.
+  report.accuracyPercent = report.accuracyPercent;
+
+  console.log(JSON.stringify(report, null, 2));
+
+  if (!report.passed) {
+    process.exitCode = 1;
+  }
+}
+
+main();

package/scripts/validate/config.mjs

@@ -84,18 +84,18 @@ export const REQUIRED_DEVELOPER_FIRST_MENTION_PATTERNS = [
   },
   {
     path: '.agent-context/prompts/init-project.md',
-    label: 'Init prompt first mention includes Federated Governance baseline',
-    pattern: /rules operations context\s*\(Federated Governance baseline\)/iu,
+    label: 'Init prompt first mention includes strict AI coding guidance context',
+    pattern: /strict AI coding guidance context/iu,
   },
   {
     path: 'lib/cli/commands/init.mjs',
-    label: 'Init command wording includes Federated Governance baseline',
-    pattern: /rules operations\s+(assets|pack)[^\n]*\(Federated Governance baseline\)/iu,
+    label: 'Init command wording includes project guidance pack',
+    pattern: /copy the project guidance pack[^\n]*compile a single rulebook/iu,
   },
   {
     path: 'lib/cli/commands/upgrade.mjs',
-    label: 'Upgrade command wording includes Federated Governance baseline',
-    pattern: /rules operations upgrade assistant\s*\(Federated Governance baseline\)/iu,
+    label: 'Upgrade command wording includes managed guidance upgrade',
+    pattern: /running managed guidance upgrade for an existing repository\./iu,
   },
   {
     path: 'lib/cli/utils.mjs',
@@ -121,10 +121,9 @@ export const REQUIRED_COMPLIANCE_CANONICAL_SNIPPETS = [
 ];
 export const REQUIRED_DETECTION_TRANSPARENCY_SNIPPETS = [
   {
-    path: 'lib/cli/commands/init.mjs',
+    path: 'lib/cli/init-detection-flow.mjs',
     snippets: [
-      'Existing project detection transparency:',
-      'Use detected setup for this existing project?',
+      'existing-project-evidence-only',
       'detectionTransparency',
     ],
   },
@@ -144,20 +143,38 @@ export const REQUIRED_DETECTION_TRANSPARENCY_SNIPPETS = [
     ],
   },
 ];
-export const REQUIRED_STACK_RESEARCH_ENGINE_SNIPPETS = [
+export const REQUIRED_STACK_DECISION_BOUNDARY_SNIPPETS = [
+  {
+    path: '.instructions.md',
+    snippets: [
+      'Do not silently choose frameworks or architecture from offline heuristics.',
+      'produce a short recommendation from evidence and live official documentation before coding',
+    ],
+  },
+  {
+    path: '.agent-context/prompts/init-project.md',
+    snippets: [
+      'If the user already named a stack or framework, treat it as an explicit constraint.',
+      'produce a short evidence-backed recommendation from the brief, repo evidence, and live official documentation before coding',
+    ],
+  },
   {
-    path: 'lib/cli/architect.mjs',
+    path: '.agent-context/rules/architecture.md',
     snippets: [
-      'STACK_SIGNAL_WEIGHTS',
-      'briefType',
-      'recommendArchitecture',
-      'formatArchitectureRecommendation',
+      'Do not force a default architecture label before the repo, delivery model, and boundary evidence are clear.',
+    ],
+  },
+  {
+    path: '.agent-context/rules/microservices.md',
+    snippets: [
+      'Do not start with microservices by fashion, fear, or habit.',
     ],
   },
   {
     path: 'lib/cli/commands/init.mjs',
     snippets: [
-      'recommendArchitecture',
+      'AGENT_DECISION_STACK_FILE_NAME',
+      'agent recommendation required from current repo/brief evidence',
     ],
   },
 ];
@@ -254,12 +271,13 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
   {
     path: '.instructions.md',
     snippets: [
+      'Resolve the smallest relevant layer set for the current request.',
       'UI Design Mode',
       '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',
     ],
@@ -267,64 +285,118 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
   {
     path: '.agent-context/prompts/bootstrap-design.md',
     snippets: [
-      'UI Design Mode is context-isolated by default:',
+      'This contract is a decision scaffold, not a style preset.',
+      'We guide the agent; we do not pick the final style',
       'Token Architecture and Alias Strategy',
-      '`tokenSystem`',
       '`repoEvidence.designEvidenceSummary`',
-      'Responsive Strategy and Cross-Viewport Adaptation Matrix',
-      '`colorTruth.format`',
-      '`crossViewportAdaptation.mutationRules.mobile/tablet/desktop`',
-      '`motionSystem`',
-      '`componentMorphology`',
-      '`accessibilityPolicy`',
-      '`visualQaPolicy`',
-      '`contextHygiene`',
-      'Do not reuse a color palette, component skin, or motion signature from prior chats, memories, or unrelated projects',
-      'If no approved reference system exists, synthesize the design from zero using current product context, constraints, and content only.',
-      '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',
-      'long-page capture strategy',
-      'anchor-based section or tiled-scroll captures',
+      'Responsive Recomposition Plan',
+      'source of truth',
+      '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',
     ],
   },
   {
     path: 'scripts/ui-design-judge.mjs',
     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.',
-      'Deterministic visual diff reported no meaningful drift, so semantic review was skipped.',
-      'UI_VISUAL_DIFF_REPORT_JSON',
-      'meaningfulDiffViewportCount',
+      'Structured design execution summary was supplied to semantic review.',
+      'designExecutionSignalCount',
+      'designExecutionPolicy',
+      'designExecutionHandoff',
+      'reviewRubric',
+      'genericityStatus',
+      'handoffReady',
+      'structuredInspectionAvailable',
+      'calibratedStatus',
+      'applyGenericityAutoFail',
+    ],
+  },
+  {
+    path: 'scripts/ui-design-judge/rubric-calibration.mjs',
+    snippets: [
+      'ui-rubric-calibration-v1',
+      'matchedGenericitySignals',
+      'matchedForbiddenPatterns',
+      'matchedValidBoldSignals',
+      'contractDriftDetected',
+      'Genericity claim was not backed by any named drift signal.',
+    ],
+  },
+  {
+    path: 'scripts/ui-rubric-calibration.mjs',
+    snippets: [
+      'ui-rubric-calibration',
+      'rubric-goldset.json',
+      'accuracyPercent',
     ],
   },
   {
     path: 'lib/cli/project-scaffolder/design-contract.mjs',
     snippets: [
       'tokenSystem',
+      'seedPolicy',
+      'structure-first-scaffold',
       'colorTruth',
+      'rolesAreMinimumScaffold',
       'crossViewportAdaptation',
       'motionSystem',
+      'seedToneLocked',
       'componentMorphology',
+      'seedBehaviorsRequireRefinement',
       'accessibilityPolicy',
-      'visualQaPolicy',
-      'deterministicFirst',
-      'baselineStrategy',
-      'requiredViewports',
-      'capturePlan',
-      'longPageStrategy',
-      'tileOverlapRatio',
-      'meaningfulDiffRatioThreshold',
+      'designExecutionPolicy',
+      'seedRefinementRequiredBeforeUiImplementation',
+      'requirePerSurfaceMutationOps',
+      'forbidUniformSiblingSurfaceTreatment',
+      'requireStructuredHandoff',
+      'handoffFormatVersion',
+      'designExecutionHandoff',
+      'seedMode',
+      'requiresTaskSpecificRefinement',
+      'representationStrategy',
+      'requireSurfacePlan',
+      'requireComponentGraph',
+      'requireViewportMutationPlan',
+      'requireInteractionStateMatrix',
+      'requireContentPriorityMap',
+      'forbidScreenshotDependency',
+      'semanticReviewFocus',
+      'primaryExperienceGoal',
+      'surfacePlan',
+      'contentPriorityMap',
+      'viewportMutationPlan',
+      'interactionStateMatrix',
+      'taskFlowNarrative',
+      'signatureMoveRationale',
+      'implementationGuardrails',
+      'reviewRubric',
+      'genericityAutoFail',
+      'genericitySignals',
+      'validBoldSignals',
+      'mustExplainGenericity',
+      'mustSeparateTasteFromFailure',
+      'offline-prescribed-style-used-as-final-direction',
+      'unresearched-library-or-framework-choice',
+      'single-safe-typographic-family-without-role-contrast-or-rationale',
       'hardComplianceFloor',
       'advisoryContrastModel',
       'contextHygiene',
       'repoEvidenceOverridesMemory',
       'requireExplicitContinuityApproval',
       'forbidCarryoverWhenUnapproved',
+      'approvedExternalConstraintUsage',
       'requireViewportMutationRules',
       'allowHexDerivatives',
     ],
@@ -345,15 +417,21 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       'arbitraryBreakpointCount',
       'cssVariables',
       'componentInventory',
+      'structuredInspection',
+      'classAttributeCount',
+      'inlineStyleObjectCount',
       'tokenBypassSignals',
     ],
   },
   {
     path: 'lib/cli/compiler.mjs',
     snippets: [
+      'Resolve the smallest relevant layer set before responding.',
+      'LAYER 1: RULES (SCOPE-RESOLVED)',
       'LAYER 5: EXECUTION PROMPTS AND UI TRIGGERS',
       'bootstrap-design.md -> ui, ux, layout, screen, tailwind, frontend, redesign',
       'Keep UI-only requests context-isolated',
+      'git-workflow.md',
       'designEvidenceSummary',
     ],
   },
@@ -373,9 +451,9 @@ export const REQUIRED_DOCKER_RUNTIME_AUTOMATION_SNIPPETS = [
       'Docker Compose Quickstart',
       'Compose file reference',
       'Dockerfile best practices',
-      'Prefer current `docker compose` workflows and `compose.yaml`.',
+      'Use current `docker compose` workflows and `compose.yaml`.',
       'Do not add the top-level Compose `version` field by default.',
-      'Prefer the latest stable compatible Docker base image',
+      'Use the latest stable compatible Docker base image',
     ],
   },
   {
@@ -390,7 +468,7 @@ export const REQUIRED_DEPENDENCY_FRESHNESS_AUTOMATION_SNIPPETS = [
   {
     path: '.instructions.md',
     snippets: [
-      'prefer the latest stable compatible dependency set and official setup flow',
+      'use the latest stable compatible dependency set and official setup flow',
     ],
   },
   {
@@ -405,8 +483,8 @@ export const REQUIRED_DEPENDENCY_FRESHNESS_AUTOMATION_SNIPPETS = [
   {
     path: '.agent-context/prompts/init-project.md',
     snippets: [
-      'latest stable compatible dependency set and official framework setup flow first',
-      'Prefer official framework setup commands or canonical starter flows',
+      'recommend the latest stable compatible dependency set and official framework setup flow from live official documentation before coding',
+      'Use official framework setup commands or canonical starter flows',
     ],
   },
 ];
@@ -418,13 +496,78 @@ export const FORBIDDEN_TEMPLATE_BOOTSTRAP_SNIPPETS = [
     ],
   },
 ];
+export const FORBIDDEN_ACTIVE_BIAS_ANCHOR_SNIPPETS = [
+  {
+    path: '.instructions.md',
+    snippets: [
+      'illustrative, not exhaustive',
+      'explicitly approved reference systems',
+      'Do not auto-recommend frameworks',
+      'prefer the latest stable compatible dependency set',
+    ],
+  },
+  {
+    path: '.agent-context/prompts/bootstrap-design.md',
+    snippets: [
+      'stylistic inspiration',
+      'famous brand reference',
+      'If no approved reference system exists',
+      'explicitly approved reference systems',
+    ],
+  },
+  {
+    path: '.agent-context/prompts/init-project.md',
+    snippets: [
+      'Compact User Prompt Patterns',
+      'latest stable compatible dependency set and official framework setup flow first',
+      'Prefer official framework setup commands',
+      'ask for confirmation instead of silently choosing a stack',
+    ],
+  },
+  {
+    path: 'lib/cli/project-scaffolder/design-contract.mjs',
+    snippets: [
+      'explicitly-approved-reference-systems',
+      'approvedReferenceUsage',
+    ],
+  },
+  {
+    path: 'lib/cli/constants.mjs',
+    snippets: [
+      'BLUEPRINT_RECOMMENDATIONS',
+      `java-${'enter'}${'prise'}-api`,
+      `dotnet-${'enter'}${'prise'}-api`,
+    ],
+  },
+  {
+    path: 'lib/cli/init-detection-flow.mjs',
+    snippets: [
+      `Using detected ${'stack'} automatically`,
+      `Use detected ${'setup'} for this existing project?`,
+      'Override detected stack',
+    ],
+  },
+  {
+    path: 'scripts/ui-design-judge/prompting.mjs',
+    snippets: [
+      '"recommendation": string',
+    ],
+  },
+  {
+    path: 'scripts/documentation-boundary-audit.mjs',
+    snippets: [
+      'suggestedActions',
+      'suggestedDocumentationUpdates',
+    ],
+  },
+];
 export const REQUIRED_DETERMINISTIC_BOUNDARY_ENFORCEMENT_SNIPPETS = [
   {
     path: 'scripts/documentation-boundary-audit.mjs',
     snippets: [
       'reportVersion',
       'violations',
-      'suggestedActions',
+      'requiredActions',
       'diagnosticCode',
       'autoDocsSyncScope',
       'rolloutMetrics',
@@ -440,7 +583,7 @@ export const REQUIRED_DETERMINISTIC_BOUNDARY_ENFORCEMENT_SNIPPETS = [
       'diagnostics.documentationBoundaryAudit',
       'auto-docs-sync-scope-phase1',
       'auto-docs-sync-rollout-metrics',
-      'ui-design-judge-hybrid-diagnostics',
+      'ui-design-judge-structured-diagnostics',
     ],
   },
 ];

package/scripts/validate/coverage-checks.mjs

@@ -3,6 +3,7 @@ import { join, relative } from 'node:path';
 import {
   COMPLIANCE_ALIAS_TERMS,
   COMPLIANCE_TERMINOLOGY_BOUNDARY_PATHS,
+  FORBIDDEN_ACTIVE_BIAS_ANCHOR_SNIPPETS,
   FORMAL_ARTIFACT_PATHS,
   FORBIDDEN_TEMPLATE_BOOTSTRAP_SNIPPETS,
   REQUIRED_COMPLIANCE_CANONICAL_SNIPPETS,
@@ -12,7 +13,7 @@ import {
   REQUIRED_DEVELOPER_FIRST_MENTION_PATTERNS,
   REQUIRED_DOCKER_RUNTIME_AUTOMATION_SNIPPETS,
   REQUIRED_HUMAN_WRITING_SNIPPETS,
-  REQUIRED_STACK_RESEARCH_ENGINE_SNIPPETS,
+  REQUIRED_STACK_DECISION_BOUNDARY_SNIPPETS,
   REQUIRED_TEMPLATE_FREE_BOOTSTRAP_SNIPPETS,
   REQUIRED_TERMINOLOGY_ROW_PATTERNS,
   REQUIRED_TERMINOLOGY_RULE_SNIPPET,
@@ -86,7 +87,7 @@ export async function validateTerminologyMapping(context) {
       fail(`${TERMINOLOGY_REFERENCE_DOCUMENT_PATH} must define first-mention canonical term rule`);
     }
 
-    if (terminologyReferenceContent.includes('Compliance and audit artifacts must keep canonical enterprise terminology')) {
+    if (terminologyReferenceContent.includes('Formal policy and audit artifacts must keep canonical terminology')) {
       pass(`${TERMINOLOGY_REFERENCE_DOCUMENT_PATH} defines compliance terminology boundary`);
     } else {
       fail(`${TERMINOLOGY_REFERENCE_DOCUMENT_PATH} must define compliance terminology boundary`);
@@ -191,12 +192,12 @@ export async function validateDetectionTransparencyCoverage(context) {
   });
 }
 
-export async function validateStackResearchEngineCoverage(context) {
+export async function validateStackDecisionBoundaryCoverage(context) {
   await validateSnippetCoverage({
-    heading: 'Checking stack research engine coverage...',
-    coverageRules: REQUIRED_STACK_RESEARCH_ENGINE_SNIPPETS,
-    missingLabel: 'stack research source',
-    snippetLabel: 'stack research snippet',
+    heading: 'Checking stack decision boundary coverage...',
+    coverageRules: REQUIRED_STACK_DECISION_BOUNDARY_SNIPPETS,
+    missingLabel: 'stack decision boundary source',
+    snippetLabel: 'stack decision boundary snippet',
     context,
   });
 }
@@ -303,6 +304,30 @@ export async function validateDeterministicBoundaryEnforcementCoverage(context)
   });
 }
 
+export async function validateRulesOnlyActiveSurfaceCoverage(context) {
+  const { ROOT_DIR, fileExists, readTextFile, pass, fail } = context;
+
+  console.log('\nChecking rules-only active surface cleanup...');
+
+  for (const forbiddenRule of FORBIDDEN_ACTIVE_BIAS_ANCHOR_SNIPPETS) {
+    const absoluteForbiddenPath = join(ROOT_DIR, forbiddenRule.path);
+
+    if (!(await fileExists(absoluteForbiddenPath))) {
+      fail(`Missing rules-only active surface source: ${forbiddenRule.path}`);
+      continue;
+    }
+
+    const forbiddenContent = await readTextFile(absoluteForbiddenPath);
+    for (const forbiddenSnippet of forbiddenRule.snippets) {
+      if (forbiddenContent.includes(forbiddenSnippet)) {
+        fail(`${forbiddenRule.path} must not include active bias-anchor snippet: ${forbiddenSnippet}`);
+      } else {
+        pass(`${forbiddenRule.path} excludes active bias-anchor snippet: ${forbiddenSnippet}`);
+      }
+    }
+  }
+}
+
 export async function validateHumanWritingGovernance(context) {
   const { ROOT_DIR, fileExists, readTextFile, pass, fail } = context;
 

package/scripts/validate.mjs

@@ -19,7 +19,6 @@ import { fileURLToPath } from 'node:url';
 import {
   ALLOWED_SEVERITIES,
   OVERRIDE_WARNING_WINDOW_DAYS,
-  REQUIRED_STACK_RESEARCH_ENGINE_SNIPPETS,
 } from './validate/config.mjs';
 import {
   validateDependencyFreshnessAutomationCoverage,
@@ -28,8 +27,9 @@ import {
   validateDockerRuntimeAutomationCoverage,
   validateHumanWritingGovernance,
   validateInstructionAdapters,
+  validateRulesOnlyActiveSurfaceCoverage,
   validateSkillPurgeSurface,
-  validateStackResearchEngineCoverage,
+  validateStackDecisionBoundaryCoverage,
   validateTemplateFreeBootstrapCoverage,
   validateTerminologyMapping,
   validateUiDesignAutomationCoverage,
@@ -137,6 +137,9 @@ async function validateRequiredFiles() {
     'scripts/docs-quality-drift-report.mjs',
     'scripts/governance-weekly-report.mjs',
     'scripts/mcp-server.mjs',
+    'scripts/mcp-server/constants.mjs',
+    'scripts/mcp-server/tool-registry.mjs',
+    'scripts/mcp-server/tools.mjs',
     'scripts/frontend-usability-audit.mjs',
     'scripts/ui-design-judge.mjs',
     'scripts/documentation-boundary-audit.mjs',
@@ -180,7 +183,7 @@ async function validateRequiredFiles() {
     'tests/cli-smoke.test.mjs',
     'tests/mcp-server.test.mjs',
     'tests/llm-judge.test.mjs',
-    'tests/enterprise-ops.test.mjs',
+    'tests/operations.test.mjs',
     'LICENSE',
     '.gitignore',
   ];
@@ -700,7 +703,7 @@ async function main() {
   await validateDocumentationFlow();
   await validateTerminologyMapping(coverageValidationContext);
   await validateDetectionTransparencyCoverage(coverageValidationContext);
-  await validateStackResearchEngineCoverage(coverageValidationContext);
+  await validateStackDecisionBoundaryCoverage(coverageValidationContext);
   await validateUniversalSopConsolidationCoverage(coverageValidationContext);
   await validateTemplateFreeBootstrapCoverage(coverageValidationContext);
   await validateUpgradeUiContractWarningCoverage(coverageValidationContext);
@@ -708,6 +711,7 @@ async function main() {
   await validateDockerRuntimeAutomationCoverage(coverageValidationContext);
   await validateDependencyFreshnessAutomationCoverage(coverageValidationContext);
   await validateDeterministicBoundaryEnforcementCoverage(coverageValidationContext);
+  await validateRulesOnlyActiveSurfaceCoverage(coverageValidationContext);
   await validateStackResearchSnapshotState();
   await validateMcpConfiguration();
   await validateHumanWritingGovernance(coverageValidationContext);