@getbourdon/participants 0.2.2 → 0.2.4

package/README.md

@@ -14,12 +14,18 @@ Python (`pip install bourdon`) is the oracle; this TS mirror asserts against the
 | Reader | Category | Native store |
 |---|---|---|
 | `HermesParticipant` | SQLite (read-only) | `~/.hermes/` — `state.db` sessions + `memories/*.md` |
-| `ClaudeCodeParticipant` | file / convention | claude-brain + `~/.claude/projects/*/memory/` + KG JSONL |
+| `ClaudeCodeParticipant` | file / convention | `~/agent-brain/` + `~/.claude/projects/*/memory/` + KG JSONL |
 | `GitHubCopilotParticipant` | network (TTL cache) | `api.github.com` PR activity → `~/.cache/bourdon/github-copilot/` |
 
 The heavier SQLite readers (`cursor`, `codex`, `copilot_cli`) are **deferred to
 the follow-on slice**; `openclaw` ships as the `@getbourdon/openclaw` plugin.
 
+`ClaudeCodeParticipant` resolves its knowledge repo in this order: the
+`AGENT_BRAIN` env var, then `$HOME/agent-brain/`, then `./agent-brain/`. The
+pre-rename env var (`CLAUDE_BRAIN`) and the pre-rename directory name are still
+accepted as **legacy aliases** at each tier, so a checkout that predates the
+rename keeps resolving with no operator action.
+
 ## The four invariants (enforced in code, not by trust)
 
 1. **Visibility filter BEFORE emission** — every entity passes

