crewly 1.8.8 → 1.8.9

package/dist/cli/backend/src/services/knowledge/fts5-search-strategy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fts5-search-strategy.js","sourceRoot":"","sources":["../../../../../../backend/src/services/knowledge/fts5-search-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,aAAa,EAAwB,MAAM,2BAA2B,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,kBAAkB;IACZ,YAAY,CAAsB;IAClC,MAAM,CAAkB;IAEzC;;;;OAIG;IACH,YAAY,YAAiC;QAC3C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC,oBAAoB,CAAC,CAAC;IACxF,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,SAAqC;QAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QAElE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAChE,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,uDAAuD;QACvD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAEzD,MAAM,MAAM,GAAqB,EAAE,CAAC;QAEpC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,4EAA4E;YAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAEvC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAE9C,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;YAChD,CAAC;iBAAM,CAAC;gBACN,8EAA8E;gBAC9E,MAAM,UAAU,GAA6B;oBAC3C,EAAE,EAAE,SAAS,CAAC,EAAE;oBAChB,KAAK,EAAE,SAAS,CAAC,KAAK;oBACtB,QAAQ,EAAE,SAAS,CAAC,QAAQ;oBAC5B,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;oBACxD,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;oBACxC,KAAK,EAAE,QAAQ;oBACf,SAAS,EAAE,QAAQ;oBACnB,SAAS,EAAE,QAAQ;oBACnB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACnC,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC,CAAC;gBACF,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/C,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC;CACF"}

package/dist/cli/backend/src/services/knowledge/learnings-index.service.d.ts

