@ryuenn3123/agentic-senior-core 4.4.0 → 5.2.0

package/scripts/frontend-usability-audit.mjs

@@ -1,243 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * frontend-usability-audit.mjs
- *
- * Governance-level audit for current frontend governance assets.
- * This repository does not host a frontend runtime app, so the audit validates
- * required quality gates and archived execution evidence.
- */
-
-import { existsSync, readFileSync } from 'node:fs';
-import { resolve, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const REPOSITORY_ROOT = resolve(__dirname, '..');
-
-const REQUIRED_FILES = [
-  'docs/archive/HISTORY.md',
-  'AGENTS.md',
-  '.agent-context/prompts/bootstrap-design.md',
-  'scripts/ui-design-judge.mjs',
-  'scripts/ui-rubric-calibration.mjs',
-  'scripts/ui-design-judge/rubric-calibration.mjs',
-  'scripts/ui-design-judge/rubric-goldset.json',
-  '.agent-context/rules/frontend-architecture.md',
-  '.agent-context/review-checklists/pr-checklist.md',
-  '.agent-context/review-checklists/architecture-review.md',
-  'lib/cli/detector/design-evidence.mjs',
-];
-
-const REQUIRED_HISTORY_SNIPPETS = [
-  'V1.7',
-  'Frontend Product Experience',
-  'completed',
-];
-
-const REQUIRED_PR_CHECKLIST_SNIPPETS = [
-  '### 2. Architecture (→ rules/architecture.md)',
-  '### 10. Documentation',
-  '### 15. Universal SOP Consolidation',
-];
-
-const REQUIRED_ARCHITECTURE_CHECKLIST_SNIPPETS = [];
-
-const REQUIRED_FRONTEND_RULE_SNIPPETS = [
-  '## FE-009: Accessibility',
-  'WCAG 2.2 AA is the hard floor.',
-  'APCA is advisory perceptual tuning only.',
-  '## FE-010: CSS Production Hardening',
-  'overflow, wrapping, truncation',
-  '## FE-011: Implementation Boundaries',
-  'Do not hardcode framework-specific state management or data fetching libraries, or rigid component doctrines',
-];
-
-const REQUIRED_BOOTSTRAP_DESIGN_SNIPPETS = [
-  'WCAG 2.2 AA is the hard compliance floor',
-  'Name Your Defaults',
-  'Choose an Anchor',
-  'Creative Commitments'
-];
-
-const REQUIRED_UI_DESIGN_JUDGE_SNIPPETS = [
-  'Advisory-default UI design contract judge.',
-  'Repo-internal workflow audit; no user-facing runtime modes.',
-  'genericityAutoFail',
-  'blocking required actions',
-  'Do not reward generic SaaS defaults or popular template patterns.',
-  'UI design judge only evaluates changed UI surfaces.',
-  'Structured design execution summary was supplied to semantic review.',
-  'designExecutionSignalCount',
-  'designExecutionPolicy',
-  'designExecutionHandoff',
-  'reviewRubric',
-  'genericityStatus',
-  'handoffReady',
-  'calibratedStatus',
-  'structuredInspectionAvailable',
-  'applyGenericityAutoFail',
-];
-
-const REQUIRED_INSTRUCTIONS_SNIPPETS = [
-  'UI Design Mode',
-  'Resolve the smallest relevant layer set for the current request.',
-  'bootstrap-design.md',
-  'frontend-architecture.md',
-  'do not eagerly load unrelated backend-only rules',
-  'valid style context',
-  'External references, prior-chat memory, unrelated-project visuals, and remembered screenshots are tainted',
-  'WCAG 2.2 AA as the hard compliance floor',
-  'APCA as advisory perceptual tuning only',
-];
-
-const REQUIRED_DESIGN_EVIDENCE_SNIPPETS = [
-  'summaryVersion',
-  "source: 'lightweight-static-scan'",
-  'cssVariables',
-  'componentInventory',
-  'structuredInspection',
-  'classAttributeCount',
-  'inlineStyleObjectCount',
-  'tokenBypassSignals',
-];
-
-const REQUIRED_COMPILER_UI_EVIDENCE_SNIPPETS = [
-  'frontendEvidenceMetrics',
-  'designEvidenceSummary',
-];
-
-function assertFileExists(relativeFilePath, failures) {
-  const absoluteFilePath = resolve(REPOSITORY_ROOT, relativeFilePath);
-  if (!existsSync(absoluteFilePath)) {
-    failures.push(`Missing required file: ${relativeFilePath}`);
-  }
-}
-
-function assertContains(contentLabel, filePath, fileContent, snippets, failures) {
-  for (const snippetText of snippets) {
-    if (!fileContent.includes(snippetText)) {
-      failures.push(`${contentLabel} missing snippet "${snippetText}" in ${filePath}`);
-    }
-  }
-}
-
-function runAudit() {
-  const failures = [];
-
-  for (const requiredFilePath of REQUIRED_FILES) {
-    assertFileExists(requiredFilePath, failures);
-  }
-
-  const roadmapPath = 'docs/archive/HISTORY.md';
-  const frontendRulePath = '.agent-context/rules/frontend-architecture.md';
-  const bootstrapDesignPromptPath = '.agent-context/prompts/bootstrap-design.md';
-  const instructionsPath = 'AGENTS.md';
-  const prChecklistPath = '.agent-context/review-checklists/pr-checklist.md';
-  const architectureChecklistPath = '.agent-context/review-checklists/architecture-review.md';
-  const designEvidenceExtractorPath = 'lib/cli/detector/design-evidence.mjs';
-  const compilerPath = 'lib/cli/compiler.mjs';
-
-  if (existsSync(resolve(REPOSITORY_ROOT, roadmapPath))) {
-    const roadmapContent = readFileSync(resolve(REPOSITORY_ROOT, roadmapPath), 'utf8');
-    assertContains('Project history', roadmapPath, roadmapContent, REQUIRED_HISTORY_SNIPPETS, failures);
-  }
-
-  if (existsSync(resolve(REPOSITORY_ROOT, prChecklistPath))) {
-    const checklistContent = readFileSync(resolve(REPOSITORY_ROOT, prChecklistPath), 'utf8');
-    assertContains('PR checklist', prChecklistPath, checklistContent, REQUIRED_PR_CHECKLIST_SNIPPETS, failures);
-  }
-
-  if (existsSync(resolve(REPOSITORY_ROOT, frontendRulePath))) {
-    const frontendRuleContent = readFileSync(resolve(REPOSITORY_ROOT, frontendRulePath), 'utf8');
-    assertContains('Frontend rule', frontendRulePath, frontendRuleContent, REQUIRED_FRONTEND_RULE_SNIPPETS, failures);
-  }
-
-  if (existsSync(resolve(REPOSITORY_ROOT, bootstrapDesignPromptPath))) {
-    const bootstrapDesignPromptContent = readFileSync(resolve(REPOSITORY_ROOT, bootstrapDesignPromptPath), 'utf8');
-    assertContains(
-      'Bootstrap design prompt',
-      bootstrapDesignPromptPath,
-      bootstrapDesignPromptContent,
-      REQUIRED_BOOTSTRAP_DESIGN_SNIPPETS,
-      failures
-    );
-  }
-
-  if (existsSync(resolve(REPOSITORY_ROOT, 'scripts/ui-design-judge.mjs'))) {
-    const uiDesignJudgeContent = readFileSync(resolve(REPOSITORY_ROOT, 'scripts/ui-design-judge.mjs'), 'utf8');
-    assertContains(
-      'UI design judge',
-      'scripts/ui-design-judge.mjs',
-      uiDesignJudgeContent,
-      REQUIRED_UI_DESIGN_JUDGE_SNIPPETS,
-      failures
-    );
-  }
-
-  if (existsSync(resolve(REPOSITORY_ROOT, instructionsPath))) {
-    const instructionsContent = readFileSync(resolve(REPOSITORY_ROOT, instructionsPath), 'utf8');
-    assertContains('Instructions', instructionsPath, instructionsContent, REQUIRED_INSTRUCTIONS_SNIPPETS, failures);
-  }
-
-  if (existsSync(resolve(REPOSITORY_ROOT, architectureChecklistPath))) {
-    const excellenceRubricContent = readFileSync(resolve(REPOSITORY_ROOT, architectureChecklistPath), 'utf8');
-    assertContains(
-      'Architecture checklist',
-      architectureChecklistPath,
-      excellenceRubricContent,
-      REQUIRED_ARCHITECTURE_CHECKLIST_SNIPPETS,
-      failures
-    );
-  }
-
-  let designEvidenceExtractorContent = '';
-  let compilerContent = '';
-
-  if (existsSync(resolve(REPOSITORY_ROOT, designEvidenceExtractorPath))) {
-    designEvidenceExtractorContent = readFileSync(resolve(REPOSITORY_ROOT, designEvidenceExtractorPath), 'utf8');
-    assertContains(
-      'Design evidence extractor',
-      designEvidenceExtractorPath,
-      designEvidenceExtractorContent,
-      REQUIRED_DESIGN_EVIDENCE_SNIPPETS,
-      failures
-    );
-  }
-
-  if (existsSync(resolve(REPOSITORY_ROOT, compilerPath))) {
-    compilerContent = readFileSync(resolve(REPOSITORY_ROOT, compilerPath), 'utf8');
-    assertContains(
-      'Compiler UI evidence projection',
-      compilerPath,
-      compilerContent,
-      REQUIRED_COMPILER_UI_EVIDENCE_SNIPPETS,
-      failures
-    );
-  }
-
-  const reportPayload = {
-    generatedAt: new Date().toISOString(),
-    auditName: 'frontend-usability-audit',
-    passed: failures.length === 0,
-    failureCount: failures.length,
-    failures,
-    phase2DesignEvidenceCoverage: {
-      extractorFilePath: designEvidenceExtractorPath,
-      compilerFilePath: compilerPath,
-      extractorIncludesSummaryVersion: designEvidenceExtractorContent.includes('summaryVersion'),
-      extractorIncludesCssVariables: designEvidenceExtractorContent.includes('cssVariables'),
-      extractorIncludesComponentInventory: designEvidenceExtractorContent.includes('componentInventory'),
-      extractorIncludesStructuredInspection: designEvidenceExtractorContent.includes('structuredInspection'),
-      extractorIncludesTokenBypassSignals: designEvidenceExtractorContent.includes('tokenBypassSignals'),
-      compilerProjectsFrontendEvidenceMetrics: compilerContent.includes('frontendEvidenceMetrics'),
-      compilerProjectsDesignEvidenceSummary: compilerContent.includes('designEvidenceSummary'),
-    },
-  };
-
-  console.log(JSON.stringify(reportPayload, null, 2));
-  process.exit(reportPayload.passed ? 0 : 1);
-}
-
-runAudit();

package/scripts/generate-sbom.mjs

@@ -1,61 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * generate-sbom.mjs
- *
- * Minimal CycloneDX-compatible SBOM for governance CI evidence.
- */
-
-import { readFileSync } from 'node:fs';
-import { resolve, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { randomUUID } from 'node:crypto';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const REPOSITORY_ROOT = resolve(__dirname, '..');
-const PACKAGE_JSON_PATH = resolve(REPOSITORY_ROOT, 'package.json');
-
-function buildComponents(dependencyGroup, dependencies) {
-  return Object.entries(dependencies || {}).map(([dependencyName, dependencyVersion]) => ({
-    type: 'library',
-    name: dependencyName,
-    version: String(dependencyVersion).replace(/^[^\d]*/, ''),
-    scope: dependencyGroup,
-    purl: `pkg:npm/${dependencyName}@${String(dependencyVersion).replace(/^[^\d]*/, '')}`,
-  }));
-}
-
-function generateSbom() {
-  const packageManifest = JSON.parse(readFileSync(PACKAGE_JSON_PATH, 'utf8'));
-  const runtimeComponents = buildComponents('required', packageManifest.dependencies);
-  const developmentComponents = buildComponents('optional', packageManifest.devDependencies);
-  const allComponents = [...runtimeComponents, ...developmentComponents];
-
-  const sbomPayload = {
-    bomFormat: 'CycloneDX',
-    specVersion: '1.5',
-    serialNumber: `urn:uuid:${randomUUID()}`,
-    version: 1,
-    metadata: {
-      timestamp: new Date().toISOString(),
-      component: {
-        type: 'application',
-        name: packageManifest.name,
-        version: packageManifest.version,
-      },
-      tools: [
-        {
-          vendor: 'Agentic-Senior-Core',
-          name: 'generate-sbom.mjs',
-          version: packageManifest.version,
-        },
-      ],
-    },
-    components: allComponents,
-  };
-
-  console.log(JSON.stringify(sbomPayload, null, 2));
-}
-
-generateSbom();