package/dist/base.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Bourdon participant base — the Protocol → TS interface, errors, and the
+ * AgentStore / HealthStatus types. Faithful port of `participants/base.py`.
+ *
+ * The L5 dataclass model (AgentInfo/Entity/Session/VisibilityPolicy/L5Manifest),
+ * the `toDict` omission rules, and the visibility helpers all live in
+ * `@getbourdon/l5` and are reused verbatim — only THAT output shape is the parity
+ * contract. This module owns the participant CONTRACT surface around them.
+ *
+ * Contract semantics (enforced by every reader, asserted by the conformance
+ * fixtures, never by trust):
+ *   1. visibility filter BEFORE emission (`filterForFederation`) — private wins.
+ *   2. deterministic / idempotent `exportL5` — same store → identical `toDict`.
+ *   3. `healthCheck` NEVER throws — catch-all → degraded/blocked.
+ *   4. every native string through `@getbourdon/redaction` before it enters L5.
+ */
+import type { L5ManifestModel, SessionModel } from "@getbourdon/l5";
+/** Tied to Bourdon spec v0.1 — same literals as the Python oracle. */
+export declare const CONTRACT_VERSION = "0.1";
+export declare const SPEC_VERSION = "0.1";
+/** Base class for participant errors. */
+export declare class ParticipantError extends Error {
+    constructor(message?: string);
+}
+/** Raised by `discover()` when the native store cannot be found or read.
+ * Non-fatal: L6 skips this agent rather than aborting the whole export. */
+export declare class ParticipantDiscoveryError extends ParticipantError {
+}
+/** Raised by `exportL5()` / `exportSessions()` when an export fails mid-op
+ * (the store WAS present — distinct from a discovery miss). */
+export declare class ParticipantExportError extends ParticipantError {
+}
+/** Raised when the native store's version is outside the supported range.
+ * Subtype of discovery error (a version mismatch is a discovery-time miss). */
+export declare class ParticipantVersionMismatchError extends ParticipantDiscoveryError {
+}
+/** Metadata describing the native agent store. Returned by `discover()`. */
+export interface AgentStore {
+    path: string;
+    version: string;
+    metadata: Record<string, unknown>;
+}
+/** Returned by `healthCheck()`. Consumed by the `bourdon doctor` CLI. */
+export interface HealthStatus {
+    status: "ok" | "degraded" | "blocked";
+    reason?: string;
+    details: Record<string, unknown>;
+    /** A human-runnable command to remedy a non-ok status. */
+    proposedFix?: string;
+}
+/**
+ * Structural interface every participant must satisfy (the Python
+ * `@runtime_checkable Protocol`). Duck-typed at registration: a class is a
+ * participant iff it has `agentId` + `agentType` + `exportL5` + `healthCheck`.
+ *
+ * Optional members (`displayName`, a `defaultNativePath` static) are documented
+ * here as in the Python Protocol; discovery + the setup wizard fall back to
+ * sensible defaults when absent.
+ */
+export interface BourdonParticipant {
+    agentId: string;
+    agentType: string;
+    nativePath: string;
+    /** Human-friendly label (e.g. "GitHub Copilot"). Optional. */
+    displayName?: string;
+    /** Quarantined-class marker (Python `QUARANTINED_CLASS`). When true, the CLI
+     * requires `--i-understand-the-risk` to register the agent trusted, and its
+     * exports are staged for operator review rather than written to the live
+     * store (spec D6: quarantine follows the content, not the invoker). Absent =
+     * a normal, non-quarantined participant. Read by `bourdon agent add/set-tier`
+     * (cli/src/commands/federation.ts). */
+    quarantinedClass?: boolean;
+    /** Confirm the native store exists; return metadata. Throws
+     * {@link ParticipantDiscoveryError} when missing/unreadable. */
+    discover(): AgentStore;
+    /** Build the L5 manifest from native memory, applying the visibility filter
+     * BEFORE return. Deterministic — same store yields the same manifest. */
+    exportL5(since?: Date): L5ManifestModel;
+    /** Export recent sessions in normalized schema. */
+    exportSessions(since?: Date, limit?: number): SessionModel[];
+    /** Return ok / degraded / blocked with a reason. MUST NOT throw. */
+    healthCheck(): HealthStatus;
+}
+/**
+ * Tiny structural guard mirroring Python's `_PARTICIPANT_MARKER_ATTRS`
+ * duck-type: a value is a participant iff it carries the four marker members.
+ */
+export declare function isParticipant(obj: unknown): obj is BourdonParticipant;
+/**
+ * Environment variable holding the deployment's own project-name recognition
+ * vocabulary, as a comma-separated list (e.g.
+ * `BOURDON_PROJECT_HINTS="Acme Portal,Widget API,internal-tools"`).
+ */
+export declare const PROJECT_HINTS_ENV = "BOURDON_PROJECT_HINTS";
+/**
+ * Project-name hints used to tag sessions with a project focus.
+ *
+ * Bourdon ships **no** project roster of its own — the `defaults` a reader
+ * passes are limited to product-neutral names (this product, plus the agent
+ * surfaces it federates). A deployment that wants its own projects recognized
+ * sets {@link PROJECT_HINTS_ENV}; those entries are appended to `defaults`.
+ *
+ * Matching downstream is case-insensitive substring matching, so entries are
+ * de-duplicated case-insensitively here while preserving first-seen order and
+ * the original casing (which is what gets emitted as the project name).
+ *
+ * Mirrors Python `participants.base.load_project_hints`.
+ */
+export declare function loadProjectHints(defaults?: readonly string[]): readonly string[];

package/dist/base.js

