@ryuenn3123/agentic-senior-core 4.3.14 → 4.4.0

package/scripts/{audit-caching-scope-hygiene.mjs → validate/audits/caching-scope-hygiene.mjs}

@@ -30,7 +30,7 @@ import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const SCRIPT_FILE_PATH = fileURLToPath(import.meta.url);
-const REPOSITORY_ROOT = resolve(dirname(SCRIPT_FILE_PATH), '..');
+const REPOSITORY_ROOT = resolve(dirname(SCRIPT_FILE_PATH), '../../..');
 const ARGS = new Set(process.argv.slice(2));
 const JSON_ONLY = ARGS.has('--json');
 
@@ -232,37 +232,4 @@ export function runCachingScopeHygieneAudit(options = {}) {
   };
 }
 
-function main() {
-  const report = runCachingScopeHygieneAudit();
 
-  if (JSON_ONLY) {
-    process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
-    process.exit(report.passed ? 0 : 1);
-  }
-
-  console.log('===============================================');
-  console.log('  audit:caching-scope-hygiene');
-  console.log('===============================================');
-  console.log(`  Public surfaces scanned: ${report.surfaceCount}`);
-  console.log(`  Caching saving claims:    ${report.totalClaimCount}`);
-  console.log('');
-
-  if (report.passed) {
-    console.log('  All caching saving claims on public surfaces are integration-scoped.');
-    process.stderr.write(`AUDIT_CACHING_SCOPE_HYGIENE_REPORT: ${JSON.stringify({ passed: true, surfaceCount: report.surfaceCount, totalClaimCount: report.totalClaimCount })}\n`);
-    process.exit(0);
-  }
-
-  console.log('  Violations:');
-  for (const violation of report.violations) {
-    console.log(`    [${violation.kind}] ${violation.file}:${violation.line} ${violation.detail}`);
-  }
-  console.log('');
-  console.log(`  ${report.violationCount} violation(s) found.`);
-  process.stderr.write(`AUDIT_CACHING_SCOPE_HYGIENE_REPORT: ${JSON.stringify({ passed: false, violationCount: report.violationCount })}\n`);
-  process.exit(1);
-}
-
-if (process.argv[1] && (import.meta.url === `file://${process.argv[1].replace(/\\/g, '/')}` || process.argv[1].endsWith('audit-caching-scope-hygiene.mjs'))) {
-  main();
-}

package/scripts/{audit-file-size.mjs → validate/audits/file-size.mjs}

@@ -30,7 +30,7 @@ import { dirname, join, relative, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const SCRIPT_FILE_PATH = fileURLToPath(import.meta.url);
-const REPOSITORY_ROOT = resolve(dirname(SCRIPT_FILE_PATH), '..');
+const REPOSITORY_ROOT = resolve(dirname(SCRIPT_FILE_PATH), '../../..');
 
 export const DEFAULT_LOC_THRESHOLD = 500;
 const EXCEPTION_MARKER_PATTERN = /^\s*(?:\/\/|\*)\s*@file-size-exception:\s*(.+?)\s*(?:\*\/\s*)?$/;
@@ -155,65 +155,4 @@ export function runAuditFileSize({ threshold = DEFAULT_LOC_THRESHOLD } = {}) {
   };
 }
 
