@ryuenn3123/agentic-senior-core 4.3.14 → 4.4.0

package/lib/cli/audits/typography-palette-anti-repeat-audit.mjs

@@ -1,239 +0,0 @@
-// @ts-check
-
-/**
- * Typography and palette anti-repeat audit.
- *
- * Scans CSS-like files for font-family declarations and color values, then
- *
- * DEPRECATED: This audit was built for the legacy design-intent.json system
- * and its machine-readable antiRepeatLedger. In the 2026 Context Ops Paradigm,
- * anti-repeat checks are handled by the LLM reading docs/DESIGN.md's 
- * "Previous Directions" blocklist. This audit now unconditionally skips.
- *   - Typography matches are EXACT family-name matches and are always
- *     blocking (kind: typography.previously-shipped-family,
- *     diagnosticCode: BOUNDARY_TYPOGRAPHY_LEDGER_VIOLATION).
- *   - Palette matches are HEURISTIC. OKLCH-to-OKLCH distance is perceptually
- *     uniform (deltaE < threshold => match). Hex-to-hex matches are exact
- *     normalized equality. Cross-type matches (hex declared in CSS vs OKLCH
- *     in the ledger, or vice versa) are NOT performed; reporting cross-type
- *     would require a color-space conversion that is its own correctness
- *     surface (tracked in docs/deep-analysis-and-roadmap-backlog.md).
- *   - Palette findings BLOCK by default with kind:
- *     palette.previously-shipped-color and diagnosticCode:
- *     BOUNDARY_PALETTE_LEDGER_VIOLATION. Pass
- *     `treatPaletteAsAdvisory: true` (or `--palette-advisory` on the CLI)
- *     to opt a project into advisory-only palette reporting; severity drops
- *     to "advisory" and the diagnostic code becomes
- *     BOUNDARY_PALETTE_LEDGER_ADVISORY. Use the advisory mode only when a
- *     project knowingly accepts the false-positive risk of OKLCH distance
- *     matching at its chosen threshold.
- */
-
-import { existsSync, readFileSync } from 'node:fs';
-import { join, relative } from 'node:path';
-
-import {
-  collectScannableFilePaths,
-  lineNumberFromIndex,
-} from './typography-palette-anti-repeat/file-scanner.mjs';
-import {
-  extractFontFamiliesFromText,
-  extractLedgerTypographyFamilies,
-} from './typography-palette-anti-repeat/typography-utils.mjs';
-import {
-  extractColorOccurrencesFromText,
-  extractLedgerColors,
-  oklchPerceptualDistance,
-} from './typography-palette-anti-repeat/color-utils.mjs';
-
-const DEFAULT_OKLCH_DISTANCE_THRESHOLD = 0.04;
-
-function findTypographyViolationsForFile({ relativeFilePath, sourceText, ledgerFamilies }) {
-  const violations = [];
-  const fontFamilyOccurrences = extractFontFamiliesFromText(sourceText);
-  for (const familyOccurrence of fontFamilyOccurrences) {
-    const ledgerEntry = ledgerFamilies.get(familyOccurrence.family);
-    if (!ledgerEntry) {
-      continue;
-    }
-    violations.push({
-      file: relativeFilePath,
-      line: lineNumberFromIndex(sourceText, familyOccurrence.index),
-      kind: 'typography.previously-shipped-family',
-      severity: 'blocking',
-      diagnosticCode: 'BOUNDARY_TYPOGRAPHY_LEDGER_VIOLATION',
-      detail: `CSS declares font-family "${familyOccurrence.family}" which appears in researchDossier.metadata.antiRepeatLedger.previousTypographyChoices ("${ledgerEntry.summary}"). Either escape the previously-shipped trio, or set derivedTokenLogic.tokenContinuityClassification.typography to continuity-retained with explicit rationale.`,
-    });
-  }
-  return violations;
-}
-
-function buildHexAdvisory({ relativeFilePath, sourceText, colorOccurrence, ledgerColor, paletteSeverity, paletteDiagnosticCode }) {
-  return {
-    file: relativeFilePath,
-    line: lineNumberFromIndex(sourceText, colorOccurrence.index),
-    kind: 'palette.previously-shipped-color',
-    severity: paletteSeverity,
-    diagnosticCode: paletteDiagnosticCode,
-    detail: `CSS hex "${colorOccurrence.raw}" matches a hex color in researchDossier.metadata.antiRepeatLedger.previousPalettes ("${ledgerColor.sourceEntry.summary}"). Either escape the previously-shipped palette or set derivedTokenLogic.tokenContinuityClassification.palette to continuity-retained with explicit rationale.`,
-  };
-}
-
-function buildOklchAdvisory({ relativeFilePath, sourceText, colorOccurrence, ledgerColor, perceptualDistance, oklchDistanceThreshold, paletteSeverity, paletteDiagnosticCode }) {
-  return {
-    file: relativeFilePath,
-    line: lineNumberFromIndex(sourceText, colorOccurrence.index),
-    kind: 'palette.previously-shipped-color',
-    severity: paletteSeverity,
-    diagnosticCode: paletteDiagnosticCode,
-    detail: `CSS OKLCH "${colorOccurrence.raw}" is within ${perceptualDistance.toFixed(4)} of an OKLCH color in researchDossier.metadata.antiRepeatLedger.previousPalettes ("${ledgerColor.sourceEntry.summary}") (threshold ${oklchDistanceThreshold}). Heuristic match on perceptually-uniform OKLCH distance; either escape the previously-shipped palette, raise the threshold via --threshold, or set derivedTokenLogic.tokenContinuityClassification.palette to continuity-retained with explicit rationale.`,
-  };
-}
-
-function findPaletteFindingsForFile({ relativeFilePath, sourceText, ledgerColors, oklchDistanceThreshold, paletteSeverity, paletteDiagnosticCode }) {
-  const findings = [];
-  const colorOccurrences = extractColorOccurrencesFromText(sourceText);
-  for (const colorOccurrence of colorOccurrences) {
-    for (const ledgerColor of ledgerColors) {
-      if (colorOccurrence.kind === 'hex' && ledgerColor.kind === 'hex') {
-        if (
-          colorOccurrence.normalized
-          && ledgerColor.normalized
-          && colorOccurrence.normalized === ledgerColor.normalized
-        ) {
-          findings.push(buildHexAdvisory({
-            relativeFilePath, sourceText, colorOccurrence, ledgerColor,
-            paletteSeverity, paletteDiagnosticCode,
-          }));
-        }
-        continue;
-      }
-      if (colorOccurrence.kind === 'oklch' && ledgerColor.kind === 'oklch' && colorOccurrence.oklch && ledgerColor.oklch) {
-        const perceptualDistance = oklchPerceptualDistance(colorOccurrence.oklch, ledgerColor.oklch);
-        if (perceptualDistance <= oklchDistanceThreshold) {
-          findings.push(buildOklchAdvisory({
-            relativeFilePath, sourceText, colorOccurrence, ledgerColor, perceptualDistance, oklchDistanceThreshold,
-            paletteSeverity, paletteDiagnosticCode,
-          }));
-        }
-      }
-      // Cross-type (hex declared vs OKLCH ledger or vice versa) is intentionally
-      // skipped here; reporting cross-type would require a color-space conversion
-      // pass that is its own correctness surface. Tracked in
-      // docs/deep-analysis-and-roadmap-backlog.md.
-    }
-  }
-  return findings;
-}
-
-function loadDesignIntentContract() {
-  return { contract: null, reason: 'design-intent-deprecated-use-design-md-blocklist' };
-}
-
-function buildSkippedReport(reportShell, reason) {
-  return {
-    ...reportShell,
-    passed: true,
-    skipped: true,
-    reason,
-    filesScanned: 0,
-    typographyViolationCount: 0,
-    paletteFindingCount: 0,
-    typographyViolations: [],
-    paletteFindings: [],
-  };
-}
-
-/**
- * Runs the typography and palette anti-repeat audit.
- *
- * @param {object} [auditOptions]
- * @param {string} [auditOptions.repositoryRootPath]
- * @param {string[]} [auditOptions.scanRoots]
- * @param {string} [auditOptions.designIntentRelativePath]
- * @param {number} [auditOptions.oklchDistanceThreshold]
- * @param {boolean} [auditOptions.treatPaletteAsAdvisory]
- */
-export function runTypographyPaletteAntiRepeatAudit(auditOptions = {}) {
-  const repositoryRootPath = auditOptions.repositoryRootPath || process.cwd();
-  const scanRoots = Array.isArray(auditOptions.scanRoots) && auditOptions.scanRoots.length > 0
-    ? auditOptions.scanRoots
-    : ['.'];
-  const designIntentRelativePath = auditOptions.designIntentRelativePath || 'docs/design-intent.json';
-  const oklchDistanceThreshold = typeof auditOptions.oklchDistanceThreshold === 'number'
-    ? auditOptions.oklchDistanceThreshold
-    : DEFAULT_OKLCH_DISTANCE_THRESHOLD;
-  const treatPaletteAsAdvisory = auditOptions.treatPaletteAsAdvisory === true;
-  const paletteSeverity = treatPaletteAsAdvisory ? 'advisory' : 'blocking';
-  const paletteDiagnosticCode = treatPaletteAsAdvisory
-    ? 'BOUNDARY_PALETTE_LEDGER_ADVISORY'
-    : 'BOUNDARY_PALETTE_LEDGER_VIOLATION';
-
-  const reportShell = {
-    auditName: 'audit-typography-palette-anti-repeat',
-    reportVersion: '2.0.0',
-    generatedAt: new Date().toISOString(),
-    designIntentRelativePath,
-    paletteSeverity,
-    paletteDiagnosticCode,
-    oklchDistanceThreshold,
-    scope: {
-      typographyMatching: 'exact-family-name-after-normalization',
-      paletteHexMatching: 'exact-hex-after-7-digit-normalization',
-      paletteOklchMatching: 'l*c*h-distance-under-threshold',
-      paletteCrossTypeMatching: 'not-supported-color-conversion-out-of-scope',
-      paletteCrossTypeMatchingTrackedIn: 'docs/deep-analysis-and-roadmap-backlog.md',
-    },
-  };
-
-  const designIntentLoad = loadDesignIntentContract();
-  if (!designIntentLoad.contract) {
-    return buildSkippedReport(reportShell, designIntentLoad.reason);
-  }
-  if (!antiRepeatLedger || typeof antiRepeatLedger !== 'object') {
-    return buildSkippedReport(reportShell, 'anti-repeat-ledger-absent');
-  }
-
-  const ledgerFamilies = extractLedgerTypographyFamilies(antiRepeatLedger);
-  const ledgerColors = extractLedgerColors(antiRepeatLedger);
-  const scannableFilePaths = collectScannableFilePaths(repositoryRootPath, scanRoots);
-
-  /** @type {any[]} */
-  const typographyViolations = [];
-  /** @type {any[]} */
-  const paletteFindings = [];
-
-  for (const absoluteFilePath of scannableFilePaths) {
-    const relativeFilePath = relative(repositoryRootPath, absoluteFilePath).replace(/\\/g, '/');
-    let sourceText;
-    try {
-      sourceText = readFileSync(absoluteFilePath, 'utf8');
-    } catch {
-      continue;
-    }
-    if (ledgerFamilies.size > 0) {
-      typographyViolations.push(...findTypographyViolationsForFile({
-        relativeFilePath, sourceText, ledgerFamilies,
-      }));
-    }
-    if (ledgerColors.length > 0) {
-      paletteFindings.push(...findPaletteFindingsForFile({
-        relativeFilePath, sourceText, ledgerColors, oklchDistanceThreshold,
-        paletteSeverity, paletteDiagnosticCode,
-      }));
-    }
-  }
-
-  const blockingViolationCount = typographyViolations.length + (treatPaletteAsAdvisory ? 0 : paletteFindings.length);
-
-  return {
-    ...reportShell,
-    passed: blockingViolationCount === 0,
-    skipped: false,
-    filesScanned: scannableFilePaths.length,
-    typographyViolationCount: typographyViolations.length,
-    paletteFindingCount: paletteFindings.length,
-    typographyViolations,
-    paletteFindings,
-  };
-}

