@jonit-dev/night-watch-cli 1.4.7 → 1.5.1

package/dist/utils/roadmap-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roadmap-parser.d.ts","sourceRoot":"","sources":["../../src/utils/roadmap-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE,CAuD5D;AA4DD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAEvE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAWpF"}

package/dist/utils/roadmap-parser.js

@@ -0,0 +1,136 @@
+/**
+ * Roadmap Parser for Night Watch CLI
+ * Parses ROADMAP.md files into structured items
+ */
+import * as crypto from "crypto";
+/**
+ * Generate a hash for an item based on its title
+ * Uses first 8 characters of SHA-256 hash of lowercase trimmed title
+ */
+export function generateItemHash(title) {
+    const normalizedTitle = title.toLowerCase().trim();
+    return crypto.createHash("sha256").update(normalizedTitle).digest("hex").slice(0, 8);
+}
+/**
+ * Parse ROADMAP.md content into structured items
+ *
+ * Supports two formats:
+ * 1. Checklist format: Lines matching `- [ ] Title` or `- [x] Title`
+ *    with optional description on following indented lines
+ * 2. Heading format: `### Title` followed by body text (until next heading)
+ *
+ * @param content - The raw ROADMAP.md content
+ * @returns Array of parsed roadmap items
+ */
+export function parseRoadmap(content) {
+    const items = [];
+    const lines = content.split("\n");
+    let currentSection = "General";
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Track section headers (## headings)
+        const sectionMatch = line.match(/^##\s+(.+)$/);
+        if (sectionMatch) {
+            currentSection = sectionMatch[1].trim();
+            continue;
+        }
+        // Parse checklist items: - [ ] Title or - [x] Title
+        const checklistMatch = line.match(/^-\s+\[([ xX])\]\s+(.+)$/);
+        if (checklistMatch) {
+            const checked = checklistMatch[1].toLowerCase() === "x";
+            const title = checklistMatch[2].trim();
+            // Collect description from following indented lines
+            const description = collectDescription(lines, i + 1);
+            items.push({
+                hash: generateItemHash(title),
+                title,
+                description,
+                checked,
+                section: currentSection,
+            });
+            continue;
+        }
+        // Parse heading-based items: ### Title followed by body
+        const headingMatch = line.match(/^###\s+(.+)$/);
+        if (headingMatch) {
+            const title = headingMatch[1].trim();
+            // Collect description from following lines until next heading
+            const description = collectDescriptionUntilNextHeading(lines, i + 1);
+            items.push({
+                hash: generateItemHash(title),
+                title,
+                description,
+                checked: false, // Heading-based items are never checked
+                section: currentSection,
+            });
+            continue;
+        }
+    }
+    return items;
+}
+/**
+ * Collect description from indented lines following a checklist item
+ * Stops when reaching a non-indented line, another list item, or a heading
+ */
+function collectDescription(lines, startIndex) {
+    const descriptionLines = [];
+    for (let i = startIndex; i < lines.length; i++) {
+        const line = lines[i];
+        // Stop at empty line
+        if (line.trim() === "") {
+            break;
+        }
+        // Stop at non-indented line (including headings, other list items)
+        if (!line.startsWith("  ") && !line.startsWith("\t")) {
+            break;
+        }
+        // Add the line, stripping leading indentation
+        descriptionLines.push(line.trim());
+    }
+    return descriptionLines.join("\n");
+}
+/**
+ * Collect description from lines following a ### heading
+ * Stops when reaching another heading (## or ###)
+ */
+function collectDescriptionUntilNextHeading(lines, startIndex) {
+    const descriptionLines = [];
+    for (let i = startIndex; i < lines.length; i++) {
+        const line = lines[i];
+        // Stop at any heading
+        if (line.match(/^#{1,3}\s+/)) {
+            break;
+        }
+        // Stop at empty line followed by another heading
+        if (line.trim() === "") {
+            // Look ahead for heading
+            if (i + 1 < lines.length && lines[i + 1].match(/^#{1,3}\s+/)) {
+                break;
+            }
+        }
+        descriptionLines.push(line);
+    }
+    // Trim trailing empty lines and join
+    const result = descriptionLines.join("\n").trim();
+    return result;
+}
+/**
+ * Filter roadmap items to only unchecked items (pending work)
+ */
+export function getUncheckedItems(items) {
+    return items.filter((item) => !item.checked);
+}
+/**
+ * Group roadmap items by section
+ */
+export function groupBySection(items) {
+    const groups = {};
+    for (const item of items) {
+        if (!groups[item.section]) {
+            groups[item.section] = [];
+        }
+        groups[item.section].push(item);
+    }
+    return groups;
+}
+//# sourceMappingURL=roadmap-parser.js.map

package/dist/utils/roadmap-parser.js.map

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

package/dist/utils/roadmap-scanner.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Roadmap Scanner for Night Watch CLI
+ * Scans ROADMAP.md files and generates PRD skeleton files
+ */
+import { INightWatchConfig } from "../types.js";
+import { IRoadmapItem } from "./roadmap-parser.js";
+/**
+ * Status of the roadmap scanner
+ */
+export interface IRoadmapStatus {
+    /** Whether ROADMAP.md file was found */
+    found: boolean;
+    /** Whether the scanner is enabled in config */
+    enabled: boolean;
+    /** Total number of items in roadmap */
+    totalItems: number;
+    /** Number of items that have been processed */
+    processedItems: number;
+    /** Number of items pending processing */
+    pendingItems: number;
+    /** Current status of the scanner */
+    status: "idle" | "scanning" | "complete" | "disabled" | "no-roadmap";
+    /** All roadmap items with processing status */
+    items: Array<IRoadmapItem & {
+        processed: boolean;
+        prdFile?: string;
+    }>;
+}
+/**
+ * Result of a roadmap scan operation
+ */
+export interface IScanResult {
+    /** List of PRD files created */
+    created: string[];
+    /** List of items skipped (already processed or checked) */
+    skipped: string[];
+    /** List of errors encountered */
+    errors: string[];
+}
+/**
+ * Get the current status of the roadmap scanner
+ *
+ * @param projectDir - The project directory
+ * @param config - The Night Watch configuration
+ * @returns The roadmap scanner status
+ */
+export declare function getRoadmapStatus(projectDir: string, config: INightWatchConfig): IRoadmapStatus;
+/**
+ * Scan the roadmap and create PRD files for unprocessed items
+ *
+ * @param projectDir - The project directory
+ * @param config - The Night Watch configuration
+ * @returns The scan result with created, skipped, and error lists
+ */
+export declare function scanRoadmap(projectDir: string, config: INightWatchConfig): IScanResult;
+/**
+ * Check if there are new (unprocessed) items in the roadmap
+ */
+export declare function hasNewItems(projectDir: string, config: INightWatchConfig): boolean;
+//# sourceMappingURL=roadmap-scanner.d.ts.map

package/dist/utils/roadmap-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roadmap-scanner.d.ts","sourceRoot":"","sources":["../../src/utils/roadmap-scanner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAE,YAAY,EAAgB,MAAM,qBAAqB,CAAC;AASjE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,cAAc,EAAE,MAAM,CAAC;IACvB,yCAAyC;IACzC,YAAY,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,YAAY,CAAC;IACrE,+CAA+C;IAC/C,KAAK,EAAE,KAAK,CAAC,YAAY,GAAG;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACvE;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iCAAiC;IACjC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,iBAAiB,GACxB,cAAc,CA+EhB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,iBAAiB,GACxB,WAAW,CAsFb;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAGT"}

package/dist/utils/roadmap-scanner.js

@@ -0,0 +1,236 @@
+/**
+ * Roadmap Scanner for Night Watch CLI
+ * Scans ROADMAP.md files and generates PRD skeleton files
+ */
+import * as fs from "fs";
+import * as path from "path";
+import { getNextPrdNumber, slugify } from "../commands/prd.js";
+import { renderPrdTemplate } from "../templates/prd-template.js";
+import { parseRoadmap } from "./roadmap-parser.js";
+import { isItemProcessed, loadRoadmapState, markItemProcessed, saveRoadmapState, } from "./roadmap-state.js";
+/**
+ * Get the current status of the roadmap scanner
+ *
+ * @param projectDir - The project directory
+ * @param config - The Night Watch configuration
+ * @returns The roadmap scanner status
+ */
+export function getRoadmapStatus(projectDir, config) {
+    const roadmapPath = path.join(projectDir, config.roadmapScanner.roadmapPath);
+    // Check if enabled
+    if (!config.roadmapScanner.enabled) {
+        return {
+            found: false,
+            enabled: false,
+            totalItems: 0,
+            processedItems: 0,
+            pendingItems: 0,
+            status: "disabled",
+            items: [],
+        };
+    }
+    // Check if roadmap file exists
+    if (!fs.existsSync(roadmapPath)) {
+        return {
+            found: false,
+            enabled: true,
+            totalItems: 0,
+            processedItems: 0,
+            pendingItems: 0,
+            status: "no-roadmap",
+            items: [],
+        };
+    }
+    // Parse roadmap
+    const content = fs.readFileSync(roadmapPath, "utf-8");
+    const items = parseRoadmap(content);
+    // Load state
+    const prdDir = path.join(projectDir, config.prdDir);
+    const state = loadRoadmapState(prdDir);
+    // Scan existing PRD files for title-based duplicate detection
+    const existingPrdSlugs = scanExistingPrdSlugs(prdDir);
+    // Build status items
+    const statusItems = items.map((item) => {
+        const processed = isItemProcessed(state, item.hash);
+        const stateItem = state.items[item.hash];
+        // Also check for duplicates by title match
+        const itemSlug = slugify(item.title);
+        const isDuplicateByTitle = existingPrdSlugs.has(itemSlug) && !processed;
+        return {
+            ...item,
+            processed: processed || isDuplicateByTitle,
+            prdFile: stateItem?.prdFile,
+        };
+    });
+    // Count processed and pending
+    const processedItems = statusItems.filter((item) => item.processed).length;
+    const pendingItems = statusItems.filter((item) => !item.processed && !item.checked).length;
+    // Determine status
+    let status;
+    if (pendingItems === 0 && statusItems.length > 0) {
+        status = "complete";
+    }
+    else {
+        status = "idle";
+    }
+    return {
+        found: true,
+        enabled: true,
+        totalItems: items.length,
+        processedItems,
+        pendingItems,
+        status,
+        items: statusItems,
+    };
+}
+/**
+ * Scan the roadmap and create PRD files for unprocessed items
+ *
+ * @param projectDir - The project directory
+ * @param config - The Night Watch configuration
+ * @returns The scan result with created, skipped, and error lists
+ */
+export function scanRoadmap(projectDir, config) {
+    const result = {
+        created: [],
+        skipped: [],
+        errors: [],
+    };
+    // Check if enabled
+    if (!config.roadmapScanner.enabled) {
+        return result;
+    }
+    const roadmapPath = path.join(projectDir, config.roadmapScanner.roadmapPath);
+    // Check if roadmap file exists
+    if (!fs.existsSync(roadmapPath)) {
+        return result;
+    }
+    // Parse roadmap
+    const content = fs.readFileSync(roadmapPath, "utf-8");
+    const items = parseRoadmap(content);
+    if (items.length === 0) {
+        return result;
+    }
+    // Setup PRD directory
+    const prdDir = path.join(projectDir, config.prdDir);
+    if (!fs.existsSync(prdDir)) {
+        fs.mkdirSync(prdDir, { recursive: true });
+    }
+    // Load state
+    let state = loadRoadmapState(prdDir);
+    // Scan existing PRD files for title-based duplicate detection
+    const existingPrdSlugs = scanExistingPrdSlugs(prdDir);
+    // Process each item
+    for (const item of items) {
+        // Skip checked items (completed in roadmap)
+        if (item.checked) {
+            result.skipped.push(`${item.title} (checked)`);
+            continue;
+        }
+        // Skip already processed items
+        if (isItemProcessed(state, item.hash)) {
+            result.skipped.push(`${item.title} (processed)`);
+            continue;
+        }
+        // Skip items that have a PRD with matching title
+        const itemSlug = slugify(item.title);
+        if (existingPrdSlugs.has(itemSlug)) {
+            result.skipped.push(`${item.title} (duplicate by title)`);
+            continue;
+        }
+        try {
+            // Generate PRD file
+            const prdFile = createPrdFromItem(prdDir, item);
+            // Update state
+            const stateItem = {
+                title: item.title,
+                prdFile,
+                createdAt: new Date().toISOString(),
+            };
+            state = markItemProcessed(state, item.hash, stateItem);
+            // Add to existing slugs to prevent duplicates in same scan
+            existingPrdSlugs.add(itemSlug);
+            result.created.push(prdFile);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            result.errors.push(`${item.title}: ${errorMessage}`);
+        }
+    }
+    // Save state
+    saveRoadmapState(prdDir, state);
+    return result;
+}
+/**
+ * Check if there are new (unprocessed) items in the roadmap
+ */
+export function hasNewItems(projectDir, config) {
+    const status = getRoadmapStatus(projectDir, config);
+    return status.pendingItems > 0;
+}
+/**
+ * Scan existing PRD files and extract their slugs for duplicate detection
+ */
+function scanExistingPrdSlugs(prdDir) {
+    const slugs = new Set();
+    if (!fs.existsSync(prdDir)) {
+        return slugs;
+    }
+    const files = fs.readdirSync(prdDir);
+    for (const file of files) {
+        // Skip non-markdown files and special files
+        if (!file.endsWith(".md") || file === "NIGHT-WATCH-SUMMARY.md") {
+            continue;
+        }
+        // Extract slug from filename (e.g., "01-feature-name.md" -> "feature-name")
+        const match = file.match(/^\d+-(.+)\.md$/);
+        if (match) {
+            slugs.add(match[1]);
+        }
+        else {
+            // Handle files without number prefix
+            const slugMatch = file.match(/^(.+)\.md$/);
+            if (slugMatch) {
+                slugs.add(slugMatch[1]);
+            }
+        }
+    }
+    return slugs;
+}
+/**
+ * Create a PRD file from a roadmap item
+ *
+ * @param prdDir - The PRD directory
+ * @param item - The roadmap item
+ * @returns The filename of the created PRD
+ */
+function createPrdFromItem(prdDir, item) {
+    // Get next PRD number
+    const nextNum = getNextPrdNumber(prdDir);
+    const padded = String(nextNum).padStart(2, "0");
+    // Generate filename
+    const slug = slugify(item.title);
+    const filename = `${padded}-${slug}.md`;
+    const filePath = path.join(prdDir, filename);
+    // Render PRD template
+    const prdContent = renderPrdTemplate({
+        title: item.title,
+        dependsOn: [],
+        complexityScore: 5,
+        complexityLevel: "MEDIUM",
+        complexityBreakdown: [],
+        phaseCount: 3,
+    });
+    // Prepend roadmap context comment
+    const roadmapContext = `<!-- Roadmap Context:
+Section: ${item.section}
+Description: ${item.description}
+-->
+
+`;
+    const fullContent = roadmapContext + prdContent;
+    // Write file
+    fs.writeFileSync(filePath, fullContent, "utf-8");
+    return filename;
+}
+//# sourceMappingURL=roadmap-scanner.js.map

package/dist/utils/roadmap-scanner.js.map

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

package/dist/utils/roadmap-state.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Roadmap State Manager for Night Watch CLI
+ * Manages .roadmap-state.json for tracking processed items
+ */
+/**
+ * Represents the state of a single processed roadmap item
+ */
+export interface IRoadmapStateItem {
+    /** Original title from roadmap */
+    title: string;
+    /** Path to the generated PRD file */
+    prdFile: string;
+    /** ISO timestamp when item was processed */
+    createdAt: string;
+}
+/**
+ * Represents the full roadmap state persisted to .roadmap-state.json
+ */
+export interface IRoadmapState {
+    /** State file format version */
+    version: number;
+    /** ISO timestamp of last scan */
+    lastScan: string;
+    /** Map of item hash to state item */
+    items: Record<string, IRoadmapStateItem>;
+}
+/**
+ * Get the path to the roadmap state file
+ */
+export declare function getStateFilePath(prdDir: string): string;
+/**
+ * Load the roadmap state from disk
+ * Returns an empty state if the file does not exist or is invalid
+ *
+ * @param prdDir - Directory containing PRD files (where state file lives)
+ * @returns The loaded or empty roadmap state
+ */
+export declare function loadRoadmapState(prdDir: string): IRoadmapState;
+/**
+ * Save the roadmap state to disk
+ *
+ * @param prdDir - Directory containing PRD files (where state file lives)
+ * @param state - The state to save
+ */
+export declare function saveRoadmapState(prdDir: string, state: IRoadmapState): void;
+/**
+ * Create an empty roadmap state
+ */
+export declare function createEmptyState(): IRoadmapState;
+/**
+ * Check if an item has already been processed
+ *
+ * @param state - The roadmap state
+ * @param hash - The item hash to check
+ * @returns True if the item has been processed
+ */
+export declare function isItemProcessed(state: IRoadmapState, hash: string): boolean;
+/**
+ * Mark an item as processed in the state
+ *
+ * @param state - The roadmap state (will be mutated)
+ * @param hash - The item hash
+ * @param item - The state item data
+ * @returns The updated state
+ */
+export declare function markItemProcessed(state: IRoadmapState, hash: string, item: IRoadmapStateItem): IRoadmapState;
+/**
+ * Remove an item from the state (e.g., if PRD was deleted)
+ *
+ * @param state - The roadmap state (will be mutated)
+ * @param hash - The item hash to remove
+ * @returns True if the item was found and removed
+ */
+export declare function unmarkItemProcessed(state: IRoadmapState, hash: string): boolean;
+/**
+ * Get all processed item hashes
+ */
+export declare function getProcessedHashes(state: IRoadmapState): string[];
+/**
+ * Get state item by hash
+ */
+export declare function getStateItem(state: IRoadmapState, hash: string): IRoadmapStateItem | undefined;
+//# sourceMappingURL=roadmap-state.d.ts.map

package/dist/utils/roadmap-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roadmap-state.d.ts","sourceRoot":"","sources":["../../src/utils/roadmap-state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC1C;AAQD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAmC9D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAc3E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAMhD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE3E;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,iBAAiB,GACtB,aAAa,CAGf;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAM/E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,EAAE,CAEjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,MAAM,GACX,iBAAiB,GAAG,SAAS,CAE/B"}

package/dist/utils/roadmap-state.js

@@ -0,0 +1,131 @@
+/**
+ * Roadmap State Manager for Night Watch CLI
+ * Manages .roadmap-state.json for tracking processed items
+ */
+import * as fs from "fs";
+import * as path from "path";
+/** Current version of the state file format */
+const STATE_VERSION = 1;
+/** Name of the state file */
+const STATE_FILE_NAME = ".roadmap-state.json";
+/**
+ * Get the path to the roadmap state file
+ */
+export function getStateFilePath(prdDir) {
+    return path.join(prdDir, STATE_FILE_NAME);
+}
+/**
+ * Load the roadmap state from disk
+ * Returns an empty state if the file does not exist or is invalid
+ *
+ * @param prdDir - Directory containing PRD files (where state file lives)
+ * @returns The loaded or empty roadmap state
+ */
+export function loadRoadmapState(prdDir) {
+    const statePath = getStateFilePath(prdDir);
+    if (!fs.existsSync(statePath)) {
+        return createEmptyState();
+    }
+    try {
+        const content = fs.readFileSync(statePath, "utf-8");
+        const parsed = JSON.parse(content);
+        // Validate structure
+        if (typeof parsed !== "object" || parsed === null) {
+            return createEmptyState();
+        }
+        // Ensure version and items exist
+        if (typeof parsed.version !== "number" || typeof parsed.items !== "object") {
+            return createEmptyState();
+        }
+        // Validate lastScan is a string if present
+        if (parsed.lastScan !== undefined && typeof parsed.lastScan !== "string") {
+            parsed.lastScan = new Date().toISOString();
+        }
+        return {
+            version: parsed.version,
+            lastScan: parsed.lastScan || "",
+            items: parsed.items || {},
+        };
+    }
+    catch {
+        // Invalid JSON or other error
+        return createEmptyState();
+    }
+}
+/**
+ * Save the roadmap state to disk
+ *
+ * @param prdDir - Directory containing PRD files (where state file lives)
+ * @param state - The state to save
+ */
+export function saveRoadmapState(prdDir, state) {
+    const statePath = getStateFilePath(prdDir);
+    // Ensure directory exists
+    const dir = path.dirname(statePath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    // Update lastScan timestamp
+    state.lastScan = new Date().toISOString();
+    // Write with pretty formatting
+    fs.writeFileSync(statePath, JSON.stringify(state, null, 2) + "\n", "utf-8");
+}
+/**
+ * Create an empty roadmap state
+ */
+export function createEmptyState() {
+    return {
+        version: STATE_VERSION,
+        lastScan: "",
+        items: {},
+    };
+}
+/**
+ * Check if an item has already been processed
+ *
+ * @param state - The roadmap state
+ * @param hash - The item hash to check
+ * @returns True if the item has been processed
+ */
+export function isItemProcessed(state, hash) {
+    return hash in state.items;
+}
+/**
+ * Mark an item as processed in the state
+ *
+ * @param state - The roadmap state (will be mutated)
+ * @param hash - The item hash
+ * @param item - The state item data
+ * @returns The updated state
+ */
+export function markItemProcessed(state, hash, item) {
+    state.items[hash] = item;
+    return state;
+}
+/**
+ * Remove an item from the state (e.g., if PRD was deleted)
+ *
+ * @param state - The roadmap state (will be mutated)
+ * @param hash - The item hash to remove
+ * @returns True if the item was found and removed
+ */
+export function unmarkItemProcessed(state, hash) {
+    if (hash in state.items) {
+        delete state.items[hash];
+        return true;
+    }
+    return false;
+}
+/**
+ * Get all processed item hashes
+ */
+export function getProcessedHashes(state) {
+    return Object.keys(state.items);
+}
+/**
+ * Get state item by hash
+ */
+export function getStateItem(state, hash) {
+    return state.items[hash];
+}
+//# sourceMappingURL=roadmap-state.js.map