@ryuenn3123/agentic-senior-core 1.8.2 → 1.9.1

package/scripts/detection-benchmark.mjs

@@ -1,138 +1,138 @@
-#!/usr/bin/env node
-
-/**
- * detection-benchmark.mjs
- *
- * Lightweight benchmark for stack detection heuristics used by the CLI.
- * Publishes top-1 accuracy and manual-correction-rate proxy.
- */
-
-const BLUEPRINT_RECOMMENDATIONS = {
-  'typescript.md': 'api-nextjs.md',
-  'python.md': 'fastapi-service.md',
-  'java.md': 'spring-boot-api.md',
-  'php.md': 'laravel-api.md',
-  'go.md': 'go-service.md',
-  'csharp.md': 'aspnet-api.md',
-};
-
-const AMBIGUITY_THRESHOLD = 0.08;
-
-const BENCHMARK_FIXTURES = [
-  { fixtureName: 'typescript-basic', markers: ['package.json', 'tsconfig.json'], expectedStack: 'typescript.md' },
-  { fixtureName: 'typescript-next', markers: ['package.json', 'tsconfig.json', 'next.config.js'], expectedStack: 'typescript.md' },
-  { fixtureName: 'python-poetry', markers: ['pyproject.toml'], expectedStack: 'python.md' },
-  { fixtureName: 'python-requirements', markers: ['requirements.txt'], expectedStack: 'python.md' },
-  { fixtureName: 'java-maven', markers: ['pom.xml'], expectedStack: 'java.md' },
-  { fixtureName: 'java-gradle', markers: ['build.gradle'], expectedStack: 'java.md' },
-  { fixtureName: 'php-composer', markers: ['composer.json'], expectedStack: 'php.md' },
-  { fixtureName: 'go-module', markers: ['go.mod'], expectedStack: 'go.md' },
-  { fixtureName: 'dotnet-solution', markers: ['app.sln'], expectedStack: 'csharp.md' },
-  { fixtureName: 'rust-cargo', markers: ['Cargo.toml'], expectedStack: 'rust.md' },
-  { fixtureName: 'ruby-gemfile', markers: ['Gemfile'], expectedStack: 'ruby.md' },
-  { fixtureName: 'mixed-ts-python', markers: ['package.json', 'tsconfig.json', 'pyproject.toml'], expectedStack: 'typescript.md' },
-];
-
-function detectProjectFromMarkers(markers) {
-  const markerNames = new Set(markers);
-  const candidates = [];
-
-  if (markerNames.has('package.json') || markerNames.has('tsconfig.json') || markerNames.has('next.config.js') || markerNames.has('next.config.mjs')) {
-    let confidenceScore = 0.7;
-    if (markerNames.has('package.json')) confidenceScore += 0.12;
-    if (markerNames.has('tsconfig.json')) confidenceScore += 0.12;
-    if (markerNames.has('next.config.js') || markerNames.has('next.config.mjs')) confidenceScore += 0.05;
-    candidates.push({ stackFileName: 'typescript.md', confidenceScore: Math.min(confidenceScore, 0.97) });
-  }
-
-  if (markerNames.has('pyproject.toml') || markerNames.has('requirements.txt')) {
-    candidates.push({
-      stackFileName: 'python.md',
-      confidenceScore: markerNames.has('pyproject.toml') ? 0.96 : 0.78,
-    });
-  }
-
-  if (markerNames.has('pom.xml') || markerNames.has('build.gradle') || markerNames.has('build.gradle.kts')) {
-    candidates.push({
-      stackFileName: 'java.md',
-      confidenceScore: markerNames.has('pom.xml') ? 0.95 : 0.84,
-    });
-  }
-
-  if (markerNames.has('composer.json')) candidates.push({ stackFileName: 'php.md', confidenceScore: 0.95 });
-  if (markerNames.has('go.mod')) candidates.push({ stackFileName: 'go.md', confidenceScore: 0.96 });
-  if (markerNames.has('Cargo.toml')) candidates.push({ stackFileName: 'rust.md', confidenceScore: 0.96 });
-  if (markerNames.has('Gemfile')) candidates.push({ stackFileName: 'ruby.md', confidenceScore: 0.95 });
-
-  const hasDotNetMarker = Array.from(markerNames).some((markerName) => markerName.endsWith('.sln') || markerName.endsWith('.csproj'));
-  if (hasDotNetMarker) {
-    candidates.push({ stackFileName: 'csharp.md', confidenceScore: 0.95 });
-  }
-
-  if (candidates.length === 0) {
-    return {
-      recommendedStack: null,
-      recommendedBlueprint: null,
-      confidenceScore: 0,
-      confidenceGap: 0,
-      needsManualCorrection: true,
-    };
-  }
-
-  candidates.sort((leftCandidate, rightCandidate) => rightCandidate.confidenceScore - leftCandidate.confidenceScore);
-  const strongestCandidate = candidates[0];
-  const secondStrongestCandidate = candidates[1];
-  const confidenceGap = secondStrongestCandidate
-    ? Number((strongestCandidate.confidenceScore - secondStrongestCandidate.confidenceScore).toFixed(2))
-    : Number(strongestCandidate.confidenceScore.toFixed(2));
-
-  return {
-    recommendedStack: strongestCandidate.stackFileName,
-    recommendedBlueprint: BLUEPRINT_RECOMMENDATIONS[strongestCandidate.stackFileName] || null,
-    confidenceScore: strongestCandidate.confidenceScore,
-    confidenceGap,
-    needsManualCorrection: confidenceGap < AMBIGUITY_THRESHOLD,
-  };
-}
-
-function runBenchmark() {
-  let passingFixtureCount = 0;
-  let manualCorrectionCount = 0;
-
-  const fixtureResults = BENCHMARK_FIXTURES.map((benchmarkFixture) => {
-    const detectionResult = detectProjectFromMarkers(benchmarkFixture.markers);
-    const isCorrect = detectionResult.recommendedStack === benchmarkFixture.expectedStack;
-
-    if (isCorrect) {
-      passingFixtureCount += 1;
-    }
-
-    if (detectionResult.needsManualCorrection) {
-      manualCorrectionCount += 1;
-    }
-
-    return {
-      fixtureName: benchmarkFixture.fixtureName,
-      expectedStack: benchmarkFixture.expectedStack,
-      detectedStack: detectionResult.recommendedStack,
-      confidenceGap: detectionResult.confidenceGap,
-      needsManualCorrection: detectionResult.needsManualCorrection,
-      isCorrect,
-    };
-  });
-
-  const totalFixtureCount = BENCHMARK_FIXTURES.length;
-  const top1Accuracy = Number((passingFixtureCount / totalFixtureCount).toFixed(4));
-  const manualCorrectionRate = Number((manualCorrectionCount / totalFixtureCount).toFixed(4));
-
-  return {
-    generatedAt: new Date().toISOString(),
-    fixtureCount: totalFixtureCount,
-    top1Accuracy,
-    manualCorrectionRate,
-    fixtures: fixtureResults,
-  };
-}
-
-const benchmarkResult = runBenchmark();
-console.log(JSON.stringify(benchmarkResult, null, 2));
+#!/usr/bin/env node
+
+/**
+ * detection-benchmark.mjs
+ *
+ * Lightweight benchmark for stack detection heuristics used by the CLI.
+ * Publishes top-1 accuracy and manual-correction-rate proxy.
+ */
+
+const BLUEPRINT_RECOMMENDATIONS = {
+  'typescript.md': 'api-nextjs.md',
+  'python.md': 'fastapi-service.md',
+  'java.md': 'spring-boot-api.md',
+  'php.md': 'laravel-api.md',
+  'go.md': 'go-service.md',
+  'csharp.md': 'aspnet-api.md',
+};
+
+const AMBIGUITY_THRESHOLD = 0.08;
+
+const BENCHMARK_FIXTURES = [
+  { fixtureName: 'typescript-basic', markers: ['package.json', 'tsconfig.json'], expectedStack: 'typescript.md' },
+  { fixtureName: 'typescript-next', markers: ['package.json', 'tsconfig.json', 'next.config.js'], expectedStack: 'typescript.md' },
+  { fixtureName: 'python-poetry', markers: ['pyproject.toml'], expectedStack: 'python.md' },
+  { fixtureName: 'python-requirements', markers: ['requirements.txt'], expectedStack: 'python.md' },
+  { fixtureName: 'java-maven', markers: ['pom.xml'], expectedStack: 'java.md' },
+  { fixtureName: 'java-gradle', markers: ['build.gradle'], expectedStack: 'java.md' },
+  { fixtureName: 'php-composer', markers: ['composer.json'], expectedStack: 'php.md' },
+  { fixtureName: 'go-module', markers: ['go.mod'], expectedStack: 'go.md' },
+  { fixtureName: 'dotnet-solution', markers: ['app.sln'], expectedStack: 'csharp.md' },
+  { fixtureName: 'rust-cargo', markers: ['Cargo.toml'], expectedStack: 'rust.md' },
+  { fixtureName: 'ruby-gemfile', markers: ['Gemfile'], expectedStack: 'ruby.md' },
+  { fixtureName: 'mixed-ts-python', markers: ['package.json', 'tsconfig.json', 'pyproject.toml'], expectedStack: 'typescript.md' },
+];
+
+function detectProjectFromMarkers(markers) {
+  const markerNames = new Set(markers);
+  const candidates = [];
+
+  if (markerNames.has('package.json') || markerNames.has('tsconfig.json') || markerNames.has('next.config.js') || markerNames.has('next.config.mjs')) {
+    let confidenceScore = 0.7;
+    if (markerNames.has('package.json')) confidenceScore += 0.12;
+    if (markerNames.has('tsconfig.json')) confidenceScore += 0.12;
+    if (markerNames.has('next.config.js') || markerNames.has('next.config.mjs')) confidenceScore += 0.05;
+    candidates.push({ stackFileName: 'typescript.md', confidenceScore: Math.min(confidenceScore, 0.97) });
+  }
+
+  if (markerNames.has('pyproject.toml') || markerNames.has('requirements.txt')) {
+    candidates.push({
+      stackFileName: 'python.md',
+      confidenceScore: markerNames.has('pyproject.toml') ? 0.96 : 0.78,
+    });
+  }
+
+  if (markerNames.has('pom.xml') || markerNames.has('build.gradle') || markerNames.has('build.gradle.kts')) {
+    candidates.push({
+      stackFileName: 'java.md',
+      confidenceScore: markerNames.has('pom.xml') ? 0.95 : 0.84,
+    });
+  }
+
+  if (markerNames.has('composer.json')) candidates.push({ stackFileName: 'php.md', confidenceScore: 0.95 });
+  if (markerNames.has('go.mod')) candidates.push({ stackFileName: 'go.md', confidenceScore: 0.96 });
+  if (markerNames.has('Cargo.toml')) candidates.push({ stackFileName: 'rust.md', confidenceScore: 0.96 });
+  if (markerNames.has('Gemfile')) candidates.push({ stackFileName: 'ruby.md', confidenceScore: 0.95 });
+
+  const hasDotNetMarker = Array.from(markerNames).some((markerName) => markerName.endsWith('.sln') || markerName.endsWith('.csproj'));
+  if (hasDotNetMarker) {
+    candidates.push({ stackFileName: 'csharp.md', confidenceScore: 0.95 });
+  }
+
+  if (candidates.length === 0) {
+    return {
+      recommendedStack: null,
+      recommendedBlueprint: null,
+      confidenceScore: 0,
+      confidenceGap: 0,
+      needsManualCorrection: true,
+    };
+  }
+
+  candidates.sort((leftCandidate, rightCandidate) => rightCandidate.confidenceScore - leftCandidate.confidenceScore);
+  const strongestCandidate = candidates[0];
+  const secondStrongestCandidate = candidates[1];
+  const confidenceGap = secondStrongestCandidate
+    ? Number((strongestCandidate.confidenceScore - secondStrongestCandidate.confidenceScore).toFixed(2))
+    : Number(strongestCandidate.confidenceScore.toFixed(2));
+
+  return {
+    recommendedStack: strongestCandidate.stackFileName,
+    recommendedBlueprint: BLUEPRINT_RECOMMENDATIONS[strongestCandidate.stackFileName] || null,
+    confidenceScore: strongestCandidate.confidenceScore,
+    confidenceGap,
+    needsManualCorrection: confidenceGap < AMBIGUITY_THRESHOLD,
+  };
+}
+
+function runBenchmark() {
+  let passingFixtureCount = 0;
+  let manualCorrectionCount = 0;
+
+  const fixtureResults = BENCHMARK_FIXTURES.map((benchmarkFixture) => {
+    const detectionResult = detectProjectFromMarkers(benchmarkFixture.markers);
+    const isCorrect = detectionResult.recommendedStack === benchmarkFixture.expectedStack;
+
+    if (isCorrect) {
+      passingFixtureCount += 1;
+    }
+
+    if (detectionResult.needsManualCorrection) {
+      manualCorrectionCount += 1;
+    }
+
+    return {
+      fixtureName: benchmarkFixture.fixtureName,
+      expectedStack: benchmarkFixture.expectedStack,
+      detectedStack: detectionResult.recommendedStack,
+      confidenceGap: detectionResult.confidenceGap,
+      needsManualCorrection: detectionResult.needsManualCorrection,
+      isCorrect,
+    };
+  });
+
+  const totalFixtureCount = BENCHMARK_FIXTURES.length;
+  const top1Accuracy = Number((passingFixtureCount / totalFixtureCount).toFixed(4));
+  const manualCorrectionRate = Number((manualCorrectionCount / totalFixtureCount).toFixed(4));
+
+  return {
+    generatedAt: new Date().toISOString(),
+    fixtureCount: totalFixtureCount,
+    top1Accuracy,
+    manualCorrectionRate,
+    fixtures: fixtureResults,
+  };
+}
+
+const benchmarkResult = runBenchmark();
+console.log(JSON.stringify(benchmarkResult, null, 2));

