Garry's Opinionated OpenClaw/Hermes Agent Brain
TypeScript
/**
* Source-Type Boost Map
*
* Multiplies into ts_rank / vector cosine score at SQL build time so that
* curated content (originals/, concepts/, writing/) outranks bulk content
* (openclaw/chat/, daily/, media/x/) for non-temporal queries.
*
* Keyed by slug prefix. Longest-prefix-match wins (sorted at lookup time
* inside sql-ranking.ts). Defaults grounded in the composition of the
* canonical brain at ~/git/brain/.
*
* Per brain: `gbrain config set search.source_boosts "wiki/:1.3,daily/:1.0"`
* (`none` drops the defaults). Per process (wins over the brain):
* GBRAIN_SOURCE_BOOST="originals/:1.8,openclaw/chat/:0.3"
* Hard-exclude via env: GBRAIN_SEARCH_EXCLUDE="test/,scratch/"
*/
export const DEFAULT_SOURCE_BOOSTS: Record<string, number> = {
// Curated, opinionated, high-signal — Garry's own writing
'originals/': 1.5,
// Reusable knowledge frameworks
'concepts/': 1.3,
// Long-form essays / articles
'writing/': 1.4,
// Entity pages
'people/': 1.2,
'companies/': 1.2,
'deals/': 1.2,
// Notes from real meetings
'meetings/': 1.1,
// Ingested third-party content
'media/articles/': 1.1,
'media/repos/': 1.1,
// Neutral baselines (explicit for clarity)
'yc/': 1.0,
'civic/': 1.0,
// Bulk / noisy
'daily/': 0.8,
'media/x/': 0.7,
// Chat transcripts — massive, noisy, swamp keyword queries
'openclaw/chat/': 0.5,
// Archived historical content — findable by default but ranked below curated
// content (issue #1777). NOT hard-excluded: archive/ routinely holds high-signal
// history (conversation exports, prior-system logs, older notes) users expect to
// retrieve. Demote-not-exclude keeps it findable without letting it dominate. The
// 0.5 is a prior applied in the SQL/fusion layer; the cross-encoder reranker can
// still PROMOTE a strongly-matching archive page that survives the demote into the
// rerank candidate window.
'archive/': 0.5,
// v0.42 extract_receipt pages — surface when relevant (extraction
// questions, audit trail) but never dominate user content. Per plan
// D-EXTRACT-42. Receipts stamp `type: extract_receipt` AND
// `dream_generated: true` in their frontmatter; demote here keeps them
// findable but ranked below all curated user content.
'extracts/': 0.3,
};
/**
* Hard-excludes — slug prefixes that should never enter search results
* (unless explicitly opted-in via include_slug_prefixes).
*
* These are genuine noise: test fixtures, binary attachments, raw sidecars.
* `archive/` is deliberately NOT here (issue #1777) — it holds high-signal
* historical content users expect to find, so it is DEMOTED via
* DEFAULT_SOURCE_BOOSTS (`archive/`: 0.5) instead of hidden.
*/
export const DEFAULT_HARD_EXCLUDES: string[] = [
'test/',
'attachments/',
'.raw/',
];
/**
* Parse GBRAIN_SOURCE_BOOST env var.
* Format: comma-separated prefix:factor pairs.
* Example: "originals/:1.8,openclaw/chat/:0.3"
*
* Malformed entries are skipped silently. Returns empty object if env is
* unset or unparseable in its entirety.
*/
export function parseSourceBoostEnv(env: string | undefined): Record<string, number> {
if (!env) return {};
const out: Record<string, number> = {};
for (const pair of env.split(',')) {
const idx = pair.lastIndexOf(':');
if (idx <= 0) continue;
const prefix = pair.slice(0, idx).trim();
const factor = Number.parseFloat(pair.slice(idx + 1).trim());
if (!prefix || !Number.isFinite(factor) || factor < 0) continue;
out[prefix] = factor;
}
return out;
}
/**
* Parse GBRAIN_SEARCH_EXCLUDE env var.
* Format: comma-separated slug prefixes.
* Example: "test/,scratch/,private/"
*
* Blank entries skipped. Returns empty array if env is unset.
*/
export function parseHardExcludesEnv(env: string | undefined): string[] {
if (!env) return [];
return env.split(',').map(s => s.trim()).filter(s => s.length > 0);
}
/**
* Resolve the effective boost map: defaults, then the brain's
* `search.source_boosts` config (same `prefix:factor` format; a bare `none`
* entry drops the defaults so a brain with a different layout starts from a
* neutral map), then the GBRAIN_SOURCE_BOOST env override. Shallow merges;
* later layers win per prefix.
*/
export function resolveBoostMap(
envValue: string | undefined = process.env.GBRAIN_SOURCE_BOOST,
configValue?: string | null,
): Record<string, number> {
const dropDefaults = (configValue ?? '').split(',').some((entry) => entry.trim() === 'none');
return {
...(dropDefaults ? {} : DEFAULT_SOURCE_BOOSTS),
...parseSourceBoostEnv(configValue ?? undefined),
...parseSourceBoostEnv(envValue),
};
}
/**
* Resolve the effective hard-exclude prefix list.
*
* - Defaults union with env-supplied excludes
* - Subtract any caller-supplied include_slug_prefixes (opt-back-in)
* - Caller-supplied exclude_slug_prefixes adds to the union
*/
export function resolveHardExcludes(
excludeOpt?: string[],
includeOpt?: string[],
envValue: string | undefined = process.env.GBRAIN_SEARCH_EXCLUDE,
): string[] {
const envExcludes = parseHardExcludesEnv(envValue);
const union = new Set<string>([...DEFAULT_HARD_EXCLUDES, ...envExcludes, ...(excludeOpt ?? [])]);
if (includeOpt?.length) {
for (const p of includeOpt) union.delete(p);
}
return Array.from(union);
}