@ryuenn3123/agentic-senior-core 4.3.2 → 4.3.5

package/scripts/validate/config.mjs

@@ -21,16 +21,7 @@ export const FORMAL_ARTIFACT_PATHS = [
   'GEMINI.md',
 ];
 export const REQUIRED_HUMAN_WRITING_SNIPPETS = [
-  {
-    path: '.agent-context/rules/api-docs.md',
-    snippets: [
-      '## API-006: Human Writing Standard (Mandatory)',
-      'This applies to documentation, release notes, onboarding text, review summaries, and agent-facing explanations.',
-      'Style baseline findings are advisory by default and must not block endpoint-change commits that already include accurate docs/spec updates.',
-      'Write formal project docs in English by default',
-      'No emoji in formal artifacts.',
-    ],
-  },
+  
   {
     path: '.agent-context/review-checklists/pr-checklist.md',
     snippets: [
@@ -161,18 +152,8 @@ export const REQUIRED_STACK_DECISION_BOUNDARY_SNIPPETS = [
       'produce a short evidence-backed recommendation from the brief, repo evidence, and live official documentation before coding',
     ],
   },
-  {
-    path: '.agent-context/rules/architecture.md',
-    snippets: [
-      '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: [
@@ -192,16 +173,7 @@ export const REQUIRED_UNIVERSAL_SOP_SNIPPETS = [
       'Do not write application, firmware, or UI code',
     ],
   },
-  {
-    path: '.agent-context/rules/architecture.md',
-    snippets: [
-      '## ARCH-003: Universal SOP Baseline (Mandatory)',
-      'Root `README.md` must exist for every fresh or existing project',
-      '`docs/doc-index.md` must exist whenever `docs/` exists',
-      'Security and testing are non-negotiable baseline requirements.',
-      'If required project context docs are missing, stop implementation and bootstrap docs before writing application code.',
-    ],
-  },
+  
   {
     path: '.agent-context/prompts/init-project.md',
     snippets: [
@@ -252,20 +224,12 @@ export const REQUIRED_UNIVERSAL_SOP_SNIPPETS = [
       'Documentation-first policy:',
       'Keep README.md public and developer friendly',
       'For docs-only/docs-first requests, do not write application, firmware, or UI code until the user asks or approves an implementation plan.',
-      'For UI scope: if docs/DESIGN.md or docs/design-intent.json is missing, execute bootstrap-design prompt before implementing UI surfaces.',
+      'Follow the three-step design direction process in bootstrap-design.md',
     ],
   },
 ];
 export const REQUIRED_DIAGRAM_FORMAT_SNIPPETS = [
-  {
-    path: '.agent-context/rules/api-docs.md',
-    snippets: [
-      '## API-013: Documentation Diagram Format (Mandatory)',
-      'Mermaid.js as the default diagram format',
-      'Do not use PlantUML',
-      'convert the relevant sections to Mermaid diagrams in the same change',
-    ],
-  },
+  
   {
     path: 'lib/cli/project-scaffolder/prompt-builders.mjs',
     snippets: [
@@ -303,18 +267,9 @@ export const REQUIRED_UPGRADE_UI_CONTRACT_WARNING_SNIPPETS = [
     path: 'lib/cli/commands/upgrade.mjs',
     snippets: [
       'UI/frontend scope was detected, but the dynamic design contract is incomplete:',
-      'docs/design-intent.json',
-      'Planned seed on apply: docs/design-intent.json',
-      'Upgrade synchronizes governance assets and can seed docs/design-intent.json, but it does not author project-specific docs/DESIGN.md automatically.',
       'detectUiScopeSignals',
     ],
   },
-  {
-    path: 'lib/cli/commands/upgrade/design-intent-seed.mjs',
-    snippets: [
-      'seed-generated-during-upgrade',
-    ],
-  },
 ];
 export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
   {
@@ -324,19 +279,12 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       'bootstrap-design.md',
       'frontend-architecture.md',
       'docs/DESIGN.md',
-      'docs/design-intent.json',
       'Documentation-First Mode',
       'English by default',
       'do not write application, firmware, or UI code',
-      'Motion/Palette Decision',
-      'product categories are heuristics',
+      'three-step direction process',
+      'anti-repeat ledger',
       'perform live web research',
-      'research-design.md',
-      'researchDossier.metadata',
-      'researchVerifiedAt',
-      'freshnessWindowDays',
-      'Anti-repeat ledger',
-      'user-explicit redesign',
     ],
   },
   {
@@ -346,8 +294,6 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       'UI Design Mode',
       'bootstrap-design.md',
       'frontend-architecture.md',
-      'Motion/Palette Decision',
-      'product categories are heuristics',
       'do not eagerly load unrelated backend-only rules',
       'valid style context',
       'External references, prior-chat memory, unrelated-project visuals, and remembered screenshots are tainted',
@@ -358,63 +304,16 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
   {
     path: '.agent-context/prompts/bootstrap-design.md',
     snippets: [
-      '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',
-      '`repoEvidence.designEvidenceSummary`',
-      'Responsive Recomposition Plan',
-      'source of truth',
+      'WCAG 2.2 AA is the hard compliance floor',
+      'Name Your Defaults',
+      'Choose an Anchor',
+      'Creative Commitments',
+      'anti-repeat ledger',
+      'Named Defaults to Avoid',
+      'Post-Implementation Check',
+      'Redesign Protocol',
       'research current official docs',
-      'motionPaletteDecision',
-      'AI-safe UI',
-      'Creative Ambition Floor',
-      'AI Color and Template Residue Audit',
-      'Motion and 3D Courage Rule',
-      'Design Flexibility Layer',
-      'visually exploratory, product-derived palettes',
-      'decorative grid wallpaper',
-      '`aiSafeUiAudit`',
-      'AI color drift',
-      'first-class UI options',
-      'product categories are heuristics',
-      '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',
-      'Dynamic UI Foundation Selection',
-      'Adaptive Research Freshness',
-      'fixed calendar range',
-      'research vocabulary internal',
-      'locked outcomes from flexible expression',
-      'A new dependency, package count, or vague performance concern is not a blocker by itself.',
-      'default component-kit styling without product rationale',
-      'genericity findings that cannot name the exact drift signal',
-      'research-design.md',
-      'Section 3 gate from `research-design.md`',
-      'Pre-Emit Identity Check',
-    ],
-  },
-  {
-    path: '.agent-context/prompts/research-design.md',
-    snippets: [
-      '# Research-Design Brief',
-      '## Section 3 — Creative Direction',
-      '### 3a. Category defaults to avoid',
-      '### 3b. Anchor reference',
-      '### 3c. Four creative commitments',
-      'AI slop',
-      'Anti-Repeat Ledger Gate',
-      'Live Source Freshness Gate',
-      'rolling-current',
-      'evidenceTable[]',
-      'old-timeless',
-      'Research vocabulary is internal-only',
-      'previousAnchors',
-      'previousMotionSignatures',
-      'tokenContinuityClassification',
-      'categoryCodes',
+      'product-specific reason',
     ],
   },
   {
@@ -566,8 +465,7 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
       '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',
+      'three-step design direction process in bootstrap-design.md',
       'designEvidenceSummary',
     ],
   },
@@ -580,18 +478,7 @@ export const REQUIRED_DOCKER_RUNTIME_AUTOMATION_SNIPPETS = [
       'For Docker or Compose work, load `docker-runtime.md` and verify the latest official Docker docs before authoring container assets.',
     ],
   },
-  {
-    path: '.agent-context/rules/docker-runtime.md',
-    snippets: [
-      'latest official Docker documentation first',
-      'Docker Compose Quickstart',
-      'Compose file reference',
-      'Dockerfile best practices',
-      'Use current `docker compose` workflows and `compose.yaml`.',
-      'Do not add the top-level Compose `version` field by default.',
-      'Use the latest stable compatible Docker base image',
-    ],
-  },
+  
   {
     path: '.agent-context/prompts/init-project.md',
     snippets: [
@@ -607,17 +494,7 @@ export const REQUIRED_DEPENDENCY_FRESHNESS_AUTOMATION_SNIPPETS = [
       'use the latest stable compatible dependency set and official setup flow',
     ],
   },
-  {
-    path: '.agent-context/rules/efficiency-vs-hype.md',
-    snippets: [
-      'Latest-Compatible-First Rule',
-      'latest stable compatible dependency version',
-      'official scaffolder or setup command',
-      'Only step down to an older dependency version after documenting',
-      'Do not treat dependency avoidance as an engineering virtue by itself.',
-      'performance-fear choices',
-    ],
-  },
+  
   {
     path: '.agent-context/prompts/init-project.md',
     snippets: [
@@ -649,7 +526,6 @@ export const FORBIDDEN_ACTIVE_BIAS_ANCHOR_SNIPPETS = [
     snippets: [
       'stylistic inspiration',
       'famous brand reference',
-      'If no approved reference system exists',
       'explicitly approved reference systems',
     ],
   },

package/scripts/validate/coverage-checks.mjs

@@ -360,13 +360,9 @@ export async function validateInstructionAdapters(context) {
     'unreachable_files',
     'validation_plan',
   ];
-  const requiredUiReadabilitySnippets = [
-    'Motion/Palette Decision',
-    'product categories are heuristics',
-  ];
   const instructionFootprintLimits = [
     { path: 'AGENTS.md', maxLines: 180 },
-    { path: '.agent-context/prompts/bootstrap-design.md', maxLines: 235 },
+    { path: '.agent-context/prompts/bootstrap-design.md', maxLines: 80 },
     { path: '.agent-context/rules/frontend-architecture.md', maxLines: 180 },
   ];
 
@@ -378,13 +374,7 @@ export async function validateInstructionAdapters(context) {
     }
   }
 
-  for (const requiredUiReadabilitySnippet of requiredUiReadabilitySnippets) {
-    if (canonicalInstructionContent.includes(requiredUiReadabilitySnippet)) {
-      pass(`AGENTS.md includes UI readability snippet: ${requiredUiReadabilitySnippet}`);
-    } else {
-      fail(`AGENTS.md is missing UI readability snippet: ${requiredUiReadabilitySnippet}`);
-    }
-  }
+
 
   for (const footprintLimit of instructionFootprintLimits) {
     const absoluteFootprintPath = join(ROOT_DIR, footprintLimit.path);

package/scripts/validate/file-structure.mjs

@@ -0,0 +1,165 @@
+import { join } from 'node:path';
+import { readdir } from 'node:fs/promises';
+
+export async function validateRequiredFiles(context) {
+  const { ROOT_DIR, fileExists, pass, fail } = context;
+  console.log('\nChecking required files...');
+
+  const requiredFiles = [
+    'bin/agentic-senior-core.js',
+    'scripts/validate.mjs',
+    'scripts/llm-judge.mjs',
+    'scripts/detection-benchmark.mjs',
+    'scripts/benchmark-evidence-bundle.mjs',
+    'scripts/benchmark-writer-judge-matrix.mjs',
+    'scripts/benchmark-gate.mjs',
+    'scripts/benchmark-intelligence.mjs',
+    'scripts/memory-continuity-benchmark.mjs',
+    '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',
+    'scripts/context-triggered-audit.mjs',
+    'scripts/rules-guardian-audit.mjs',
+    'scripts/explain-on-demand-audit.mjs',
+    'scripts/single-source-lazy-loading-audit.mjs',
+    'scripts/audit-cache-layer-contract.mjs',
+    'scripts/audit-typography-palette-anti-repeat.mjs',
+    'lib/cli/audits/typography-palette-anti-repeat-audit.mjs',
+    'lib/cli/commands/audit-design-anti-repeat.mjs',
+    'scripts/sync-thin-adapters.mjs',
+    'scripts/release-gate.mjs',
+    'scripts/generate-sbom.mjs',
+    '.agent-context/policies/llm-judge-threshold.json',
+    '.agent-context/prompts/compact-natural-mode.md',
+    'mcp.json',
+    'AGENTS.md',
+    'CLAUDE.md',
+    'GEMINI.md',
+    'README.md',
+    'CHANGELOG.md',
+    'docs/doc-index.md',
+    'docs/project-brief.md',
+    'docs/flow-overview.md',
+    'docs/api-contract.md',
+    'docs/faq.md',
+    'docs/deep-dive.md',
+    'docs/archive/HISTORY.md',
+    'docs/archive/CHANGELOG-archive.md',
+    '.agent-context/state/benchmark-reproducibility.json',
+    '.agent-context/state/benchmark-writer-judge-config.json',
+    '.agent-context/state/memory-schema-v1.json',
+    '.agent-context/state/memory-adapter-contract.json',
+    '.vscode/mcp.json',
+    '.github/workflows/release-gate.yml',
+    '.github/workflows/sbom-compliance.yml',
+    '.github/workflows/benchmark-intelligence.yml',
+    '.github/workflows/docs-quality-drift-report.yml',
+    '.github/workflows/governance-weekly-report.yml',
+    'tests/cli-smoke.test.mjs',
+    'tests/mcp-server.test.mjs',
+    'tests/llm-judge.test.mjs',
+    'tests/operations.test.mjs',
+    'LICENSE',
+    '.gitignore',
+  ];
+
+  for (const requiredFilePath of requiredFiles) {
+    const absoluteRequiredFilePath = join(ROOT_DIR, requiredFilePath);
+
+    if (await fileExists(absoluteRequiredFilePath)) {
+      pass(requiredFilePath);
+      continue;
+    }
+
+    fail(`Missing required file: ${requiredFilePath}`);
+  }
+}
+
+export async function validateRuleFiles(context) {
+  const { AGENT_CONTEXT_DIR, fileExists, readTextFile, pass, fail } = context;
+  console.log('\nChecking rule, checklist, prompt, and state files...');
+
+  const expectedPaths = [
+    'rules/naming-conv.md',
+    'rules/architecture.md',
+    'rules/security.md',
+    'rules/performance.md',
+    'rules/error-handling.md',
+    'rules/testing.md',
+    'rules/git-workflow.md',
+    'rules/efficiency-vs-hype.md',
+    'rules/api-docs.md',
+    'rules/microservices.md',
+    'rules/event-driven.md',
+    'rules/database-design.md',
+    'rules/realtime.md',
+    'rules/frontend-architecture.md',
+    'rules/docker-runtime.md',
+    'rules/observability.md',
+    'rules/resilience.md',
+    'rules/migrations.md',
+    'rules/background-jobs.md',
+    'rules/config-and-flags.md',
+    'rules/api-versioning.md',
+    'review-checklists/pr-checklist.md',
+    'review-checklists/architecture-review.md',
+    'prompts/init-project.md',
+    'prompts/compact-natural-mode.md',
+    'prompts/bootstrap-design.md',
+    'prompts/refactor.md',
+    'prompts/review-code.md',
+    'state/architecture-map.md',
+    'state/dependency-map.md',
+  ];
+
+  for (const expectedPath of expectedPaths) {
+    const absoluteExpectedPath = join(AGENT_CONTEXT_DIR, expectedPath);
+
+    if (!(await fileExists(absoluteExpectedPath))) {
+      fail(`Missing agent context file: .agent-context/${expectedPath}`);
+      continue;
+    }
+
+    const fileContent = await readTextFile(absoluteExpectedPath);
+    if (fileContent.trim().length < 100) {
+      fail(`Agent context file is suspiciously short: .agent-context/${expectedPath}`);
+      continue;
+    }
+
+    pass(`.agent-context/${expectedPath}`);
+  }
+}
+
+export async function validateChecklistConsolidation(context) {
+  const { AGENT_CONTEXT_DIR, pass, fail } = context;
+  console.log('\nChecking review checklist consolidation...');
+
+  const reviewChecklistDirectoryPath = join(AGENT_CONTEXT_DIR, 'review-checklists');
+  const checklistEntries = await readdir(reviewChecklistDirectoryPath, { withFileTypes: true });
+  const checklistFileNames = checklistEntries
+    .filter((entry) => entry.isFile() && entry.name.endsWith('.md'))
+    .map((entry) => entry.name)
+    .sort((leftName, rightName) => leftName.localeCompare(rightName));
+
+  const expectedChecklistFileNames = ['architecture-review.md', 'pr-checklist.md'];
+
+  if (checklistFileNames.length <= 2) {
+    pass(`Checklist count is consolidated (${checklistFileNames.length}/2)`);
+  } else {
+    fail(`Checklist count exceeds limit (${checklistFileNames.length}/2): ${checklistFileNames.join(', ')}`);
+  }
+
+  for (const expectedChecklistFileName of expectedChecklistFileNames) {
+    if (checklistFileNames.includes(expectedChecklistFileName)) {
+      pass(`Checklist exists: .agent-context/review-checklists/${expectedChecklistFileName}`);
+    } else {
+      fail(`Missing consolidated checklist: .agent-context/review-checklists/${expectedChecklistFileName}`);
+    }
+  }
+}

package/scripts/validate/markdown-content.mjs

@@ -0,0 +1,109 @@
+import { dirname, join, relative, resolve } from 'node:path';
+
+export async function validateMarkdownFiles(context) {
+  const { ROOT_DIR, collectFiles, readTextFile, pass, fail } = context;
+  console.log('\nChecking markdown content...');
+
+  const markdownFilePaths = await collectFiles(ROOT_DIR, (fileName) => fileName.endsWith('.md'));
+
+  for (const markdownFilePath of markdownFilePaths) {
+    const markdownContent = await readTextFile(markdownFilePath);
+    const relativeMarkdownPath = relative(ROOT_DIR, markdownFilePath);
+
+    if (markdownContent.trim().length === 0) {
+      fail(`Empty markdown file: ${relativeMarkdownPath}`);
+      continue;
+    }
+
+    pass(`${relativeMarkdownPath} (${markdownContent.length} chars)`);
+  }
+}
+
+export async function validateCrossReferences(context) {
+  const { ROOT_DIR, collectFiles, readTextFile, fileExists, pass, fail, warn } = context;
+  console.log('\nChecking internal links...');
+
+  const markdownFilePaths = await collectFiles(ROOT_DIR, (fileName) => fileName.endsWith('.md'));
+  const linkPattern = /\[([^\]]*)\]\((?!https?:\/\/|#)([^)]+)\)/g;
+  let checkedLinkCount = 0;
+
+  for (const markdownFilePath of markdownFilePaths) {
+    const markdownContent = await readTextFile(markdownFilePath);
+    const currentFileDirectory = dirname(markdownFilePath);
+    const relativeMarkdownPath = relative(ROOT_DIR, markdownFilePath);
+    let linkMatch = linkPattern.exec(markdownContent);
+
+    while (linkMatch) {
+      const rawLinkTarget = linkMatch[2].split('#')[0];
+      if (rawLinkTarget) {
+        checkedLinkCount += 1;
+        const resolvedLinkPath = resolve(currentFileDirectory, rawLinkTarget);
+
+        if (await fileExists(resolvedLinkPath)) {
+          pass(`${relativeMarkdownPath} → ${linkMatch[2]}`);
+        } else {
+          fail(`Broken link in ${relativeMarkdownPath}: ${linkMatch[2]}`);
+        }
+      }
+
+      linkMatch = linkPattern.exec(markdownContent);
+    }
+  }
+
+  if (checkedLinkCount === 0) {
+    warn('No internal links were found in markdown files');
+  }
+}
+
+export async function validateAgentsManifest(context) {
+  const { ROOT_DIR, readTextFile, fileExists, pass, fail, warn } = context;
+  console.log('\nChecking AGENTS.md manifest links...');
+
+  const agentsContent = await readTextFile(join(ROOT_DIR, 'AGENTS.md'));
+  const fileReferencePattern = /\[`?([^`\]]+)`?\]\(([^)]+)\)/g;
+  let manifestLinkCount = 0;
+  let fileReferenceMatch = fileReferencePattern.exec(agentsContent);
+
+  while (fileReferenceMatch) {
+    const manifestLinkTarget = fileReferenceMatch[2];
+
+    if (!manifestLinkTarget.startsWith('http')) {
+      manifestLinkCount += 1;
+      const resolvedManifestLinkPath = resolve(ROOT_DIR, manifestLinkTarget);
+
+      if (await fileExists(resolvedManifestLinkPath)) {
+        pass(`AGENTS.md → ${manifestLinkTarget}`);
+      } else {
+        fail(`AGENTS.md references missing file: ${manifestLinkTarget}`);
+      }
+    }
+
+    fileReferenceMatch = fileReferencePattern.exec(agentsContent);
+  }
+
+  if (manifestLinkCount === 0) {
+    warn('AGENTS.md does not contain any local manifest links');
+  }
+}
+
+export async function validateDocumentationFlow(context) {
+  const { README_PATH, readTextFile, pass, fail } = context;
+  console.log('\nChecking documentation flow...');
+
+  const readmeContent = await readTextFile(README_PATH);
+  const requiredReadmeSnippets = [
+    'npx @ryuenn3123/agentic-senior-core init',
+    'npm run validate',
+    'docs/faq.md',
+    'docs/deep-dive.md',
+    'docs/archive/HISTORY.md',
+  ];
+
+  for (const requiredReadmeSnippet of requiredReadmeSnippets) {
+    if (readmeContent.includes(requiredReadmeSnippet)) {
+      pass(`README.md mentions ${requiredReadmeSnippet}`);
+    } else {
+      fail(`README.md must mention ${requiredReadmeSnippet}`);
+    }
+  }
+}