important-indexes.md
· 2.7 KiB · Markdown
原始檔案
# Important Indexes — Atomique Knowledge Base
The atomique codebase is indexed in the context-mode knowledge base for cross-session recall.
These indexes are how future sessions access project knowledge without re-reading source files.
## Indexed Sources
| Source label | Path | Contents |
|-------------|------|----------|
| `atomique-core` | `Disks/System.atdsk/Lua/core/` | 22 files — atm.lua, boot.lua, constants.lua, Window.lua, bookmarks.lua, url.lua, mainloop.lua, gfx.lua, animation.lua, etc. |
| `atomique-views` | `Disks/System.atdsk/Lua/views/` | 49 files — View.lua, TableView.lua, ButtonView.lua, ScrollView.lua, FlowView.lua, TextInput.lua, TextArea.lua, protocols/ etc. |
| `atomique-menu` | `Disks/System.atdsk/Lua/menu/system/` | 17 files — MenuBarView.lua, MenuBarController.lua, SystemMenuBar.lua, MenuBarComponent.lua, DropDownMenu.lua, MenuFlowView.lua, etc. |
| `atomique-desk` | `Disks/System.atdsk/Lua/desk/` | 6 files — DeskView.lua, DeskIcons.lua, DeskItemView.lua, Wallpaper.lua, etc. |
| `atomique-c` | `src/` | 39 files — main.c, bindings_common.c, lua_runtime.c, app_thread.c, view.c, wm.c, draw.c, fb.c, mouse.c, readable_c/ etc. |
| `atomique-agents` | `dev_docs/agents.md` | Agent instructions, conventions, build rules |
| `atomique-architecture` | `dev_docs/architecture.md` | Architecture overview (view system, events, threads, etc.) |
| `atomique-bugs` | `dev_docs/bugs.md` | Known bugs and pending issues |
| `atomique-session-summary` | `dev_docs/SESSION_SUMMARY.md` | Session history and milestones |
| `atomique-important-indexes` | `dev_docs/important-indexes.md` | This file — index catalog |
## Searching
Use `ctx_search` with optional `source` filter to scope results:
```lua
ctx_search(queries: ["mouse event dispatch", "addSubview coordinate"])
ctx_search(queries: ["menu bar coordinate system"], source: "atomique-menu")
ctx_search(queries: ["constants list"], source: "atomique-core")
```
## Re-indexing After Changes
The index is static — it captures file content at the time of indexing.
After modifying any file in an indexed source, re-index that source:
```lua
-- Single file
ctx_index(path: "Disks/System.atdsk/Lua/core/atm.lua", source: "atomique-core")
-- Entire directory (preferred after batch changes)
ctx_index(path: "Disks/System.atdsk/Lua/core", source: "atomique-core")
```
**Rule:** Every agent that modifies a file in an indexed source must re-index
that source before reporting done.
## Adding New Indexes
When a new module or file becomes important enough to search across sessions:
```lua
ctx_index(path: "path/to/file.lua", source: "atomique-<category>")
```
Add it to the table above and update the source label in `agents.md`.
Important Indexes — Atomique Knowledge Base
The atomique codebase is indexed in the context-mode knowledge base for cross-session recall. These indexes are how future sessions access project knowledge without re-reading source files.
Indexed Sources
| Source label | Path | Contents |
|---|---|---|
atomique-core |
Disks/System.atdsk/Lua/core/ |
22 files — atm.lua, boot.lua, constants.lua, Window.lua, bookmarks.lua, url.lua, mainloop.lua, gfx.lua, animation.lua, etc. |
atomique-views |
Disks/System.atdsk/Lua/views/ |
49 files — View.lua, TableView.lua, ButtonView.lua, ScrollView.lua, FlowView.lua, TextInput.lua, TextArea.lua, protocols/ etc. |
atomique-menu |
Disks/System.atdsk/Lua/menu/system/ |
17 files — MenuBarView.lua, MenuBarController.lua, SystemMenuBar.lua, MenuBarComponent.lua, DropDownMenu.lua, MenuFlowView.lua, etc. |
atomique-desk |
Disks/System.atdsk/Lua/desk/ |
6 files — DeskView.lua, DeskIcons.lua, DeskItemView.lua, Wallpaper.lua, etc. |
atomique-c |
src/ |
39 files — main.c, bindings_common.c, lua_runtime.c, app_thread.c, view.c, wm.c, draw.c, fb.c, mouse.c, readable_c/ etc. |
atomique-agents |
dev_docs/agents.md |
Agent instructions, conventions, build rules |
atomique-architecture |
dev_docs/architecture.md |
Architecture overview (view system, events, threads, etc.) |
atomique-bugs |
dev_docs/bugs.md |
Known bugs and pending issues |
atomique-session-summary |
dev_docs/SESSION_SUMMARY.md |
Session history and milestones |
atomique-important-indexes |
dev_docs/important-indexes.md |
This file — index catalog |
Searching
Use ctx_search with optional source filter to scope results:
ctx_search(queries: ["mouse event dispatch", "addSubview coordinate"])
ctx_search(queries: ["menu bar coordinate system"], source: "atomique-menu")
ctx_search(queries: ["constants list"], source: "atomique-core")
Re-indexing After Changes
The index is static — it captures file content at the time of indexing. After modifying any file in an indexed source, re-index that source:
-- Single file
ctx_index(path: "Disks/System.atdsk/Lua/core/atm.lua", source: "atomique-core")
-- Entire directory (preferred after batch changes)
ctx_index(path: "Disks/System.atdsk/Lua/core", source: "atomique-core")
Rule: Every agent that modifies a file in an indexed source must re-index that source before reporting done.
Adding New Indexes
When a new module or file becomes important enough to search across sessions:
ctx_index(path: "path/to/file.lua", source: "atomique-<category>")
Add it to the table above and update the source label in agents.md.