crewly 1.20.19 → 1.20.21

package/dist/backend/backend/src/services/wiki/wiki-page.d.ts

@@ -0,0 +1,101 @@
+/**
+ * The page contract of the LLM-wiki.
+ *
+ * A vault page is markdown with YAML frontmatter. Two fields make a page a
+ * piece of knowledge rather than a bookmark: `summary` (the one-line
+ * conclusion — what this means for us) and `keep_because` (the reason it
+ * earns a place at all). Without them a write goes to `log.md`, not to a
+ * page. This module parses/serialises that shape and applies the gate;
+ * everything else (index, history, supersede) builds on it.
+ *
+ * @module services/wiki/wiki-page
+ */
+import { type WikiKeepBecause } from '../../constants.js';
+/** Frontmatter every page carries (agents set the first block; the system fills the rest). */
+export interface WikiPageFrontmatter {
+    title: string;
+    /** One-line conclusion: what this page means for the team/project. */
+    summary: string;
+    keep_because: WikiKeepBecause;
+    tags?: string[];
+    /** Roles allowed to read the page; empty/absent = everyone in the vault's instance. */
+    visibility?: string[];
+    source?: string;
+    caller?: string;
+    recorded?: string;
+    updated?: string;
+    superseded_by?: string;
+    superseded_at?: string;
+    superseded_reason?: string;
+    proposed_by?: string;
+    /** Anything else on the page (migrated fields such as `confidence`, `migrated_from`). */
+    [key: string]: unknown;
+}
+/** A parsed page. */
+export interface WikiPage {
+    frontmatter: Partial<WikiPageFrontmatter>;
+    body: string;
+    /** True when the file had a `---` block at all. */
+    hadFrontmatter: boolean;
+}
+/** Why a page write was refused by the retention gate. */
+export interface RetentionRefusal {
+    reason: 'retention_gate';
+    missing: string[];
+    message: string;
+}
+/**
+ * Split a page into frontmatter + body. Tolerant: a page without a block
+ * parses as `{ frontmatter: {}, body: raw }`; a malformed block is left in
+ * the body untouched.
+ *
+ * @param raw - File content
+ * @returns The parsed page
+ */
+export declare function parsePage(raw: string): WikiPage;
+/**
+ * Serialise frontmatter + body back into a file. Keys are written in the
+ * canonical order of {@link WIKI_KB_CONSTANTS.FRONTMATTER_KEYS} first, then
+ * any extra keys, so diffs stay readable.
+ *
+ * @param frontmatter - Fields to write (undefined values are dropped)
+ * @param body - Markdown body
+ * @returns File content
+ */
+export declare function serializePage(frontmatter: Partial<WikiPageFrontmatter>, body: string): string;
+/**
+ * Apply the retention gate to a page write: `title`, a non-empty `summary`
+ * and a valid `keep_because` are required. Returns null when the page
+ * passes.
+ *
+ * @param fm - Frontmatter the writer supplied
+ * @returns A refusal describing what is missing, or null
+ */
+export declare function checkRetention(fm: Partial<WikiPageFrontmatter>): RetentionRefusal | null;
+/**
+ * The single index line for a page: `- [title](path) — summary`, with a
+ * `⟶ superseded by <path>` marker when applicable.
+ *
+ * @param relativePath - Vault-relative page path
+ * @param fm - The page's frontmatter
+ * @returns One markdown list line
+ */
+export declare function indexLineFor(relativePath: string, fm: Partial<WikiPageFrontmatter>): string;
+/**
+ * Whether a viewer role may read a page. No `visibility` list = public
+ * within the instance; a canonical role (owner/orchestrator) always may.
+ *
+ * @param fm - Page frontmatter
+ * @param viewerRole - Role of the reader, or undefined for the owner/UI
+ * @returns True when readable
+ */
+export declare function isVisibleTo(fm: Partial<WikiPageFrontmatter>, viewerRole?: string): boolean;
+/**
+ * Collapse whitespace and cut to a maximum length (with an ellipsis).
+ *
+ * @param value - Text
+ * @param max - Maximum characters
+ * @returns One line
+ */
+export declare function oneLine(value: string, max: number): string;
+//# sourceMappingURL=wiki-page.d.ts.map

