@ryuenn3123/agentic-senior-core 2.0.5 → 2.0.8

package/scripts/validate.mjs

@@ -1,865 +1,942 @@
-#!/usr/bin/env node
-
-/**
- * validate.mjs — Repository Integrity Validator
- *
- * Validates the Agentic-Senior-Core repository:
- * - Required files exist
- * - Markdown and JSON documents are readable
- * - Cross-references resolve from the correct source directory
- * - Version references stay consistent for release builds
- * - LLM Judge policy configuration is valid
- *
- * Usage: node scripts/validate.mjs
- */
-
-import { readdir, readFile, stat } from 'node:fs/promises';
-import { dirname, join, relative, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { createHash } from 'node:crypto';
-import { validateSkillTopicContent } from './skill-tier-policy.mjs';
-import { calculateTrustScore } from './trust-scorer.mjs';
-
-const SCRIPT_FILE_PATH = fileURLToPath(import.meta.url);
-const ROOT_DIR = resolve(dirname(SCRIPT_FILE_PATH), '..');
-const AGENT_CONTEXT_DIR = join(ROOT_DIR, '.agent-context');
-const CANONICAL_INSTRUCTION_PATH = join(ROOT_DIR, '.instructions.md');
-const PACKAGE_JSON_PATH = join(ROOT_DIR, 'package.json');
-const CHANGELOG_PATH = join(ROOT_DIR, 'CHANGELOG.md');
-const README_PATH = join(ROOT_DIR, 'README.md');
-const POLICY_FILE_PATH = join(ROOT_DIR, '.agent-context', 'policies', 'llm-judge-threshold.json');
-const OVERRIDE_FILE_PATH = join(ROOT_DIR, '.agent-override.md');
-const SKILLS_DIR = join(AGENT_CONTEXT_DIR, 'skills');
-const GENERATED_RULE_FILES = ['.cursorrules', '.windsurfrules'];
-const ALLOWED_SEVERITIES = new Set(['critical', 'high', 'medium', 'low']);
-const OVERRIDE_WARNING_WINDOW_DAYS = 30;
-const SUPPORTED_COMPATIBILITY_PLATFORMS = new Set(['windows', 'linux', 'macos']);
-const THIN_ADAPTER_PATHS = [
-  'AGENTS.md',
-  '.github/copilot-instructions.md',
-  '.gemini/instructions.md',
-];
-
-const validationResult = {
-  passed: 0,
-  failed: 0,
-  errors: [],
-  warnings: [],
-};
-
-async function fileExists(filePath) {
-  try {
-    await stat(filePath);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-async function readTextFile(filePath) {
-  return readFile(filePath, 'utf8');
-}
-
-async function collectFiles(directoryPath, fileExtensionMatcher) {
-  const matchingFilePaths = [];
-
-  async function walk(currentDirectoryPath) {
-    const directoryEntries = await readdir(currentDirectoryPath, { withFileTypes: true });
-
-    for (const directoryEntry of directoryEntries) {
-      if (
-        directoryEntry.name === '.git'
-        || directoryEntry.name === 'node_modules'
-        || directoryEntry.name === '.agentic-backup'
-        || directoryEntry.name === '.benchmarks'
-      ) {
-        continue;
-      }
-
-      const entryPath = join(currentDirectoryPath, directoryEntry.name);
-
-      if (directoryEntry.isDirectory()) {
-        await walk(entryPath);
-        continue;
-      }
-
-      if (fileExtensionMatcher(directoryEntry.name)) {
-        matchingFilePaths.push(entryPath);
-      }
-    }
-  }
-
-  await walk(directoryPath);
-  return matchingFilePaths;
-}
-
-function pass(message) {
-  validationResult.passed += 1;
-  console.log(`  PASS ${message}`);
-}
-
-function fail(message) {
-  validationResult.failed += 1;
-  validationResult.errors.push(message);
-  console.log(`  FAIL ${message}`);
-}
-
-function warn(message) {
-  validationResult.warnings.push(message);
-  console.log(`  WARN ${message}`);
-}
-
-async function validateRequiredFiles() {
-  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-gate.mjs',
-    'scripts/benchmark-intelligence.mjs',
-    'scripts/frontend-usability-audit.mjs',
-    'scripts/release-gate.mjs',
-    'scripts/generate-sbom.mjs',
-    'scripts/init-project.sh',
-    'scripts/init-project.ps1',
-    '.cursorrules',
-    '.windsurfrules',
-    '.agent-override.md',
-    '.agent-context/policies/llm-judge-threshold.json',
-    'mcp.json',
-    'AGENTS.md',
-    '.github/copilot-instructions.md',
-    '.gemini/instructions.md',
-    'README.md',
-    'CHANGELOG.md',
-    'docs/faq.md',
-    'docs/deep-dive.md',
-    'docs/v1.7-execution-playbook.md',
-    'docs/v1.7-issue-breakdown.md',
-    'docs/v1.8-operations-playbook.md',
-    'docs/v2-upgrade-playbook.md',
-    '.agent-context/state/benchmark-watchlist.json',
-    '.agent-context/state/skill-platform.json',
-    '.agent-context/skills/index.json',
-    '.github/workflows/release-gate.yml',
-    '.github/workflows/sbom-compliance.yml',
-    '.github/workflows/benchmark-intelligence.yml',
-    'tests/cli-smoke.test.mjs',
-    'tests/llm-judge.test.mjs',
-    'tests/enterprise-ops.test.mjs',
-    'LICENSE',
-    '.gitignore',
-    '.agent-context/marketplace/trust-tiers.json',
-  ];
-
-  for (const requiredFilePath of requiredFiles) {
-    const absoluteRequiredFilePath = join(ROOT_DIR, requiredFilePath);
-
-    if (await fileExists(absoluteRequiredFilePath)) {
-      pass(requiredFilePath);
-      continue;
-    }
-
-    fail(`Missing required file: ${requiredFilePath}`);
-  }
-}
-
-async function validateMarkdownFiles() {
-  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)`);
-  }
-}
-
-async function validateRuleFiles() {
-  console.log('\nChecking rule, stack, blueprint, checklist, 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',
-    'stacks/typescript.md',
-    'stacks/python.md',
-    'stacks/java.md',
-    'stacks/php.md',
-    'stacks/go.md',
-    'stacks/csharp.md',
-    'stacks/rust.md',
-    'stacks/ruby.md',
-    'blueprints/api-nextjs.md',
-    'blueprints/nestjs-logic.md',
-    'blueprints/fastapi-service.md',
-    'blueprints/laravel-api.md',
-    'blueprints/spring-boot-api.md',
-    'blueprints/go-service.md',
-    'blueprints/aspnet-api.md',
-    'blueprints/ci-github-actions.md',
-    'blueprints/ci-gitlab.md',
-    'blueprints/observability.md',
-    'blueprints/graphql-grpc-api.md',
-    'blueprints/infrastructure-as-code.md',
-    'blueprints/kubernetes-manifests.md',
-    'profiles/startup.md',
-    'profiles/regulated.md',
-    'profiles/platform.md',
-    'review-checklists/pr-checklist.md',
-    'review-checklists/frontend-usability.md',
-    'review-checklists/frontend-skill-parity.md',
-    'review-checklists/release-operations.md',
-    'review-checklists/security-audit.md',
-    'review-checklists/performance-audit.md',
-    'review-checklists/architecture-review.md',
-    'review-checklists/marketplace-acceptance.md',
-    'skills/README.md',
-    'skills/frontend/README.md',
-    'skills/backend/README.md',
-    'skills/fullstack/README.md',
-    'skills/cli/README.md',
-    'skills/distribution/README.md',
-    'skills/review-quality/README.md',
-    'skills/frontend.md',
-    'skills/backend.md',
-    'skills/fullstack.md',
-    'skills/cli.md',
-    'skills/distribution.md',
-    'skills/review-quality.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}`);
-  }
-}
-
-async function validateSkillTierQuality() {
-  console.log('\nChecking skill tier quality...');
-
-  const skillMarkdownFiles = await collectFiles(SKILLS_DIR, (fileName) => fileName.endsWith('.md'));
-  const scopedSkillTopicFiles = skillMarkdownFiles.filter((skillFilePath) => {
-    if (skillFilePath.endsWith('README.md') || skillFilePath.endsWith('CHANGELOG.md')) {
-      return false;
-    }
-
-    const relativeSkillPath = relative(SKILLS_DIR, skillFilePath);
-    return /[\\/]/.test(relativeSkillPath);
-  });
-
-  for (const skillTopicPath of scopedSkillTopicFiles) {
-    const skillTopicContent = await readTextFile(skillTopicPath);
-    const relativeSkillTopicPath = relative(ROOT_DIR, skillTopicPath);
-    const validationResult = validateSkillTopicContent(skillTopicContent);
-
-    if (!validationResult.isValid) {
-      if (validationResult.reason === 'missing-tier') {
-        fail(`${relativeSkillTopicPath} is missing explicit Tier metadata`);
-        continue;
-      }
-
-      if (validationResult.reason === 'unsupported-tier') {
-        fail(`${relativeSkillTopicPath} has unsupported tier: ${validationResult.detectedTier}`);
-        continue;
-      }
-
-      if (validationResult.reason === 'word-count') {
-        fail(`${relativeSkillTopicPath} tier ${validationResult.detectedTier} must include at least ${validationResult.minimumRules.minWords} words (found ${validationResult.wordCount})`);
-        continue;
-      }
-
-      if (validationResult.reason === 'heading-count') {
-        fail(`${relativeSkillTopicPath} tier ${validationResult.detectedTier} must include at least ${validationResult.minimumRules.minHeadings} section headings (found ${validationResult.headingCount})`);
-        continue;
-      }
-
-      if (validationResult.reason === 'checklist-count') {
-        fail(`${relativeSkillTopicPath} tier ${validationResult.detectedTier} must include at least ${validationResult.minimumRules.minChecklistItems} checklist item(s) (found ${validationResult.checklistCount})`);
-        continue;
-      }
-
-      if (validationResult.reason === 'code-block-count') {
-        fail(`${relativeSkillTopicPath} tier ${validationResult.detectedTier} must include at least ${validationResult.minimumRules.minCodeBlocks} code block(s) (found ${validationResult.codeBlockCount})`);
-        continue;
-      }
-
-      fail(`${relativeSkillTopicPath} failed tier validation`);
-      continue;
-    }
-
-    pass(`${relativeSkillTopicPath} tier ${validationResult.detectedTier} quality gate passed`);
-  }
-}
-
-async function validateSkillCompatibilityManifests() {
-  console.log('\nChecking skill compatibility manifests...');
-
-  const skillDomainEntries = await readdir(SKILLS_DIR, { withFileTypes: true });
-  const skillDomainDirectoryNames = skillDomainEntries
-    .filter((entry) => entry.isDirectory())
-    .map((entry) => entry.name)
-    .sort((leftName, rightName) => leftName.localeCompare(rightName));
-
-  let validManifestCount = 0;
-
-  for (const skillDomainDirectoryName of skillDomainDirectoryNames) {
-    const compatibilityManifestPath = join(
-      SKILLS_DIR,
-      skillDomainDirectoryName,
-      'compatibility-manifest.json'
-    );
-
-    if (!(await fileExists(compatibilityManifestPath))) {
-      fail(`Missing compatibility manifest: .agent-context/skills/${skillDomainDirectoryName}/compatibility-manifest.json`);
-      continue;
-    }
-
-    let parsedCompatibilityManifest;
-    try {
-      parsedCompatibilityManifest = JSON.parse(await readTextFile(compatibilityManifestPath));
-    } catch (error) {
-      fail(`Invalid JSON compatibility manifest for ${skillDomainDirectoryName}: ${error.message}`);
-      continue;
-    }
-
-    if (!Array.isArray(parsedCompatibilityManifest.ides) || parsedCompatibilityManifest.ides.length === 0) {
-      fail(`Compatibility manifest for ${skillDomainDirectoryName} must include non-empty "ides" array`);
-      continue;
-    }
-
-    if (!Array.isArray(parsedCompatibilityManifest.platforms) || parsedCompatibilityManifest.platforms.length === 0) {
-      fail(`Compatibility manifest for ${skillDomainDirectoryName} must include non-empty "platforms" array`);
-      continue;
-    }
-
-    const unsupportedPlatform = parsedCompatibilityManifest.platforms.find(
-      (platformName) => !SUPPORTED_COMPATIBILITY_PLATFORMS.has(platformName)
-    );
-
-    if (unsupportedPlatform) {
-      fail(`Compatibility manifest for ${skillDomainDirectoryName} has unsupported platform: ${unsupportedPlatform}`);
-      continue;
-    }
-
-    if (
-      typeof parsedCompatibilityManifest.nodeMin !== 'string'
-      || !/^\d+(\.\d+)?$/.test(parsedCompatibilityManifest.nodeMin)
-    ) {
-      fail(`Compatibility manifest for ${skillDomainDirectoryName} must include string nodeMin (for example "18" or "18.0")`);
-      continue;
-    }
-
-    validManifestCount += 1;
-    pass(`Compatibility manifest validated: .agent-context/skills/${skillDomainDirectoryName}/compatibility-manifest.json`);
-  }
-
-  if (validManifestCount >= 6) {
-    pass(`Compatibility manifest coverage is valid (${validManifestCount} skill domains)`);
-  } else {
-    fail(`Compatibility manifest coverage is insufficient (${validManifestCount}/6 skill domains)`);
-  }
-}
-
-function stripMarkdownCodeBlocks(markdownText) {
-  return markdownText.replace(/```[\s\S]*?```/g, '');
-}
-
-function parseOverrideExpiryDate(rawExpiryValue) {
-  if (!/^\d{4}-\d{2}-\d{2}$/.test(rawExpiryValue)) {
-    return null;
-  }
-
-  const parsedDate = new Date(`${rawExpiryValue}T00:00:00.000Z`);
-  return Number.isNaN(parsedDate.getTime()) ? null : parsedDate;
-}
-
-async function validateOverrideGovernance() {
-  console.log('\nChecking override governance...');
-
-  const overrideContent = await readTextFile(OVERRIDE_FILE_PATH);
-  const overrideContentWithoutCodeBlocks = stripMarkdownCodeBlocks(overrideContent);
-  const overrideEntryPattern = /\[Rule:\s*([^\]]+)\]([\s\S]*?)(?=\n\[Rule:|$)/g;
-  const overrideEntries = [];
-  let overrideEntryMatch = overrideEntryPattern.exec(overrideContentWithoutCodeBlocks);
-
-  while (overrideEntryMatch) {
-    const ruleName = overrideEntryMatch[1].trim();
-    const entryBody = overrideEntryMatch[2];
-    const ownerMatch = entryBody.match(/(?:^|\n)Owner:\s*(.+)/);
-    const expiryMatch = entryBody.match(/(?:^|\n)Expiry:\s*(.+)/);
-
-    overrideEntries.push({
-      ruleName,
-      owner: ownerMatch ? ownerMatch[1].trim() : '',
-      expiry: expiryMatch ? expiryMatch[1].trim() : '',
-    });
-
-    overrideEntryMatch = overrideEntryPattern.exec(overrideContentWithoutCodeBlocks);
-  }
-
-  if (overrideEntries.length === 0) {
-    pass('No active override entries found; governance baseline remains strict');
-    return;
-  }
-
-  const currentDate = new Date();
-
-  for (const overrideEntry of overrideEntries) {
-    const overrideContextLabel = `[Rule: ${overrideEntry.ruleName}]`;
-
-    if (!overrideEntry.owner) {
-      fail(`${overrideContextLabel} is missing Owner metadata`);
-      continue;
-    }
-
-    pass(`${overrideContextLabel} owner is defined`);
-
-    if (!overrideEntry.expiry) {
-      fail(`${overrideContextLabel} is missing Expiry metadata`);
-      continue;
-    }
-
-    const expiryDate = parseOverrideExpiryDate(overrideEntry.expiry);
-    if (!expiryDate) {
-      fail(`${overrideContextLabel} has invalid Expiry format (expected YYYY-MM-DD)`);
-      continue;
-    }
-
-    const remainingMilliseconds = expiryDate.getTime() - currentDate.getTime();
-    const remainingDays = Math.floor(remainingMilliseconds / (1000 * 60 * 60 * 24));
-
-    if (remainingMilliseconds < 0) {
-      fail(`${overrideContextLabel} is expired (${overrideEntry.expiry})`);
-      continue;
-    }
-
-    pass(`${overrideContextLabel} expiry is valid (${overrideEntry.expiry})`);
-
-    if (remainingDays <= OVERRIDE_WARNING_WINDOW_DAYS) {
-      warn(`${overrideContextLabel} expires in ${remainingDays} day(s); renew or remove soon`);
-    }
-  }
-}
-
-async function validateCrossReferences() {
-  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');
-  }
-}
-
-async function validateAgentsManifest() {
-  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');
-  }
-}
-
-async function validatePackageMetadata() {
-  console.log('\nChecking package metadata...');
-
-  const packageJson = JSON.parse(await readTextFile(PACKAGE_JSON_PATH));
-  const versionPattern = /^\d+\.\d+\.\d+$/;
-
-  if (typeof packageJson.version !== 'string' || !versionPattern.test(packageJson.version)) {
-    fail('package.json version must be a semantic version string');
-  } else {
-    pass(`package.json version ${packageJson.version}`);
-  }
-
-  if (packageJson.scripts?.validate === 'node ./scripts/validate.mjs') {
-    pass('package.json validate script is Node-first');
-  } else {
-    fail('package.json validate script must use node ./scripts/validate.mjs');
-  }
-
-  if (packageJson.scripts?.test) {
-    pass('package.json test script exists');
-  } else {
-    fail('package.json test script is missing');
-  }
-
-  if (packageJson.devDependencies && Object.keys(packageJson.devDependencies).length > 0) {
-    warn('package.json still has devDependencies; review whether they are necessary');
-  } else {
-    pass('package.json has no unnecessary devDependencies');
-  }
-}
-
-async function validatePolicyFile() {
-  console.log('\nChecking LLM Judge policy...');
-
-  const policyContent = await readTextFile(POLICY_FILE_PATH);
-  const parsedPolicy = JSON.parse(policyContent);
-  const selectedProfileName = parsedPolicy.selectedProfile;
-  const profileThresholds = parsedPolicy.profileThresholds;
-
-  if (typeof selectedProfileName !== 'string') {
-    fail('Policy file must define selectedProfile as a string');
-  } else {
-    pass(`LLM Judge selected profile: ${selectedProfileName}`);
-  }
-
-  if (!profileThresholds || typeof profileThresholds !== 'object') {
-    fail('Policy file must define profileThresholds');
-    return;
-  }
-
-  for (const [profileName, profileSettings] of Object.entries(profileThresholds)) {
-    if (!Array.isArray(profileSettings.blockingSeverities)) {
-      fail(`Policy profile ${profileName} must define blockingSeverities`);
-      continue;
-    }
-
-    const invalidSeverity = profileSettings.blockingSeverities.find((severity) => !ALLOWED_SEVERITIES.has(severity));
-    if (invalidSeverity) {
-      fail(`Policy profile ${profileName} uses unsupported severity: ${invalidSeverity}`);
-      continue;
-    }
-
-    pass(`Policy profile ${profileName} blocking severities are valid`);
-  }
-
-  if (typeof profileThresholds[selectedProfileName] === 'object') {
-    pass('Policy selectedProfile points to a valid profile');
-  } else {
-    fail('Policy selectedProfile must match one of the configured profileThresholds');
-  }
-}
-
-async function validateVersionConsistency() {
-  console.log('\nChecking release version consistency...');
-
-  const packageJson = JSON.parse(await readTextFile(PACKAGE_JSON_PATH));
-  const packageVersion = packageJson.version;
-  const changelogContent = await readTextFile(CHANGELOG_PATH);
-
-  if (changelogContent.includes(`## ${packageVersion}`)) {
-    pass(`CHANGELOG.md contains release entry for ${packageVersion}`);
-  } else {
-    fail(`CHANGELOG.md is missing a ## ${packageVersion} heading`);
-  }
-
-  for (const generatedRuleFileName of GENERATED_RULE_FILES) {
-    const generatedRuleContent = await readTextFile(join(ROOT_DIR, generatedRuleFileName));
-
-    if (generatedRuleContent.includes(`Generated by Agentic-Senior-Core CLI v${packageVersion}`)) {
-      pass(`${generatedRuleFileName} matches package version ${packageVersion}`);
-    } else {
-      fail(`${generatedRuleFileName} does not match package version ${packageVersion}`);
-    }
-  }
-}
-
-async function validateDocumentationFlow() {
-  console.log('\nChecking documentation flow...');
-
-  const readmeContent = await readTextFile(README_PATH);
-  const requiredReadmeSnippets = [
-    'GitHub Template',
-    'scripts/init-project.ps1',
-    'scripts/init-project.sh',
-    'npx @ryuenn3123/agentic-senior-core init',
-    'npm run validate',
-    'docs/faq.md',
-    'docs/deep-dive.md',
-    'docs/v2-upgrade-playbook.md',
-  ];
-
-  for (const requiredReadmeSnippet of requiredReadmeSnippets) {
-    if (readmeContent.includes(requiredReadmeSnippet)) {
-      pass(`README.md mentions ${requiredReadmeSnippet}`);
-    } else {
-      fail(`README.md must mention ${requiredReadmeSnippet}`);
-    }
-  }
-}
-
-async function validateMcpConfiguration() {
-  console.log('\nChecking MCP configuration...');
-
-  const mcpConfiguration = JSON.parse(await readTextFile(join(ROOT_DIR, 'mcp.json')));
-  const lintServerCommand = mcpConfiguration.servers?.lint?.command;
-  const testServerCommand = mcpConfiguration.servers?.test?.command;
-
-  if (lintServerCommand === 'node') {
-    pass('MCP lint server uses Node');
-  } else {
-    fail('MCP lint server must use Node');
-  }
-
-  if (testServerCommand === 'node') {
-    pass('MCP test server uses Node');
-  } else {
-    fail('MCP test server must use Node');
-  }
-}
-
-async function validateInstructionAdapters() {
-  console.log('\nChecking instruction adapter consolidation...');
-
-  const canonicalInstructionContent = await readTextFile(CANONICAL_INSTRUCTION_PATH);
-  const canonicalSnapshotHash = createHash('sha256').update(canonicalInstructionContent).digest('hex');
-
-  for (const thinAdapterPath of THIN_ADAPTER_PATHS) {
-    const absoluteAdapterPath = join(ROOT_DIR, thinAdapterPath);
-
-    if (!(await fileExists(absoluteAdapterPath))) {
-      fail(`Missing thin adapter file: ${thinAdapterPath}`);
-      continue;
-    }
-
-    const thinAdapterContent = await readTextFile(absoluteAdapterPath);
-
-    if (
-      thinAdapterContent.includes('Adapter Mode: thin')
-      && thinAdapterContent.includes('Adapter Source: .instructions.md')
-    ) {
-      pass(`${thinAdapterPath} declares thin adapter metadata`);
-    } else {
-      fail(`${thinAdapterPath} must declare Adapter Mode: thin and Adapter Source: .instructions.md`);
-    }
-
-    const hashMatch = thinAdapterContent.match(/Canonical Snapshot SHA256:\s*([a-f0-9]{64})/);
-    if (!hashMatch) {
-      fail(`${thinAdapterPath} must declare Canonical Snapshot SHA256`);
-      continue;
-    }
-
-    if (hashMatch[1] === canonicalSnapshotHash) {
-      pass(`${thinAdapterPath} canonical hash matches .instructions.md`);
-    } else {
-      fail(`${thinAdapterPath} canonical hash drift detected (expected ${canonicalSnapshotHash})`);
-    }
-
-    const thinAdapterLineCount = thinAdapterContent.split(/\r?\n/u).length;
-    if (thinAdapterLineCount <= 80) {
-      pass(`${thinAdapterPath} remains thin (${thinAdapterLineCount} lines)`);
-    } else {
-      fail(`${thinAdapterPath} is too large for thin-adapter mode (${thinAdapterLineCount} lines)`);
-    }
-  }
-}
-
-async function validateTrustTierSchema() {
-  console.log('\nChecking marketplace trust tier schema...');
-
-  const trustTierPath = join(AGENT_CONTEXT_DIR, 'marketplace', 'trust-tiers.json');
-  const trustTierContent = await readTextFile(trustTierPath);
-  const trustTierSchema = JSON.parse(trustTierContent);
-
-  const expectedTierNames = ['verified', 'community', 'experimental'];
-  for (const expectedTierName of expectedTierNames) {
-    if (trustTierSchema.tiers?.[expectedTierName]) {
-      pass(`Trust tier "${expectedTierName}" is defined`);
-    } else {
-      fail(`Trust tier "${expectedTierName}" is missing from trust-tiers.json`);
-    }
-  }
-
-  const scorecardDimensions = trustTierSchema.scorecard?.dimensions;
-  if (!scorecardDimensions || typeof scorecardDimensions !== 'object') {
-    fail('Trust tier scorecard must define dimensions');
-    return;
-  }
-
-  const dimensionNames = Object.keys(scorecardDimensions);
-  let totalWeight = 0;
-
-  for (const dimensionName of dimensionNames) {
-    const dimensionWeight = scorecardDimensions[dimensionName].weight;
-    if (typeof dimensionWeight !== 'number' || dimensionWeight <= 0) {
-      fail(`Scorecard dimension "${dimensionName}" must have a positive weight`);
-      continue;
-    }
-    totalWeight += dimensionWeight;
-    pass(`Scorecard dimension "${dimensionName}" weight: ${dimensionWeight}`);
-  }
-
-  if (totalWeight === 100) {
-    pass(`Scorecard weights sum to 100`);
-  } else {
-    fail(`Scorecard weights must sum to 100 (got ${totalWeight})`);
-  }
-
-  for (const dimensionName of dimensionNames) {
-    const gates = scorecardDimensions[dimensionName].gates;
-    if (!Array.isArray(gates) || gates.length === 0) {
-      fail(`Scorecard dimension "${dimensionName}" must define at least one gate`);
-      continue;
-    }
-    pass(`Scorecard dimension "${dimensionName}" has ${gates.length} gates`);
-  }
-
-  for (const [tierName, tierDefinition] of Object.entries(trustTierSchema.tiers)) {
-    if (typeof tierDefinition.minimumScore !== 'number') {
-      fail(`Tier "${tierName}" must define a numeric minimumScore`);
-      continue;
-    }
-    pass(`Tier "${tierName}" minimumScore: ${tierDefinition.minimumScore}`);
-  }
-}
-
-async function validateEvidenceBundles() {
-  console.log('\nChecking skill evidence bundles and trust scores...');
-  
-  const skillsDir = join(AGENT_CONTEXT_DIR, 'skills');
-  const skillDirs = (await readdir(skillsDir, { withFileTypes: true }))
-      .filter(dirent => dirent.isDirectory())
-      .map(dirent => dirent.name);
-
-  // We only DEMAND evidence from official skills if they want to be considered "Verified".
-  // Let's at least enforce they don't throw errors when scored.
-  // And specifically, 'cli' has a mocked evidence bundle, so it should score Verified.
-  for (const skillName of skillDirs) {
-      if (skillName === 'cli') {
-          try {
-             const result = await calculateTrustScore(join(skillsDir, skillName));
-             if (result.tier === 'verified') {
-                 pass(`Skill "${skillName}" achieved Verified trust tier (Score: ${result.score})`);
-             } else {
-                 fail(`Skill "${skillName}" failed to reach Verified tier. Got ${result.tier} (Score: ${result.score})`);
-                 console.log(result.dimensions);
-             }
-          } catch (err) {
-             fail(`Skill "${skillName}" scorer crashed: ${err.message}`);
-          }
-      } else {
-          try {
-             const result = await calculateTrustScore(join(skillsDir, skillName));
-             pass(`Skill "${skillName}" parses successfully as ${result.tier} tier`);
-          } catch (err) {
-             fail(`Skill "${skillName}" scorer crashed: ${err.message}`);
-          }
-      }
-  }
-}
-
-async function main() {
-  console.log('===============================================');
-  console.log('  Agentic-Senior-Core Repository Validator');
-  console.log('===============================================');
-
-  await validateRequiredFiles();
-  await validateMarkdownFiles();
-  await validateRuleFiles();
-  await validateSkillTierQuality();
-  await validateSkillCompatibilityManifests();
-  await validateOverrideGovernance();
-  await validateAgentsManifest();
-  await validateCrossReferences();
-  await validatePackageMetadata();
-  await validatePolicyFile();
-  await validateVersionConsistency();
-  await validateDocumentationFlow();
-  await validateMcpConfiguration();
-  await validateInstructionAdapters();
-  await validateTrustTierSchema();
-  await validateEvidenceBundles();
-
-  console.log('\n===============================================');
-  console.log('  RESULTS');
-  console.log('===============================================');
-  console.log(`  Passed: ${validationResult.passed}`);
-  console.log(`  Failed: ${validationResult.failed}`);
-  console.log(`  Warnings: ${validationResult.warnings.length}`);
-  console.log('===============================================');
-
-  if (validationResult.failed > 0) {
-    console.log('\nVALIDATION FAILED\n');
-    process.exit(1);
-  }
-
-  console.log('\nALL CHECKS PASSED\n');
-}
-
-main().catch((error) => {
-  console.error('Validator crashed:', error);
-  process.exit(1);
-});
+#!/usr/bin/env node
+
+/**
+ * validate.mjs — Repository Integrity Validator
+ *
+ * Validates the Agentic-Senior-Core repository:
+ * - Required files exist
+ * - Markdown and JSON documents are readable
+ * - Cross-references resolve from the correct source directory
+ * - Version references stay consistent for release builds
+ * - LLM Judge policy configuration is valid
+ *
+ * Usage: node scripts/validate.mjs
+ */
+
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { dirname, join, relative, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createHash } from 'node:crypto';
+import { validateSkillTopicContent } from './skill-tier-policy.mjs';
+import { calculateTrustScore } from './trust-scorer.mjs';
+
+const SCRIPT_FILE_PATH = fileURLToPath(import.meta.url);
+const ROOT_DIR = resolve(dirname(SCRIPT_FILE_PATH), '..');
+const AGENT_CONTEXT_DIR = join(ROOT_DIR, '.agent-context');
+const CANONICAL_INSTRUCTION_PATH = join(ROOT_DIR, '.instructions.md');
+const PACKAGE_JSON_PATH = join(ROOT_DIR, 'package.json');
+const CHANGELOG_PATH = join(ROOT_DIR, 'CHANGELOG.md');
+const README_PATH = join(ROOT_DIR, 'README.md');
+const POLICY_FILE_PATH = join(ROOT_DIR, '.agent-context', 'policies', 'llm-judge-threshold.json');
+const OVERRIDE_FILE_PATH = join(ROOT_DIR, '.agent-override.md');
+const SKILLS_DIR = join(AGENT_CONTEXT_DIR, 'skills');
+const GENERATED_RULE_FILES = ['.cursorrules', '.windsurfrules'];
+const ALLOWED_SEVERITIES = new Set(['critical', 'high', 'medium', 'low']);
+const OVERRIDE_WARNING_WINDOW_DAYS = 30;
+const SUPPORTED_COMPATIBILITY_PLATFORMS = new Set(['windows', 'linux', 'macos']);
+const THIN_ADAPTER_PATHS = [
+  'AGENTS.md',
+  '.github/copilot-instructions.md',
+  '.gemini/instructions.md',
+];
+const FORMAL_ARTIFACT_PATHS = [
+  '.instructions.md',
+  'README.md',
+  'CHANGELOG.md',
+  'docs/deep_analysis_and_roadmap_backlog.md',
+  '.agent-context/rules/api-docs.md',
+  '.agent-context/review-checklists/pr-checklist.md',
+  '.agent-context/prompts/review-code.md',
+  '.agent-context/skills/review-quality.md',
+  'AGENTS.md',
+  '.github/copilot-instructions.md',
+  '.gemini/instructions.md',
+];
+const REQUIRED_HUMAN_WRITING_SNIPPETS = [
+  {
+    path: '.agent-context/rules/api-docs.md',
+    snippets: ['## Human Writing Standard (Mandatory)', 'No emoji in formal artifacts.'],
+  },
+  {
+    path: '.agent-context/review-checklists/pr-checklist.md',
+    snippets: ['No emoji in formal documentation or review summaries', 'Documentation uses plain English and avoids AI cliches'],
+  },
+  {
+    path: 'docs/deep_analysis_and_roadmap_backlog.md',
+    snippets: ['## Part 6: Documentation and Explanation Standards (Mandatory)', 'No emoji in formal artifacts. This is mandatory.'],
+  },
+];
+
+const validationResult = {
+  passed: 0,
+  failed: 0,
+  errors: [],
+  warnings: [],
+};
+
+async function fileExists(filePath) {
+  try {
+    await stat(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function readTextFile(filePath) {
+  return readFile(filePath, 'utf8');
+}
+
+async function collectFiles(directoryPath, fileExtensionMatcher) {
+  const matchingFilePaths = [];
+
+  async function walk(currentDirectoryPath) {
+    const directoryEntries = await readdir(currentDirectoryPath, { withFileTypes: true });
+
+    for (const directoryEntry of directoryEntries) {
+      if (
+        directoryEntry.name === '.git'
+        || directoryEntry.name === 'node_modules'
+        || directoryEntry.name === '.agentic-backup'
+        || directoryEntry.name === '.benchmarks'
+      ) {
+        continue;
+      }
+
+      const entryPath = join(currentDirectoryPath, directoryEntry.name);
+
+      if (directoryEntry.isDirectory()) {
+        await walk(entryPath);
+        continue;
+      }
+
+      if (fileExtensionMatcher(directoryEntry.name)) {
+        matchingFilePaths.push(entryPath);
+      }
+    }
+  }
+
+  await walk(directoryPath);
+  return matchingFilePaths;
+}
+
+function pass(message) {
+  validationResult.passed += 1;
+  console.log(`  PASS ${message}`);
+}
+
+function fail(message) {
+  validationResult.failed += 1;
+  validationResult.errors.push(message);
+  console.log(`  FAIL ${message}`);
+}
+
+function warn(message) {
+  validationResult.warnings.push(message);
+  console.log(`  WARN ${message}`);
+}
+
+function normalizeLineEndings(content) {
+  return content.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+}
+
+async function validateRequiredFiles() {
+  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-gate.mjs',
+    'scripts/benchmark-intelligence.mjs',
+    'scripts/governance-weekly-report.mjs',
+    'scripts/frontend-usability-audit.mjs',
+    'scripts/release-gate.mjs',
+    'scripts/generate-sbom.mjs',
+    'scripts/init-project.sh',
+    'scripts/init-project.ps1',
+    '.cursorrules',
+    '.windsurfrules',
+    '.agent-override.md',
+    '.agent-context/policies/llm-judge-threshold.json',
+    'mcp.json',
+    'AGENTS.md',
+    '.github/copilot-instructions.md',
+    '.gemini/instructions.md',
+    'README.md',
+    'CHANGELOG.md',
+    'docs/faq.md',
+    'docs/deep-dive.md',
+    'docs/v1.7-execution-playbook.md',
+    'docs/v1.7-issue-breakdown.md',
+    'docs/v1.8-operations-playbook.md',
+    'docs/v2-upgrade-playbook.md',
+    '.agent-context/state/benchmark-watchlist.json',
+    '.agent-context/state/skill-platform.json',
+    '.agent-context/skills/index.json',
+    '.github/workflows/release-gate.yml',
+    '.github/workflows/sbom-compliance.yml',
+    '.github/workflows/benchmark-intelligence.yml',
+    '.github/workflows/governance-weekly-report.yml',
+    'tests/cli-smoke.test.mjs',
+    'tests/llm-judge.test.mjs',
+    'tests/enterprise-ops.test.mjs',
+    'LICENSE',
+    '.gitignore',
+    '.agent-context/marketplace/trust-tiers.json',
+  ];
+
+  for (const requiredFilePath of requiredFiles) {
+    const absoluteRequiredFilePath = join(ROOT_DIR, requiredFilePath);
+
+    if (await fileExists(absoluteRequiredFilePath)) {
+      pass(requiredFilePath);
+      continue;
+    }
+
+    fail(`Missing required file: ${requiredFilePath}`);
+  }
+}
+
+async function validateMarkdownFiles() {
+  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)`);
+  }
+}
+
+async function validateRuleFiles() {
+  console.log('\nChecking rule, stack, blueprint, checklist, 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',
+    'stacks/typescript.md',
+    'stacks/python.md',
+    'stacks/java.md',
+    'stacks/php.md',
+    'stacks/go.md',
+    'stacks/csharp.md',
+    'stacks/rust.md',
+    'stacks/ruby.md',
+    'blueprints/api-nextjs.md',
+    'blueprints/nestjs-logic.md',
+    'blueprints/fastapi-service.md',
+    'blueprints/laravel-api.md',
+    'blueprints/spring-boot-api.md',
+    'blueprints/go-service.md',
+    'blueprints/aspnet-api.md',
+    'blueprints/ci-github-actions.md',
+    'blueprints/ci-gitlab.md',
+    'blueprints/observability.md',
+    'blueprints/graphql-grpc-api.md',
+    'blueprints/infrastructure-as-code.md',
+    'blueprints/kubernetes-manifests.md',
+    'profiles/startup.md',
+    'profiles/regulated.md',
+    'profiles/platform.md',
+    'review-checklists/pr-checklist.md',
+    'review-checklists/frontend-usability.md',
+    'review-checklists/frontend-skill-parity.md',
+    'review-checklists/release-operations.md',
+    'review-checklists/security-audit.md',
+    'review-checklists/performance-audit.md',
+    'review-checklists/architecture-review.md',
+    'review-checklists/marketplace-acceptance.md',
+    'skills/README.md',
+    'skills/frontend/README.md',
+    'skills/backend/README.md',
+    'skills/fullstack/README.md',
+    'skills/cli/README.md',
+    'skills/distribution/README.md',
+    'skills/review-quality/README.md',
+    'skills/frontend.md',
+    'skills/backend.md',
+    'skills/fullstack.md',
+    'skills/cli.md',
+    'skills/distribution.md',
+    'skills/review-quality.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}`);
+  }
+}
+
+async function validateSkillTierQuality() {
+  console.log('\nChecking skill tier quality...');
+
+  const skillMarkdownFiles = await collectFiles(SKILLS_DIR, (fileName) => fileName.endsWith('.md'));
+  const scopedSkillTopicFiles = skillMarkdownFiles.filter((skillFilePath) => {
+    if (skillFilePath.endsWith('README.md') || skillFilePath.endsWith('CHANGELOG.md')) {
+      return false;
+    }
+
+    const relativeSkillPath = relative(SKILLS_DIR, skillFilePath);
+    return /[\\/]/.test(relativeSkillPath);
+  });
+
+  for (const skillTopicPath of scopedSkillTopicFiles) {
+    const skillTopicContent = await readTextFile(skillTopicPath);
+    const relativeSkillTopicPath = relative(ROOT_DIR, skillTopicPath);
+    const validationResult = validateSkillTopicContent(skillTopicContent);
+
+    if (!validationResult.isValid) {
+      if (validationResult.reason === 'missing-tier') {
+        fail(`${relativeSkillTopicPath} is missing explicit Tier metadata`);
+        continue;
+      }
+
+      if (validationResult.reason === 'unsupported-tier') {
+        fail(`${relativeSkillTopicPath} has unsupported tier: ${validationResult.detectedTier}`);
+        continue;
+      }
+
+      if (validationResult.reason === 'word-count') {
+        fail(`${relativeSkillTopicPath} tier ${validationResult.detectedTier} must include at least ${validationResult.minimumRules.minWords} words (found ${validationResult.wordCount})`);
+        continue;
+      }
+
+      if (validationResult.reason === 'heading-count') {
+        fail(`${relativeSkillTopicPath} tier ${validationResult.detectedTier} must include at least ${validationResult.minimumRules.minHeadings} section headings (found ${validationResult.headingCount})`);
+        continue;
+      }
+
+      if (validationResult.reason === 'checklist-count') {
+        fail(`${relativeSkillTopicPath} tier ${validationResult.detectedTier} must include at least ${validationResult.minimumRules.minChecklistItems} checklist item(s) (found ${validationResult.checklistCount})`);
+        continue;
+      }
+
+      if (validationResult.reason === 'code-block-count') {
+        fail(`${relativeSkillTopicPath} tier ${validationResult.detectedTier} must include at least ${validationResult.minimumRules.minCodeBlocks} code block(s) (found ${validationResult.codeBlockCount})`);
+        continue;
+      }
+
+      fail(`${relativeSkillTopicPath} failed tier validation`);
+      continue;
+    }
+
+    pass(`${relativeSkillTopicPath} tier ${validationResult.detectedTier} quality gate passed`);
+  }
+}
+
+async function validateSkillCompatibilityManifests() {
+  console.log('\nChecking skill compatibility manifests...');
+
+  const skillDomainEntries = await readdir(SKILLS_DIR, { withFileTypes: true });
+  const skillDomainDirectoryNames = skillDomainEntries
+    .filter((entry) => entry.isDirectory())
+    .map((entry) => entry.name)
+    .sort((leftName, rightName) => leftName.localeCompare(rightName));
+
+  let validManifestCount = 0;
+
+  for (const skillDomainDirectoryName of skillDomainDirectoryNames) {
+    const compatibilityManifestPath = join(
+      SKILLS_DIR,
+      skillDomainDirectoryName,
+      'compatibility-manifest.json'
+    );
+
+    if (!(await fileExists(compatibilityManifestPath))) {
+      fail(`Missing compatibility manifest: .agent-context/skills/${skillDomainDirectoryName}/compatibility-manifest.json`);
+      continue;
+    }
+
+    let parsedCompatibilityManifest;
+    try {
+      parsedCompatibilityManifest = JSON.parse(await readTextFile(compatibilityManifestPath));
+    } catch (error) {
+      fail(`Invalid JSON compatibility manifest for ${skillDomainDirectoryName}: ${error.message}`);
+      continue;
+    }
+
+    if (!Array.isArray(parsedCompatibilityManifest.ides) || parsedCompatibilityManifest.ides.length === 0) {
+      fail(`Compatibility manifest for ${skillDomainDirectoryName} must include non-empty "ides" array`);
+      continue;
+    }
+
+    if (!Array.isArray(parsedCompatibilityManifest.platforms) || parsedCompatibilityManifest.platforms.length === 0) {
+      fail(`Compatibility manifest for ${skillDomainDirectoryName} must include non-empty "platforms" array`);
+      continue;
+    }
+
+    const unsupportedPlatform = parsedCompatibilityManifest.platforms.find(
+      (platformName) => !SUPPORTED_COMPATIBILITY_PLATFORMS.has(platformName)
+    );
+
+    if (unsupportedPlatform) {
+      fail(`Compatibility manifest for ${skillDomainDirectoryName} has unsupported platform: ${unsupportedPlatform}`);
+      continue;
+    }
+
+    if (
+      typeof parsedCompatibilityManifest.nodeMin !== 'string'
+      || !/^\d+(\.\d+)?$/.test(parsedCompatibilityManifest.nodeMin)
+    ) {
+      fail(`Compatibility manifest for ${skillDomainDirectoryName} must include string nodeMin (for example "18" or "18.0")`);
+      continue;
+    }
+
+    validManifestCount += 1;
+    pass(`Compatibility manifest validated: .agent-context/skills/${skillDomainDirectoryName}/compatibility-manifest.json`);
+  }
+
+  if (validManifestCount >= 6) {
+    pass(`Compatibility manifest coverage is valid (${validManifestCount} skill domains)`);
+  } else {
+    fail(`Compatibility manifest coverage is insufficient (${validManifestCount}/6 skill domains)`);
+  }
+}
+
+function stripMarkdownCodeBlocks(markdownText) {
+  return markdownText.replace(/```[\s\S]*?```/g, '');
+}
+
+function parseOverrideExpiryDate(rawExpiryValue) {
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(rawExpiryValue)) {
+    return null;
+  }
+
+  const parsedDate = new Date(`${rawExpiryValue}T00:00:00.000Z`);
+  return Number.isNaN(parsedDate.getTime()) ? null : parsedDate;
+}
+
+async function validateOverrideGovernance() {
+  console.log('\nChecking override governance...');
+
+  const overrideContent = await readTextFile(OVERRIDE_FILE_PATH);
+  const overrideContentWithoutCodeBlocks = stripMarkdownCodeBlocks(overrideContent);
+  const overrideEntryPattern = /\[Rule:\s*([^\]]+)\]([\s\S]*?)(?=\n\[Rule:|$)/g;
+  const overrideEntries = [];
+  let overrideEntryMatch = overrideEntryPattern.exec(overrideContentWithoutCodeBlocks);
+
+  while (overrideEntryMatch) {
+    const ruleName = overrideEntryMatch[1].trim();
+    const entryBody = overrideEntryMatch[2];
+    const ownerMatch = entryBody.match(/(?:^|\n)Owner:\s*(.+)/);
+    const expiryMatch = entryBody.match(/(?:^|\n)Expiry:\s*(.+)/);
+
+    overrideEntries.push({
+      ruleName,
+      owner: ownerMatch ? ownerMatch[1].trim() : '',
+      expiry: expiryMatch ? expiryMatch[1].trim() : '',
+    });
+
+    overrideEntryMatch = overrideEntryPattern.exec(overrideContentWithoutCodeBlocks);
+  }
+
+  if (overrideEntries.length === 0) {
+    pass('No active override entries found; governance baseline remains strict');
+    return;
+  }
+
+  const currentDate = new Date();
+
+  for (const overrideEntry of overrideEntries) {
+    const overrideContextLabel = `[Rule: ${overrideEntry.ruleName}]`;
+
+    if (!overrideEntry.owner) {
+      fail(`${overrideContextLabel} is missing Owner metadata`);
+      continue;
+    }
+
+    pass(`${overrideContextLabel} owner is defined`);
+
+    if (!overrideEntry.expiry) {
+      fail(`${overrideContextLabel} is missing Expiry metadata`);
+      continue;
+    }
+
+    const expiryDate = parseOverrideExpiryDate(overrideEntry.expiry);
+    if (!expiryDate) {
+      fail(`${overrideContextLabel} has invalid Expiry format (expected YYYY-MM-DD)`);
+      continue;
+    }
+
+    const remainingMilliseconds = expiryDate.getTime() - currentDate.getTime();
+    const remainingDays = Math.floor(remainingMilliseconds / (1000 * 60 * 60 * 24));
+
+    if (remainingMilliseconds < 0) {
+      fail(`${overrideContextLabel} is expired (${overrideEntry.expiry})`);
+      continue;
+    }
+
+    pass(`${overrideContextLabel} expiry is valid (${overrideEntry.expiry})`);
+
+    if (remainingDays <= OVERRIDE_WARNING_WINDOW_DAYS) {
+      warn(`${overrideContextLabel} expires in ${remainingDays} day(s); renew or remove soon`);
+    }
+  }
+}
+
+async function validateCrossReferences() {
+  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');
+  }
+}
+
+async function validateAgentsManifest() {
+  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');
+  }
+}
+
+async function validatePackageMetadata() {
+  console.log('\nChecking package metadata...');
+
+  const packageJson = JSON.parse(await readTextFile(PACKAGE_JSON_PATH));
+  const versionPattern = /^\d+\.\d+\.\d+$/;
+
+  if (typeof packageJson.version !== 'string' || !versionPattern.test(packageJson.version)) {
+    fail('package.json version must be a semantic version string');
+  } else {
+    pass(`package.json version ${packageJson.version}`);
+  }
+
+  if (packageJson.scripts?.validate === 'node ./scripts/validate.mjs') {
+    pass('package.json validate script is Node-first');
+  } else {
+    fail('package.json validate script must use node ./scripts/validate.mjs');
+  }
+
+  if (packageJson.scripts?.test) {
+    pass('package.json test script exists');
+  } else {
+    fail('package.json test script is missing');
+  }
+
+  if (packageJson.devDependencies && Object.keys(packageJson.devDependencies).length > 0) {
+    warn('package.json still has devDependencies; review whether they are necessary');
+  } else {
+    pass('package.json has no unnecessary devDependencies');
+  }
+}
+
+async function validatePolicyFile() {
+  console.log('\nChecking LLM Judge policy...');
+
+  const policyContent = await readTextFile(POLICY_FILE_PATH);
+  const parsedPolicy = JSON.parse(policyContent);
+  const selectedProfileName = parsedPolicy.selectedProfile;
+  const profileThresholds = parsedPolicy.profileThresholds;
+
+  if (typeof selectedProfileName !== 'string') {
+    fail('Policy file must define selectedProfile as a string');
+  } else {
+    pass(`LLM Judge selected profile: ${selectedProfileName}`);
+  }
+
+  if (!profileThresholds || typeof profileThresholds !== 'object') {
+    fail('Policy file must define profileThresholds');
+    return;
+  }
+
+  for (const [profileName, profileSettings] of Object.entries(profileThresholds)) {
+    if (!Array.isArray(profileSettings.blockingSeverities)) {
+      fail(`Policy profile ${profileName} must define blockingSeverities`);
+      continue;
+    }
+
+    const invalidSeverity = profileSettings.blockingSeverities.find((severity) => !ALLOWED_SEVERITIES.has(severity));
+    if (invalidSeverity) {
+      fail(`Policy profile ${profileName} uses unsupported severity: ${invalidSeverity}`);
+      continue;
+    }
+
+    pass(`Policy profile ${profileName} blocking severities are valid`);
+  }
+
+  if (typeof profileThresholds[selectedProfileName] === 'object') {
+    pass('Policy selectedProfile points to a valid profile');
+  } else {
+    fail('Policy selectedProfile must match one of the configured profileThresholds');
+  }
+}
+
+async function validateVersionConsistency() {
+  console.log('\nChecking release version consistency...');
+
+  const packageJson = JSON.parse(await readTextFile(PACKAGE_JSON_PATH));
+  const packageVersion = packageJson.version;
+  const changelogContent = await readTextFile(CHANGELOG_PATH);
+
+  if (changelogContent.includes(`## ${packageVersion}`)) {
+    pass(`CHANGELOG.md contains release entry for ${packageVersion}`);
+  } else {
+    fail(`CHANGELOG.md is missing a ## ${packageVersion} heading`);
+  }
+
+  for (const generatedRuleFileName of GENERATED_RULE_FILES) {
+    const generatedRuleContent = await readTextFile(join(ROOT_DIR, generatedRuleFileName));
+
+    if (generatedRuleContent.includes(`Generated by Agentic-Senior-Core CLI v${packageVersion}`)) {
+      pass(`${generatedRuleFileName} matches package version ${packageVersion}`);
+    } else {
+      fail(`${generatedRuleFileName} does not match package version ${packageVersion}`);
+    }
+  }
+}
+
+async function validateDocumentationFlow() {
+  console.log('\nChecking documentation flow...');
+
+  const readmeContent = await readTextFile(README_PATH);
+  const requiredReadmeSnippets = [
+    'GitHub Template',
+    'scripts/init-project.ps1',
+    'scripts/init-project.sh',
+    'npx @ryuenn3123/agentic-senior-core init',
+    'npm run validate',
+    'docs/faq.md',
+    'docs/deep-dive.md',
+    'docs/v2-upgrade-playbook.md',
+  ];
+
+  for (const requiredReadmeSnippet of requiredReadmeSnippets) {
+    if (readmeContent.includes(requiredReadmeSnippet)) {
+      pass(`README.md mentions ${requiredReadmeSnippet}`);
+    } else {
+      fail(`README.md must mention ${requiredReadmeSnippet}`);
+    }
+  }
+}
+
+async function validateMcpConfiguration() {
+  console.log('\nChecking MCP configuration...');
+
+  const mcpConfiguration = JSON.parse(await readTextFile(join(ROOT_DIR, 'mcp.json')));
+  const lintServerCommand = mcpConfiguration.servers?.lint?.command;
+  const testServerCommand = mcpConfiguration.servers?.test?.command;
+
+  if (lintServerCommand === 'node') {
+    pass('MCP lint server uses Node');
+  } else {
+    fail('MCP lint server must use Node');
+  }
+
+  if (testServerCommand === 'node') {
+    pass('MCP test server uses Node');
+  } else {
+    fail('MCP test server must use Node');
+  }
+}
+
+async function validateHumanWritingGovernance() {
+  console.log('\nChecking human writing governance...');
+
+  const disallowedEmojiPattern = /[\u2705\u274C\u26A0\u{1F4CC}\u{1F536}\u{1F4CE}\u{1F534}\u{1F7E0}\u{1F7E1}\u{1F7E2}]/u;
+
+  for (const formalArtifactPath of FORMAL_ARTIFACT_PATHS) {
+    const absoluteFormalArtifactPath = join(ROOT_DIR, formalArtifactPath);
+
+    if (!(await fileExists(absoluteFormalArtifactPath))) {
+      fail(`Missing formal artifact for writing governance: ${formalArtifactPath}`);
+      continue;
+    }
+
+    const formalArtifactContent = await readTextFile(absoluteFormalArtifactPath);
+
+    if (disallowedEmojiPattern.test(formalArtifactContent)) {
+      fail(`${formalArtifactPath} contains disallowed emoji symbols in formal text`);
+    } else {
+      pass(`${formalArtifactPath} has no disallowed emoji symbols`);
+    }
+  }
+
+  for (const snippetRule of REQUIRED_HUMAN_WRITING_SNIPPETS) {
+    const absoluteRulePath = join(ROOT_DIR, snippetRule.path);
+    if (!(await fileExists(absoluteRulePath))) {
+      fail(`Missing writing governance source: ${snippetRule.path}`);
+      continue;
+    }
+
+    const writingRuleContent = await readTextFile(absoluteRulePath);
+    for (const requiredSnippet of snippetRule.snippets) {
+      if (writingRuleContent.includes(requiredSnippet)) {
+        pass(`${snippetRule.path} includes writing governance snippet: ${requiredSnippet}`);
+      } else {
+        fail(`${snippetRule.path} is missing writing governance snippet: ${requiredSnippet}`);
+      }
+    }
+  }
+}
+
+async function validateInstructionAdapters() {
+  console.log('\nChecking instruction adapter consolidation...');
+
+  const canonicalInstructionContent = normalizeLineEndings(await readTextFile(CANONICAL_INSTRUCTION_PATH));
+  const canonicalSnapshotHash = createHash('sha256').update(canonicalInstructionContent).digest('hex');
+
+  for (const thinAdapterPath of THIN_ADAPTER_PATHS) {
+    const absoluteAdapterPath = join(ROOT_DIR, thinAdapterPath);
+
+    if (!(await fileExists(absoluteAdapterPath))) {
+      fail(`Missing thin adapter file: ${thinAdapterPath}`);
+      continue;
+    }
+
+    const thinAdapterContent = await readTextFile(absoluteAdapterPath);
+
+    if (
+      thinAdapterContent.includes('Adapter Mode: thin')
+      && thinAdapterContent.includes('Adapter Source: .instructions.md')
+    ) {
+      pass(`${thinAdapterPath} declares thin adapter metadata`);
+    } else {
+      fail(`${thinAdapterPath} must declare Adapter Mode: thin and Adapter Source: .instructions.md`);
+    }
+
+    const hashMatch = thinAdapterContent.match(/Canonical Snapshot SHA256:\s*([a-f0-9]{64})/);
+    if (!hashMatch) {
+      fail(`${thinAdapterPath} must declare Canonical Snapshot SHA256`);
+      continue;
+    }
+
+    if (hashMatch[1] === canonicalSnapshotHash) {
+      pass(`${thinAdapterPath} canonical hash matches .instructions.md`);
+    } else {
+      fail(`${thinAdapterPath} canonical hash drift detected (expected ${canonicalSnapshotHash})`);
+    }
+
+    const thinAdapterLineCount = thinAdapterContent.split(/\r?\n/u).length;
+    if (thinAdapterLineCount <= 80) {
+      pass(`${thinAdapterPath} remains thin (${thinAdapterLineCount} lines)`);
+    } else {
+      fail(`${thinAdapterPath} is too large for thin-adapter mode (${thinAdapterLineCount} lines)`);
+    }
+  }
+}
+
+async function validateTrustTierSchema() {
+  console.log('\nChecking marketplace trust tier schema...');
+
+  const trustTierPath = join(AGENT_CONTEXT_DIR, 'marketplace', 'trust-tiers.json');
+  const trustTierContent = await readTextFile(trustTierPath);
+  const trustTierSchema = JSON.parse(trustTierContent);
+
+  const expectedTierNames = ['verified', 'community', 'experimental'];
+  for (const expectedTierName of expectedTierNames) {
+    if (trustTierSchema.tiers?.[expectedTierName]) {
+      pass(`Trust tier "${expectedTierName}" is defined`);
+    } else {
+      fail(`Trust tier "${expectedTierName}" is missing from trust-tiers.json`);
+    }
+  }
+
+  const scorecardDimensions = trustTierSchema.scorecard?.dimensions;
+  if (!scorecardDimensions || typeof scorecardDimensions !== 'object') {
+    fail('Trust tier scorecard must define dimensions');
+    return;
+  }
+
+  const dimensionNames = Object.keys(scorecardDimensions);
+  let totalWeight = 0;
+
+  for (const dimensionName of dimensionNames) {
+    const dimensionWeight = scorecardDimensions[dimensionName].weight;
+    if (typeof dimensionWeight !== 'number' || dimensionWeight <= 0) {
+      fail(`Scorecard dimension "${dimensionName}" must have a positive weight`);
+      continue;
+    }
+    totalWeight += dimensionWeight;
+    pass(`Scorecard dimension "${dimensionName}" weight: ${dimensionWeight}`);
+  }
+
+  if (totalWeight === 100) {
+    pass(`Scorecard weights sum to 100`);
+  } else {
+    fail(`Scorecard weights must sum to 100 (got ${totalWeight})`);
+  }
+
+  for (const dimensionName of dimensionNames) {
+    const gates = scorecardDimensions[dimensionName].gates;
+    if (!Array.isArray(gates) || gates.length === 0) {
+      fail(`Scorecard dimension "${dimensionName}" must define at least one gate`);
+      continue;
+    }
+    pass(`Scorecard dimension "${dimensionName}" has ${gates.length} gates`);
+  }
+
+  for (const [tierName, tierDefinition] of Object.entries(trustTierSchema.tiers)) {
+    if (typeof tierDefinition.minimumScore !== 'number') {
+      fail(`Tier "${tierName}" must define a numeric minimumScore`);
+      continue;
+    }
+    pass(`Tier "${tierName}" minimumScore: ${tierDefinition.minimumScore}`);
+  }
+}
+
+async function validateEvidenceBundles() {
+  console.log('\nChecking skill evidence bundles and trust scores...');
+  
+  const skillsDir = join(AGENT_CONTEXT_DIR, 'skills');
+  const skillDirs = (await readdir(skillsDir, { withFileTypes: true }))
+      .filter(dirent => dirent.isDirectory())
+      .map(dirent => dirent.name);
+
+  const requiredVerifiedSkillNames = new Set([
+    'cli',
+    'frontend',
+    'fullstack',
+    'distribution',
+    'review-quality',
+  ]);
+
+  for (const skillName of skillDirs) {
+      try {
+         const result = await calculateTrustScore(join(skillsDir, skillName));
+
+         if (requiredVerifiedSkillNames.has(skillName)) {
+           if (result.tier === 'verified') {
+             pass(`Skill "${skillName}" achieved Verified trust tier (Score: ${result.score})`);
+           } else {
+             fail(`Skill "${skillName}" failed to reach Verified tier. Got ${result.tier} (Score: ${result.score})`);
+             continue;
+           }
+
+           continue;
+         }
+
+         pass(`Skill "${skillName}" parses successfully as ${result.tier} tier`);
+      } catch (err) {
+         fail(`Skill "${skillName}" scorer crashed: ${err.message}`);
+      }
+  }
+}
+
+async function main() {
+  console.log('===============================================');
+  console.log('  Agentic-Senior-Core Repository Validator');
+  console.log('===============================================');
+
+  await validateRequiredFiles();
+  await validateMarkdownFiles();
+  await validateRuleFiles();
+  await validateSkillTierQuality();
+  await validateSkillCompatibilityManifests();
+  await validateOverrideGovernance();
+  await validateAgentsManifest();
+  await validateCrossReferences();
+  await validatePackageMetadata();
+  await validatePolicyFile();
+  await validateVersionConsistency();
+  await validateDocumentationFlow();
+  await validateMcpConfiguration();
+  await validateHumanWritingGovernance();
+  await validateInstructionAdapters();
+  await validateTrustTierSchema();
+  await validateEvidenceBundles();
+
+  console.log('\n===============================================');
+  console.log('  RESULTS');
+  console.log('===============================================');
+  console.log(`  Passed: ${validationResult.passed}`);
+  console.log(`  Failed: ${validationResult.failed}`);
+  console.log(`  Warnings: ${validationResult.warnings.length}`);
+  console.log('===============================================');
+
+  if (validationResult.failed > 0) {
+    console.log('\nVALIDATION FAILED\n');
+    process.exit(1);
+  }
+
+  console.log('\nALL CHECKS PASSED\n');
+}
+
+main().catch((error) => {
+  console.error('Validator crashed:', error);
+  process.exit(1);
+});