@kiwidata/grimoire 0.1.1

package/dist/core/list.js

@@ -0,0 +1,170 @@
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import chalk from "chalk";
+import matter from "gray-matter";
+import { findProjectRoot } from "../utils/paths.js";
+import { fileExists } from "../utils/fs.js";
+export async function listChanges(json) {
+    const root = await findProjectRoot();
+    const changesDir = join(root, ".grimoire", "changes");
+    try {
+        const entries = await readdir(changesDir, { withFileTypes: true });
+        const changes = entries.filter((e) => e.isDirectory());
+        if (changes.length === 0) {
+            if (json) {
+                console.log(JSON.stringify([]));
+            }
+            else {
+                console.log("No active changes.");
+            }
+            return;
+        }
+        const results = [];
+        for (const change of changes) {
+            const changePath = join(changesDir, change.name);
+            const hasManifest = await fileExists(join(changePath, "manifest.md"));
+            const hasTasks = await fileExists(join(changePath, "tasks.md"));
+            const glob = (await import("fast-glob")).default;
+            const featureFiles = await glob("features/**/*.feature", {
+                cwd: changePath,
+            });
+            const hasFeatures = featureFiles.length > 0;
+            const hasDecisions = await dirHasFiles(join(changePath, "decisions"), ".md");
+            // Parse manifest frontmatter
+            let status = "draft";
+            let branch = null;
+            if (hasManifest) {
+                const manifestContent = await readFile(join(changePath, "manifest.md"), "utf-8");
+                const { data: fm } = matter(manifestContent);
+                if (fm.status)
+                    status = fm.status;
+                if (fm.branch)
+                    branch = fm.branch;
+            }
+            let stage = "draft";
+            if (hasTasks)
+                stage = "planned";
+            results.push({
+                id: change.name,
+                status,
+                branch,
+                stage,
+                hasManifest,
+                hasTasks,
+                hasFeatures,
+                hasDecisions,
+                featureFiles,
+            });
+        }
+        // Detect conflicts: multiple changes touching the same feature file
+        const conflicts = detectConflicts(results);
+        if (json) {
+            console.log(JSON.stringify({ changes: results, conflicts }, null, 2));
+        }
+        else {
+            console.log(chalk.bold("Active changes:\n"));
+            for (const r of results) {
+                const artifacts = [
+                    r.hasManifest ? "manifest" : null,
+                    r.hasFeatures ? "features" : null,
+                    r.hasDecisions ? "decisions" : null,
+                    r.hasTasks ? "tasks" : null,
+                ]
+                    .filter(Boolean)
+                    .join(", ");
+                const branchInfo = r.branch
+                    ? ` ${chalk.dim(`→ ${r.branch}`)}`
+                    : "";
+                console.log(`  ${chalk.cyan(r.id)} ${chalk.dim(`[${r.status}]`)} — ${artifacts}${branchInfo}`);
+            }
+            if (conflicts.length > 0) {
+                console.log(chalk.bold.yellow("\nConflicts detected:\n"));
+                for (const c of conflicts) {
+                    console.log(`  ${chalk.yellow("!")} ${chalk.bold(c.file)} is touched by: ${c.changes.join(", ")}`);
+                }
+                console.log(chalk.dim("\n  These changes modify the same feature file. Coordinate before applying."));
+            }
+        }
+    }
+    catch {
+        if (json) {
+            console.log(JSON.stringify({ changes: [], conflicts: [] }));
+        }
+        else {
+            console.log("No .grimoire/changes/ directory. Run grimoire init first.");
+        }
+    }
+}
+function detectConflicts(changes) {
+    const fileToChanges = new Map();
+    for (const change of changes) {
+        for (const file of change.featureFiles) {
+            const existing = fileToChanges.get(file) || [];
+            existing.push(change.id);
+            fileToChanges.set(file, existing);
+        }
+    }
+    const conflicts = [];
+    for (const [file, changeIds] of fileToChanges) {
+        if (changeIds.length > 1) {
+            conflicts.push({ file, changes: changeIds });
+        }
+    }
+    return conflicts;
+}
+export async function listFeatures(json) {
+    const root = await findProjectRoot();
+    const glob = (await import("fast-glob")).default;
+    const features = await glob("features/**/*.feature", {
+        cwd: root,
+        absolute: false,
+    });
+    if (json) {
+        console.log(JSON.stringify(features));
+    }
+    else {
+        if (features.length === 0) {
+            console.log("No feature files found.");
+            return;
+        }
+        console.log(chalk.bold("Feature files:\n"));
+        for (const f of features) {
+            console.log(`  ${f}`);
+        }
+    }
+}
+export async function listDecisions(json) {
+    const root = await findProjectRoot();
+    const glob = (await import("fast-glob")).default;
+    const decisions = await glob(".grimoire/decisions/[0-9]*.md", {
+        cwd: root,
+        absolute: false,
+    });
+    if (json) {
+        console.log(JSON.stringify(decisions));
+    }
+    else {
+        if (decisions.length === 0) {
+            console.log("No decision records found.");
+            return;
+        }
+        console.log(chalk.bold("Decision records:\n"));
+        for (const d of decisions) {
+            const content = await readFile(join(root, d), "utf-8");
+            const titleMatch = content.match(/^# (.+)$/m);
+            const title = titleMatch ? titleMatch[1] : d;
+            console.log(`  ${chalk.dim(d.replace(".grimoire/decisions/", ""))} ${title}`);
+        }
+    }
+}
+// fileExists imported from utils/fs.js
+async function dirHasFiles(dir, ext) {
+    try {
+        const entries = await readdir(dir, { recursive: true });
+        return entries.some((e) => e.endsWith(ext));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/core/list.js.map

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

package/dist/core/log.d.ts

@@ -0,0 +1,8 @@
+interface LogOptions {
+    from?: string;
+    to?: string;
+    json: boolean;
+}
+export declare function generateLog(options: LogOptions): Promise<void>;
+export {};
+//# sourceMappingURL=log.d.ts.map

package/dist/core/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/core/log.ts"],"names":[],"mappings":"AAMA,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,OAAO,CAAC;CACf;AAYD,wBAAsB,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA2EpE"}

package/dist/core/log.js

@@ -0,0 +1,150 @@
+import { readdir, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import chalk from "chalk";
+import { simpleGit } from "simple-git";
+import { findProjectRoot } from "../utils/paths.js";
+export async function generateLog(options) {
+    const root = await findProjectRoot();
+    const archiveDir = join(root, ".grimoire", "archive");
+    let entries;
+    try {
+        entries = await readArchiveEntries(archiveDir);
+    }
+    catch {
+        throw new Error("No archive found. No changes have been archived yet.");
+    }
+    if (entries.length === 0) {
+        console.log(chalk.dim("No archived changes found."));
+        return;
+    }
+    // Filter by date range if tags/dates provided
+    if (options.from || options.to) {
+        const fromDate = options.from
+            ? await resolveDate(root, options.from)
+            : "";
+        const toDate = options.to
+            ? await resolveDate(root, options.to)
+            : "9999-99-99";
+        entries = entries.filter((e) => e.date >= fromDate && e.date <= toDate);
+    }
+    // Sort newest first
+    entries.sort((a, b) => b.date.localeCompare(a.date));
+    if (options.json) {
+        console.log(JSON.stringify(entries, null, 2));
+        return;
+    }
+    // Pretty output
+    console.log(chalk.bold("Grimoire Change Log\n"));
+    let currentMonth = "";
+    for (const entry of entries) {
+        const month = entry.date.slice(0, 7); // YYYY-MM
+        if (month !== currentMonth) {
+            currentMonth = month;
+            console.log(chalk.bold.underline(`\n${formatMonth(month)}\n`));
+        }
+        console.log(`  ${chalk.dim(entry.date)}  ${chalk.cyan(entry.changeId)}`);
+        console.log(`  ${entry.summary}`);
+        if (entry.features.length > 0) {
+            console.log(`  ${chalk.dim("Features:")} ${entry.features.join(", ")}`);
+        }
+        if (entry.decisions.length > 0) {
+            console.log(`  ${chalk.dim("Decisions:")} ${entry.decisions.join(", ")}`);
+        }
+        if (entry.scenarios.length > 0) {
+            const display = entry.scenarios.length <= 3
+                ? entry.scenarios.join(", ")
+                : `${entry.scenarios.slice(0, 3).join(", ")} +${entry.scenarios.length - 3} more`;
+            console.log(`  ${chalk.dim("Scenarios:")} ${display}`);
+        }
+        console.log();
+    }
+    console.log(chalk.dim(`${entries.length} change(s) total`));
+}
+async function readArchiveEntries(archiveDir) {
+    const dirs = await readdir(archiveDir, { withFileTypes: true });
+    const entries = [];
+    for (const dir of dirs) {
+        if (!dir.isDirectory())
+            continue;
+        // Directory name format: YYYY-MM-DD-<change-id>
+        const match = dir.name.match(/^(\d{4}-\d{2}-\d{2})-(.+)$/);
+        if (!match)
+            continue;
+        const [, date, changeId] = match;
+        const manifestPath = join(archiveDir, dir.name, "manifest.md");
+        let manifest;
+        try {
+            manifest = await readFile(manifestPath, "utf-8");
+        }
+        catch {
+            continue;
+        }
+        entries.push({
+            date,
+            changeId,
+            ...parseManifest(manifest),
+        });
+    }
+    return entries;
+}
+function parseManifest(content) {
+    // Extract title: # Change: <summary>
+    const titleMatch = content.match(/^#\s+Change:\s*(.+)$/m);
+    const summary = titleMatch ? titleMatch[1].trim() : "(no summary)";
+    // Extract why section
+    const whyMatch = content.match(/^##\s+Why\s*\n([\s\S]*?)(?=^##|\Z)/m);
+    const why = whyMatch ? whyMatch[1].trim() : "";
+    // Extract feature changes
+    const features = [];
+    const featurePattern = /\*\*(?:ADDED|MODIFIED|REMOVED)\*\*\s+`([^`]+\.feature)`/g;
+    let m;
+    while ((m = featurePattern.exec(content)) !== null) {
+        features.push(m[1]);
+    }
+    // Extract decisions
+    const decisions = [];
+    const decisionPattern = /\*\*(?:ADDED|MODIFIED|SUPERSEDED)\*\*\s+`(\d{4}-[^`]+\.md)`/g;
+    while ((m = decisionPattern.exec(content)) !== null) {
+        decisions.push(m[1]);
+    }
+    // Extract scenarios
+    const scenarios = [];
+    const scenarioPattern = /"([^"]+)"/g;
+    const scenarioSection = content.match(/^##\s+Scenarios\s+(?:Added|Modified)\s*\n([\s\S]*?)(?=^##|\Z)/gm);
+    if (scenarioSection) {
+        for (const section of scenarioSection) {
+            while ((m = scenarioPattern.exec(section)) !== null) {
+                scenarios.push(m[1]);
+            }
+        }
+    }
+    return { summary, why, features, decisions, scenarios };
+}
+/**
+ * Resolve a git tag or date string to an ISO date.
+ * If it looks like a date already, return it. Otherwise try git tag.
+ */
+async function resolveDate(root, ref) {
+    if (/^\d{4}-\d{2}-\d{2}$/.test(ref)) {
+        return ref;
+    }
+    // Try as a git tag
+    try {
+        const git = simpleGit(root);
+        const stdout = await git.raw(["log", "-1", "--format=%aI", ref]);
+        return stdout.trim().split("T")[0];
+    }
+    catch {
+        console.error(chalk.yellow(`Warning: Could not resolve "${ref}" as a git tag or date. Using as-is.`));
+        return ref;
+    }
+}
+function formatMonth(yyyyMm) {
+    const [year, month] = yyyyMm.split("-");
+    const months = [
+        "January", "February", "March", "April", "May", "June",
+        "July", "August", "September", "October", "November", "December",
+    ];
+    return `${months[parseInt(month, 10) - 1]} ${year}`;
+}
+//# sourceMappingURL=log.js.map

package/dist/core/log.js.map

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

package/dist/core/map.d.ts

@@ -0,0 +1,9 @@
+interface MapOptions {
+    json: boolean;
+    refresh: boolean;
+    maxDepth: number;
+    duplicates: boolean;
+}
+export declare function generateMap(options: MapOptions): Promise<void>;
+export {};
+//# sourceMappingURL=map.d.ts.map

package/dist/core/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../src/core/map.ts"],"names":[],"mappings":"AAaA,UAAU,UAAU;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB;AAiGD,wBAAsB,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA0KpE"}

package/dist/core/map.js

@@ -0,0 +1,302 @@
+import { readdir, readFile, writeFile, mkdir } from "node:fs/promises";
+import { join, relative, extname, basename, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import chalk from "chalk";
+import { findProjectRoot } from "../utils/paths.js";
+const execFileAsync = promisify(execFile);
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PACKAGE_ROOT = join(__dirname, "..", "..");
+/**
+ * Parse a mapignore file into a Set of patterns.
+ * Blank lines and lines starting with # are skipped.
+ */
+function parseIgnoreFile(content) {
+    const patterns = new Set();
+    for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (trimmed && !trimmed.startsWith("#")) {
+            patterns.add(trimmed);
+        }
+    }
+    return patterns;
+}
+/**
+ * Parse a mapkeys file into a Record<filename, type>.
+ * Format: filename = type
+ * Blank lines and lines starting with # are skipped.
+ */
+function parseKeyFilesConfig(content) {
+    const keys = {};
+    for (const line of content.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith("#"))
+            continue;
+        const eqIndex = trimmed.indexOf("=");
+        if (eqIndex === -1)
+            continue;
+        const filename = trimmed.slice(0, eqIndex).trim();
+        const type = trimmed.slice(eqIndex + 1).trim();
+        if (filename && type) {
+            keys[filename] = type;
+        }
+    }
+    return keys;
+}
+/**
+ * Load config from project-level file, falling back to bundled template.
+ */
+async function loadConfigFile(root, filename) {
+    // Project-level override: .grimoire/<filename>
+    const projectPath = join(root, ".grimoire", filename);
+    try {
+        return await readFile(projectPath, "utf-8");
+    }
+    catch {
+        // Fall back to bundled template
+        const templatePath = join(PACKAGE_ROOT, "templates", filename);
+        return await readFile(templatePath, "utf-8");
+    }
+}
+export async function generateMap(options) {
+    const root = await findProjectRoot();
+    const docsDir = join(root, ".grimoire", "docs");
+    // Load config files
+    // mapignore → structure scan only (dir-name match)
+    // dupignore → jscpd only (glob match)
+    const ignoreContent = await loadConfigFile(root, "mapignore");
+    const keysContent = await loadConfigFile(root, "mapkeys");
+    const dupIgnoreContent = await loadConfigFile(root, "dupignore");
+    const ignorePatterns = parseIgnoreFile(ignoreContent);
+    const keyFilePatterns = parseKeyFilesConfig(keysContent);
+    const dupIgnoreGlobs = parseIgnoreFile(dupIgnoreContent);
+    // Scan the directory tree
+    const directories = [];
+    const keyFiles = [];
+    await scanDirectory(root, root, 0, options.maxDepth, directories, keyFiles, ignorePatterns, keyFilePatterns);
+    // Load existing index if refreshing
+    let existingAreas = [];
+    if (options.refresh) {
+        existingAreas = await loadExistingAreas(docsDir);
+    }
+    // Determine what's undocumented and what's been removed
+    const scannedDirs = new Set(directories.map((d) => d.path));
+    const undocumented = directories
+        .filter((d) => !existingAreas.includes(d.path))
+        .filter((d) => d.fileCount > 0)
+        .map((d) => d.path);
+    const removed = existingAreas.filter((a) => !scannedDirs.has(a));
+    // Run duplicate detection if requested
+    let duplicates = null;
+    if (options.duplicates) {
+        duplicates = await runJscpd(root, dupIgnoreGlobs);
+    }
+    const snapshot = {
+        generatedAt: new Date().toISOString(),
+        projectRoot: ".",
+        directories,
+        keyFiles,
+        undocumented,
+        removed,
+        duplicates,
+    };
+    if (options.json) {
+        console.log(JSON.stringify(snapshot, null, 2));
+        return;
+    }
+    // Pretty print
+    console.log(chalk.bold("\nProject Map\n"));
+    // Directory tree
+    console.log(chalk.bold("Structure:"));
+    for (const dir of directories) {
+        const depth = dir.path === "." ? 0 : dir.path.split("/").length;
+        const padding = "  ".repeat(depth);
+        const extSummary = Object.entries(dir.extensions)
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 3)
+            .map(([ext, count]) => `${count} ${ext}`)
+            .join(", ");
+        const keyFileNote = dir.keyFiles.length > 0
+            ? chalk.dim(` [${dir.keyFiles.join(", ")}]`)
+            : "";
+        console.log(`${padding}${chalk.cyan(dir.path + "/")} ${chalk.dim(extSummary)}${keyFileNote}`);
+    }
+    // Key files
+    if (keyFiles.length > 0) {
+        console.log(chalk.bold("\nKey Files:"));
+        for (const kf of keyFiles) {
+            console.log(`  ${kf.path} ${chalk.dim(`(${kf.type})`)}`);
+        }
+    }
+    // Duplicate report
+    if (duplicates) {
+        if (duplicates.clones.length > 0) {
+            console.log(chalk.bold.yellow(`\nDuplicates: ${duplicates.clones.length} clone(s), ${duplicates.totalDuplicatedLines} duplicated lines (${duplicates.percentDuplicated.toFixed(1)}%)\n`));
+            for (const clone of duplicates.clones.slice(0, 10)) {
+                console.log(`  ${chalk.dim(clone.firstFile)}:${clone.firstStartLine}-${clone.firstEndLine}`);
+                console.log(`  ${chalk.dim(clone.secondFile)}:${clone.secondStartLine}-${clone.secondEndLine}`);
+                console.log(`  ${chalk.dim(`${clone.lines} lines, ${clone.tokens} tokens`)}\n`);
+            }
+            if (duplicates.clones.length > 10) {
+                console.log(chalk.dim(`  ... and ${duplicates.clones.length - 10} more (see .snapshot.json for full list)`));
+            }
+        }
+        else {
+            console.log(chalk.green("\nNo duplicates detected."));
+        }
+    }
+    // Diff against existing docs
+    if (options.refresh) {
+        if (undocumented.length > 0) {
+            console.log(chalk.bold.yellow("\nUndocumented areas:"));
+            for (const u of undocumented) {
+                console.log(`  ${chalk.yellow("+")} ${u}/`);
+            }
+        }
+        if (removed.length > 0) {
+            console.log(chalk.bold.red("\nRemoved (docs may be stale):"));
+            for (const r of removed) {
+                console.log(`  ${chalk.red("-")} ${r}/`);
+            }
+        }
+        if (undocumented.length === 0 && removed.length === 0) {
+            console.log(chalk.green("\nAll areas are documented. No changes detected."));
+        }
+    }
+    else {
+        console.log(chalk.dim(`\n${directories.length} directories, ${keyFiles.length} key files found.`));
+        console.log(chalk.dim("Run /grimoire:discover to generate area docs from this snapshot."));
+    }
+    // Write snapshot for the skill to consume
+    await mkdir(docsDir, { recursive: true });
+    await writeFile(join(docsDir, ".snapshot.json"), JSON.stringify(snapshot, null, 2));
+    console.log(chalk.dim(`\nSnapshot saved to .grimoire/docs/.snapshot.json`));
+}
+async function scanDirectory(fullPath, root, depth, maxDepth, directories, keyFiles, ignorePatterns, keyFilePatterns) {
+    if (depth > maxDepth)
+        return;
+    const relPath = relative(root, fullPath) || ".";
+    const dirName = basename(fullPath);
+    // Skip ignored directories (by name match)
+    if (depth > 0 && ignorePatterns.has(dirName))
+        return;
+    // Skip hidden dirs except .grimoire
+    if (depth > 0 && dirName.startsWith(".") && dirName !== ".grimoire")
+        return;
+    let entries;
+    try {
+        entries = await readdir(fullPath, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    const files = entries.filter((e) => e.isFile());
+    const subdirs = entries
+        .filter((e) => e.isDirectory())
+        .filter((e) => !ignorePatterns.has(e.name))
+        .filter((e) => !e.name.startsWith(".") || e.name === ".grimoire");
+    // Count extensions and detect key files
+    const extensions = {};
+    const dirKeyFiles = [];
+    for (const file of files) {
+        const ext = extname(file.name) || file.name;
+        extensions[ext] = (extensions[ext] || 0) + 1;
+        if (keyFilePatterns[file.name]) {
+            const kfPath = relPath === "." ? file.name : `${relPath}/${file.name}`;
+            keyFiles.push({
+                path: kfPath,
+                type: keyFilePatterns[file.name],
+            });
+            dirKeyFiles.push(file.name);
+        }
+    }
+    // Include directories that have files or are shallow enough to show structure
+    if (files.length > 0 || depth <= 1) {
+        directories.push({
+            path: relPath === "." ? "." : relPath,
+            fileCount: files.length,
+            extensions,
+            keyFiles: dirKeyFiles,
+            subdirs: subdirs.map((s) => s.name),
+        });
+    }
+    for (const subdir of subdirs) {
+        await scanDirectory(join(fullPath, subdir.name), root, depth + 1, maxDepth, directories, keyFiles, ignorePatterns, keyFilePatterns);
+    }
+}
+async function runJscpd(root, dupIgnoreGlobs) {
+    // Check if jscpd is available
+    try {
+        await execFileAsync("npx", ["jscpd", "--version"], { cwd: root });
+    }
+    catch {
+        console.log(chalk.yellow("\njscpd not found. Install with: npm install -g jscpd"));
+        console.log(chalk.yellow("Skipping duplicate detection.\n"));
+        return null;
+    }
+    console.log(chalk.dim("\nRunning jscpd duplicate detection..."));
+    try {
+        const ignoreArg = [...dupIgnoreGlobs].join(",");
+        const args = [
+            "jscpd",
+            root,
+            "--reporters", "json",
+            "--output", join(root, ".grimoire", "docs"),
+            "--silent",
+        ];
+        if (ignoreArg) {
+            args.push("--ignore", ignoreArg);
+        }
+        await execFileAsync("npx", args, {
+            cwd: root,
+            timeout: 60_000,
+        });
+        // Read the jscpd JSON report
+        const reportPath = join(root, ".grimoire", "docs", "jscpd-report.json");
+        const reportContent = await readFile(reportPath, "utf-8");
+        const report = JSON.parse(reportContent);
+        const clones = (report.duplicates || []).map((d) => {
+            const first = d.firstFile;
+            const second = d.secondFile;
+            return {
+                firstFile: relative(root, first.name),
+                firstStartLine: first.startLoc?.line ?? 0,
+                firstEndLine: first.endLoc?.line ?? 0,
+                secondFile: relative(root, second.name),
+                secondStartLine: second.startLoc?.line ?? 0,
+                secondEndLine: second.endLoc?.line ?? 0,
+                lines: d.lines || 0,
+                tokens: d.tokens || 0,
+                fragment: (d.fragment || "").slice(0, 200),
+            };
+        });
+        const stats = report.statistics;
+        const totalLines = stats?.total?.lines || 1;
+        const dupLines = stats?.total?.duplicatedLines || 0;
+        return {
+            clones,
+            totalDuplicatedLines: dupLines,
+            percentDuplicated: (dupLines / totalLines) * 100,
+        };
+    }
+    catch (err) {
+        console.log(chalk.yellow(`\njscpd failed: ${err instanceof Error ? err.message : "unknown error"}`));
+        return null;
+    }
+}
+async function loadExistingAreas(docsDir) {
+    try {
+        const indexContent = await readFile(join(docsDir, "index.yml"), "utf-8");
+        const areas = [];
+        const dirMatches = indexContent.matchAll(/directory:\s*(.+)/g);
+        for (const match of dirMatches) {
+            areas.push(match[1].trim());
+        }
+        return areas;
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=map.js.map