package/dist/backend/backend/src/services/wiki/wiki-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-page.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-page.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAqB,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE7E,8FAA8F;AAC9F,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,eAAe,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yFAAyF;IACzF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qBAAqB;AACrB,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,cAAc,EAAE,OAAO,CAAC;CACzB;AAED,0DAA0D;AAC1D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAW/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAU7F;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,gBAAgB,GAAG,IAAI,CAiBxF;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,mBAAmB,CAAC,GAAG,MAAM,CAK3F;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,OAAO,CAAC,mBAAmB,CAAC,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAM1F;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAG1D"}

package/dist/backend/backend/src/services/wiki/wiki-page.js

@@ -0,0 +1,130 @@
+/**
+ * The page contract of the LLM-wiki.
+ *
+ * A vault page is markdown with YAML frontmatter. Two fields make a page a
+ * piece of knowledge rather than a bookmark: `summary` (the one-line
+ * conclusion — what this means for us) and `keep_because` (the reason it
+ * earns a place at all). Without them a write goes to `log.md`, not to a
+ * page. This module parses/serialises that shape and applies the gate;
+ * everything else (index, history, supersede) builds on it.
+ *
+ * @module services/wiki/wiki-page
+ */
+import { parse as parseYAML, stringify as stringifyYAML } from 'yaml';
+import { WIKI_KB_CONSTANTS } from '../../constants.js';
+/**
+ * Split a page into frontmatter + body. Tolerant: a page without a block
+ * parses as `{ frontmatter: {}, body: raw }`; a malformed block is left in
+ * the body untouched.
+ *
+ * @param raw - File content
+ * @returns The parsed page
+ */
+export function parsePage(raw) {
+    const normalized = raw.replace(/\r\n/g, '\n');
+    const m = normalized.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+    if (!m)
+        return { frontmatter: {}, body: normalized, hadFrontmatter: false };
+    try {
+        const parsed = parseYAML(m[1]);
+        const fm = parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
+        return { frontmatter: fm, body: m[2], hadFrontmatter: true };
+    }
+    catch {
+        return { frontmatter: {}, body: normalized, hadFrontmatter: false };
+    }
+}
+/**
+ * Serialise frontmatter + body back into a file. Keys are written in the
+ * canonical order of {@link WIKI_KB_CONSTANTS.FRONTMATTER_KEYS} first, then
+ * any extra keys, so diffs stay readable.
+ *
+ * @param frontmatter - Fields to write (undefined values are dropped)
+ * @param body - Markdown body
+ * @returns File content
+ */
+export function serializePage(frontmatter, body) {
+    const ordered = {};
+    for (const key of WIKI_KB_CONSTANTS.FRONTMATTER_KEYS) {
+        if (frontmatter[key] !== undefined)
+            ordered[key] = frontmatter[key];
+    }
+    for (const [key, value] of Object.entries(frontmatter)) {
+        if (!(key in ordered) && value !== undefined)
+            ordered[key] = value;
+    }
+    const yaml = stringifyYAML(ordered).trimEnd();
+    return `---\n${yaml}\n---\n${body.replace(/^\n+/, '')}`;
+}
+/**
+ * Apply the retention gate to a page write: `title`, a non-empty `summary`
+ * and a valid `keep_because` are required. Returns null when the page
+ * passes.
+ *
+ * @param fm - Frontmatter the writer supplied
+ * @returns A refusal describing what is missing, or null
+ */
+export function checkRetention(fm) {
+    const missing = [];
+    if (!fm.title || !String(fm.title).trim())
+        missing.push('title');
+    const summary = typeof fm.summary === 'string' ? fm.summary.trim() : '';
+    if (!summary)
+        missing.push('summary');
+    else if (summary.length > WIKI_KB_CONSTANTS.SUMMARY_MAX_CHARS)
+        missing.push(`summary (≤ ${WIKI_KB_CONSTANTS.SUMMARY_MAX_CHARS} chars)`);
+    if (!fm.keep_because || !WIKI_KB_CONSTANTS.KEEP_BECAUSE.includes(String(fm.keep_because))) {
+        missing.push(`keep_because (one of ${WIKI_KB_CONSTANTS.KEEP_BECAUSE.join(' | ')})`);
+    }
+    if (missing.length === 0)
+        return null;
+    return {
+        reason: 'retention_gate',
+        missing,
+        message: `A page needs ${missing.join(', ')}. Default is to NOT keep: write a page only when it changes a decision, ` +
+            `contradicts what we believed, is a citable hard fact, or a reusable method — otherwise append to llm-curated/log.md.`,
+    };
+}
+/**
+ * The single index line for a page: `- [title](path) — summary`, with a
+ * `⟶ superseded by <path>` marker when applicable.
+ *
+ * @param relativePath - Vault-relative page path
+ * @param fm - The page's frontmatter
+ * @returns One markdown list line
+ */
+export function indexLineFor(relativePath, fm) {
+    const title = oneLine(String(fm.title ?? relativePath.split('/').pop() ?? relativePath), WIKI_KB_CONSTANTS.TITLE_MAX_CHARS);
+    const summary = oneLine(String(fm.summary ?? ''), WIKI_KB_CONSTANTS.SUMMARY_MAX_CHARS);
+    const superseded = fm.superseded_by ? ` ⟶ superseded by ${fm.superseded_by}` : '';
+    return `- [${title}](${relativePath})${summary ? ` — ${summary}` : ''}${superseded}`;
+}
+/**
+ * Whether a viewer role may read a page. No `visibility` list = public
+ * within the instance; a canonical role (owner/orchestrator) always may.
+ *
+ * @param fm - Page frontmatter
+ * @param viewerRole - Role of the reader, or undefined for the owner/UI
+ * @returns True when readable
+ */
+export function isVisibleTo(fm, viewerRole) {
+    const list = Array.isArray(fm.visibility) ? fm.visibility.map((v) => String(v).toLowerCase()) : [];
+    if (list.length === 0)
+        return true;
+    if (!viewerRole)
+        return true;
+    const role = viewerRole.toLowerCase();
+    return role === 'orchestrator' || role === 'owner' || list.includes(role);
+}
+/**
+ * Collapse whitespace and cut to a maximum length (with an ellipsis).
+ *
+ * @param value - Text
+ * @param max - Maximum characters
+ * @returns One line
+ */
+export function oneLine(value, max) {
+    const flat = value.replace(/\\n/g, ' ').replace(/\s+/g, ' ').trim();
+    return flat.length <= max ? flat : `${flat.slice(0, max - 1)}…`;
+}
+//# sourceMappingURL=wiki-page.js.map

