crewly 1.20.184 → 1.20.185

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

@@ -30,8 +30,22 @@ import * as fs from 'fs/promises';
 import { existsSync } from 'fs';
 import { randomUUID } from 'crypto';
 import { LoggerService } from '../core/logger.service.js';
+import { WIKI_QUEUE_CONSTANTS } from '../../constants.js';
+/**
+ * Canonical form of a vault path, so `/p/.crewly/wiki/` and
+ * `/p/.crewly/wiki` (or a path with `..`) name the same vault. Queue
+ * filters used to compare the raw strings; an item stored with a trailing
+ * slash never matched the discovered vault and was never drained (#914).
+ *
+ * @param vaultPath - Absolute vault path as given by a caller
+ * @returns The resolved path without a trailing separator
+ */
+export function normalizeVaultPath(vaultPath) {
+    return path.resolve(vaultPath);
+}
 const MAX_CONTENT_BYTES = 64 * 1024;
 const MAX_REASON_BYTES = 2 * 1024;
+const MS_PER_DAY = 24 * 60 * 60 * 1000;
 /**
  * File-backed queue. Stateless other than the on-disk JSONs and an
  * in-memory cache of the root directory. Singleton because all writes
@@ -68,7 +82,7 @@ export class WikiQueueService {
         await this.ensureRoot();
         const item = {
             id: randomUUID(),
-            vaultPath: input.vaultPath,
+            vaultPath: normalizeVaultPath(input.vaultPath),
             queuedAt: new Date().toISOString(),
             queuedBy: input.queuedBy,
             sourceType: input.sourceType,
@@ -87,27 +101,26 @@ export class WikiQueueService {
         });
         return item;
     }
-    /** List items, newest-first, optionally filtered. */
+    /**
+     * List items, optionally filtered. Newest-first unless `order: 'oldest'`.
+     * Vault paths are compared in normalised form (see {@link normalizeVaultPath}).
+     *
+     * @param filter - Vault / status / author filters, limit and order
+     * @returns Matching items, sorted and capped
+     */
     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));
+        const wantVault = filter.vaultPath ? normalizeVaultPath(filter.vaultPath) : null;
+        const items = (await this.readAll()).filter((item) => (!wantVault || normalizeVaultPath(item.vaultPath) === wantVault) &&
+            (!filter.status || item.status === filter.status) &&
+            (!filter.queuedBy || item.queuedBy === filter.queuedBy));
+        const oldestFirst = filter.order === 'oldest';
+        items.sort((a, b) => {
+            if (a.queuedAt === b.queuedAt)
+                return 0;
+            const aFirst = oldestFirst ? a.queuedAt < b.queuedAt : a.queuedAt > b.queuedAt;
+            return aFirst ? -1 : 1;
+        });
         return items.slice(0, limit);
     }
     /** Fetch one by id. Returns null when missing. */
@@ -186,12 +199,100 @@ export class WikiQueueService {
             processed: 0,
             skipped: 0,
             total: items.length,
+            oldestPendingQueuedAt: null,
         };
         for (const it of items) {
             counts[it.status]++;
+            if (it.status === 'pending' &&
+                (counts.oldestPendingQueuedAt === null || it.queuedAt < counts.oldestPendingQueuedAt)) {
+                counts.oldestPendingQueuedAt = it.queuedAt;
+            }
         }
         return counts;
     }
