roadmapsmith 0.9.5 → 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.5",
+  "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
 };