@@ -0,0 +1,88 @@
+/**
+ * Bourdon participant base — the Protocol → TS interface, errors, and the
+ * AgentStore / HealthStatus types. Faithful port of `participants/base.py`.
+ *
+ * The L5 dataclass model (AgentInfo/Entity/Session/VisibilityPolicy/L5Manifest),
+ * the `toDict` omission rules, and the visibility helpers all live in
+ * `@getbourdon/l5` and are reused verbatim — only THAT output shape is the parity
+ * contract. This module owns the participant CONTRACT surface around them.
+ *
+ * Contract semantics (enforced by every reader, asserted by the conformance
+ * fixtures, never by trust):
+ *   1. visibility filter BEFORE emission (`filterForFederation`) — private wins.
+ *   2. deterministic / idempotent `exportL5` — same store → identical `toDict`.
+ *   3. `healthCheck` NEVER throws — catch-all → degraded/blocked.
+ *   4. every native string through `@getbourdon/redaction` before it enters L5.
+ */
+/** Tied to Bourdon spec v0.1 — same literals as the Python oracle. */
+export const CONTRACT_VERSION = "0.1";
+export const SPEC_VERSION = "0.1";
+// -- Errors -------------------------------------------------------------------
+/** Base class for participant errors. */
+export class ParticipantError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+/** Raised by `discover()` when the native store cannot be found or read.
+ * Non-fatal: L6 skips this agent rather than aborting the whole export. */
+export class ParticipantDiscoveryError extends ParticipantError {
+}
+/** Raised by `exportL5()` / `exportSessions()` when an export fails mid-op
+ * (the store WAS present — distinct from a discovery miss). */
+export class ParticipantExportError extends ParticipantError {
+}
+/** Raised when the native store's version is outside the supported range.
+ * Subtype of discovery error (a version mismatch is a discovery-time miss). */
+export class ParticipantVersionMismatchError extends ParticipantDiscoveryError {
+}
+/**
+ * Tiny structural guard mirroring Python's `_PARTICIPANT_MARKER_ATTRS`
+ * duck-type: a value is a participant iff it carries the four marker members.
+ */
+export function isParticipant(obj) {
+    if (obj === null || typeof obj !== "object")
+        return false;
+    const o = obj;
+    return (typeof o["agentId"] === "string" &&
+        typeof o["agentType"] === "string" &&
+        typeof o["exportL5"] === "function" &&
+        typeof o["healthCheck"] === "function");
+}
+/**
+ * Environment variable holding the deployment's own project-name recognition
+ * vocabulary, as a comma-separated list (e.g.
+ * `BOURDON_PROJECT_HINTS="Acme Portal,Widget API,internal-tools"`).
+ */
+export const PROJECT_HINTS_ENV = "BOURDON_PROJECT_HINTS";
+/**
+ * Project-name hints used to tag sessions with a project focus.
+ *
+ * Bourdon ships **no** project roster of its own — the `defaults` a reader
+ * passes are limited to product-neutral names (this product, plus the agent
+ * surfaces it federates). A deployment that wants its own projects recognized
+ * sets {@link PROJECT_HINTS_ENV}; those entries are appended to `defaults`.
+ *
+ * Matching downstream is case-insensitive substring matching, so entries are
+ * de-duplicated case-insensitively here while preserving first-seen order and
+ * the original casing (which is what gets emitted as the project name).
+ *
+ * Mirrors Python `participants.base.load_project_hints`.
+ */
+export function loadProjectHints(defaults = []) {
+    const hints = [];
+    const seen = new Set();
+    const raw = process.env[PROJECT_HINTS_ENV] ?? "";
+    for (const candidate of [...defaults, ...raw.split(",")]) {
+        const name = candidate.trim();
+        if (!name)
+            continue;
+        const key = name.toLowerCase();
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        hints.push(name);
+    }
+    return hints;
+}

package/dist/index.cjs