+    /**
+     * Housekeeping pass over the whole queue (#914). One read of the
+     * directory does three things:
+     *
+     *   1. A `claimed` item whose claim is older than `claimTimeoutMs` goes
+     *      back to `pending` — the agent that claimed it died or forgot to
+     *      call process/skip, and nothing else would ever release it.
+     *   2. A `pending`/`claimed` item queued longer ago than `maxItemAgeMs`
+     *      moves to `<root>/dead-letter/<id>.json` with `expiredAt` +
+     *      `expireReason`. Never deleted; one warn line per item.
+     *   3. Reports the remaining pending backlog per vault (count + oldest
+     *      `queuedAt`) so the caller can alert on stale vaults and on items
+     *      whose vault is not discovered.
+     *
+     * Processed/skipped items are left alone (they are the audit trail).
+     *
+     * @param opts - Clock and age thresholds (defaults from WIKI_QUEUE_CONSTANTS)
+     * @returns Expired items, released claim ids and per-vault backlog
+     *
+     * @example
+     * ```typescript
+     * const { expired, backlog } = await WikiQueueService.getInstance().sweep();
+     * ```
+     */
+    async sweep(opts = {}) {
+        const now = opts.now ?? Date.now();
+        const maxAge = opts.maxItemAgeMs ?? WIKI_QUEUE_CONSTANTS.MAX_ITEM_AGE_MS;
+        const claimTimeout = opts.claimTimeoutMs ?? WIKI_QUEUE_CONSTANTS.CLAIM_TIMEOUT_MS;
+        const result = { expired: [], releasedClaims: [], backlog: [] };
+        const backlog = new Map();
+        for (const item of await this.readAll()) {
+            if (item.status !== 'pending' && item.status !== 'claimed')
+                continue;
+            const queuedMs = Date.parse(item.queuedAt);
+            if (Number.isFinite(queuedMs) && now - queuedMs > maxAge) {
+                await this.deadLetter(item, now, queuedMs);
+                result.expired.push(item);
+                continue;
+            }
+            let current = item;
+            if (item.status === 'claimed') {
+                const claimedMs = Date.parse(item.claimedAt ?? '');
+                if (Number.isFinite(claimedMs) && now - claimedMs <= claimTimeout)
+                    continue;
+                current = { ...item, status: 'pending', claimedBy: undefined, claimedAt: undefined };
+                await this.writeItem(current);
+                result.releasedClaims.push(item.id);
+                this.logger.warn('WikiQueue claim released — claimant never processed or skipped it', {
+                    id: item.id,
+                    vaultPath: item.vaultPath,
+                    claimedBy: item.claimedBy,
+                    claimedAt: item.claimedAt,
+                });
+            }
+            const vaultPath = normalizeVaultPath(current.vaultPath);
+            const entry = backlog.get(vaultPath);
+            if (!entry) {
+                backlog.set(vaultPath, { vaultPath, pending: 1, oldestQueuedAt: current.queuedAt });
+            }
+            else {
+                entry.pending++;
+                if (current.queuedAt < entry.oldestQueuedAt)
+                    entry.oldestQueuedAt = current.queuedAt;
+            }
+        }
+        result.backlog = [...backlog.values()].sort((a, b) => a.vaultPath.localeCompare(b.vaultPath));
+        if (result.expired.length > 0 || result.releasedClaims.length > 0) {
+            this.logger.warn('WikiQueue sweep', {
+                expired: result.expired.length,
+                releasedClaims: result.releasedClaims.length,
+                deadLetterDir: this.getDeadLetterDir(),
+            });
+        }
+        return result;
+    }
+    /**
+     * Folder that holds expired items.
+     *
+     * @returns Absolute path of the dead-letter folder
+     */
+    getDeadLetterDir() {
+        return path.join(this.rootDir, WIKI_QUEUE_CONSTANTS.DEAD_LETTER_DIR);
+    }
     // ---------------------------------------------------------------------------
     // Internals
     // ---------------------------------------------------------------------------
@@ -220,6 +321,56 @@ export class WikiQueueService {
             throw new Error(`WikiQueue.add: reason exceeds ${MAX_REASON_BYTES} bytes`);
         }
     }
