toga-ai 1.0.38 → 1.0.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": "toga-ai",
3
- "version": "1.0.38",
3
+ "version": "1.0.40",
4
4
  "description": "TOGA Technology Team Claude Knowledge System — shared AI coding harness with skills, knowledge base CLI, and project installer for Claude Code.",
5
5
  "keywords": [
6
6
  "claude",
@@ -71,6 +71,32 @@ persist the `.claude/` bundle path, or the next session will silently skip pushi
71
71
 
72
72
  Call the helper as `node "<TEAM_REPO>/knowledge.js" …`.
73
73
 
74
+ ## Step 1b — Resolve the author username (`owners` — NEVER leave empty)
75
+
76
+ Every doc's `owners:` field must name the person authoring this session's changes.
77
+ **Never write `owners: []` or an empty owner.** Resolve the username once and reuse it for
78
+ every doc in this capture — call the result `AUTHOR_USERNAME`:
79
+
80
+ 1. **Claude memory** — look for a `user` memory named `author-username`. If present, use it
81
+ and do not ask again.
82
+ 2. **If absent, ASK the developer:** "What's your username for knowledge ownership?
83
+ (convention: first initial + last name, all lowercase — e.g. John Smith → `jsmith`)."
84
+ - Do **not** guess from the OS login or git config — ask and confirm.
85
+ - Normalize the answer to lowercase with no spaces.
86
+ 3. **Persist it** to Claude memory as a `user` memory named `author-username` (and add its
87
+ `MEMORY.md` pointer) so future captures never ask again.
88
+
89
+ `owners` is a **list of everyone who has worked on the doc — it may hold several names**,
90
+ not just one. Always include `AUTHOR_USERNAME`, and treat the field as cumulative:
91
+
92
+ - **New doc:** start `owners` with `["<AUTHOR_USERNAME>"]`.
93
+ - **Existing doc:** **union** — keep all existing owners and add `AUTHOR_USERNAME` if not
94
+ already present. Never replace or drop an existing owner.
95
+ - **Co-authors:** if more than one person worked on this feature (e.g. pairing, or a handoff
96
+ this session), ask "Anyone else who should be listed as an owner? (usernames, comma-separated,
97
+ same first-initial+last-name convention)" and add each — deduplicated, lowercase — to the list.
98
+ - Never leave `owners` empty.
99
+
74
100
  ## Step 2 — Determine framework / repo / project (ask if unknown)
75
101
 
76
102
  1. From the **live session context**, identify what was built, changed, debugged, or decided,
@@ -118,6 +144,8 @@ Write all docs to `<TEAM_REPO>/knowledge/...` — the git clone, not the project
118
144
 
119
145
  For every doc, set/refresh frontmatter: `framework`, `repo`, `project`, `client`,
120
146
  `type`, `status`, `updated` (today's date), `owners`, `files`, `related`.
147
+ Set `owners` to `["<AUTHOR_USERNAME>"]` from Step 1b — **never leave it empty**; when a doc
148
+ already has owners, add `AUTHOR_USERNAME` if missing rather than replacing.
121
149
  Add `related:` cross-links. Append new repos to `<TEAM_REPO>/knowledge/registry.json`.
122
150
 
123
151
  ## Step 6 — Validate, index, mirror back (mandatory)
@@ -224,7 +252,7 @@ client: <shared|client-slug>
224
252
  type: <feature|client-feature>
225
253
  status: active
226
254
  updated: <YYYY-MM-DD>
227
- owners: [<who>]
255
+ owners: ["<AUTHOR_USERNAME>"] # from Step 1b — never empty
228
256
  files:
229
257
  - <on-disk/path/one>
230
258
  related: [] # client-feature: link the shared apps/<repo>/features/<base>.md
@@ -262,7 +290,7 @@ client: <client-slug>
262
290
  type: workflow
263
291
  status: active
264
292
  updated: <YYYY-MM-DD>
265
- owners: [<who>]
293
+ owners: ["<AUTHOR_USERNAME>"] # from Step 1b — never empty
266
294
  files: []
267
295
  related: []
268
296
  ---
@@ -291,7 +319,7 @@ client: shared
291
319
  type: architecture
292
320
  status: active
293
321
  updated: <YYYY-MM-DD>
294
- owners: [<who>]
322
+ owners: ["<AUTHOR_USERNAME>"] # from Step 1b — never empty
295
323
  files: [<key paths>]
296
324
  related: []
297
325
  ---
@@ -310,7 +338,7 @@ client: shared
310
338
  type: standard
311
339
  status: active
312
340
  updated: <YYYY-MM-DD>
313
- owners: [<who>]
341
+ owners: ["<AUTHOR_USERNAME>"] # from Step 1b — never empty
314
342
  files: []
315
343
  related: []
316
344
  ---