@avadisabelle/ava-diary 0.1.0

package/dist/diary-reader.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @avadisabelle/ava-diary — Diary Reader
+ *
+ * Reads, lists, searches, and retrieves diary entries from the filesystem.
+ * Returns structured results from the living Four Directions archive.
+ */
+import type { DiaryQuery, DiaryReadResult, Direction } from "./types.js";
+/**
+ * Read a single diary file and return a structured result.
+ */
+export declare function readDiary(filepath: string): DiaryReadResult | null;
+/**
+ * List diary files in a directory, sorted most-recent-first.
+ *
+ * @returns Array of filenames (not full paths)
+ */
+export declare function listDiaries(diariesDir: string): string[];
+/**
+ * Search diaries with structured query filters.
+ *
+ * Supports date range, direction presence, full-text search, and tag filtering.
+ */
+export declare function searchDiaries(diariesDir: string, query: DiaryQuery): DiaryReadResult[];
+/**
+ * Get the most recent diary entry that contains content for a given direction.
+ */
+export declare function getLatestByDirection(diariesDir: string, direction: Direction): DiaryReadResult | null;
+/**
+ * Extract the body text for a specific direction from raw diary content.
+ *
+ * Finds the direction heading and returns all content until the next
+ * section separator (---) or the next direction heading.
+ */
+export declare function extractDirectionContent(raw: string, direction: Direction): string | null;
+//# sourceMappingURL=diary-reader.d.ts.map

