akm-cli 0.7.0-rc1 → 0.7.1

package/dist/tests/file-context.test.js

@@ -1,552 +0,0 @@
-import { afterAll, describe, expect, test } from "bun:test";
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { buildFileContext, buildRenderContext, getAllRenderers, getRenderer, runMatchers, } from "../src/indexer/file-context";
-import { directoryMatcher, smartMdMatcher } from "../src/indexer/matchers";
-import { walkStashFlat } from "../src/indexer/walker";
-// ── Temp directory helpers ──────────────────────────────────────────────────
-const createdTmpDirs = [];
-function expectDefined(value) {
-    expect(value).toBeDefined();
-    if (value === undefined || value === null) {
-        throw new Error("Expected value to be defined");
-    }
-    return value;
-}
-function tmpDir(prefix = "akm-fc-") {
-    const dir = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
-    createdTmpDirs.push(dir);
-    return dir;
-}
-function writeFile(filePath, content = "") {
-    fs.mkdirSync(path.dirname(filePath), { recursive: true });
-    fs.writeFileSync(filePath, content);
-}
-afterAll(() => {
-    for (const dir of createdTmpDirs) {
-        fs.rmSync(dir, { recursive: true, force: true });
-    }
-});
-// ── 1. buildFileContext tests ───────────────────────────────────────────────
-describe("buildFileContext", () => {
-    test("computes path fields correctly for nested file", () => {
-        const root = tmpDir();
-        const realPath = path.join(root, "scripts", "azure", "deploy.sh");
-        writeFile(realPath, "#!/bin/bash\necho deploy\n");
-        const ctx = buildFileContext(root, realPath);
-        expect(ctx.relPath).toBe("scripts/azure/deploy.sh");
-        expect(ctx.ext).toBe(".sh");
-        expect(ctx.fileName).toBe("deploy.sh");
-        expect(ctx.parentDir).toBe("azure");
-        expect(ctx.ancestorDirs).toEqual(["scripts", "azure"]);
-        expect(ctx.stashRoot).toBe(root);
-    });
-    test("lazy content() reads file and caches result", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "test.txt");
-        writeFile(filePath, "hello world");
-        const ctx = buildFileContext(root, filePath);
-        // First call reads the file
-        const firstRead = ctx.content();
-        expect(firstRead).toBe("hello world");
-        // Modify the file on disk to verify caching
-        fs.writeFileSync(filePath, "changed content");
-        // Second call should return cached value
-        const secondRead = ctx.content();
-        expect(secondRead).toBe("hello world");
-    });
-    test("lazy frontmatter() returns parsed data for .md with frontmatter", () => {
-        const root = tmpDir();
-        const mdPath = path.join(root, "agents", "reviewer.md");
-        writeFile(mdPath, ["---", "description: Code reviewer", "model: gpt-4", "---", "You are a code reviewer."].join("\n"));
-        const ctx = buildFileContext(root, mdPath);
-        const fm = ctx.frontmatter();
-        expect(fm).not.toBeNull();
-        expect(fm?.description).toBe("Code reviewer");
-        expect(fm?.model).toBe("gpt-4");
-    });
-    test("lazy frontmatter() returns null for .md without frontmatter", () => {
-        const root = tmpDir();
-        const mdPath = path.join(root, "knowledge", "guide.md");
-        writeFile(mdPath, "# Just a heading\nSome content.");
-        const ctx = buildFileContext(root, mdPath);
-        expect(ctx.frontmatter()).toBeNull();
-    });
-    test("lazy frontmatter() returns null for non-.md files", () => {
-        const root = tmpDir();
-        const shPath = path.join(root, "scripts", "deploy.sh");
-        writeFile(shPath, "#!/bin/bash\necho deploy\n");
-        const ctx = buildFileContext(root, shPath);
-        expect(ctx.frontmatter()).toBeNull();
-    });
-    test("lazy stat() returns fs.Stats", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "test.txt");
-        writeFile(filePath, "hello world");
-        const ctx = buildFileContext(root, filePath);
-        const stat = ctx.stat();
-        expect(stat).toBeDefined();
-        expect(stat.isFile()).toBe(true);
-        expect(stat.size).toBe(11);
-    });
-    test("handles file directly in stashRoot (no parent dirs)", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "README.md");
-        writeFile(filePath, "# Root file");
-        const ctx = buildFileContext(root, filePath);
-        expect(ctx.relPath).toBe("README.md");
-        expect(ctx.fileName).toBe("README.md");
-        expect(ctx.ancestorDirs).toEqual([]);
-    });
-    test("handles deeply nested files", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "a", "b", "c", "d", "deep.ts");
-        writeFile(filePath, "console.log('deep')\n");
-        const ctx = buildFileContext(root, filePath);
-        expect(ctx.relPath).toBe("a/b/c/d/deep.ts");
-        expect(ctx.ext).toBe(".ts");
-        expect(ctx.fileName).toBe("deep.ts");
-        expect(ctx.parentDir).toBe("d");
-        expect(ctx.ancestorDirs).toEqual(["a", "b", "c", "d"]);
-    });
-});
-// ── 2. runMatchers tests ────────────────────────────────────────────────────
-describe("runMatchers", () => {
-    test("directoryMatcher matches .sh file under scripts/ as 'script'", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "scripts", "deploy.sh");
-        writeFile(filePath, "#!/bin/bash\necho deploy\n");
-        const ctx = buildFileContext(root, filePath);
-        const result = directoryMatcher(ctx);
-        expect(result).not.toBeNull();
-        expect(result?.type).toBe("script");
-        expect(result?.specificity).toBe(10);
-    });
-    test("directoryMatcher matches SKILL.md under skills/ as 'skill'", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "skills", "review", "SKILL.md");
-        writeFile(filePath, "# Review Skill");
-        const ctx = buildFileContext(root, filePath);
-        const result = directoryMatcher(ctx);
-        expect(result).not.toBeNull();
-        expect(result?.type).toBe("skill");
-        expect(result?.specificity).toBe(10);
-    });
-    test("directoryMatcher matches .md under commands/ as 'command'", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "commands", "deploy.md");
-        writeFile(filePath, "---\ndescription: Deploy\n---\nDeploy it.");
-        const ctx = buildFileContext(root, filePath);
-        const result = directoryMatcher(ctx);
-        expect(result).not.toBeNull();
-        expect(result?.type).toBe("command");
-    });
-    test("directoryMatcher matches .md under agents/ as 'agent'", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "agents", "reviewer.md");
-        writeFile(filePath, "You are a code reviewer.");
-        const ctx = buildFileContext(root, filePath);
-        const result = directoryMatcher(ctx);
-        expect(result).not.toBeNull();
-        expect(result?.type).toBe("agent");
-    });
-    test("directoryMatcher matches .md under nested agents/ path as 'agent'", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "agent-stash", "agents", "blog", "topic-discovery.md");
-        writeFile(filePath, "You are a topic discovery agent.");
-        const ctx = buildFileContext(root, filePath);
-        const result = directoryMatcher(ctx);
-        expect(result).not.toBeNull();
-        expect(result?.type).toBe("agent");
-        expect(result?.specificity).toBe(10);
-        expect(result?.renderer).toBe("agent-md");
-    });
-    test("directoryMatcher matches .md under knowledge/ as 'knowledge'", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "knowledge", "guide.md");
-        writeFile(filePath, "# Guide\nSome knowledge.");
-        const ctx = buildFileContext(root, filePath);
-        const result = directoryMatcher(ctx);
-        expect(result).not.toBeNull();
-        expect(result?.type).toBe("knowledge");
-    });
-    test("directoryMatcher matches .py under scripts/ as 'script'", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "scripts", "analyze.py");
-        writeFile(filePath, "print('hello')");
-        const ctx = buildFileContext(root, filePath);
-        const result = directoryMatcher(ctx);
-        expect(result).not.toBeNull();
-        expect(result?.type).toBe("script");
-    });
-    test("smartMdMatcher matches .md with 'model' frontmatter as 'agent' at specificity 8 (weak signal)", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "misc", "assistant.md");
-        writeFile(filePath, ["---", "model: gpt-4", "---", "You are an assistant."].join("\n"));
-        const ctx = buildFileContext(root, filePath);
-        const result = smartMdMatcher(ctx);
-        // model alone is a weak agent signal -- commands also use model
-        expect(result).not.toBeNull();
-        expect(result?.type).toBe("agent");
-        expect(result?.specificity).toBe(8);
-    });
-    test("smartMdMatcher matches .md with 'tools' frontmatter as 'agent'", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "misc", "builder.md");
-        writeFile(filePath, ["---", "tools:", "  read: allow", "---", "You are a builder."].join("\n"));
-        const ctx = buildFileContext(root, filePath);
-        const result = smartMdMatcher(ctx);
-        expect(result).not.toBeNull();
-        expect(result?.type).toBe("agent");
-        expect(result?.specificity).toBe(20);
-    });
-    test("smartMdMatcher classifies .md without agent/command signals as knowledge", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "misc", "deploy.md");
-        writeFile(filePath, ["---", "description: Deploy to prod", "---", "Run deploy."].join("\n"));
-        const ctx = buildFileContext(root, filePath);
-        const result = smartMdMatcher(ctx);
-        // No agent or command signals; falls back to knowledge
-        expect(result).not.toBeNull();
-        expect(result?.type).toBe("knowledge");
-        expect(result?.specificity).toBe(5);
-    });
-    test("smartMdMatcher detects 'agent' frontmatter as command signal at specificity 18", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "misc", "build.md");
-        writeFile(filePath, ["---", "agent: build", "description: Build the project", "---", "Build $ARGUMENTS."].join("\n"));
-        const ctx = buildFileContext(root, filePath);
-        const result = smartMdMatcher(ctx);
-        expect(result).not.toBeNull();
-        expect(result?.type).toBe("command");
-        expect(result?.specificity).toBe(18);
-        expect(result?.renderer).toBe("command-md");
-    });
-    test("smartMdMatcher detects $ARGUMENTS placeholder as command signal at specificity 18", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "misc", "deploy.md");
-        writeFile(filePath, "Deploy $ARGUMENTS to production.");
-        const ctx = buildFileContext(root, filePath);
-        const result = smartMdMatcher(ctx);
-        expect(result).not.toBeNull();
-        expect(result?.type).toBe("command");
-        expect(result?.specificity).toBe(18);
-    });
-    test("smartMdMatcher detects $1/$2/$3 placeholders as command signal", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "misc", "greet.md");
-        writeFile(filePath, "Hello $1, welcome to $2.");
-        const ctx = buildFileContext(root, filePath);
-        const result = smartMdMatcher(ctx);
-        expect(result).not.toBeNull();
-        expect(result?.type).toBe("command");
-        expect(result?.specificity).toBe(18);
-    });
-    test("smartMdMatcher: tools/toolPolicy (20) beats agent frontmatter command signal (18)", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "misc", "hybrid.md");
-        writeFile(filePath, ["---", "tools:", "  read: allow", "agent: build", "---", "You are a hybrid."].join("\n"));
-        const ctx = buildFileContext(root, filePath);
-        const result = smartMdMatcher(ctx);
-        // tools is agent-exclusive at 20, wins over agent dispatch at 18
-        expect(result?.type).toBe("agent");
-        expect(result?.specificity).toBe(20);
-    });
-    test("smartMdMatcher: agent frontmatter (18) beats model-only (8)", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "misc", "deploy.md");
-        writeFile(filePath, ["---", "model: gpt-4", "agent: build", "---", "Deploy things."].join("\n"));
-        const ctx = buildFileContext(root, filePath);
-        const result = smartMdMatcher(ctx);
-        // agent frontmatter is a command signal at 18
-        expect(result?.type).toBe("command");
-        expect(result?.specificity).toBe(18);
-    });
-    test("smartMdMatcher falls back to 'knowledge' at specificity 5 for plain .md", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "misc", "guide.md");
-        writeFile(filePath, "# Guide\nJust a plain markdown document.");
-        const ctx = buildFileContext(root, filePath);
-        const result = smartMdMatcher(ctx);
-        expect(result).not.toBeNull();
-        expect(result?.type).toBe("knowledge");
-        expect(result?.specificity).toBe(5);
-    });
-    test("smartMdMatcher returns null for non-.md files", () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "scripts", "deploy.sh");
-        writeFile(filePath, "#!/bin/bash\necho deploy\n");
-        const ctx = buildFileContext(root, filePath);
-        expect(smartMdMatcher(ctx)).toBeNull();
-    });
-    test("specificity ordering: strong agent signal (tools) beats directoryMatcher", async () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "commands", "hybrid.md");
-        writeFile(filePath, ["---", "tools:", "  read: allow", "---", "Agent in commands dir."].join("\n"));
-        const ctx = buildFileContext(root, filePath);
-        // directoryMatcher says "command" at specificity 10
-        const dirResult = directoryMatcher(ctx);
-        expect(dirResult?.type).toBe("command");
-        expect(dirResult?.specificity).toBe(10);
-        // smartMdMatcher says "agent" at specificity 20 (tools is a strong signal)
-        const smartResult = smartMdMatcher(ctx);
-        expect(smartResult?.type).toBe("agent");
-        expect(smartResult?.specificity).toBe(20);
-        // runMatchers should pick the higher specificity
-        const best = await runMatchers(ctx);
-        expect(best).not.toBeNull();
-        expect(best?.type).toBe("agent");
-        expect(best?.specificity).toBe(20);
-    });
-    test("specificity ordering: directoryMatcher(10) beats smartMdMatcher(5) for plain .md", async () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "knowledge", "reference.md");
-        writeFile(filePath, "# Reference\nPlain knowledge document.");
-        const ctx = buildFileContext(root, filePath);
-        // directoryMatcher says "knowledge" at specificity 10
-        expect(directoryMatcher(ctx)?.specificity).toBe(10);
-        // smartMdMatcher says "knowledge" at specificity 5
-        expect(smartMdMatcher(ctx)?.specificity).toBe(5);
-        // runMatchers should pick specificity 10
-        const best = await runMatchers(ctx);
-        expect(best?.specificity).toBeGreaterThanOrEqual(10);
-    });
-    test("runMatchers returns null for unmatched file types", async () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "data", "config.json");
-        writeFile(filePath, '{"key": "value"}');
-        const ctx = buildFileContext(root, filePath);
-        const result = await runMatchers(ctx);
-        expect(result).toBeNull();
-    });
-});
-// ── 3. Renderer tests ───────────────────────────────────────────────────────
-describe("Renderer", () => {
-    test("getRenderer('script-source') returns the script renderer", async () => {
-        const renderer = await getRenderer("script-source");
-        expect(renderer).toBeDefined();
-        expect(renderer?.name).toBe("script-source");
-    });
-    test("getRenderer('agent-md') builds show response with prompt prefix", async () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "agents", "reviewer.md");
-        writeFile(filePath, ["---", "description: Code reviewer", "model: gpt-4", "---", "You are a code reviewer."].join("\n"));
-        const renderer = expectDefined(await getRenderer("agent-md"));
-        const ctx = buildFileContext(root, filePath);
-        const match = { type: "agent", specificity: 20, renderer: "agent-md", meta: { name: "reviewer.md" } };
-        const renderCtx = buildRenderContext(ctx, match, [root]);
-        const response = renderer.buildShowResponse(renderCtx);
-        expect(response.type).toBe("agent");
-        expect(response.action).toContain("verbatim");
-        expect(response.prompt).toBeDefined();
-        expect(response.prompt).toContain("You are a code reviewer.");
-        expect(response.description).toBe("Code reviewer");
-        expect(response.modelHint).toBe("gpt-4");
-    });
-    test("getRenderer('command-md') extracts template from body", async () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "commands", "deploy.md");
-        writeFile(filePath, ["---", "description: Deploy to production", "---", "Run the deploy script with {{env}}."].join("\n"));
-        const renderer = expectDefined(await getRenderer("command-md"));
-        const ctx = buildFileContext(root, filePath);
-        const match = { type: "command", specificity: 10, renderer: "command-md", meta: { name: "deploy.md" } };
-        const renderCtx = buildRenderContext(ctx, match, [root]);
-        const response = renderer.buildShowResponse(renderCtx);
-        expect(response.type).toBe("command");
-        expect(response.template).toBe("Run the deploy script with {{env}}.");
-        expect(response.description).toBe("Deploy to production");
-    });
-    test("getRenderer('knowledge-md') handles toc view", async () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "knowledge", "guide.md");
-        writeFile(filePath, [
-            "---",
-            "title: Guide",
-            "---",
-            "# Introduction",
-            "Welcome.",
-            "",
-            "## Setup",
-            "Install.",
-            "",
-            "## Usage",
-            "Use.",
-        ].join("\n"));
-        const renderer = expectDefined(await getRenderer("knowledge-md"));
-        const ctx = buildFileContext(root, filePath);
-        const match = {
-            type: "knowledge",
-            specificity: 10,
-            renderer: "knowledge-md",
-            meta: { name: "guide.md", view: { mode: "toc" } },
-        };
-        const renderCtx = buildRenderContext(ctx, match, [root]);
-        const response = renderer.buildShowResponse(renderCtx);
-        expect(response.content).toContain("Introduction");
-        expect(response.content).toContain("Setup");
-        expect(response.content).toContain("Usage");
-    });
-    test("getRenderer('knowledge-md') handles section view", async () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "knowledge", "guide.md");
-        writeFile(filePath, ["# Intro", "Welcome.", "", "## Setup", "Install things.", "", "## Usage", "Use things."].join("\n"));
-        const renderer = expectDefined(await getRenderer("knowledge-md"));
-        const ctx = buildFileContext(root, filePath);
-        const match = {
-            type: "knowledge",
-            specificity: 10,
-            renderer: "knowledge-md",
-            meta: { name: "guide.md", view: { mode: "section", heading: "Setup" } },
-        };
-        const renderCtx = buildRenderContext(ctx, match, [root]);
-        const response = renderer.buildShowResponse(renderCtx);
-        expect(response.content).toContain("## Setup");
-        expect(response.content).toContain("Install things.");
-    });
-    test("getRenderer('knowledge-md') handles lines view", async () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "knowledge", "guide.md");
-        writeFile(filePath, ["# Intro", "Welcome.", "", "## Setup", "Install things."].join("\n"));
-        const renderer = expectDefined(await getRenderer("knowledge-md"));
-        const ctx = buildFileContext(root, filePath);
-        const match = {
-            type: "knowledge",
-            specificity: 10,
-            renderer: "knowledge-md",
-            meta: { name: "guide.md", view: { mode: "lines", start: 1, end: 2 } },
-        };
-        const renderCtx = buildRenderContext(ctx, match, [root]);
-        const response = renderer.buildShowResponse(renderCtx);
-        expect(response.content).toContain("Intro");
-        expect(response.content).toContain("Welcome");
-        expect(response.content).not.toContain("Setup");
-    });
-    test("getAllRenderers() returns all 10 built-in renderers", async () => {
-        const all = await getAllRenderers();
-        expect(all).toHaveLength(10);
-        const names = all.map((r) => r.name).sort();
-        expect(names).toEqual([
-            "agent-md",
-            "command-md",
-            "knowledge-md",
-            "lesson-md",
-            "memory-md",
-            "script-source",
-            "skill-md",
-            "vault-env",
-            "wiki-md",
-            "workflow-md",
-        ]);
-    });
-    test("getRenderer returns undefined for unknown renderer name", async () => {
-        expect(await getRenderer("nonexistent")).toBeUndefined();
-    });
-    test("workflow renderer builds origin-aware shell-quoted action text", async () => {
-        const root = tmpDir();
-        const filePath = path.join(root, "workflows", "release flow.md");
-        writeFile(filePath, [
-            "---",
-            "description: Ship a release safely",
-            "---",
-            "# Workflow: Release Flow",
-            "",
-            "## Step: Validate",
-            "Step ID: validate",
-            "",
-            "### Instructions",
-            "Check inputs.",
-        ].join("\n"));
-        const renderer = expectDefined(await getRenderer("workflow-md"));
-        const ctx = buildFileContext(root, filePath);
-        const match = { type: "workflow", specificity: 10, renderer: "workflow-md", meta: { name: "release flow" } };
-        const renderCtx = buildRenderContext(ctx, match, [root], "npm:@scope/pkg");
-        const response = renderer.buildShowResponse(renderCtx);
-        expect(response.action).toContain("akm workflow next 'npm:@scope/pkg//workflow:release flow'");
-    });
-});
-// ── 4. walkStashFlat tests ──────────────────────────────────────────────────
-describe("walkStashFlat", () => {
-    test("returns empty array for non-existent directory", () => {
-        expect(walkStashFlat("/nonexistent/path")).toEqual([]);
-    });
-    test("returns empty array for empty directory", () => {
-        const root = tmpDir();
-        expect(walkStashFlat(root)).toEqual([]);
-    });
-    test("finds files across nested directories", () => {
-        const root = tmpDir();
-        writeFile(path.join(root, "scripts", "deploy.sh"), "echo deploy\n");
-        writeFile(path.join(root, "agents", "reviewer.md"), "You are a reviewer.");
-        writeFile(path.join(root, "knowledge", "guide.md"), "# Guide");
-        writeFile(path.join(root, "scripts", "deep", "nested", "analyze.py"), "print('hi')");
-        const results = walkStashFlat(root);
-        expect(results.length).toBe(4);
-        const relPaths = results.map((ctx) => ctx.relPath).sort();
-        expect(relPaths).toContain("scripts/deploy.sh");
-        expect(relPaths).toContain("agents/reviewer.md");
-        expect(relPaths).toContain("knowledge/guide.md");
-        expect(relPaths).toContain("scripts/deep/nested/analyze.py");
-    });
-    test("skips .git directories", () => {
-        const root = tmpDir();
-        writeFile(path.join(root, "scripts", "deploy.sh"), "echo deploy\n");
-        writeFile(path.join(root, ".git", "config"), "[core]\n");
-        const results = walkStashFlat(root);
-        expect(results.length).toBe(1);
-        expect(results[0].relPath).toBe("scripts/deploy.sh");
-    });
-    test("skips node_modules directories", () => {
-        const root = tmpDir();
-        writeFile(path.join(root, "scripts", "deploy.sh"), "echo deploy\n");
-        writeFile(path.join(root, "node_modules", "pkg", "index.js"), "module.exports = {}");
-        const results = walkStashFlat(root);
-        expect(results.length).toBe(1);
-        expect(results[0].relPath).toBe("scripts/deploy.sh");
-    });
-    test("skips .stash.json files", () => {
-        const root = tmpDir();
-        writeFile(path.join(root, "scripts", "deploy.sh"), "echo deploy\n");
-        writeFile(path.join(root, "scripts", ".stash.json"), '{"entries":[]}');
-        writeFile(path.join(root, ".stash.json"), '{"meta":true}');
-        const results = walkStashFlat(root);
-        expect(results.length).toBe(1);
-        expect(results[0].relPath).toBe("scripts/deploy.sh");
-    });
-    test("each returned item is a valid FileContext with correct fields", () => {
-        const root = tmpDir();
-        writeFile(path.join(root, "scripts", "azure", "deploy.sh"), "#!/bin/bash\necho deploy\n");
-        writeFile(path.join(root, "agents", "reviewer.md"), "You are a reviewer.");
-        const results = walkStashFlat(root);
-        expect(results.length).toBe(2);
-        for (const ctx of results) {
-            expect(typeof ctx.absPath).toBe("string");
-            expect(path.isAbsolute(ctx.absPath)).toBe(true);
-            expect(typeof ctx.relPath).toBe("string");
-            expect(typeof ctx.ext).toBe("string");
-            expect(typeof ctx.fileName).toBe("string");
-            expect(ctx.stashRoot).toBe(root);
-            expect(Array.isArray(ctx.ancestorDirs)).toBe(true);
-            expect(typeof ctx.content).toBe("function");
-            expect(typeof ctx.frontmatter).toBe("function");
-            expect(typeof ctx.stat).toBe("function");
-        }
-        const deployCtx = results.find((ctx) => ctx.fileName === "deploy.sh");
-        expect(deployCtx).toBeDefined();
-        expect(deployCtx?.relPath).toBe("scripts/azure/deploy.sh");
-        expect(deployCtx?.ext).toBe(".sh");
-        expect(deployCtx?.parentDir).toBe("azure");
-        expect(deployCtx?.ancestorDirs).toEqual(["scripts", "azure"]);
-        expect(deployCtx?.content()).toBe("#!/bin/bash\necho deploy\n");
-    });
-    test("handles multiple files in the same directory", () => {
-        const root = tmpDir();
-        writeFile(path.join(root, "scripts", "build.sh"), "echo build\n");
-        writeFile(path.join(root, "scripts", "test.sh"), "echo test\n");
-        writeFile(path.join(root, "scripts", "deploy.sh"), "echo deploy\n");
-        const results = walkStashFlat(root);
-        expect(results.length).toBe(3);
-        const fileNames = results.map((ctx) => ctx.fileName).sort();
-        expect(fileNames).toEqual(["build.sh", "deploy.sh", "test.sh"]);
-    });
-});

package/dist/tests/fixtures/scripts/git/summarize-diff.js

@@ -1,9 +0,0 @@
-"use strict";
-/**
- * Summarize git diff changes into a concise developer-friendly report.
- * Reads the current staged diff and produces a human-readable summary.
- */
-console.log(JSON.stringify({
-    summary: "3 files changed: added auth middleware, updated user model, fixed login route",
-    filesChanged: 3,
-}));

package/dist/tests/fixtures/scripts/lint/eslint-check.js

@@ -1,7 +0,0 @@
-"use strict";
-/**
- * Run ESLint on the project and report issues.
- * Checks for code style and potential bugs.
- */
-console.log("Checking 42 files...");
-console.log("No issues found.");