package/scripts/frontend-usability-audit.mjs

@@ -1,87 +1,87 @@
-#!/usr/bin/env node
-
-/**
- * frontend-usability-audit.mjs
- *
- * Governance-level audit for V1.7 frontend execution assets.
- * This repository does not host a frontend runtime app, so the audit validates
- * required execution artifacts and quality gates documentation.
- */
-
-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/roadmap.md',
-  'docs/v1.7-issue-breakdown.md',
-  'docs/v1.7-execution-playbook.md',
-  '.agent-context/review-checklists/frontend-usability.md',
-];
-
-const REQUIRED_ROADMAP_SNIPPETS = [
-  'V1.7',
-  'Frontend Product Experience',
-  'Release status: Completed',
-  'Delivered Scope',
-];
-
-const REQUIRED_CHECKLIST_SNIPPETS = [
-  'Responsiveness',
-  'Accessibility',
-  'Performance',
-  'Documentation and Release Evidence',
-];
-
-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/roadmap.md';
-  const checklistPath = '.agent-context/review-checklists/frontend-usability.md';
-
-  if (existsSync(resolve(REPOSITORY_ROOT, roadmapPath))) {
-    const roadmapContent = readFileSync(resolve(REPOSITORY_ROOT, roadmapPath), 'utf8');
-    assertContains('Roadmap', roadmapPath, roadmapContent, REQUIRED_ROADMAP_SNIPPETS, failures);
-  }
-
-  if (existsSync(resolve(REPOSITORY_ROOT, checklistPath))) {
-    const checklistContent = readFileSync(resolve(REPOSITORY_ROOT, checklistPath), 'utf8');
-    assertContains('Checklist', checklistPath, checklistContent, REQUIRED_CHECKLIST_SNIPPETS, failures);
-  }
-
-  const reportPayload = {
-    generatedAt: new Date().toISOString(),
-    auditName: 'frontend-usability-audit',
-    passed: failures.length === 0,
-    failureCount: failures.length,
-    failures,
-  };
-
-  console.log(JSON.stringify(reportPayload, null, 2));
-  process.exit(reportPayload.passed ? 0 : 1);
-}
-
-runAudit();
+#!/usr/bin/env node
+
+/**
+ * frontend-usability-audit.mjs
+ *
+ * Governance-level audit for V1.7 frontend execution assets.
+ * This repository does not host a frontend runtime app, so the audit validates
+ * required execution artifacts and quality gates documentation.
+ */
+
+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/roadmap.md',
+  'docs/v1.7-issue-breakdown.md',
+  'docs/v1.7-execution-playbook.md',
+  '.agent-context/review-checklists/frontend-usability.md',
+];
+
+const REQUIRED_ROADMAP_SNIPPETS = [
+  'V1.7',
+  'Frontend Product Experience',
+  'Release status: Completed',
+  'Delivered Scope',
+];
+
+const REQUIRED_CHECKLIST_SNIPPETS = [
+  'Responsiveness',
+  'Accessibility',
+  'Performance',
+  'Documentation and Release Evidence',
+];
+
+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/roadmap.md';
+  const checklistPath = '.agent-context/review-checklists/frontend-usability.md';
+
+  if (existsSync(resolve(REPOSITORY_ROOT, roadmapPath))) {
+    const roadmapContent = readFileSync(resolve(REPOSITORY_ROOT, roadmapPath), 'utf8');
+    assertContains('Roadmap', roadmapPath, roadmapContent, REQUIRED_ROADMAP_SNIPPETS, failures);
+  }
+
+  if (existsSync(resolve(REPOSITORY_ROOT, checklistPath))) {
+    const checklistContent = readFileSync(resolve(REPOSITORY_ROOT, checklistPath), 'utf8');
+    assertContains('Checklist', checklistPath, checklistContent, REQUIRED_CHECKLIST_SNIPPETS, failures);
+  }
+
+  const reportPayload = {
+    generatedAt: new Date().toISOString(),
+    auditName: 'frontend-usability-audit',
+    passed: failures.length === 0,
+    failureCount: failures.length,
+    failures,
+  };
+
+  console.log(JSON.stringify(reportPayload, null, 2));
+  process.exit(reportPayload.passed ? 0 : 1);
+}
+
+runAudit();

package/scripts/generate-sbom.mjs

@@ -1,61 +1,61 @@
-#!/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();
+#!/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();