@lsctech/polaris 0.1.0

package/dist/smartdocs-engine/seed-instructions.js

@@ -0,0 +1,335 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DRAFT_MARKER = void 0;
+exports.hasDraftMarker = hasDraftMarker;
+exports.generateDraft = generateDraft;
+exports.generateSummaryDraft = generateSummaryDraft;
+exports.seedInstructions = seedInstructions;
+exports.seedSummary = seedSummary;
+exports.seedInstructionsAll = seedInstructionsAll;
+exports.seedSummaryAll = seedSummaryAll;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const loader_js_1 = require("../config/loader.js");
+const atlas_js_1 = require("../map/atlas.js");
+const smartdoc_ignore_js_1 = require("./smartdoc-ignore.js");
+exports.DRAFT_MARKER = "<!-- polaris:draft -->";
+function hasDraftMarker(filePath) {
+    try {
+        const content = (0, node_fs_1.readFileSync)(filePath, "utf-8");
+        return content.includes(exports.DRAFT_MARKER);
+    }
+    catch {
+        return false;
+    }
+}
+function collectDirs(dir, root, eligibilityOpts = {}, result = { eligible: [], ineligible: [] }) {
+    try {
+        for (const entry of (0, node_fs_1.readdirSync)(dir, { withFileTypes: true })) {
+            if (!entry.isDirectory())
+                continue;
+            const full = (0, node_path_1.join)(dir, entry.name);
+            const rel = (0, node_path_1.relative)(root, full).replace(/\\/g, "/");
+            // Check if directory is eligible for Smart Docs coverage
+            const eligibility = (0, smartdoc_ignore_js_1.isDirectoryEligible)(full, root, eligibilityOpts);
+            if (!eligibility.eligible) {
+                result.ineligible.push({
+                    path: rel,
+                    reason: eligibility.reason || "unknown",
+                    category: eligibility.category === "eligible" ? undefined : eligibility.category,
+                });
+                continue;
+            }
+            result.eligible.push(rel);
+            collectDirs(full, root, eligibilityOpts, result);
+        }
+    }
+    catch {
+        // ignore unreadable dirs
+    }
+    return result;
+}
+function generateDraft(targetDir, repoRoot, allRoutes) {
+    const filesInDir = Object.entries(allRoutes).filter(([filePath]) => {
+        const fileDir = (0, node_path_1.dirname)(filePath);
+        const normDir = targetDir.replace(/\\/g, "/");
+        return fileDir === normDir || (normDir === "." && !filePath.includes("/"));
+    });
+    const domains = [...new Set(filesInDir.map(([, e]) => e.domain))].filter(Boolean);
+    const routes = [...new Set(filesInDir.map(([, e]) => e.route))].filter(Boolean);
+    const taskchains = [...new Set(filesInDir.map(([, e]) => e.taskchain))].filter(Boolean);
+    // Nearby doc references: .md files in atlas whose route overlaps with this dir's routes
+    const nearbyDocs = Object.entries(allRoutes)
+        .filter(([p]) => p.endsWith(".md") || p.startsWith("docs/"))
+        .filter(([, e]) => routes.some((r) => e.route === r || e.domain === domains[0]))
+        .map(([p]) => p)
+        .slice(0, 5);
+    const dirLabel = (0, node_path_1.basename)(targetDir) || (0, node_path_1.basename)(repoRoot);
+    const lines = [
+        exports.DRAFT_MARKER,
+        `# ${dirLabel}`,
+        "",
+        "> Polaris draft — review and remove the `<!-- polaris:draft -->` marker to promote.",
+        "",
+        "## Purpose",
+        "",
+        "<!-- One paragraph describing what this folder does. -->",
+        "",
+    ];
+    if (domains.length > 0)
+        lines.push(`**Domain:** ${domains.join(", ")}`);
+    if (routes.length > 0)
+        lines.push(`**Route:** ${routes.join(", ")}`);
+    if (taskchains.length > 0)
+        lines.push(`**Taskchain:** ${taskchains.join(", ")}`);
+    if (domains.length + routes.length + taskchains.length > 0)
+        lines.push("");
+    lines.push("## What belongs here", "");
+    if (filesInDir.length > 0) {
+        for (const [filePath, entry] of filesInDir) {
+            lines.push(`- \`${(0, node_path_1.basename)(filePath)}\` — ${entry.route} (${entry.domain})`);
+        }
+    }
+    else {
+        lines.push("<!-- Bulleted file list of contents. -->");
+    }
+    lines.push("");
+    lines.push("## What does not belong here", "");
+    lines.push("<!-- Explicit exclusions of files or responsibilities. -->");
+    lines.push("");
+    lines.push("## Editing rules", "");
+    lines.push("<!-- Behavioral constraints for agents and humans. -->");
+    lines.push("");
+    lines.push("## Architecture assumptions", "");
+    lines.push("<!-- What the code assumes about the world. -->");
+    lines.push("");
+    lines.push("## Read before editing", "");
+    if (nearbyDocs.length > 0) {
+        for (const docPath of nearbyDocs) {
+            lines.push(`- [${(0, node_path_1.basename)(docPath)}](${docPath})`);
+        }
+    }
+    else {
+        lines.push("<!-- Links to canonical sources (doctrine, specs). -->");
+    }
+    lines.push("");
+    lines.push("## Related routes", "");
+    lines.push("<!-- Atlas route pointer to sibling or parent folders. -->");
+    lines.push("");
+    return lines.join("\n");
+}
+function generateSummaryDraft(targetDir, repoRoot, _allRoutes) {
+    const dirLabel = (0, node_path_1.basename)(targetDir) || (0, node_path_1.basename)(repoRoot);
+    const lines = [
+        exports.DRAFT_MARKER,
+        `# Summary: ${dirLabel}`,
+        "",
+        "> Polaris draft — review and remove the `<!-- polaris:draft -->` marker to promote.",
+        "",
+        "## Purpose",
+        "<!-- One-line statement of what this folder does. -->",
+        "",
+        "## Core Concepts",
+        "<!-- 3–7 key concepts a reader needs before diving into source. -->",
+        "",
+        "## Architectural Role",
+        "<!-- How this folder fits into the larger system. -->",
+        "",
+        "## Key Constraints",
+        "<!-- The most important non-obvious behavioral limits. -->",
+        "",
+        "## Important Relationships",
+        "<!-- Upstream/downstream dependencies on other folders. -->",
+        "",
+        "## Current State",
+        "<!-- What is implemented, what is not yet, known gaps. -->",
+        "",
+        "## Route Health",
+        "<!-- Current operational condition. Workers should understand route health in under 10 seconds. -->",
+        "",
+        "### Healthy",
+        "<!-- If the route is healthy, state why. Otherwise omit this subsection. -->",
+        "",
+        "### Monitoring",
+        "<!-- Any ongoing monitoring or observations. Omit if none. -->",
+        "",
+        "### Known Issues",
+        "<!-- Any known problems or risks. Omit if none. -->",
+        "",
+        "### Recent Treatments",
+        "<!-- Recent fixes or improvements, with chart references if applicable. Omit if none. -->",
+        "",
+        "### Improvement Opportunities",
+        "<!-- Potential future improvements. Omit if none. -->",
+        "",
+        "## Canonical References",
+        "",
+        "```yaml",
+        "canonical_docs:",
+        "  - POLARIS.md",
+        "<!-- Add navigation paths to canonical docs, specs, or doctrine. These are retrieval paths, not reading assignments. -->",
+        "```",
+        "",
+        "## Known Drift",
+        "<!-- Places where the summary may be stale (honesty field). -->",
+        "",
+    ];
+    return lines.join("\n");
+}
+function seedInstructions(targetPath, repoRoot, opts = {}) {
+    const absTarget = (0, node_path_1.resolve)(repoRoot, targetPath);
+    // Path traversal check: ensure absTarget is within repoRoot
+    const relCheck = (0, node_path_1.relative)(repoRoot, absTarget);
+    if (relCheck.startsWith("..") || relCheck.startsWith("/")) {
+        throw new Error(`Path traversal detected: target path is outside repo root`);
+    }
+    const outFile = (0, node_path_1.join)(absTarget, "POLARIS.md");
+    if ((0, node_fs_1.existsSync)(outFile)) {
+        if (hasDraftMarker(outFile)) {
+            return "skipped-draft";
+        }
+        return "skipped-exists";
+    }
+    const config = (0, loader_js_1.loadConfig)(repoRoot);
+    const atlasPath = (0, node_path_1.resolve)(repoRoot, config.repo.sidecarOutputPath ?? ".polaris/map");
+    const allRoutes = {
+        ...(0, atlas_js_1.readFileRoutes)(atlasPath),
+        ...(0, atlas_js_1.readNeedsReview)(atlasPath),
+    };
+    const relTarget = (0, node_path_1.relative)(repoRoot, absTarget).replace(/\\/g, "/");
+    const content = generateDraft(relTarget, repoRoot, allRoutes);
+    if (!opts.dryRun) {
+        (0, node_fs_1.writeFileSync)(outFile, content, "utf-8");
+    }
+    return "written";
+}
+function seedSummary(targetPath, repoRoot, opts = {}) {
+    const absTarget = (0, node_path_1.resolve)(repoRoot, targetPath);
+    const relCheck = (0, node_path_1.relative)(repoRoot, absTarget);
+    if (relCheck.startsWith("..") || relCheck.startsWith("/")) {
+        throw new Error(`Path traversal detected: target path is outside repo root`);
+    }
+    const outFile = (0, node_path_1.join)(absTarget, "SUMMARY.md");
+    if ((0, node_fs_1.existsSync)(outFile)) {
+        if (hasDraftMarker(outFile)) {
+            return "skipped-draft";
+        }
+        return "skipped-exists";
+    }
+    const config = (0, loader_js_1.loadConfig)(repoRoot);
+    const atlasPath = (0, node_path_1.resolve)(repoRoot, config.repo.sidecarOutputPath ?? ".polaris/map");
+    const allRoutes = {
+        ...(0, atlas_js_1.readFileRoutes)(atlasPath),
+        ...(0, atlas_js_1.readNeedsReview)(atlasPath),
+    };
+    const relTarget = (0, node_path_1.relative)(repoRoot, absTarget).replace(/\\/g, "/");
+    const content = generateSummaryDraft(relTarget, repoRoot, allRoutes);
+    if (!opts.dryRun) {
+        (0, node_fs_1.writeFileSync)(outFile, content, "utf-8");
+    }
+    return "written";
+}
+function seedInstructionsAll(repoRoot, opts = {}) {
+    const config = (0, loader_js_1.loadConfig)(repoRoot);
+    const atlasPath = (0, node_path_1.resolve)(repoRoot, config.repo.sidecarOutputPath ?? ".polaris/map");
+    const allRoutes = {
+        ...(0, atlas_js_1.readFileRoutes)(atlasPath),
+        ...(0, atlas_js_1.readNeedsReview)(atlasPath),
+    };
+    // Root handling: skipped by default for POLARIS.md (root uses AGENTS.md/CLAUDE.md)
+    const rootEligibility = (0, smartdoc_ignore_js_1.isDirectoryEligible)(repoRoot, repoRoot, {
+        isRoot: true,
+        skipRoot: opts.includeRoot ? false : true,
+    });
+    let skippedRoot;
+    if (!rootEligibility.eligible) {
+        skippedRoot = { path: ".", reason: rootEligibility.reason || "root skipped" };
+    }
+    // Collect eligible subdirectories
+    const eligibilityOpts = {
+        includeAgentFolders: opts.includeAgentFolders,
+        includeHidden: opts.includeHidden,
+        skipRoot: true, // Always skip root in collectDirs, we handle it separately
+    };
+    const { eligible: dirs, ineligible: skippedIneligible } = collectDirs(repoRoot, repoRoot, eligibilityOpts);
+    // Build the list of dirs to process
+    const dirsToProcess = [];
+    if (rootEligibility.eligible) {
+        dirsToProcess.push(".");
+    }
+    dirsToProcess.push(...dirs);
+    const written = [];
+    const skippedExists = [];
+    const skippedDraft = [];
+    for (const relDir of dirsToProcess) {
+        const absDir = (0, node_path_1.resolve)(repoRoot, relDir);
+        const outFile = (0, node_path_1.join)(absDir, "POLARIS.md");
+        if ((0, node_fs_1.existsSync)(outFile)) {
+            if (hasDraftMarker(outFile)) {
+                skippedDraft.push(relDir);
+            }
+            else {
+                skippedExists.push(relDir);
+            }
+            continue;
+        }
+        const content = generateDraft(relDir, repoRoot, allRoutes);
+        if (!opts.dryRun) {
+            (0, node_fs_1.writeFileSync)(outFile, content, "utf-8");
+        }
+        written.push(relDir);
+    }
+    return { written, skippedExists, skippedDraft, skippedIneligible, skippedRoot };
+}
+function seedSummaryAll(repoRoot, opts = {}) {
+    const config = (0, loader_js_1.loadConfig)(repoRoot);
+    const atlasPath = (0, node_path_1.resolve)(repoRoot, config.repo.sidecarOutputPath ?? ".polaris/map");
+    const allRoutes = {
+        ...(0, atlas_js_1.readFileRoutes)(atlasPath),
+        ...(0, atlas_js_1.readNeedsReview)(atlasPath),
+    };
+    // Root handling: skipped by default for SUMMARY.md (match POLARIS.md behavior)
+    const rootEligibility = (0, smartdoc_ignore_js_1.isDirectoryEligible)(repoRoot, repoRoot, {
+        isRoot: true,
+        skipRoot: opts.includeRoot ? false : true,
+    });
+    let skippedRoot;
+    if (!rootEligibility.eligible) {
+        skippedRoot = { path: ".", reason: rootEligibility.reason || "root skipped" };
+    }
+    // Collect eligible subdirectories
+    const eligibilityOpts = {
+        includeAgentFolders: opts.includeAgentFolders,
+        includeHidden: opts.includeHidden,
+        skipRoot: true, // Always skip root in collectDirs, we handle it separately
+    };
+    const { eligible: dirs, ineligible: skippedIneligible } = collectDirs(repoRoot, repoRoot, eligibilityOpts);
+    // Build the list of dirs to process
+    const dirsToProcess = [];
+    if (rootEligibility.eligible) {
+        dirsToProcess.push(".");
+    }
+    dirsToProcess.push(...dirs);
+    const written = [];
+    const skippedExists = [];
+    const skippedDraft = [];
+    for (const relDir of dirsToProcess) {
+        const absDir = (0, node_path_1.resolve)(repoRoot, relDir);
+        const outFile = (0, node_path_1.join)(absDir, "SUMMARY.md");
+        if ((0, node_fs_1.existsSync)(outFile)) {
+            if (hasDraftMarker(outFile)) {
+                skippedDraft.push(relDir);
+            }
+            else {
+                skippedExists.push(relDir);
+            }
+            continue;
+        }
+        const content = generateSummaryDraft(relDir, repoRoot, allRoutes);
+        if (!opts.dryRun) {
+            (0, node_fs_1.writeFileSync)(outFile, content, "utf-8");
+        }
+        written.push(relDir);
+    }
+    return { written, skippedExists, skippedDraft, skippedIneligible, skippedRoot };
+}

