@unlimitechcloud/devlink 1.0.2

package/dist/commands/consumers.js

@@ -0,0 +1,107 @@
+/**
+ * Consumers Command - Listar proyectos consumidores
+ */
+import { withStoreLock } from "../core/lock.js";
+import { readInstallations, writeInstallations, getConsumers, getConsumersByNamespace, getAllProjects, getProject, pruneDeadProjects, } from "../core/installations.js";
+import { formatConsumersTree } from "../formatters/tree.js";
+import { formatConsumersFlat } from "../formatters/flat.js";
+/**
+ * Get consumers info
+ */
+export async function getConsumersInfo(options = {}) {
+    const installations = await readInstallations();
+    let pruned;
+    // Handle prune option
+    if (options.prune) {
+        pruned = await withStoreLock(async () => {
+            const removed = await pruneDeadProjects(installations);
+            if (removed.length > 0) {
+                await writeInstallations(installations);
+            }
+            return removed;
+        });
+    }
+    const consumers = [];
+    if (options.package) {
+        // Filter by package
+        const packageConsumers = getConsumers(installations, options.package, {
+            namespace: options.namespace,
+        });
+        for (const { projectPath, info } of packageConsumers) {
+            consumers.push({
+                projectPath,
+                packages: [{
+                        name: options.package,
+                        version: info.version,
+                        namespace: info.namespace,
+                    }],
+            });
+        }
+    }
+    else if (options.namespace) {
+        // Filter by namespace
+        const nsConsumers = getConsumersByNamespace(installations, options.namespace);
+        for (const { projectPath, packages } of nsConsumers) {
+            consumers.push({
+                projectPath,
+                packages: Object.entries(packages).map(([name, info]) => ({
+                    name,
+                    version: info.version,
+                    namespace: info.namespace,
+                })),
+            });
+        }
+    }
+    else {
+        // All consumers
+        const projects = getAllProjects(installations);
+        for (const projectPath of projects) {
+            const project = getProject(installations, projectPath);
+            if (!project)
+                continue;
+            consumers.push({
+                projectPath,
+                packages: Object.entries(project.packages).map(([name, info]) => ({
+                    name,
+                    version: info.version,
+                    namespace: info.namespace,
+                })),
+            });
+        }
+    }
+    return { consumers, pruned };
+}
+/**
+ * Format consumers output
+ */
+export async function listConsumers(options = {}) {
+    const { consumers, pruned } = await getConsumersInfo(options);
+    let output;
+    if (options.flat) {
+        output = formatConsumersFlat(consumers);
+    }
+    else {
+        output = formatConsumersTree(consumers);
+    }
+    if (pruned && pruned.length > 0) {
+        output += `\n\n🧹 Pruned ${pruned.length} dead project(s):\n`;
+        for (const p of pruned) {
+            output += `  - ${p}\n`;
+        }
+    }
+    return output;
+}
+/**
+ * CLI handler for consumers command
+ */
+export async function handleConsumers(args) {
+    try {
+        const output = await listConsumers(args);
+        console.log(output);
+    }
+    catch (error) {
+        console.error(`✗ Consumers failed: ${error.message}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=consumers.js.map

package/dist/commands/consumers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumers.js","sourceRoot":"","sources":["../../src/commands/consumers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,uBAAuB,EACvB,cAAc,EACd,UAAU,EACV,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAS5D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,UAA4B,EAAE;IAInE,MAAM,aAAa,GAAG,MAAM,iBAAiB,EAAE,CAAC;IAChD,IAAI,MAA4B,CAAC;IAEjC,sBAAsB;IACtB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,GAAG,MAAM,aAAa,CAAC,KAAK,IAAI,EAAE;YACtC,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,aAAa,CAAC,CAAC;YACvD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,MAAM,kBAAkB,CAAC,aAAa,CAAC,CAAC;YAC1C,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,SAAS,GAAgG,EAAE,CAAC;IAElH,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,oBAAoB;QACpB,MAAM,gBAAgB,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,EAAE;YACpE,SAAS,EAAE,OAAO,CAAC,SAAS;SAC7B,CAAC,CAAC;QAEH,KAAK,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,gBAAgB,EAAE,CAAC;YACrD,SAAS,CAAC,IAAI,CAAC;gBACb,WAAW;gBACX,QAAQ,EAAE,CAAC;wBACT,IAAI,EAAE,OAAO,CAAC,OAAO;wBACrB,OAAO,EAAE,IAAI,CAAC,OAAO;wBACrB,SAAS,EAAE,IAAI,CAAC,SAAS;qBAC1B,CAAC;aACH,CAAC,CAAC;QACL,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QAC7B,sBAAsB;QACtB,MAAM,WAAW,GAAG,uBAAuB,CAAC,aAAa,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAE9E,KAAK,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,WAAW,EAAE,CAAC;YACpD,SAAS,CAAC,IAAI,CAAC;gBACb,WAAW;gBACX,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;oBACxD,IAAI;oBACJ,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,SAAS,EAAE,IAAI,CAAC,SAAS;iBAC1B,CAAC,CAAC;aACJ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;SAAM,CAAC;QACN,gBAAgB;QAChB,MAAM,QAAQ,GAAG,cAAc,CAAC,aAAa,CAAC,CAAC;QAE/C,KAAK,MAAM,WAAW,IAAI,QAAQ,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,UAAU,CAAC,aAAa,EAAE,WAAW,CAAC,CAAC;YACvD,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,SAAS,CAAC,IAAI,CAAC;gBACb,WAAW;gBACX,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;oBAChE,IAAI;oBACJ,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,SAAS,EAAE,IAAI,CAAC,SAAS;iBAC1B,CAAC,CAAC;aACJ,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAA4B,EAAE;IAChE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAE9D,IAAI,MAAc,CAAC;IACnB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,iBAAiB,MAAM,CAAC,MAAM,qBAAqB,CAAC;QAC9D,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAKrC;IACC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,uBAAuB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/commands/docs.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Docs Command - Display embedded documentation
+ */
+export interface DocEntry {
+    name: string;
+    path: string;
+    type: "file" | "directory";
+    children?: DocEntry[];
+}
+/**
+ * Get the docs directory path (relative to package root)
+ */
+export declare function getDocsPath(): string;
+/**
+ * Get the AGENTS.md path
+ */
+export declare function getAgentsPath(): string;
+/**
+ * Normalize a path for comparison (lowercase, no .md extension)
+ */
+export declare function normalizePath(p: string): string;
+/**
+ * Build documentation tree from filesystem
+ */
+export declare function buildDocTree(dirPath: string, relativePath?: string): DocEntry[];
+/**
+ * Find a document by path (case insensitive)
+ */
+export declare function findDocument(tree: DocEntry[], searchPath: string): {
+    entry: DocEntry;
+    fullPath: string;
+} | null;
+/**
+ * Format the documentation tree for display
+ */
+export declare function formatTree(entries: DocEntry[], prefix?: string): string;
+/**
+ * Format directory listing
+ */
+export declare function formatDirectoryListing(entry: DocEntry): string;
+/**
+ * Read and return document content
+ */
+export declare function readDocument(docPath: string, docsDir?: string): string | null;
+/**
+ * Read AGENTS.md
+ */
+export declare function readAgents(agentsPath?: string): string | null;
+/**
+ * Main docs command handler
+ */
+export declare function handleDocs(args: {
+    document?: string;
+}): Promise<void>;
+/**
+ * Print docs help
+ */
+export declare function printDocsHelp(): void;
+//# sourceMappingURL=docs.d.ts.map

package/dist/commands/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/commands/docs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAUH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,QAAQ,CAAC,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAGpC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,GAAE,MAAW,GAAG,QAAQ,EAAE,CAoCnF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,QAAQ,EAAE,EAChB,UAAU,EAAE,MAAM,GACjB;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA+B9C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,MAAM,GAAE,MAAW,GAAG,MAAM,CAoB3E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAoB9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS7E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO7D;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAsE3E;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CA2BpC"}

package/dist/commands/docs.js

@@ -0,0 +1,262 @@
+/**
+ * Docs Command - Display embedded documentation
+ */
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Get the docs directory path (relative to package root)
+ */
+export function getDocsPath() {
+    // From dist/commands/docs.js, go up to package root
+    return path.resolve(__dirname, "../../docs");
+}
+/**
+ * Get the AGENTS.md path
+ */
+export function getAgentsPath() {
+    return path.resolve(__dirname, "../../AGENTS.md");
+}
+/**
+ * Normalize a path for comparison (lowercase, no .md extension)
+ */
+export function normalizePath(p) {
+    return p.toLowerCase().replace(/\.md$/, "").replace(/\\/g, "/");
+}
+/**
+ * Build documentation tree from filesystem
+ */
+export function buildDocTree(dirPath, relativePath = "") {
+    const entries = [];
+    try {
+        const items = fs.readdirSync(dirPath, { withFileTypes: true });
+        for (const item of items) {
+            if (item.name.startsWith("."))
+                continue;
+            const itemPath = path.join(dirPath, item.name);
+            const relPath = relativePath ? `${relativePath}/${item.name}` : item.name;
+            if (item.isDirectory()) {
+                entries.push({
+                    name: item.name,
+                    path: relPath,
+                    type: "directory",
+                    children: buildDocTree(itemPath, relPath),
+                });
+            }
+            else if (item.name.endsWith(".md")) {
+                entries.push({
+                    name: item.name.replace(/\.md$/, ""),
+                    path: relPath.replace(/\.md$/, ""),
+                    type: "file",
+                });
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist or can't be read
+    }
+    return entries.sort((a, b) => {
+        // Directories first, then files
+        if (a.type !== b.type)
+            return a.type === "directory" ? -1 : 1;
+        return a.name.localeCompare(b.name);
+    });
+}
+/**
+ * Find a document by path (case insensitive)
+ */
+export function findDocument(tree, searchPath) {
+    const normalized = normalizePath(searchPath);
+    const parts = normalized.split("/").filter(Boolean);
+    let current = tree;
+    let currentPath = "";
+    for (let i = 0; i < parts.length; i++) {
+        const part = parts[i];
+        const isLast = i === parts.length - 1;
+        const found = current.find((e) => normalizePath(e.name) === part);
+        if (!found)
+            return null;
+        currentPath = currentPath ? `${currentPath}/${found.name}` : found.name;
+        if (isLast) {
+            return { entry: found, fullPath: currentPath };
+        }
+        if (found.type === "directory" && found.children) {
+            current = found.children;
+        }
+        else {
+            return null;
+        }
+    }
+    return null;
+}
+/**
+ * Format the documentation tree for display
+ */
+export function formatTree(entries, prefix = "") {
+    const lines = [];
+    for (let i = 0; i < entries.length; i++) {
+        const entry = entries[i];
+        const isLast = i === entries.length - 1;
+        const connector = isLast ? "└── " : "├── ";
+        const childPrefix = isLast ? "    " : "│   ";
+        if (entry.type === "directory") {
+            lines.push(`${prefix}${connector}${entry.name}/`);
+            if (entry.children && entry.children.length > 0) {
+                lines.push(formatTree(entry.children, prefix + childPrefix));
+            }
+        }
+        else {
+            lines.push(`${prefix}${connector}${entry.name}`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Format directory listing
+ */
+export function formatDirectoryListing(entry) {
+    const lines = [];
+    lines.push(`📁 ${entry.path}/\n`);
+    if (entry.children && entry.children.length > 0) {
+        lines.push("Documents:");
+        for (const child of entry.children) {
+            if (child.type === "file") {
+                lines.push(`  ${child.name}`);
+            }
+            else {
+                lines.push(`  ${child.name}/`);
+            }
+        }
+        lines.push("");
+        lines.push(`Usage: devlink docs ${entry.path}/<document>`);
+    }
+    else {
+        lines.push("(empty directory)");
+    }
+    return lines.join("\n");
+}
+/**
+ * Read and return document content
+ */
+export function readDocument(docPath, docsDir) {
+    const dir = docsDir || getDocsPath();
+    const fullPath = path.join(dir, docPath + ".md");
+    try {
+        return fs.readFileSync(fullPath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read AGENTS.md
+ */
+export function readAgents(agentsPath) {
+    const filePath = agentsPath || getAgentsPath();
+    try {
+        return fs.readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Main docs command handler
+ */
+export async function handleDocs(args) {
+    const docsDir = getDocsPath();
+    const tree = buildDocTree(docsDir);
+    // Add AGENTS.md as a special top-level entry
+    const fullTree = [
+        { name: "agents", path: "agents", type: "file" },
+        ...tree,
+    ];
+    // No argument: show full tree
+    if (!args.document) {
+        console.log(`
+📚 DevLink Documentation
+
+${formatTree(fullTree)}
+
+Usage:
+  devlink docs <document>       Show document content
+  devlink docs <directory>      List documents in directory
+
+Examples:
+  devlink docs agents           AI agent guide (comprehensive)
+  devlink docs store            List store documents
+  devlink docs store/namespaces Show namespaces documentation
+`);
+        return;
+    }
+    const searchPath = args.document;
+    const normalizedSearch = normalizePath(searchPath);
+    // Special case: agents
+    if (normalizedSearch === "agents" || normalizedSearch === "agent" || normalizedSearch === "ai") {
+        const content = readAgents();
+        if (content) {
+            console.log(content);
+            return;
+        }
+        console.error("Error: AGENTS.md not found");
+        process.exit(1);
+    }
+    // Search in tree
+    const result = findDocument(tree, searchPath);
+    if (!result) {
+        console.error(`Document not found: ${searchPath}`);
+        console.error("");
+        console.error("Available documents:");
+        console.error(formatTree(fullTree));
+        process.exit(1);
+    }
+    const { entry, fullPath } = result;
+    if (entry.type === "directory") {
+        // Show directory listing
+        console.log(formatDirectoryListing(entry));
+        return;
+    }
+    // Read and display file
+    const content = readDocument(fullPath);
+    if (content) {
+        console.log(content);
+    }
+    else {
+        console.error(`Error: Could not read ${fullPath}.md`);
+        process.exit(1);
+    }
+}
+/**
+ * Print docs help
+ */
+export function printDocsHelp() {
+    console.log(`
+devlink docs - Display embedded documentation
+
+USAGE
+  devlink docs [document]
+
+DESCRIPTION
+  Access DevLink documentation directly from the command line.
+  Without arguments, shows the documentation tree.
+  With a document path, displays that document's content.
+  With a directory path, lists documents in that directory.
+
+ARGUMENTS
+  [document]    Document or directory path (case insensitive, .md optional)
+
+EXAMPLES
+  devlink docs                    Show documentation tree
+  devlink docs agents             AI agent guide (comprehensive)
+  devlink docs store              List store documents
+  devlink docs store/namespaces   Show namespaces documentation
+  devlink docs STORE/NAMESPACES   Same (case insensitive)
+  devlink docs publishing/push    Show push command documentation
+
+SPECIAL DOCUMENTS
+  agents    Complete self-contained guide for AI agents
+`);
+}
+//# sourceMappingURL=docs.js.map

package/dist/commands/docs.js.map

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

package/dist/commands/docs.spec.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Docs Command - Unit tests
+ */
+export {};
+//# sourceMappingURL=docs.spec.d.ts.map

package/dist/commands/docs.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.spec.d.ts","sourceRoot":"","sources":["../../src/commands/docs.spec.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/commands/docs.spec.js

@@ -0,0 +1,213 @@
+/**
+ * Docs Command - Unit tests
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import fs from "fs/promises";
+import path from "path";
+import os from "os";
+import { normalizePath, buildDocTree, findDocument, formatTree, formatDirectoryListing, readDocument, readAgents, } from "./docs.js";
+const TEST_DOCS_PATH = path.join(os.tmpdir(), "devlink-docs-test-" + Date.now());
+describe("Docs Command", () => {
+    beforeEach(async () => {
+        // Create test documentation structure
+        await fs.mkdir(TEST_DOCS_PATH, { recursive: true });
+        // Create directories
+        await fs.mkdir(path.join(TEST_DOCS_PATH, "store"), { recursive: true });
+        await fs.mkdir(path.join(TEST_DOCS_PATH, "publishing"), { recursive: true });
+        await fs.mkdir(path.join(TEST_DOCS_PATH, "empty-dir"), { recursive: true });
+        // Create files
+        await fs.writeFile(path.join(TEST_DOCS_PATH, "README.md"), "# Documentation Index\n\nWelcome to docs.");
+        await fs.writeFile(path.join(TEST_DOCS_PATH, "store", "structure.md"), "# Store Structure\n\nThe store is located at ~/.devlink");
+        await fs.writeFile(path.join(TEST_DOCS_PATH, "store", "namespaces.md"), "# Namespaces\n\nNamespaces provide isolation.");
+        await fs.writeFile(path.join(TEST_DOCS_PATH, "publishing", "publish.md"), "# Publish Command\n\nPublish packages to the store.");
+        // Create AGENTS.md
+        await fs.writeFile(path.join(TEST_DOCS_PATH, "AGENTS.md"), "# Agent Guide\n\nComplete guide for AI agents.");
+    });
+    afterEach(async () => {
+        await fs.rm(TEST_DOCS_PATH, { recursive: true, force: true });
+    });
+    describe("normalizePath", () => {
+        it("should convert to lowercase", () => {
+            expect(normalizePath("STORE/NAMESPACES")).toBe("store/namespaces");
+        });
+        it("should remove .md extension", () => {
+            expect(normalizePath("store/namespaces.md")).toBe("store/namespaces");
+        });
+        it("should normalize backslashes", () => {
+            expect(normalizePath("store\\namespaces")).toBe("store/namespaces");
+        });
+        it("should handle combined cases", () => {
+            expect(normalizePath("STORE\\NAMESPACES.MD")).toBe("store/namespaces");
+        });
+    });
+    describe("buildDocTree", () => {
+        it("should build tree from directory", () => {
+            const tree = buildDocTree(TEST_DOCS_PATH);
+            // Should have directories first, then files
+            expect(tree.length).toBeGreaterThan(0);
+            // Find store directory
+            const storeDir = tree.find(e => e.name === "store");
+            expect(storeDir).toBeDefined();
+            expect(storeDir?.type).toBe("directory");
+            expect(storeDir?.children?.length).toBe(2);
+        });
+        it("should sort directories before files", () => {
+            const tree = buildDocTree(TEST_DOCS_PATH);
+            // First entries should be directories
+            const firstDir = tree.findIndex(e => e.type === "directory");
+            const firstFile = tree.findIndex(e => e.type === "file");
+            if (firstDir !== -1 && firstFile !== -1) {
+                expect(firstDir).toBeLessThan(firstFile);
+            }
+        });
+        it("should exclude hidden files", async () => {
+            await fs.writeFile(path.join(TEST_DOCS_PATH, ".hidden.md"), "hidden");
+            const tree = buildDocTree(TEST_DOCS_PATH);
+            const hidden = tree.find(e => e.name === ".hidden");
+            expect(hidden).toBeUndefined();
+        });
+        it("should only include .md files", async () => {
+            await fs.writeFile(path.join(TEST_DOCS_PATH, "test.txt"), "text file");
+            const tree = buildDocTree(TEST_DOCS_PATH);
+            const txtFile = tree.find(e => e.name === "test");
+            expect(txtFile).toBeUndefined();
+        });
+        it("should handle empty directories", () => {
+            const tree = buildDocTree(TEST_DOCS_PATH);
+            const emptyDir = tree.find(e => e.name === "empty-dir");
+            expect(emptyDir).toBeDefined();
+            expect(emptyDir?.children).toEqual([]);
+        });
+        it("should return empty array for non-existent directory", () => {
+            const tree = buildDocTree("/non/existent/path");
+            expect(tree).toEqual([]);
+        });
+    });
+    describe("findDocument", () => {
+        it("should find file by exact path", () => {
+            const tree = buildDocTree(TEST_DOCS_PATH);
+            const result = findDocument(tree, "store/structure");
+            expect(result).not.toBeNull();
+            expect(result?.entry.name).toBe("structure");
+            expect(result?.entry.type).toBe("file");
+        });
+        it("should find file case insensitively", () => {
+            const tree = buildDocTree(TEST_DOCS_PATH);
+            const result = findDocument(tree, "STORE/STRUCTURE");
+            expect(result).not.toBeNull();
+            expect(result?.entry.name).toBe("structure");
+        });
+        it("should find directory", () => {
+            const tree = buildDocTree(TEST_DOCS_PATH);
+            const result = findDocument(tree, "store");
+            expect(result).not.toBeNull();
+            expect(result?.entry.type).toBe("directory");
+        });
+        it("should return null for non-existent path", () => {
+            const tree = buildDocTree(TEST_DOCS_PATH);
+            const result = findDocument(tree, "nonexistent/path");
+            expect(result).toBeNull();
+        });
+        it("should handle path with .md extension", () => {
+            const tree = buildDocTree(TEST_DOCS_PATH);
+            const result = findDocument(tree, "store/structure.md");
+            expect(result).not.toBeNull();
+            expect(result?.entry.name).toBe("structure");
+        });
+    });
+    describe("formatTree", () => {
+        it("should format tree with connectors", () => {
+            const entries = [
+                { name: "dir", path: "dir", type: "directory", children: [] },
+                { name: "file", path: "file", type: "file" },
+            ];
+            const output = formatTree(entries);
+            expect(output).toContain("├── dir/");
+            expect(output).toContain("└── file");
+        });
+        it("should format nested directories", () => {
+            const entries = [
+                {
+                    name: "parent",
+                    path: "parent",
+                    type: "directory",
+                    children: [
+                        { name: "child", path: "parent/child", type: "file" },
+                    ],
+                },
+            ];
+            const output = formatTree(entries);
+            expect(output).toContain("└── parent/");
+            expect(output).toContain("└── child");
+        });
+        it("should handle empty array", () => {
+            const output = formatTree([]);
+            expect(output).toBe("");
+        });
+    });
+    describe("formatDirectoryListing", () => {
+        it("should format directory with children", () => {
+            const entry = {
+                name: "store",
+                path: "store",
+                type: "directory",
+                children: [
+                    { name: "structure", path: "store/structure", type: "file" },
+                    { name: "namespaces", path: "store/namespaces", type: "file" },
+                ],
+            };
+            const output = formatDirectoryListing(entry);
+            expect(output).toContain("📁 store/");
+            expect(output).toContain("Documents:");
+            expect(output).toContain("structure");
+            expect(output).toContain("namespaces");
+            expect(output).toContain("Usage: devlink docs store/<document>");
+        });
+        it("should handle empty directory", () => {
+            const entry = {
+                name: "empty",
+                path: "empty",
+                type: "directory",
+                children: [],
+            };
+            const output = formatDirectoryListing(entry);
+            expect(output).toContain("(empty directory)");
+        });
+        it("should show subdirectories with trailing slash", () => {
+            const entry = {
+                name: "parent",
+                path: "parent",
+                type: "directory",
+                children: [
+                    { name: "subdir", path: "parent/subdir", type: "directory", children: [] },
+                ],
+            };
+            const output = formatDirectoryListing(entry);
+            expect(output).toContain("subdir/");
+        });
+    });
+    describe("readDocument", () => {
+        it("should read document content", () => {
+            const content = readDocument("store/structure", TEST_DOCS_PATH);
+            expect(content).not.toBeNull();
+            expect(content).toContain("# Store Structure");
+        });
+        it("should return null for non-existent document", () => {
+            const content = readDocument("nonexistent", TEST_DOCS_PATH);
+            expect(content).toBeNull();
+        });
+    });
+    describe("readAgents", () => {
+        it("should read AGENTS.md content", () => {
+            const agentsPath = path.join(TEST_DOCS_PATH, "AGENTS.md");
+            const content = readAgents(agentsPath);
+            expect(content).not.toBeNull();
+            expect(content).toContain("# Agent Guide");
+        });
+        it("should return null for non-existent file", () => {
+            const content = readAgents("/nonexistent/AGENTS.md");
+            expect(content).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=docs.spec.js.map