admin/gbrain
1
0
Fork 0
mirror of https://github.com/garrytan/gbrain.git synced 2026-07-27 22:15:33 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
5d42f3295e75765c62fb72342f9818a06279bd05
gbrain/skills/manifest.json
T
Garry TanGitHubClaude Opus 4.7
 5d42f3295e v0.41.22.0 feat: type-unification cathedral — 94 types → 15 canonical (closes #1479) (#1542) 
* Merge branch 'master' into garrytan/type-taxonomy-unification

Resolve VERSION, package.json, CHANGELOG conflicts with v0.41.22.0
on top, preserving master's v0.41.19.0 entry below.

* feat: v0.41.22.0 type-unification cathedral — collapse 94 types to 15 (closes #1479)

Ships gbrain-base-v2 as the new install default (15 canonical types: 14
+ note catch-all) and the unify-types PROTECTED Minion handler that
runs the gbrain-base→v2 migration end-to-end on existing brains.

What this delivers:
- gbrain-base-v2.yaml standalone schema pack (no extends:) with 14
  canonical page_types + 9 cluster mapping_rules + catch-all sentinel
- 3 new schema-pack primitives: runRetypeCore (chunked UPDATE with
  legacy_type stamping), runPageToLinkCore (edge-shaped pages →
  link rows), runPageToAliasCore (concept-redirect → slug_aliases)
- rewriteLinksBatch for N-pair atomic FK rewrite
- Migration v104 slug_aliases table (forward-bootstrap probed on both
  engines for safe upgrade chain)
- New engine method resolveSlugWithAlias(slug, sourceOrSources) on
  both Postgres + PGLite with multi-source ambiguity warning
- inferTypeAndSubtypeFromPack overload + subtypes: + mapping_rules:
  + migration_from: schema-pack manifest extensions
- findPackSuccessors version-range walker (1.x / 1.0.x / exact match)
- expandTypeFilter for --type back-compat (D14): legacy aliases route
  through mapping_rules → canonical+subtype before the SQL filter fires
- 3 new onboard checks: pack_upgrade_available, type_proliferation,
  dangling_aliases (source-scoped per F12)
- unify-types Minion handler (PROTECTED, manual_only via render.ts
  allowlist per D17): retype-explicit → retype-catch-all →
  page-to-link → page-to-alias → final sync → active-pack flip
- alias_resolved 1.05x post-fusion search boost stage; KNOBS_HASH_VERSION
  bumped 5→6 (one-time cache miss on upgrade, self-healing in TTL)
- ELIGIBLE_TYPES for facts extraction extended with v2 canonicals
  (codex F-ELIGIBLE: blocker not v0.43 follow-up)

Tests: 79 new unit/integration cases + 3 E2E cases covering all 9
production clusters end-to-end. 124-case verification on the cache-key
+ build-llms fixes. KNOBS_HASH_VERSION assertions updated in 3 tests.

Plan: ~/.claude/plans/system-instruction-you-are-working-transient-elephant.md
(16 locked decisions D1-D17, 12 baseline fixes F7-F21 absorbed from
codex outside voice).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* fix: CI verify failures — system-of-record allow-comment + schema-unify manifest registration

Two CI failures on PR #1542:

1. check:system-of-record flagged page-to-link.ts:207 addLinksBatch as
   a direct write to a derived table. The call IS the reconcile surface
   for page_to_link mapping_rules — it converts edge-shaped pages into
   canonical link rows under the PROTECTED unify-types Minion handler,
   source-scoped, atomic per-rule. Added the canonical
   `// gbrain-allow-direct-insert: <reason>` comment on the same line.

2. check:resolver emitted 11 orphan_trigger warnings for `schema-unify`
   because the skill was added to skills/RESOLVER.md without a
   corresponding entry in skills/manifest.json. Added the registration
   under the existing skills[] array.

bun run verify: 28/28 checks pass locally.

* fix: CI test failures — schema-unify conformance + eligibility regression

Six test failures across shards 2 + 10 on PR #1542:

1. resolver.test.ts: round-trip parser requires frontmatter triggers to
   be quoted (`- "..."` or `- '...'`). schema-unify shipped with bare
   YAML strings; quoted the 10 triggers to round-trip correctly.

2. skills-conformance.test.ts (×3): schema-unify SKILL.md was missing
   the required Contract, Anti-Patterns, and Output Format sections
   that every conformant skill must declare. Added all three:
   - Contract: inputs / outputs / side effects / failure modes
   - Anti-Patterns: 5 DON'Ts including the autopilot trust boundary
   - Output Format: per-phase stderr lines + celebration summary +
     JSON envelope shape

3. facts-eligibility.test.ts (×2): the v0.41.22 ELIGIBLE_TYPES
   expansion added `concept` to the eligible list, but the existing
   test suite pins concept as rejected (it's `extractable: true` in
   the schema pack but the v0.41.11 contract documented this as
   "cosmetic on the backstop path because backstop uses hardcoded
   ELIGIBLE_TYPES"). Removed `concept` from the expansion; other v2
   canonicals (media, tweet, atom, analysis) stay. Comment updated
   to document the deliberate omission.

All 6 failing tests now pass locally (370/370 across the 3 affected
files). bun run verify: 28/28 checks green.

* fix: harden findPackSuccessors test against shard pollution

CI shard 8 reported 1 fail (1.00ms — too fast for any real loadActivePack
file I/O) on `finds gbrain-base-v2 as successor of gbrain-base@1.0.0`.
Local triple-run passes 9/9 in isolation.

Root cause: the existing afterEach reset clears the module-level pack
cache AFTER each test, but the FIRST test in the file inherits whatever
state sibling files in the same bun shard process left behind. With
24+ schema-pack tests in shard 8 (mutate, mutate-audit, best-effort,
registry-reload, manifest-v041_2, etc.) running before this file, the
first test can read a poisoned cache.

Fix: add `beforeEach(_resetPackCacheForTests)`. Two-sided reset
guarantees clean state regardless of file ordering within the shard.

bun run verify: 28/28 checks pass.

* fix: quarantine two flaky tests to serial runner

CI shard 1 + shard 8 each surfaced one intermittent failure:

shard 1: buildBrainTools > execute() on put_page with valid namespace
shard 8: findPackSuccessors > finds gbrain-base-v2 as successor

Both pass cleanly in isolation. Both are concurrency races against
shared in-shard state:

- brain-allowlist.test.ts shares a singleton PGLiteEngine across 18
  tests with a beforeEach DELETE FROM pages. With max-concurrency=4,
  two put_page tests can interleave their TRUNCATE + write phases,
  so the auto-link/extract sub-steps inside put_page race against
  the sibling test's DELETE.
- schema-pack-find-pack-successors.test.ts reads bundled YAML packs
  via loadActivePack. The module-level pack cache is shared across
  parallel tests in the same shard; the previous beforeEach reset
  helped but didn't fully isolate against concurrent file reads
  under CI load.

Fix per CLAUDE.md test-isolation lint rule R2 (concurrency-fragile
files belong in the .serial.test.ts quarantine): rename both files
to *.serial.test.ts. Serial runner picks them up at max-concurrency=1.
49/49 serial files pass locally. 28/28 verify checks pass.

* fix: quarantine embed-stale test to serial runner

CI shard 9 reported 6 failures, all from the embedStaleForSource describe
block, all ~120-150ms each — classic shared-engine concurrency race shape.
Passes 7/7 locally in isolation.

Root cause: embed-stale.test.ts shares a singleton PGLiteEngine across 7
tests with beforeEach resetPgliteState. Under bun's max-concurrency=4 in
the parallel shard, two tests can interleave their TRUNCATE + seedPage +
upsertChunks + embedStaleForSource flow, so one test's stale-chunk count
sees another test's mid-flight writes.

Same fix as brain-allowlist.serial.test.ts and
schema-pack-find-pack-successors.serial.test.ts: rename to *.serial.test.ts
so the serial runner picks it up at max-concurrency=1.

bun run verify: 28/28 checks pass. 7/7 embed-stale tests pass via serial.

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-27 07:01:28 -07:00

261 lines
12 KiB
JSON
Raw Blame History

{
"name": "gbrain",
"version": "0.32.3.0",
"conformance_version": "1.0.0",
"description": "Personal knowledge brain with hybrid RAG search \u2014 GStack mod for agent platforms",
"skills": [
{
"name": "ingest",
"path": "ingest/SKILL.md",
"description": "Route content to specialized ingestion skills. Detects input type and delegates."
},
{
"name": "query",
"path": "query/SKILL.md",
"description": "Answer questions using 3-layer search, synthesis, and citation propagation"
},
{
"name": "maintain",
"path": "maintain/SKILL.md",
"description": "Brain health checks: back-link enforcement, citation audit, filing validation, stale info, orphans, benchmarks"
},
{
"name": "enrich",
"path": "enrich/SKILL.md",
"description": "Enrich pages with tiered enrichment protocol, person/company page templates, and validation rules"
},
{
"name": "briefing",
"path": "briefing/SKILL.md",
"description": "Compile daily briefing with meeting context, active deals, and citation tracking"
},
{
"name": "migrate",
"path": "migrate/SKILL.md",
"description": "Universal migration from Obsidian, Notion, Logseq, markdown, CSV, JSON, Roam"
},
{
"name": "setup",
"path": "setup/SKILL.md",
"description": "Set up GBrain: auto-provision Supabase or PGLite, AGENTS.md injection, first import"
},
{
"name": "publish",
"path": "publish/SKILL.md",
"description": "Share brain pages as beautiful password-protected HTML (code + skill pair, zero LLM calls)"
},
{
"name": "frontmatter-guard",
"path": "frontmatter-guard/SKILL.md",
"description": "Validate and auto-repair YAML frontmatter on brain pages; gates against malformed YAML, missing closing ---, nested quotes, slug mismatches, null bytes"
},
{
"name": "signal-detector",
"path": "signal-detector/SKILL.md",
"description": "Always-on ambient signal capture. Fires on every message to detect original thinking and entity mentions."
},
{
"name": "brain-ops",
"path": "brain-ops/SKILL.md",
"description": "Brain-first lookup, read-enrich-write loop, source attribution, ambient enrichment. The core read/write cycle."
},
{
"name": "capture",
"path": "capture/SKILL.md",
"description": "Single human-facing entrypoint for ingestion. Routes through put_page (local) or MCP (thin-client); replaces put-page-vs-commit-vs-autopilot confusion with one verb."
},
{
"name": "idea-ingest",
"path": "idea-ingest/SKILL.md",
"description": "Ingest links, articles, tweets, and ideas into the brain with analysis and entity cross-linking."
},
{
"name": "media-ingest",
"path": "media-ingest/SKILL.md",
"description": "Ingest video, audio, PDF, book, screenshot, and repo content with entity extraction."
},
{
"name": "meeting-ingestion",
"path": "meeting-ingestion/SKILL.md",
"description": "Ingest meeting transcripts with attendee enrichment, entity propagation, and timeline merge."
},
{
"name": "citation-fixer",
"path": "citation-fixer/SKILL.md",
"description": "Audit and fix citation formatting across brain pages."
},
{
"name": "repo-architecture",
"path": "repo-architecture/SKILL.md",
"description": "Where new brain files go. Filing rules and directory conventions."
},
{
"name": "skill-creator",
"path": "skill-creator/SKILL.md",
"description": "Create new skills following the conformance standard with MECE validation."
},
{
"name": "daily-task-manager",
"path": "daily-task-manager/SKILL.md",
"description": "Task lifecycle: add, complete, defer, remove, review with priority levels."
},
{
"name": "daily-task-prep",
"path": "daily-task-prep/SKILL.md",
"description": "Morning preparation with calendar context, open threads, and task review."
},
{
"name": "cross-modal-review",
"path": "cross-modal-review/SKILL.md",
"description": "Quality gate via second model with refusal routing chain."
},
{
"name": "cron-scheduler",
"path": "cron-scheduler/SKILL.md",
"description": "Schedule management with staggering, quiet hours, and wake-up override."
},
{
"name": "reports",
"path": "reports/SKILL.md",
"description": "Save and load timestamped reports with keyword routing for fast lookup."
},
{
"name": "testing",
"path": "testing/SKILL.md",
"description": "Skill validation framework: frontmatter, sections, manifest coverage, MECE checks."
},
{
"name": "soul-audit",
"path": "soul-audit/SKILL.md",
"description": "6-phase interactive interview generating SOUL.md, USER.md, ACCESS_POLICY.md, HEARTBEAT.md."
},
{
"name": "webhook-transforms",
"path": "webhook-transforms/SKILL.md",
"description": "Convert external events into brain-ingestible signals with entity extraction."
},
{
"name": "data-research",
"path": "data-research/SKILL.md",
"description": "Structured data research: search, extract, archive, deduplicate, track. Parameterized YAML recipes for investor updates, donations, company metrics."
},
{
"name": "minion-orchestrator",
"path": "minion-orchestrator/SKILL.md",
"description": "Unified Minions skill for deterministic shell jobs and LLM subagent orchestration. Submit, monitor, steer, pause/resume, replay. Replaces the older gbrain-jobs routing intent and sessions_spawn for durable observable background work."
},
{
"name": "schema-author",
"path": "schema-author/SKILL.md",
"description": "Evolve the active schema pack. Add page types, propose new types from a corpus scan, backfill page.type via sync. Wraps the 14 gbrain schema CLI verbs + 9 MCP ops shipped in v0.40.7.0."
},
{
"name": "skillify",
"path": "skillify/SKILL.md",
"description": "Meta skill. Turn any raw feature into a properly-skilled, tested, resolvable, evaled unit. Paired with gbrain check-resolvable gives user-controllable auto-skill-creation."
},
{
"name": "skillpack-check",
"path": "skillpack-check/SKILL.md",
"description": "Agent-readable gbrain health report. Wraps doctor + apply-migrations --list into one JSON blob with exit codes. Cron-friendly for morning-briefing pipelines."
},
{
"name": "skillpack-harvest",
"path": "skillpack-harvest/SKILL.md",
"description": "Editorial workflow for lifting a proven skill from a host repo back into gbrain. Pairs with `gbrain skillpack harvest` CLI. Drives the genericization checklist that scrubs fork-specific names + real entities before files land in gbrain core."
},
{
"name": "smoke-test",
"path": "smoke-test/SKILL.md",
"description": "Post-restart smoke tests + auto-fix for gbrain and OpenClaw environments"
},
{
"name": "book-mirror",
"path": "book-mirror/SKILL.md",
"description": "Take any book (EPUB/PDF), produce a personalized chapter-by-chapter analysis with two-column tables: left = chapter summary, right = how it applies to you based on brain context. Output: brain page + PDF."
},
{
"name": "article-enrichment",
"path": "article-enrichment/SKILL.md",
"description": "Transform raw article text dumps in the brain into structured pages with executive summaries, verbatim quotes, key insights, why-it-matters, and cross-references."
},
{
"name": "strategic-reading",
"path": "strategic-reading/SKILL.md",
"description": "Read a book/article/case study through the lens of a specific strategic problem; produce an applied playbook (do/avoid/watch for) with short/medium/long-term recommendations."
},
{
"name": "concept-synthesis",
"path": "concept-synthesis/SKILL.md",
"description": "Deduplicate and synthesize raw concept stubs into a tiered intellectual map (T1 Canon to T4 Riff), tracing idea evolution across sources over time."
},
{
"name": "perplexity-research",
"path": "perplexity-research/SKILL.md",
"description": "Brain-augmented web research via Perplexity plus Opus; surfaces what is NEW vs already-known about a topic by cross-referencing against the brain first."
},
{
"name": "archive-crawler",
"path": "archive-crawler/SKILL.md",
"description": "Universal archivist for personal file archives (Dropbox/B2/email exports). Filters for high-value content within an explicit gbrain.yml allow-list scan_paths gate."
},
{
"name": "academic-verify",
"path": "academic-verify/SKILL.md",
"description": "Verify academic citations and research claims against current literature; routes through perplexity-research for the actual web search and formats results as a citation-checked brain page."
},
{
"name": "brain-pdf",
"path": "brain-pdf/SKILL.md",
"description": "Generate a publication-quality PDF from any brain page via the gstack make-pdf binary; strips frontmatter, sanitizes emoji, applies running headers."
},
{
"name": "voice-note-ingest",
"path": "voice-note-ingest/SKILL.md",
"description": "Ingest voice notes with exact-phrasing preservation (never paraphrased); routes content based on a decision tree across originals/concepts/people/companies/ideas/personal/voice-notes."
},
{
"name": "cold-start",
"path": "cold-start/SKILL.md",
"description": "Day-one brain bootstrapping: sequence the highest-leverage data sources (contacts, calendar, email, conversations, social, archives) to go from empty brain to useful brain. Uses ClawVisor for safe credential handling — agents never hold raw API keys."
},
{
"name": "ask-user",
"path": "ask-user/SKILL.md",
"description": "Reusable choice-gate pattern for presenting users with 2-4 options and stopping execution until they respond. Platform-agnostic (Telegram buttons, Discord, CLI, OpenClaw clarify tool)."
},
{
"name": "functional-area-resolver",
"path": "functional-area-resolver/SKILL.md",
"description": "Compress an agent's routing file (RESOLVER.md or AGENTS.md) by replacing skill-per-row tables with functional-area dispatcher entries. Two-layer dispatch keeps every sub-skill reachable at ~50% of the file size."
},
{
"name": "brain-taxonomist",
"path": "brain-taxonomist/SKILL.md",
"description": "Filing gate consulted before every brain page write. Reads the active schema pack via `gbrain schema show --json`; emits a recommended filing path with reasoning."
},
{
"name": "eiirp",
"path": "eiirp/SKILL.md",
"description": "Everything In Its Right Place — post-work organizer. 7-phase audit: inventory, taxonomy, schema check (via cathedral CLI), file, skill graph audit, verify, report."
},
{
"name": "schema-unify",
"path": "schema-unify/SKILL.md",
"description": "Migrate a brain off a noisy 24+-type pack onto gbrain-base-v2 (15 canonical types). 7-phase workflow: brain → assess → propose → apply → sync → verify → commit. Wraps the v0.41.22 unify-types PROTECTED Minion handler."
}
],
"dependencies": {
"runtime": "bun",
"package": "gbrain"
},
"setup": {
"skill": "setup",
"description": "Auto-provision Supabase or PGLite and configure GBrain (< 2 min)"
},
"recipes_dir": "recipes/",
"resolver": "RESOLVER.md",
"conventions_dir": "conventions/",
"templates_dir": "../templates/"
}
Reference in New Issue View Git Blame Copy Permalink