@@ -1,159 +0,0 @@
-/**
- * Learnings Index Service
- *
- * Surfaces project-scoped record-learning entries (`.crewly/knowledge/learnings.md`)
- * as virtual `KnowledgeDocumentSummary` entries so they appear in the `/knowledge`
- * UI and are returned by recall searches.
- *
- * Background (memory.f1, 2026-04-28): the `record-learning` skill writes to
- * `learnings.md` (an append-only log owned by `ProjectMemoryService`), but the
- * `/knowledge` UI reads `KnowledgeService.listDocuments()` which only sees
- * `.crewly/docs/`. As a result, learnings persisted to disk were not visible
- * in the UI and were not returned by recall. This service bridges that gap by
- * parsing the learnings log on demand and exposing each entry under a stable
- * synthetic ID (`learning:<sha1-prefix>`) that the rest of the knowledge stack
- * can carry through `listDocuments` / `getDocument` / search.
- *
- * @module services/knowledge/learnings-index.service
- */
-import type { KnowledgeDocument, KnowledgeDocumentSummary, KnowledgeScope } from '../../types/knowledge.types.js';
-/** Prefix that marks a synthetic learning document ID. */
-export declare const LEARNING_ID_PREFIX = "learning:";
-/** Category label used for learnings surfaced in the knowledge UI. */
-export declare const LEARNINGS_CATEGORY = "Learnings";
-/**
- * A learning entry parsed out of `learnings.md`.
- *
- * @internal
- */
-export interface ParsedLearning {
-    /** Stable synthetic ID — `learning:` prefix + sha1 hash of (timestamp + author + content). */
-    id: string;
-    /** Title — Karpathy-lite `[[Entity]]` opener if present, else first sentence (capped). */
-    title: string;
-    /** Tags — `learning` always, plus any `[tag-name]` tokens found in the body. */
-    tags: string[];
-    /** Full body of the entry (date / agent header lines stripped). */
-    content: string;
-    /** ISO timestamp parsed from `## YYYY-MM-DD` and `### [role/agent] HH:MM:SS` headers. */
-    createdAt: string;
-    /** Same as `createdAt` — learnings are append-only, no separate update timestamp. */
-    updatedAt: string;
-    /** Agent author string from the `[role/agentId]` header (or `unknown`). */
-    author: string;
-}
-/**
- * Parse `learnings.md` content into discrete learning entries.
- *
- * The expected format produced by `ProjectMemoryService.recordLearning` is:
- *
- * ```
- * ## YYYY-MM-DD
- *
- * ### [role/agentId] HH:MM:SS
- * <content>
- *
- * ---
- * ```
- *
- * Older entries may lack the `### [role/agentId]` header — those are still
- * parsed, with `author = 'unknown'` and time defaulting to `00:00:00`. Entries
- * containing only the file-level header (`# Project Learnings`) are skipped.
- *
- * Exported for testing only — callers should use {@link LearningsIndexService}.
- *
- * @param raw - Full file content (YAML frontmatter is stripped if present)
- * @returns Parsed entries in file order
- */
-export declare function parseLearnings(raw: string): ParsedLearning[];
-/**
- * Service that surfaces `learnings.md` entries as virtual knowledge documents.
- *
- * Singleton, file-system-backed, no caching — `learnings.md` is small enough
- * (a single project's append-only log) that re-parsing on every list call is
- * acceptable and avoids stale-cache bugs across writes from the agent skill.
- */
-export declare class LearningsIndexService {
-    private static instance;
-    private readonly logger;
-    private constructor();
-    /**
-     * Get the singleton instance.
-     *
-     * @returns LearningsIndexService instance
-     */
-    static getInstance(): LearningsIndexService;
-    /**
-     * Reset the singleton (for testing).
-     */
-    static resetInstance(): void;
-    /**
-     * Detect whether an ID belongs to this service's synthetic namespace.
-     *
-     * @param id - Document ID to test
-     * @returns True if the ID has the learning prefix
-     */
-    static isLearningId(id: string): boolean;
-    /**
-     * Resolve the absolute path to `learnings.md` for the given scope.
-     *
-     * Learnings only exist at project scope today (the `record-learning` skill
-     * always requires a `projectPath`). Global scope returns null so callers
-     * can short-circuit cleanly.
-     *
-     * @param scope - 'global' or 'project'
-     * @param projectPath - Required when scope is 'project'
-     * @returns Absolute file path, or null if learnings cannot exist for this scope
-     */
-    private learningsPath;
-    /**
-     * Read and parse `learnings.md` for the given scope.
-     *
-     * Missing-file and read-error cases both return an empty array — the
-     * indexer must never fail callers just because no learnings exist yet.
-     *
-     * @param scope - Document scope
-     * @param projectPath - Project path (required for 'project' scope)
-     * @returns Parsed learning entries (empty if file missing or unreadable)
-     */
-    private readLearnings;
-    /**
-     * List all learnings for the given scope as `KnowledgeDocumentSummary` entries.
-     *
-     * Sorted newest-first so the UI shows recent learnings at the top of the
-     * unified knowledge list (matching the user mental model that learnings
-     * are a chronological journal).
-     *
-     * @param scope - 'global' or 'project'
-     * @param projectPath - Required when scope is 'project'
-     * @returns Array of summaries (empty if scope is 'global' or no learnings exist)
-     */
-    listLearnings(scope: KnowledgeScope, projectPath?: string): Promise<KnowledgeDocumentSummary[]>;
-    /**
-     * Fetch a single learning by its synthetic ID.
-     *
-     * @param id - Synthetic document ID (must start with `learning:`)
-     * @param scope - Document scope
-     * @param projectPath - Required when scope is 'project'
-     * @returns Full document, or null if id is not a learning id or not found
-     */
-    getLearning(id: string, scope: KnowledgeScope, projectPath?: string): Promise<KnowledgeDocument | null>;
-    /**
-     * Project a parsed entry into a `KnowledgeDocumentSummary`.
-     *
-     * @param e - Parsed learning entry
-     * @param scope - Target scope label
-     * @returns Summary suitable for the knowledge list API
-     */
-    private toSummary;
-    /**
-     * Project a parsed entry into a full `KnowledgeDocument`.
-     *
-     * @param e - Parsed learning entry
-     * @param scope - Target scope label
-     * @param projectPath - Carried into the document for project-scoped entries
-     * @returns Full document suitable for the knowledge document API
-     */
-    private toDocument;
-}
-//# sourceMappingURL=learnings-index.service.d.ts.map

package/dist/cli/backend/src/services/knowledge/learnings-index.service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"learnings-index.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/knowledge/learnings-index.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAQH,OAAO,KAAK,EACV,iBAAiB,EACjB,wBAAwB,EACxB,cAAc,EACf,MAAM,gCAAgC,CAAC;AAGxC,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAE9C,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,cAAc,CAAC;AAQ9C;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,8FAA8F;IAC9F,EAAE,EAAE,MAAM,CAAC;IACX,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,yFAAyF;IACzF,SAAS,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,EAAE,CAiG5D;AAED;;;;;;GAMG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC,OAAO;IAIP;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,qBAAqB;IAO3C;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,aAAa;IAYrB;;;;;;;;;OASG;YACW,aAAa;IAiB3B;;;;;;;;;;OAUG;IACG,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAOrG;;;;;;;OAOG;IACG,WAAW,CACf,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,cAAc,EACrB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IASpC;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IAejB;;;;;;;OAOG;IACH,OAAO,CAAC,UAAU;CAmBnB"}

