roadmapsmith 0.9.34 → 0.9.36

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "roadmapsmith",
-  "version": "0.9.34",
+  "version": "0.9.36",
   "description": "Evidence-backed ROADMAP.md workflows for AI coding agents, with canonical RoadmapSmith status and maintain surfaces plus advanced sync/generate tools and legacy compatibility aliases.",
   "author": {
     "name": "PapiScholz"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "roadmapsmith",
-  "version": "0.9.34",
+  "version": "0.9.36",
   "description": "Evidence-backed ROADMAP.md workflows for AI coding agents, with canonical RoadmapSmith status and maintain surfaces plus advanced sync/generate tools and legacy compatibility aliases.",
   "author": {
     "name": "PapiScholz"

package/bin/cli.js

@@ -92,6 +92,15 @@ function printAudit(audit) {
       console.log(`- [${item.task.id}] ${item.task.text}`);
     });
   }
+  if (Array.isArray(audit.newlyUnchecked) && audit.newlyUnchecked.length > 0) {
+    console.log(`Unchecked by this run (${audit.newlyUnchecked.length}): ${audit.newlyUnchecked.join(', ')}`);
+  }
+  if (Array.isArray(audit.humanVerifiedTasks) && audit.humanVerifiedTasks.length > 0) {
+    console.log(`Human-verified tasks (${audit.humanVerifiedTasks.length}):`);
+    audit.humanVerifiedTasks.forEach((item) => {
+      console.log(`- [${item.task.id}] ${item.task.text}`);
+    });
+  }
 }
 
 function printReadinessSummary(summary) {
@@ -276,8 +285,18 @@ function runSyncCommand(projectRoot, config, flags, options = {}) {
   const validationContext = buildValidationContext(projectRoot, config, loadPlugins(projectRoot, config.plugins));
   const results = validateTasks(syncTasks, validationContext, config, validationContext.plugins);
   applyMinimumConfidence(results, config.validation?.minimumConfidence);
+  if (isEnabled(flags.audit)) {
+    const audit = auditValidation(syncTasks, results);
+    printAudit(audit);
+    const hasMismatch = audit.checkedWithoutEvidence.length > 0 || audit.readyButUnchecked.length > 0;
+    if (hasMismatch) {
+      process.exitCode = 2;
+    }
+    return;
+  }
+
   const forceRefresh = isEnabled(flags['refresh-annotations']);
-  const next = applySync(content, syncTasks, results, { forceRefresh });
+  const { content: next, changes } = applySync(content, syncTasks, results, { forceRefresh });
   const dryRun = isEnabled(flags['dry-run']);
   emitPreWriteWarning(roadmapFile, {
     commandName: options.commandName || 'roadmapsmith sync',
@@ -294,11 +313,17 @@ function runSyncCommand(projectRoot, config, flags, options = {}) {
       console.log(`No changes for ${roadmapFile}`);
     }
   } else {
+    if (changes.newlyUnchecked.length > 0) {
+      console.log(`Unchecked ${changes.newlyUnchecked.length} task(s): ${changes.newlyUnchecked.join(', ')}`);
+    }
+    if (changes.newlyChecked.length > 0) {
+      console.log(`Checked ${changes.newlyChecked.length} task(s): ${changes.newlyChecked.join(', ')}`);
+    }
     console.log(writeResult.changed ? `Updated ${roadmapFile}` : `No changes for ${roadmapFile}`);
   }
 
-  if (options.audit || isEnabled(flags.audit)) {
-    const audit = auditValidation(syncTasks, results);
+  if (options.audit) {
+    const audit = auditValidation(syncTasks, results, changes);
     printAudit(audit);
   }
 }
@@ -354,13 +379,16 @@ function runUpdateCommand(projectRoot, config, flags) {
   const validationContext = buildValidationContext(projectRoot, config, loadPlugins(projectRoot, config.plugins));
   const result = validateTasks([draftTask], validationContext, config, validationContext.plugins)[taskId];
   const errors = (result.diagnostics || []).filter((item) => item.severity === 'error');
+  const isEscapeHatch = draftTask.verifiedBy === 'human' || draftTask.kind === 'docs';
   const suppliedEvidenceResolved = result.evidence.authoritative && result.evidence.authoritativeFiles.length > 0;
-  if (!suppliedEvidenceResolved || !result.passed || result.confidence !== 'high' || errors.length > 0) {
+  const evidenceAccepted = isEscapeHatch ? result.passed : (suppliedEvidenceResolved && result.passed && result.confidence === 'high');
+  if (!evidenceAccepted || errors.length > 0) {
     const reasons = result.reasons.length > 0 ? `: ${result.reasons.join('; ')}` : '';
-    throw new Error(`Task ${taskId} was not updated; supplied evidence must resolve in the repository and validate at high confidence${reasons}`);
+    const hint = isEscapeHatch ? '; escape-hatch task requires an Evidence: child line' : '; supplied evidence must resolve in the repository and validate at high confidence';
+    throw new Error(`Task ${taskId} was not updated${hint}${reasons}`);
   }
 
-  const next = applySync(draft, [draftTask], { [taskId]: result });
+  const { content: next } = applySync(draft, [draftTask], { [taskId]: result });
   const dryRun = isEnabled(flags['dry-run']);
   emitPreWriteWarning(roadmapFile, {
     commandName: 'roadmapsmith update',
@@ -489,7 +517,7 @@ function runMaintainCommand(projectRoot, flags) {
     forceFullRegenerate: fullRegen,
     warningState
   });
-  runSyncCommand(projectRoot, config, { ...flags, audit: true }, {
+  runSyncCommand(projectRoot, config, { ...flags, audit: undefined }, {
     audit: true,
     commandName: 'roadmapsmith maintain',
     warningState

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roadmapsmith",
-  "version": "0.9.34",
+  "version": "0.9.36",
   "description": "Evidence-backed ROADMAP.md workflows for AI coding agents, with canonical RoadmapSmith status and maintain surfaces plus advanced sync/generate tools and legacy compatibility aliases.",
   "main": "src/index.js",
   "bin": {

package/skills.json

@@ -28,67 +28,67 @@
       "name": "roadmap",
       "path": "skills/roadmap",
       "description": "Native slash palette for RoadmapSmith commands and recommended entrypoints across supported hosts.",
-      "version": "0.9.34"
+      "version": "0.9.36"
     },
     {
       "name": "roadmap-zero",
       "path": "skills/roadmap-zero",
       "description": "Native slash entrypoint for Zero Mode, including non-interactive config-plus-flag discovery.",
-      "version": "0.9.34"
+      "version": "0.9.36"
     },
     {
       "name": "roadmap-maintain",
       "path": "skills/roadmap-maintain",
       "description": "Native slash entrypoint for conservative managed-block maintenance plus sync and audit output.",
-      "version": "0.9.34"
+      "version": "0.9.36"
     },
     {
       "name": "roadmap-status",
       "path": "skills/roadmap-status",
       "description": "Native slash readiness check grounded in roadmapsmith status JSON.",
-      "version": "0.9.34"
+      "version": "0.9.36"
     },
     {
       "name": "roadmap-init",
       "path": "skills/roadmap-init",
       "description": "Native slash entrypoint for creating ROADMAP.md and AGENTS.md.",
-      "version": "0.9.34"
+      "version": "0.9.36"
     },
     {
       "name": "roadmap-generate",
       "path": "skills/roadmap-generate",
       "description": "Native slash entrypoint for managed roadmap updates that require --full-regen before destructive replacement.",
-      "version": "0.9.34"
+      "version": "0.9.36"
     },
     {
       "name": "roadmap-validate",
       "path": "skills/roadmap-validate",
       "description": "Native slash entrypoint for evidence-backed roadmap validation.",
-      "version": "0.9.34"
+      "version": "0.9.36"
     },
     {
       "name": "roadmap-update",
       "path": "skills/roadmap-update",
       "description": "Native slash entrypoint for evidence-backed inline annotation refresh and verified single-task completion.",
-      "version": "0.9.34"
+      "version": "0.9.36"
     },
     {
       "name": "roadmap-sync",
       "path": "skills/roadmap-sync",
       "description": "DEPRECATED legacy compatibility root; use roadmap-maintain or roadmap-update.",
-      "version": "0.9.34"
+      "version": "0.9.36"
     },
     {
       "name": "roadmap-audit",
       "path": "skills/roadmap-audit",
       "description": "Native slash entrypoint for the advanced sync-plus-audit mutating summary workflow.",
-      "version": "0.9.34"
+      "version": "0.9.36"
     },
     {
       "name": "roadmap-setup",
       "path": "skills/roadmap-setup",
       "description": "Native slash entrypoint for generating RoadmapSmith host integration files.",
-      "version": "0.9.34"
+      "version": "0.9.36"
     }
   ]
 }

package/src/config.js

@@ -30,6 +30,9 @@ const DEFAULT_CONFIG = {
     constraints: [],
     doneCriteria: []
   },
+  scan: {
+    excludeDirs: []
+  },
   validation: {
     minimumConfidence: 'low',
     testReports: [],
@@ -95,6 +98,11 @@ function mergeConfig(userConfig) {
         ? userConfig.zeroMode.doneCriteria
         : DEFAULT_CONFIG.zeroMode.doneCriteria
     },
+    scan: {
+      excludeDirs: Array.isArray(userConfig && userConfig.scan && userConfig.scan.excludeDirs)
+        ? userConfig.scan.excludeDirs
+        : DEFAULT_CONFIG.scan.excludeDirs
+    },
     validation: {
       ...DEFAULT_CONFIG.validation,
       ...((userConfig && userConfig.validation) || {}),

package/src/io.js

@@ -12,6 +12,16 @@ const DEFAULT_IGNORED_DIRS = new Set([
   '.nuxt',
   '.turbo',
   '.cache',
+  '.open-next',
+  '.vercel',
+  '.svelte-kit',
+  '.parcel-cache',
+  '.angular',
+  '.expo',
+  '.serverless',
+  '.wrangler',
+  '.tmp',
+  'tmp',
   'dist',
   'dist-electron',
   'build',
@@ -68,7 +78,10 @@ function writeText(filePath, content, options = {}) {
 }
 
 function walkFiles(rootPath, options = {}) {
-  const ignoredDirs = options.ignoredDirs || DEFAULT_IGNORED_DIRS;
+  let ignoredDirs = options.ignoredDirs || DEFAULT_IGNORED_DIRS;
+  if (Array.isArray(options.extraIgnoredDirs) && options.extraIgnoredDirs.length > 0) {
+    ignoredDirs = new Set([...ignoredDirs, ...options.extraIgnoredDirs]);
+  }
   const result = [];
 
   function walk(current) {

package/src/parser/index.js

@@ -147,6 +147,10 @@ function parseRoadmap(content) {
 
     const { indent, checked, text, markerId, markerFlags } = taskLine;
     const noTest = /\brs:no-test\b/i.test(markerFlags);
+    const kindMatch = markerFlags.match(/\brs:kind=(\S+)/i);
+    const taskKind = kindMatch ? kindMatch[1].toLowerCase() : null;
+    const verifiedByMatch = markerFlags.match(/\brs:verified-by=(\S+)/i);
+    const taskVerifiedBy = verifiedByMatch ? verifiedByMatch[1].toLowerCase() : null;
     const taskIndentWidth = getIndentWidth(indent);
 
     let warningLineIndex = null;
@@ -243,6 +247,8 @@ function parseRoadmap(content) {
       blockedByIds,
       markerId,
       noTest,
+      kind: taskKind,
+      verifiedBy: taskVerifiedBy,
       indent,
       section
     });

package/src/sync/index.js

@@ -139,6 +139,13 @@ function applySync(content, parsedTasks, results, options) {
   const lines = [...parsed.lines];
   const tasks = parsedTasks || parsed.tasks;
 
+  const changes = {
+    newlyUnchecked: [],
+    newlyChecked: [],
+    warningsAdded: [],
+    warningsRemoved: []
+  };
+
   let offset = 0;
   for (const task of tasks) {
     const result = results[task.id];
@@ -151,7 +158,13 @@ function applySync(content, parsedTasks, results, options) {
       continue;
     }
 
+    const wasChecked = task.checked;
     lines[lineIndex] = setChecklistState(lines[lineIndex], result.passed);
+    if (wasChecked && !result.passed) {
+      changes.newlyUnchecked.push(task.id);
+    } else if (!wasChecked && result.passed) {
+      changes.newlyChecked.push(task.id);
+    }
 
     const reason = normalizeWarningReasons(result.reasons).join('; ');
     const warningText = formatWarning(task.indent || '', reason || 'validation failed', result.attempted);
@@ -198,6 +211,7 @@ function applySync(content, parsedTasks, results, options) {
     } else {
       lines.splice(lastChildLineIndex + 1, 0, warningText);
       offset += 1;
+      changes.warningsAdded.push(task.id);
     }
 
     const recipeIndex = findVerificationRecipeIndex(lines, lineIndex);
@@ -218,7 +232,7 @@ function applySync(content, parsedTasks, results, options) {
     }
   }
 
-  return ensureTrailingNewline(lines.join('\n'));
+  return { content: ensureTrailingNewline(lines.join('\n')), changes };
 }
 
 module.exports = {

package/src/validator/index.js

@@ -13,7 +13,11 @@ const CODE_EXTENSIONS = new Set([
 ]);
 const TRANSLATION_DIR_SEGMENTS = ['locale', 'locales', 'i18n', 'translations'];
 const DEFAULT_EXCLUDED_PATH_PREFIXES = ['.claude/', '.agent/', 'roadmap-skill/'];
-const GENERATED_OUTPUT_PREFIXES = ['dist-electron/', 'dist/', 'build/', 'out/', '.next/', 'coverage/'];
+const GENERATED_OUTPUT_PREFIXES = [
+  'dist-electron/', 'dist/', 'build/', 'out/', '.next/', 'coverage/',
+  '.open-next/', '.vercel/', '.svelte-kit/', '.parcel-cache/', '.angular/',
+  '.expo/', '.serverless/', '.wrangler/', '.tmp/', 'tmp/'
+];
 const AUXILIARY_HEURISTIC_PATH_SEGMENTS = new Set(['scripts', 'tools', 'tooling', 'demo', 'demos']);
 
 // "docs" omitted from DOC_HINTS — it is a path prefix in scan tasks, not a doc-authoring keyword.
@@ -246,6 +250,7 @@ function readFileIndex(projectRoot, files, config) {
     if (SELF_REFERENTIAL_FILES.has(relativePath)) continue;
     if (isFixturePath(relativePath)) continue;
     if (shouldExcludeByDefaultPath(relativePath, config)) continue;
+    if (isGeneratedOutputPath(relativePath)) continue;
 
     const absolutePath = path.resolve(projectRoot, relativePath);
     const ext = path.extname(relativePath).toLowerCase();
@@ -1774,7 +1779,10 @@ function evaluateDeterministicVerification(task, context) {
 }
 
 function buildValidationContext(projectRoot, config, plugins, options = {}) {
-  const files = walkFiles(projectRoot);
+  const userExcludeDirs = Array.isArray(config && config.scan && config.scan.excludeDirs)
+    ? config.scan.excludeDirs
+    : [];
+  const files = walkFiles(projectRoot, { extraIgnoredDirs: userExcludeDirs });
   const fileIndex = readFileIndex(projectRoot, files, config);
   const testFrameworks = detectTestFrameworks(projectRoot, files);
   const pathHintResolver = buildPathHintResolver(fileIndex);
@@ -1852,6 +1860,39 @@ function buildDiscoveredEvidenceLine(evidence) {
 }
 
 function validateTask(task, context, config, plugins) {
+  if (task.verifiedBy === 'human') {
+    const hasEvidenceLine = Array.isArray(task.evidenceLines) &&
+      task.evidenceLines.some((e) => e.text && e.text.trim().length > 0);
+    if (!hasEvidenceLine) {
+      return {
+        passed: false,
+        confidence: 'low',
+        attempted: false,
+        reasons: ['human-verified tasks require an Evidence: child line'],
+        evidence: { code: false, test: false, artifact: false, files: [], codeFiles: [], testFiles: [], weakPathFiles: [], weakPathContentTokens: [], artifactFiles: [], heuristicArtifacts: [], symbols: [], structuralEvidence: null, authoritative: false, authoritativeFiles: [], authoritativeSummaries: [] },
+        diagnostics: [],
+        verificationRecipe: null,
+        staleEvidenceDetected: false,
+        staleEvidenceResolved: false,
+        generatedTestEvidence: null
+      };
+    }
+    const evidenceText = task.evidenceLines[0].text;
+    return {
+      passed: true,
+      confidence: 'medium',
+      attempted: true,
+      reasons: [],
+      evidence: { code: false, test: false, artifact: false, files: [], codeFiles: [], testFiles: [], weakPathFiles: [], weakPathContentTokens: [], artifactFiles: [], heuristicArtifacts: [], symbols: [], structuralEvidence: null, authoritative: true, authoritativeFiles: [], authoritativeSummaries: [evidenceText] },
+      diagnostics: [],
+      verificationRecipe: null,
+      staleEvidenceDetected: false,
+      staleEvidenceResolved: false,
+      generatedTestEvidence: null,
+      humanVerified: true
+    };
+  }
+
   const {
     paths: pathHints,
     externalPaths,
@@ -1943,6 +1984,7 @@ function validateTask(task, context, config, plugins) {
 
   const requiresTest =
     !task.noTest &&
+    task.kind !== 'docs' &&
     context.testFrameworks.length > 0 &&
     isCodeTask(task.text) &&
     !isDocTask(task.text) &&
@@ -2010,6 +2052,7 @@ function validateTask(task, context, config, plugins) {
   // Only pure path hints (not line-reference hints like file.ts:169) count as direct evidence.
   const hasDirectReferencePass = filesFromPurePathHints.length > 0 || filesFromSymbols.length > 0;
   const hasArtifactTaskPass = evidence.artifact && (
+    task.kind === 'docs' ||
     isDocTask(task.text) ||
     evidence.heuristicArtifacts.length > 0 ||
     filesFromPaths.some((relativePath) => !CODE_EXTENSIONS.has(path.extname(relativePath).toLowerCase()))
@@ -2226,17 +2269,23 @@ function validateTasks(tasks, context, config, plugins) {
   return result;
 }
 
-function auditValidation(tasks, results) {
+function auditValidation(tasks, results, changes) {
   const checkedWithoutEvidence = [];
   const readyButUnchecked = [];
   const checkedWithWeakEvidence = [];
   const documentationOnlyEvidenceForImplementation = [];
   const checkedWithNoStructuralEvidence = [];
+  const humanVerifiedTasks = [];
+  const newlyUnchecked = Array.isArray(changes && changes.newlyUnchecked) ? changes.newlyUnchecked : [];
 
   for (const task of tasks) {
     const result = results[task.id];
     if (!result) continue;
 
+    if (result.humanVerified) {
+      humanVerifiedTasks.push({ task, result });
+    }
+
     if (task.checked && !result.passed) {
       checkedWithoutEvidence.push({ task, result });
     }
@@ -2265,6 +2314,8 @@ function auditValidation(tasks, results) {
     checkedWithWeakEvidence,
     documentationOnlyEvidenceForImplementation,
     checkedWithNoStructuralEvidence,
+    humanVerifiedTasks,
+    newlyUnchecked
   };
 }