package/dist/backend/backend/src/services/wiki/wiki-page.js.map

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

package/dist/backend/backend/src/services/wiki/wiki-policy.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Write-policy decisions for a vault (SCHEMA.md `write_policy`).
+ *
+ * Who wrote is resolved by the server from the `X-Agent-Session` header
+ * (session → team member → role), never from a role the caller claims.
+ * The owner (dashboard, no session) and the orchestrator are canonical.
+ *
+ * @module services/wiki/wiki-policy
+ */
+import type { VaultSchema } from './wiki.types.js';
+/** What a write by a given role becomes. */
+export type WriteDecision = 'canonical' | 'proposed';
+/**
+ * Decide whether a writer's page lands directly or as a proposal.
+ *
+ * Rules, in order: no role (owner/UI) → canonical; role listed in
+ * `canonical` → canonical; role listed in `proposed_only` → proposed;
+ * `worker` in `proposed_only` covers every role not listed elsewhere;
+ * an unlisted role with no `worker` catch-all → proposed (safe default).
+ *
+ * @param schema - Vault schema
+ * @param role - Writer's role (lower-cased inside), or undefined for the owner
+ * @returns The decision
+ */
+export declare function decideWrite(schema: Pick<VaultSchema, 'write_policy'>, role: string | undefined): WriteDecision;
+/**
+ * Whether a role may accept/reject proposals or supersede pages (a
+ * canonical role).
+ *
+ * @param schema - Vault schema
+ * @param role - Role, or undefined for the owner
+ * @returns True when allowed
+ */
+export declare function canReview(schema: Pick<VaultSchema, 'write_policy'>, role: string | undefined): boolean;
+//# sourceMappingURL=wiki-policy.d.ts.map

