@ryuenn3123/agentic-senior-core 4.4.0 → 5.1.0

package/lib/cli/detector/design-evidence/structured-attribute-evidence.mjs

@@ -1,117 +0,0 @@
-/**
- * Structured attribute-aware inspection: counts class attributes, bound class
- * expressions, JSX/Vue inline styles, and Tailwind utility families seen in the
- * source. These metrics complement the raw regex pass with a structurally
- * aware view that better matches modern frontend authorship patterns.
- */
-
-import {
-  COLOR_PATTERN,
-  CSS_VARIABLE_REFERENCE_PATTERN,
-  EXPRESSION_CLASS_ATTRIBUTE_PATTERN,
-  JSX_INLINE_STYLE_PATTERN,
-  RAW_RADIUS_PATTERN,
-  RAW_SHADOW_PATTERN,
-  RAW_SPACING_PATTERN,
-  STRING_CLASS_ATTRIBUTE_PATTERN,
-  VUE_INLINE_STYLE_PATTERN,
-} from './constants.mjs';
-import {
-  countPatternMatches,
-  getFirstDefinedCapture,
-  incrementCountMap,
-  inferUtilityFamily,
-  normalizeEvidenceSample,
-  pushSampleValue,
-} from './utility-helpers.mjs';
-
-function collectTailwindUtilityFamilies(classValue, utilityFamilyCounts, utilityFamilySamples, utilityFamilySampleSet) {
-  for (const utilityToken of String(classValue || '').split(/\s+/g)) {
-    const utilityFamily = inferUtilityFamily(utilityToken);
-    if (!utilityFamily) {
-      continue;
-    }
-
-    incrementCountMap(utilityFamilyCounts, utilityFamily);
-    pushSampleValue(utilityFamilySamples, utilityFamily, utilityFamilySampleSet);
-  }
-}
-
-function applyInlineStyleInspection(styleSourceText, summary, styleSampleSet) {
-  const normalizedStyleSource = normalizeEvidenceSample(styleSourceText);
-  pushSampleValue(summary.structuredInspection.inlineStyleSamples, normalizedStyleSource, styleSampleSet);
-
-  const hardcodedColorCount = countPatternMatches(styleSourceText, COLOR_PATTERN);
-  const rawSpacingCount = countPatternMatches(styleSourceText, RAW_SPACING_PATTERN);
-  const rawRadiusCount = countPatternMatches(styleSourceText, RAW_RADIUS_PATTERN);
-  const rawShadowCount = countPatternMatches(styleSourceText, RAW_SHADOW_PATTERN);
-  const cssVariableReferenceCount = countPatternMatches(styleSourceText, CSS_VARIABLE_REFERENCE_PATTERN);
-
-  summary.structuredInspection.inlineTokenBypassSignals.hardcodedColorCount += hardcodedColorCount;
-  summary.structuredInspection.inlineTokenBypassSignals.rawSpacingCount += rawSpacingCount;
-  summary.structuredInspection.inlineTokenBypassSignals.rawRadiusCount += rawRadiusCount;
-  summary.structuredInspection.inlineTokenBypassSignals.rawShadowCount += rawShadowCount;
-  summary.structuredInspection.inlineTokenBypassSignals.cssVariableReferenceCount += cssVariableReferenceCount;
-}
-
-export function collectStructuredAttributeEvidence(
-  sourceText,
-  summary,
-  classSampleSet,
-  styleSampleSet,
-  utilityFamilySampleSet,
-) {
-  for (const classAttributeMatch of sourceText.matchAll(STRING_CLASS_ATTRIBUTE_PATTERN)) {
-    const classValue = getFirstDefinedCapture(classAttributeMatch.slice(1));
-    if (!classValue) {
-      continue;
-    }
-
-    summary.structuredInspection.classAttributeCount += 1;
-    pushSampleValue(
-      summary.structuredInspection.classAttributeSamples,
-      normalizeEvidenceSample(classValue),
-      classSampleSet,
-    );
-    collectTailwindUtilityFamilies(
-      classValue,
-      summary.structuredInspection.utilityFamilyCounts,
-      summary.structuredInspection.utilityFamilySamples,
-      utilityFamilySampleSet,
-    );
-  }
-
-  for (const expressionClassAttributeMatch of sourceText.matchAll(EXPRESSION_CLASS_ATTRIBUTE_PATTERN)) {
-    const expressionValue = getFirstDefinedCapture(expressionClassAttributeMatch.slice(1));
-    if (!expressionValue) {
-      continue;
-    }
-
-    summary.structuredInspection.boundClassExpressionCount += 1;
-    pushSampleValue(
-      summary.structuredInspection.classAttributeSamples,
-      normalizeEvidenceSample(expressionValue),
-      classSampleSet,
-    );
-  }
-
-  for (const inlineStyleMatch of sourceText.matchAll(JSX_INLINE_STYLE_PATTERN)) {
-    const inlineStyleSource = getFirstDefinedCapture(inlineStyleMatch.slice(1));
-    if (!inlineStyleSource) {
-      continue;
-    }
-
-    summary.structuredInspection.inlineStyleObjectCount += 1;
-    applyInlineStyleInspection(inlineStyleSource, summary, styleSampleSet);
-  }
-
-  for (const vueInlineStyleMatch of sourceText.matchAll(VUE_INLINE_STYLE_PATTERN)) {
-    const inlineStyleSource = getFirstDefinedCapture(vueInlineStyleMatch.slice(1));
-    if (!inlineStyleSource) {
-      continue;
-    }
-
-    summary.structuredInspection.inlineStyleBindingCount += 1;
-    applyInlineStyleInspection(inlineStyleSource, summary, styleSampleSet);
-  }
-}

