roadmapsmith 0.7.1 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roadmapsmith",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "Evidence-backed ROADMAP.md generator and sync tool for AI coding agents.",
   "main": "src/index.js",
   "bin": {

package/src/classifier/index.js

@@ -0,0 +1,134 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const WEB_DIRS = ['app/', 'pages/', 'components/', 'src/app/', 'src/pages/', 'src/components/'];
+const ASSET_DIRS = ['public/', 'assets/', 'static/'];
+const WEB_CONFIGS = [
+  'next.config.js', 'next.config.ts', 'next.config.mjs',
+  'vite.config.js', 'vite.config.ts',
+  'astro.config.mjs', 'astro.config.ts'
+];
+const STYLE_CONFIGS = ['tailwind.config.js', 'tailwind.config.ts', 'tailwind.config.cjs'];
+const WEB_DEPS = new Set(['next', 'react', 'vue', 'svelte', 'astro', 'vite', 'nuxt', 'gatsby', 'remix', '@remix-run/react']);
+const LANDING_ROUTE_RE = /(?:^|\/)(?:contact|services|about|pricing|hero|cta|landing)(?:\/|\.)/i;
+
+function readPackageDeps(projectRoot) {
+  if (!projectRoot) return [];
+  try {
+    const raw = fs.readFileSync(path.join(projectRoot, 'package.json'), 'utf8');
+    const pkg = JSON.parse(raw);
+    return Object.keys({ ...pkg.dependencies, ...pkg.devDependencies });
+  } catch {
+    return [];
+  }
+}
+
+function hasDir(files, prefix) {
+  return files.some((f) => f.startsWith(prefix));
+}
+
+function hasFilename(files, name) {
+  return files.some((f) => f === name || f.endsWith('/' + name));
+}
+
+function hasWorkspaces(projectRoot) {
+  if (!projectRoot) return false;
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(projectRoot, 'package.json'), 'utf8'));
+    return Array.isArray(pkg.workspaces) && pkg.workspaces.length > 0;
+  } catch {
+    return false;
+  }
+}
+
+function classifyProject({ projectRoot, files }) {
+  const signals = [];
+
+  if (hasWorkspaces(projectRoot)) {
+    signals.push('package.json workspaces field');
+    return { type: 'monorepo', confidence: 'high', signals };
+  }
+
+  const hasPy = hasFilename(files, 'pyproject.toml') || hasFilename(files, 'setup.py');
+  if (hasPy && !files.some((f) => /\.[jt]sx?$/.test(f))) {
+    signals.push('pyproject.toml / setup.py, no JS files');
+    return { type: 'python-package', confidence: 'high', signals };
+  }
+
+  let webScore = 0;
+  let landingScore = 0;
+  const deps = readPackageDeps(projectRoot);
+
+  for (const dep of deps) {
+    if (WEB_DEPS.has(dep)) {
+      webScore += 2;
+      signals.push(`dependency: ${dep}`);
+    }
+  }
+
+  for (const dir of WEB_DIRS) {
+    if (hasDir(files, dir)) {
+      webScore += 2;
+      signals.push(`directory: ${dir.replace(/\/$/, '')}`);
+    }
+  }
+
+  for (const dir of ASSET_DIRS) {
+    if (hasDir(files, dir)) {
+      webScore += 1;
+      signals.push(`directory: ${dir.replace(/\/$/, '')}`);
+    }
+  }
+
+  for (const cfg of WEB_CONFIGS) {
+    if (hasFilename(files, cfg)) {
+      webScore += 3;
+      signals.push(`config: ${cfg}`);
+    }
+  }
+
+  for (const cfg of STYLE_CONFIGS) {
+    if (hasFilename(files, cfg)) {
+      webScore += 1;
+      signals.push(`config: ${cfg}`);
+    }
+  }
+
+  if (files.some((f) => /\.css$/.test(f))) {
+    webScore += 1;
+    signals.push('CSS files present');
+  }
+
+  const landingRoutes = files.filter((f) => LANDING_ROUTE_RE.test(f));
+  if (landingRoutes.length > 0) {
+    landingScore += landingRoutes.length * 2;
+    signals.push(`landing/service routes: ${landingRoutes.length}`);
+  }
+
+  if (hasFilename(files, 'favicon.ico') || hasFilename(files, 'logo.png') || hasFilename(files, 'logo.svg')) {
+    landingScore += 1;
+    signals.push('branding asset in public/');
+  }
+
+  if (webScore === 0 && (files.some((f) => f.startsWith('bin/')) || hasFilename(files, 'cli.js'))) {
+    signals.push('bin/ directory or cli.js');
+    return { type: 'cli-tool', confidence: 'medium', signals };
+  }
+
+  if (webScore === 0 && hasFilename(files, 'package.json')) {
+    signals.push('package.json, no web signals');
+    return { type: 'npm-package', confidence: 'low', signals };
+  }
+
+  if (webScore >= 3) {
+    const type = landingScore >= 3 ? 'landing-site' : 'frontend-web';
+    const confidence = webScore >= 7 ? 'high' : 'medium';
+    return { type, confidence, signals };
+  }
+
+  return { type: 'unknown-generic', confidence: 'low', signals: [] };
+}
+
+module.exports = { classifyProject };

package/src/generator/index.js