package/dist/smartdocs-engine/seed-instructions.test.js

@@ -0,0 +1,275 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const seed_instructions_js_1 = require("./seed-instructions.js");
+const TMP = (0, node_path_1.join)(process.cwd(), ".test-docs-seed-tmp");
+function makeEntry(overrides = {}) {
+    return {
+        domain: "test-domain",
+        route: "test-route",
+        taskchain: "test-chain",
+        confidence: 0.9,
+        classification: "indexed",
+        last_updated: "2026-01-01T00:00:00Z",
+        updated_by: "test",
+        tags: [],
+        ...overrides,
+    };
+}
+function setup() {
+    (0, node_fs_1.mkdirSync)((0, node_path_1.join)(TMP, "src/map"), { recursive: true });
+    (0, node_fs_1.mkdirSync)((0, node_path_1.join)(TMP, "src/cli"), { recursive: true });
+    (0, node_fs_1.mkdirSync)((0, node_path_1.join)(TMP, ".polaris/map"), { recursive: true });
+    // Minimal polaris.config.json so loadConfig doesn't fail
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(TMP, "polaris.config.json"), JSON.stringify({ repo: {}, map: {} }));
+    // Empty atlas files
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(TMP, ".polaris/map/file-routes.json"), JSON.stringify({}));
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(TMP, ".polaris/map/needs-review.json"), JSON.stringify({}));
+}
+function teardown() {
+    (0, node_fs_1.rmSync)(TMP, { recursive: true, force: true });
+}
+(0, vitest_1.describe)("hasDraftMarker", () => {
+    (0, vitest_1.beforeEach)(setup);
+    (0, vitest_1.afterEach)(teardown);
+    (0, vitest_1.it)("returns true when file starts with draft marker", () => {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(TMP, "POLARIS.md"), `${seed_instructions_js_1.DRAFT_MARKER}\n# title`);
+        (0, vitest_1.expect)((0, seed_instructions_js_1.hasDraftMarker)((0, node_path_1.join)(TMP, "POLARIS.md"))).toBe(true);
+    });
+    (0, vitest_1.it)("returns false when file has no draft marker", () => {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(TMP, "POLARIS.md"), "# Human-written doc");
+        (0, vitest_1.expect)((0, seed_instructions_js_1.hasDraftMarker)((0, node_path_1.join)(TMP, "POLARIS.md"))).toBe(false);
+    });
+    (0, vitest_1.it)("returns false for nonexistent file", () => {
+        (0, vitest_1.expect)((0, seed_instructions_js_1.hasDraftMarker)((0, node_path_1.join)(TMP, "nonexistent.md"))).toBe(false);
+    });
+});
+(0, vitest_1.describe)("generateDraft", () => {
+    (0, vitest_1.it)("includes draft marker at top", () => {
+        const content = (0, seed_instructions_js_1.generateDraft)("src/map", TMP, {});
+        (0, vitest_1.expect)(content.startsWith(seed_instructions_js_1.DRAFT_MARKER)).toBe(true);
+    });
+    (0, vitest_1.it)("uses directory basename as heading", () => {
+        const content = (0, seed_instructions_js_1.generateDraft)("src/map", TMP, {});
+        (0, vitest_1.expect)(content).toContain("# map");
+    });
+    (0, vitest_1.it)("includes domain and route from atlas entries in that directory", () => {
+        const routes = {
+            "src/map/atlas.ts": makeEntry({ domain: "atlas", route: "polaris-map" }),
+        };
+        const content = (0, seed_instructions_js_1.generateDraft)("src/map", TMP, routes);
+        (0, vitest_1.expect)(content).toContain("atlas");
+        (0, vitest_1.expect)(content).toContain("polaris-map");
+    });
+    (0, vitest_1.it)("lists files in the directory", () => {
+        const routes = {
+            "src/map/atlas.ts": makeEntry({ domain: "atlas", route: "polaris-map" }),
+            "src/map/update.ts": makeEntry({ domain: "atlas", route: "polaris-map" }),
+        };
+        const content = (0, seed_instructions_js_1.generateDraft)("src/map", TMP, routes);
+        (0, vitest_1.expect)(content).toContain("`atlas.ts`");
+        (0, vitest_1.expect)(content).toContain("`update.ts`");
+    });
+    (0, vitest_1.it)("does not include files from other directories", () => {
+        const routes = {
+            "src/cli/index.ts": makeEntry({ domain: "cli", route: "polaris-cli" }),
+            "src/map/atlas.ts": makeEntry({ domain: "atlas", route: "polaris-map" }),
+        };
+        const content = (0, seed_instructions_js_1.generateDraft)("src/map", TMP, routes);
+        (0, vitest_1.expect)(content).not.toContain("`index.ts`");
+    });
+});
+(0, vitest_1.describe)("seedInstructions", () => {
+    (0, vitest_1.beforeEach)(setup);
+    (0, vitest_1.afterEach)(teardown);
+    (0, vitest_1.it)("writes a POLARIS.md draft and returns written", () => {
+        const result = (0, seed_instructions_js_1.seedInstructions)("src/map", TMP);
+        (0, vitest_1.expect)(result).toBe("written");
+        const outPath = (0, node_path_1.join)(TMP, "src/map/POLARIS.md");
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(outPath)).toBe(true);
+        const content = (0, node_fs_1.readFileSync)(outPath, "utf-8");
+        (0, vitest_1.expect)(content).toContain(seed_instructions_js_1.DRAFT_MARKER);
+    });
+    (0, vitest_1.it)("returns skipped-exists when human-edited POLARIS.md present", () => {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(TMP, "src/map/POLARIS.md"), "# Human-edited");
+        const result = (0, seed_instructions_js_1.seedInstructions)("src/map", TMP);
+        (0, vitest_1.expect)(result).toBe("skipped-exists");
+    });
+    (0, vitest_1.it)("returns skipped-draft when draft POLARIS.md already present", () => {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(TMP, "src/map/POLARIS.md"), `${seed_instructions_js_1.DRAFT_MARKER}\n# Draft`);
+        const result = (0, seed_instructions_js_1.seedInstructions)("src/map", TMP);
+        (0, vitest_1.expect)(result).toBe("skipped-draft");
+    });
+    (0, vitest_1.it)("does not write file in dry-run mode", () => {
+        const result = (0, seed_instructions_js_1.seedInstructions)("src/map", TMP, { dryRun: true });
+        (0, vitest_1.expect)(result).toBe("written");
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)((0, node_path_1.join)(TMP, "src/map/POLARIS.md"))).toBe(false);
+    });
+});
+(0, vitest_1.describe)("seedInstructionsAll", () => {
+    (0, vitest_1.beforeEach)(setup);
+    (0, vitest_1.afterEach)(teardown);
+    (0, vitest_1.it)("generates drafts for directories without POLARIS.md", () => {
+        const { written, skippedIneligible } = (0, seed_instructions_js_1.seedInstructionsAll)(TMP);
+        (0, vitest_1.expect)(written).toContain("src/map");
+        (0, vitest_1.expect)(written).toContain("src/cli");
+        (0, vitest_1.expect)(skippedIneligible).toBeDefined();
+    });
+    (0, vitest_1.it)("skips directories with human-edited POLARIS.md", () => {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(TMP, "src/map/POLARIS.md"), "# Human-edited");
+        const { written, skippedExists, skippedIneligible } = (0, seed_instructions_js_1.seedInstructionsAll)(TMP);
+        (0, vitest_1.expect)(skippedExists).toContain("src/map");
+        (0, vitest_1.expect)(written).not.toContain("src/map");
+        (0, vitest_1.expect)(skippedIneligible).toBeDefined();
+    });
+    (0, vitest_1.it)("skips directories with draft POLARIS.md", () => {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(TMP, "src/map/POLARIS.md"), `${seed_instructions_js_1.DRAFT_MARKER}\n# Draft`);
+        const { skippedDraft, skippedIneligible } = (0, seed_instructions_js_1.seedInstructionsAll)(TMP);
+        (0, vitest_1.expect)(skippedDraft).toContain("src/map");
+        (0, vitest_1.expect)(skippedIneligible).toBeDefined();
+    });
+    (0, vitest_1.it)("does not write files in dry-run mode", () => {
+        const { written, skippedIneligible } = (0, seed_instructions_js_1.seedInstructionsAll)(TMP, { dryRun: true });
+        (0, vitest_1.expect)(written.length).toBeGreaterThan(0);
+        for (const dir of written) {
+            (0, vitest_1.expect)((0, node_fs_1.existsSync)((0, node_path_1.join)(TMP, dir, "POLARIS.md"))).toBe(false);
+        }
+        (0, vitest_1.expect)(skippedIneligible).toBeDefined();
+    });
+    (0, vitest_1.it)("skips ineligible directories like node_modules and dist", () => {
+        // Create ineligible directories
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(TMP, "node_modules"), { recursive: true });
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(TMP, "dist"), { recursive: true });
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(TMP, "src/node_modules"), { recursive: true });
+        const { written, skippedIneligible } = (0, seed_instructions_js_1.seedInstructionsAll)(TMP);
+        // node_modules and dist should be in skippedIneligible
+        const ineligiblePaths = skippedIneligible.map((s) => s.path);
+        (0, vitest_1.expect)(ineligiblePaths).toContain("node_modules");
+        (0, vitest_1.expect)(ineligiblePaths).toContain("dist");
+        (0, vitest_1.expect)(ineligiblePaths).toContain("src/node_modules");
+        // node_modules and dist should NOT be in written
+        (0, vitest_1.expect)(written).not.toContain("node_modules");
+        (0, vitest_1.expect)(written).not.toContain("dist");
+        (0, vitest_1.expect)(written).not.toContain("src/node_modules");
+    });
+    (0, vitest_1.it)("skips root by default for POLARIS.md", () => {
+        const { written, skippedRoot } = (0, seed_instructions_js_1.seedInstructionsAll)(TMP);
+        // Root should not be in written
+        (0, vitest_1.expect)(written).not.toContain(".");
+        // Root should be in skippedRoot
+        (0, vitest_1.expect)(skippedRoot).toBeDefined();
+        (0, vitest_1.expect)(skippedRoot?.path).toBe(".");
+    });
+    (0, vitest_1.it)("includes root when includeRoot option is set", () => {
+        const { written, skippedRoot } = (0, seed_instructions_js_1.seedInstructionsAll)(TMP, { includeRoot: true });
+        // Root should be in written
+        (0, vitest_1.expect)(written).toContain(".");
+        // Root should not be in skippedRoot
+        (0, vitest_1.expect)(skippedRoot).toBeUndefined();
+    });
+});
+(0, vitest_1.describe)("generateSummaryDraft", () => {
+    (0, vitest_1.it)("includes draft marker at top", () => {
+        const content = (0, seed_instructions_js_1.generateSummaryDraft)("src/map", TMP, {});
+        (0, vitest_1.expect)(content.startsWith(seed_instructions_js_1.DRAFT_MARKER)).toBe(true);
+    });
+    (0, vitest_1.it)("uses directory basename in heading", () => {
+        const content = (0, seed_instructions_js_1.generateSummaryDraft)("src/map", TMP, {});
+        (0, vitest_1.expect)(content).toContain("# Summary: map");
+    });
+    (0, vitest_1.it)("includes all standard schema sections", () => {
+        const content = (0, seed_instructions_js_1.generateSummaryDraft)("src/map", TMP, {});
+        (0, vitest_1.expect)(content).toContain("## Purpose");
+        (0, vitest_1.expect)(content).toContain("## Core Concepts");
+        (0, vitest_1.expect)(content).toContain("## Architectural Role");
+        (0, vitest_1.expect)(content).toContain("## Key Constraints");
+        (0, vitest_1.expect)(content).toContain("## Important Relationships");
+        (0, vitest_1.expect)(content).toContain("## Current State");
+        (0, vitest_1.expect)(content).toContain("## Known Drift");
+        (0, vitest_1.expect)(content).toContain("## Linked Canonical Sources");
+    });
+});
+(0, vitest_1.describe)("seedSummary", () => {
+    (0, vitest_1.beforeEach)(setup);
+    (0, vitest_1.afterEach)(teardown);
+    (0, vitest_1.it)("writes a SUMMARY.md draft and returns written", () => {
+        const result = (0, seed_instructions_js_1.seedSummary)("src/map", TMP);
+        (0, vitest_1.expect)(result).toBe("written");
+        const outPath = (0, node_path_1.join)(TMP, "src/map/SUMMARY.md");
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)(outPath)).toBe(true);
+        const content = (0, node_fs_1.readFileSync)(outPath, "utf-8");
+        (0, vitest_1.expect)(content).toContain(seed_instructions_js_1.DRAFT_MARKER);
+        (0, vitest_1.expect)(content).toContain("# Summary: map");
+    });
+    (0, vitest_1.it)("returns skipped-exists when human-edited SUMMARY.md present", () => {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(TMP, "src/map/SUMMARY.md"), "# Human-edited");
+        const result = (0, seed_instructions_js_1.seedSummary)("src/map", TMP);
+        (0, vitest_1.expect)(result).toBe("skipped-exists");
+    });
+    (0, vitest_1.it)("returns skipped-draft when draft SUMMARY.md already present", () => {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(TMP, "src/map/SUMMARY.md"), `${seed_instructions_js_1.DRAFT_MARKER}\n# Draft`);
+        const result = (0, seed_instructions_js_1.seedSummary)("src/map", TMP);
+        (0, vitest_1.expect)(result).toBe("skipped-draft");
+    });
+    (0, vitest_1.it)("does not write file in dry-run mode", () => {
+        const result = (0, seed_instructions_js_1.seedSummary)("src/map", TMP, { dryRun: true });
+        (0, vitest_1.expect)(result).toBe("written");
+        (0, vitest_1.expect)((0, node_fs_1.existsSync)((0, node_path_1.join)(TMP, "src/map/SUMMARY.md"))).toBe(false);
+    });
+});
+(0, vitest_1.describe)("seedSummaryAll", () => {
+    (0, vitest_1.beforeEach)(setup);
+    (0, vitest_1.afterEach)(teardown);
+    (0, vitest_1.it)("generates drafts for directories without SUMMARY.md", () => {
+        const { written, skippedIneligible } = (0, seed_instructions_js_1.seedSummaryAll)(TMP);
+        (0, vitest_1.expect)(written).toContain("src/map");
+        (0, vitest_1.expect)(written).toContain("src/cli");
+        (0, vitest_1.expect)(skippedIneligible).toBeDefined();
+    });
+    (0, vitest_1.it)("skips root by default for SUMMARY.md", () => {
+        const { written, skippedRoot } = (0, seed_instructions_js_1.seedSummaryAll)(TMP);
+        // Root should not be in written
+        (0, vitest_1.expect)(written).not.toContain(".");
+        // Root should be in skippedRoot
+        (0, vitest_1.expect)(skippedRoot).toBeDefined();
+        (0, vitest_1.expect)(skippedRoot?.path).toBe(".");
+    });
+    (0, vitest_1.it)("includes root when includeRoot option is set for SUMMARY.md", () => {
+        const { written, skippedRoot } = (0, seed_instructions_js_1.seedSummaryAll)(TMP, { includeRoot: true });
+        // Root should be in written
+        (0, vitest_1.expect)(written).toContain(".");
+        // Root should not be in skippedRoot
+        (0, vitest_1.expect)(skippedRoot).toBeUndefined();
+    });
+    (0, vitest_1.it)("skips directories with human-edited SUMMARY.md", () => {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(TMP, "src/map/SUMMARY.md"), "# Human-edited");
+        const { written, skippedExists, skippedIneligible } = (0, seed_instructions_js_1.seedSummaryAll)(TMP);
+        (0, vitest_1.expect)(skippedExists).toContain("src/map");
+        (0, vitest_1.expect)(written).not.toContain("src/map");
+        (0, vitest_1.expect)(skippedIneligible).toBeDefined();
+    });
+    (0, vitest_1.it)("skips directories with draft SUMMARY.md", () => {
+        (0, node_fs_1.writeFileSync)((0, node_path_1.join)(TMP, "src/map/SUMMARY.md"), `${seed_instructions_js_1.DRAFT_MARKER}\n# Draft`);
+        const { skippedDraft, skippedIneligible } = (0, seed_instructions_js_1.seedSummaryAll)(TMP);
+        (0, vitest_1.expect)(skippedDraft).toContain("src/map");
+        (0, vitest_1.expect)(skippedIneligible).toBeDefined();
+    });
+    (0, vitest_1.it)("skips ineligible directories like node_modules and dist", () => {
+        // Create ineligible directories
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(TMP, "node_modules"), { recursive: true });
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(TMP, "dist"), { recursive: true });
+        (0, node_fs_1.mkdirSync)((0, node_path_1.join)(TMP, "coverage"), { recursive: true });
+        const { written, skippedIneligible } = (0, seed_instructions_js_1.seedSummaryAll)(TMP);
+        // node_modules, dist, coverage should be in skippedIneligible
+        const ineligiblePaths = skippedIneligible.map((s) => s.path);
+        (0, vitest_1.expect)(ineligiblePaths).toContain("node_modules");
+        (0, vitest_1.expect)(ineligiblePaths).toContain("dist");
+        (0, vitest_1.expect)(ineligiblePaths).toContain("coverage");
+        // node_modules, dist, coverage should NOT be in written
+        (0, vitest_1.expect)(written).not.toContain("node_modules");
+        (0, vitest_1.expect)(written).not.toContain("dist");
+        (0, vitest_1.expect)(written).not.toContain("coverage");
+    });
+});