crewly 1.8.4 → 1.8.5

package/dist/backend/backend/src/services/wiki/wiki-queue.service.js

@@ -0,0 +1,261 @@
+/**
+ * WikiQueueService — file-backed queue of "wiki-worthy" content
+ * that agents enqueue from inside their conversations.
+ *
+ * Design (Steve, 2026-05-22 redesign — replacing the keyword heuristic):
+ *
+ *   1. The orchestrator-system-prompt rule teaches agents to call the
+ *      `wiki-queue-add` skill when a turn produces content with lasting
+ *      value (decision, person fact, customer info, pattern, learning).
+ *      Agents — not regex — decide.
+ *
+ *   2. Items sit in the queue with `status: pending` until an agent
+ *      claims one via `wiki-process-queue` and chooses (a) where in the
+ *      vault to put it OR (b) skip it because it's not actually worth
+ *      saving. The agent's LLM is the classifier; we never pre-pick a
+ *      taxonomy beyond the frozen folders.
+ *
+ *   3. Bookkeeping cron / threshold reads the same queue + vault stats
+ *      so it can decide when to ask an agent for a consolidation pass.
+ *
+ * Storage: `~/.crewly/wiki-queue/<id>.json`. Single flat directory;
+ * cross-vault filtering happens at list time via the `vaultPath` field
+ * inside each record.
+ *
+ * @module services/wiki/wiki-queue.service
+ */
+import * as path from 'path';
+import * as os from 'os';
+import * as fs from 'fs/promises';
+import { existsSync } from 'fs';
+import { randomUUID } from 'crypto';
+import { LoggerService } from '../core/logger.service.js';
+const MAX_CONTENT_BYTES = 64 * 1024;
+const MAX_REASON_BYTES = 2 * 1024;
+/**
+ * File-backed queue. Stateless other than the on-disk JSONs and an
+ * in-memory cache of the root directory. Singleton because all writes
+ * go to the same on-disk pool.
+ */
+export class WikiQueueService {
+    static instance = null;
+    logger;
+    rootDir;
+    initPromise = null;
+    constructor(rootDir) {
+        this.logger = LoggerService.getInstance().createComponentLogger('WikiQueue');
+        this.rootDir = rootDir ?? path.join(os.homedir(), '.crewly', 'wiki-queue');
+    }
+    static getInstance() {
+        if (!this.instance)
+            this.instance = new WikiQueueService();
+        return this.instance;
+    }
+    /** Test-only reset. */
+    static _resetForTesting() {
+        this.instance = null;
+    }
+    /** Expose for tests. */
+    getRootDir() {
+        return this.rootDir;
+    }
+    // ---------------------------------------------------------------------------
+    // CRUD
+    // ---------------------------------------------------------------------------
+    /** Enqueue a new candidate. Returns the persisted item. */
+    async add(input) {
+        this.validateAddInput(input);
+        await this.ensureRoot();
+        const item = {
+            id: randomUUID(),
+            vaultPath: input.vaultPath,
+            queuedAt: new Date().toISOString(),
+            queuedBy: input.queuedBy,
+            sourceType: input.sourceType,
+            sourceRef: input.sourceRef,
+            content: input.content,
+            reason: input.reason,
+            status: 'pending',
+        };
+        await this.writeItem(item);
+        this.logger.info('WikiQueue add', {
+            id: item.id,
+            vaultPath: item.vaultPath,
+            sourceType: item.sourceType,
+            queuedBy: item.queuedBy,
+            bytes: Buffer.byteLength(item.content, 'utf8'),
+        });
+        return item;
+    }
+    /** List items, newest-first, optionally filtered. */
+    async list(filter = {}) {
+        await this.ensureRoot();
+        const limit = filter.limit ?? 50;
+        const entries = await fs.readdir(this.rootDir, { withFileTypes: true });
+        const items = [];
+        for (const entry of entries) {
+            if (!entry.isFile() || !entry.name.endsWith('.json'))
+                continue;
+            const item = await this.readItemFile(path.join(this.rootDir, entry.name));
+            if (!item)
+                continue;
+            if (filter.vaultPath && item.vaultPath !== filter.vaultPath)
+                continue;
+            if (filter.status && item.status !== filter.status)
+                continue;
+            if (filter.queuedBy && item.queuedBy !== filter.queuedBy)
+                continue;
+            items.push(item);
+        }
+        items.sort((a, b) => (a.queuedAt < b.queuedAt ? 1 : -1));
+        return items.slice(0, limit);
+    }
+    /** Fetch one by id. Returns null when missing. */
+    async get(id) {
+        await this.ensureRoot();
+        const file = path.join(this.rootDir, `${id}.json`);
+        return this.readItemFile(file);
+    }
+    /**
+     * Claim an item — only allowed when `status: pending`. Stamps the
+     * claimant + timestamp atomically.
+     */
+    async claim(id, claimedBy) {
+        const item = await this.requireItem(id);
+        if (item.status !== 'pending') {
+            throw new Error(`WikiQueue.claim(${id}): item is ${item.status}; only pending items can be claimed`);
+        }
+        const updated = {
+            ...item,
+            status: 'claimed',
+            claimedBy,
+            claimedAt: new Date().toISOString(),
+        };
+        await this.writeItem(updated);
+        this.logger.info('WikiQueue claim', { id, claimedBy });
+        return updated;
+    }
+    /**
+     * Mark processed. Requires the item to be `claimed` AND requires a
+     * `result` with at least one of `pagesWritten` / `targetPath` / `summary`.
+     */
+    async markProcessed(id, result) {
+        const item = await this.requireItem(id);
+        if (item.status !== 'claimed') {
+            throw new Error(`WikiQueue.markProcessed(${id}): item is ${item.status}; must be claimed first`);
+        }
+        const updated = {
+            ...item,
+            status: 'processed',
+            processedAt: new Date().toISOString(),
+            result,
+        };
+        await this.writeItem(updated);
+        this.logger.info('WikiQueue processed', {
+            id,
+            pages: result.pagesWritten?.length ?? 0,
+            target: result.targetPath,
+        });
+        return updated;
+    }
+    /** Mark skipped — agent decided this isn't wiki-worthy after all. */
+    async markSkipped(id, skipReason) {
+        if (!skipReason || skipReason.trim().length === 0) {
+            throw new Error('WikiQueue.markSkipped requires a non-empty skipReason');
+        }
+        const item = await this.requireItem(id);
+        if (item.status !== 'claimed') {
+            throw new Error(`WikiQueue.markSkipped(${id}): item is ${item.status}; must be claimed first`);
+        }
+        const updated = {
+            ...item,
+            status: 'skipped',
+            processedAt: new Date().toISOString(),
+            result: { ingested: false, skipReason },
+        };
+        await this.writeItem(updated);
+        this.logger.info('WikiQueue skipped', { id, reason: skipReason });
+        return updated;
+    }
+    /** Status counts, optionally scoped to a vault. */
+    async getStats(vaultPath) {
+        const items = await this.list({ vaultPath, limit: Number.MAX_SAFE_INTEGER });
+        const counts = {
+            pending: 0,
+            claimed: 0,
+            processed: 0,
+            skipped: 0,
+            total: items.length,
+        };
+        for (const it of items) {
+            counts[it.status]++;
+        }
+        return counts;
+    }
+    // ---------------------------------------------------------------------------
+    // Internals
+    // ---------------------------------------------------------------------------
+    validateAddInput(input) {
+        if (!input.vaultPath || !path.isAbsolute(input.vaultPath)) {
+            throw new Error('WikiQueue.add: vaultPath must be absolute');
+        }
+        if (!input.queuedBy)
+            throw new Error('WikiQueue.add: queuedBy is required');
+        if (!input.sourceType)
+            throw new Error('WikiQueue.add: sourceType is required');
+        if (!input.sourceRef)
+            throw new Error('WikiQueue.add: sourceRef is required');
+        const content = input.content ?? '';
+        if (content.trim().length === 0) {
+            throw new Error('WikiQueue.add: content is empty');
+        }
+        if (Buffer.byteLength(content, 'utf8') > MAX_CONTENT_BYTES) {
+            throw new Error(`WikiQueue.add: content exceeds ${MAX_CONTENT_BYTES} bytes`);
+        }
+        const reason = input.reason ?? '';
+        if (reason.trim().length === 0) {
+            throw new Error('WikiQueue.add: reason is required — agents MUST justify why this is wiki-worthy');
+        }
+        if (Buffer.byteLength(reason, 'utf8') > MAX_REASON_BYTES) {
+            throw new Error(`WikiQueue.add: reason exceeds ${MAX_REASON_BYTES} bytes`);
+        }
+    }
+    async ensureRoot() {
+        if (this.initPromise) {
+            await this.initPromise;
+            return;
+        }
+        this.initPromise = (async () => {
+            if (!existsSync(this.rootDir)) {
+                await fs.mkdir(this.rootDir, { recursive: true });
+            }
+        })();
+        await this.initPromise;
+    }
+    async writeItem(item) {
+        const file = path.join(this.rootDir, `${item.id}.json`);
+        const tmp = `${file}.tmp`;
+        await fs.writeFile(tmp, JSON.stringify(item, null, 2), 'utf8');
+        await fs.rename(tmp, file); // atomic on the same filesystem
+    }
+    async readItemFile(file) {
+        try {
+            const raw = await fs.readFile(file, 'utf8');
+            const parsed = JSON.parse(raw);
+            // Soft validation — discard rows that don't match the shape we own.
+            if (!parsed.id || !parsed.status || !parsed.queuedAt)
+                return null;
+            return parsed;
+        }
+        catch {
+            return null;
+        }
+    }
+    async requireItem(id) {
+        const item = await this.get(id);
+        if (!item)
+            throw new Error(`WikiQueue: item not found: ${id}`);
+        return item;
+    }
+}
+//# sourceMappingURL=wiki-queue.service.js.map

