devguard 0.1.0 → 0.2.0

package/dist/tools/search-entries.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSearchEntries = registerSearchEntries;
+const zod_1 = require("zod");
+const fs_1 = require("fs");
+const path_1 = require("path");
+function registerSearchEntries(server) {
+    server.tool("search_entries", "Search diary entries by keyword or date range. Returns matching sections from the diary so you can find past decisions, issues, or context without reading every entry.", {
+        project_path: zod_1.z.string().describe("Absolute path to the project directory"),
+        query: zod_1.z.string().describe("Keyword or phrase to search for (case-insensitive)"),
+        from_date: zod_1.z
+            .string()
+            .optional()
+            .describe("Start date filter (YYYY-MM-DD). Only entries on or after this date."),
+        to_date: zod_1.z
+            .string()
+            .optional()
+            .describe("End date filter (YYYY-MM-DD). Only entries on or before this date."),
+    }, async ({ project_path, query, from_date, to_date, }) => {
+        const dir = (0, path_1.join)(project_path, ".devguard", "entries");
+        if (!(0, fs_1.existsSync)(dir)) {
+            return {
+                content: [{ type: "text", text: "No diary entries found." }],
+            };
+        }
+        let files = (0, fs_1.readdirSync)(dir)
+            .filter((f) => f.endsWith(".md"))
+            .sort()
+            .reverse();
+        // Date filtering
+        if (from_date) {
+            files = files.filter((f) => f.replace(".md", "") >= from_date);
+        }
+        if (to_date) {
+            files = files.filter((f) => f.replace(".md", "") <= to_date);
+        }
+        const queryLower = query.toLowerCase();
+        const matches = [];
+        for (const file of files) {
+            const content = (0, fs_1.readFileSync)((0, path_1.join)(dir, file), "utf-8");
+            if (!content.toLowerCase().includes(queryLower))
+                continue;
+            const date = file.replace(".md", "");
+            // Split into sessions and find matching ones
+            const sessions = content.split(/---\s*\n\s*<!--\s*session:/);
+            const matchingSections = [];
+            for (const session of sessions) {
+                if (session.toLowerCase().includes(queryLower)) {
+                    // Extract a concise snippet around the match
+                    const lines = session.split("\n");
+                    const matchingLines = lines.filter((l) => l.toLowerCase().includes(queryLower));
+                    matchingSections.push(matchingLines.slice(0, 5).join("\n"));
+                }
+            }
+            if (matchingSections.length > 0) {
+                matches.push(`### ${date}\n${matchingSections.join("\n...\n")}`);
+            }
+        }
+        if (matches.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No entries matching "${query}"${from_date ? ` from ${from_date}` : ""}${to_date ? ` to ${to_date}` : ""}.`,
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `**Search results for "${query}" (${matches.length} entries):**\n\n${matches.join("\n\n---\n\n")}`,
+                },
+            ],
+        };
+    });
+}

package/dist/tools/setup.js

@@ -4,13 +4,13 @@ exports.registerSetup = registerSetup;
 const zod_1 = require("zod");
 const fs_1 = require("fs");
 const path_1 = require("path");
-const INSTRUCTION = `After completing a task, switching branches, or making a significant commit, call the devguard write_entry tool to log what was done and what's next.`;
+const INSTRUCTION = `After completing a task, switching branches, or making a significant commit, call the devdiary write_entry tool to log what was done and what's next.`;
 const CONFIG_FILES = ["CLAUDE.md", ".cursorrules"];
 function hasInstruction(content) {
-    return content.includes("devguard write_entry");
+    return content.includes("devdiary write_entry");
 }
 function registerSetup(server) {
-    server.tool("setup", "Add devguard's auto-logging instruction to your project's CLAUDE.md or .cursorrules. Run once per project — it appends the instruction so your AI writes diary entries automatically.", {
+    server.tool("setup", "Add devdiary's auto-logging instruction to your project's CLAUDE.md or .cursorrules. Run once per project — it appends the instruction so your AI writes diary entries automatically.", {
         project_path: zod_1.z.string().describe("Absolute path to the project directory"),
         target: zod_1.z
             .enum(["CLAUDE.md", ".cursorrules", "auto"])
@@ -42,7 +42,7 @@ function registerSetup(server) {
                     content: [
                         {
                             type: "text",
-                            text: `Already set up — ${targetFile} already contains the devguard instruction.`,
+                            text: `Already set up — ${targetFile} already contains the devdiary instruction.`,
                         },
                     ],
                 };
@@ -60,7 +60,7 @@ function registerSetup(server) {
             content: [
                 {
                     type: "text",
-                    text: `Done — added devguard instruction to ${targetFile}. Your AI will now log diary entries automatically.`,
+                    text: `Done — added devdiary instruction to ${targetFile}. Your AI will now log diary entries automatically.`,
                 },
             ],
         };

package/dist/tools/write-entry.js

@@ -59,10 +59,14 @@ function registerWriteEntry(server) {
             ? git.getBranch(project_path)
             : "unknown";
         const now = new Date().toISOString();
+        const commit = git.isGitRepo(project_path)
+            ? git.getHeadCommitHash(project_path)
+            : "none";
         const sections = [
             `---`,
             `date: ${now}`,
             `branch: ${branch}`,
+            `commit: ${commit}`,
             `summary: "${summary}"`,
             `---`,
             "",
@@ -81,7 +85,10 @@ function registerWriteEntry(server) {
             sections.push("", "## Next Steps", next_steps);
         }
         const content = sections.join("\n") + "\n";
-        const filePath = storage.writeEntry(project_path, content);
+        const isMainBranch = branch === "main" || branch === "master";
+        const filePath = isMainBranch
+            ? storage.writeEntry(project_path, content)
+            : storage.writeBranchEntry(project_path, branch, content);
         return {
             content: [
                 {

package/dist/utils/auto-setup.js

@@ -3,8 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.autoSetup = autoSetup;
 const fs_1 = require("fs");
 const path_1 = require("path");
-const GITIGNORE_ENTRY = ".devguard/";
-const INSTRUCTION = `After completing a task, switching branches, or making a significant commit, call the devguard write_entry tool to log what was done and what's next.`;
+const GITIGNORE_ENTRY = ".devdiary/";
+const INSTRUCTION = `After completing a task, switching branches, or making a significant commit, call the devdiary write_entry tool to log what was done and what's next.`;
 function autoSetup(projectPath) {
     addToGitignore(projectPath);
     addInstruction(projectPath);
@@ -20,7 +20,7 @@ function addToGitignore(projectPath) {
     else {
         (0, fs_1.writeFileSync)(gitignorePath, `${GITIGNORE_ENTRY}\n`, "utf-8");
     }
-    console.error(`devguard: added ${GITIGNORE_ENTRY} to .gitignore`);
+    console.error(`devdiary: added ${GITIGNORE_ENTRY} to .gitignore`);
 }
 function addInstruction(projectPath) {
     const claudeMd = (0, path_1.join)(projectPath, "CLAUDE.md");
@@ -43,12 +43,12 @@ function addInstruction(projectPath) {
     // Already has it?
     if ((0, fs_1.existsSync)(targetPath)) {
         const content = (0, fs_1.readFileSync)(targetPath, "utf-8");
-        if (content.includes("devguard write_entry"))
+        if (content.includes("devdiary write_entry"))
             return;
         (0, fs_1.appendFileSync)(targetPath, `\n\n# Dev Diary\n\n${INSTRUCTION}\n`, "utf-8");
     }
     else {
         (0, fs_1.writeFileSync)(targetPath, `# Dev Diary\n\n${INSTRUCTION}\n`, "utf-8");
     }
-    console.error(`devguard: added auto-logging instruction to ${targetName}`);
+    console.error(`devdiary: added auto-logging instruction to ${targetName}`);
 }

package/dist/utils/branch-map-html.d.ts

@@ -0,0 +1,19 @@
+import { CommitNode } from "./git.js";
+import { DiaryEntry } from "./storage.js";
+export interface BranchData {
+    name: string;
+    isCurrent: boolean;
+    isMain: boolean;
+    summary: string;
+    ahead: number;
+    behind: number;
+    commits: CommitNode[];
+    filesChanged: number;
+    diaryEntries: DiaryEntry[];
+}
+export interface GitEvent {
+    type: "fork" | "merge" | "new";
+    label: string;
+    branch: string;
+}
+export declare function generateAndOpenBranchMap(projectPath: string, branches: BranchData[], events: GitEvent[]): string;