@@ -9,6 +9,7 @@ const { parseRoadmap, upsertManagedBlock } = require('../parser');
 const { findBestTaskMatch, dedupeTasks } = require('../match');
 const { collectPluginContributions } = require('../config');
 const { renderBody } = require('../renderer');
+const { classifyProject } = require('../classifier');
 
 const IMPL_PATTERN_RE = /[/|]TODO|TODO[|/]|[/|]FIXME|FIXME[|/]/;
 const COMMENT_TODO_RE = /(?:\/\/|#|\*\s*).*\b(?:TODO|FIXME)\b/;
@@ -149,6 +150,8 @@ function scanProject(projectRoot) {
   const implementedFiles = files.filter((file) => /\.(js|ts|tsx|py|go|rs|java|kt|cs)$/.test(file));
   const testFiles = files.filter((file) => /(^|\/)(__tests__|tests)\//.test(file) || /\.test\.|\.spec\.|_test\.go$/.test(file));
 
+  const classifier = classifyProject({ projectRoot, files });
+
   return {
     projectRoot,
     files,
@@ -160,7 +163,10 @@ function scanProject(projectRoot) {
     codeTodos,
     workspaces,
     implementedCount: implementedFiles.length,
-    testCount: testFiles.length
+    testCount: testFiles.length,
+    projectType: classifier.type,
+    classifierConfidence: classifier.confidence,
+    classifierSignals: classifier.signals
   };
 }
 
@@ -175,6 +181,35 @@ function toCandidate(text, phase, priority, source = 'default') {
   };
 }
 
+const WEB_CANDIDATES_COMMON = [
+  { text: 'Add SEO metadata: title, description, and canonical URL for all pages', phase: 'P0' },
+  { text: 'Implement responsive and mobile-first layout across all breakpoints', phase: 'P0' },
+  { text: 'Establish accessibility baseline (semantic HTML, ARIA labels, keyboard navigation)', phase: 'P0' },
+  { text: 'Add OpenGraph and Twitter card metadata for social sharing', phase: 'P1' },
+  { text: 'Achieve Lighthouse performance score ≥ 90 and resolve critical findings', phase: 'P1' },
+  { text: 'Validate branding consistency: typography, color tokens, and logo usage', phase: 'P1' },
+  { text: 'Configure deployment and hosting pipeline (CI/CD to production)', phase: 'P2' },
+  { text: 'Add web security headers: Content-Security-Policy, X-Frame-Options, HSTS', phase: 'P2' }
+];
+
+const LANDING_CANDIDATES = [
+  { text: 'Complete services and content sections with clear value proposition', phase: 'P1' },
+  { text: 'Implement contact form and conversion flow with input validation', phase: 'P1' },
+  { text: 'Set up analytics and conversion event tracking', phase: 'P2' }
+];
+
+function buildWebCandidates(scan) {
+  const candidates = WEB_CANDIDATES_COMMON.map(({ text, phase }) =>
+    toCandidate(text, phase, phase, 'classifier')
+  );
+  if (scan.projectType === 'landing-site') {
+    for (const { text, phase } of LANDING_CANDIDATES) {
+      candidates.push(toCandidate(text, phase, phase, 'classifier'));
+    }
+  }
+  return candidates;
+}
+
 function buildDefaultCandidates(scan, config) {
   const languageLabel = scan.languages.length > 0 ? scan.languages.join(', ') : 'current stack';
   const candidates = [];
@@ -223,6 +258,10 @@ function buildDefaultCandidates(scan, config) {
     candidates.push(toCandidate(`Resolve backlog note in ${hint.file}`, 'P0', 'P0', 'todo-hint'));
   }
 
+  if (scan.projectType === 'frontend-web' || scan.projectType === 'landing-site') {
+    candidates.push(...buildWebCandidates(scan));
+  }
+
   return candidates;
 }
 
@@ -547,10 +586,22 @@ function generateRoadmapDocument(options) {
     items: section.items || []
   }));
 
+  const evidenceLine = scan.classifierSignals.length > 0
+    ? scan.classifierSignals.slice(0, 5).join(', ')
+    : 'general file scan';
+  const profileSection = {
+    title: 'Detected Project Profile',
+    items: [
+      `- **Type:** ${scan.projectType}`,
+      `- **Confidence:** ${scan.classifierConfidence}`,
+      `- **Evidence:** ${evidenceLine}`
+    ]
+  };
+
   const baseCandidates = buildDefaultCandidates(scan, config);
   const matcherCandidates = applyTaskMatchers(scan, config);
   const merged = mergeWithExisting([...baseCandidates, ...matcherCandidates, ...pluginTaskCandidates], existingPhaseTasks);
-  const model = createModel(scan, merged, config, [...configSections, ...pluginSections], existingCheckedById);
+  const model = createModel(scan, merged, config, [profileSection, ...configSections, ...pluginSections], existingCheckedById);
   const profile = config.roadmapProfile || 'compact';
   const managedBody = renderBody(model, profile);
 

package/src/renderer/professional.js

@@ -530,6 +530,14 @@ function renderProfessional(model) {
   renderSection12SuccessCriteria(model, lines);
   renderSection13CustomPhases(model, lines);
 
+  for (const section of (model.customSections || [])) {
+    lines.push(`## ${section.title}`);
+    for (const line of section.items) {
+      lines.push(line);
+    }
+    lines.push('');
+  }
+
   return ensureTrailingNewline(lines.join('\n')).trimEnd();
 }