package/dist/backend/backend/src/services/wiki/wiki-queue.service.js.map

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

package/dist/backend/backend/src/services/wiki/wiki.types.d.ts

@@ -0,0 +1,84 @@
+/**
+ * LLM-Wiki shared types.
+ *
+ * Mirrors the SCHEMA.md YAML shape defined in
+ * .crewly/specs/2026-05-22-atlas-crewly-llm-wiki-v2-three-scope.md §2.
+ *
+ * @module services/wiki/wiki.types
+ */
+/**
+ * The three vault scopes per v2.1 §1.
+ *
+ * - `team`:    ~/.crewly/teams/<team-id>/wiki/         (cross-project team norms)
+ * - `project`: <project-root>/.crewly/wiki/            (project-scoped knowledge)
+ * - `global`:  ~/.crewly/global-wiki/                  (ORC cross-project synthesis)
+ */
+export type VaultScope = 'team' | 'project' | 'global';
+/**
+ * A symbolic `referenced_by:` entry in SCHEMA.md.
+ *
+ * Format: `<kind>:<name>` (e.g. `skill:get-sops`, `service:sop.service`).
+ * Resolves to an absolute filesystem path via
+ * {@link ReferencedByResolver.resolve} so SCHEMA.md stays portable across
+ * machines, users, and runtime targets.
+ */
+export type ReferencedBySymbol = `skill:${string}` | `service:${string}`;
+/**
+ * A folder entry inside a vault's `hardcoded:` block.
+ *
+ * Hardcoded folders are referenced by string literal from OSS code. They
+ * MUST NOT be moved, renamed, or restructured by `wiki-lint`.
+ */
+export interface HardcodedFolder {
+    /** Folder name relative to vault root, e.g. `sop/`, `memory/`. */
+    path: string;
+    /** Always true for entries in `hardcoded:`. */
+    frozen: true;
+    /** Human description; appears in lint reports. */
+    description: string;
+    /** Symbolic refs to code that hard-codes this path. Use `skill:` / `service:`. */
+    referenced_by: ReferencedBySymbol[];
+}
+/**
+ * The single `llm-curated:` folder entry — LLM owns sub-structure entirely.
+ */
+export interface LlmCuratedFolder {
+    /** Always `llm-curated/`. */
+    path: string;
+    /** Always false; lint MAY restructure. */
+    frozen: false;
+    /** Initial subdirs to seed; LLM may add more if `llm_can_create_subdirs`. */
+    seed_subdirs: string[];
+    llm_can_create_subdirs: boolean;
+    lint_may_restructure: boolean;
+}
+/**
+ * `write_policy:` block — who may write canonical pages vs. propose-only.
+ */
+export interface WritePolicy {
+    /** Roles allowed to write canonical pages via `wiki-ingest`. */
+    canonical: string[];
+    /** Roles whose ingest writes are PR-style; TL/ORC must accept. */
+    proposed_only: string[];
+    /** Roles allowed to modify SCHEMA.md itself. */
+    schema_writer: string[];
+}
+/**
+ * Parsed SCHEMA.md content for one vault.
+ */
+export interface VaultSchema {
+    vault_scope: VaultScope;
+    vault_id: string;
+    hardcoded: HardcodedFolder[];
+    llm_curated: LlmCuratedFolder[];
+    write_policy: WritePolicy;
+}
+/**
+ * Result of resolving a symbolic `referenced_by:` entry.
+ */
+export interface ResolvedReference {
+    symbol: ReferencedBySymbol;
+    absolutePath: string;
+    exists: boolean;
+}
+//# sourceMappingURL=wiki.types.d.ts.map

package/dist/backend/backend/src/services/wiki/wiki.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki.types.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,MAAM,EAAE,GAAG,WAAW,MAAM,EAAE,CAAC;AAEzE;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,MAAM,EAAE,IAAI,CAAC;IACb,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,aAAa,EAAE,kBAAkB,EAAE,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,MAAM,EAAE,KAAK,CAAC;IACd,6EAA6E;IAC7E,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,sBAAsB,EAAE,OAAO,CAAC;IAChC,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gEAAgE;IAChE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kEAAkE;IAClE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gDAAgD;IAChD,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,UAAU,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,YAAY,EAAE,WAAW,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,kBAAkB,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB"}

package/dist/backend/backend/src/services/wiki/wiki.types.js

@@ -0,0 +1,10 @@
+/**
+ * LLM-Wiki shared types.
+ *
+ * Mirrors the SCHEMA.md YAML shape defined in
+ * .crewly/specs/2026-05-22-atlas-crewly-llm-wiki-v2-three-scope.md §2.
+ *
+ * @module services/wiki/wiki.types
+ */
+export {};
+//# sourceMappingURL=wiki.types.js.map

package/dist/backend/backend/src/services/wiki/wiki.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki.types.js","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki.types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}