-function formatHumanLine(prefix, entry) {
-  return `  ${prefix} ${entry.filePath} (${entry.lineCount}/${entry.threshold ?? DEFAULT_LOC_THRESHOLD} LOC)`;
-}
-
-function main() {
-  const report = runAuditFileSize();
-
-  if (JSON_ONLY) {
-    process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
-    process.exit(report.passed ? 0 : 1);
-  }
-
-  console.log('===============================================');
-  console.log('  audit:file-size — 500 LOC enforcement');
-  console.log('===============================================');
-  console.log(`  Threshold: ${report.threshold} LOC`);
-  console.log(`  Scanned: ${report.scannedFileCount} files`);
-  console.log('');
-
-  if (report.exemptedCount > 0) {
-    console.log('  Exempted (declared @file-size-exception):');
-    for (const entry of report.exemptedFiles) {
-      console.log(`    EXEMPT ${entry.filePath} (${entry.lineCount} LOC) — ${entry.reason}`);
-    }
-    console.log('');
-  }
 
-  if (report.violationCount === 0) {
-    console.log('  All files within budget.');
-    process.stderr.write(`AUDIT_FILE_SIZE_REPORT: ${JSON.stringify({
-      passed: true,
-      scannedFileCount: report.scannedFileCount,
-      violationCount: 0,
-      exemptedCount: report.exemptedCount,
-    })}\n`);
-    process.exit(0);
-  }
-
-  console.log('  Violations:');
-  for (const entry of report.violations) {
-    console.log(formatHumanLine('FAIL', { ...entry, threshold: report.threshold }));
-  }
-  console.log('');
-  console.log(`  ${report.violationCount} file(s) exceed the ${report.threshold} LOC threshold.`);
-  console.log('  Either split the file into focused submodules or, when justified,');
-  console.log('  declare an exception in the first 5 lines:');
-  console.log('    // @file-size-exception: <reason>');
-  console.log('');
-
-  process.stderr.write(`AUDIT_FILE_SIZE_REPORT: ${JSON.stringify({
-    passed: false,
-    scannedFileCount: report.scannedFileCount,
-    violationCount: report.violationCount,
-    exemptedCount: report.exemptedCount,
-    violations: report.violations,
-  })}\n`);
-  process.exit(1);
-}
-
-if (import.meta.url === `file://${process.argv[1].replace(/\\/g, '/')}` || process.argv[1].endsWith('audit-file-size.mjs')) {
-  main();
-}

package/scripts/{audit-reflection-citations.mjs → validate/audits/reflection-citations.mjs}

@@ -4,10 +4,10 @@
 import { existsSync, readFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { runRuleIdUniquenessAudit } from './audit-rule-id-uniqueness.mjs';
+import { runRuleIdUniquenessAudit } from './rule-id-uniqueness.mjs';
 
 const SCRIPT_FILE_PATH = fileURLToPath(import.meta.url);
-const REPOSITORY_ROOT = resolve(dirname(SCRIPT_FILE_PATH), '..');
+const REPOSITORY_ROOT = resolve(dirname(SCRIPT_FILE_PATH), '../../..');
 const ARGS = new Set(process.argv.slice(2));
 const JSON_ONLY = ARGS.has('--json');
 const RULE_ID_PATTERN = /\b[A-Z]+-\d{3,4}(?:-[A-Z])?\b/g;
@@ -127,37 +127,4 @@ export function runReflectionCitationAudit(options = {}) {
   };
 }
 
-function main() {
-  const report = runReflectionCitationAudit();
 
-  if (JSON_ONLY) {
-    process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
-    process.exit(report.passed ? 0 : 1);
-  }
-
-  console.log('===============================================');
-  console.log('  audit:reflection-citations');
-  console.log('===============================================');
-  console.log(`  Reflection surfaces: ${report.surfaceCount}`);
-  console.log(`  Known rule IDs:      ${report.knownRuleIdCount}`);
-  console.log('');
-
-  if (report.passed) {
-    console.log('  Reflection citation surfaces are present and all cited rule IDs resolve.');
-    process.stderr.write(`AUDIT_REFLECTION_CITATIONS_REPORT: ${JSON.stringify({ passed: true, surfaceCount: report.surfaceCount, knownRuleIdCount: report.knownRuleIdCount })}\n`);
-    process.exit(0);
-  }
-
-  console.log('  Violations:');
-  for (const violation of report.violations) {
-    console.log(`    [${violation.kind}] ${violation.file}: ${violation.detail}`);
-  }
-  console.log('');
-  console.log(`  ${report.violationCount} violation(s) found.`);
-  process.stderr.write(`AUDIT_REFLECTION_CITATIONS_REPORT: ${JSON.stringify({ passed: false, violationCount: report.violationCount, kinds: [...new Set(report.violations.map((violation) => violation.kind))] })}\n`);
-  process.exit(1);
-}
-
-if (import.meta.url === `file://${process.argv[1].replace(/\\/g, '/')}` || process.argv[1].endsWith('audit-reflection-citations.mjs')) {
-  main();
-}