package/lib/cli/detector/design-evidence/summary.mjs

@@ -1,109 +0,0 @@
-/**
- * Default-shaped design evidence summary. Constructed once per scan and then
- * mutated in place by the collector and inspection passes. Keeping the default
- * shape in one place makes downstream consumers diff-stable when adding new
- * counters: add the field here once, and every scan starts with it.
- */
-
-export function createDesignEvidenceSummary(scanRootRelativePaths) {
-  return {
-    summaryVersion: 'v1',
-    source: 'lightweight-static-scan',
-    scanRootRelativePaths,
-    scannedFileCount: 0,
-    cssVariables: {
-      definitionCount: 0,
-      referenceCount: 0,
-      sampleNames: [],
-      categoryCounts: {
-        color: 0,
-        spacing: 0,
-        radius: 0,
-        shadow: 0,
-        typography: 0,
-        motion: 0,
-        other: 0,
-      },
-    },
-    colors: {
-      hardcodedCount: 0,
-      kindCounts: {
-        hex: 0,
-        rgb: 0,
-        hsl: 0,
-        oklch: 0,
-        other: 0,
-      },
-      sampleValues: [],
-    },
-    spacing: {
-      rawValueCount: 0,
-      sampleValues: [],
-    },
-    radius: {
-      rawValueCount: 0,
-      sampleValues: [],
-    },
-    shadow: {
-      rawValueCount: 0,
-      sampleValues: [],
-    },
-    typography: {
-      fontFamilyCount: 0,
-      fontSizeCount: 0,
-      lineHeightCount: 0,
-      letterSpacingCount: 0,
-      fontFamilySamples: [],
-      fontSizeSamples: [],
-      lineHeightSamples: [],
-      letterSpacingSamples: [],
-    },
-    motion: {
-      transitionCount: 0,
-      animationCount: 0,
-      durationCount: 0,
-      durationSamples: [],
-    },
-    tailwind: {
-      breakpointUsageCount: 0,
-      arbitraryBreakpointCount: 0,
-      utilityFamilyCounts: {},
-      utilityFamilySamples: [],
-    },
-    componentInventory: {
-      componentFileCount: 0,
-      pageFileCount: 0,
-      layoutFileCount: 0,
-      surfaceFileSamples: [],
-    },
-    structuredInspection: {
-      mode: 'attribute-aware-static-scan',
-      classAttributeCount: 0,
-      boundClassExpressionCount: 0,
-      inlineStyleObjectCount: 0,
-      inlineStyleBindingCount: 0,
-      classAttributeSamples: [],
-      inlineStyleSamples: [],
-      utilityFamilyCounts: {},
-      utilityFamilySamples: [],
-      inlineTokenBypassSignals: {
-        hardcodedColorCount: 0,
-        rawSpacingCount: 0,
-        rawRadiusCount: 0,
-        rawShadowCount: 0,
-        cssVariableReferenceCount: 0,
-      },
-    },
-    tokenBypassSignals: {
-      hardcodedColorCount: 0,
-      rawSpacingCount: 0,
-      rawRadiusCount: 0,
-      rawShadowCount: 0,
-      inlineHardcodedColorCount: 0,
-      inlineRawSpacingCount: 0,
-      inlineRawRadiusCount: 0,
-      inlineRawShadowCount: 0,
-      inlineCssVariableReferenceCount: 0,
-    },
-  };
-}