package/dist/backend/backend/src/services/wiki/wiki-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-policy.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,4CAA4C;AAC5C,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC;AAErD;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAO9G;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEtG"}

package/dist/backend/backend/src/services/wiki/wiki-policy.js

@@ -0,0 +1,44 @@
+/**
+ * Write-policy decisions for a vault (SCHEMA.md `write_policy`).
+ *
+ * Who wrote is resolved by the server from the `X-Agent-Session` header
+ * (session → team member → role), never from a role the caller claims.
+ * The owner (dashboard, no session) and the orchestrator are canonical.
+ *
+ * @module services/wiki/wiki-policy
+ */
+/**
+ * Decide whether a writer's page lands directly or as a proposal.
+ *
+ * Rules, in order: no role (owner/UI) → canonical; role listed in
+ * `canonical` → canonical; role listed in `proposed_only` → proposed;
+ * `worker` in `proposed_only` covers every role not listed elsewhere;
+ * an unlisted role with no `worker` catch-all → proposed (safe default).
+ *
+ * @param schema - Vault schema
+ * @param role - Writer's role (lower-cased inside), or undefined for the owner
+ * @returns The decision
+ */
+export function decideWrite(schema, role) {
+    if (!role)
+        return 'canonical';
+    const r = role.toLowerCase();
+    if (r === 'orchestrator' || r === 'owner')
+        return 'canonical';
+    const canonical = schema.write_policy.canonical.map((x) => x.toLowerCase());
+    if (canonical.includes(r))
+        return 'canonical';
+    return 'proposed';
+}
+/**
+ * Whether a role may accept/reject proposals or supersede pages (a
+ * canonical role).
+ *
+ * @param schema - Vault schema
+ * @param role - Role, or undefined for the owner
+ * @returns True when allowed
+ */
+export function canReview(schema, role) {
+    return decideWrite(schema, role) === 'canonical';
+}
+//# sourceMappingURL=wiki-policy.js.map

package/dist/backend/backend/src/services/wiki/wiki-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-policy.js","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-policy.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,MAAyC,EAAE,IAAwB;IAC7F,IAAI,CAAC,IAAI;QAAE,OAAO,WAAW,CAAC;IAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7B,IAAI,CAAC,KAAK,cAAc,IAAI,CAAC,KAAK,OAAO;QAAE,OAAO,WAAW,CAAC;IAC9D,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5E,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,WAAW,CAAC;IAC9C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,MAAyC,EAAE,IAAwB;IAC3F,OAAO,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,WAAW,CAAC;AACnD,CAAC"}