package/scripts/{audit-release-bundle.mjs → validate/audits/release-bundle.mjs}

@@ -16,7 +16,7 @@ import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const SCRIPT_FILE_PATH = fileURLToPath(import.meta.url);
-const REPOSITORY_ROOT = resolve(dirname(SCRIPT_FILE_PATH), '..');
+const REPOSITORY_ROOT = resolve(dirname(SCRIPT_FILE_PATH), '../../..');
 const ARGS = new Set(process.argv.slice(2));
 const JSON_ONLY = ARGS.has('--json');
 
@@ -132,39 +132,4 @@ function finalizeReport(violations, extras) {
   };
 }
 
-function main() {
-  const report = runReleaseBundleAudit();
 
-  if (JSON_ONLY) {
-    process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
-    process.exit(report.passed ? 0 : 1);
-  }
-
-  console.log('===============================================');
-  console.log('  audit:release-bundle');
-  console.log('===============================================');
-  console.log(`  Bundle path:      ${report.bundlePath}`);
-  console.log(`  Artifact count:   ${report.artifactCount}`);
-  console.log(`  Release target:   ${report.releaseTarget || '(missing)'}`);
-  console.log(`  Release status:   ${report.releaseStatus || '(missing)'}`);
-  console.log('');
-
-  if (report.passed) {
-    console.log('  Release bundle is intact. All artifact hashes match.');
-    process.stderr.write(`AUDIT_RELEASE_BUNDLE_REPORT: ${JSON.stringify({ passed: true, artifactCount: report.artifactCount })}\n`);
-    process.exit(0);
-  }
-
-  console.log('  Violations:');
-  for (const violation of report.violations) {
-    console.log(`    [${violation.kind}] ${violation.detail}`);
-  }
-  console.log('');
-  console.log(`  ${report.violationCount} violation(s) found.`);
-  process.stderr.write(`AUDIT_RELEASE_BUNDLE_REPORT: ${JSON.stringify({ passed: false, violationCount: report.violationCount })}\n`);
-  process.exit(1);
-}
-
-if (process.argv[1] && (import.meta.url === `file://${process.argv[1].replace(/\\/g, '/')}` || process.argv[1].endsWith('audit-release-bundle.mjs'))) {
-  main();
-}

package/scripts/{audit-rule-id-uniqueness.mjs → validate/audits/rule-id-uniqueness.mjs}

@@ -36,7 +36,7 @@ import { fileURLToPath } from 'node:url';
 import { parse as parseYaml } from 'yaml';
 
 const SCRIPT_FILE_PATH = fileURLToPath(import.meta.url);
-const REPOSITORY_ROOT = resolve(dirname(SCRIPT_FILE_PATH), '..');
+const REPOSITORY_ROOT = resolve(dirname(SCRIPT_FILE_PATH), '../../..');
 const RULES_DIRECTORY = join(REPOSITORY_ROOT, '.agent-context', 'rules');
 const PROMPTS_DIRECTORY = join(REPOSITORY_ROOT, '.agent-context', 'prompts');
 const REVIEW_CHECKLISTS_DIRECTORY = join(REPOSITORY_ROOT, '.agent-context', 'review-checklists');
@@ -275,39 +275,4 @@ export function runRuleIdUniquenessAudit() {
   };
 }
 