package/lib/cli/detector/design-evidence/utility-helpers.mjs

@@ -1,122 +0,0 @@
-/**
- * Small pure helpers shared across the static design evidence scan modules.
- * Kept side-effect free so each can be tested in isolation.
- */
-
-import { DESIGN_EVIDENCE_SAMPLE_LIMIT } from './constants.mjs';
-
-export function countPatternMatches(sourceText, pattern) {
-  return Array.from(sourceText.matchAll(pattern)).length;
-}
-
-export function pushSampleValue(targetSamples, value, targetSet) {
-  const normalizedValue = String(value || '').trim();
-  if (!normalizedValue || targetSet.has(normalizedValue)) {
-    return;
-  }
-
-  targetSet.add(normalizedValue);
-  if (targetSamples.length < DESIGN_EVIDENCE_SAMPLE_LIMIT) {
-    targetSamples.push(normalizedValue);
-  }
-}
-
-export function incrementCountMap(countMap, key) {
-  countMap[key] = (countMap[key] || 0) + 1;
-}
-
-export function getFirstDefinedCapture(matchGroups) {
-  for (const capturedValue of matchGroups) {
-    if (typeof capturedValue === 'string' && capturedValue.trim().length > 0) {
-      return capturedValue;
-    }
-  }
-
-  return '';
-}
-
-export function normalizeEvidenceSample(rawValue) {
-  return String(rawValue || '').replace(/\s+/g, ' ').trim();
-}
-
-export function categorizeCssVariable(variableName) {
-  const normalizedVariableName = String(variableName || '').trim().toLowerCase();
-
-  if (/(color|surface|accent|bg|text|border|fill|stroke|ink|tone)/.test(normalizedVariableName)) {
-    return 'color';
-  }
-
-  if (/(space|gap|padding|margin|size|width|height|inset)/.test(normalizedVariableName)) {
-    return 'spacing';
-  }
-
-  if (/(radius|rounded|corner)/.test(normalizedVariableName)) {
-    return 'radius';
-  }
-
-  if (/(shadow|elevation)/.test(normalizedVariableName)) {
-    return 'shadow';
-  }
-
-  if (/(font|type|line|letter|tracking|leading)/.test(normalizedVariableName)) {
-    return 'typography';
-  }
-
-  if (/(motion|duration|easing|ease|animation|transition)/.test(normalizedVariableName)) {
-    return 'motion';
-  }
-
-  return 'other';
-}
-
-export function inferColorKind(colorValue) {
-  if (/^#/i.test(colorValue)) {
-    return 'hex';
-  }
-
-  if (/^rgba?\(/i.test(colorValue)) {
-    return 'rgb';
-  }
-
-  if (/^hsla?\(/i.test(colorValue)) {
-    return 'hsl';
-  }
-
-  if (/^oklch\(/i.test(colorValue)) {
-    return 'oklch';
-  }
-
-  return 'other';
-}
-
-export function inferUtilityFamily(rawUtilityToken) {
-  const normalizedUtilityToken = String(rawUtilityToken || '')
-    .trim()
-    .split(':')
-    .pop()
-    ?.replace(/^!/, '')
-    ?.replace(/\/.+$/, '')
-    ?.trim();
-
-  if (!normalizedUtilityToken) {
-    return '';
-  }
-
-  if (/^grid(?:-|$)/.test(normalizedUtilityToken)) {
-    return 'grid';
-  }
-
-  if (/^flex(?:-|$)/.test(normalizedUtilityToken)) {
-    return 'flex';
-  }
-
-  if (/^(?:block|inline|hidden|contents)$/.test(normalizedUtilityToken)) {
-    return normalizedUtilityToken;
-  }
-
-  if (/^(?:min|max)-\[/.test(normalizedUtilityToken)) {
-    return 'arbitrary-breakpoint';
-  }
-
-  return normalizedUtilityToken.split('-')[0];
-}

package/lib/cli/detector/design-evidence.mjs

@@ -1,25 +0,0 @@
-/**
- * Aggregator re-export for the design evidence scan. Implementation lives in
- * lib/cli/detector/design-evidence/* split per concern. Importers continue to
- * import the same public surface (collectFrontendDesignEvidence and
- * FRONTEND_SCAN_IGNORE_DIRECTORY_NAMES) from this module.
- *
- * Public schema produced by collectFrontendDesignEvidence (kept here so static
- * tooling can confirm the expected shape without crawling sub-files):
- *
- *   designEvidenceSummary.summaryVersion: 'v1'
- *   designEvidenceSummary.source: 'lightweight-static-scan'
- *   designEvidenceSummary.cssVariables.{ definitionCount, referenceCount, sampleNames, categoryCounts }
- *   designEvidenceSummary.componentInventory.{ componentFileCount, pageFileCount, layoutFileCount, surfaceFileSamples }
- *   designEvidenceSummary.structuredInspection.{ classAttributeCount, inlineStyleObjectCount, ... }
- *   designEvidenceSummary.tokenBypassSignals.{ hardcodedColorCount, rawSpacingCount, rawRadiusCount, rawShadowCount, ... }
- *   designEvidenceSummary.tailwind.{ breakpointUsageCount, arbitraryBreakpointCount, utilityFamilyCounts, ... }
- *
- *   frontendEvidenceMetrics.{ scannedFileCount, hardcodedColorCount, propDrillingCandidateCount,
- *     mediaQueryCount, tailwindBreakpointUsageCount, arbitraryBreakpointCount,
- *     uniqueMediaWidthCount, structuredClassAttributeCount, boundClassExpressionCount,
- *     inlineStyleObjectCount, inlineStyleBindingCount, inlineStyleTokenBypassCount }
- */
-
-export { FRONTEND_SCAN_IGNORE_DIRECTORY_NAMES } from './design-evidence/constants.mjs';
-export { collectFrontendDesignEvidence } from './design-evidence/collector.mjs';

package/lib/cli/detector/stack-detection.mjs

@@ -1,243 +0,0 @@
-/**
- * Stack detection: scores known marker sets per language ecosystem, ranks them,
- * and emits an explanation of what was chosen and why. Used by the CLI to seed
- * detection summaries and ranked candidate lists.
- */
-
-import { toTitleCase } from '../utils.mjs';
-import { collectNestedWorkspaceProjects, collectProjectMarkers } from './workspace-scan.mjs';
-
-export function collectStackDetectionCandidates(markerNames, evidencePrefix = null) {
-  const detectionCandidates = [];
-  const withEvidencePrefix = (evidenceItem) => evidencePrefix ? `${evidencePrefix}: ${evidenceItem}` : evidenceItem;
-
-  if (
-    markerNames.has('package.json')
-    || markerNames.has('tsconfig.json')
-    || markerNames.has('next.config.js')
-    || markerNames.has('next.config.mjs')
-    || markerNames.has('vite.config.js')
-    || markerNames.has('vite.config.mjs')
-    || markerNames.has('vite.config.ts')
-  ) {
-    const evidence = [];
-    let confidenceScore = 0.7;
-
-    if (markerNames.has('package.json')) {
-      evidence.push(withEvidencePrefix('package.json'));
-      confidenceScore += 0.12;
-    }
-
-    if (markerNames.has('tsconfig.json')) {
-      evidence.push(withEvidencePrefix('tsconfig.json'));
-      confidenceScore += 0.12;
-    }
-
-    if (markerNames.has('next.config.js') || markerNames.has('next.config.mjs')) {
-      evidence.push(withEvidencePrefix('Next.js config'));
-      confidenceScore += 0.05;
-    }
-
-    if (markerNames.has('vite.config.js') || markerNames.has('vite.config.mjs') || markerNames.has('vite.config.ts')) {
-      evidence.push(withEvidencePrefix('Vite config'));
-      confidenceScore += 0.08;
-    }
-
-    detectionCandidates.push({
-      stackFileName: 'typescript.md',
-      confidenceScore: Math.min(confidenceScore, 0.97),
-      evidence,
-    });
-  }
-
-  if (markerNames.has('pyproject.toml') || markerNames.has('requirements.txt')) {
-    detectionCandidates.push({
-      stackFileName: 'python.md',
-      confidenceScore: markerNames.has('pyproject.toml') ? 0.96 : 0.78,
-      evidence: markerNames.has('pyproject.toml')
-        ? [withEvidencePrefix('pyproject.toml')]
-        : [withEvidencePrefix('requirements.txt')],
-    });
-  }
-
-  if (markerNames.has('pom.xml') || markerNames.has('build.gradle') || markerNames.has('build.gradle.kts')) {
-    const evidence = [];
-    if (markerNames.has('pom.xml')) evidence.push(withEvidencePrefix('pom.xml'));
-    if (markerNames.has('build.gradle') || markerNames.has('build.gradle.kts')) evidence.push(withEvidencePrefix('Gradle build file'));
-    detectionCandidates.push({
-      stackFileName: 'java.md',
-      confidenceScore: markerNames.has('pom.xml') ? 0.95 : 0.84,
-      evidence,
-    });
-  }
-
-  if (markerNames.has('composer.json')) {
-    detectionCandidates.push({
-      stackFileName: 'php.md',
-      confidenceScore: 0.95,
-      evidence: [withEvidencePrefix('composer.json')],
-    });
-  }
-
-  if (markerNames.has('go.mod')) {
-    detectionCandidates.push({
-      stackFileName: 'go.md',
-      confidenceScore: 0.96,
-      evidence: [withEvidencePrefix('go.mod')],
-    });
-  }
-
-  if (markerNames.has('Cargo.toml')) {
-    detectionCandidates.push({
-      stackFileName: 'rust.md',
-      confidenceScore: 0.96,
-      evidence: [withEvidencePrefix('Cargo.toml')],
-    });
-  }
-
-  if (markerNames.has('Gemfile')) {
-    detectionCandidates.push({
-      stackFileName: 'ruby.md',
-      confidenceScore: 0.95,
-      evidence: [withEvidencePrefix('Gemfile')],
-    });
-  }
-
-  const hasDotNetMarker = Array.from(markerNames).some(
-    (markerName) => markerName.endsWith('.sln') || markerName.endsWith('.csproj'),
-  );
-  if (hasDotNetMarker) {
-    detectionCandidates.push({
-      stackFileName: 'csharp.md',
-      confidenceScore: 0.95,
-      evidence: [withEvidencePrefix('.sln or .csproj file')],
-    });
-  }
-
-  if (
-    markerNames.has('package.json')
-    && (markerNames.has('android') || markerNames.has('ios') || markerNames.has('react-native.config.js'))
-  ) {
-    detectionCandidates.push({
-      stackFileName: 'react-native.md',
-      confidenceScore: 0.9,
-      evidence: [withEvidencePrefix('package.json'), withEvidencePrefix('mobile runtime markers')],
-    });
-  }
-
-  if (markerNames.has('pubspec.yaml')) {
-    detectionCandidates.push({
-      stackFileName: 'flutter.md',
-      confidenceScore: 0.94,
-      evidence: [withEvidencePrefix('pubspec.yaml')],
-    });
-  }
-
-  return detectionCandidates;
-}
-
-export async function detectProjectContext(targetDirectoryPath) {
-  const markerNames = await collectProjectMarkers(targetDirectoryPath);
-  const nestedWorkspaceProjects = await collectNestedWorkspaceProjects(targetDirectoryPath);
-  const detectionCandidates = [
-    ...collectStackDetectionCandidates(markerNames),
-    ...nestedWorkspaceProjects.flatMap((nestedWorkspaceProject) => (
-      collectStackDetectionCandidates(
-        nestedWorkspaceProject.markerNames,
-        nestedWorkspaceProject.relativePath,
-      )
-    )),
-  ];
-  const hasExistingProjectFiles = markerNames.size > 0;
-
-  if (detectionCandidates.length === 0) {
-    return {
-      hasExistingProjectFiles,
-      detectedStackFileName: null,
-      secondaryStackFileNames: [],
-      detectedBlueprintFileName: null,
-      confidenceLabel: null,
-      confidenceScore: 0,
-      confidenceGap: 0,
-      detectionReasoning: 'No known project markers were detected.',
-      rankedCandidates: [],
-      evidence: [],
-    };
-  }
-
-  detectionCandidates.sort(
-    (leftCandidate, rightCandidate) => rightCandidate.confidenceScore - leftCandidate.confidenceScore,
-  );
-  const strongestCandidate = detectionCandidates[0];
-  const secondStrongestCandidate = detectionCandidates[1];
-  const confidenceGap = secondStrongestCandidate
-    ? Number((strongestCandidate.confidenceScore - secondStrongestCandidate.confidenceScore).toFixed(2))
-    : Number(strongestCandidate.confidenceScore.toFixed(2));
-  const isAmbiguous = secondStrongestCandidate && confidenceGap < 0.08;
-  const confidenceLabel = strongestCandidate.confidenceScore >= 0.9
-    ? 'high'
-    : strongestCandidate.confidenceScore >= 0.78
-      ? 'medium'
-      : 'low';
-  const evidence = isAmbiguous
-    ? [...strongestCandidate.evidence, 'multiple stack signals detected']
-    : strongestCandidate.evidence;
-  const rankedCandidates = detectionCandidates.slice(0, 3).map((detectionCandidate) => ({
-    stackFileName: detectionCandidate.stackFileName,
-    confidenceScore: Number(detectionCandidate.confidenceScore.toFixed(2)),
-    evidence: detectionCandidate.evidence,
-  }));
-  const secondaryStackFileNames = rankedCandidates
-    .slice(1)
-    .filter((rankedCandidate) => (strongestCandidate.confidenceScore - rankedCandidate.confidenceScore) < 0.08)
-    .map((rankedCandidate) => rankedCandidate.stackFileName);
-  const detectionReasoning = isAmbiguous
-    ? `Top signal ${toTitleCase(strongestCandidate.stackFileName)} is close to ${toTitleCase(secondStrongestCandidate.stackFileName)} (confidence gap ${confidenceGap}).`
-    : `Top signal ${toTitleCase(strongestCandidate.stackFileName)} won with confidence ${strongestCandidate.confidenceScore.toFixed(2)} from markers: ${strongestCandidate.evidence.join(', ') || 'none'}.`;
-
-  return {
-    hasExistingProjectFiles,
-    detectedStackFileName: strongestCandidate.stackFileName,
-    secondaryStackFileNames,
-    detectedBlueprintFileName: null,
-    confidenceLabel,
-    confidenceScore: strongestCandidate.confidenceScore,
-    confidenceGap,
-    detectionReasoning,
-    rankedCandidates,
-    evidence,
-  };
-}
-
-export function buildDetectionSummary(projectDetection) {
-  if (!projectDetection.detectedStackFileName) {
-    return 'I did not find enough stack markers to auto-detect this project confidently.';
-  }
-
-  const readableEvidence = projectDetection.evidence.length > 0
-    ? projectDetection.evidence.join(', ')
-    : 'basic project markers';
-
-  const confidenceGapSummary = typeof projectDetection.confidenceGap === 'number'
-    ? ` Confidence gap: ${projectDetection.confidenceGap}.`
-    : '';
-
-  const secondaryStacksSummary = projectDetection.secondaryStackFileNames?.length
-    ? ` Secondary stack signals: ${projectDetection.secondaryStackFileNames.map((stackFileName) => toTitleCase(stackFileName)).join(', ')}.`
-    : '';
-
-  return `This folder looks like ${toTitleCase(projectDetection.detectedStackFileName)} with ${projectDetection.confidenceLabel} confidence based on ${readableEvidence}.${confidenceGapSummary}${secondaryStacksSummary}`;
-}
-
-export function formatDetectionCandidates(rankedCandidates) {
-  if (!rankedCandidates?.length) {
-    return 'No ranked candidates available.';
-  }
-
-  return rankedCandidates
-    .map((candidate, candidateIndex) => {
-      const evidenceSummary = candidate.evidence?.length ? candidate.evidence.join(', ') : 'no direct markers';
-      return `${candidateIndex + 1}. ${toTitleCase(candidate.stackFileName)} (score ${candidate.confidenceScore}) via ${evidenceSummary}`;
-    })
-    .join('\n');
-}