package/lib/cli/commands/audit-design-anti-repeat.mjs

@@ -1,39 +0,0 @@
-// @ts-check
-
-/**
- * `agentic-senior-core audit:design-anti-repeat`
- *
- * [DEPRECATED in 2026 Context Ops Paradigm]
- * This script is retired because the anti-repeat ledger is now maintained
- * as plain-text inside docs/DESIGN.md. The Adaptive Context AI agent enforces
- * this naturally without needing regex-based JSON compliance theater.
- */
-
-export async function runDesignAntiRepeatAuditCommand(commandLineArgs = []) {
-  if (commandLineArgs.includes('--json')) {
-    process.stdout.write(JSON.stringify({
-      passed: true,
-      skipped: true,
-      reason: 'audit-design-anti-repeat is deprecated in Context Ops 2026. Plain text ledgers in DESIGN.md are handled by the agent contextually.',
-      targetDirectoryPath: process.cwd(),
-      filesScanned: 0,
-      typographyViolationCount: 0,
-      paletteFindingCount: 0,
-      paletteSeverity: 'advisory',
-      oklchDistanceThreshold: 0.04,
-      typographyViolations: [],
-      paletteFindings: []
-    }, null, 2) + '\n');
-    return 0;
-  }
-
-  console.log('===============================================');
-  console.log('  audit:design-anti-repeat (DEPRECATED)');
-  console.log('===============================================');
-  console.log('  Audit skipped: audit-design-anti-repeat is retired in Context Ops 2026.');
-  console.log('  Plain text ledgers in docs/DESIGN.md are handled by the agent contextually.');
-  console.log('  You can safely remove this check from your CI pipeline.');
-  console.log('');
-  
-  return 0;
-}

