@slope-dev/slope 1.60.0 → 1.61.0

package/dist/cli/commands/review.js

@@ -1,49 +1,69 @@
-import { mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
-import { dirname, isAbsolute, join } from 'node:path';
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
+import { dirname, isAbsolute, join, relative, resolve } from 'node:path';
 import { formatSprintReview, compareSprintIds, normalizeScorecard, parseSprintNumber } from '../../core/index.js';
 import { loadConfig } from '../config.js';
 import { resolveMetaphor } from '../metaphor.js';
-import { updateGate } from '../sprint-state.js';
-export function reviewCommand(path, mode, metaphorFlag, outputPath) {
-    const config = loadConfig();
-    const cwd = process.cwd();
-    const metaphor = resolveMetaphor(metaphorFlag ? [`--metaphor=${metaphorFlag}`] : [], config.metaphor);
-    if (!path) {
-        // Default to latest scorecard
-        const dir = join(cwd, config.scorecardDir);
-        const patternParts = config.scorecardPattern.split('*');
-        const prefix = patternParts[0] ?? '';
-        const suffix = patternParts[1] ?? '';
-        const regex = new RegExp(`^${prefix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}(\\d+(?:\\.\\d+)?)${suffix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}$`);
-        try {
-            const files = readdirSync(dir)
-                .filter((f) => {
-                const m = f.match(regex);
-                const sprint = m ? parseSprintNumber(m[1]) : null;
-                return sprint != null && sprint >= config.minSprint;
-            })
-                .sort((a, b) => {
-                const na = parseSprintNumber(a.match(regex)?.[1] ?? '0') ?? 0;
-                const nb = parseSprintNumber(b.match(regex)?.[1] ?? '0') ?? 0;
-                return compareSprintIds(na, nb);
-            });
-            if (files.length === 0) {
-                console.log('\nNo scorecards found.\n');
-                process.exit(1);
-            }
-            path = join(dir, files[files.length - 1]);
+import { loadSprintState, updateGate } from '../sprint-state.js';
+function discoverScorecardPaths(cwd, config) {
+    const dir = join(cwd, config.scorecardDir);
+    if (!existsSync(dir))
+        return [];
+    const patternParts = config.scorecardPattern.split('*');
+    const prefix = patternParts[0] ?? '';
+    const suffix = patternParts[1] ?? '';
+    const escapeRegex = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const regex = new RegExp(`^${escapeRegex(prefix)}(\\d+(?:\\.\\d+)?)${escapeRegex(suffix)}$`);
+    return readdirSync(dir)
+        .map(file => ({ file, sprint: parseSprintNumber(file.match(regex)?.[1] ?? '') }))
+        .filter((entry) => entry.sprint != null && entry.sprint >= config.minSprint)
+        .sort((a, b) => compareSprintIds(a.sprint, b.sprint))
+        .map(entry => join(dir, entry.file));
+}
+function resolveScorecardPath(path, sprintSelector, cwd, config) {
+    if (path && sprintSelector) {
+        console.error('\nUse either an explicit scorecard path or --sprint, not both.\n');
+        process.exit(1);
+    }
+    if (path)
+        return isAbsolute(path) ? path : resolve(cwd, path);
+    if (sprintSelector) {
+        const sprint = parseSprintNumber(sprintSelector);
+        if (sprint == null) {
+            console.error(`\nInvalid sprint selector: ${sprintSelector}\n`);
+            process.exit(1);
         }
-        catch {
-            console.log('\nScorecard directory not found.\n');
+        const selected = join(cwd, config.scorecardDir, config.scorecardPattern.replace('*', String(sprint)));
+        if (!existsSync(selected)) {
+            console.error(`\nScorecard not found for Sprint ${sprint}: ${relative(cwd, selected)}\n`);
             process.exit(1);
         }
+        return selected;
+    }
+    const scorecards = discoverScorecardPaths(cwd, config);
+    if (scorecards.length === 0) {
+        console.error('\nNo scorecards found. Pass an explicit scorecard path.\n');
+        process.exit(1);
+    }
+    if (scorecards.length > 1) {
+        console.error('\nMultiple scorecards found; refusing to guess which sprint to review.');
+        console.error('Pass an explicit path, for example:');
+        console.error(`  slope review ${relative(cwd, scorecards[scorecards.length - 1])}`);
+        console.error('');
+        process.exit(1);
     }
+    return scorecards[0];
+}
+export function reviewCommand(path, mode, metaphorFlag, outputPath, sprintSelector) {
+    const config = loadConfig();
+    const cwd = process.cwd();
+    const metaphor = resolveMetaphor(metaphorFlag ? [`--metaphor=${metaphorFlag}`] : [], config.metaphor);
+    const scorecardPath = resolveScorecardPath(path, sprintSelector, cwd, config);
     let raw;
     try {
-        raw = JSON.parse(readFileSync(path, 'utf8'));
+        raw = JSON.parse(readFileSync(scorecardPath, 'utf8'));
     }
     catch {
-        console.error(`\nFailed to parse ${path}\n`);
+        console.error(`\nFailed to parse ${scorecardPath}\n`);
         process.exit(1);
     }
     const card = normalizeScorecard(raw);
@@ -54,12 +74,20 @@ export function reviewCommand(path, mode, metaphorFlag, outputPath) {
     if (outputPath !== null) {
         const reviewPath = outputPath
             ? isAbsolute(outputPath) ? outputPath : join(cwd, outputPath)
-            : join(cwd, config.scorecardDir, `sprint-${card.sprint_number}-review.md`);
+            : join(dirname(scorecardPath), `sprint-${card.sprint_number}-review.md`);
         mkdirSync(dirname(reviewPath), { recursive: true });
         writeFileSync(reviewPath, review + '\n');
-        console.log(`\nReview written: ${reviewPath.replace(cwd + '/', '')}`);
+        console.error(`\nReview written: ${relative(cwd, reviewPath)}`);
+    }
+    // Generating a historical sprint's review must not complete a different
+    // active sprint's gate.
+    const sprintState = loadSprintState(cwd);
+    if (sprintState?.sprint === card.sprint_number) {
+        updateGate(cwd, 'review_md', true);
     }
-    // Mark review_md gate complete
-    updateGate(cwd, 'review_md', true);
 }
+export const reviewCommandInternals = {
+    discoverScorecardPaths,
+    resolveScorecardPath,
+};
 //# sourceMappingURL=review.js.map

package/dist/cli/commands/review.js.map

@@ -1 +1 @@
-{"version":3,"file":"review.js","sourceRoot":"","sources":["../../../src/cli/commands/review.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../../src/cli/commands/review.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/roadmap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"roadmap.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/roadmap.ts"],"names":[],"mappings":"AAktBA,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA0DlE"}
+{"version":3,"file":"roadmap.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/roadmap.ts"],"names":[],"mappings":"AA8+BA,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA6ElE"}

package/dist/cli/commands/roadmap.js

@@ -1,14 +1,15 @@
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
-import { join } from 'node:path';
-import { parseRoadmap, validateRoadmap, castRoadmapStructure, findShippedSprintsOnMain, compareSprintIds, computeCriticalPath, findParallelOpportunities, formatSprintLabel, formatRoadmapSummary, formatStrategicContext, isRoadmapSprintPending, loadScorecards, loadVision, parseSprintNumber, analyzeBacklog, mergeBacklogs, runAnalyzers, estimateComplexity, generateRoadmapFromVision, RoadmapGenerationError, } from '../../core/index.js';
+import { dirname, join, relative, resolve } from 'node:path';
+import { parseRoadmap, validateRoadmap, castRoadmapStructure, findShippedSprintsOnMain, compareSprintIds, computeCriticalPath, findParallelOpportunities, formatSprintLabel, formatRoadmapSummary, formatStrategicContext, buildRoadmapFocus, formatRoadmapFocus, formatRoadmapSprintLabel, roadmapSprintOrderValue, isRoadmapSprintPending, loadScorecards, discoverScorecardFiles, sprintNumberFromScorecardFile, loadVision, parseSprintNumber, analyzeBacklog, mergeBacklogs, runAnalyzers, estimateComplexity, generateRoadmapFromVision, RoadmapGenerationError, } from '../../core/index.js';
 import { loadConfig } from '../config.js';
-import { buildRoadmapReality, formatRoadmapRealitySection } from '../pre-sprint-reality.js';
+import { buildRoadmapReality, formatRoadmapRealitySection, roadmapRealityIssues } from '../pre-sprint-reality.js';
 import { interviewCommand } from './interview.js';
+import { loadRoadmapSourceStore, hasModularRoadmapSources, planRoadmapSourceArchive, applyRoadmapSourceArchive, validateRoadmapSourceStore, writeRoadmapSourceProjection, } from '../roadmap-source-store.js';
 // --- Helpers ---
 function parseArgs(args) {
     const result = {};
     for (const arg of args) {
-        const match = arg.match(/^--(\w[\w-]*)(?:=(.+))?$/);
+        const match = arg.match(/^--(\w[\w-]*)(?:=(.*))?$/);
         if (match)
             result[match[1]] = match[2] ?? 'true';
     }
@@ -301,6 +302,225 @@ function statusSubcommand(flags, cwd) {
         printCompactRoadmapStatus(roadmap, currentSprint, completedSprints, cwd);
     }
 }
+function displayPath(cwd, path) {
+    return relative(cwd, resolve(cwd, path)).replace(/\\/g, '/');
+}
+function focusEvidence(roadmap, sprintId, flags, cwd) {
+    const config = loadConfig(cwd);
+    const evidence = [{
+            kind: 'roadmap',
+            label: 'Roadmap source',
+            ref: displayPath(cwd, resolveRoadmapPath(flags, cwd)),
+            sprint: sprintId,
+        }];
+    const selected = roadmap.sprints.find(sprint => sprint.id === sprintId);
+    const phase = roadmap.phases.find(candidate => candidate.sprints.includes(sprintId));
+    const phaseIndex = phase?.sprints.indexOf(sprintId) ?? -1;
+    const contextIds = new Set([
+        sprintId,
+        ...(selected?.depends_on ?? []),
+        ...(phaseIndex < 0 ? [] : phase.sprints.slice(Math.max(0, phaseIndex - 2), phaseIndex)),
+    ]);
+    const contextByValue = new Map([...contextIds].map(id => [roadmapSprintOrderValue(roadmap, id), id]));
+    for (const path of discoverScorecardFiles(config, cwd)) {
+        const scorecardSprint = sprintNumberFromScorecardFile(path, config);
+        if (scorecardSprint == null)
+            continue;
+        const roadmapSprintId = contextByValue.get(roadmapSprintOrderValue(roadmap, scorecardSprint));
+        if (roadmapSprintId == null)
+            continue;
+        evidence.push({
+            kind: 'scorecard',
+            label: `${formatRoadmapSprintLabel(roadmap, roadmapSprintId)} scorecard`,
+            ref: displayPath(cwd, path),
+            sprint: roadmapSprintId,
+        });
+        const reviewPath = [scorecardSprint, roadmapSprintId]
+            .map(id => join(dirname(path), `sprint-${id}-review.md`))
+            .find(candidate => existsSync(candidate));
+        if (reviewPath) {
+            evidence.push({
+                kind: 'review',
+                label: `${formatRoadmapSprintLabel(roadmap, roadmapSprintId)} review`,
+                ref: displayPath(cwd, reviewPath),
+                sprint: roadmapSprintId,
+            });
+        }
+    }
+    return evidence;
+}
+function focusSubcommand(flags, cwd) {
+    if (!Object.prototype.hasOwnProperty.call(flags, 'sprint') || flags.sprint === 'true') {
+        console.error('\nMissing required --sprint=N for roadmap focus.');
+        console.error('Usage: slope roadmap focus --sprint=N [--path=<file>] [--json]\n');
+        process.exit(1);
+        return;
+    }
+    const sprintId = parseSprintNumber(flags.sprint);
+    if (sprintId == null) {
+        console.error(`\nInvalid sprint number: ${flags.sprint || '(empty)'}`);
+        console.error('Usage: slope roadmap focus --sprint=N [--path=<file>] [--json]\n');
+        process.exit(1);
+        return;
+    }
+    const roadmap = loadRoadmapFile(flags, cwd);
+    if (!roadmap) {
+        process.exit(1);
+        return;
+    }
+    const config = loadConfig(cwd);
+    const scorecards = loadScorecards(config, cwd);
+    const completedSprintIds = scorecards.map(card => card.sprint_number);
+    const hazards = roadmapRealityIssues(buildRoadmapReality(cwd, roadmap), sprintId)
+        .map(issue => ({
+        sprint: sprintId,
+        sprint_label: formatRoadmapSprintLabel(roadmap, sprintId),
+        type: 'roadmap_reality',
+        severity: issue.type === 'error' ? 'major' : 'minor',
+        description: issue.message,
+    }));
+    const focus = buildRoadmapFocus(roadmap, sprintId, {
+        completedSprintIds,
+        hazards,
+        scorecards,
+        evidence: focusEvidence(roadmap, sprintId, flags, cwd),
+    });
+    if (!focus) {
+        console.error(`\nSprint ${formatRoadmapSprintLabel(roadmap, sprintId)} was not found in the roadmap.\n`);
+        process.exit(1);
+        return;
+    }
+    if (flags.json === 'true') {
+        console.log(JSON.stringify(focus, null, 2));
+    }
+    else {
+        console.log(formatRoadmapFocus(focus).trimEnd());
+    }
+}
+function compileSourcesSubcommand(flags, cwd) {
+    try {
+        const store = loadRoadmapSourceStore(cwd, flags.source);
+        const validation = validateRoadmapSourceStore(store, { checkProjection: false });
+        if (!validation.valid) {
+            throw new Error([
+                'Modular roadmap sources are invalid:',
+                ...validation.errors.map(issue => `  - ${issue.source ? `${issue.source}: ` : ''}${issue.message}`),
+                'Run `slope roadmap validate-sources` for the full report.',
+            ].join('\n'));
+        }
+        const existing = existsSync(store.outputPath) ? readFileSync(store.outputPath, 'utf8') : null;
+        const changed = existing !== store.projection;
+        const output = displayPath(cwd, store.outputPath);
+        if (flags.check === 'true') {
+            if (changed) {
+                throw new Error(`Roadmap projection drift: ${output}. Run \`slope roadmap compile\` to regenerate it from modular sources.`);
+            }
+            console.log(`\nRoadmap projection is current: ${output}\n`);
+            return;
+        }
+        if (flags['dry-run'] === 'true') {
+            console.log(`\nRoadmap compile dry run: ${changed ? 'would write' : 'already current'} ${output}`);
+            console.log(`  Sources: ${store.sources.length}; phases: ${store.roadmap.phases.length}; sprints: ${store.roadmap.sprints.length}\n`);
+            return;
+        }
+        const result = writeRoadmapSourceProjection(store);
+        console.log(`\nRoadmap projection ${result}: ${output}`);
+        console.log(`  Sources: ${store.sources.length}; phases: ${store.roadmap.phases.length}; sprints: ${store.roadmap.sprints.length}\n`);
+    }
+    catch (error) {
+        console.error(`\n${error.message}\n`);
+        process.exit(1);
+    }
+}
+function validateSourcesSubcommand(flags, cwd) {
+    const explicitSource = Object.prototype.hasOwnProperty.call(flags, 'source');
+    let sourceExists;
+    try {
+        sourceExists = hasModularRoadmapSources(cwd, flags.source);
+    }
+    catch (error) {
+        console.error(`\n${error.message}\n`);
+        process.exit(1);
+        return;
+    }
+    if (!sourceExists) {
+        if (explicitSource) {
+            console.error(`\nModular roadmap manifest not found: ${flags.source || '(empty)'}\n`);
+            process.exit(1);
+            return;
+        }
+        console.log('\nSingle-file roadmap mode; run `slope roadmap validate` for docs/backlog/roadmap.json.\n');
+        return;
+    }
+    let store;
+    try {
+        store = loadRoadmapSourceStore(cwd, flags.source);
+    }
+    catch (error) {
+        console.error(`\n${error.message}\n`);
+        process.exit(1);
+        return;
+    }
+    const validation = validateRoadmapSourceStore(store);
+    console.log(`\nModular roadmap sources: ${displayPath(cwd, store.manifestPath)}`);
+    console.log('═'.repeat(40));
+    if (validation.valid) {
+        console.log('\n✓ Modular sources and compiled projection are valid');
+    }
+    else {
+        console.log(`\n✗ ${validation.errors.length} source error${validation.errors.length === 1 ? '' : 's'} found`);
+    }
+    for (const issue of validation.errors) {
+        console.log(`  ✗ ${issue.source ? `[${issue.source}] ` : ''}${issue.message}`);
+    }
+    for (const issue of validation.warnings) {
+        console.log(`  ⚠ ${issue.source ? `[${issue.source}] ` : ''}${issue.message}`);
+    }
+    console.log(`\n  Sources: ${store.sources.length}; phases: ${store.roadmap.phases.length}; sprints: ${store.roadmap.sprints.length}\n`);
+    if (!validation.valid)
+        process.exit(1);
+}
+function archiveSourcesSubcommand(flags, cwd) {
+    if (!Object.prototype.hasOwnProperty.call(flags, 'through') || flags.through === 'true') {
+        console.error('\nMissing required --through=N for roadmap archive.');
+        console.error('Usage: slope roadmap archive --through=N [--source=<file>] [--dry-run]\n');
+        process.exit(1);
+        return;
+    }
+    const through = parseSprintNumber(flags.through);
+    if (through == null) {
+        console.error(`\nInvalid archive boundary: ${flags.through || '(empty)'}\n`);
+        process.exit(1);
+        return;
+    }
+    try {
+        const store = loadRoadmapSourceStore(cwd, flags.source);
+        const projectionBefore = existsSync(store.outputPath) ? readFileSync(store.outputPath, 'utf8') : null;
+        const plan = planRoadmapSourceArchive(store, through);
+        console.log(`\nRoadmap archive through Sprint ${through}:`);
+        if (plan.moves.length === 0) {
+            console.log('  No complete live phases are eligible.\n');
+            return;
+        }
+        for (const move of plan.moves)
+            console.log(`  ${move.from} -> ${move.to}`);
+        if (flags['dry-run'] === 'true') {
+            console.log('\n  --dry-run: source files, manifest, and projection are unchanged.\n');
+            return;
+        }
+        applyRoadmapSourceArchive(store, plan);
+        const reloaded = loadRoadmapSourceStore(cwd, flags.source);
+        const validation = validateRoadmapSourceStore(reloaded);
+        if (!validation.valid || readFileSync(reloaded.outputPath, 'utf8') !== projectionBefore) {
+            throw new Error('Archive verification failed: compiled projection changed or archived evidence is invalid.');
+        }
+        console.log(`\n  Archived ${plan.moves.length} phase source${plan.moves.length === 1 ? '' : 's'}; compatibility projection unchanged.\n`);
+    }
+    catch (error) {
+        console.error(`\n${error.message}\n`);
+        process.exit(1);
+    }
+}
 function printFullRoadmapStatus(roadmap, currentSprint, completedSprints) {
     console.log(`\n# Roadmap Status — ${roadmap.name}`);
     console.log('\u2550'.repeat(40));
@@ -479,7 +699,35 @@ function mergeScorecardTickets(existingTickets, scorecardTickets) {
         return existing ? { ...existing, ...ticket } : ticket;
     });
 }
+function modularAuthorityBlocksProjectionMutation(flags, cwd, action) {
+    let defaultExists = false;
+    let explicitExists = false;
+    try {
+        defaultExists = hasModularRoadmapSources(cwd);
+        if (!defaultExists && Object.prototype.hasOwnProperty.call(flags, 'source')) {
+            explicitExists = hasModularRoadmapSources(cwd, flags.source);
+        }
+    }
+    catch (error) {
+        console.error(`\n${error.message}\n`);
+        process.exit(1);
+        return true;
+    }
+    if (!defaultExists && Object.prototype.hasOwnProperty.call(flags, 'source') && !explicitExists) {
+        console.error(`\nModular roadmap manifest not found: ${flags.source || '(empty)'}\n`);
+        process.exit(1);
+        return true;
+    }
+    if (!defaultExists && !explicitExists)
+        return false;
+    console.error(`\nModular roadmap sources are authoritative; \`roadmap ${action}\` cannot edit the generated projection.`);
+    console.error('Update the source YAML and run `slope roadmap compile`.\n');
+    process.exit(1);
+    return true;
+}
 function syncSubcommand(flags, cwd) {
+    if (modularAuthorityBlocksProjectionMutation(flags, cwd, 'sync'))
+        return;
     const dryRun = flags['dry-run'] === 'true';
     const path = resolveRoadmapPath(flags, cwd);
     const config = loadConfig(cwd);
@@ -546,6 +794,8 @@ function syncSubcommand(flags, cwd) {
     console.log(`\n  Written to ${path}\n`);
 }
 async function generateSubcommand(flags, cwd) {
+    if (modularAuthorityBlocksProjectionMutation(flags, cwd, 'generate'))
+        return;
     const vision = loadVision(cwd);
     if (!vision) {
         console.error('\nNo vision found. Create one first:');
@@ -635,6 +885,18 @@ export async function roadmapCommand(args) {
         case 'status':
             statusSubcommand(flags, cwd);
             break;
+        case 'focus':
+            focusSubcommand(flags, cwd);
+            break;
+        case 'compile':
+            compileSourcesSubcommand(flags, cwd);
+            break;
+        case 'validate-sources':
+            validateSourcesSubcommand(flags, cwd);
+            break;
+        case 'archive':
+            archiveSourcesSubcommand(flags, cwd);
+            break;
         case 'show':
             showSubcommand(flags, cwd);
             break;
@@ -656,13 +918,20 @@ Usage:
   slope roadmap validate [--path=<file>]     Schema + dependency graph checks
   slope roadmap review [--path=<file>]       Automated architect review
   slope roadmap status [--path=<file>] [--sprint=N] [--full]  Compact current progress
+  slope roadmap focus --sprint=N [--path=<file>] [--json]     Bounded sprint context
+  slope roadmap compile [--source=<file>] [--dry-run|--check] Compile modular YAML sources
+  slope roadmap validate-sources [--source=<file>]            Validate sources and projection drift
+  slope roadmap archive --through=N [--source=<file>] [--dry-run] Archive whole terminal phases
   slope roadmap show [--path=<file>]         Render summary (critical path, parallel tracks)
   slope roadmap sync [--path=<file>] [--dry-run]     Sync scorecards into roadmap
   slope roadmap generate [--path=<file>] [--dry-run] Generate from vision + concrete backlog signals
 
 Options:
   --path=<file>    Path to roadmap JSON (default: docs/backlog/roadmap.json)
-  --sprint=N       Override current sprint number (for status)
+  --sprint=N       Select a sprint (required for focus; override for status)
+  --json           Emit machine-readable focus JSON
+  --source=<file>  Modular roadmap manifest (default: docs/roadmap/project.yaml)
+  --check          Fail when the compiled roadmap projection has drifted
   --full           Show full roadmap history for status
   --dry-run        Show what would change without writing (for sync and generate)