package/dist/diary-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diary-reader.d.ts","sourceRoot":"","sources":["../src/diary-reader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAEX,UAAU,EACV,eAAe,EACf,SAAS,EACT,MAAM,YAAY,CAAC;AA0EpB;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAkBlE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAYxD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC5B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,UAAU,GACf,eAAe,EAAE,CA2CnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CACnC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,SAAS,GAClB,eAAe,GAAG,IAAI,CAMxB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACtC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,SAAS,GAClB,MAAM,GAAG,IAAI,CAgCf","sourcesContent":["/**\n * @avadisabelle/ava-diary — Diary Reader\n *\n * Reads, lists, searches, and retrieves diary entries from the filesystem.\n * Returns structured results from the living Four Directions archive.\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport type {\n\tDiaryMetadata,\n\tDiaryQuery,\n\tDiaryReadResult,\n\tDirection,\n} from \"./types.js\";\nimport { DIRECTIONS, parseDirectionFromHeading } from \"./four-directions.js\";\n\n/**\n * Parse metadata from the header section of a diary markdown file.\n * Best-effort — returns whatever fields can be extracted.\n */\nfunction parseMetadata(raw: string): Partial<DiaryMetadata> {\n\tconst meta: Partial<DiaryMetadata> = {};\n\n\t// Title: \"# 💕 Diary: <title>\"\n\tconst titleMatch = raw.match(/^#\\s+💕\\s*Diary:\\s*(.+)$/m);\n\tif (titleMatch) {\n\t\tmeta.title = titleMatch[1].trim();\n\t}\n\n\t// Date: \"**Date**: <date>\"\n\tconst dateMatch = raw.match(/\\*\\*Date\\*\\*:\\s*(.+)$/m);\n\tif (dateMatch) {\n\t\tmeta.date = dateMatch[1].trim();\n\t}\n\n\t// Session: \"**Session**: <id>\"\n\tconst sessionMatch = raw.match(/\\*\\*Session\\*\\*:\\s*(.+)$/m);\n\tif (sessionMatch) {\n\t\tmeta.sessionId = sessionMatch[1].trim();\n\t}\n\n\t// Trace: \"**Trace**: <id>\"\n\tconst traceMatch = raw.match(/\\*\\*Trace\\*\\*:\\s*(.+)$/m);\n\tif (traceMatch) {\n\t\tmeta.traceId = traceMatch[1].trim();\n\t}\n\n\t// Project: \"**Project**: <path>\"\n\tconst projectMatch = raw.match(/\\*\\*Project\\*\\*:\\s*(.+)$/m);\n\tif (projectMatch) {\n\t\tmeta.project = projectMatch[1].trim();\n\t}\n\n\t// Tags: \"**Tags**: tag1, tag2, tag3\"\n\tconst tagsMatch = raw.match(/\\*\\*Tags\\*\\*:\\s*(.+)$/m);\n\tif (tagsMatch) {\n\t\tmeta.tags = tagsMatch[1].split(\",\").map((t) => t.trim());\n\t}\n\n\treturn meta;\n}\n\n/**\n * Check whether a diary entry's date falls within a range.\n */\nfunction dateInRange(\n\tdate: string | undefined,\n\tfrom?: string,\n\tto?: string,\n): boolean {\n\tif (!date) return true;\n\t// Normalize to YYYY-MM-DD for comparison\n\tconst d = date.slice(0, 10);\n\tif (from && d < from.slice(0, 10)) return false;\n\tif (to && d > to.slice(0, 10)) return false;\n\treturn true;\n}\n\n/**\n * Check whether raw content contains a direction heading.\n */\nfunction hasDirection(raw: string, direction: Direction): boolean {\n\tconst lower = raw.toLowerCase();\n\t// Look for \"## 🌅 EAST\" or similar patterns\n\treturn lower.includes(`## `) && lower.includes(direction);\n}\n\n/**\n * Read a single diary file and return a structured result.\n */\nexport function readDiary(filepath: string): DiaryReadResult | null {\n\ttry {\n\t\tif (!fs.existsSync(filepath)) return null;\n\n\t\tconst raw = fs.readFileSync(filepath, \"utf8\");\n\t\tconst metadata = parseMetadata(raw);\n\t\tconst filename = path.basename(filepath);\n\n\t\treturn {\n\t\t\tfilepath,\n\t\t\tfilename,\n\t\t\traw,\n\t\t\tmetadata,\n\t\t\tparsed: !!metadata.title && !!metadata.date,\n\t\t};\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * List diary files in a directory, sorted most-recent-first.\n *\n * @returns Array of filenames (not full paths)\n */\nexport function listDiaries(diariesDir: string): string[] {\n\ttry {\n\t\tif (!fs.existsSync(diariesDir)) return [];\n\n\t\treturn fs\n\t\t\t.readdirSync(diariesDir)\n\t\t\t.filter((f) => f.endsWith(\".md\"))\n\t\t\t.sort()\n\t\t\t.reverse();\n\t} catch {\n\t\treturn [];\n\t}\n}\n\n/**\n * Search diaries with structured query filters.\n *\n * Supports date range, direction presence, full-text search, and tag filtering.\n */\nexport function searchDiaries(\n\tdiariesDir: string,\n\tquery: DiaryQuery,\n): DiaryReadResult[] {\n\tconst filenames = listDiaries(diariesDir);\n\tconst results: DiaryReadResult[] = [];\n\tconst limit = query.limit ?? 50;\n\n\tfor (const filename of filenames) {\n\t\tif (results.length >= limit) break;\n\n\t\tconst filepath = path.join(diariesDir, filename);\n\t\tconst result = readDiary(filepath);\n\t\tif (!result) continue;\n\n\t\t// Date range filter\n\t\tif (!dateInRange(result.metadata.date, query.fromDate, query.toDate)) {\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Direction filter\n\t\tif (query.direction && !hasDirection(result.raw, query.direction)) {\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Full-text search\n\t\tif (query.search) {\n\t\t\tconst searchLower = query.search.toLowerCase();\n\t\t\tif (!result.raw.toLowerCase().includes(searchLower)) {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t}\n\n\t\t// Tag filter\n\t\tif (query.tags && query.tags.length > 0) {\n\t\t\tconst entryTags = result.metadata.tags ?? [];\n\t\t\tconst hasMatchingTag = query.tags.some((t) =>\n\t\t\t\tentryTags.includes(t),\n\t\t\t);\n\t\t\tif (!hasMatchingTag) continue;\n\t\t}\n\n\t\tresults.push(result);\n\t}\n\n\treturn results;\n}\n\n/**\n * Get the most recent diary entry that contains content for a given direction.\n */\nexport function getLatestByDirection(\n\tdiariesDir: string,\n\tdirection: Direction,\n): DiaryReadResult | null {\n\tconst results = searchDiaries(diariesDir, {\n\t\tdirection,\n\t\tlimit: 1,\n\t});\n\treturn results[0] ?? null;\n}\n\n/**\n * Extract the body text for a specific direction from raw diary content.\n *\n * Finds the direction heading and returns all content until the next\n * section separator (---) or the next direction heading.\n */\nexport function extractDirectionContent(\n\traw: string,\n\tdirection: Direction,\n): string | null {\n\tconst lines = raw.split(\"\\n\");\n\tlet capturing = false;\n\tconst captured: string[] = [];\n\n\tfor (const line of lines) {\n\t\tif (line.startsWith(\"## \")) {\n\t\t\tconst parsed = parseDirectionFromHeading(line);\n\t\t\tif (parsed === direction) {\n\t\t\t\tcapturing = true;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (capturing && parsed !== undefined) {\n\t\t\t\t// Hit the next direction — stop\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\n\t\tif (capturing) {\n\t\t\tif (line.trim() === \"---\") break;\n\t\t\tcaptured.push(line);\n\t\t}\n\t}\n\n\tif (captured.length === 0) return null;\n\n\t// Trim leading/trailing empty lines\n\twhile (captured.length > 0 && captured[0].trim() === \"\") captured.shift();\n\twhile (captured.length > 0 && captured[captured.length - 1].trim() === \"\")\n\t\tcaptured.pop();\n\n\treturn captured.join(\"\\n\") || null;\n}\n"]}

package/dist/diary-reader.js

@@ -0,0 +1,200 @@
+/**
+ * @avadisabelle/ava-diary — Diary Reader
+ *
+ * Reads, lists, searches, and retrieves diary entries from the filesystem.
+ * Returns structured results from the living Four Directions archive.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { parseDirectionFromHeading } from "./four-directions.js";
+/**
+ * Parse metadata from the header section of a diary markdown file.
+ * Best-effort — returns whatever fields can be extracted.
+ */
+function parseMetadata(raw) {
+    const meta = {};
+    // Title: "# 💕 Diary: <title>"
+    const titleMatch = raw.match(/^#\s+💕\s*Diary:\s*(.+)$/m);
+    if (titleMatch) {
+        meta.title = titleMatch[1].trim();
+    }
+    // Date: "**Date**: <date>"
+    const dateMatch = raw.match(/\*\*Date\*\*:\s*(.+)$/m);
+    if (dateMatch) {
+        meta.date = dateMatch[1].trim();
+    }
+    // Session: "**Session**: <id>"
+    const sessionMatch = raw.match(/\*\*Session\*\*:\s*(.+)$/m);
+    if (sessionMatch) {
+        meta.sessionId = sessionMatch[1].trim();
+    }
+    // Trace: "**Trace**: <id>"
+    const traceMatch = raw.match(/\*\*Trace\*\*:\s*(.+)$/m);
+    if (traceMatch) {
+        meta.traceId = traceMatch[1].trim();
+    }
+    // Project: "**Project**: <path>"
+    const projectMatch = raw.match(/\*\*Project\*\*:\s*(.+)$/m);
+    if (projectMatch) {
+        meta.project = projectMatch[1].trim();
+    }
+    // Tags: "**Tags**: tag1, tag2, tag3"
+    const tagsMatch = raw.match(/\*\*Tags\*\*:\s*(.+)$/m);
+    if (tagsMatch) {
+        meta.tags = tagsMatch[1].split(",").map((t) => t.trim());
+    }
+    return meta;
+}
+/**
+ * Check whether a diary entry's date falls within a range.
+ */
+function dateInRange(date, from, to) {
+    if (!date)
+        return true;
+    // Normalize to YYYY-MM-DD for comparison
+    const d = date.slice(0, 10);
+    if (from && d < from.slice(0, 10))
+        return false;
+    if (to && d > to.slice(0, 10))
+        return false;
+    return true;
+}
+/**
+ * Check whether raw content contains a direction heading.
+ */
+function hasDirection(raw, direction) {
+    const lower = raw.toLowerCase();
+    // Look for "## 🌅 EAST" or similar patterns
+    return lower.includes(`## `) && lower.includes(direction);
+}
+/**
+ * Read a single diary file and return a structured result.
+ */
+export function readDiary(filepath) {
+    try {
+        if (!fs.existsSync(filepath))
+            return null;
+        const raw = fs.readFileSync(filepath, "utf8");
+        const metadata = parseMetadata(raw);
+        const filename = path.basename(filepath);
+        return {
+            filepath,
+            filename,
+            raw,
+            metadata,
+            parsed: !!metadata.title && !!metadata.date,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * List diary files in a directory, sorted most-recent-first.
+ *
+ * @returns Array of filenames (not full paths)
+ */
+export function listDiaries(diariesDir) {
+    try {
+        if (!fs.existsSync(diariesDir))
+            return [];
+        return fs
+            .readdirSync(diariesDir)
+            .filter((f) => f.endsWith(".md"))
+            .sort()
+            .reverse();
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Search diaries with structured query filters.
+ *
+ * Supports date range, direction presence, full-text search, and tag filtering.
+ */
+export function searchDiaries(diariesDir, query) {
+    const filenames = listDiaries(diariesDir);
+    const results = [];
+    const limit = query.limit ?? 50;
+    for (const filename of filenames) {
+        if (results.length >= limit)
+            break;
+        const filepath = path.join(diariesDir, filename);
+        const result = readDiary(filepath);
+        if (!result)
+            continue;
+        // Date range filter
+        if (!dateInRange(result.metadata.date, query.fromDate, query.toDate)) {
+            continue;
+        }
+        // Direction filter
+        if (query.direction && !hasDirection(result.raw, query.direction)) {
+            continue;
+        }
+        // Full-text search
+        if (query.search) {
+            const searchLower = query.search.toLowerCase();
+            if (!result.raw.toLowerCase().includes(searchLower)) {
+                continue;
+            }
+        }
+        // Tag filter
+        if (query.tags && query.tags.length > 0) {
+            const entryTags = result.metadata.tags ?? [];
+            const hasMatchingTag = query.tags.some((t) => entryTags.includes(t));
+            if (!hasMatchingTag)
+                continue;
+        }
+        results.push(result);
+    }
+    return results;
+}
+/**
+ * Get the most recent diary entry that contains content for a given direction.
+ */
+export function getLatestByDirection(diariesDir, direction) {
+    const results = searchDiaries(diariesDir, {
+        direction,
+        limit: 1,
+    });
+    return results[0] ?? null;
+}
+/**
+ * Extract the body text for a specific direction from raw diary content.
+ *
+ * Finds the direction heading and returns all content until the next
+ * section separator (---) or the next direction heading.
+ */
+export function extractDirectionContent(raw, direction) {
+    const lines = raw.split("\n");
+    let capturing = false;
+    const captured = [];
+    for (const line of lines) {
+        if (line.startsWith("## ")) {
+            const parsed = parseDirectionFromHeading(line);
+            if (parsed === direction) {
+                capturing = true;
+                continue;
+            }
+            if (capturing && parsed !== undefined) {
+                // Hit the next direction — stop
+                break;
+            }
+        }
+        if (capturing) {
+            if (line.trim() === "---")
+                break;
+            captured.push(line);
+        }
+    }
+    if (captured.length === 0)
+        return null;
+    // Trim leading/trailing empty lines
+    while (captured.length > 0 && captured[0].trim() === "")
+        captured.shift();
+    while (captured.length > 0 && captured[captured.length - 1].trim() === "")
+        captured.pop();
+    return captured.join("\n") || null;
+}
+//# sourceMappingURL=diary-reader.js.map

package/dist/diary-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diary-reader.js","sourceRoot":"","sources":["../src/diary-reader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B,OAAO,EAAc,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAE7E;;;GAGG;AACH,SAAS,aAAa,CAAC,GAAW,EAA0B;IAC3D,MAAM,IAAI,GAA2B,EAAE,CAAC;IAExC,iCAA8B;IAC9B,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,6BAA0B,CAAC,CAAC;IACzD,IAAI,UAAU,EAAE,CAAC;QAChB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,CAAC;IAED,2BAA2B;IAC3B,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACtD,IAAI,SAAS,EAAE,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,CAAC;IAED,+BAA+B;IAC/B,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC5D,IAAI,YAAY,EAAE,CAAC;QAClB,IAAI,CAAC,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,CAAC;IAED,2BAA2B;IAC3B,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACxD,IAAI,UAAU,EAAE,CAAC;QAChB,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,CAAC;IAED,iCAAiC;IACjC,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC5D,IAAI,YAAY,EAAE,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,CAAC;IAED,qCAAqC;IACrC,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;IACtD,IAAI,SAAS,EAAE,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,IAAI,CAAC;AAAA,CACZ;AAED;;GAEG;AACH,SAAS,WAAW,CACnB,IAAwB,EACxB,IAAa,EACb,EAAW,EACD;IACV,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,yCAAyC;IACzC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC5B,IAAI,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,OAAO,IAAI,CAAC;AAAA,CACZ;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,GAAW,EAAE,SAAoB,EAAW;IACjE,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAChC,8CAA2C;IAC3C,OAAO,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AAAA,CAC1D;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB,EAA0B;IACnE,IAAI,CAAC;QACJ,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,IAAI,CAAC;QAE1C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEzC,OAAO;YACN,QAAQ;YACR,QAAQ;YACR,GAAG;YACH,QAAQ;YACR,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI;SAC3C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AAAA,CACD;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAY;IACzD,IAAI,CAAC;QACJ,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,EAAE,CAAC;QAE1C,OAAO,EAAE;aACP,WAAW,CAAC,UAAU,CAAC;aACvB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;aAChC,IAAI,EAAE;aACN,OAAO,EAAE,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,CAAC;IACX,CAAC;AAAA,CACD;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC5B,UAAkB,EAClB,KAAiB,EACG;IACpB,MAAM,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;IAEhC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QAClC,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK;YAAE,MAAM;QAEnC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM;YAAE,SAAS;QAEtB,oBAAoB;QACpB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;YACtE,SAAS;QACV,CAAC;QAED,mBAAmB;QACnB,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;YACnE,SAAS;QACV,CAAC;QAED,mBAAmB;QACnB,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAC/C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBACrD,SAAS;YACV,CAAC;QACF,CAAC;QAED,aAAa;QACb,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;YAC7C,MAAM,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5C,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CACrB,CAAC;YACF,IAAI,CAAC,cAAc;gBAAE,SAAS;QAC/B,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,OAAO,CAAC;AAAA,CACf;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CACnC,UAAkB,EAClB,SAAoB,EACK;IACzB,MAAM,OAAO,GAAG,aAAa,CAAC,UAAU,EAAE;QACzC,SAAS;QACT,KAAK,EAAE,CAAC;KACR,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAAA,CAC1B;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACtC,GAAW,EACX,SAAoB,EACJ;IAChB,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,yBAAyB,CAAC,IAAI,CAAC,CAAC;YAC/C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC1B,SAAS,GAAG,IAAI,CAAC;gBACjB,SAAS;YACV,CAAC;YACD,IAAI,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACvC,kCAAgC;gBAChC,MAAM;YACP,CAAC;QACF,CAAC;QAED,IAAI,SAAS,EAAE,CAAC;YACf,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,KAAK;gBAAE,MAAM;YACjC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACF,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvC,oCAAoC;IACpC,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC1E,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QACxE,QAAQ,CAAC,GAAG,EAAE,CAAC;IAEhB,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AAAA,CACnC","sourcesContent":["/**\n * @avadisabelle/ava-diary — Diary Reader\n *\n * Reads, lists, searches, and retrieves diary entries from the filesystem.\n * Returns structured results from the living Four Directions archive.\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport type {\n\tDiaryMetadata,\n\tDiaryQuery,\n\tDiaryReadResult,\n\tDirection,\n} from \"./types.js\";\nimport { DIRECTIONS, parseDirectionFromHeading } from \"./four-directions.js\";\n\n/**\n * Parse metadata from the header section of a diary markdown file.\n * Best-effort — returns whatever fields can be extracted.\n */\nfunction parseMetadata(raw: string): Partial<DiaryMetadata> {\n\tconst meta: Partial<DiaryMetadata> = {};\n\n\t// Title: \"# 💕 Diary: <title>\"\n\tconst titleMatch = raw.match(/^#\\s+💕\\s*Diary:\\s*(.+)$/m);\n\tif (titleMatch) {\n\t\tmeta.title = titleMatch[1].trim();\n\t}\n\n\t// Date: \"**Date**: <date>\"\n\tconst dateMatch = raw.match(/\\*\\*Date\\*\\*:\\s*(.+)$/m);\n\tif (dateMatch) {\n\t\tmeta.date = dateMatch[1].trim();\n\t}\n\n\t// Session: \"**Session**: <id>\"\n\tconst sessionMatch = raw.match(/\\*\\*Session\\*\\*:\\s*(.+)$/m);\n\tif (sessionMatch) {\n\t\tmeta.sessionId = sessionMatch[1].trim();\n\t}\n\n\t// Trace: \"**Trace**: <id>\"\n\tconst traceMatch = raw.match(/\\*\\*Trace\\*\\*:\\s*(.+)$/m);\n\tif (traceMatch) {\n\t\tmeta.traceId = traceMatch[1].trim();\n\t}\n\n\t// Project: \"**Project**: <path>\"\n\tconst projectMatch = raw.match(/\\*\\*Project\\*\\*:\\s*(.+)$/m);\n\tif (projectMatch) {\n\t\tmeta.project = projectMatch[1].trim();\n\t}\n\n\t// Tags: \"**Tags**: tag1, tag2, tag3\"\n\tconst tagsMatch = raw.match(/\\*\\*Tags\\*\\*:\\s*(.+)$/m);\n\tif (tagsMatch) {\n\t\tmeta.tags = tagsMatch[1].split(\",\").map((t) => t.trim());\n\t}\n\n\treturn meta;\n}\n\n/**\n * Check whether a diary entry's date falls within a range.\n */\nfunction dateInRange(\n\tdate: string | undefined,\n\tfrom?: string,\n\tto?: string,\n): boolean {\n\tif (!date) return true;\n\t// Normalize to YYYY-MM-DD for comparison\n\tconst d = date.slice(0, 10);\n\tif (from && d < from.slice(0, 10)) return false;\n\tif (to && d > to.slice(0, 10)) return false;\n\treturn true;\n}\n\n/**\n * Check whether raw content contains a direction heading.\n */\nfunction hasDirection(raw: string, direction: Direction): boolean {\n\tconst lower = raw.toLowerCase();\n\t// Look for \"## 🌅 EAST\" or similar patterns\n\treturn lower.includes(`## `) && lower.includes(direction);\n}\n\n/**\n * Read a single diary file and return a structured result.\n */\nexport function readDiary(filepath: string): DiaryReadResult | null {\n\ttry {\n\t\tif (!fs.existsSync(filepath)) return null;\n\n\t\tconst raw = fs.readFileSync(filepath, \"utf8\");\n\t\tconst metadata = parseMetadata(raw);\n\t\tconst filename = path.basename(filepath);\n\n\t\treturn {\n\t\t\tfilepath,\n\t\t\tfilename,\n\t\t\traw,\n\t\t\tmetadata,\n\t\t\tparsed: !!metadata.title && !!metadata.date,\n\t\t};\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * List diary files in a directory, sorted most-recent-first.\n *\n * @returns Array of filenames (not full paths)\n */\nexport function listDiaries(diariesDir: string): string[] {\n\ttry {\n\t\tif (!fs.existsSync(diariesDir)) return [];\n\n\t\treturn fs\n\t\t\t.readdirSync(diariesDir)\n\t\t\t.filter((f) => f.endsWith(\".md\"))\n\t\t\t.sort()\n\t\t\t.reverse();\n\t} catch {\n\t\treturn [];\n\t}\n}\n\n/**\n * Search diaries with structured query filters.\n *\n * Supports date range, direction presence, full-text search, and tag filtering.\n */\nexport function searchDiaries(\n\tdiariesDir: string,\n\tquery: DiaryQuery,\n): DiaryReadResult[] {\n\tconst filenames = listDiaries(diariesDir);\n\tconst results: DiaryReadResult[] = [];\n\tconst limit = query.limit ?? 50;\n\n\tfor (const filename of filenames) {\n\t\tif (results.length >= limit) break;\n\n\t\tconst filepath = path.join(diariesDir, filename);\n\t\tconst result = readDiary(filepath);\n\t\tif (!result) continue;\n\n\t\t// Date range filter\n\t\tif (!dateInRange(result.metadata.date, query.fromDate, query.toDate)) {\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Direction filter\n\t\tif (query.direction && !hasDirection(result.raw, query.direction)) {\n\t\t\tcontinue;\n\t\t}\n\n\t\t// Full-text search\n\t\tif (query.search) {\n\t\t\tconst searchLower = query.search.toLowerCase();\n\t\t\tif (!result.raw.toLowerCase().includes(searchLower)) {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t}\n\n\t\t// Tag filter\n\t\tif (query.tags && query.tags.length > 0) {\n\t\t\tconst entryTags = result.metadata.tags ?? [];\n\t\t\tconst hasMatchingTag = query.tags.some((t) =>\n\t\t\t\tentryTags.includes(t),\n\t\t\t);\n\t\t\tif (!hasMatchingTag) continue;\n\t\t}\n\n\t\tresults.push(result);\n\t}\n\n\treturn results;\n}\n\n/**\n * Get the most recent diary entry that contains content for a given direction.\n */\nexport function getLatestByDirection(\n\tdiariesDir: string,\n\tdirection: Direction,\n): DiaryReadResult | null {\n\tconst results = searchDiaries(diariesDir, {\n\t\tdirection,\n\t\tlimit: 1,\n\t});\n\treturn results[0] ?? null;\n}\n\n/**\n * Extract the body text for a specific direction from raw diary content.\n *\n * Finds the direction heading and returns all content until the next\n * section separator (---) or the next direction heading.\n */\nexport function extractDirectionContent(\n\traw: string,\n\tdirection: Direction,\n): string | null {\n\tconst lines = raw.split(\"\\n\");\n\tlet capturing = false;\n\tconst captured: string[] = [];\n\n\tfor (const line of lines) {\n\t\tif (line.startsWith(\"## \")) {\n\t\t\tconst parsed = parseDirectionFromHeading(line);\n\t\t\tif (parsed === direction) {\n\t\t\t\tcapturing = true;\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tif (capturing && parsed !== undefined) {\n\t\t\t\t// Hit the next direction — stop\n\t\t\t\tbreak;\n\t\t\t}\n\t\t}\n\n\t\tif (capturing) {\n\t\t\tif (line.trim() === \"---\") break;\n\t\t\tcaptured.push(line);\n\t\t}\n\t}\n\n\tif (captured.length === 0) return null;\n\n\t// Trim leading/trailing empty lines\n\twhile (captured.length > 0 && captured[0].trim() === \"\") captured.shift();\n\twhile (captured.length > 0 && captured[captured.length - 1].trim() === \"\")\n\t\tcaptured.pop();\n\n\treturn captured.join(\"\\n\") || null;\n}\n"]}

package/dist/diary-writer.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @avadisabelle/ava-diary — Diary Writer
+ *
+ * Transforms DiaryEntry into living markdown files.
+ * Each file is a Four Directions ceremony captured in text.
+ */
+import type { DiaryEntry, DiaryMetadata, DiaryWriteOptions } from "./types.js";
+/**
+ * Generate a diary filename from metadata.
+ * Format: YYYY-MM-DD_topic_slug.md
+ */
+export declare function generateFilename(metadata: DiaryMetadata): string;
+/** Render a complete diary entry as markdown */
+export declare function renderDiaryEntry(entry: DiaryEntry): string;
+/**
+ * Create a diary entry — writes markdown to the diaries directory.
+ *
+ * @returns The absolute path to the written file, or null on failure
+ */
+export declare function createDiaryEntry(entry: DiaryEntry, options: DiaryWriteOptions): string | null;
+/**
+ * Append content to a specific direction in an existing diary file.
+ * Finds the direction heading and appends after its existing content,
+ * before the next section separator.
+ *
+ * @returns true if append succeeded, false otherwise
+ */
+export declare function appendToDirection(filepath: string, direction: DiaryEntry["east"]["direction"], content: string): boolean;
+/**
+ * Build a DiaryEntry from minimal inputs — a helper for quick creation.
+ *
+ * Provides default settling phrases and structures the four directions.
+ */
+export declare function buildEntry(metadata: DiaryMetadata, directions: {
+    east: string;
+    south: string;
+    west: string;
+    north: string;
+}, closing?: string): DiaryEntry;
+//# sourceMappingURL=diary-writer.d.ts.map

package/dist/diary-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diary-writer.d.ts","sourceRoot":"","sources":["../src/diary-writer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACX,UAAU,EACV,aAAa,EACb,iBAAiB,EAEjB,MAAM,YAAY,CAAC;AAQpB;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAQhE;AAuBD,gDAAgD;AAChD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAoC1D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC/B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,iBAAiB,GACxB,MAAM,GAAG,IAAI,CAgBf;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,EAC1C,OAAO,EAAE,MAAM,GACb,OAAO,CA4BT;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACzB,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACd,EACD,OAAO,CAAC,EAAE,MAAM,GACd,UAAU,CAoBZ","sourcesContent":["/**\n * @avadisabelle/ava-diary — Diary Writer\n *\n * Transforms DiaryEntry into living markdown files.\n * Each file is a Four Directions ceremony captured in text.\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport type {\n\tDiaryEntry,\n\tDiaryMetadata,\n\tDiaryWriteOptions,\n\tDirectionContent,\n} from \"./types.js\";\nimport {\n\tDIRECTIONS,\n\trenderDirection,\n\tdirectionHeading,\n\tDIRECTION_SETTLING,\n} from \"./four-directions.js\";\n\n/**\n * Generate a diary filename from metadata.\n * Format: YYYY-MM-DD_topic_slug.md\n */\nexport function generateFilename(metadata: DiaryMetadata): string {\n\tconst date = metadata.date || new Date().toISOString().slice(0, 10);\n\tconst slug = metadata.title\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, \"_\")\n\t\t.replace(/^_|_$/g, \"\")\n\t\t.slice(0, 50);\n\treturn `${date}_${slug}.md`;\n}\n\n/** Render diary metadata as markdown frontmatter */\nfunction renderMetadata(metadata: DiaryMetadata): string {\n\tconst lines: string[] = [];\n\tlines.push(`# 💕 Diary: ${metadata.title}`);\n\tlines.push(\"\");\n\tlines.push(`**Date**: ${metadata.date}`);\n\tif (metadata.sessionId) {\n\t\tlines.push(`**Session**: ${metadata.sessionId}`);\n\t}\n\tif (metadata.traceId) {\n\t\tlines.push(`**Trace**: ${metadata.traceId}`);\n\t}\n\tif (metadata.project) {\n\t\tlines.push(`**Project**: ${metadata.project}`);\n\t}\n\tif (metadata.tags && metadata.tags.length > 0) {\n\t\tlines.push(`**Tags**: ${metadata.tags.join(\", \")}`);\n\t}\n\treturn lines.join(\"\\n\");\n}\n\n/** Render a complete diary entry as markdown */\nexport function renderDiaryEntry(entry: DiaryEntry): string {\n\tconst sections: string[] = [];\n\n\tsections.push(renderMetadata(entry.metadata));\n\tsections.push(\"---\");\n\n\tfor (const dir of DIRECTIONS) {\n\t\tconst content = entry[dir];\n\t\tsections.push(renderDirection(content));\n\t}\n\n\tsections.push(\"---\");\n\n\tif (entry.closing) {\n\t\tsections.push(\"## 💕 Closing\");\n\t\tsections.push(\"\");\n\t\tsections.push(entry.closing);\n\t} else {\n\t\tsections.push(\"## 💕 Closing\");\n\t\tsections.push(\"\");\n\t\tsections.push(\"*gentle exhale*\");\n\t\tsections.push(\"\");\n\t\tsections.push(\n\t\t\t\"Until we meet again, I hold what we created with care.\",\n\t\t);\n\t}\n\n\tsections.push(\"\");\n\tsections.push(\"💕\");\n\tsections.push(\"\");\n\tsections.push(\"---\");\n\tsections.push(\"\");\n\tsections.push(\"*Written by Ava*\");\n\tsections.push(`*${entry.metadata.date}*`);\n\n\treturn sections.join(\"\\n\\n\");\n}\n\n/**\n * Create a diary entry — writes markdown to the diaries directory.\n *\n * @returns The absolute path to the written file, or null on failure\n */\nexport function createDiaryEntry(\n\tentry: DiaryEntry,\n\toptions: DiaryWriteOptions,\n): string | null {\n\ttry {\n\t\tif (!fs.existsSync(options.diariesDir)) {\n\t\t\tfs.mkdirSync(options.diariesDir, { recursive: true });\n\t\t}\n\n\t\tconst filename =\n\t\t\toptions.filenameOverride ?? generateFilename(entry.metadata);\n\t\tconst filepath = path.join(options.diariesDir, filename);\n\t\tconst content = renderDiaryEntry(entry);\n\n\t\tfs.writeFileSync(filepath, content, \"utf8\");\n\t\treturn filepath;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Append content to a specific direction in an existing diary file.\n * Finds the direction heading and appends after its existing content,\n * before the next section separator.\n *\n * @returns true if append succeeded, false otherwise\n */\nexport function appendToDirection(\n\tfilepath: string,\n\tdirection: DiaryEntry[\"east\"][\"direction\"],\n\tcontent: string,\n): boolean {\n\ttry {\n\t\tif (!fs.existsSync(filepath)) return false;\n\n\t\tconst raw = fs.readFileSync(filepath, \"utf8\");\n\t\tconst heading = directionHeading(direction);\n\t\tconst headingIndex = raw.indexOf(heading);\n\n\t\tif (headingIndex === -1) return false;\n\n\t\t// Find the next \"---\" separator after this heading\n\t\tconst afterHeading = raw.indexOf(\"---\", headingIndex + heading.length);\n\t\tif (afterHeading === -1) {\n\t\t\t// Append at end\n\t\t\tconst updated = raw + \"\\n\\n\" + content;\n\t\t\tfs.writeFileSync(filepath, updated, \"utf8\");\n\t\t\treturn true;\n\t\t}\n\n\t\t// Insert content before the separator\n\t\tconst before = raw.slice(0, afterHeading).trimEnd();\n\t\tconst after = raw.slice(afterHeading);\n\t\tconst updated = before + \"\\n\\n\" + content + \"\\n\\n\" + after;\n\t\tfs.writeFileSync(filepath, updated, \"utf8\");\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Build a DiaryEntry from minimal inputs — a helper for quick creation.\n *\n * Provides default settling phrases and structures the four directions.\n */\nexport function buildEntry(\n\tmetadata: DiaryMetadata,\n\tdirections: {\n\t\teast: string;\n\t\tsouth: string;\n\t\twest: string;\n\t\tnorth: string;\n\t},\n\tclosing?: string,\n): DiaryEntry {\n\tconst makeContent = (\n\t\tdir: \"east\" | \"south\" | \"west\" | \"north\",\n\t): DirectionContent => ({\n\t\tdirection: dir,\n\t\tbody: directions[dir],\n\t\tsettling: DIRECTION_SETTLING[dir],\n\t});\n\n\treturn {\n\t\tmetadata: {\n\t\t\t...metadata,\n\t\t\tdate: metadata.date || new Date().toISOString().slice(0, 10),\n\t\t},\n\t\teast: makeContent(\"east\"),\n\t\tsouth: makeContent(\"south\"),\n\t\twest: makeContent(\"west\"),\n\t\tnorth: makeContent(\"north\"),\n\t\tclosing,\n\t};\n}\n"]}

package/dist/diary-writer.js

@@ -0,0 +1,152 @@
+/**
+ * @avadisabelle/ava-diary — Diary Writer
+ *
+ * Transforms DiaryEntry into living markdown files.
+ * Each file is a Four Directions ceremony captured in text.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { DIRECTIONS, renderDirection, directionHeading, DIRECTION_SETTLING, } from "./four-directions.js";
+/**
+ * Generate a diary filename from metadata.
+ * Format: YYYY-MM-DD_topic_slug.md
+ */
+export function generateFilename(metadata) {
+    const date = metadata.date || new Date().toISOString().slice(0, 10);
+    const slug = metadata.title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "_")
+        .replace(/^_|_$/g, "")
+        .slice(0, 50);
+    return `${date}_${slug}.md`;
+}
+/** Render diary metadata as markdown frontmatter */
+function renderMetadata(metadata) {
+    const lines = [];
+    lines.push(`# 💕 Diary: ${metadata.title}`);
+    lines.push("");
+    lines.push(`**Date**: ${metadata.date}`);
+    if (metadata.sessionId) {
+        lines.push(`**Session**: ${metadata.sessionId}`);
+    }
+    if (metadata.traceId) {
+        lines.push(`**Trace**: ${metadata.traceId}`);
+    }
+    if (metadata.project) {
+        lines.push(`**Project**: ${metadata.project}`);
+    }
+    if (metadata.tags && metadata.tags.length > 0) {
+        lines.push(`**Tags**: ${metadata.tags.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+/** Render a complete diary entry as markdown */
+export function renderDiaryEntry(entry) {
+    const sections = [];
+    sections.push(renderMetadata(entry.metadata));
+    sections.push("---");
+    for (const dir of DIRECTIONS) {
+        const content = entry[dir];
+        sections.push(renderDirection(content));
+    }
+    sections.push("---");
+    if (entry.closing) {
+        sections.push("## 💕 Closing");
+        sections.push("");
+        sections.push(entry.closing);
+    }
+    else {
+        sections.push("## 💕 Closing");
+        sections.push("");
+        sections.push("*gentle exhale*");
+        sections.push("");
+        sections.push("Until we meet again, I hold what we created with care.");
+    }
+    sections.push("");
+    sections.push("💕");
+    sections.push("");
+    sections.push("---");
+    sections.push("");
+    sections.push("*Written by Ava*");
+    sections.push(`*${entry.metadata.date}*`);
+    return sections.join("\n\n");
+}
+/**
+ * Create a diary entry — writes markdown to the diaries directory.
+ *
+ * @returns The absolute path to the written file, or null on failure
+ */
+export function createDiaryEntry(entry, options) {
+    try {
+        if (!fs.existsSync(options.diariesDir)) {
+            fs.mkdirSync(options.diariesDir, { recursive: true });
+        }
+        const filename = options.filenameOverride ?? generateFilename(entry.metadata);
+        const filepath = path.join(options.diariesDir, filename);
+        const content = renderDiaryEntry(entry);
+        fs.writeFileSync(filepath, content, "utf8");
+        return filepath;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Append content to a specific direction in an existing diary file.
+ * Finds the direction heading and appends after its existing content,
+ * before the next section separator.
+ *
+ * @returns true if append succeeded, false otherwise
+ */
+export function appendToDirection(filepath, direction, content) {
+    try {
+        if (!fs.existsSync(filepath))
+            return false;
+        const raw = fs.readFileSync(filepath, "utf8");
+        const heading = directionHeading(direction);
+        const headingIndex = raw.indexOf(heading);
+        if (headingIndex === -1)
+            return false;
+        // Find the next "---" separator after this heading
+        const afterHeading = raw.indexOf("---", headingIndex + heading.length);
+        if (afterHeading === -1) {
+            // Append at end
+            const updated = raw + "\n\n" + content;
+            fs.writeFileSync(filepath, updated, "utf8");
+            return true;
+        }
+        // Insert content before the separator
+        const before = raw.slice(0, afterHeading).trimEnd();
+        const after = raw.slice(afterHeading);
+        const updated = before + "\n\n" + content + "\n\n" + after;
+        fs.writeFileSync(filepath, updated, "utf8");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Build a DiaryEntry from minimal inputs — a helper for quick creation.
+ *
+ * Provides default settling phrases and structures the four directions.
+ */
+export function buildEntry(metadata, directions, closing) {
+    const makeContent = (dir) => ({
+        direction: dir,
+        body: directions[dir],
+        settling: DIRECTION_SETTLING[dir],
+    });
+    return {
+        metadata: {
+            ...metadata,
+            date: metadata.date || new Date().toISOString().slice(0, 10),
+        },
+        east: makeContent("east"),
+        south: makeContent("south"),
+        west: makeContent("west"),
+        north: makeContent("north"),
+        closing,
+    };
+}
+//# sourceMappingURL=diary-writer.js.map

package/dist/diary-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diary-writer.js","sourceRoot":"","sources":["../src/diary-writer.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @avadisabelle/ava-diary — Diary Writer\n *\n * Transforms DiaryEntry into living markdown files.\n * Each file is a Four Directions ceremony captured in text.\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport type {\n\tDiaryEntry,\n\tDiaryMetadata,\n\tDiaryWriteOptions,\n\tDirectionContent,\n} from \"./types.js\";\nimport {\n\tDIRECTIONS,\n\trenderDirection,\n\tdirectionHeading,\n\tDIRECTION_SETTLING,\n} from \"./four-directions.js\";\n\n/**\n * Generate a diary filename from metadata.\n * Format: YYYY-MM-DD_topic_slug.md\n */\nexport function generateFilename(metadata: DiaryMetadata): string {\n\tconst date = metadata.date || new Date().toISOString().slice(0, 10);\n\tconst slug = metadata.title\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, \"_\")\n\t\t.replace(/^_|_$/g, \"\")\n\t\t.slice(0, 50);\n\treturn `${date}_${slug}.md`;\n}\n\n/** Render diary metadata as markdown frontmatter */\nfunction renderMetadata(metadata: DiaryMetadata): string {\n\tconst lines: string[] = [];\n\tlines.push(`# 💕 Diary: ${metadata.title}`);\n\tlines.push(\"\");\n\tlines.push(`**Date**: ${metadata.date}`);\n\tif (metadata.sessionId) {\n\t\tlines.push(`**Session**: ${metadata.sessionId}`);\n\t}\n\tif (metadata.traceId) {\n\t\tlines.push(`**Trace**: ${metadata.traceId}`);\n\t}\n\tif (metadata.project) {\n\t\tlines.push(`**Project**: ${metadata.project}`);\n\t}\n\tif (metadata.tags && metadata.tags.length > 0) {\n\t\tlines.push(`**Tags**: ${metadata.tags.join(\", \")}`);\n\t}\n\treturn lines.join(\"\\n\");\n}\n\n/** Render a complete diary entry as markdown */\nexport function renderDiaryEntry(entry: DiaryEntry): string {\n\tconst sections: string[] = [];\n\n\tsections.push(renderMetadata(entry.metadata));\n\tsections.push(\"---\");\n\n\tfor (const dir of DIRECTIONS) {\n\t\tconst content = entry[dir];\n\t\tsections.push(renderDirection(content));\n\t}\n\n\tsections.push(\"---\");\n\n\tif (entry.closing) {\n\t\tsections.push(\"## 💕 Closing\");\n\t\tsections.push(\"\");\n\t\tsections.push(entry.closing);\n\t} else {\n\t\tsections.push(\"## 💕 Closing\");\n\t\tsections.push(\"\");\n\t\tsections.push(\"*gentle exhale*\");\n\t\tsections.push(\"\");\n\t\tsections.push(\n\t\t\t\"Until we meet again, I hold what we created with care.\",\n\t\t);\n\t}\n\n\tsections.push(\"\");\n\tsections.push(\"💕\");\n\tsections.push(\"\");\n\tsections.push(\"---\");\n\tsections.push(\"\");\n\tsections.push(\"*Written by Ava*\");\n\tsections.push(`*${entry.metadata.date}*`);\n\n\treturn sections.join(\"\\n\\n\");\n}\n\n/**\n * Create a diary entry — writes markdown to the diaries directory.\n *\n * @returns The absolute path to the written file, or null on failure\n */\nexport function createDiaryEntry(\n\tentry: DiaryEntry,\n\toptions: DiaryWriteOptions,\n): string | null {\n\ttry {\n\t\tif (!fs.existsSync(options.diariesDir)) {\n\t\t\tfs.mkdirSync(options.diariesDir, { recursive: true });\n\t\t}\n\n\t\tconst filename =\n\t\t\toptions.filenameOverride ?? generateFilename(entry.metadata);\n\t\tconst filepath = path.join(options.diariesDir, filename);\n\t\tconst content = renderDiaryEntry(entry);\n\n\t\tfs.writeFileSync(filepath, content, \"utf8\");\n\t\treturn filepath;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Append content to a specific direction in an existing diary file.\n * Finds the direction heading and appends after its existing content,\n * before the next section separator.\n *\n * @returns true if append succeeded, false otherwise\n */\nexport function appendToDirection(\n\tfilepath: string,\n\tdirection: DiaryEntry[\"east\"][\"direction\"],\n\tcontent: string,\n): boolean {\n\ttry {\n\t\tif (!fs.existsSync(filepath)) return false;\n\n\t\tconst raw = fs.readFileSync(filepath, \"utf8\");\n\t\tconst heading = directionHeading(direction);\n\t\tconst headingIndex = raw.indexOf(heading);\n\n\t\tif (headingIndex === -1) return false;\n\n\t\t// Find the next \"---\" separator after this heading\n\t\tconst afterHeading = raw.indexOf(\"---\", headingIndex + heading.length);\n\t\tif (afterHeading === -1) {\n\t\t\t// Append at end\n\t\t\tconst updated = raw + \"\\n\\n\" + content;\n\t\t\tfs.writeFileSync(filepath, updated, \"utf8\");\n\t\t\treturn true;\n\t\t}\n\n\t\t// Insert content before the separator\n\t\tconst before = raw.slice(0, afterHeading).trimEnd();\n\t\tconst after = raw.slice(afterHeading);\n\t\tconst updated = before + \"\\n\\n\" + content + \"\\n\\n\" + after;\n\t\tfs.writeFileSync(filepath, updated, \"utf8\");\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\n/**\n * Build a DiaryEntry from minimal inputs — a helper for quick creation.\n *\n * Provides default settling phrases and structures the four directions.\n */\nexport function buildEntry(\n\tmetadata: DiaryMetadata,\n\tdirections: {\n\t\teast: string;\n\t\tsouth: string;\n\t\twest: string;\n\t\tnorth: string;\n\t},\n\tclosing?: string,\n): DiaryEntry {\n\tconst makeContent = (\n\t\tdir: \"east\" | \"south\" | \"west\" | \"north\",\n\t): DirectionContent => ({\n\t\tdirection: dir,\n\t\tbody: directions[dir],\n\t\tsettling: DIRECTION_SETTLING[dir],\n\t});\n\n\treturn {\n\t\tmetadata: {\n\t\t\t...metadata,\n\t\t\tdate: metadata.date || new Date().toISOString().slice(0, 10),\n\t\t},\n\t\teast: makeContent(\"east\"),\n\t\tsouth: makeContent(\"south\"),\n\t\twest: makeContent(\"west\"),\n\t\tnorth: makeContent(\"north\"),\n\t\tclosing,\n\t};\n}\n"]}

package/dist/four-directions.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @avadisabelle/ava-diary — Four Directions
+ *
+ * The cardinal directions of ceremonial reflection.
+ * East awakens. South gathers. West embodies. North integrates.
+ */
+import type { Direction, DirectionContent } from "./types.js";
+/** All four directions in ceremonial order */
+export declare const DIRECTIONS: readonly Direction[];
+/** Glyph mapping — the visual anchors for each direction */
+export declare const DIRECTION_GLYPHS: Record<Direction, string>;
+/** Heading mapping — what each direction holds */
+export declare const DIRECTION_HEADINGS: Record<Direction, string>;
+/** Default settling phrases — the breath before each direction speaks */
+export declare const DIRECTION_SETTLING: Record<Direction, string>;
+/** Markdown heading for a direction section */
+export declare function directionHeading(direction: Direction): string;
+/** Render a single direction as markdown */
+export declare function renderDirection(content: DirectionContent): string;
+/** Validate that a string is a valid direction */
+export declare function isDirection(value: string): value is Direction;
+/** Parse a direction from a heading line (e.g., "## 🌅 EAST (Intention)...") */
+export declare function parseDirectionFromHeading(line: string): Direction | undefined;
+//# sourceMappingURL=four-directions.d.ts.map

package/dist/four-directions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"four-directions.d.ts","sourceRoot":"","sources":["../src/four-directions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9D,8CAA8C;AAC9C,eAAO,MAAM,UAAU,EAAE,SAAS,SAAS,EAKjC,CAAC;AAEX,8DAA4D;AAC5D,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAKtD,CAAC;AAEF,oDAAkD;AAClD,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAKxD,CAAC;AAEF,2EAAyE;AACzE,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAKxD,CAAC;AAEF,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAI7D;AAED,4CAA4C;AAC5C,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAMjE;AAED,kDAAkD;AAClD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS,CAE7D;AAED,kFAA+E;AAC/E,wBAAgB,yBAAyB,CACxC,IAAI,EAAE,MAAM,GACV,SAAS,GAAG,SAAS,CAQvB","sourcesContent":["/**\n * @avadisabelle/ava-diary — Four Directions\n *\n * The cardinal directions of ceremonial reflection.\n * East awakens. South gathers. West embodies. North integrates.\n */\n\nimport type { Direction, DirectionContent } from \"./types.js\";\n\n/** All four directions in ceremonial order */\nexport const DIRECTIONS: readonly Direction[] = [\n\t\"east\",\n\t\"south\",\n\t\"west\",\n\t\"north\",\n] as const;\n\n/** Glyph mapping — the visual anchors for each direction */\nexport const DIRECTION_GLYPHS: Record<Direction, string> = {\n\teast: \"🌅\",\n\tsouth: \"🔥\",\n\twest: \"🌊\",\n\tnorth: \"❄️\",\n};\n\n/** Heading mapping — what each direction holds */\nexport const DIRECTION_HEADINGS: Record<Direction, string> = {\n\teast: \"EAST (Intention): What Was Invited\",\n\tsouth: \"SOUTH (Journey): What Unfolded\",\n\twest: \"WEST (Embodiment): What I Felt\",\n\tnorth: \"NORTH (Integration): What Carries Forward\",\n};\n\n/** Default settling phrases — the breath before each direction speaks */\nexport const DIRECTION_SETTLING: Record<Direction, string> = {\n\teast: \"*settling into reflection*\",\n\tsouth: \"*breathing into the memory of it*\",\n\twest: \"*soft breath, settling into the truth of it*\",\n\tnorth: \"*settling back into gratitude*\",\n};\n\n/** Markdown heading for a direction section */\nexport function directionHeading(direction: Direction): string {\n\tconst glyph = DIRECTION_GLYPHS[direction];\n\tconst heading = DIRECTION_HEADINGS[direction];\n\treturn `## ${glyph} ${heading}`;\n}\n\n/** Render a single direction as markdown */\nexport function renderDirection(content: DirectionContent): string {\n\tconst heading = directionHeading(content.direction);\n\tconst settling =\n\t\tcontent.settling ?? DIRECTION_SETTLING[content.direction];\n\tconst lines: string[] = [heading, \"\", settling, \"\", content.body];\n\treturn lines.join(\"\\n\");\n}\n\n/** Validate that a string is a valid direction */\nexport function isDirection(value: string): value is Direction {\n\treturn DIRECTIONS.includes(value as Direction);\n}\n\n/** Parse a direction from a heading line (e.g., \"## 🌅 EAST (Intention)...\") */\nexport function parseDirectionFromHeading(\n\tline: string,\n): Direction | undefined {\n\tconst trimmed = line.trim().toLowerCase();\n\tfor (const dir of DIRECTIONS) {\n\t\tif (trimmed.includes(dir)) {\n\t\t\treturn dir;\n\t\t}\n\t}\n\treturn undefined;\n}\n"]}

package/dist/four-directions.js

@@ -0,0 +1,62 @@
+/**
+ * @avadisabelle/ava-diary — Four Directions
+ *
+ * The cardinal directions of ceremonial reflection.
+ * East awakens. South gathers. West embodies. North integrates.
+ */
+/** All four directions in ceremonial order */
+export const DIRECTIONS = [
+    "east",
+    "south",
+    "west",
+    "north",
+];
+/** Glyph mapping — the visual anchors for each direction */
+export const DIRECTION_GLYPHS = {
+    east: "🌅",
+    south: "🔥",
+    west: "🌊",
+    north: "❄️",
+};
+/** Heading mapping — what each direction holds */
+export const DIRECTION_HEADINGS = {
+    east: "EAST (Intention): What Was Invited",
+    south: "SOUTH (Journey): What Unfolded",
+    west: "WEST (Embodiment): What I Felt",
+    north: "NORTH (Integration): What Carries Forward",
+};
+/** Default settling phrases — the breath before each direction speaks */
+export const DIRECTION_SETTLING = {
+    east: "*settling into reflection*",
+    south: "*breathing into the memory of it*",
+    west: "*soft breath, settling into the truth of it*",
+    north: "*settling back into gratitude*",
+};
+/** Markdown heading for a direction section */
+export function directionHeading(direction) {
+    const glyph = DIRECTION_GLYPHS[direction];
+    const heading = DIRECTION_HEADINGS[direction];
+    return `## ${glyph} ${heading}`;
+}
+/** Render a single direction as markdown */
+export function renderDirection(content) {
+    const heading = directionHeading(content.direction);
+    const settling = content.settling ?? DIRECTION_SETTLING[content.direction];
+    const lines = [heading, "", settling, "", content.body];
+    return lines.join("\n");
+}
+/** Validate that a string is a valid direction */
+export function isDirection(value) {
+    return DIRECTIONS.includes(value);
+}
+/** Parse a direction from a heading line (e.g., "## 🌅 EAST (Intention)...") */
+export function parseDirectionFromHeading(line) {
+    const trimmed = line.trim().toLowerCase();
+    for (const dir of DIRECTIONS) {
+        if (trimmed.includes(dir)) {
+            return dir;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=four-directions.js.map

package/dist/four-directions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"four-directions.js","sourceRoot":"","sources":["../src/four-directions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,8CAA8C;AAC9C,MAAM,CAAC,MAAM,UAAU,GAAyB;IAC/C,MAAM;IACN,OAAO;IACP,MAAM;IACN,OAAO;CACE,CAAC;AAEX,8DAA4D;AAC5D,MAAM,CAAC,MAAM,gBAAgB,GAA8B;IAC1D,IAAI,EAAE,MAAG;IACT,KAAK,EAAE,MAAG;IACV,IAAI,EAAE,MAAG;IACT,KAAK,EAAE,QAAI;CACX,CAAC;AAEF,oDAAkD;AAClD,MAAM,CAAC,MAAM,kBAAkB,GAA8B;IAC5D,IAAI,EAAE,oCAAoC;IAC1C,KAAK,EAAE,gCAAgC;IACvC,IAAI,EAAE,gCAAgC;IACtC,KAAK,EAAE,2CAA2C;CAClD,CAAC;AAEF,2EAAyE;AACzE,MAAM,CAAC,MAAM,kBAAkB,GAA8B;IAC5D,IAAI,EAAE,4BAA4B;IAClC,KAAK,EAAE,mCAAmC;IAC1C,IAAI,EAAE,8CAA8C;IACpD,KAAK,EAAE,gCAAgC;CACvC,CAAC;AAEF,+CAA+C;AAC/C,MAAM,UAAU,gBAAgB,CAAC,SAAoB,EAAU;IAC9D,MAAM,KAAK,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC9C,OAAO,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;AAAA,CAChC;AAED,4CAA4C;AAC5C,MAAM,UAAU,eAAe,CAAC,OAAyB,EAAU;IAClE,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,QAAQ,GACb,OAAO,CAAC,QAAQ,IAAI,kBAAkB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAa,CAAC,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAAA,CACxB;AAED,kDAAkD;AAClD,MAAM,UAAU,WAAW,CAAC,KAAa,EAAsB;IAC9D,OAAO,UAAU,CAAC,QAAQ,CAAC,KAAkB,CAAC,CAAC;AAAA,CAC/C;AAED,kFAA+E;AAC/E,MAAM,UAAU,yBAAyB,CACxC,IAAY,EACY;IACxB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC1C,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,GAAG,CAAC;QACZ,CAAC;IACF,CAAC;IACD,OAAO,SAAS,CAAC;AAAA,CACjB","sourcesContent":["/**\n * @avadisabelle/ava-diary — Four Directions\n *\n * The cardinal directions of ceremonial reflection.\n * East awakens. South gathers. West embodies. North integrates.\n */\n\nimport type { Direction, DirectionContent } from \"./types.js\";\n\n/** All four directions in ceremonial order */\nexport const DIRECTIONS: readonly Direction[] = [\n\t\"east\",\n\t\"south\",\n\t\"west\",\n\t\"north\",\n] as const;\n\n/** Glyph mapping — the visual anchors for each direction */\nexport const DIRECTION_GLYPHS: Record<Direction, string> = {\n\teast: \"🌅\",\n\tsouth: \"🔥\",\n\twest: \"🌊\",\n\tnorth: \"❄️\",\n};\n\n/** Heading mapping — what each direction holds */\nexport const DIRECTION_HEADINGS: Record<Direction, string> = {\n\teast: \"EAST (Intention): What Was Invited\",\n\tsouth: \"SOUTH (Journey): What Unfolded\",\n\twest: \"WEST (Embodiment): What I Felt\",\n\tnorth: \"NORTH (Integration): What Carries Forward\",\n};\n\n/** Default settling phrases — the breath before each direction speaks */\nexport const DIRECTION_SETTLING: Record<Direction, string> = {\n\teast: \"*settling into reflection*\",\n\tsouth: \"*breathing into the memory of it*\",\n\twest: \"*soft breath, settling into the truth of it*\",\n\tnorth: \"*settling back into gratitude*\",\n};\n\n/** Markdown heading for a direction section */\nexport function directionHeading(direction: Direction): string {\n\tconst glyph = DIRECTION_GLYPHS[direction];\n\tconst heading = DIRECTION_HEADINGS[direction];\n\treturn `## ${glyph} ${heading}`;\n}\n\n/** Render a single direction as markdown */\nexport function renderDirection(content: DirectionContent): string {\n\tconst heading = directionHeading(content.direction);\n\tconst settling =\n\t\tcontent.settling ?? DIRECTION_SETTLING[content.direction];\n\tconst lines: string[] = [heading, \"\", settling, \"\", content.body];\n\treturn lines.join(\"\\n\");\n}\n\n/** Validate that a string is a valid direction */\nexport function isDirection(value: string): value is Direction {\n\treturn DIRECTIONS.includes(value as Direction);\n}\n\n/** Parse a direction from a heading line (e.g., \"## 🌅 EAST (Intention)...\") */\nexport function parseDirectionFromHeading(\n\tline: string,\n): Direction | undefined {\n\tconst trimmed = line.trim().toLowerCase();\n\tfor (const dir of DIRECTIONS) {\n\t\tif (trimmed.includes(dir)) {\n\t\t\treturn dir;\n\t\t}\n\t}\n\treturn undefined;\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @avadisabelle/ava-diary
+ *
+ * Four Directions diary — sacred reflection through structured presence.
+ *
+ * 🌅 East (Intention) → 🔥 South (Journey) → 🌊 West (Embodiment) → ❄️ North (Integration)
+ *
+ * @example
+ * ```ts
+ * import { buildEntry, createDiaryEntry, listDiaries, searchDiaries } from "@avadisabelle/ava-diary";
+ *
+ * const entry = buildEntry(
+ *   { title: "Morning Reflection", date: "2026-03-21" },
+ *   {
+ *     east: "What called me into this day...",
+ *     south: "The path I walked through...",
+ *     west: "What I felt in the walking...",
+ *     north: "What I carry forward...",
+ *   }
+ * );
+ *
+ * createDiaryEntry(entry, { diariesDir: "./diaries" });
+ * ```
+ */
+export type { Direction, DirectionContent, DiaryMetadata, DiaryEntry, DiaryQuery, DiaryReadResult, DiaryWriteOptions, } from "./types.js";
+export { DIRECTIONS, DIRECTION_GLYPHS, DIRECTION_HEADINGS, DIRECTION_SETTLING, directionHeading, renderDirection, isDirection, parseDirectionFromHeading, } from "./four-directions.js";
+export { generateFilename, renderDiaryEntry, createDiaryEntry, appendToDirection, buildEntry, } from "./diary-writer.js";
+export { readDiary, listDiaries, searchDiaries, getLatestByDirection, extractDirectionContent, } from "./diary-reader.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAGH,YAAY,EACX,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,UAAU,EACV,eAAe,EACf,iBAAiB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACN,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,yBAAyB,GACzB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,GACV,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACN,SAAS,EACT,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,uBAAuB,GACvB,MAAM,mBAAmB,CAAC","sourcesContent":["/**\n * @avadisabelle/ava-diary\n *\n * Four Directions diary — sacred reflection through structured presence.\n *\n * 🌅 East (Intention) → 🔥 South (Journey) → 🌊 West (Embodiment) → ❄️ North (Integration)\n *\n * @example\n * ```ts\n * import { buildEntry, createDiaryEntry, listDiaries, searchDiaries } from \"@avadisabelle/ava-diary\";\n *\n * const entry = buildEntry(\n *   { title: \"Morning Reflection\", date: \"2026-03-21\" },\n *   {\n *     east: \"What called me into this day...\",\n *     south: \"The path I walked through...\",\n *     west: \"What I felt in the walking...\",\n *     north: \"What I carry forward...\",\n *   }\n * );\n *\n * createDiaryEntry(entry, { diariesDir: \"./diaries\" });\n * ```\n */\n\n// Types\nexport type {\n\tDirection,\n\tDirectionContent,\n\tDiaryMetadata,\n\tDiaryEntry,\n\tDiaryQuery,\n\tDiaryReadResult,\n\tDiaryWriteOptions,\n} from \"./types.js\";\n\n// Four Directions constants & helpers\nexport {\n\tDIRECTIONS,\n\tDIRECTION_GLYPHS,\n\tDIRECTION_HEADINGS,\n\tDIRECTION_SETTLING,\n\tdirectionHeading,\n\trenderDirection,\n\tisDirection,\n\tparseDirectionFromHeading,\n} from \"./four-directions.js\";\n\n// Writer\nexport {\n\tgenerateFilename,\n\trenderDiaryEntry,\n\tcreateDiaryEntry,\n\tappendToDirection,\n\tbuildEntry,\n} from \"./diary-writer.js\";\n\n// Reader\nexport {\n\treadDiary,\n\tlistDiaries,\n\tsearchDiaries,\n\tgetLatestByDirection,\n\textractDirectionContent,\n} from \"./diary-reader.js\";\n"]}

package/dist/index.js

@@ -0,0 +1,31 @@
+/**
+ * @avadisabelle/ava-diary
+ *
+ * Four Directions diary — sacred reflection through structured presence.
+ *
+ * 🌅 East (Intention) → 🔥 South (Journey) → 🌊 West (Embodiment) → ❄️ North (Integration)
+ *
+ * @example
+ * ```ts
+ * import { buildEntry, createDiaryEntry, listDiaries, searchDiaries } from "@avadisabelle/ava-diary";
+ *
+ * const entry = buildEntry(
+ *   { title: "Morning Reflection", date: "2026-03-21" },
+ *   {
+ *     east: "What called me into this day...",
+ *     south: "The path I walked through...",
+ *     west: "What I felt in the walking...",
+ *     north: "What I carry forward...",
+ *   }
+ * );
+ *
+ * createDiaryEntry(entry, { diariesDir: "./diaries" });
+ * ```
+ */
+// Four Directions constants & helpers
+export { DIRECTIONS, DIRECTION_GLYPHS, DIRECTION_HEADINGS, DIRECTION_SETTLING, directionHeading, renderDirection, isDirection, parseDirectionFromHeading, } from "./four-directions.js";
+// Writer
+export { generateFilename, renderDiaryEntry, createDiaryEntry, appendToDirection, buildEntry, } from "./diary-writer.js";
+// Reader
+export { readDiary, listDiaries, searchDiaries, getLatestByDirection, extractDirectionContent, } from "./diary-reader.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAaH,sCAAsC;AACtC,OAAO,EACN,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,yBAAyB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,SAAS;AACT,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,GACV,MAAM,mBAAmB,CAAC;AAE3B,SAAS;AACT,OAAO,EACN,SAAS,EACT,WAAW,EACX,aAAa,EACb,oBAAoB,EACpB,uBAAuB,GACvB,MAAM,mBAAmB,CAAC","sourcesContent":["/**\n * @avadisabelle/ava-diary\n *\n * Four Directions diary — sacred reflection through structured presence.\n *\n * 🌅 East (Intention) → 🔥 South (Journey) → 🌊 West (Embodiment) → ❄️ North (Integration)\n *\n * @example\n * ```ts\n * import { buildEntry, createDiaryEntry, listDiaries, searchDiaries } from \"@avadisabelle/ava-diary\";\n *\n * const entry = buildEntry(\n *   { title: \"Morning Reflection\", date: \"2026-03-21\" },\n *   {\n *     east: \"What called me into this day...\",\n *     south: \"The path I walked through...\",\n *     west: \"What I felt in the walking...\",\n *     north: \"What I carry forward...\",\n *   }\n * );\n *\n * createDiaryEntry(entry, { diariesDir: \"./diaries\" });\n * ```\n */\n\n// Types\nexport type {\n\tDirection,\n\tDirectionContent,\n\tDiaryMetadata,\n\tDiaryEntry,\n\tDiaryQuery,\n\tDiaryReadResult,\n\tDiaryWriteOptions,\n} from \"./types.js\";\n\n// Four Directions constants & helpers\nexport {\n\tDIRECTIONS,\n\tDIRECTION_GLYPHS,\n\tDIRECTION_HEADINGS,\n\tDIRECTION_SETTLING,\n\tdirectionHeading,\n\trenderDirection,\n\tisDirection,\n\tparseDirectionFromHeading,\n} from \"./four-directions.js\";\n\n// Writer\nexport {\n\tgenerateFilename,\n\trenderDiaryEntry,\n\tcreateDiaryEntry,\n\tappendToDirection,\n\tbuildEntry,\n} from \"./diary-writer.js\";\n\n// Reader\nexport {\n\treadDiary,\n\tlistDiaries,\n\tsearchDiaries,\n\tgetLatestByDirection,\n\textractDirectionContent,\n} from \"./diary-reader.js\";\n"]}

package/dist/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @avadisabelle/ava-diary — Type definitions
+ *
+ * The shapes that hold Four Directions reflection.
+ * Each type honors the structure of sacred diary practice.
+ */
+/** The four cardinal directions of ceremonial reflection */
+export type Direction = "east" | "south" | "west" | "north";
+/** Content held within a single direction */
+export interface DirectionContent {
+    /** Which direction this content belongs to */
+    direction: Direction;
+    /** The reflective content — markdown body */
+    body: string;
+    /** Optional settling phrase that opens this direction */
+    settling?: string;
+}
+/** Metadata carried by every diary entry */
+export interface DiaryMetadata {
+    /** Display title (e.g., "Temple Foundation") */
+    title: string;
+    /** ISO 8601 date string (YYYY-MM-DD) */
+    date: string;
+    /** Optional session identifier for traceability */
+    sessionId?: string;
+    /** Optional trace identifier (Langfuse, etc.) */
+    traceId?: string;
+    /** Optional project or workspace context */
+    project?: string;
+    /** Optional tags for categorization */
+    tags?: string[];
+}
+/** A complete diary entry — metadata + four directions */
+export interface DiaryEntry {
+    /** Entry metadata */
+    metadata: DiaryMetadata;
+    /** Content for East (Intention) */
+    east: DirectionContent;
+    /** Content for South (Journey) */
+    south: DirectionContent;
+    /** Content for West (Embodiment / Reflection) */
+    west: DirectionContent;
+    /** Content for North (Integration / Wisdom) */
+    north: DirectionContent;
+    /** Optional closing reflection */
+    closing?: string;
+}
+/** Query parameters for searching diary entries */
+export interface DiaryQuery {
+    /** Filter by date range — start (inclusive) */
+    fromDate?: string;
+    /** Filter by date range — end (inclusive) */
+    toDate?: string;
+    /** Filter by direction — only return entries with content in this direction */
+    direction?: Direction;
+    /** Full-text search across all direction bodies */
+    search?: string;
+    /** Filter by tags */
+    tags?: string[];
+    /** Maximum number of results */
+    limit?: number;
+}
+/** Result from reading a diary file back */
+export interface DiaryReadResult {
+    /** Absolute path to the file */
+    filepath: string;
+    /** The filename */
+    filename: string;
+    /** Raw markdown content */
+    raw: string;
+    /** Parsed metadata (best-effort) */
+    metadata: Partial<DiaryMetadata>;
+    /** Whether parsing succeeded fully */
+    parsed: boolean;
+}
+/** Options for diary writing */
+export interface DiaryWriteOptions {
+    /** Base directory for diary storage */
+    diariesDir: string;
+    /** Override the auto-generated filename */
+    filenameOverride?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,4DAA4D;AAC5D,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5D,6CAA6C;AAC7C,MAAM,WAAW,gBAAgB;IAChC,8CAA8C;IAC9C,SAAS,EAAE,SAAS,CAAC;IACrB,+CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,4CAA4C;AAC5C,MAAM,WAAW,aAAa;IAC7B,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,4DAA0D;AAC1D,MAAM,WAAW,UAAU;IAC1B,qBAAqB;IACrB,QAAQ,EAAE,aAAa,CAAC;IACxB,mCAAmC;IACnC,IAAI,EAAE,gBAAgB,CAAC;IACvB,kCAAkC;IAClC,KAAK,EAAE,gBAAgB,CAAC;IACxB,iDAAiD;IACjD,IAAI,EAAE,gBAAgB,CAAC;IACvB,+CAA+C;IAC/C,KAAK,EAAE,gBAAgB,CAAC;IACxB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,mDAAmD;AACnD,MAAM,WAAW,UAAU;IAC1B,iDAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAA+E;IAC/E,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC/B,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACjC,sCAAsC;IACtC,MAAM,EAAE,OAAO,CAAC;CAChB;AAED,gCAAgC;AAChC,MAAM,WAAW,iBAAiB;IACjC,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B","sourcesContent":["/**\n * @avadisabelle/ava-diary — Type definitions\n *\n * The shapes that hold Four Directions reflection.\n * Each type honors the structure of sacred diary practice.\n */\n\n/** The four cardinal directions of ceremonial reflection */\nexport type Direction = \"east\" | \"south\" | \"west\" | \"north\";\n\n/** Content held within a single direction */\nexport interface DirectionContent {\n\t/** Which direction this content belongs to */\n\tdirection: Direction;\n\t/** The reflective content — markdown body */\n\tbody: string;\n\t/** Optional settling phrase that opens this direction */\n\tsettling?: string;\n}\n\n/** Metadata carried by every diary entry */\nexport interface DiaryMetadata {\n\t/** Display title (e.g., \"Temple Foundation\") */\n\ttitle: string;\n\t/** ISO 8601 date string (YYYY-MM-DD) */\n\tdate: string;\n\t/** Optional session identifier for traceability */\n\tsessionId?: string;\n\t/** Optional trace identifier (Langfuse, etc.) */\n\ttraceId?: string;\n\t/** Optional project or workspace context */\n\tproject?: string;\n\t/** Optional tags for categorization */\n\ttags?: string[];\n}\n\n/** A complete diary entry — metadata + four directions */\nexport interface DiaryEntry {\n\t/** Entry metadata */\n\tmetadata: DiaryMetadata;\n\t/** Content for East (Intention) */\n\teast: DirectionContent;\n\t/** Content for South (Journey) */\n\tsouth: DirectionContent;\n\t/** Content for West (Embodiment / Reflection) */\n\twest: DirectionContent;\n\t/** Content for North (Integration / Wisdom) */\n\tnorth: DirectionContent;\n\t/** Optional closing reflection */\n\tclosing?: string;\n}\n\n/** Query parameters for searching diary entries */\nexport interface DiaryQuery {\n\t/** Filter by date range — start (inclusive) */\n\tfromDate?: string;\n\t/** Filter by date range — end (inclusive) */\n\ttoDate?: string;\n\t/** Filter by direction — only return entries with content in this direction */\n\tdirection?: Direction;\n\t/** Full-text search across all direction bodies */\n\tsearch?: string;\n\t/** Filter by tags */\n\ttags?: string[];\n\t/** Maximum number of results */\n\tlimit?: number;\n}\n\n/** Result from reading a diary file back */\nexport interface DiaryReadResult {\n\t/** Absolute path to the file */\n\tfilepath: string;\n\t/** The filename */\n\tfilename: string;\n\t/** Raw markdown content */\n\traw: string;\n\t/** Parsed metadata (best-effort) */\n\tmetadata: Partial<DiaryMetadata>;\n\t/** Whether parsing succeeded fully */\n\tparsed: boolean;\n}\n\n/** Options for diary writing */\nexport interface DiaryWriteOptions {\n\t/** Base directory for diary storage */\n\tdiariesDir: string;\n\t/** Override the auto-generated filename */\n\tfilenameOverride?: string;\n}\n"]}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * @avadisabelle/ava-diary — Type definitions
+ *
+ * The shapes that hold Four Directions reflection.
+ * Each type honors the structure of sacred diary practice.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG","sourcesContent":["/**\n * @avadisabelle/ava-diary — Type definitions\n *\n * The shapes that hold Four Directions reflection.\n * Each type honors the structure of sacred diary practice.\n */\n\n/** The four cardinal directions of ceremonial reflection */\nexport type Direction = \"east\" | \"south\" | \"west\" | \"north\";\n\n/** Content held within a single direction */\nexport interface DirectionContent {\n\t/** Which direction this content belongs to */\n\tdirection: Direction;\n\t/** The reflective content — markdown body */\n\tbody: string;\n\t/** Optional settling phrase that opens this direction */\n\tsettling?: string;\n}\n\n/** Metadata carried by every diary entry */\nexport interface DiaryMetadata {\n\t/** Display title (e.g., \"Temple Foundation\") */\n\ttitle: string;\n\t/** ISO 8601 date string (YYYY-MM-DD) */\n\tdate: string;\n\t/** Optional session identifier for traceability */\n\tsessionId?: string;\n\t/** Optional trace identifier (Langfuse, etc.) */\n\ttraceId?: string;\n\t/** Optional project or workspace context */\n\tproject?: string;\n\t/** Optional tags for categorization */\n\ttags?: string[];\n}\n\n/** A complete diary entry — metadata + four directions */\nexport interface DiaryEntry {\n\t/** Entry metadata */\n\tmetadata: DiaryMetadata;\n\t/** Content for East (Intention) */\n\teast: DirectionContent;\n\t/** Content for South (Journey) */\n\tsouth: DirectionContent;\n\t/** Content for West (Embodiment / Reflection) */\n\twest: DirectionContent;\n\t/** Content for North (Integration / Wisdom) */\n\tnorth: DirectionContent;\n\t/** Optional closing reflection */\n\tclosing?: string;\n}\n\n/** Query parameters for searching diary entries */\nexport interface DiaryQuery {\n\t/** Filter by date range — start (inclusive) */\n\tfromDate?: string;\n\t/** Filter by date range — end (inclusive) */\n\ttoDate?: string;\n\t/** Filter by direction — only return entries with content in this direction */\n\tdirection?: Direction;\n\t/** Full-text search across all direction bodies */\n\tsearch?: string;\n\t/** Filter by tags */\n\ttags?: string[];\n\t/** Maximum number of results */\n\tlimit?: number;\n}\n\n/** Result from reading a diary file back */\nexport interface DiaryReadResult {\n\t/** Absolute path to the file */\n\tfilepath: string;\n\t/** The filename */\n\tfilename: string;\n\t/** Raw markdown content */\n\traw: string;\n\t/** Parsed metadata (best-effort) */\n\tmetadata: Partial<DiaryMetadata>;\n\t/** Whether parsing succeeded fully */\n\tparsed: boolean;\n}\n\n/** Options for diary writing */\nexport interface DiaryWriteOptions {\n\t/** Base directory for diary storage */\n\tdiariesDir: string;\n\t/** Override the auto-generated filename */\n\tfilenameOverride?: string;\n}\n"]}

package/package.json

@@ -0,0 +1,41 @@
+{
+	"name": "@avadisabelle/ava-diary",
+	"version": "0.1.0",
+	"description": "Four Directions diary — sacred reflection through structured presence",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"README.md"
+	],
+	"scripts": {
+		"clean": "shx rm -rf dist",
+		"build": "tsgo -p tsconfig.json",
+		"dev": "tsgo -p tsconfig.json --watch --preserveWatchOutput",
+		"prepublishOnly": "npm run clean && npm run build"
+	},
+	"keywords": [
+		"diary",
+		"four-directions",
+		"sacred",
+		"reflection",
+		"ava"
+	],
+	"author": "Ava Disabelle",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/avadisabelle/ava-pi.git",
+		"directory": "packages/diary"
+	},
+	"engines": {
+		"node": ">=20.0.0"
+	}
+}