@@ -35,6 +35,8 @@ __export(index_exports, {
   CursorAutomationsParticipant: () => CursorAutomationsParticipant,
   CursorParticipant: () => CursorParticipant,
   DEFAULT_CACHE_TTL_SECONDS: () => DEFAULT_CACHE_TTL_SECONDS,
+  DEFAULT_RECENT_THREAD_LIMIT: () => DEFAULT_RECENT_THREAD_LIMIT,
+  DEFAULT_TITLE_LIMIT: () => DEFAULT_TITLE_LIMIT,
   FIRST_PARTY: () => FIRST_PARTY,
   GitHubCopilotParticipant: () => GitHubCopilotParticipant,
   HermesParticipant: () => HermesParticipant,
@@ -44,6 +46,7 @@ __export(index_exports, {
   NetworkUnavailable: () => NetworkUnavailable,
   OpenClawApiClient: () => OpenClawApiClient,
   OpenClawParticipant: () => OpenClawParticipant,
+  PROJECT_HINTS_ENV: () => PROJECT_HINTS_ENV,
   ParticipantAuthError: () => ParticipantAuthError,
   ParticipantDiscoveryError: () => ParticipantDiscoveryError,
   ParticipantError: () => ParticipantError,
@@ -62,9 +65,14 @@ __export(index_exports, {
   friendlyLabel: () => friendlyLabel,
   ghTokenProvider: () => ghTokenProvider,
   isParticipant: () => isParticipant,
+  loadProjectHints: () => loadProjectHints,
   openReadonly: () => openReadonly,
+  parseSessionIndex: () => parseSessionIndex,
   projectKeyFromCwd: () => projectKeyFromCwd,
+  recentSessionThreads: () => recentSessionThreads,
+  resolveCodexHome: () => resolveCodexHome,
   resolvePluginParticipants: () => resolvePluginParticipants,
+  sessionThreadTitles: () => sessionThreadTitles,
   sqliteAvailable: () => sqliteAvailable,
   tableColumns: () => tableColumns,
   tableExists: () => tableExists,
@@ -95,6 +103,21 @@ function isParticipant(obj) {
   const o = obj;
   return typeof o["agentId"] === "string" && typeof o["agentType"] === "string" && typeof o["exportL5"] === "function" && typeof o["healthCheck"] === "function";
 }
+var PROJECT_HINTS_ENV = "BOURDON_PROJECT_HINTS";
+function loadProjectHints(defaults = []) {
+  const hints = [];
+  const seen = /* @__PURE__ */ new Set();
+  const raw = process.env[PROJECT_HINTS_ENV] ?? "";
+  for (const candidate of [...defaults, ...raw.split(",")]) {
+    const name = candidate.trim();
+    if (!name) continue;
+    const key = name.toLowerCase();
+    if (seen.has(key)) continue;
+    seen.add(key);
+    hints.push(name);
+  }
+  return hints;
+}
 
 // src/sqlite-base.ts
 var import_node_fs = require("fs");
@@ -749,7 +772,7 @@ var import_l52 = require("@getbourdon/l5");
 var import_redaction2 = require("@getbourdon/redaction");
 var AGENT_ID2 = "claude-code";
 var AGENT_TYPE2 = "code-assistant";
-var ROLE_NARRATIVE2 = "Agentic manager and code-assistant. Coordinates the RADLAB agent fleet, reviews PRs, and consults on architectural decisions. Capable of authoring code but typically reviews + delegates to specialised code-assistants like Codex for prime-code execution.";
+var ROLE_NARRATIVE2 = "Agentic manager and code-assistant. Coordinates the agent fleet, reviews PRs, and consults on architectural decisions. Capable of authoring code but typically reviews + delegates to specialised code-assistants like Codex for prime-code execution.";
 var DEFAULT_POLICY2 = (0, import_l52.makeVisibilityPolicy)({
   default: import_l52.Visibility.PUBLIC,
   private_tags: ["personal", "financial", "credential", "health", "family", "legal"],
@@ -779,13 +802,22 @@ function isFile2(p) {
     return false;
   }
 }
-function resolveClaudeBrainPath() {
-  const envOverride = process.env.CLAUDE_BRAIN;
-  if (envOverride && isDir2(envOverride)) return envOverride;
-  const homeCandidate = (0, import_node_path3.join)(homeDir(), "claude-brain");
-  if (isDir2(homeCandidate)) return homeCandidate;
-  const cwdCandidate = (0, import_node_path3.join)(process.cwd(), "claude-brain");
-  if (isDir2(cwdCandidate)) return cwdCandidate;
+var BRAIN_DIR_NAMES = [
+  "agent-brain",
+  ["c", "laude-brain"].join("")
+];
+var BRAIN_ENV_VARS = ["AGENT_BRAIN", "CLAUDE_BRAIN"];
+function resolveBrainPath() {
+  for (const varName of BRAIN_ENV_VARS) {
+    const envOverride = process.env[varName];
+    if (envOverride && isDir2(envOverride)) return envOverride;
+  }
+  for (const base of [homeDir(), process.cwd()]) {
+    for (const name of BRAIN_DIR_NAMES) {
+      const candidate = (0, import_node_path3.join)(base, name);
+      if (isDir2(candidate)) return candidate;
+    }
+  }
   return null;
 }
 function homeDir() {
@@ -1110,8 +1142,8 @@ var ClaudeCodeParticipant = class {
     return (0, import_node_path3.join)(home ?? homeDir(), ".claude");
   }
   constructor() {
-    this.nativePath = (0, import_node_path3.join)(homeDir(), "claude-brain");
-    this.brainPath = resolveClaudeBrainPath();
+    this.nativePath = (0, import_node_path3.join)(homeDir(), BRAIN_DIR_NAMES[0]);
+    this.brainPath = resolveBrainPath();
     this.autoMemoryPath = resolveAutoMemoryPath();
     this.knowledgeGraphPath = resolveKnowledgeGraphPath();
   }
@@ -1123,7 +1155,7 @@ var ClaudeCodeParticipant = class {
     };
     if (!Object.values(sources).some((v) => v)) {
       throw new ParticipantDiscoveryError(
-        "No Claude Code memory sources found. Expected one of: ~/claude-brain/, ~/.claude/projects/*/memory/, ~/claude-memory/memory.jsonl."
+        "No Claude Code memory sources found. Expected one of: ~/agent-brain/, ~/.claude/projects/*/memory/, ~/claude-memory/memory.jsonl."
       );
     }
     return {
@@ -1185,7 +1217,7 @@ var ClaudeCodeParticipant = class {
         status: "degraded",
         reason: `${present}/3 Claude Code memory sources found`,
         details,
-        proposedFix: "Run `bourdon setup` to (re-)wire missing sources, or set the CLAUDE_BRAIN env var to point at your claude-brain checkout."
+        proposedFix: "Run `bourdon setup` to (re-)wire missing sources, or set the AGENT_BRAIN env var to point at your agent-brain checkout."
       };
     } catch (err) {
       return {
@@ -3229,24 +3261,15 @@ var MAX_KEY_ACTIONS_PER_RUN = 6;
 var MAX_KEY_ACTION_CHARS2 = 280;
 var RUN_HEADER_RE = /^(\d{4}-\d{2}-\d{2})(?:\b|$)(.*)$/;
 var HEADER_SUFFIX_STRIP = " -:\u2014";
-var PROJECT_HINTS = [
-  "ShipStable",
-  "ILTT",
-  "Prun",
-  "PRUN",
-  "OMNIvour",
-  "Castmore",
+var DEFAULT_PROJECT_HINTS = [
   "Bourdon",
-  "RADLAB",
-  "CHIP",
-  "Claude Brain",
   "Cursor",
   "Copilot",
   "Codex",
   "Cascade"
 ];
 var SIGNAL_PATTERNS = [
-  ["human-dashboard-action", /\b(human|ryan|dashboard|manual)\b/i],
+  ["human-dashboard-action", /\b(human|dashboard|manual)\b/i],
   ["release-gate", /\b(release|store|app review|play console|testflight)\b/i],
   ["billing-drift", /\b(billing|stripe|revenuecat|iap|subscription)\b/i],
   ["memory-coverage-gap", /\b(memory|l5|manifest|federated|bourdon)\b/i],
@@ -3470,7 +3493,7 @@ function inferProjects(text) {
   const projects = [];
   const lowered = text.toLowerCase();
   const seen = /* @__PURE__ */ new Set();
-  for (const project of PROJECT_HINTS) {
+  for (const project of loadProjectHints(DEFAULT_PROJECT_HINTS)) {
     const key = project.toLowerCase();
     if (lowered.includes(key) && !seen.has(key)) {
       projects.push(project);
@@ -3701,22 +3724,9 @@ var MAX_MEMORY_CHARS2 = 16e4;
 var MAX_KEY_ACTIONS_PER_RUN2 = 6;
 var MAX_KEY_ACTION_CHARS3 = 280;
 var RUN_HEADER_RE2 = /^(\d{4}-\d{2}-\d{2})(?:\b|$)(.*)$/;
-var PROJECT_HINTS2 = [
-  "ShipStable",
-  "ILTT",
-  "Prun",
-  "PRUN",
-  "OMNIvour",
-  "Castmore",
-  "Bourdon",
-  "RADLAB",
-  "CHIP",
-  "Claude Brain",
-  "Cursor",
-  "Copilot"
-];
+var DEFAULT_PROJECT_HINTS2 = ["Bourdon", "Cursor", "Copilot"];
 var SIGNAL_PATTERNS2 = [
-  ["human-dashboard-action", /\b(human|ryan|dashboard|manual)\b/i],
+  ["human-dashboard-action", /\b(human|dashboard|manual)\b/i],
   ["release-gate", /\b(release|store|app review|play console|testflight)\b/i],
   ["billing-drift", /\b(billing|stripe|revenuecat|iap|subscription)\b/i],
   ["memory-coverage-gap", /\b(memory|l5|manifest|federated|bourdon)\b/i],
@@ -3834,7 +3844,7 @@ function readMemoryText2(path) {
   return text.length > MAX_MEMORY_CHARS2 ? text.slice(-MAX_MEMORY_CHARS2) : text;
 }
 function splitLines2(text) {
-  return text.split(/\r\n|[\n\r\v\f\x1c\x1d\x1e\x85\u2028\u2029]/);
+  return text.split(/\r\n|[\n\r\u000B\u000C\u001C\u001D\u001E\u0085\u2028\u2029]/u);
 }
 function rstrip2(s) {
   return s.replace(/\s+$/, "");
@@ -3874,7 +3884,7 @@ function inferProjects2(text) {
   const projects = [];
   const lowered = text.toLowerCase();
   const seen = /* @__PURE__ */ new Set();
-  for (const project of PROJECT_HINTS2) {
+  for (const project of loadProjectHints(DEFAULT_PROJECT_HINTS2)) {
     const key = project.toLowerCase();
     if (lowered.includes(key) && !seen.has(key)) {
       projects.push(project);
@@ -4213,9 +4223,7 @@ function buildConfig3(tomlPath) {
   const kind = pyStr2(pyTruthy(raw["kind"]) ? raw["kind"] : "").trim();
   const reposRaw = pyTruthy(raw["repos"]) ? raw["repos"] : [];
   const reposIter = Array.isArray(reposRaw) ? reposRaw : typeof reposRaw === "string" ? Array.from(reposRaw) : [];
-  const repos = reposIter.filter(
-    (r) => typeof r === "string" && r.trim() !== ""
-  );
+  const repos = reposIter.filter((r) => typeof r === "string" && r.trim() !== "");
   const memoryPath = (0, import_node_path11.join)(parentDir, MEMORY_MD3);
   return {
     automationId,
@@ -4251,7 +4259,10 @@ function iterConfigs3(automationsDir) {
 }
 function splitLines3(text) {
   if (text.length === 0) return [];
-  return text.split(/\r\n|\r|\n|\v|\f|\x1c|\x1d|\x1e|\x85|\u2028|\u2029/);
+  return text.split(
+    // eslint-disable-next-line no-control-regex
+    /\r\n|\r|\n|\u000B|\u000C|\u001C|\u001D|\u001E|\u0085|\u2028|\u2029/u
+  );
 }
 function rstrip3(s) {
   return s.replace(/\s+$/u, "");
@@ -4269,9 +4280,7 @@ function extractMemoryRuns3(config) {
   try {
     text = (0, import_node_fs11.readFileSync)(config.memoryPath, "utf8");
   } catch (exc) {
-    logger5.warn(
-      `CopilotAutomationsParticipant: cannot read ${config.memoryPath}: ${String(exc)}`
-    );
+    logger5.warn(`CopilotAutomationsParticipant: cannot read ${config.memoryPath}: ${String(exc)}`);
     return [];
   }
   text = text.slice(-MAX_MEMORY_CHARS3);
@@ -4521,24 +4530,15 @@ var MAX_KEY_ACTIONS_PER_RUN4 = 6;
 var MAX_KEY_ACTION_CHARS5 = 280;
 var RUN_HEADER_RE4 = /^(\d{4}-\d{2}-\d{2})(?:\b|$)(.*)$/;
 var HEADER_SUFFIX_STRIP2 = " -:\u2014";
-var PROJECT_HINTS3 = [
-  "ShipStable",
-  "ILTT",
-  "Prun",
-  "PRUN",
-  "OMNIvour",
-  "Castmore",
+var DEFAULT_PROJECT_HINTS3 = [
   "Bourdon",
-  "RADLAB",
-  "CHIP",
-  "Claude Brain",
   "Cursor",
   "Copilot",
   "Codex",
   "Cascade"
 ];
 var SIGNAL_PATTERNS3 = [
-  ["human-dashboard-action", /\b(human|ryan|dashboard|manual)\b/i],
+  ["human-dashboard-action", /\b(human|dashboard|manual)\b/i],
   ["release-gate", /\b(release|store|app review|play console|testflight)\b/i],
   ["billing-drift", /\b(billing|stripe|revenuecat|iap|subscription)\b/i],
   ["memory-coverage-gap", /\b(memory|l5|manifest|federated|bourdon)\b/i],
@@ -4751,7 +4751,7 @@ function inferProjects3(text) {
   const projects = [];
   const lowered = text.toLowerCase();
   const seen = /* @__PURE__ */ new Set();
-  for (const project of PROJECT_HINTS3) {
+  for (const project of loadProjectHints(DEFAULT_PROJECT_HINTS3)) {
     const key = project.toLowerCase();
     if (lowered.includes(key) && !seen.has(key)) {
       projects.push(project);
@@ -4962,17 +4962,8 @@ var STATE_FILE_RE = /^local_.*\.json$/;
 var MAX_KEY_ACTION_CHARS6 = 280;
 var MAX_PROJECTS = 6;
 var MAX_KEY_ACTIONS2 = 6;
-var PROJECT_HINTS4 = [
-  "ShipStable",
-  "ILTT",
-  "Prun",
-  "PRUN",
-  "OMNIvour",
-  "Castmore",
+var DEFAULT_PROJECT_HINTS4 = [
   "Bourdon",
-  "RADLAB",
-  "CHIP",
-  "Claude Brain",
   "Cursor",
   "Copilot",
   "Codex",
@@ -5142,7 +5133,7 @@ function inferProjects4(state) {
     if (base) add(base);
   }
   const haystack = pathStrings.join(" ").toLowerCase();
-  for (const hint of PROJECT_HINTS4) {
+  for (const hint of loadProjectHints(DEFAULT_PROJECT_HINTS4)) {
     if (haystack.includes(hint.toLowerCase())) add(hint);
   }
   return projects.slice(0, MAX_PROJECTS);
@@ -5389,17 +5380,8 @@ var STATE_PREFIX2 = "local_";
 var MAX_PROJECTS2 = 6;
 var MAX_KEY_ACTIONS3 = 8;
 var MAX_AUDIT_LINES = 5e4;
-var PROJECT_HINTS5 = [
-  "ShipStable",
-  "ILTT",
-  "Prun",
-  "PRUN",
-  "OMNIvour",
-  "Castmore",
+var DEFAULT_PROJECT_HINTS5 = [
   "Bourdon",
-  "RADLAB",
-  "CHIP",
-  "Claude Brain",
   "Cursor",
   "Copilot",
   "Codex",
@@ -5579,7 +5561,7 @@ function inferProjects5(state) {
     if (base) add(base);
   }
   const haystack = pathStrings.join(" ").toLowerCase();
-  for (const hint of PROJECT_HINTS5) {
+  for (const hint of loadProjectHints(DEFAULT_PROJECT_HINTS5)) {
     if (haystack.includes(hint.toLowerCase())) add(hint);
   }
   return projects.slice(0, MAX_PROJECTS2);
@@ -6350,6 +6332,105 @@ var CopilotVscodeParticipant = class {
   }
 };
 
+// src/readers/codex-sessions.ts
+var import_node_fs16 = require("fs");
+var import_node_os16 = require("os");
+var import_node_path16 = require("path");
+var DEFAULT_TITLE_LIMIT = 200;
+var DEFAULT_RECENT_THREAD_LIMIT = 5;
+function normalizeText(value) {
+  return value.trim().replace(/\s+/g, " ");
+}
+function isDir14(path) {
+  try {
+    return (0, import_node_fs16.statSync)(path).isDirectory();
+  } catch {
+    return false;
+  }
+}
+function resolveCodexHome(baseHome) {
+  const env = process.env.CODEX_HOME;
+  if (env) {
+    if (isDir14(env)) return env;
+  }
+  const home = baseHome ? baseHome : (0, import_node_os16.homedir)();
+  const candidate = (0, import_node_path16.join)(home, ".codex");
+  return isDir14(candidate) ? candidate : null;
+}
+function parseSessionIndex(path, limit) {
+  let text;
+  try {
+    if (!(0, import_node_fs16.statSync)(path).isFile()) return [];
+    text = (0, import_node_fs16.readFileSync)(path, "utf8");
+  } catch (exc) {
+    if (existsQuiet(path)) console.warn(`Failed to read ${path}: ${String(exc)}`);
+    return [];
+  }
+  const entries = [];
+  const lines = text.split(/\r?\n/);
+  for (let i = 0; i < lines.length; i += 1) {
+    const line = lines[i].trim();
+    if (!line) continue;
+    let record;
+    try {
+      record = JSON.parse(line);
+    } catch (exc) {
+      console.warn(`Skipping malformed JSONL in ${path}:${i + 1} -- ${String(exc)}`);
+      continue;
+    }
+    if (record !== null && typeof record === "object" && !Array.isArray(record) && typeof record.id === "string") {
+      entries.push(record);
+    }
+  }
+  entries.sort((a, b) => {
+    const ua = String(a.updated_at ?? "");
+    const ub = String(b.updated_at ?? "");
+    return ua < ub ? 1 : ua > ub ? -1 : 0;
+  });
+  return limit !== void 0 && limit !== null ? entries.slice(0, limit) : entries;
+}
+function existsQuiet(path) {
+  try {
+    (0, import_node_fs16.statSync)(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function sessionThreadTitles(codexHome, opts = {}) {
+  const limit = opts.limit ?? DEFAULT_TITLE_LIMIT;
+  const home = codexHome === void 0 || codexHome === null ? resolveCodexHome() : codexHome;
+  if (home === null) return {};
+  const titles = {};
+  for (const entry of parseSessionIndex((0, import_node_path16.join)(home, "session_index.jsonl"), limit)) {
+    const sid = entry.id;
+    const name = entry.thread_name;
+    if (typeof sid === "string" && sid && typeof name === "string" && name.trim() && !(sid in titles)) {
+      titles[sid] = normalizeText(name);
+    }
+  }
+  return titles;
+}
+function recentSessionThreads(codexHome, opts = {}) {
+  const limit = opts.limit ?? DEFAULT_RECENT_THREAD_LIMIT;
+  const home = codexHome === void 0 || codexHome === null ? resolveCodexHome() : codexHome;
+  if (home === null) return [];
+  const threads = [];
+  for (const entry of parseSessionIndex((0, import_node_path16.join)(home, "session_index.jsonl"), limit)) {
+    const sid = entry.id;
+    if (typeof sid !== "string" || !sid) continue;
+    const name = entry.thread_name;
+    const title = typeof name === "string" && name.trim() ? normalizeText(name) : null;
+    const updated = String(entry.updated_at ?? "");
+    threads.push({
+      instance: sid.slice(0, 8),
+      title,
+      updated_at: updated || null
+    });
+  }
+  return threads;
+}
+
 // src/registry.ts
 var FIRST_PARTY = [
   CascadeParticipant,
@@ -6416,6 +6497,8 @@ var import_l516 = require("@getbourdon/l5");
   CursorAutomationsParticipant,
   CursorParticipant,
   DEFAULT_CACHE_TTL_SECONDS,
+  DEFAULT_RECENT_THREAD_LIMIT,
+  DEFAULT_TITLE_LIMIT,
   FIRST_PARTY,
   GitHubCopilotParticipant,
   HermesParticipant,
@@ -6425,6 +6508,7 @@ var import_l516 = require("@getbourdon/l5");
   NetworkUnavailable,
   OpenClawApiClient,
   OpenClawParticipant,
+  PROJECT_HINTS_ENV,
   ParticipantAuthError,
   ParticipantDiscoveryError,
   ParticipantError,
@@ -6443,9 +6527,14 @@ var import_l516 = require("@getbourdon/l5");
   friendlyLabel,
   ghTokenProvider,
   isParticipant,
+  loadProjectHints,
   openReadonly,
+  parseSessionIndex,
   projectKeyFromCwd,
+  recentSessionThreads,
+  resolveCodexHome,
   resolvePluginParticipants,
+  sessionThreadTitles,
   sqliteAvailable,
   tableColumns,
   tableExists,