topchester-ai 0.14.0 → 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -40,7 +40,7 @@ Build the project knowledge base:
40
40
 
41
41
  ```sh
42
42
  topchester kb init
43
- topchester kb compile
43
+ topchester kb sync
44
44
  ```
45
45
 
46
46
  Start the agent:
@@ -71,7 +71,7 @@ topchester run "Summarize this project."
71
71
 
72
72
  topchester kb status
73
73
  topchester kb sync
74
- topchester kb compile
74
+ topchester kb sync --full
75
75
  topchester kb search "status bar"
76
76
  topchester kb reset
77
77
  ```
@@ -81,11 +81,11 @@ Useful TUI slash commands:
81
81
  ```text
82
82
  /kb status
83
83
  /kb sync
84
- /kb compile
84
+ /kb sync --full
85
85
  /new
86
86
  ```
87
87
 
88
- `topchester kb status` is the cheap check. It shows files that are not current in the knowledge base. `topchester kb sync` updates only those non-clean files.
88
+ `topchester kb status` is the cheap check. It shows files that are not current in the knowledge base. `topchester kb sync` builds the KB when it is empty and updates only non-clean files afterward. Use `topchester kb sync --full` to rebuild every in-scope file and remove orphaned L1 entries.
89
89
 
90
90
  ## Configuration
91
91
 
@@ -129,7 +129,7 @@ Prefer `topchester.jsonc` for new project config. YAML paths are kept for compat
129
129
 
130
130
  ## How The Knowledge Base Works
131
131
 
132
- `topchester kb compile` scans the workspace, respects `.gitignore`, skips generated/cache folders, and writes one L1 knowledge entry per in-scope file under `topchester-kb/l1-files/`.
132
+ `topchester kb sync` scans the workspace, respects `.gitignore`, skips generated/cache folders, and writes L1 knowledge entries under `topchester-kb/l1-files/`.
133
133
 
134
134
  The compiler uses `models["kb.summarize"]` when it is configured. If it is not configured, it uses `models.default`.
135
135
 
@@ -137,7 +137,7 @@ Common KB states:
137
137
 
138
138
  - `kb: ready` — the KB exists and has compiled content.
139
139
  - `kb: empty` — the KB folder exists but has no compiled content yet.
140
- - `kb: missing` — run `topchester kb init`, then `topchester kb compile`.
140
+ - `kb: missing` — run `topchester kb init`, then `topchester kb sync`.
141
141
  - `N dirty` — run `topchester kb sync`.
142
142
 
143
143
  ## Working From Source