-function main() {
-  const report = runRuleIdUniquenessAudit();
 
-  if (JSON_ONLY) {
-    process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
-    process.exit(report.passed ? 0 : 1);
-  }
-
-  console.log('===============================================');
-  console.log('  audit:rule-id-uniqueness');
-  console.log('===============================================');
-  console.log(`  Migrated rule files: ${report.migratedFileCount} of ${report.migratedFileCount + report.skippedFileCount} scanned`);
-  console.log(`  Pre-migration files: ${report.skippedFileCount} (no YAML frontmatter, skipped)`);
-  console.log(`  Known section IDs:   ${report.knownSectionIdCount}`);
-  console.log(`  [REF:...] mentions:  ${report.refMentionCount}`);
-  console.log('');
-
-  if (report.violationCount === 0) {
-    console.log('  All migrated files clean. No prefix mismatches, duplicates, ambiguous prose references, or unresolved [REF:] / related: links.');
-    process.stderr.write(`AUDIT_RULE_ID_REPORT: ${JSON.stringify({ passed: true, ...{ migratedFileCount: report.migratedFileCount, knownSectionIdCount: report.knownSectionIdCount, refMentionCount: report.refMentionCount } })}\n`);
-    process.exit(0);
-  }
-
-  console.log('  Violations:');
-  for (const violation of report.violations) {
-    console.log(`    [${violation.kind}] ${violation.file}: ${violation.detail}`);
-  }
-  console.log('');
-  console.log(`  ${report.violationCount} violation(s) found. Phase 1 GATE B requires zero.`);
-  process.stderr.write(`AUDIT_RULE_ID_REPORT: ${JSON.stringify({ passed: false, violationCount: report.violationCount, kinds: [...new Set(report.violations.map((v) => v.kind))] })}\n`);
-  process.exit(1);
-}
-
-if (import.meta.url === `file://${process.argv[1].replace(/\\/g, '/')}` || process.argv[1].endsWith('audit-rule-id-uniqueness.mjs')) {
-  main();
-}

package/scripts/validate/config.mjs

@@ -214,19 +214,6 @@ export const REQUIRED_UNIVERSAL_SOP_SNIPPETS = [
       'docs/api-contract.md',
     ],
   },
