roadmapsmith 0.9.4 → 0.9.6

package/README.md

@@ -22,6 +22,29 @@ npx skills add PapiScholz/roadmapsmith --skill roadmap-sync
 
 This adds the `roadmap-sync` agent skill. It does not install the CLI package.
 
+## Updating
+
+Update the CLI based on how it was installed:
+
+```bash
+# Global npm install
+npm install -g roadmapsmith@latest
+
+# Project dependency
+npm install roadmapsmith@latest
+
+# One-off execution without installing
+npx roadmapsmith@latest sync --audit
+```
+
+The `roadmap-sync` agent skill is separate from the CLI. Re-running the skills install updates the agent instructions, but it does not update the `roadmapsmith` npm binary:
+
+```bash
+npx skills add PapiScholz/roadmapsmith --skill roadmap-sync
+```
+
+Fixes are available through `@latest` only after a new npm package version has been published. Before publication, install from a local checkout or a packed tarball for testing.
+
 ## Operating Modes
 
 ### Zero Mode

package/bin/cli.js

@@ -44,6 +44,14 @@ function maybeFilterTasks(tasks, filterValue) {
   });
 }
 
+function tasksInManagedBlock(parsedRoadmap) {
+  if (!parsedRoadmap.managedRange) {
+    return parsedRoadmap.tasks;
+  }
+  const { start, end } = parsedRoadmap.managedRange;
+  return parsedRoadmap.tasks.filter((task) => task.lineIndex > start && task.lineIndex < end);
+}
+
 function printAudit(audit) {
   console.log(`Audit summary: ${audit.checkedWithoutEvidence.length} checked-without-evidence, ${audit.readyButUnchecked.length} ready-but-unchecked.`);
   if (audit.checkedWithoutEvidence.length > 0) {
@@ -157,10 +165,11 @@ async function run() {
     }
 
     const parsedRoadmap = parseRoadmap(content);
+    const syncTasks = tasksInManagedBlock(parsedRoadmap);
     const validationContext = buildValidationContext(projectRoot, config, loadPlugins(projectRoot, config.plugins));
-    const results = validateTasks(parsedRoadmap.tasks, validationContext, config, validationContext.plugins);
+    const results = validateTasks(syncTasks, validationContext, config, validationContext.plugins);
     applyMinimumConfidence(results, config.validation?.minimumConfidence);
-    const next = applySync(content, parsedRoadmap.tasks, results);
+    const next = applySync(content, syncTasks, results);
     const dryRun = isEnabled(flags['dry-run']);
     const writeResult = writeText(roadmapFile, next, { dryRun });
 
@@ -175,7 +184,7 @@ async function run() {
     }
 
     if (isEnabled(flags.audit)) {
-      const audit = auditValidation(parsedRoadmap.tasks, results);
+      const audit = auditValidation(syncTasks, results);
       printAudit(audit);
     }
     return;

package/package.json

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

package/src/parser/index.js

@@ -11,6 +11,7 @@ const MANAGED_END = '<!-- rs:managed:end -->';
 
 function parseRoadmap(content) {
   const lines = String(content || '').split(/\r?\n/);
+  const managedRange = findManagedRange(lines);
   const tasks = [];
   let section = '';
 
@@ -61,6 +62,8 @@ function parseRoadmap(content) {
 
   return {
     lines,
+    managedRange,
+    hasManagedBlock: Boolean(managedRange),
     tasks
   };
 }
@@ -105,6 +108,7 @@ function upsertManagedBlock(existingContent, managedBody) {
 }
 
 module.exports = {
+  findManagedRange,
   parseRoadmap,
   upsertManagedBlock
 };

package/src/validator/index.js

@@ -333,6 +333,38 @@ function findFilesByTaskPathTokens(taskText, fileIndex, pathDerivedTokens = new
   return Array.from(matches).sort((left, right) => left.localeCompare(right));
 }
 
+function extractTaskEvidenceTokens(taskText, pathDerivedTokens = new Set()) {
+  return tokenize(taskText)
+    .filter((token) => token.length >= 3 && !GENERIC_TASK_TOKENS.has(token) && !token.endsWith('/') && !pathDerivedTokens.has(token))
+    .slice(0, 8);
+}
+
+function findWeakPathContentSpecificTokens(taskText, fileIndex, weakPathFiles, pathDerivedTokens = new Set()) {
+  const tokens = extractTaskEvidenceTokens(taskText, pathDerivedTokens);
+  if (tokens.length === 0 || weakPathFiles.length === 0) return [];
+
+  const weakFiles = new Set(weakPathFiles);
+  const matches = new Set();
+  for (const file of fileIndex) {
+    if (!weakFiles.has(file.relativePath) || !CODE_EXTENSIONS.has(file.ext) || file.isTestFile) {
+      continue;
+    }
+
+    const normalizedPath = normalizePathForMatch(file.relativePath);
+    const lowered = file.content.toLowerCase();
+    for (const token of tokens) {
+      if (normalizedPath.includes(token)) {
+        continue;
+      }
+      if (lowered.includes(token)) {
+        matches.add(token);
+      }
+    }
+  }
+
+  return Array.from(matches).sort((left, right) => left.localeCompare(right));
+}
+
 function mergeRuleEvidence(baseEvidence, ruleEvidence) {
   if (!ruleEvidence || typeof ruleEvidence !== 'object') return baseEvidence;
   const merged = { ...baseEvidence };
@@ -376,9 +408,7 @@ function extractPathDerivedTokens(pathHints) {
 }
 
 function findCodeEvidence(taskText, fileIndex, pathDerivedTokens = new Set()) {
-  const tokens = tokenize(taskText)
-    .filter((token) => token.length >= 3 && !GENERIC_TASK_TOKENS.has(token) && !token.endsWith('/') && !pathDerivedTokens.has(token))
-    .slice(0, 8);
+  const tokens = extractTaskEvidenceTokens(taskText, pathDerivedTokens);
   if (tokens.length === 0) {
     return [];
   }
@@ -750,6 +780,7 @@ function validateTask(task, context, config, plugins) {
   const pathDerivedTokens = extractPathDerivedTokens([...pathHints, ...standaloneFilenames]);
   const filesFromCode = findCodeEvidence(task.text, context.fileIndex, pathDerivedTokens);
   const filesFromWeakPathTokens = findFilesByTaskPathTokens(task.text, context.fileIndex, pathDerivedTokens);
+  const weakPathContentTokens = findWeakPathContentSpecificTokens(task.text, context.fileIndex, filesFromWeakPathTokens, pathDerivedTokens);
   const filesFromTests = findTestEvidence(task.text, context.fileIndex, [...pathHints, ...standaloneFilenames]);
   const { files: filesFromArtifacts, heuristicArtifacts } = findArtifactEvidence(task.text, context.fileIndex);
 
@@ -763,6 +794,7 @@ function validateTask(task, context, config, plugins) {
     symbols: filesFromSymbols,
     codeFiles: filesFromCode,
     weakPathFiles: filesFromWeakPathTokens,
+    weakPathContentTokens,
     testFiles: filesFromTests,
     artifactFiles: filesFromArtifacts,
     heuristicArtifacts,
@@ -790,6 +822,12 @@ function validateTask(task, context, config, plugins) {
     reasons.push('no code, test, or artifact evidence found');
   } else if (!hasEvidence && !hasWeakEvidence && structuralCheck.applicable && structuralCheck.passed) {
     reasons.push('no code, test, or artifact evidence found');
+  } else if (!hasEvidence && hasWeakEvidence) {
+    if (weakPathContentTokens.length === 0) {
+      reasons.push('weak path-only evidence lacks content-specific token match');
+    } else {
+      reasons.push('weak path-token evidence lacks strong code, test, or artifact evidence');
+    }
   }
 
   const requiresTest = !task.noTest && context.testFrameworks.length > 0 && isCodeTask(task.text) && !isDocTask(task.text);