+    /**
+     * Read every well-formed item in the queue root (not the dead-letter
+     * folder — `readdir` is not recursive).
+     *
+     * @returns All items, unsorted
+     */
+    async readAll() {
+        await this.ensureRoot();
+        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)
+                items.push(item);
+        }
+        return items;
+    }
+    /**
+     * Move one item to the dead-letter folder, stamped with why. Written
+     * there first, then removed from the queue, so a crash in between
+     * leaves a duplicate rather than a loss.
+     *
+     * @param item - Item to expire
+     * @param now - Current epoch ms
+     * @param queuedMs - Item's `queuedAt` in epoch ms
+     */
+    async deadLetter(item, now, queuedMs) {
+        const ageDays = Math.floor((now - queuedMs) / MS_PER_DAY);
+        const expired = {
+            ...item,
+            expiredAt: new Date(now).toISOString(),
+            expireReason: `still ${item.status} after ${ageDays} days`,
+        };
+        const dir = this.getDeadLetterDir();
+        await fs.mkdir(dir, { recursive: true });
+        const target = path.join(dir, `${item.id}.json`);
+        await fs.writeFile(`${target}.tmp`, JSON.stringify(expired, null, 2), 'utf8');
+        await fs.rename(`${target}.tmp`, target);
+        await fs.rm(path.join(this.rootDir, `${item.id}.json`), { force: true });
+        this.logger.warn('WikiQueue item expired to dead-letter', {
+            id: item.id,
+            vaultPath: item.vaultPath,
+            status: item.status,
+            queuedAt: item.queuedAt,
+            ageDays,
+            file: target,
+        });
+    }
     async ensureRoot() {
         if (this.initPromise) {
             await this.initPromise;

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

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

@@ -89,6 +89,24 @@ export interface WikiWorkItemBridgeOptions {
     cleanupService?: WikiCleanupService;
     /** Task pool override (test seam). */
     taskPool?: TaskPoolService;
+    /**
+     * Absolute path of `config/skills/orchestrator`. Substituted for
+     * `{{ORCHESTRATOR_SKILLS_PATH}}` in WI briefs: a brief is read raw by
+     * whoever claims it (poll-tasks), and since drains route to team leaders
+     * — whose prompts never define that placeholder — the literal string
+     * was all they got to run (#914). Null/omitted leaves it as-is.
+     */
+    orchestratorSkillsPath?: string | null;
+    /**
+     * Owner notification for a stale queue (oldest pending item older than
+     * {@link WIKI_QUEUE_CONSTANTS.STALE_ALERT_AGE_MS}). Boot wires the Slack
+     * owner notification, like auto-update. Omitted → warn log only.
+     */
+    notifyOwner?: (title: string, message: string) => Promise<unknown>;
+    /** Queue max item age override (default {@link WIKI_QUEUE_CONSTANTS.MAX_ITEM_AGE_MS}). */
+    maxItemAgeMs?: number;
+    /** Stale-alert age override (default {@link WIKI_QUEUE_CONSTANTS.STALE_ALERT_AGE_MS}). */
+    staleAlertAgeMs?: number;
 }
 export interface WikiBridgeTickResult {
     scannedVaults: string[];
@@ -103,6 +121,14 @@ export interface WikiBridgeTickResult {
     skippedByCooldown: string[];
     /** Vault paths for which a cleanup WI was created this tick. */
     createdCleanupForVault: string[];
+    /** Queue items moved to dead-letter by this tick's sweep. */
+    expiredQueueItems: number;
+    /** Abandoned claims released back to pending by this tick's sweep. */
+    releasedQueueClaims: number;
+    /** Vault paths with pending items that discovery does not return (never drained). */
+    orphanQueueVaults: string[];
+    /** Vault paths whose oldest pending item is older than the stale-alert age. */
+    staleQueueVaults: string[];
 }
 /**
  * Periodic bridge: pending wiki queue items + migration candidates
@@ -144,6 +170,12 @@ export declare class WikiWorkItemBridgeService {
     private readonly statePath;
     /** True after `loadStateFromDisk` has either populated or no-op'd. */
     private stateLoaded;
+    private readonly orchestratorSkillsPath;
+    private readonly notifyOwner;
+    private readonly maxItemAgeMs;
+    private readonly staleAlertAgeMs;
+    /** vaultPath → epoch ms of the last stale-queue owner alert. */
+    private readonly lastStaleAlertAt;
     constructor(opts?: WikiWorkItemBridgeOptions);
     /**
      * Hydrate {@link lastCreatedAt} from disk. Idempotent — runs once per
@@ -194,6 +226,34 @@ export declare class WikiWorkItemBridgeService {
      * terminal — i.e. it's still queued/claimed/running/etc.
      */
     private snapshotInflight;
+    /**
+     * Queue housekeeping at the start of each tick (#914): release abandoned
+     * claims, dead-letter items past the max age, warn about pending items
+     * whose vault discovery does not return (nothing would ever drain them),
+     * and alert the owner when a vault's oldest pending item is older than
+     * the stale-alert age. Failures are logged and never abort the tick.
+     *
+     * @param vaults - Vault paths discovery returned this tick
+     * @param result - Tick result to fill in
+     */
+    private sweepQueue;
+    /**
+     * Report one stale vault: a warn log line always, plus the owner
+     * notification when one is wired.
+     *
+     * @param backlog - The vault's pending backlog
+     * @param ageMs - Age of its oldest pending item
+     * @param orphan - True when discovery does not return the vault
+     */
+    private alertStaleQueue;
+    /**
+     * Fill in placeholders a WI brief carries, since the claimant reads the
+     * brief raw. See {@link WikiWorkItemBridgeOptions.orchestratorSkillsPath}.
+     *
+     * @param brief - Brief markdown with `{{ORCHESTRATOR_SKILLS_PATH}}`
+     * @returns The brief with the path filled in, or unchanged when unknown
+     */
+    private resolveBrief;
     /**
      * The session that should do a vault's wiki work: the resolver's answer
      * (a team leader) or the fallback target.

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

@@ -1 +1 @@
-{"version":3,"file":"wiki-workitem-bridge.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-workitem-bridge.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wiki-workitem-bridge.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/wiki/wiki-workitem-bridge.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAsB,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAkE/D;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAYD,sEAAsE;AACtE,eAAO,MAAM,oBAAoB,EAAG,kBAA2B,CAAC;AAChE,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB,EAAG,qBAA8B,CAAC;AACrE,wFAAwF;AACxF,eAAO,MAAM,sBAAsB,EAAG,sBAA+B,CAAC;AA6BtE,MAAM,WAAW,yBAAyB;IACxC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CAAC,sBAAsB,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3E;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACxC,8EAA8E;IAC9E,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/C,+CAA+C;IAC/C,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,iDAAiD;IACjD,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,iDAAiD;IACjD,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC,sCAAsC;IACtC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC;;;;OAIG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE,0FAA0F;IAC1F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0FAA0F;IAC1F,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAClC,kIAAkI;IAClI,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,oEAAoE;IACpE,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,gEAAgE;IAChE,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,6DAA6D;IAC7D,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qFAAqF;IACrF,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,+EAA+E;IAC/E,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;GAGG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsE;IACpG,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;IACxD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA0B;IAC/D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAkB;IACvC,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,OAAO,CAAS;IACxB,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6B;IAC3D;;;;;;;;;OASG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IACjE,sDAAsD;IACtD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,wEAAwE;IACxE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,sEAAsE;IACtE,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAgB;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgE;IAC5F,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,gEAAgE;IAChE,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;gBAElD,IAAI,GAAE,yBAA8B;IA2BhD;;;OAGG;YACW,iBAAiB;IA8C/B;;;;OAIG;YACW,eAAe;IAqC7B;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAMrB;;;;;;;OAOG;IACH,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAMxC;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAiBnB,MAAM,CAAC,WAAW,IAAI,yBAAyB,GAAG,IAAI;IAItD,8CAA8C;IAC9C,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,yBAAyB,GAAG,IAAI,GAAG,IAAI;IAKhE,oEAAoE;IACpE,KAAK,IAAI,IAAI;IAiBb,IAAI,IAAI,IAAI;IAOZ,sEAAsE;IAChE,IAAI,IAAI,OAAO,CAAC,oBAAoB,CAAC;IA2L3C;;;;OAIG;YACW,gBAAgB;IA8B9B;;;;;;;;;OASG;YACW,UAAU;IAmCxB;;;;;;;OAOG;YACW,eAAe;IAgC7B;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAKpB;;;;;;OAMG;YACW,SAAS;YAST,mBAAmB;YA2BnB,qBAAqB;YAuCrB,qBAAqB;CAyBpC;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAU5D;AAiGD;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAsB7D"}

package/dist/backend/backend/src/services/wiki/wiki-workitem-bridge.service.js

@@ -30,7 +30,7 @@ import path from 'path';
 import { existsSync, promises as fs } from 'fs';
 import { LoggerService } from '../core/logger.service.js';
 import { TaskPoolService } from '../task-pool/task-pool.service.js';
-import { WikiQueueService } from './wiki-queue.service.js';
+import { WikiQueueService, normalizeVaultPath } from './wiki-queue.service.js';
 import { WikiMigrateService } from './wiki-migrate.service.js';
 import { WikiCleanupService } from './wiki-cleanup.service.js';
 import { discoverWikiVaults } from './wiki-bookkeep-trigger.service.js';
@@ -38,7 +38,7 @@ import { isInsidePackageTree } from '../v3/mission-paths.js';
 import { createWorkItem } from '../../types/v2/work-item.types.js';
 import { atomicWriteJson, safeReadJson, ensureDir } from '../../utils/file-io.utils.js';
 import { getCrewlyHomePath } from '../core/crewly-home.utils.js';
-import { WIKI_KB_CONSTANTS } from '../../constants.js';
+import { WIKI_KB_CONSTANTS, WIKI_QUEUE_CONSTANTS } from '../../constants.js';
 // ---------------------------------------------------------------------------
 // Constants
 // ---------------------------------------------------------------------------
@@ -157,6 +157,12 @@ export class WikiWorkItemBridgeService {
     statePath;
     /** True after `loadStateFromDisk` has either populated or no-op'd. */
     stateLoaded = false;
+    orchestratorSkillsPath;
+    notifyOwner;
+    maxItemAgeMs;
+    staleAlertAgeMs;
+    /** vaultPath → epoch ms of the last stale-queue owner alert. */
+    lastStaleAlertAt = new Map();
     constructor(opts = {}) {
         this.logger = LoggerService.getInstance().createComponentLogger('WikiWorkItemBridge');
         this.intervalMs = opts.intervalMs ?? DEFAULT_INTERVAL_MS;
@@ -171,6 +177,10 @@ export class WikiWorkItemBridgeService {
         this.migrate = opts.migrateService ?? WikiMigrateService.getInstance();
         this.cleanup = opts.cleanupService ?? WikiCleanupService.getInstance();
         this.pool = opts.taskPool ?? TaskPoolService.getInstance();
+        this.orchestratorSkillsPath = opts.orchestratorSkillsPath ?? null;
+        this.notifyOwner = opts.notifyOwner ?? null;
+        this.maxItemAgeMs = opts.maxItemAgeMs ?? WIKI_QUEUE_CONSTANTS.MAX_ITEM_AGE_MS;
+        this.staleAlertAgeMs = opts.staleAlertAgeMs ?? WIKI_QUEUE_CONSTANTS.STALE_ALERT_AGE_MS;
         if (opts.statePath === null) {
             this.statePath = null;
         }
@@ -367,6 +377,10 @@ export class WikiWorkItemBridgeService {
             deferredByThrottle: [],
             skippedByCooldown: [],
             createdCleanupForVault: [],
+            expiredQueueItems: 0,
+            releasedQueueClaims: 0,
+            orphanQueueVaults: [],
+            staleQueueVaults: [],
         };
         if (this.running) {
             // Overlapping ticks would create duplicates; the dedupe pass below
@@ -381,6 +395,7 @@ export class WikiWorkItemBridgeService {
             const { inflightVaults, inflightProjects, inflightCleanupVaults } = await this.snapshotInflight();
             // Drains come first — they're cheap, fast, and the most common case.
             const vaults = await this.discoverRoots();
+            await this.sweepQueue(vaults, result);
             for (const vaultPath of vaults) {
                 result.scannedVaults.push(vaultPath);
                 if (inflightVaults.has(vaultPath)) {
@@ -393,10 +408,14 @@ export class WikiWorkItemBridgeService {
                     continue;
                 }
                 try {
+                    // Uncapped (#914): with `limit: 200` a vault holding ≥ 200 pending
+                    // items reported 200 every time, so every drain WI looked like
+                    // "no progress" and the cooldown climbed to 24h even while the
+                    // agent was draining.
                     const pending = await this.queue.list({
                         vaultPath,
                         status: 'pending',
-                        limit: 200,
+                        limit: Number.MAX_SAFE_INTEGER,
                     });
                     if (pending.length === 0)
                         continue;
@@ -410,7 +429,7 @@ export class WikiWorkItemBridgeService {
                     createdThisTick++;
                 }
                 catch (err) {
-                    this.logger.debug('queue.list / drain WI create failed (non-fatal)', {
+                    this.logger.warn('queue.list / drain WI create failed (non-fatal)', {
                         vaultPath,
                         error: err.message,
                     });
@@ -569,6 +588,101 @@ export class WikiWorkItemBridgeService {
         }
         return { inflightVaults, inflightProjects, inflightCleanupVaults };
     }
+    /**
+     * Queue housekeeping at the start of each tick (#914): release abandoned
+     * claims, dead-letter items past the max age, warn about pending items
+     * whose vault discovery does not return (nothing would ever drain them),
+     * and alert the owner when a vault's oldest pending item is older than
+     * the stale-alert age. Failures are logged and never abort the tick.
+     *
+     * @param vaults - Vault paths discovery returned this tick
+     * @param result - Tick result to fill in
+     */
+    async sweepQueue(vaults, result) {
+        const now = this.nowFn();
+        let sweep;
+        try {
+            sweep = await this.queue.sweep({ now, maxItemAgeMs: this.maxItemAgeMs });
+        }
+        catch (err) {
+            this.logger.warn('Wiki queue sweep failed (non-fatal)', { error: err.message });
+            return;
+        }
+        result.expiredQueueItems = sweep.expired.length;
+        result.releasedQueueClaims = sweep.releasedClaims.length;
+        const discovered = new Set(vaults.map(normalizeVaultPath));
+        for (const backlog of sweep.backlog) {
+            if (!discovered.has(backlog.vaultPath)) {
+                result.orphanQueueVaults.push(backlog.vaultPath);
+                if (!this.exhaustedWarned.has(`orphan:${backlog.vaultPath}`)) {
+                    this.exhaustedWarned.add(`orphan:${backlog.vaultPath}`);
+                    this.logger.warn('Wiki queue has pending items for a vault the bridge does not discover — no drain WI will be created for them', {
+                        vaultPath: backlog.vaultPath,
+                        pending: backlog.pending,
+                        oldestQueuedAt: backlog.oldestQueuedAt,
+                        hint: 'the vault needs a SCHEMA.md and its project must be in ~/.crewly/projects.json; otherwise the items expire to the dead-letter folder',
+                    });
+                }
+            }
+            const ageMs = now - Date.parse(backlog.oldestQueuedAt);
+            if (!(ageMs > this.staleAlertAgeMs))
+                continue;
+            result.staleQueueVaults.push(backlog.vaultPath);
+            const last = this.lastStaleAlertAt.get(backlog.vaultPath);
+            if (last !== undefined && now - last < WIKI_QUEUE_CONSTANTS.STALE_ALERT_COOLDOWN_MS)
+                continue;
+            this.lastStaleAlertAt.set(backlog.vaultPath, now);
+            await this.alertStaleQueue(backlog, ageMs, !discovered.has(backlog.vaultPath));
+        }
+    }
+    /**
+     * Report one stale vault: a warn log line always, plus the owner
+     * notification when one is wired.
+     *
+     * @param backlog - The vault's pending backlog
+     * @param ageMs - Age of its oldest pending item
+     * @param orphan - True when discovery does not return the vault
+     */
+    async alertStaleQueue(backlog, ageMs, orphan) {
+        const ageDays = Math.floor(ageMs / (24 * 60 * 60 * 1000));
+        const expireDays = Math.round(this.maxItemAgeMs / (24 * 60 * 60 * 1000));
+        const scope = describeVaultScope(backlog.vaultPath);
+        const message = `${backlog.pending} wiki queue item(s) for ${scope} are waiting; the oldest was queued ${ageDays} days ago (${backlog.oldestQueuedAt}). ` +
+            (orphan
+                ? 'This vault is not discovered (no SCHEMA.md or project not registered), so nothing will process them. '
+                : 'The drain WorkItems are not keeping up — check that the vault owner is claiming and finishing them. ') +
+            `Items older than ${expireDays} days move to ~/.crewly/wiki-queue/${WIKI_QUEUE_CONSTANTS.DEAD_LETTER_DIR}/.`;
+        this.logger.warn('Wiki queue is stale', {
+            vaultPath: backlog.vaultPath,
+            pending: backlog.pending,
+            oldestQueuedAt: backlog.oldestQueuedAt,
+            ageDays,
+            orphan,
+        });
+        if (!this.notifyOwner)
+            return;
+        try {
+            await this.notifyOwner('Wiki queue backlog', message);
+        }
+        catch (err) {
+            this.logger.warn('Stale wiki queue notification failed (non-fatal)', {
+                vaultPath: backlog.vaultPath,
+                error: err.message,
+            });
+        }
+    }
+    /**
+     * Fill in placeholders a WI brief carries, since the claimant reads the
+     * brief raw. See {@link WikiWorkItemBridgeOptions.orchestratorSkillsPath}.
+     *
+     * @param brief - Brief markdown with `{{ORCHESTRATOR_SKILLS_PATH}}`
+     * @returns The brief with the path filled in, or unchanged when unknown
+     */
+    resolveBrief(brief) {
+        if (!this.orchestratorSkillsPath)
+            return brief;
+        return brief.replace(/\{\{ORCHESTRATOR_SKILLS_PATH\}\}/g, this.orchestratorSkillsPath);
+    }
     /**
      * The session that should do a vault's wiki work: the resolver's answer
      * (a team leader) or the fallback target.
@@ -595,7 +709,7 @@ export class WikiWorkItemBridgeService {
             target,
             title: `Drain ${pendingCount} wiki queue item(s) — ${scope}`,
             description: `Process ${pendingCount} pending wiki queue items in ${vaultPath}.`,
-            briefMarkdown: drainBrief(vaultPath, pendingCount),
+            briefMarkdown: this.resolveBrief(drainBrief(vaultPath, pendingCount)),
             maxRetries: 1,
             metadata: {
                 kind: META_KIND_WIKI_DRAIN,
@@ -621,7 +735,7 @@ export class WikiWorkItemBridgeService {
             target,
             title: `Cleanup ${chunk.length} of ${totalCandidates} low-quality wiki page(s) — ${scope}`,
             description: `Review ${chunk.length} cleanup candidates in ${vaultPath}; decide keep/delete; call wiki-cleanup --apply with the final list.`,
-            briefMarkdown: cleanupBrief(vaultPath, chunk, totalCandidates),
+            briefMarkdown: this.resolveBrief(cleanupBrief(vaultPath, chunk, totalCandidates)),
             maxRetries: 1,
             metadata: {
                 kind: META_KIND_WIKI_CLEANUP,
@@ -654,7 +768,7 @@ export class WikiWorkItemBridgeService {
             target,
             title: `Migrate ${proposedCount} legacy wiki item(s) — ${path.basename(projectRoot)}`,
             description: `Apply wiki-migrate for ${projectRoot} (${proposedCount} new pages).`,
-            briefMarkdown: migrateBrief(projectRoot, proposedCount),
+            briefMarkdown: this.resolveBrief(migrateBrief(projectRoot, proposedCount)),
             maxRetries: 1,
             metadata: {
                 kind: META_KIND_WIKI_MIGRATE,