crewly 1.20.356 → 1.20.359

package/dist/backend/backend/src/services/wiki/wiki-vault-walk.js

@@ -6,12 +6,26 @@
  */
 import * as path from 'path';
 import * as fs from 'fs/promises';
-import { WIKI_KB_CONSTANTS } from '../../constants.js';
+import { WIKI_KB_CONSTANTS, WIKI_LOG_CONSTANTS } from '../../constants.js';
 /** Files that are not knowledge pages (index, log, readme). */
 export function isSeedFile(relativePath) {
     const base = relativePath.split('/').pop()?.toLowerCase() ?? '';
     return base === 'index.md' || base === 'log.md' || base === 'readme.md' || base === 'schema.md';
 }
+/**
+ * Whether a vault-relative path lies inside the rotated-log archive
+ * (`llm-curated/log-archive/`). Archived logs are kept, never searched,
+ * counted or linted (#1345).
+ *
+ * @param relativePath - POSIX path relative to the vault root
+ * @returns True for the archive folder and anything under it
+ */
+export function isLogArchivePath(relativePath) {
+    const normalized = relativePath.replace(/\\/g, '/').replace(/^\/+/, '');
+    return normalized === WIKI_LOG_CONSTANTS.ARCHIVE_DIR || normalized.startsWith(`${WIKI_LOG_CONSTANTS.ARCHIVE_DIR}/`);
+}
+/** Directory basename of the rotated-log archive. */
+export const LOG_ARCHIVE_DIR_NAME = WIKI_LOG_CONSTANTS.ARCHIVE_DIR.split('/').pop() ?? 'log-archive';
 /**
  * Walk `<vault>/llm-curated/` and list every `.md` page.
  *
@@ -40,6 +54,8 @@ export async function walkCuratedPages(vaultPath, options = {}) {
                     continue;
                 if (abs === proposedAbs && !options.includeProposed)
                     continue;
+                if (isLogArchivePath(path.relative(vaultPath, abs).replace(/\\/g, '/')))
+                    continue;
                 stack.push(abs);
             }
             else if (entry.isFile() && entry.name.endsWith('.md')) {

package/dist/backend/backend/src/services/wiki/wiki-vault-walk.js.map

@@ -1 +1 @@
-{"version":3,"file":"wiki-vault-walk.js","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-vault-walk.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AASvD,+DAA+D;AAC/D,MAAM,UAAU,UAAU,CAAC,YAAoB;IAC7C,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAChE,OAAO,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,CAAC;AAClG,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,SAAiB,EACjB,UAAyC,EAAE;IAE3C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC;IACzE,MAAM,GAAG,GAAkB,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC;IACrB,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;QACzB,IAAI,OAA8B,CAAC;QACnC,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc;oBAAE,SAAS;gBAC1E,IAAI,GAAG,KAAK,WAAW,IAAI,CAAC,OAAO,CAAC,eAAe;oBAAE,SAAS;gBAC9D,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxD,GAAG,CAAC,IAAI,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;YAC9F,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;AAC1E,CAAC"}
+{"version":3,"file":"wiki-vault-walk.js","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-vault-walk.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/wiki/work-record-transcript.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Transcript facts for a work record (#1349).
+ *
+ * Reads a bounded tail of the doer's Claude Code transcript and keeps only
+ * what happened inside the task window: failed tool calls (with whether the
+ * same call later succeeded), files written, PR / commit references and
+ * messages posted. Only the main chain counts (`isSidechain` entries belong
+ * to subagents). Tool results are read for their error flag and the first
+ * line of an exit code, never copied.
+ *
+ * Codex rollouts are not read (their shape differs; the trace covers them).
+ *
+ * @module services/wiki/work-record-transcript
+ */
+import type { WorkRecordError } from './work-record.js';
+/** What the transcript slice says about a task. */
+export interface TranscriptWindowFacts {
+    errors: WorkRecordError[];
+    filesWritten: string[];
+    urls: string[];
+    commits: string[];
+    /** Messages the agent posted through a reply / post skill. */
+    posts: number;
+    /** Tool calls seen inside the window. */
+    toolCalls: number;
+}
+/** Task window. */
+export interface TranscriptWindow {
+    fromMs: number;
+    toMs: number;
+}
+/**
+ * Read the end of a file as whole lines (the first partial line is dropped).
+ *
+ * @param file - Path
+ * @param maxBytes - Bytes from the end
+ * @returns Text, '' when the file cannot be read
+ */
+export declare function readTranscriptTail(file: string, maxBytes?: number): Promise<string>;
+/**
+ * Facts from whole Claude transcript lines inside a window.
+ *
+ * @param text - JSONL text (whole lines)
+ * @param window - Task window (epoch ms); entries outside it are ignored
+ * @param roots - Project roots to make file paths relative to
+ * @returns Facts (empty when nothing fell in the window)
+ *
+ * @example
+ * ```typescript
+ * const facts = parseClaudeTranscriptWindow(await readTranscriptTail(file), { fromMs, toMs }, [projectPath]);
+ * facts.errors; // [{ what: 'Bash `npm test` exit 1', resolved: 'fixed' }]
+ * ```
+ */
+export declare function parseClaudeTranscriptWindow(text: string, window: TranscriptWindow, roots?: readonly string[]): TranscriptWindowFacts;
+/**
+ * Whether a transcript is worth reading for an item that ended at `endedMs`:
+ * the tail only holds recent turns.
+ *
+ * @param endedMs - When the item ended (epoch ms)
+ * @param now - Clock
+ * @returns True when the window may still be in the tail
+ */
+export declare function transcriptWorthReading(endedMs: number, now?: number): boolean;
+//# sourceMappingURL=work-record-transcript.d.ts.map

