cyberbrain 0.1.0

Cited, trust-tiered, local-first memory for AI coding agents
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135

# Default import plan for a tree of operator notes (the `.wolf/` shape found on this
# machine). Copy it next to the tree, adjust, and run `cyberbrain import --plan <file>`.
#
# Rules: [[skip]] rules are evaluated first, then [[group]] rules in order; the first
# match wins. A file that matches nothing is reported as UNMAPPED and fails the run.
# A skipped file is counted and listed under its rule; it is never silently dropped.

version = 1
root = "."
tags = ["imported"]

# ---- what is not a note ----------------------------------------------------------------

[[skip]]
paths = ["backups/**", "*.bak", "*.bak-*", "*.bak.*", "*.bak-pre-*"]
reason = "backups and .bak copies of files that are imported from their live version"

[[skip]]
paths = ["hooks/**", "*.js", "*.mjs", "*.pid", "*.log", "*.vec", "dashboard-token", "remote-token", ".gitignore", "*.jpg", "*.png", "designqc-captures/**"]
reason = "tool code, runtime state, logs, images: not notes"

[[skip]]
paths = ["*.json"]
reason = "JSON state of the previous tool (bug log, config, cron state, symbol graphs); not Markdown, imported separately if at all"

[[skip]]
paths = ["OPENWOLF.md"]
reason = "the previous tool's operating protocol: it instructs an agent to write into .wolf/STATUS.md, which would be a standing instruction pointing at nothing"

# ---- ring 0: invariants ------------------------------------------------------------------

[[group]]
name = "invariants"
paths = ["identity.md"]
ring = 0
kind = "knowledge"
tags = ["identity"]

# ---- ring 1: operating protocol -----------------------------------------------------------
# Rings 0 and 1 share an 8k-token cap and are injected into every session; only short
# protocol files belong here. STATUS.md (a 200 KB retired handoff log) does not fit and
# goes to ring 3 below.
#
# OPENWOLF.md is skipped above rather than landing here. A file in ring 1 is injected into
# every session as protocol to follow, and that one tells an agent to write into a tree we
# are leaving. An instruction that points at nothing is worse in the resident ring than
# anywhere else, because it arrives before the agent has any reason to doubt it.

[[group]]
name = "protocol"
paths = ["ENGINE.md"]
ring = 1
kind = "reference"
tags = ["protocol"]

# ---- ring 2: curated knowledge -----------------------------------------------------------

[[group]]
name = "curated"
paths = ["cerebrum.md"]
ring = 2
kind = "knowledge"
split = "heading"
heading_level = 3
note_name = "{stem}-{heading}"
collisions = "hash"   # the same heading recurs (appended batches); content-hash suffix, each one reported
tags = ["cerebrum"]

[[group]]
name = "do-not-repeat"
paths = ["DO-NOT-REPEAT.md"]
ring = 2
kind = "lesson"
split = "heading"
heading_level = 3
note_name = "{stem}-{heading}"
tags = ["do-not-repeat"]

# Pre-registered evidence: the hashes file rides along so the chain can be re-checked.
[[group]]
name = "prereg"
paths = ["PREREG_*.md", "PREREG_hashes.txt"]
ring = 2
kind = "reference"
tags = ["prereg", "evidence"]

[[group]]
name = "notes"
paths = ["cfetch-AGENT.draft.md", "cfetch-umzug-checkliste.md"]
ring = 2
kind = "knowledge"

# ---- ring 3: session records ---------------------------------------------------------------

[[group]]
name = "sessions"
paths = ["memory.md"]
ring = 3
kind = "session"
split = "heading"
heading_level = 2
note_name = "{stem}-{heading}"
collisions = "hash"   # the same heading recurs (appended batches); content-hash suffix, each one reported
tags = ["memory"]

[[group]]
name = "status-log"
paths = ["STATUS.md"]
ring = 3
kind = "session"
split = "heading"
heading_level = 2
note_name = "{stem}-{heading}"
collisions = "hash"   # the same heading recurs (appended batches); content-hash suffix, each one reported
tags = ["status"]

# ---- ring 4: imported, unverified ------------------------------------------------------------

[[group]]
name = "proposals"
paths = ["proposals/*.md"]
ring = 4
kind = "reference"
note_name = "{dir}-{stem}"
tags = ["proposal", "unverified"]

[[group]]
name = "generated"
paths = ["anatomy.md", "reframe-frameworks.md"]
ring = 4
kind = "reference"
tags = ["generated"]

# Anything else that is Markdown or text and matched no rule above is still UNMAPPED and
# fails the run. Add it to a group or to a skip rule with a reason.