codeassembly-guidance 0.6.0 → 0.7.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/.meta/changelog.json +185 -0
- package/CHANGELOG.md +45 -0
- package/README.md +29 -51
- package/content/_partials/kb-unsearched-private-stores.md +6 -0
- package/content/codeassembly-content.yaml +2 -0
- package/content/guidance/rulebooks/live-worktree-policy.md +2 -2
- package/content/guidance/rulebooks/williamthorsen-ticketing-preferences.md +3 -1
- package/content/guidance/shared/AGENTS.md +1 -1
- package/content/scripts/check-prose.mjs +1 -1
- package/content/scripts/describe-change.mjs +89 -89
- package/content/scripts/manage-jira-ticket.mjs +113 -113
- package/content/scripts/select-lede-exemplars.mjs +85 -85
- package/content/scripts/validate-preferences.mjs +38 -38
- package/content/skills/_data/project-stage.md +9 -5
- package/content/skills/_data/spike-conventions.md +9 -6
- package/content/skills/_partials/implementation-order-list.md +27 -0
- package/content/skills/_partials/next-steps-after-plan.md +2 -2
- package/content/skills/_partials/plan-template.md +2 -0
- package/content/skills/_partials/split-launch-prompts.md +1 -1
- package/content/skills/align-ticket-with-implementation/SKILL.md +1 -1
- package/content/skills/assess-code-health/SKILL.md +2 -2
- package/content/skills/assess-usability/SKILL.md +2 -2
- package/content/skills/capture-event/SKILL.md +20 -11
- package/content/skills/capture-event/capture-event.mjs +122 -122
- package/content/skills/capture-feedback/SKILL.md +2 -1
- package/content/skills/capture-lede-decision/capture-lede-decision.mjs +97 -97
- package/content/skills/create-pr/SKILL.md +11 -11
- package/content/skills/create-ticket/resolve-ticket-target.mjs +92 -92
- package/content/skills/curate-feedback/curate-feedback.mjs +82 -82
- package/content/skills/derive-session-context/derive-session-context.mjs +107 -107
- package/content/skills/design-and-plan/SKILL.md +4 -2
- package/content/skills/implement-plan/SKILL.md +3 -1
- package/content/skills/implementation-order/implementation-order.mjs +67 -0
- package/content/skills/investigate-spike/SKILL.md +1 -1
- package/content/skills/kb-add/SKILL.md +12 -3
- package/content/skills/kb-add/kb-add.mjs +88 -88
- package/content/skills/kb-curate/kb-curate.mjs +88 -88
- package/content/skills/kb-edit/kb-edit.mjs +90 -90
- package/content/skills/kb-retrieve/SKILL.md +8 -3
- package/content/skills/kb-retrieve/kb-retrieve.mjs +104 -104
- package/content/skills/kb-retrieve-events/SKILL.md +8 -3
- package/content/skills/kb-retrieve-events/kb-retrieve-events.mjs +113 -113
- package/content/skills/kb-update-events/kb-update-events.mjs +92 -92
- package/content/skills/lesson-clusters/lesson-clusters.mjs +102 -102
- package/content/skills/list-implementation-order/SKILL.md +23 -0
- package/content/skills/merge-bb-pr/SKILL.md +31 -8
- package/content/skills/merge-gh-pr/SKILL.md +25 -12
- package/content/skills/merge-gh-pr/merge-gh-pr.mjs +13 -8
- package/content/skills/merge-pr/SKILL.md +55 -20
- package/content/skills/migrate-feedback-memories/SKILL.md +1 -0
- package/content/skills/plan/SKILL.md +3 -1
- package/content/skills/prepare-prototype-brief/SKILL.md +3 -1
- package/content/skills/refine-plan/SKILL.md +2 -0
- package/content/skills/review-branch/SKILL.md +1 -1
- package/content/skills/review-criteria/SKILL.md +1 -1
- package/content/skills/revise-prose/revise-prose.mjs +111 -111
- package/content/skills/save-plan/SKILL.md +2 -0
- package/content/skills/streamline-guidance/streamline-guidance.mjs +76 -76
- package/content/skills/summarize-change/SKILL.md +17 -7
- package/content/skills/testing-conventions/SKILL.md +2 -2
- package/content/skills/triage-feedback/SKILL.md +4 -0
- package/content/skills/triage-spike-findings/SKILL.md +10 -5
- package/content/skills/wrap-up/SKILL.md +4 -0
- package/package.json +9 -9
- package/schemas/preferences.v1.json +74 -8
- package/schemas/work-types.v1.json +1 -1
|
@@ -27,9 +27,9 @@ A value-bearing flag accepts both `--tag fix` and `--tag=fix`. A repeated `--exc
|
|
|
27
27
|
|
|
28
28
|
### Scope
|
|
29
29
|
|
|
30
|
-
By default the helper searches
|
|
30
|
+
By default the helper searches the knowledge base discovered by walking up from the current directory for a `.kb/` folder, the registry's `default_kb`, and every registry entry that declares `in_default_scope: true` (see the `kb.yaml` registry's own documentation in `@williamthorsen/kb`). A knowledge base that more than one source admits is searched once. `in_default_scope: false` does not exclude a knowledge base that discovery or `default_kb` admits. `--all-kbs` widens the search to every knowledge base in the merged `kb.yaml` registry.
|
|
31
31
|
|
|
32
|
-
`--store <name>` (alias `--kb <name>`) narrows the search to a single registered knowledge base, resolved by registry
|
|
32
|
+
`--store <name>` (alias `--kb <name>`) narrows the search to a single registered knowledge base, resolved by name against the merged `kb.yaml` registry (user and project): The helper does not run a `.kb/` discovery walk. A name that does not match any registry entry yields an empty result with an explanatory diagnostic.
|
|
33
33
|
|
|
34
34
|
Within each knowledge base, recall is limited to the notes declared by the store, the files matching its configured `targets`/`exclude` (the same note set that `kb check` enforces). Events are stored under `content/events/`.
|
|
35
35
|
|
|
@@ -67,6 +67,7 @@ The helper prints a JSON object to stdout:
|
|
|
67
67
|
- `candidates`: An array of event candidates, each with `path`, `summary` (the event's human-readable summary, or the file basename when absent), `capturedAt` (its ISO-8601 capture timestamp, or `null`), `tags`, `snippet`, and `kbName`. Each also has `occurrences` (a coarse recurrence count of how many query-matched events share its `repo`) and, when present, `repo` (its `owner/name` repository), `addressedBy` (references recording what was done about the problem that it notes), and `impact` (the author's rating, one of `low` < `medium` < `high` < `critical`; absent when the event is unrated).
|
|
68
68
|
- `scopedKbs`: The knowledge bases that were actually searched.
|
|
69
69
|
- `warnings`: An array (possibly empty) of registry-health problems, present even when candidates are returned.
|
|
70
|
+
- `unsearchedPrivateStores`: The registered `private` stores that the recall did not search, each with `name` and `path`; an array, possibly empty, present even when candidates are returned.
|
|
70
71
|
- `diagnostic`: Present only when scope is empty or the query did not match any events.
|
|
71
72
|
|
|
72
73
|
### 2. Rank the candidates
|
|
@@ -102,6 +103,10 @@ When the helper returns a `diagnostic` without any candidates, report the empty
|
|
|
102
103
|
- `registry invalid: …`: The `kb.yaml` registry could not be loaded; entries that it would have contributed are missing from the search.
|
|
103
104
|
- `… path does not exist: …`: A registry entry names a knowledge base whose directory is absent on disk, so that KB was skipped; the entry or the directory needs fixing.
|
|
104
105
|
|
|
106
|
+
### 6. Disclose partial recall
|
|
107
|
+
|
|
108
|
+
<!-- include: ../../_partials/kb-unsearched-private-stores.md / -->
|
|
109
|
+
|
|
105
110
|
## Completion
|
|
106
111
|
|
|
107
|
-
A ranked list of relevant events with recurrence and addressed-by annotations, or a plain empty-result report.
|
|
112
|
+
A ranked list of relevant events with recurrence and addressed-by annotations, or a plain empty-result report, either one followed by the disclosure of any private store that the recall did not search.
|