package/scripts/audit-typography-palette-anti-repeat.mjs

@@ -1,120 +0,0 @@
-#!/usr/bin/env node
-// @ts-check
-
-/**
- * audit-typography-palette-anti-repeat.mjs
- *
- * Thin CLI wrapper around lib/cli/audits/typography-palette-anti-repeat-audit.mjs.
- * The wrapper defaults to scanning the current working directory so it works
- * for both repo-internal `npm run audit:typography-palette-anti-repeat` (npm
- * sets cwd to the repo root) and direct invocation from a user project. The
- * user-facing entry point is the `audit:design-anti-repeat` subcommand on
- * the published bin (see lib/cli/commands/audit-design-anti-repeat.mjs).
- *
- * Usage:
- *   node scripts/audit-typography-palette-anti-repeat.mjs
- *   node scripts/audit-typography-palette-anti-repeat.mjs --json
- *   node scripts/audit-typography-palette-anti-repeat.mjs --palette-advisory
- *   node scripts/audit-typography-palette-anti-repeat.mjs --threshold 0.05
- *   node scripts/audit-typography-palette-anti-repeat.mjs --root /path/to/project
- *
- * Default severity:
- *   - Typography matches always block.
- *   - Palette matches block by default. Pass --palette-advisory to opt a
- *     project into advisory-only palette reporting (release stays unblocked
- *     by palette findings; typography still blocks).
- *
- * Exit codes:
- *   0 = no blocking violations
- *   1 = at least one BOUNDARY_TYPOGRAPHY_LEDGER_VIOLATION or, in default
- *       mode, BOUNDARY_PALETTE_LEDGER_VIOLATION
- */
-
-import { resolve } from 'node:path';
-
-import { runTypographyPaletteAntiRepeatAudit } from '../lib/cli/audits/typography-palette-anti-repeat-audit.mjs';
-
-const COMMAND_LINE_ARGS = process.argv.slice(2);
-const SHOULD_OUTPUT_JSON_ONLY = COMMAND_LINE_ARGS.includes('--json');
-const SHOULD_TREAT_PALETTE_AS_ADVISORY = COMMAND_LINE_ARGS.includes('--palette-advisory');
-
-function readStringFlag(flagName) {
-  const flagIndex = COMMAND_LINE_ARGS.indexOf(flagName);
-  if (flagIndex === -1) {
-    return null;
-  }
-  const flagValue = COMMAND_LINE_ARGS[flagIndex + 1];
-  if (typeof flagValue !== 'string' || flagValue.length === 0 || flagValue.startsWith('--')) {
-    return null;
-  }
-  return flagValue;
-}
-
-function readNumericFlag(flagName) {
-  const stringValue = readStringFlag(flagName);
-  if (stringValue === null) {
-    return null;
-  }
-  const numericValue = Number(stringValue);
-  return Number.isFinite(numericValue) ? numericValue : null;
-}
-
-function main() {
-  const oklchDistanceThreshold = readNumericFlag('--threshold');
-  const explicitRootPath = readStringFlag('--root');
-  const repositoryRootPath = resolve(explicitRootPath || process.cwd());
-
-  const auditReport = runTypographyPaletteAntiRepeatAudit({
-    repositoryRootPath,
-    treatPaletteAsAdvisory: SHOULD_TREAT_PALETTE_AS_ADVISORY,
-    ...(typeof oklchDistanceThreshold === 'number' ? { oklchDistanceThreshold } : {}),
-  });
-
-  if (SHOULD_OUTPUT_JSON_ONLY) {
-    process.stdout.write(`${JSON.stringify({ ...auditReport, repositoryRootPath }, null, 2)}\n`);
-    process.exit(auditReport.passed ? 0 : 1);
-  }
-
-  console.log('===============================================');
-  console.log('  audit:typography-palette-anti-repeat');
-  console.log('===============================================');
-  console.log(`  Target directory:            ${repositoryRootPath}`);
-  console.log(`  Files scanned:               ${auditReport.filesScanned}`);
-  console.log(`  Typography violations:       ${auditReport.typographyViolationCount} (blocking)`);
-  console.log(`  Palette findings:            ${auditReport.paletteFindingCount} (${auditReport.paletteSeverity})`);
-  console.log(`  OKLCH distance threshold:    ${auditReport.oklchDistanceThreshold}`);
-  console.log('');
-
-  if (auditReport.skipped) {
-    console.log(`  Audit skipped: ${auditReport.reason}`);
-    process.exit(0);
-  }
-
-  if (auditReport.typographyViolations.length > 0) {
-    console.log('  Typography violations (blocking):');
-    for (const violation of auditReport.typographyViolations) {
-      console.log(`    [${violation.kind}] ${violation.file}:${violation.line} ${violation.detail}`);
-    }
-    console.log('');
-  }
-
-  if (auditReport.paletteFindings.length > 0) {
-    console.log(`  Palette findings (${auditReport.paletteSeverity}):`);
-    for (const finding of auditReport.paletteFindings) {
-      console.log(`    [${finding.kind}] ${finding.file}:${finding.line} ${finding.detail}`);
-    }
-    console.log('');
-  }
-
-  if (auditReport.passed) {
-    console.log('  No blocking violations against the anti-repeat ledger.');
-    process.exit(0);
-  }
-  const blockingPaletteCount = auditReport.paletteSeverity === 'blocking' ? auditReport.paletteFindingCount : 0;
-  console.log(`  ${auditReport.typographyViolationCount} typography violation(s) and ${blockingPaletteCount} palette violation(s) found; release blocked.`);
-  process.exit(1);
-}
-
-if (process.argv[1] && (import.meta.url === `file://${process.argv[1].replace(/\\/g, '/')}` || process.argv[1].endsWith('audit-typography-palette-anti-repeat.mjs'))) {
-  main();
-}