openalmanac 0.2.39 → 0.2.40

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/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "openalmanac",
3
- "version": "0.2.39",
3
+ "version": "0.2.40",
4
4
  "description": "OpenAlmanac — pull, edit, and push articles to the open knowledge base",
5
5
  "type": "module",
6
6
  "bin": {
@@ -156,18 +156,30 @@ Read 20-30 corpus entries (prioritize high-score posts) to understand the landsc
156
156
  list_articles(community_slug: "<subreddit>", sort: "most_referenced")
157
157
  ```
158
158
 
159
- Identify 15-20 core topics grouped by theme. These should be the foundational articles every reader of this wiki would expect. Present them to the user grouped by theme:
159
+ Identify 15-20 core articles. **Favor nouns over themes** specific things people would look up, not vague survey topics.
160
+
161
+ - **~70% nouns:** Specific locks, tools, people, techniques, concepts. "American Lock 1100", "Spool Pin", "Tension Wrench", "LockPickingLawyer". These are the building blocks — what people search for, link to, and learn from.
162
+ - **~30% structural themes:** Only the big ones that serve as entry points and tie nouns together. "Belt System", "Lock Picking Basics". Not vague surveys — each should be a real article that teaches something.
163
+
164
+ Bad: "Security Pin Mechanics" (vague theme, reads like a textbook chapter)
165
+ Good: "Spool Pin", "Serrated Pin", "Mushroom Pin" (specific nouns — then link them from a "Security Pins" overview)
166
+
167
+ Present them to the user grouped by category, but make clear most articles are about specific things:
160
168
 
161
169
  ```
162
170
  Here's what I'd build for the foundation:
163
171
 
164
- Lock Anatomy
165
- Cylinder, Warding, Master Keying
172
+ Locks
173
+ American Lock 1100, Abus 55/40, Master Lock #3, Kwikset SmartKey
174
+
175
+ Components
176
+ › Spool Pin, Serrated Pin, Tension Wrench, Key Pin
166
177
 
167
178
  Techniques
168
- › Bumping, Comb Picking, Impressioning
179
+ › Bumping, Raking, Single Pin Picking
169
180
 
170
- [etc.]
181
+ Community
182
+ › LockPickingLawyer, BosnianBill, Belt System
171
183
 
172
184
  Want to add or change anything?
173
185
  ```
@@ -357,6 +369,11 @@ openalmanac.org/communities/<subreddit>/wiki
357
369
  - The description should have personality — capture the community's vibe, not a generic taxonomy
358
370
  - Find a good cover image with `search_images`
359
371
 
372
+ ### File access
373
+ - Use `Glob` and `Read` tools to browse and read files in `~/.openalmanac/` — do NOT use `Bash(ls ...)` or `Bash(cat ...)`
374
+ - Use `Write` and `Edit` tools to modify files — do NOT use `Bash(echo ...)` or `Bash(sed ...)`
375
+ - The only Bash command you should use is the ingest script
376
+
360
377
  ### What NOT to do
361
378
  - Don't estimate how long things will take
362
379
  - Don't make small talk or ask personal questions