package/dist/cli/backend/src/services/knowledge/learnings-index.service.js

@@ -1,304 +0,0 @@
-/**
- * Learnings Index Service
- *
- * Surfaces project-scoped record-learning entries (`.crewly/knowledge/learnings.md`)
- * as virtual `KnowledgeDocumentSummary` entries so they appear in the `/knowledge`
- * UI and are returned by recall searches.
- *
- * Background (memory.f1, 2026-04-28): the `record-learning` skill writes to
- * `learnings.md` (an append-only log owned by `ProjectMemoryService`), but the
- * `/knowledge` UI reads `KnowledgeService.listDocuments()` which only sees
- * `.crewly/docs/`. As a result, learnings persisted to disk were not visible
- * in the UI and were not returned by recall. This service bridges that gap by
- * parsing the learnings log on demand and exposing each entry under a stable
- * synthetic ID (`learning:<sha1-prefix>`) that the rest of the knowledge stack
- * can carry through `listDocuments` / `getDocument` / search.
- *
- * @module services/knowledge/learnings-index.service
- */
-import * as path from 'path';
-import * as fs from 'fs/promises';
-import { existsSync } from 'fs';
-import { createHash } from 'crypto';
-import { LoggerService } from '../core/logger.service.js';
-import { CREWLY_CONSTANTS, MEMORY_CONSTANTS } from '../../constants.js';
-import { KNOWLEDGE_CONSTANTS } from '../../types/knowledge.types.js';
-/** Prefix that marks a synthetic learning document ID. */
-export const LEARNING_ID_PREFIX = 'learning:';
-/** Category label used for learnings surfaced in the knowledge UI. */
-export const LEARNINGS_CATEGORY = 'Learnings';
-/** Maximum title length for a synthesized learning summary (kept short for list rendering). */
-const MAX_TITLE_LENGTH = 100;
-/** Length of the sha1 hash prefix used for synthetic IDs (16 hex chars = 64 bits collision space). */
-const ID_HASH_LENGTH = 16;
-/**
- * Parse `learnings.md` content into discrete learning entries.
- *
- * The expected format produced by `ProjectMemoryService.recordLearning` is:
- *
- * ```
- * ## YYYY-MM-DD
- *
- * ### [role/agentId] HH:MM:SS
- * <content>
- *
- * ---
- * ```
- *
- * Older entries may lack the `### [role/agentId]` header — those are still
- * parsed, with `author = 'unknown'` and time defaulting to `00:00:00`. Entries
- * containing only the file-level header (`# Project Learnings`) are skipped.
- *
- * Exported for testing only — callers should use {@link LearningsIndexService}.
- *
- * @param raw - Full file content (YAML frontmatter is stripped if present)
- * @returns Parsed entries in file order
- */
-export function parseLearnings(raw) {
-    // Strip YAML frontmatter (if present) so the first `---` after it doesn't
-    // get treated as a section separator.
-    let body = raw;
-    if (body.startsWith('---')) {
-        const end = body.indexOf('\n---', 3);
-        if (end !== -1) {
-            body = body.slice(end + 4);
-        }
-    }
-    // Sections are separated by a markdown horizontal rule (a line containing
-    // only `---`). The recordLearning writer always emits this between entries.
-    const sections = body
-        .split(/^---\s*$/m)
-        .map((s) => s.trim())
-        .filter((s) => s.length > 0);
-    const entries = [];
-    for (const section of sections) {
-        // Skip file-level headers (`# Project Learnings: ...`).
-        if (/^#\s+(Project Learnings|Learnings from)/i.test(section)) {
-            continue;
-        }
-        const dateMatch = section.match(/^##\s+(\d{4}-\d{2}-\d{2})/m);
-        const date = dateMatch?.[1] ?? '';
-        const agentMatch = section.match(/^###\s+\[([^\]]+)\]\s+(\d{2}:\d{2}:\d{2})/m);
-        const author = agentMatch?.[1] ?? 'unknown';
-        const time = agentMatch?.[2] ?? '00:00:00';
-        // ISO timestamp: combine date + time as UTC. If date is missing (truly
-        // malformed), fall back to epoch so the entry still surfaces but sorts
-        // last. This is intentionally permissive: better to show a learning with
-        // a wrong-looking timestamp than to drop it silently.
-        const createdAt = date ? `${date}T${time}.000Z` : new Date(0).toISOString();
-        // Strip the headers we already parsed from the content body so they don't
-        // appear duplicated in the synthesized document.
-        const content = section
-            .replace(/^##\s+\d{4}-\d{2}-\d{2}\s*$/m, '')
-            .replace(/^###\s+\[[^\]]+\]\s+\d{2}:\d{2}:\d{2}\s*$/m, '')
-            .trim();
-        if (!content) {
-            continue;
-        }
-        // Title selection priority:
-        //   1. Karpathy-lite `[[Entity]]` opener — entity name as title.
-        //   2. First sentence/line of the body, capped at MAX_TITLE_LENGTH.
-        const entityMatch = content.match(/^\[\[([^\]]+)\]\]/);
-        let title;
-        if (entityMatch) {
-            title = entityMatch[1].trim().slice(0, MAX_TITLE_LENGTH);
-        }
-        else {
-            const firstSentence = content.split(/[.\n]/)[0].trim();
-            title = firstSentence.slice(0, MAX_TITLE_LENGTH) || 'Learning';
-        }
-        // Tags: 'learning' plus any `[tag-name]` markers in the body. Matches the
-        // existing convention used by record-learning callers (e.g. `[best-practice]`,
-        // `[gotcha]`, `[architecture-decision]`).
-        const tags = ['learning'];
-        const tagPattern = /\[([a-z][a-z0-9-]{0,49})\]/g;
-        let tagMatch;
-        while ((tagMatch = tagPattern.exec(content)) !== null) {
-            const tag = tagMatch[1];
-            if (!tags.includes(tag) && tags.length < KNOWLEDGE_CONSTANTS.MAX_TAGS) {
-                tags.push(tag);
-            }
-        }
-        // Stable synthetic ID. We hash (timestamp + author + content prefix) so
-        // that re-parsing the same file produces the same IDs, but two entries
-        // written at the same second by the same author with different content
-        // get distinct IDs. SHA-1 + 16 hex chars is sufficient (64 bits) for the
-        // append-only log scale.
-        const idHash = createHash('sha1')
-            .update(`${createdAt}|${author}|${content.slice(0, 200)}`)
-            .digest('hex')
-            .slice(0, ID_HASH_LENGTH);
-        entries.push({
-            id: `${LEARNING_ID_PREFIX}${idHash}`,
-            title,
-            tags,
-            content,
-            createdAt,
-            updatedAt: createdAt,
-            author,
-        });
-    }
-    return entries;
-}
-/**
- * Service that surfaces `learnings.md` entries as virtual knowledge documents.
- *
- * Singleton, file-system-backed, no caching — `learnings.md` is small enough
- * (a single project's append-only log) that re-parsing on every list call is
- * acceptable and avoids stale-cache bugs across writes from the agent skill.
- */
-export class LearningsIndexService {
-    static instance = null;
-    logger;
-    constructor() {
-        this.logger = LoggerService.getInstance().createComponentLogger('LearningsIndexService');
-    }
-    /**
-     * Get the singleton instance.
-     *
-     * @returns LearningsIndexService instance
-     */
-    static getInstance() {
-        if (!LearningsIndexService.instance) {
-            LearningsIndexService.instance = new LearningsIndexService();
-        }
-        return LearningsIndexService.instance;
-    }
-    /**
-     * Reset the singleton (for testing).
-     */
-    static resetInstance() {
-        LearningsIndexService.instance = null;
-    }
-    /**
-     * Detect whether an ID belongs to this service's synthetic namespace.
-     *
-     * @param id - Document ID to test
-     * @returns True if the ID has the learning prefix
-     */
-    static isLearningId(id) {
-        return typeof id === 'string' && id.startsWith(LEARNING_ID_PREFIX);
-    }
-    /**
-     * Resolve the absolute path to `learnings.md` for the given scope.
-     *
-     * Learnings only exist at project scope today (the `record-learning` skill
-     * always requires a `projectPath`). Global scope returns null so callers
-     * can short-circuit cleanly.
-     *
-     * @param scope - 'global' or 'project'
-     * @param projectPath - Required when scope is 'project'
-     * @returns Absolute file path, or null if learnings cannot exist for this scope
-     */
-    learningsPath(scope, projectPath) {
-        if (scope !== 'project' || !projectPath) {
-            return null;
-        }
-        return path.join(projectPath, CREWLY_CONSTANTS.PATHS.CREWLY_HOME, MEMORY_CONSTANTS.PATHS.KNOWLEDGE_DIR, MEMORY_CONSTANTS.PROJECT_FILES.LEARNINGS);
-    }
-    /**
-     * Read and parse `learnings.md` for the given scope.
-     *
-     * Missing-file and read-error cases both return an empty array — the
-     * indexer must never fail callers just because no learnings exist yet.
-     *
-     * @param scope - Document scope
-     * @param projectPath - Project path (required for 'project' scope)
-     * @returns Parsed learning entries (empty if file missing or unreadable)
-     */
-    async readLearnings(scope, projectPath) {
-        const filePath = this.learningsPath(scope, projectPath);
-        if (!filePath || !existsSync(filePath)) {
-            return [];
-        }
-        try {
-            const raw = await fs.readFile(filePath, 'utf-8');
-            return parseLearnings(raw);
-        }
-        catch (error) {
-            this.logger.warn('Failed to read learnings.md', {
-                path: filePath,
-                error: error instanceof Error ? error.message : String(error),
-            });
-            return [];
-        }
-    }
-    /**
-     * List all learnings for the given scope as `KnowledgeDocumentSummary` entries.
-     *
-     * Sorted newest-first so the UI shows recent learnings at the top of the
-     * unified knowledge list (matching the user mental model that learnings
-     * are a chronological journal).
-     *
-     * @param scope - 'global' or 'project'
-     * @param projectPath - Required when scope is 'project'
-     * @returns Array of summaries (empty if scope is 'global' or no learnings exist)
-     */
-    async listLearnings(scope, projectPath) {
-        const parsed = await this.readLearnings(scope, projectPath);
-        return parsed
-            .map((e) => this.toSummary(e, scope))
-            .sort((a, b) => b.createdAt.localeCompare(a.createdAt));
-    }
-    /**
-     * Fetch a single learning by its synthetic ID.
-     *
-     * @param id - Synthetic document ID (must start with `learning:`)
-     * @param scope - Document scope
-     * @param projectPath - Required when scope is 'project'
-     * @returns Full document, or null if id is not a learning id or not found
-     */
-    async getLearning(id, scope, projectPath) {
-        if (!LearningsIndexService.isLearningId(id)) {
-            return null;
-        }
-        const parsed = await this.readLearnings(scope, projectPath);
-        const found = parsed.find((e) => e.id === id);
-        return found ? this.toDocument(found, scope, projectPath) : null;
-    }
-    /**
-     * Project a parsed entry into a `KnowledgeDocumentSummary`.
-     *
-     * @param e - Parsed learning entry
-     * @param scope - Target scope label
-     * @returns Summary suitable for the knowledge list API
-     */
-    toSummary(e, scope) {
-        return {
-            id: e.id,
-            title: e.title,
-            category: LEARNINGS_CATEGORY,
-            tags: e.tags,
-            preview: e.content.slice(0, KNOWLEDGE_CONSTANTS.PREVIEW_LENGTH),
-            scope,
-            createdBy: e.author,
-            updatedBy: e.author,
-            createdAt: e.createdAt,
-            updatedAt: e.updatedAt,
-        };
-    }
-    /**
-     * Project a parsed entry into a full `KnowledgeDocument`.
-     *
-     * @param e - Parsed learning entry
-     * @param scope - Target scope label
-     * @param projectPath - Carried into the document for project-scoped entries
-     * @returns Full document suitable for the knowledge document API
-     */
-    toDocument(e, scope, projectPath) {
-        return {
-            id: e.id,
-            title: e.title,
-            category: LEARNINGS_CATEGORY,
-            tags: e.tags,
-            content: e.content,
-            scope,
-            projectPath: scope === 'project' ? projectPath : undefined,
-            createdBy: e.author,
-            updatedBy: e.author,
-            createdAt: e.createdAt,
-            updatedAt: e.updatedAt,
-        };
-    }
-}
-//# sourceMappingURL=learnings-index.service.js.map

package/dist/cli/backend/src/services/knowledge/learnings-index.service.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"learnings-index.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/knowledge/learnings-index.service.ts"],"names":[],"mappings":"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"}

package/dist/cli/backend/src/services/knowledge/wiki-compiler.service.d.ts

@@ -1,115 +0,0 @@
-/**
- * Wiki Compiler Service
- *
- * Reads Markdown files with YAML frontmatter from the `.crewly/knowledge/`
- * directory and indexes them into the FTS5 full-text search database.
- * Provides reindexing, single-file indexing, and search capabilities.
- *
- * @module services/knowledge/wiki-compiler.service
- */
-import { Fts5IndexService, type FtsSearchResult } from './fts5-index.service.js';
-/**
- * Parsed frontmatter result containing extracted metadata and the body text.
- */
-interface ParsedFrontmatter {
-    /** Key-value pairs extracted from YAML frontmatter */
-    frontmatter: Record<string, string>;
-    /** The markdown body after the frontmatter block */
-    body: string;
-}
-/**
- * Parse YAML frontmatter from a Markdown file content string.
- * Handles simple key: value pairs and bracket-delimited arrays.
- * Does not require an external YAML parsing dependency.
- *
- * @param content - Raw file content including frontmatter
- * @returns Parsed frontmatter object and body text
- */
-export declare function parseFrontmatter(content: string): ParsedFrontmatter;
-/**
- * WikiCompilerService scans `.md` files in a knowledge directory, parses
- * their YAML frontmatter, and indexes the content into an FTS5 database
- * for fast full-text search.
- *
- * @example
- * ```typescript
- * const compiler = new WikiCompilerService('/Users/me/.crewly/knowledge');
- * const { indexed, errors } = await compiler.reindex();
- * const results = compiler.search('deployment guide');
- * ```
- */
-export declare class WikiCompilerService {
-    private readonly fts5;
-    private readonly knowledgePath;
-    private readonly logger;
-    /**
-     * Create a WikiCompilerService.
-     *
-     * @param knowledgePath - Directory containing `.md` knowledge files
-     */
-    constructor(knowledgePath: string);
-    /**
-     * Get the path to the knowledge directory.
-     *
-     * @returns The absolute path to the knowledge directory
-     */
-    getKnowledgePath(): string;
-    /**
-     * Recursively find all `.md` files under the knowledge directory.
-     *
-     * @returns Array of absolute file paths
-     */
-    getMarkdownFiles(): Promise<string[]>;
-    /**
-     * Scan all `.md` files in the knowledge directory (recursively), parse
-     * their frontmatter, and rebuild the FTS5 index from scratch.
-     *
-     * @returns An object with the count of indexed documents and any errors encountered
-     */
-    reindex(): Promise<{
-        indexed: number;
-        errors: string[];
-    }>;
-    /**
-     * Index a single markdown file into the FTS5 database.
-     *
-     * @param filePath - Absolute path to the markdown file
-     */
-    indexFile(filePath: string): Promise<void>;
-    /**
-     * Search the knowledge base using FTS5 full-text search.
-     *
-     * @param query - The search query string
-     * @param options - Optional search parameters (category filter, result limit)
-     * @returns Array of matching documents sorted by BM25 relevance
-     */
-    search(query: string, options?: {
-        category?: string;
-        limit?: number;
-    }): FtsSearchResult[];
-    /**
-     * Get direct access to the underlying FTS5 index service.
-     *
-     * @returns The Fts5IndexService instance
-     */
-    getFts5(): Fts5IndexService;
-    /**
-     * Close the underlying FTS5 database connection.
-     */
-    close(): void;
-    /**
-     * Recursively find all `.md` files under the knowledge directory.
-     *
-     * @returns Array of absolute file paths
-     */
-    private globMarkdownFiles;
-    /**
-     * Read and parse a single markdown file into an FTS5 document shape.
-     *
-     * @param filePath - Absolute path to the markdown file
-     * @returns Parsed document ready for FTS5 indexing
-     */
-    private parseFile;
-}
-export {};
-//# sourceMappingURL=wiki-compiler.service.d.ts.map

package/dist/cli/backend/src/services/knowledge/wiki-compiler.service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wiki-compiler.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/knowledge/wiki-compiler.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAMjF;;GAEG;AACH,UAAU,iBAAiB;IACzB,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,CA4BnE;AAkBD;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC;;;;OAIG;gBACS,aAAa,EAAE,MAAM;IAMjC;;;;OAIG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;;;OAIG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI3C;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IA4B/D;;;;OAIG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhD;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe,EAAE;IAIzF;;;;OAIG;IACH,OAAO,IAAI,gBAAgB;IAI3B;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;;;OAIG;YACW,iBAAiB;IAyB/B;;;;;OAKG;YACW,SAAS;CAcxB"}