-  {
-    path: 'lib/cli/compiler.mjs',
-    snippets: [
-      'Universal SOP hard block policy:',
-      'docs/doc-index.md whenever docs/ exists',
-      'README.md must exist and read as a public and developer entrypoint',
-      'Hard block: do not write application code until docs/project-brief.md and docs/architecture-decision-record.md exist.',
-      '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.',
-      'Follow the three-step design direction process in bootstrap-design.md',
-    ],
-  },
 ];
 export const REQUIRED_DIAGRAM_FORMAT_SNIPPETS = [
   
@@ -384,11 +371,6 @@ export const REQUIRED_UI_DESIGN_AUTOMATION_SNIPPETS = [
   {
     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',
-      'three-step design direction process in bootstrap-design.md',
       'designEvidenceSummary',
     ],
   },

package/scripts/validate/file-structure.mjs

@@ -28,10 +28,6 @@ export async function validateRequiredFiles(context) {
     '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',

package/scripts/validate/utils.mjs

@@ -0,0 +1,52 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+
+export async function fileExists(filePath) {
+  try {
+    await stat(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+export async function readTextFile(filePath) {
+  return readFile(filePath, 'utf8');
+}
+
+export 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;
+}
+
+export function normalizeLineEndings(content) {
+  return content.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+}

package/scripts/validate.mjs

@@ -18,13 +18,13 @@ import { readdir, readFile, stat } from 'node:fs/promises';
 import { dirname, join, relative, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { ALLOWED_SEVERITIES } from './validate/config.mjs';
-import { runCacheLayerContractAudit } from './audit-cache-layer-contract.mjs';
-import { runCachingScopeHygieneAudit } from './audit-caching-scope-hygiene.mjs';
-import { runTypographyPaletteAntiRepeatAudit } from '../lib/cli/audits/typography-palette-anti-repeat-audit.mjs';
-import { runAuditFileSize } from './audit-file-size.mjs';
-import { runReflectionCitationAudit } from './audit-reflection-citations.mjs';
-import { runReleaseBundleAudit } from './audit-release-bundle.mjs';
-import { runRuleIdUniquenessAudit } from './audit-rule-id-uniqueness.mjs';
+import { runCacheLayerContractAudit } from './validate/audits/cache-layer-contract.mjs';
+import { runCachingScopeHygieneAudit } from './validate/audits/caching-scope-hygiene.mjs';
+
+import { runAuditFileSize } from './validate/audits/file-size.mjs';
+import { runReflectionCitationAudit } from './validate/audits/reflection-citations.mjs';
+import { runReleaseBundleAudit } from './validate/audits/release-bundle.mjs';
+import { runRuleIdUniquenessAudit } from './validate/audits/rule-id-uniqueness.mjs';
 import {
   validateDependencyFreshnessAutomationCoverage,
   validateDetectionTransparencyCoverage,
@@ -59,6 +59,7 @@ import {
   validateVersionConsistency,
   validateMcpConfiguration,
 } from './validate/project-metadata.mjs';
+import { fileExists, readTextFile, collectFiles, normalizeLineEndings } from './validate/utils.mjs';
 
 const SCRIPT_FILE_PATH = fileURLToPath(import.meta.url);
 const ROOT_DIR = resolve(dirname(SCRIPT_FILE_PATH), '..');
@@ -79,51 +80,7 @@ const validationResult = {
   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;
@@ -141,9 +98,7 @@ function warn(message) {
   console.log(`  WARN ${message}`);
 }
 
-function normalizeLineEndings(content) {
-  return content.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
-}
+
 
 
 async function validateFileSizeAudit() {
@@ -211,33 +166,7 @@ async function validateCachingScopeHygieneAudit() {
   }
 }
 
-async function validateTypographyPaletteAntiRepeatAudit() {
-  console.log('\nChecking typography and palette anti-repeat ledger (audit:typography-palette-anti-repeat)...');
-  const report = runTypographyPaletteAntiRepeatAudit({ repositoryRootPath: ROOT_DIR });
-
-  if (report.skipped) {
-    pass(`Typography/palette anti-repeat audit skipped: ${report.reason}`);
-    return;
-  }
-
-  if (report.passed) {
-    pass(`Typography/palette anti-repeat audit clean: ${report.filesScanned} CSS/token file(s) scanned, 0 blocking typography violation(s), ${report.paletteFindingCount} palette finding(s) (${report.paletteSeverity})`);
-    return;
-  }
 
-  for (const violation of report.typographyViolations) {
-    fail(`Typography ledger violation [${violation.kind}] in ${violation.file}:${violation.line}: ${violation.detail}`);
-  }
-  if (report.paletteSeverity === 'blocking') {
-    for (const finding of report.paletteFindings) {
-      fail(`Palette ledger violation [${finding.kind}] in ${finding.file}:${finding.line}: ${finding.detail}`);
-    }
-  } else {
-    for (const finding of report.paletteFindings) {
-      warn(`Palette ledger advisory [${finding.kind}] in ${finding.file}:${finding.line}: ${finding.detail}`);
-    }
-  }
-}
 
 async function validateReleaseBundleAudit() {
   console.log('\nChecking release benchmark bundle (audit:release-bundle)...');
@@ -311,7 +240,7 @@ async function main() {
   await validateCacheLayerContractAudit();
   await validateReflectionCitationAudit();
   await validateCachingScopeHygieneAudit();
-  await validateTypographyPaletteAntiRepeatAudit();
+
   await validateReleaseBundleAudit();
   await validateFileSizeAudit();
   await validateRuleIdUniquenessAudit();