package/dist/backend/backend/src/services/wiki/work-record-transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-record-transcript.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/work-record-transcript.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAIxD,mDAAmD;AACnD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,mBAAmB;AACnB,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAeD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAgC,GAAG,OAAO,CAAC,MAAM,CAAC,CAelH;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,KAAK,GAAE,SAAS,MAAM,EAAO,GAAG,qBAAqB,CAmExI;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,OAAO,CAEzF"}

package/dist/backend/backend/src/services/wiki/work-record-transcript.js

@@ -0,0 +1,194 @@
+/**
+ * Transcript facts for a work record (#1349).
+ *
+ * Reads a bounded tail of the doer's Claude Code transcript and keeps only
+ * what happened inside the task window: failed tool calls (with whether the
+ * same call later succeeded), files written, PR / commit references and
+ * messages posted. Only the main chain counts (`isSidechain` entries belong
+ * to subagents). Tool results are read for their error flag and the first
+ * line of an exit code, never copied.
+ *
+ * Codex rollouts are not read (their shape differs; the trace covers them).
+ *
+ * @module services/wiki/work-record-transcript
+ */
+import * as fs from 'fs/promises';
+import { WORK_RECORD_CONSTANTS } from '../../constants.js';
+import { redactSensitive } from './wiki-redaction.js';
+const C = WORK_RECORD_CONSTANTS;
+const PR_URL_RE = /https:\/\/github\.com\/[\w.-]+\/[\w.-]+\/(?:pull|issues)\/\d+/g;
+const COMMIT_LINE_RE = /^\[[^\]\s]+ (?:\(root-commit\) )?([0-9a-f]{7,12})\]/m;
+const EXIT_CODE_RE = /^Exit code (\d+)/m;
+const POST_SKILL_RE = /\b(?:reply-chat|reply-channel|reply|slack-post|send-chat-response|send-message|slack-file|whatsapp-send|gmail-send)\b/;
+const FILE_TOOLS = new Set(['Write', 'Edit', 'MultiEdit', 'NotebookEdit']);
+/**
+ * Read the end of a file as whole lines (the first partial line is dropped).
+ *
+ * @param file - Path
+ * @param maxBytes - Bytes from the end
+ * @returns Text, '' when the file cannot be read
+ */
+export async function readTranscriptTail(file, maxBytes = C.TRANSCRIPT_TAIL_BYTES) {
+    let handle = null;
+    try {
+        handle = await fs.open(file, 'r');
+        const { size } = await handle.stat();
+        const start = Math.max(0, size - maxBytes);
+        const buf = Buffer.alloc(size - start);
+        await handle.read(buf, 0, buf.length, start);
+        const text = buf.toString('utf-8');
+        return start > 0 ? text.slice(text.indexOf('\n') + 1) : text;
+    }
+    catch {
+        return '';
+    }
+    finally {
+        await handle?.close();
+    }
+}
+/**
+ * Facts from whole Claude transcript lines inside a window.
+ *
+ * @param text - JSONL text (whole lines)
+ * @param window - Task window (epoch ms); entries outside it are ignored
+ * @param roots - Project roots to make file paths relative to
+ * @returns Facts (empty when nothing fell in the window)
+ *
+ * @example
+ * ```typescript
+ * const facts = parseClaudeTranscriptWindow(await readTranscriptTail(file), { fromMs, toMs }, [projectPath]);
+ * facts.errors; // [{ what: 'Bash `npm test` exit 1', resolved: 'fixed' }]
+ * ```
+ */
+export function parseClaudeTranscriptWindow(text, window, roots = []) {
+    const facts = { errors: [], filesWritten: [], urls: [], commits: [], posts: 0, toolCalls: 0 };
+    const uses = new Map();
+    const failed = [];
+    const succeededKeys = new Map();
+    const files = new Set();
+    const urls = new Set();
+    const commits = new Set();
+    const from = window.fromMs - C.TRANSCRIPT_WINDOW_SLACK_MS;
+    const to = window.toMs + C.TRANSCRIPT_WINDOW_SLACK_MS;
+    for (const line of text.split('\n')) {
+        if (line.length < 20 || !(line.includes('"tool_use"') || line.includes('"tool_result"') || line.includes('"type":"text"')))
+            continue;
+        let entry;
+        try {
+            entry = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (entry.isSidechain === true || entry.isMeta === true || entry.isApiErrorMessage === true)
+            continue;
+        const at = Date.parse(typeof entry.timestamp === 'string' ? entry.timestamp : '');
+        if (!Number.isFinite(at) || at < from || at > to)
+            continue;
+        const content = entry.message?.content;
+        if (!Array.isArray(content))
+            continue;
+        for (const block of content) {
+            if (block?.type === 'tool_use' && typeof block.id === 'string' && typeof block.name === 'string') {
+                const use = describeToolUse(block.name, block.input, roots, at);
+                uses.set(block.id, use);
+                facts.toolCalls++;
+                if (FILE_TOOLS.has(block.name)) {
+                    const p = filePathOf(block.input);
+                    if (p)
+                        files.add(relative(p, roots));
+                }
+                if (block.name === 'Bash' && POST_SKILL_RE.test(commandOf(block.input)))
+                    facts.posts++;
+            }
+            else if (block?.type === 'tool_result' && typeof block.tool_use_id === 'string') {
+                const use = uses.get(block.tool_use_id);
+                const resultText = resultTextOf(block.content);
+                const exit = resultText.match(EXIT_CODE_RE);
+                const nonZeroExit = exit ? Number(exit[1]) !== 0 : false;
+                if (block.is_error === true || nonZeroExit) {
+                    if (use)
+                        failed.push({ use: exit && nonZeroExit ? { ...use, summary: `${use.summary} exit ${exit[1]}` } : use, at });
+                }
+                else if (use) {
+                    succeededKeys.set(use.key, at);
+                }
+                for (const u of resultText.match(PR_URL_RE) ?? [])
+                    urls.add(u);
+                const commit = resultText.match(COMMIT_LINE_RE);
+                if (commit && use?.name === 'Bash' && /\bgit\s+commit\b/.test(use.summary))
+                    commits.add(commit[1]);
+            }
+            else if (block?.type === 'text' && typeof block.text === 'string' && entry.type === 'assistant') {
+                for (const u of block.text.match(PR_URL_RE) ?? [])
+                    urls.add(u);
+            }
+        }
+    }
+    const seen = new Set();
+    for (const f of failed) {
+        const what = redactSensitive(f.use.summary);
+        if (seen.has(what))
+            continue;
+        seen.add(what);
+        const later = succeededKeys.get(f.use.key);
+        facts.errors.push({ what, resolved: later !== undefined && later > f.at ? 'fixed' : 'unresolved' });
+        if (facts.errors.length >= C.MAX_ERRORS)
+            break;
+    }
+    facts.filesWritten = [...files].slice(0, C.MAX_OUTPUTS);
+    facts.urls = [...urls].slice(0, C.MAX_OUTPUTS);
+    facts.commits = [...commits].slice(0, C.MAX_OUTPUTS);
+    return facts;
+}
+/**
+ * Whether a transcript is worth reading for an item that ended at `endedMs`:
+ * the tail only holds recent turns.
+ *
+ * @param endedMs - When the item ended (epoch ms)
+ * @param now - Clock
+ * @returns True when the window may still be in the tail
+ */
+export function transcriptWorthReading(endedMs, now = Date.now()) {
+    return Number.isFinite(endedMs) && now - endedMs <= C.TRANSCRIPT_MAX_AGE_MS;
+}
+// ---------------------------------------------------------------------------
+function describeToolUse(name, input, roots, at) {
+    if (name === 'Bash') {
+        const command = commandOf(input).replace(/\s+/g, ' ').trim();
+        const shown = command.length > 80 ? `${command.slice(0, 79)}…` : command;
+        return { name, summary: `Bash \`${shown}\``, key: `Bash:${command.slice(0, 200)}`, at };
+    }
+    const p = filePathOf(input);
+    if (p)
+        return { name, summary: `${name} ${relative(p, roots)}`, key: `${name}:${p}`, at };
+    return { name, summary: `${name} call`, key: `${name}:`, at };
+}
+function commandOf(input) {
+    const c = input?.command;
+    return typeof c === 'string' ? c : '';
+}
+function filePathOf(input) {
+    const p = input;
+    const v = p?.file_path ?? p?.notebook_path ?? p?.path;
+    return typeof v === 'string' && v.length > 0 ? v : null;
+}
+function relative(file, roots) {
+    for (const root of roots) {
+        if (root && file.startsWith(`${root}/`))
+            return file.slice(root.length + 1);
+    }
+    return file;
+}
+function resultTextOf(content) {
+    if (typeof content === 'string')
+        return content.slice(0, 4_000);
+    if (Array.isArray(content)) {
+        return content
+            .map((c) => (typeof c?.text === 'string' ? (c.text) : ''))
+            .join('\n')
+            .slice(0, 4_000);
+    }
+    return '';
+}
+//# sourceMappingURL=work-record-transcript.js.map

package/dist/backend/backend/src/services/wiki/work-record-transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-record-transcript.js","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/work-record-transcript.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,MAAM,CAAC,GAAG,qBAAqB,CAAC;AAoBhC,MAAM,SAAS,GAAG,gEAAgE,CAAC;AACnF,MAAM,cAAc,GAAG,sDAAsD,CAAC;AAC9E,MAAM,YAAY,GAAG,mBAAmB,CAAC;AACzC,MAAM,aAAa,GAAG,uHAAuH,CAAC;AAC9I,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC,CAAC;AAS3E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY,EAAE,WAAmB,CAAC,CAAC,qBAAqB;IAC/F,IAAI,MAAM,GAAyB,IAAI,CAAC;IACxC,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAClC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,QAAQ,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;QACvC,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAAY,EAAE,MAAwB,EAAE,QAA2B,EAAE;IAC/G,MAAM,KAAK,GAA0B,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACrH,MAAM,IAAI,GAAG,IAAI,GAAG,EAAmB,CAAC;IACxC,MAAM,MAAM,GAAwC,EAAE,CAAC;IACvD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAC;IAChD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,0BAA0B,CAAC;IAC1D,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,0BAA0B,CAAC;IAEtD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;YAAE,SAAS;QACrI,IAAI,KAA8B,CAAC;QACnC,IAAI,CAAC;YACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA4B,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,KAAK,CAAC,WAAW,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,iBAAiB,KAAK,IAAI;YAAE,SAAS;QACtG,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,GAAG,EAAE;YAAE,SAAS;QAC3D,MAAM,OAAO,GAAI,KAAK,CAAC,OAA6C,EAAE,OAAO,CAAC;QAC9E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,SAAS;QAEtC,KAAK,MAAM,KAAK,IAAI,OAAyC,EAAE,CAAC;YAC9D,IAAI,KAAK,EAAE,IAAI,KAAK,UAAU,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACjG,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;gBAChE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;gBACxB,KAAK,CAAC,SAAS,EAAE,CAAC;gBAClB,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC/B,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBAClC,IAAI,CAAC;wBAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;gBACvC,CAAC;gBACD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;oBAAE,KAAK,CAAC,KAAK,EAAE,CAAC;YACzF,CAAC;iBAAM,IAAI,KAAK,EAAE,IAAI,KAAK,aAAa,IAAI,OAAO,KAAK,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;gBAClF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;gBACxC,MAAM,UAAU,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBAC/C,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;gBAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;gBACzD,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,WAAW,EAAE,CAAC;oBAC3C,IAAI,GAAG;wBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,IAAI,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;gBACvH,CAAC;qBAAM,IAAI,GAAG,EAAE,CAAC;oBACf,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACjC,CAAC;gBACD,KAAK,MAAM,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE;oBAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC/D,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;gBAChD,IAAI,MAAM,IAAI,GAAG,EAAE,IAAI,KAAK,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC;oBAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACrG,CAAC;iBAAM,IAAI,KAAK,EAAE,IAAI,KAAK,MAAM,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAClG,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE;oBAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC5C,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3C,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;QACpG,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,UAAU;YAAE,MAAM;IACjD,CAAC;IACD,KAAK,CAAC,YAAY,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;IAC/C,KAAK,CAAC,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC;IACrD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IAC9E,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,GAAG,GAAG,OAAO,IAAI,CAAC,CAAC,qBAAqB,CAAC;AAC9E,CAAC;AAED,8EAA8E;AAE9E,SAAS,eAAe,CAAC,IAAY,EAAE,KAAc,EAAE,KAAwB,EAAE,EAAU;IACzF,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;QACzE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,KAAK,IAAI,EAAE,GAAG,EAAE,QAAQ,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC;IAC1F,CAAC;IACD,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,IAAI,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC;IAC1F,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC;AAChE,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,MAAM,CAAC,GAAI,KAA2C,EAAE,OAAO,CAAC;IAChE,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACxC,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,MAAM,CAAC,GAAI,KAAsF,CAAC;IAClG,MAAM,CAAC,GAAG,CAAC,EAAE,SAAS,IAAI,CAAC,EAAE,aAAa,IAAI,CAAC,EAAE,IAAI,CAAC;IACtD,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1D,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAwB;IACtD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,YAAY,CAAC,OAAgB;IACpC,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAChE,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO;aACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAQ,CAAwB,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAE,CAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;aACvG,IAAI,CAAC,IAAI,CAAC;aACV,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/backend/backend/src/services/wiki/work-record.d.ts

@@ -0,0 +1,239 @@
+/**
+ * Work records (#1349) — the pure half.
+ *
+ * A work record is one structured `(record)` entry in a vault's activity log
+ * describing a finished (or long-blocked) task: who asked for it, who did it,
+ * what came out, what went wrong on the way and how it was resolved, who was
+ * pulled in, and how it ended. This module knows the shape, assembles a
+ * record from already-loaded inputs (no I/O, so fixtures can drive it),
+ * renders it as a log body, and parses a body back for the digest and the
+ * startup briefing.
+ *
+ * Owner-facing lines never carry ticket ids or WorkItem ids; those live on
+ * the `meta:` line, which the digest reads but never renders.
+ *
+ * Body layout (one field per line, parse-friendly):
+ *
+ *   (record) **<title>** — <outcome phrase>
+ *   asked by: <who> — "<quote>"
+ *   done by: <name>
+ *   did: <summary>
+ *   outputs: <a>; <b>
+ *   errors: <what> (fixed); <what> (unresolved)
+ *   helpers: delegated to Leo: "<title>" → done; asked Ella → answered; reviewed by Owen
+ *   outcome: <phrase>
+ *   meta: wi=<id> phase=final status=verified asked_by=owen:lead done_by=nova …
+ *
+ * @module services/wiki/work-record
+ */
+import type { WorkItem } from '../../types/v2/work-item.types.js';
+import type { ProjectTicket } from '../../types/project-ticket.types.js';
+import type { Request } from '../../types/v2/request.types.js';
+import type { TraceEvent } from '../trace/trace.types.js';
+import type { WikiLogEntryRecord } from './wiki-log-entries.js';
+import type { TranscriptWindowFacts } from './work-record-transcript.js';
+/** Who a party to the task is. */
+export type WorkRecordPartyKind = 'owner' | 'orchestrator' | 'lead' | 'agent' | 'schedule' | 'system';
+/** How the task ended. */
+export type WorkRecordOutcome = 'owner_verified' | 'lead_verified' | 'silence_accepted' | 'done' | 'rejected' | 'cancelled' | 'failed' | 'blocked' | 'waiting_owner';
+/** `final` closes the task; `blocked` is an interim record for a parked task. */
+export type WorkRecordPhase = 'final' | 'blocked';
+/** One party (asker, doer, helper). */
+export interface WorkRecordParty {
+    kind: WorkRecordPartyKind;
+    /** Display name (`Owen`, `the owner`, `schedule "Daily ops"`). */
+    name: string;
+    /** Agent session when the party is an agent. */
+    session?: string;
+}
+/** Someone pulled in while the task ran. */
+export interface WorkRecordHelper {
+    how: 'delegated' | 'asked' | 'reviewed';
+    name: string;
+    session?: string;
+    /** Delegated sub-task title. */
+    what?: string;
+    /** What came back (`done`, `rejected`, `answered`, `no answer`). */
+    back?: string;
+}
+/** An error met on the way. */
+export interface WorkRecordError {
+    what: string;
+    resolved: 'fixed' | 'unresolved' | 'unknown';
+}
+/** The assembled record. */
+export interface WorkRecord {
+    workItemId: string;
+    phase: WorkRecordPhase;
+    title: string;
+    askedBy: WorkRecordParty;
+    /** Where the ask came from, when known (`Slack thread`, `chat`, `app comment`). */
+    askedWhere?: string;
+    /** The person the asker acted for (an owner-origin delegation by a lead). */
+    forOwner: boolean;
+    askQuote: string;
+    doneBy: WorkRecordParty;
+    did: string;
+    outputs: string[];
+    errors: WorkRecordError[];
+    helpers: WorkRecordHelper[];
+    outcome: WorkRecordOutcome;
+    /** Who decided the outcome (reviewer, owner), display name. */
+    outcomeBy?: string;
+    /** Cancel / block / rejection reason. */
+    outcomeNote?: string;
+    endedAt: string;
+    durationMs?: number;
+    /** Machine-readable fields for the digest (ticket ids live here only). */
+    meta: Record<string, string>;
+}
+/** Everything the assembler needs, already loaded. */
+export interface WorkRecordInputs {
+    workItem: WorkItem;
+    phase: WorkRecordPhase;
+    /** Linked project ticket (`metadata.projectTicket`), when found. */
+    ticket?: ProjectTicket | null;
+    /** Linked Request (`workItem.requestId`), when found. */
+    request?: Request | null;
+    /** Child items: delegations and the verify item. */
+    children?: readonly WorkItem[];
+    /** The run trace's events, when a trace exists. */
+    trace?: readonly TraceEvent[];
+    /** Facts from the doer's transcript for the task window. */
+    transcript?: TranscriptWindowFacts | null;
+    /** Display name of an agent session. */
+    nameOf: (session: string) => string;
+    /** Party kind of an agent session (`lead`, `orchestrator`, `agent`). */
+    kindOf: (session: string) => WorkRecordPartyKind;
+    /** Ticket prefixes to strip from owner-facing text (`CE`, `CREW`). */
+    ticketPrefixes?: readonly string[];
+    /** Clock. */
+    now?: number;
+}
+/**
+ * `work-record:<workItemId>#<phase>` — the entry's `ref:` and its dedupe key.
+ *
+ * @param workItemId - WorkItem id
+ * @param phase - Record phase
+ * @returns Stable ref
+ */
+export declare function workRecordRef(workItemId: string, phase: WorkRecordPhase): string;
+/**
+ * Parse a record ref back into its parts.
+ *
+ * @param ref - `ref:` value
+ * @returns Parts, or null when it is not a record ref
+ */
+export declare function parseWorkRecordRef(ref: string): {
+    workItemId: string;
+    phase: WorkRecordPhase;
+} | null;
+/**
+ * Whether a log entry is a work record.
+ *
+ * @param entry - Parsed log entry
+ * @returns True for `work_record` entries (by source type or ref)
+ */
+export declare function isWorkRecordEntry(entry: Pick<WikiLogEntryRecord, 'sourceType' | 'ref'>): boolean;
+/**
+ * Whether a WorkItem is the verify item of another (`<id>:verify:<id>` or
+ * `metadata.verifyOf`). Verify items are folded into the parent's record.
+ *
+ * @param wi - WorkItem
+ * @returns True for a verify item
+ */
+export declare function isVerifyWorkItem(wi: Pick<WorkItem, 'id' | 'metadata' | 'type'>): boolean;
+/**
+ * Whether a WorkItem gets a record at all: real work, not a verify item or a
+ * bookkeeping type.
+ *
+ * @param wi - WorkItem
+ * @returns True when the item is recordable
+ */
+export declare function isRecordableWorkItem(wi: Pick<WorkItem, 'id' | 'metadata' | 'type'>): boolean;
+/**
+ * The moment an item stopped: `completedAt`, else `statusChangedAt`, else
+ * `createdAt`.
+ *
+ * @param wi - WorkItem
+ * @returns ISO time
+ */
+export declare function workItemEndedAt(wi: Pick<WorkItem, 'completedAt' | 'statusChangedAt' | 'createdAt'>): string;
+/**
+ * Owner-facing text: ticket ids, WorkItem ids and uuids removed, whitespace
+ * collapsed, clipped.
+ *
+ * @param text - Raw text
+ * @param prefixes - Ticket prefixes to strip
+ * @param max - Character cap
+ * @returns Clean one-line text
+ */
+export declare function cleanOwnerText(text: string | undefined | null, prefixes?: readonly string[], max?: number): string;
+/**
+ * Clip to `max` characters with an ellipsis.
+ *
+ * @param text - Text
+ * @param max - Cap
+ * @returns Clipped text
+ */
+export declare function clip(text: string, max: number): string;
+/**
+ * Assemble a record from loaded inputs. Pure.
+ *
+ * @param inputs - WorkItem, links, trace, transcript facts and name resolvers
+ * @returns The record
+ *
+ * @example
+ * ```typescript
+ * const record = assembleWorkRecord({ workItem, phase: 'final', ticket, children, trace, nameOf, kindOf });
+ * const body = renderWorkRecordBody(record);
+ * ```
+ */
+export declare function assembleWorkRecord(inputs: WorkRecordInputs): WorkRecord;
+/**
+ * Render a record as the log body. Always fits `MAX_CHARS`; the `meta:` line
+ * is never cut.
+ *
+ * @param record - Assembled record
+ * @returns Markdown body
+ */
+export declare function renderWorkRecordBody(record: WorkRecord): string;
+/** A record as read back from a log body. */
+export interface ParsedWorkRecord {
+    title: string;
+    askedBy: string;
+    doneBy: string;
+    did: string;
+    outputs: string[];
+    errors: string[];
+    helpers: Array<{
+        how: 'delegated' | 'asked' | 'reviewed';
+        name: string;
+        rest: string;
+    }>;
+    outcome: string;
+    meta: Record<string, string>;
+}
+/**
+ * Parse a record body written by {@link renderWorkRecordBody}.
+ *
+ * @param body - Log entry body
+ * @returns The fields, or null when the body is not a record
+ */
+export declare function parseWorkRecordBody(body: string): ParsedWorkRecord | null;
+/**
+ * One-line form of a record for the startup briefing and the digest.
+ *
+ * @param parsed - Parsed record
+ * @param max - Character cap
+ * @returns `**Title** — asked by X, done by Y → outcome`
+ */
+export declare function shortWorkRecordLine(parsed: ParsedWorkRecord, max?: number): string;
+/**
+ * The outcome phrase used in the headline and the `outcome:` line.
+ *
+ * @param record - Record
+ * @returns Owner-facing phrase
+ */
+export declare function outcomePhrase(record: Pick<WorkRecord, 'outcome' | 'outcomeBy'>): string;
+//# sourceMappingURL=work-record.d.ts.map

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

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