package/dist/backend/backend/src/services/wiki/wiki-process.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wiki-process.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-process.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB;;;;;;OAMG;IACH,YAAY,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC5C,kDAAkD;IAClD,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,MAAM,uBAAuB,GAC/B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,GAC5C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,kBAAkB,GAAG,oBAAoB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF;;GAEG;AACH,qBAAa,kBAAkB;IAK3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IALxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAGtB,KAAK,GAAE,gBAAiD,EACxD,KAAK,GAAE,gBAAiD;IAK3E,MAAM,CAAC,WAAW,IAAI,kBAAkB;IAKxC,uBAAuB;IACvB,MAAM,CAAC,gBAAgB,IAAI,IAAI;IAI/B;;;;;;OAMG;IACG,SAAS,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA2E/E;;;OAGG;IACH,OAAO,CAAC,eAAe;CAUxB"}
+{"version":3,"file":"wiki-process.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-process.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAGH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,qBAAqB;IACpC,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB;;;;;;OAMG;IACH,YAAY,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC5C,kDAAkD;IAClD,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,MAAM,uBAAuB,GAC/B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,sBAAsB,CAAA;CAAE,GAC5C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,kBAAkB,GAAG,oBAAoB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF;;GAEG;AACH,qBAAa,kBAAkB;IAK3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;IALxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAGtB,KAAK,GAAE,gBAAiD,EACxD,KAAK,GAAE,gBAAiD;IAK3E,MAAM,CAAC,WAAW,IAAI,kBAAkB;IAKxC,uBAAuB;IACvB,MAAM,CAAC,gBAAgB,IAAI,IAAI;IAI/B;;;;;;OAMG;IACG,SAAS,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA2E/E;;;OAGG;IACH,OAAO,CAAC,eAAe;CAaxB"}

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

@@ -126,12 +126,15 @@ export class WikiProcessService {
      */
     classifierNotes() {
         return [
-            'You have ALREADY decided this item is wiki-worthy at queue-add time (see item.reason). Do NOT re-justify; classify.',
+            'Default is to NOT keep. A page must change a decision, contradict what we believed, be a citable hard fact, or a reusable method — otherwise append it to llm-curated/log.md (no gate) or skip it.',
+            'A page needs three things or wiki-ingest refuses it: --title, a one-line --summary that states the CONCLUSION (what this means for us, not what the source said), and --keep-because <changes_decision|contradicts|hard_fact|reusable_method>.',
+            'If the item changes an earlier conclusion, write the new page and then call wiki-supersede old→new with the reason; never delete or overwrite the old page.',
             'Pick the target page path under llm-curated/. You may invent sub-folder names — there is NO preset taxonomy. Examples: llm-curated/customers/anthropic.md, llm-curated/decisions/2026-05-22-pricing-lock.md, llm-curated/patterns/embedding-fallback.md.',
             'NEVER target a frozen folder (vaultContext.schemaSummary.frozenPaths). The ingest call will reject these with HTTP 422.',
             'PREFER merging into an existing relevant page over creating a new one. Use vaultContext.candidatePages to check first; only create a new page when nothing fits.',
             'If after reading the context you decide the item is actually NOT wiki-worthy after all (duplicate of existing content, low signal), mark it skipped via POST /queue/:id/skip with a `skipReason`.',
-            'When committing: 1) call wiki-ingest with the target path; 2) call POST /queue/:id/process with { ingested, pagesWritten, targetPath, summary }.',
+            'When committing: 1) call wiki-ingest with the target path + title/summary/keep-because; 2) call POST /queue/:id/process with { ingested, pagesWritten, targetPath, summary }.',
+            'Never paste credentials or customer personal data; ingest refuses secrets and applies the vault privacy policy to personal data.',
         ];
     }
 }

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

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

package/dist/backend/backend/src/services/wiki/wiki-query.service.d.ts

@@ -2,6 +2,14 @@
  * WikiQueryService — read a vault and build the `system-context` payload
  * that the caller's runtime feeds to its LLM for synthesis.
  *
