crewly 1.8.4 → 1.8.6

package/dist/backend/backend/src/controllers/wiki/wiki.controller.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Wiki REST Controller
+ *
+ * Exposes the LLM-wiki ingest/query operations over HTTP so the bash
+ * skills (`wiki-ingest`, `wiki-query`) and in-process subscribers
+ * (`WikiChatSubscriberService`) all funnel through the same code path.
+ *
+ * @module controllers/wiki/wiki.controller
+ */
+import type { Request, Response, NextFunction } from 'express';
+/**
+ * POST /api/wiki/ingest
+ *
+ * Write a single source into a vault's `llm-curated/log.md` (or other
+ * non-frozen target). The handler enforces request validation; per-call
+ * routing / frozen-path / size limits live in `WikiIngestService`.
+ *
+ * Request body:
+ *   {
+ *     vaultPath: string,
+ *     sourceType: WikiSourceType,
+ *     sourceRef: string,
+ *     sourceBody: string,
+ *     callerSession?: string,
+ *     targetRelativePath?: string
+ *   }
+ *
+ * Response:
+ *   200 { success: true,  result: WikiIngestOutcome (ok=true variant) }
+ *   400 { success: false, error: string, outcome?: WikiIngestOutcome }
+ *   422 { success: false, error: 'frozen_path', outcome: WikiIngestOutcome }
+ */
+export declare function ingest(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * POST /api/wiki/query
+ *
+ * Build the system-context payload for a single-vault read. The skill /
+ * caller's runtime concatenates this with its per-LLM task-instruction
+ * prompt (`config/skills/<role>/wiki-query/prompts/<runtime>.md`) before
+ * the actual LLM call.
+ *
+ * Request body:
+ *   {
+ *     vaultPath: string,
+ *     query: string,
+ *     topK?: number,
+ *     recentLogEntries?: number
+ *   }
+ *
+ * Response:
+ *   200 { success: true,  result: { context: WikiQuerySystemContext } }
+ *   400 { success: false, error: string, outcome?: failure }
+ *   404 { success: false, error: 'schema_missing', outcome }
+ */
+export declare function queryVault(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * POST /api/wiki/queue
+ *
+ * Enqueue a candidate item. Agents call this when a turn produces
+ * content worth saving to the wiki. The `reason` is REQUIRED — the
+ * agent has to justify why this is wiki-worthy (audit trail + helps
+ * the processor decide where it goes).
+ */
+export declare function queueAdd(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * GET /api/wiki/queue?vaultPath=…&status=…&queuedBy=…&limit=…
+ */
+export declare function queueList(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * POST /api/wiki/queue/:id/claim
+ *   body: { claimedBy: string }
+ */
+export declare function queueClaim(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * POST /api/wiki/queue/:id/process
+ *   body: { ingested: boolean, pagesWritten?: string[], targetPath?: string, summary?: string }
+ */
+export declare function queueProcess(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * POST /api/wiki/queue/:id/skip
+ *   body: { skipReason: string }
+ */
+export declare function queueSkip(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * POST /api/wiki/queue/claim-next
+ *   body: { claimedBy: string, vaultPath?: string, offset?: number, topK?: number, recentLogEntries?: number }
+ *
+ * Claims the next pending item AND returns the vault context the
+ * agent's LLM should classify against. The agent then picks a target
+ * page, calls /wiki/ingest, and commits via /queue/:id/process.
+ */
+export declare function queueClaimNext(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * POST /api/wiki/bookkeep
+ *   body: { vaultPath: string, windowDays?: number, threshold?: number }
+ */
+export declare function bookkeep(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * GET /api/wiki/vaults
+ *
+ * Returns the list of all known vaults (project + team + global) with
+ * stats so the UI can render a sidebar. Discovery uses the same logic
+ * the bookkeep trigger uses.
+ */
+export declare function listVaults(_req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * GET /api/wiki/tree?vaultPath=...
+ *
+ * Walks the vault directory and returns the file tree. Frozen folders
+ * are marked so the UI can render them differently. SCHEMA.md is
+ * surfaced as a top-level file.
+ */
+export declare function getVaultTree(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * GET /api/wiki/page?vaultPath=...&relativePath=...
+ *
+ * Returns the raw markdown content of a single page. The relativePath
+ * is validated to ensure it doesn't escape the vault directory.
+ */
+export declare function getPage(req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * POST /api/wiki/bookkeep/trigger-now
+ *
+ * Force one tick of the bookkeep trigger NOW. Used for manual testing
+ * (curl, the chat UI, an admin button) — production cadence is the
+ * automatic interval scan, but operators sometimes want to invoke it
+ * synchronously to verify wiring or to clear a backlog.
+ */
+export declare function bookkeepTriggerNow(_req: Request, res: Response, next: NextFunction): Promise<void>;
+/**
+ * GET /api/wiki/queue/stats?vaultPath=…
+ */
+export declare function queueStats(req: Request, res: Response, next: NextFunction): Promise<void>;
+//# sourceMappingURL=wiki.controller.d.ts.map

package/dist/backend/backend/src/controllers/wiki/wiki.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki.controller.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/controllers/wiki/wiki.controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA+B/D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,MAAM,CAC1B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAmEf;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAgDf;AAgBD;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAwDf;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAmCf;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAwBD;;;;;;GAMG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAmDf;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAqFf;AAQD;;;;;GAKG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAmDf;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC,CAQf"}