phaibel 4.0.7

package/dist/entities/entity.js

@@ -0,0 +1,357 @@
+// ─────────────────────────────────────────────────────────────────────────────
+// ENTITY MODEL
+// All records are Entities — markdown files with gray-matter frontmatter.
+// ─────────────────────────────────────────────────────────────────────────────
+import { promises as fs } from 'fs';
+import path from 'path';
+import matter from 'gray-matter';
+import { debug } from '../utils/debug.js';
+import { getVaultRoot } from '../state/manager.js';
+import { getEntityType, loadEntityTypes } from './entity-type-config.js';
+import { getEntityIndex } from './entity-index.js';
+import { getEmbeddingIndex } from './embedding-index.js';
+// ─────────────────────────────────────────────────────────────────────────────
+// HELPERS
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Generate a unique entity id: "{typeName}-{6 random base-36 chars}"
+ * e.g. "task-abc123", "event-a1b2c3"
+ */
+export function generateEntityId(typeName) {
+    const chars = '0123456789abcdefghijklmnopqrstuvwxyz';
+    let suffix = '';
+    for (let i = 0; i < 6; i++)
+        suffix += chars[Math.floor(Math.random() * 36)];
+    return `${typeName}-${suffix}`;
+}
+/**
+ * Slugify a title into a URL/filename-safe snake_case string.
+ */
+export function slugify(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^_|_$/g, '');
+}
+/**
+ * Build a filename for an entity: `{slug}_{id}.md`
+ * e.g. "Fix the Plumbing" + "task-abc123" → "fix_the_plumbing_task-abc123.md"
+ */
+export function entityFilename(title, id) {
+    const slug = slugify(title);
+    return `${slug}_${id}.md`;
+}
+/**
+ * Create base entity metadata with defaults.
+ */
+export function createEntityMeta(entityType, title, opts = {}) {
+    return {
+        id: generateEntityId(entityType),
+        title,
+        entityType,
+        created: new Date().toISOString(),
+        tags: opts.tags ?? [],
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// FILE I/O
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Resolve the directory for an entity type in the active project.
+ * Reads the entity type config to get the directory name.
+ */
+export async function getEntityDir(entityType) {
+    const vaultRoot = await getVaultRoot();
+    const typeConfig = await getEntityType(entityType);
+    if (!typeConfig) {
+        throw new Error(`Unknown entity type: "${entityType}". Check ~/.phaibel/entity-types.json.`);
+    }
+    return path.join(vaultRoot, typeConfig.directory);
+}
+/**
+ * Ensure the entity directory exists, return its path.
+ */
+export async function ensureEntityDir(entityType) {
+    const dir = await getEntityDir(entityType);
+    await fs.mkdir(dir, { recursive: true });
+    return dir;
+}
+/**
+ * Parse a markdown file into an Entity (frontmatter + body content).
+ */
+export function parseEntity(filepath, rawContent) {
+    const { data, content } = matter(rawContent);
+    // Ensure filepath is available for callers
+    data._filepath = filepath;
+    return { meta: data, content: content.trim() };
+}
+/**
+ * Write an entity to a markdown file with frontmatter.
+ * Sets `updated` timestamp automatically.
+ */
+export async function writeEntity(filepath, meta, content) {
+    // Always update the timestamp on write
+    meta.updated = new Date().toISOString();
+    // Remove internal fields
+    const cleanMeta = { ...meta };
+    delete cleanMeta._filepath;
+    // Strip undefined values — js-yaml can't serialize them
+    for (const key of Object.keys(cleanMeta)) {
+        if (cleanMeta[key] === undefined) {
+            delete cleanMeta[key];
+        }
+    }
+    const fileContent = matter.stringify(content, cleanMeta);
+    await fs.writeFile(filepath, fileContent);
+}
+/**
+ * Move an entity file to the trash instead of permanently deleting it.
+ * Trash location: <vaultRoot>/.trash/<entity-dir>/<filename>
+ * If a file with the same name exists in trash, appends a timestamp.
+ */
+export async function trashEntity(filepath) {
+    const vaultRoot = await getVaultRoot();
+    const trashRoot = path.join(vaultRoot, '.trash');
+    // Derive the entity subdirectory from the filepath
+    // e.g. ~/.phaibel/projects/work/todos/foo.md → todos
+    const parentDir = path.basename(path.dirname(filepath));
+    const trashDir = path.join(trashRoot, parentDir);
+    await fs.mkdir(trashDir, { recursive: true });
+    const filename = path.basename(filepath);
+    let trashPath = path.join(trashDir, filename);
+    // Avoid collisions — append timestamp if file already exists in trash
+    try {
+        await fs.access(trashPath);
+        const stem = path.basename(filename, '.md');
+        const ts = Date.now();
+        trashPath = path.join(trashDir, `${stem}-${ts}.md`);
+    }
+    catch {
+        // No collision — use original name
+    }
+    await fs.rename(filepath, trashPath);
+    debug('entities', `Trashed ${filepath} → ${trashPath}`);
+    return trashPath;
+}
+/**
+ * Find an entity by title or filename within a directory.
+ */
+export async function findEntityByTitle(entityType, titleOrFilename) {
+    // Fast path: use in-memory index if built
+    const index = getEntityIndex();
+    if (index.isBuilt) {
+        const node = index.findByTitle(entityType, titleOrFilename);
+        if (node) {
+            try {
+                const rawContent = await fs.readFile(node.filepath, 'utf-8');
+                const { meta, content } = parseEntity(node.filepath, rawContent);
+                return { filepath: node.filepath, meta, content };
+            }
+            catch (err) {
+                debug('entities', `Index hit but file read failed: ${err}`);
+            }
+        }
+        // Semantic fallback: try embedding similarity search
+        const embeddingIndex = getEmbeddingIndex();
+        if (embeddingIndex.isLoaded) {
+            try {
+                const results = await embeddingIndex.search(titleOrFilename, 1, entityType);
+                if (results.length > 0) {
+                    const matchedNode = index.getNode(results[0].key);
+                    if (matchedNode) {
+                        debug('entities', `Semantic match for "${titleOrFilename}" → "${matchedNode.title}" (similarity: ${results[0].similarity.toFixed(3)})`);
+                        const rawContent = await fs.readFile(matchedNode.filepath, 'utf-8');
+                        const { meta, content } = parseEntity(matchedNode.filepath, rawContent);
+                        return { filepath: matchedNode.filepath, meta, content };
+                    }
+                }
+            }
+            catch (err) {
+                debug('entities', `Semantic search failed: ${err}`);
+            }
+        }
+        return null;
+    }
+    // Fallback: filesystem scan
+    let dir;
+    try {
+        dir = await getEntityDir(entityType);
+    }
+    catch (err) {
+        debug('entities', err);
+        return null;
+    }
+    try {
+        const files = await fs.readdir(dir);
+        const needle = titleOrFilename.toLowerCase();
+        let partialMatch = null;
+        for (const file of files) {
+            if (!file.endsWith('.md') || file.startsWith('.'))
+                continue;
+            const filepath = path.join(dir, file);
+            const rawContent = await fs.readFile(filepath, 'utf-8');
+            const { meta, content } = parseEntity(filepath, rawContent);
+            // Exact match on id or title — return immediately
+            if (meta.id === titleOrFilename ||
+                (meta.title && meta.title.toLowerCase() === needle)) {
+                return { filepath, meta, content };
+            }
+            // Partial match — title contains search term or vice versa
+            if (!partialMatch && meta.title) {
+                const titleLower = meta.title.toLowerCase();
+                if (titleLower.includes(needle) || needle.includes(titleLower)) {
+                    partialMatch = { filepath, meta, content };
+                }
+            }
+        }
+        // Fall back to partial match if no exact match found
+        if (partialMatch) {
+            debug('entities', `No exact match for "${titleOrFilename}", using partial match: "${partialMatch.meta.title}"`);
+            return partialMatch;
+        }
+    }
+    catch (err) {
+        debug('entities', err);
+        // Directory doesn't exist yet
+    }
+    return null;
+}
+/**
+ * Full-text search across entities by title, tags, and body content.
+ * Tokenizes query into words and scores matches: title=3pts, tag=2pts, body=1pt per token.
+ * Only returns entities where ALL tokens match at least one field.
+ */
+export async function searchEntities(query, entityType, options) {
+    // Fast path: use in-memory index if built
+    const index = getEntityIndex();
+    if (index.isBuilt) {
+        // Merge explicit tags into query as tag: tokens for the index search
+        const tagPrefix = (options?.tags ?? []).map(t => `tag:${t}`).join(' ');
+        const fullQuery = tagPrefix ? `${tagPrefix} ${query}` : query;
+        const indexResults = index.search(fullQuery, entityType);
+        // Read full content from disk for matched nodes
+        const results = [];
+        for (const { node, score } of indexResults) {
+            try {
+                const rawContent = await fs.readFile(node.filepath, 'utf-8');
+                const { meta, content } = parseEntity(node.filepath, rawContent);
+                results.push({ filepath: node.filepath, meta, content, score });
+            }
+            catch (err) {
+                debug('entities', `Index hit but file read failed for ${node.filepath}: ${err}`);
+            }
+        }
+        return results;
+    }
+    // Fallback: filesystem scan
+    const rawTokens = query.toLowerCase().split(/\s+/).filter(Boolean);
+    // Separate tag:value tokens from regular search tokens
+    const tagTokens = [];
+    const searchTokens = [];
+    for (const token of rawTokens) {
+        if (token.startsWith('tag:') || token.startsWith('tags:')) {
+            const tagValue = token.slice(token.indexOf(':') + 1);
+            if (tagValue)
+                tagTokens.push(tagValue);
+        }
+        else {
+            searchTokens.push(token);
+        }
+    }
+    // Merge inline tag: tokens with explicit tags option
+    const allFilterTags = [...tagTokens, ...(options?.tags ?? []).map(t => t.toLowerCase())];
+    if (searchTokens.length === 0 && allFilterTags.length === 0)
+        return [];
+    // Gather all entities to search
+    let allEntities;
+    if (entityType) {
+        allEntities = await listEntities(entityType);
+    }
+    else {
+        const types = await loadEntityTypes();
+        const lists = await Promise.all(types.map(t => listEntities(t.name)));
+        allEntities = lists.flat();
+    }
+    // Pre-filter by tags if any tag filters are specified
+    if (allFilterTags.length > 0) {
+        allEntities = allEntities.filter(e => {
+            const entityTags = (e.meta.tags ?? []).map(t => t.toLowerCase());
+            return allFilterTags.some(ft => entityTags.includes(ft));
+        });
+    }
+    // If no search tokens, return all tag-matched entities with score 1
+    if (searchTokens.length === 0) {
+        return allEntities.map(e => ({ filepath: e.filepath, meta: e.meta, content: e.content, score: 1 }));
+    }
+    const results = [];
+    for (const entity of allEntities) {
+        const title = (entity.meta.title ?? '').toLowerCase();
+        const tags = (entity.meta.tags ?? []).map(t => t.toLowerCase());
+        const body = entity.content.toLowerCase();
+        let score = 0;
+        let allMatched = true;
+        for (const token of searchTokens) {
+            let matched = false;
+            if (title.includes(token)) {
+                score += 3;
+                matched = true;
+            }
+            if (tags.some(tag => tag.includes(token))) {
+                score += 2;
+                matched = true;
+            }
+            if (body.includes(token)) {
+                score += 1;
+                matched = true;
+            }
+            if (!matched) {
+                allMatched = false;
+                break;
+            }
+        }
+        if (allMatched && score > 0) {
+            results.push({ filepath: entity.filepath, meta: entity.meta, content: entity.content, score });
+        }
+    }
+    results.sort((a, b) => b.score - a.score);
+    return results;
+}
+/**
+ * List all entities of a given type in the active project.
+ */
+export async function listEntities(entityType, options) {
+    let dir;
+    try {
+        dir = await getEntityDir(entityType);
+    }
+    catch (err) {
+        debug('entities', err);
+        return [];
+    }
+    const entities = [];
+    try {
+        const files = await fs.readdir(dir);
+        for (const file of files) {
+            if (!file.endsWith('.md') || file.startsWith('.'))
+                continue;
+            const filepath = path.join(dir, file);
+            const rawContent = await fs.readFile(filepath, 'utf-8');
+            const { meta, content } = parseEntity(filepath, rawContent);
+            entities.push({ filepath, meta, content });
+        }
+    }
+    catch (err) {
+        debug('entities', err);
+        // Directory doesn't exist
+    }
+    // Filter by tags if requested (case-insensitive exact match)
+    if (options?.tags && options.tags.length > 0) {
+        const filterTags = options.tags.map(t => t.toLowerCase());
+        return entities.filter(e => {
+            const entityTags = (e.meta.tags ?? []).map(t => t.toLowerCase());
+            return filterTags.some(ft => entityTags.includes(ft));
+        });
+    }
+    return entities;
+}
+//# sourceMappingURL=entity.js.map

package/dist/entities/entity.js.map

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

package/dist/entities/spawner.d.ts

@@ -0,0 +1,67 @@
+import { type SpawnerConfig, type EntityTypeConfig } from './entity-type-config.js';
+export interface ParsedEntity {
+    filepath: string;
+    meta: Record<string, unknown>;
+    content: string;
+}
+export interface SpawnResult {
+    created: number;
+    skipped: number;
+}
+export interface ChildSpec {
+    title: string;
+    fields?: Record<string, unknown>;
+    body?: string;
+}
+export interface CadenceDetails {
+    dayOfMonth?: number;
+    dayOfWeek?: string;
+    startTime?: string;
+    endTime?: string;
+    location?: string;
+}
+export interface BlackoutWindow {
+    start: string;
+    end: string;
+    reason?: string;
+}
+export declare function formatDate(d: Date): string;
+/**
+ * Compute all occurrence dates within [start, end] for daily/weekly/monthly cadences.
+ */
+export declare function computeOccurrences(cadence: string, details: CadenceDetails, start: Date, end: Date): Date[];
+/**
+ * Returns true if the date falls inside any blackout window.
+ */
+export declare function isBlackedOut(date: Date, windows: BlackoutWindow[]): boolean;
+/**
+ * Interpolate a title pattern like "{title} — {YYYY-MM-DD}" for a given date.
+ */
+export declare function interpolateTitlePattern(pattern: string, title: string, date: Date): string;
+/**
+ * Build child entity fields from a FieldMapping array.
+ * Tokens: {date} → YYYY-MM-DD string, {title} → template title
+ */
+export declare function applyFieldMapping(mappings: SpawnerConfig['fieldMapping'], template: ParsedEntity, date: Date | null): Record<string, unknown>;
+/**
+ * Generate child entities for a date-series spawner (e.g. recurrence).
+ * Creates one child per occurrence date within [startDate, endDate].
+ * Idempotent: skips already-created children based on dedupeFields.
+ */
+export declare function spawnDateSeries(template: ParsedEntity, spawnerConfig: SpawnerConfig, targetTypeConfig: EntityTypeConfig, startDate: Date, endDate: Date): Promise<SpawnResult>;
+/**
+ * Spawn a fixed set of child entities from a template entity.
+ * The template entity must have a field (childrenField) containing an array of ChildSpec.
+ * Idempotent: skips children whose title already exists in the target directory.
+ */
+export declare function spawnTemplate(template: ParsedEntity, spawnerConfig: SpawnerConfig, targetTypeConfig: EntityTypeConfig): Promise<SpawnResult>;
+/**
+ * Spawn children from a template entity.
+ * Resolves the target entity type from the spawner config, then delegates to
+ * the appropriate spawn mode.
+ */
+export declare function spawn(template: ParsedEntity, spawnerConfig: SpawnerConfig, opts?: {
+    startDate?: Date;
+    endDate?: Date;
+}): Promise<SpawnResult>;
+//# sourceMappingURL=spawner.d.ts.map

package/dist/entities/spawner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawner.d.ts","sourceRoot":"","sources":["../../src/entities/spawner.ts"],"names":[],"mappings":"AAYA,OAAO,EAAiB,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AASnG,MAAM,WAAW,YAAY;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD,MAAM,WAAW,cAAc;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAK1C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,IAAI,EACX,GAAG,EAAE,IAAI,GACV,IAAI,EAAE,CAwCR;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,OAAO,CAG3E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAI1F;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,QAAQ,EAAE,aAAa,CAAC,cAAc,CAAC,EACvC,QAAQ,EAAE,YAAY,EACtB,IAAI,EAAE,IAAI,GAAG,IAAI,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyBzB;AAMD;;;;GAIG;AACH,wBAAsB,eAAe,CACjC,QAAQ,EAAE,YAAY,EACtB,aAAa,EAAE,aAAa,EAC5B,gBAAgB,EAAE,gBAAgB,EAClC,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,GACd,OAAO,CAAC,WAAW,CAAC,CAwFtB;AAMD;;;;GAIG;AACH,wBAAsB,aAAa,CAC/B,QAAQ,EAAE,YAAY,EACtB,aAAa,EAAE,aAAa,EAC5B,gBAAgB,EAAE,gBAAgB,GACnC,OAAO,CAAC,WAAW,CAAC,CAgEtB;AAMD;;;;GAIG;AACH,wBAAsB,KAAK,CACvB,QAAQ,EAAE,YAAY,EACtB,aAAa,EAAE,aAAa,EAC5B,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,IAAI,CAAA;CAAO,GAChD,OAAO,CAAC,WAAW,CAAC,CAgCtB"}