+ * Retrieval is two-step: the payload leads with the vault's one-line
+ * index (`llm-curated/index.md`, trimmed to the query's neighbourhood
+ * when it would not fit), then BM25 candidate pages; the caller picks
+ * 3–5 paths and asks again with `pages` to get them in full. Superseded
+ * pages and pages the viewer's role may not see never appear. Every call
+ * is written to the vault's usage ledger (what was asked, what was read,
+ * whether it was a miss).
+ *
  * Per v2.1 spec §3 the skill is split into two halves:
  *   - System-context (LLM-agnostic) → what this service produces
  *   - Task-instruction (per-LLM)    → lives on disk under
@@ -15,6 +23,9 @@
  */
 import { SchemaLoaderService } from './schema-loader.service.js';
 import { VaultSchema } from './wiki.types.js';
+import { WikiIndexService } from './wiki-index.service.js';
+import { WikiUsageService } from './wiki-usage.service.js';
+import { type WikiPageFrontmatter } from './wiki-page.js';
 export interface WikiQueryInput {
     /** Absolute path to the vault root. */
     vaultPath: string;
@@ -24,6 +35,14 @@ export interface WikiQueryInput {
     topK?: number;
     /** How many tail log.md entries to include (default 20). */
     recentLogEntries?: number;
+    /** Step 2: vault-relative pages to return in full (max 8). */
+    pages?: string[];
+    /** Who is asking (session name) — for the usage ledger. */
+    agent?: string;
+    /** Reader's role — pages whose `visibility` excludes it are hidden. Undefined = owner. */
+    viewerRole?: string;
+    /** Include superseded pages (default false). */
+    includeSuperseded?: boolean;
 }
 export interface WikiLogEntry {
     timestamp: string;
@@ -40,12 +59,27 @@ export interface WikiCandidatePage {
     /** Simple keyword overlap score; higher = more relevant. */
     score: number;
 }
+/** A page returned in full (step 2). */
+export interface WikiFullPage {
+    path: string;
+    frontmatter: Partial<WikiPageFrontmatter>;
+    content: string;
+    truncated: boolean;
+}
 export interface WikiQuerySystemContext {
     vault: {
         scope: VaultSchema['vault_scope'];
         id: string;
         path: string;
     };
+    /** Step 1: the one-line-per-page index (trimmed to the query when large). */
+    index: {
+        text: string;
+        truncated: boolean;
+        entries: number;
+    };
+    /** Step 2: pages the caller asked for in full. */
+    pages: WikiFullPage[];
     schemaSummary: {
         hardcoded: Array<{
             path: string;
@@ -81,7 +115,9 @@ export declare class WikiQueryService {
     private static instance;
     private readonly logger;
     private readonly schemaLoader;
-    constructor(schemaLoader?: SchemaLoaderService);
+    private readonly index;
+    private readonly usage;
+    constructor(schemaLoader?: SchemaLoaderService, index?: WikiIndexService, usage?: WikiUsageService);
     static getInstance(): WikiQueryService;
     /** Test-only reset. */
     static _resetForTesting(): void;
@@ -103,23 +139,31 @@ export declare class WikiQueryService {
      */
     private readRecentLog;
     /**
-     * Gather the vault's NON-frozen (`llm-curated/`) `.md` pages and rank them by
-     * Okapi BM25 against the query, reusing {@link WikiSearchService.searchCorpus}
-     * so the agent-facing `wiki-query` skill scores identically to the wiki UI
-     * search. IDF is computed over exactly the gathered pages, preserving this
-     * skill's scope: only curated pages are eligible, and `llm-curated/log.md`
-     * is excluded (it is surfaced separately as `recentLog`).
+     * Rank the vault's `llm-curated/` pages by Okapi BM25 against the query,
+     * reusing {@link WikiSearchService.searchCorpus} so the agent-facing
+     * skill scores identically to the wiki UI search. Seed files (index,
+     * log) are excluded; superseded/invisible/proposed pages are dropped by
+     * the search filters.
+     *
+     * @param vaultPath - Vault root
+     * @param query - Query text
+     * @param topK - How many candidates
+     * @param filters - Viewer/superseded filters
+     * @returns Candidates with truncated excerpts
      */
     private findCandidatePages;
     /**
-     * Collect candidate `.md` pages under the schema's `llm-curated/` roots,
-     * skipping dotfile/`node_modules` dirs and `llm-curated/log.md`.
+     * Step 2: return the requested pages in full (frontmatter + content),
+     * honouring frozen paths, visibility and supersession. Unknown paths
+     * are skipped silently (the caller sees which ones came back).
      *
-     * @param vaultPath - Absolute vault root.
-     * @param schema - Loaded vault schema (defines the curated roots).
-     * @returns Page refs as `{ relativePath (POSIX), absPath }`.
+     * @param vaultPath - Vault root
+     * @param schema - Vault schema (frozen folders are readable — SOPs/norms are knowledge too)
+     * @param requested - Vault-relative paths
+     * @param filters - Viewer/superseded filters
+     * @returns Pages in request order
      */
-    private gatherCuratedPages;
+    private readFullPages;
     private readExcerpt;
 }
 //# sourceMappingURL=wiki-query.service.d.ts.map

package/dist/backend/backend/src/services/wiki/wiki-query.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wiki-query.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-query.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAO9C,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE;QAAE,KAAK,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,aAAa,EAAE;QACb,SAAS,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACxD,UAAU,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAC;QAC3D,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,WAAW,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;KAC1C,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,cAAc,EAAE,iBAAiB,EAAE,CAAC;IACpC,4DAA4D;IAC5D,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,eAAe,GAAG,gBAAgB,GAAG,eAAe,CAAC;IAC7D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,sBAAsB,CAAA;CAAE,GAC7C,gBAAgB,CAAC;AAErB;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;gBAEvC,YAAY,CAAC,EAAE,mBAAmB;IAK9C,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAOtC,uBAAuB;IACvB,MAAM,CAAC,gBAAgB,IAAI,IAAI;IAI/B;;;OAGG;IACG,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAqE5D,OAAO,CAAC,QAAQ;IAmChB;;;;;;;;;OASG;YACW,aAAa;IA8C3B;;;;;;;OAOG;YACW,kBAAkB;IAmBhC;;;;;;;OAOG;YACW,kBAAkB;YAyClB,WAAW;CAS1B"}
+{"version":3,"file":"wiki-query.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-query.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AASlF,MAAM,WAAW,cAAc;IAC7B,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE;QAAE,KAAK,EAAE,WAAW,CAAC,aAAa,CAAC,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,6EAA6E;IAC7E,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,kDAAkD;IAClD,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,aAAa,EAAE;QACb,SAAS,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACxD,UAAU,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAC;QAC3D,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,WAAW,EAAE,WAAW,CAAC,cAAc,CAAC,CAAC;KAC1C,CAAC;IACF,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,cAAc,EAAE,iBAAiB,EAAE,CAAC;IACpC,4DAA4D;IAC5D,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,eAAe,GAAG,gBAAgB,GAAG,eAAe,CAAC;IAC7D,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,sBAAsB,CAAA;CAAE,GAC7C,gBAAgB,CAAC;AAErB;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAiC;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IAEnD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;gBAE7B,YAAY,CAAC,EAAE,mBAAmB,EAAE,KAAK,CAAC,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,gBAAgB;IAOlG,MAAM,CAAC,WAAW,IAAI,gBAAgB;IAOtC,uBAAuB;IACvB,MAAM,CAAC,gBAAgB,IAAI,IAAI;IAI/B;;;OAGG;IACG,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAmF5D,OAAO,CAAC,QAAQ;IAmChB;;;;;;;;;OASG;YACW,aAAa;IA8C3B;;;;;;;;;;;;OAYG;YACW,kBAAkB;IAiBhC;;;;;;;;;;OAUG;YACW,aAAa;YAiCb,WAAW;CAS1B"}