codeassembly-guidance 0.0.0 → 0.1.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 +563 -0
- package/CHANGELOG.md +134 -0
- package/LICENSE +7 -0
- package/README.md +165 -1
- package/content/_partials/README.md +192 -0
- package/content/_partials/code-descriptions.md +4 -0
- package/content/_partials/code-style.md +7 -0
- package/content/_partials/comment-discipline.md +89 -0
- package/content/_partials/concision.md +3 -0
- package/content/_partials/diff-audit-checklist.md +9 -0
- package/content/_partials/file-access.md +4 -0
- package/content/_partials/live-repo-writes.md +13 -0
- package/content/_partials/plain-speech-calibration.md +66 -0
- package/content/_partials/plain-speech.md +13 -0
- package/content/_partials/prose-line-breaks.md +3 -0
- package/content/_partials/record-marker.md +1 -0
- package/content/_partials/reduced-object-relative.md +28 -0
- package/content/_partials/shell-commands.md +3 -0
- package/content/_partials/target-file-set-resolution.md +22 -0
- package/content/_partials/technical-recommendations.md +5 -0
- package/content/_partials/test-structure-audit-checklist.md +7 -0
- package/content/_partials/ticket-assessment-baseline.md +12 -0
- package/content/_partials/ticket-assessment.md +202 -0
- package/content/_partials/work-type-choice.md +13 -0
- package/content/codeassembly-content.yaml +49 -0
- package/content/collections/all.md +11 -0
- package/content/collections/atlassian.md +16 -0
- package/content/collections/recommended.md +34 -0
- package/content/collections/triage.md +77 -0
- package/content/collections/williamthorsen.md +25 -0
- package/content/guidance/README.md +22 -0
- package/content/guidance/_harnesses/claude/CLAUDE.md +6 -0
- package/content/guidance/_harnesses/rovo/AGENTS.md +5 -0
- package/content/guidance/_harnesses/rovo/codeassembly-guidance.md +4 -0
- package/content/guidance/rulebooks/accessibility-conventions.md +20 -0
- package/content/guidance/rulebooks/codeassembly-content-specification.md +161 -0
- package/content/guidance/rulebooks/command-output-conventions.md +14 -0
- package/content/guidance/rulebooks/commit-conventions.md +72 -0
- package/content/guidance/rulebooks/generated-content-policy.md +10 -0
- package/content/guidance/rulebooks/live-worktree-policy.md +18 -0
- package/content/guidance/rulebooks/readme-conventions.md +74 -0
- package/content/guidance/rulebooks/shared-data-conventions.md +14 -0
- package/content/guidance/rulebooks/shell-conventions.md +279 -0
- package/content/guidance/rulebooks/williamthorsen-code-layout-preferences.md +102 -0
- package/content/guidance/rulebooks/williamthorsen-collaboration-preferences.md +58 -0
- package/content/guidance/rulebooks/williamthorsen-comment-preferences.md +30 -0
- package/content/guidance/rulebooks/williamthorsen-subagent-model-preferences.md +15 -0
- package/content/guidance/rulebooks/williamthorsen-ticketing-preferences.md +22 -0
- package/content/guidance/rulebooks/williamthorsen-tooling-preferences.md +36 -0
- package/content/guidance/rulebooks/williamthorsen-typescript-preferences.md +90 -0
- package/content/guidance/rulebooks/williamthorsen-workflow-preferences.md +58 -0
- package/content/guidance/rulebooks/williamthorsen-writing-preferences.md +80 -0
- package/content/guidance/shared/AGENTS.md +43 -0
- package/content/scripts/README.md +41 -0
- package/content/scripts/describe-change.mjs +165 -0
- package/content/scripts/get-ticket-id.sh +131 -0
- package/content/scripts/manage-jira-ticket.mjs +209 -0
- package/content/scripts/resolve-frontmatter.sh +540 -0
- package/content/scripts/resolve-review-run.mjs +12 -0
- package/content/scripts/select-lede-exemplars.mjs +208 -0
- package/content/skills/_data/action-items.md +83 -0
- package/content/skills/_data/artifact-conventions.md +969 -0
- package/content/skills/_data/bitbucket-pr-access.md +89 -0
- package/content/skills/_data/branch-format.md +34 -0
- package/content/skills/_data/change-record.md +163 -0
- package/content/skills/_data/complexity-classification.md +58 -0
- package/content/skills/_data/concision.md +23 -0
- package/content/skills/_data/deployed-file-provenance.md +46 -0
- package/content/skills/_data/design-priorities.md +76 -0
- package/content/skills/_data/gh-body-file.md +30 -0
- package/content/skills/_data/git-commands.md +39 -0
- package/content/skills/_data/naming-conventions.md +50 -0
- package/content/skills/_data/pr-resolution.md +25 -0
- package/content/skills/_data/pr-source-resolution.md +36 -0
- package/content/skills/_data/recommendation-gradient.md +90 -0
- package/content/skills/_data/scope-and-deferral.md +83 -0
- package/content/skills/_data/spike-conventions.md +89 -0
- package/content/skills/_data/ticket-evaluation.md +13 -0
- package/content/skills/_data/ticket-id-extraction.md +43 -0
- package/content/skills/_data/ticket-source-resolution.md +147 -0
- package/content/skills/_data/title-templates.md +624 -0
- package/content/skills/_data/title-voice.md +17 -0
- package/content/skills/_data/work-types.json +168 -0
- package/content/skills/_partials/acceptance-criteria-scaffold.md +15 -0
- package/content/skills/_partials/action-items.md +22 -0
- package/content/skills/_partials/bitbucket-delete-both-refusal.md +3 -0
- package/content/skills/_partials/commit-title-rendering.md +14 -0
- package/content/skills/_partials/gh-body-file.md +22 -0
- package/content/skills/_partials/nested-list-indent.md +9 -0
- package/content/skills/_partials/next-steps-after-plan.md +99 -0
- package/content/skills/_partials/next-steps-after-review.md +350 -0
- package/content/skills/_partials/option-format.md +84 -0
- package/content/skills/_partials/plan-template.md +97 -0
- package/content/skills/_partials/split-launch-prompts.md +5 -0
- package/content/skills/_partials/split-ticket-compose.md +5 -0
- package/content/skills/_partials/split-ticket-create.md +3 -0
- package/content/skills/_partials/ticket-and-plan-completeness.md +33 -0
- package/content/skills/_partials/ticket-concision.md +18 -0
- package/content/skills/_partials/ticket-criteria-conventions.md +7 -0
- package/content/skills/_partials/ticket-placement.md +14 -0
- package/content/skills/_partials/ticket-skeleton-tiers.md +6 -0
- package/content/skills/_partials/ticket-skeleton.md +13 -0
- package/content/skills/add-change-record/SKILL.md +136 -0
- package/content/skills/add-test-ids/SKILL.md +51 -0
- package/content/skills/align-ticket-with-implementation/SKILL.md +115 -0
- package/content/skills/anti-patterns/SKILL.md +57 -0
- package/content/skills/assess-ticket/SKILL.md +46 -0
- package/content/skills/assess-ticket/next-steps-after-assessment.md +98 -0
- package/content/skills/brainstorming/SKILL.md +107 -0
- package/content/skills/capture-event/SKILL.md +108 -0
- package/content/skills/capture-event/capture-event.mjs +216 -0
- package/content/skills/capture-feedback/SKILL.md +71 -0
- package/content/skills/capture-lede-decision/SKILL.md +163 -0
- package/content/skills/capture-lede-decision/capture-lede-decision.mjs +231 -0
- package/content/skills/classify-complexity/SKILL.md +92 -0
- package/content/skills/collaborate/SKILL.md +86 -0
- package/content/skills/condense-branch/SKILL.md +83 -0
- package/content/skills/create-bitbucket-pr/SKILL.md +87 -0
- package/content/skills/create-commit/SKILL.md +65 -0
- package/content/skills/create-devlog/SKILL.md +108 -0
- package/content/skills/create-gh-pr/SKILL.md +106 -0
- package/content/skills/create-pr/SKILL.md +150 -0
- package/content/skills/create-ticket/SKILL.md +350 -0
- package/content/skills/derive-session-context/derive-session-context.mjs +148 -0
- package/content/skills/design-and-plan/SKILL.md +194 -0
- package/content/skills/development-workflows/SKILL.md +41 -0
- package/content/skills/get-ticket-id/SKILL.md +67 -0
- package/content/skills/groom-backlog/SKILL.md +245 -0
- package/content/skills/groom-backlog/groom-backlog.mjs +106 -0
- package/content/skills/implement-plan/SKILL.md +164 -0
- package/content/skills/index-prototypes/SKILL.md +145 -0
- package/content/skills/index-prototypes/index-prototypes.mjs +328 -0
- package/content/skills/kb-add/SKILL.md +156 -0
- package/content/skills/kb-add/kb-add.mjs +216 -0
- package/content/skills/kb-curate/SKILL.md +117 -0
- package/content/skills/kb-curate/kb-curate.mjs +213 -0
- package/content/skills/kb-edit/SKILL.md +128 -0
- package/content/skills/kb-edit/kb-edit.mjs +219 -0
- package/content/skills/kb-retrieve/SKILL.md +100 -0
- package/content/skills/kb-retrieve/kb-retrieve.mjs +206 -0
- package/content/skills/kb-retrieve-events/SKILL.md +98 -0
- package/content/skills/kb-retrieve-events/kb-retrieve-events.mjs +206 -0
- package/content/skills/kb-update-events/SKILL.md +77 -0
- package/content/skills/kb-update-events/kb-update-events.mjs +215 -0
- package/content/skills/merge-bb-pr/SKILL.md +136 -0
- package/content/skills/merge-gh-pr/SKILL.md +167 -0
- package/content/skills/merge-gh-pr/merge-gh-pr.mjs +10 -0
- package/content/skills/merge-pr/SKILL.md +368 -0
- package/content/skills/migrate-feedback-memories/SKILL.md +136 -0
- package/content/skills/migrate-feedback-memories/feedback-memories.mjs +161 -0
- package/content/skills/people-report/SKILL.md +208 -0
- package/content/skills/plan/SKILL.md +87 -0
- package/content/skills/prepare-prototype-brief/SKILL.md +126 -0
- package/content/skills/pull-from-backlog/SKILL.md +83 -0
- package/content/skills/pull-from-backlog/pull-from-backlog.mjs +208 -0
- package/content/skills/refine-plan/SKILL.md +259 -0
- package/content/skills/respond-to-review/SKILL.md +292 -0
- package/content/skills/review-bb-pr/SKILL.md +161 -0
- package/content/skills/review-branch/SKILL.md +301 -0
- package/content/skills/review-criteria/SKILL.md +108 -0
- package/content/skills/review-gh-pr/SKILL.md +155 -0
- package/content/skills/review-gh-pr/select-pr-ticket.mjs +8 -0
- package/content/skills/review-permissions/SKILL.md +39 -0
- package/content/skills/review-pr/SKILL.md +123 -0
- package/content/skills/revise-comments/SKILL.md +115 -0
- package/content/skills/revise-prose/SKILL.md +197 -0
- package/content/skills/revise-prose/revise-prose.mjs +229 -0
- package/content/skills/save-artifact/SKILL.md +69 -0
- package/content/skills/save-plan/SKILL.md +55 -0
- package/content/skills/software-engineering/SKILL.md +74 -0
- package/content/skills/streamline-guidance/SKILL.md +174 -0
- package/content/skills/streamline-guidance/streamline-guidance.mjs +211 -0
- package/content/skills/summarize-change/SKILL.md +308 -0
- package/content/skills/summarize-chat/SKILL.md +100 -0
- package/content/skills/systematic-debugging/SKILL.md +308 -0
- package/content/skills/systematic-debugging/condition-based-waiting-example.ts +160 -0
- package/content/skills/systematic-debugging/condition-based-waiting.md +122 -0
- package/content/skills/systematic-debugging/defense-in-depth.md +130 -0
- package/content/skills/systematic-debugging/find-polluter.sh +68 -0
- package/content/skills/systematic-debugging/root-cause-tracing.md +185 -0
- package/content/skills/systematic-debugging/test-academic.md +16 -0
- package/content/skills/systematic-debugging/test-pressure-1.md +67 -0
- package/content/skills/systematic-debugging/test-pressure-2.md +77 -0
- package/content/skills/systematic-debugging/test-pressure-3.md +77 -0
- package/content/skills/testing-conventions/SKILL.md +168 -0
- package/content/skills/testing-conventions/mistakes.md +1 -0
- package/content/skills/typescript-testing-conventions/SKILL.md +129 -0
- package/content/skills/update-jira-ticket/SKILL.md +245 -0
- package/content/skills/update-jira-ticket/update-jira-ticket.mjs +9 -0
- package/content/skills/update-project-guidance/SKILL.md +300 -0
- package/content/skills/upgrade-dependencies/SKILL.md +139 -0
- package/content/skills/wrap-up/SKILL.md +431 -0
- package/content/subagents/_data/claude.yaml +19 -0
- package/content/subagents/_data/rovo.yaml +31 -0
- package/content/subagents/canary.md +11 -0
- package/content/subagents/entry-drafter.md +187 -0
- package/content/subagents/handoff-reviewer.md +75 -0
- package/content/subagents/plan-reviewer.md +184 -0
- package/content/subagents/plan-reviser.md +88 -0
- package/content/subagents/prose-reviser.md +130 -0
- package/content/subagents/ticket-assessor.md +139 -0
- package/package.json +70 -2
- package/schemas/preferences.v1.json +294 -0
- package/schemas/work-types.v1.json +142 -0
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: kb-curate
|
|
3
|
+
description: Audit a knowledge base for vault-wide hygiene (broken wikilinks, hardcoded paths, tag drift, stale verification, and supersede-chain defects) and optionally apply a curated safe set of fixes
|
|
4
|
+
user-invocable: true
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Curate a knowledge base
|
|
8
|
+
|
|
9
|
+
Report vault-wide hygiene findings for a single knowledge base and, with `--apply`, perform only the two mechanically safe fixes. A bundled helper does the mechanical work: It resolves the KB, walks every note, runs the detection rules, and (under `--apply`) delegates tag canonicalization to `kb-edit` and rewrites stale path-qualified wikilinks inline. You do the judgment work: Read the findings, decide which report-only items to act on, and run the named follow-up commands.
|
|
10
|
+
|
|
11
|
+
The split is deliberate: Detection is exhaustive and mechanical; remediation is conservative. The helper auto-fixes only what is mechanically safe and leaves everything else as a report-only finding that names the operator's next step.
|
|
12
|
+
|
|
13
|
+
For a single note's edit, use `kb-edit`. For new notes, use `kb-add`. For finding notes, use `kb-retrieve`.
|
|
14
|
+
|
|
15
|
+
**Announce at start:** "Using kb-curate to {audit | audit and fix} the {kb name} knowledge base."
|
|
16
|
+
|
|
17
|
+
## Arguments
|
|
18
|
+
|
|
19
|
+
| Argument | Description | Required |
|
|
20
|
+
| ------------------- | ------------------------------------------------------------------------------------------------------ | -------- |
|
|
21
|
+
| `--kb <name>` | The knowledge base to curate, or `@default` for the registry default. Defaults to a discovered `.kb/`. | No |
|
|
22
|
+
| `--apply` | Perform the two safe fixes (tag canonicalization, path-only wikilink rewrites). Default off. | No |
|
|
23
|
+
| `--stale-after <n>` | Verification-staleness threshold in whole days. Positive integer; defaults to 90. | No |
|
|
24
|
+
|
|
25
|
+
A value-bearing flag accepts both `--kb coding` and `--kb=coding`. Without flags, the helper produces a read-only report.
|
|
26
|
+
|
|
27
|
+
### KB selection
|
|
28
|
+
|
|
29
|
+
The knowledge base is resolved the same way as `kb-add`: A concrete `--kb <name>` takes precedence over a discovered `.kb/` folder, and the registry's `default_kb` is reachable only via `--kb @default`. When `--kb` is not given and a `.kb/` folder is not discoverable, the run is refused rather than defaulting. A read-only report run accepts a KB marked `readonly: true` in `kb.yaml`; `--apply` against a readonly KB is refused with `readonly-kb`. Each run curates a single KB: Wikilink resolution and supersede chains are only valid within one vault, so curating several vaults is a shell loop over `--kb`.
|
|
30
|
+
|
|
31
|
+
The store's `.kb/config.yaml` decides which notes are curated: By default, only notes under `content/` are enumerated. A store with a different layout overrides the `targets` glob in its `config.yaml`. A malformed `config.yaml`, `tag-aliases.yaml`, or `taxonomy.yaml` fails the run with `invalid-config` rather than being silently ignored.
|
|
32
|
+
|
|
33
|
+
## Runtime dependencies
|
|
34
|
+
|
|
35
|
+
- **`node` ≥ 24**: The bundled helper inherits the Node version floor of `@williamthorsen/kb`.
|
|
36
|
+
- **Sibling `kb-edit.mjs`**: Required only for `--apply` tag canonicalization. The helper resolves it next to its own bundle; if the skills are deployed without co-location, tag fixes fail with a clear message while the read-only report and the wikilink sweep are unaffected.
|
|
37
|
+
|
|
38
|
+
## Detection categories
|
|
39
|
+
|
|
40
|
+
The helper reports findings across six categories. Each finding has a rule code and a severity. A `[[store:Target]]` link resolves against the store named by its prefix in the `kb.yaml` registry, and only into a store as shareable as this one; see the kb package's README for the rule.
|
|
41
|
+
|
|
42
|
+
| Rule code | Severity | Meaning |
|
|
43
|
+
| ------------------------------- | -------- | ----------------------------------------------------------------------------------------------- |
|
|
44
|
+
| `wikilinks.unresolved` | error | A `[[Target]]` does not resolve to any vault note. |
|
|
45
|
+
| `wikilinks.basename` | warning | Two or more notes share a basename (reported once for the vault). |
|
|
46
|
+
| `wikilinks.unknown-store` | error | A `[[store:Target]]` names a store not declared by any `kb.yaml` entry. |
|
|
47
|
+
| `wikilinks.disallowed-store` | error | A `[[store:Target]]` names a store less shareable than this one. |
|
|
48
|
+
| `wikilinks.store-unavailable` | warning | A `[[store:Target]]` names a store that could not be read on this machine. |
|
|
49
|
+
| `wikilinks.registry-unloadable` | error | `kb.yaml` would not load, so a `[[store:Target]]` cannot resolve (once per run). |
|
|
50
|
+
| `paths.user-home` | error | A hardcoded `/Users/{name}/` path; use `~/` instead. |
|
|
51
|
+
| `tag-alias` | warning | A `tags` entry is a known alias of a canonical tag. |
|
|
52
|
+
| `taxonomy.undeclared` | warning | A folder contains notes but `.kb/taxonomy.yaml` does not declare a domain for it. |
|
|
53
|
+
| `taxonomy.unused` | warning | A declared domain does not have a note at or beneath it. |
|
|
54
|
+
| `taxonomy.orphan` | warning | A declared domain's parent is undeclared. |
|
|
55
|
+
| `verification.unmarked` | warning | The note does not have a `last-verified` field; reported only when the vault uses verification. |
|
|
56
|
+
| `verification.stale` | warning | `last-verified` is older than `--stale-after` days. |
|
|
57
|
+
| `supersede.dangling` | error | A `superseded-by`/`supersedes` target is not a vault note. |
|
|
58
|
+
| `supersede.cycle` | error | The note is in a `superseded-by` loop. |
|
|
59
|
+
| `supersede.asymmetric` | warning | `A.superseded-by → B` without the matching `B.supersedes → A`. |
|
|
60
|
+
|
|
61
|
+
The three `taxonomy.*` rules describe the vault rather than a note, so each is reported once against `.kb/taxonomy.yaml` with the domain named in the message. They are self-configuring in the same way `verification.unmarked` is: The helper reports none of them for a vault whose `.kb/taxonomy.yaml` is absent, or present but declaring nothing.
|
|
62
|
+
|
|
63
|
+
`verification.unmarked` is self-configuring: It is reported only when the vault actually uses verification (that is, when at least one note has a well-formed `last-verified` value). In a vault that has not adopted verification stamps, an unmarked note is not a finding. A malformed `last-verified` value does not count as adoption, so the helper does not report any unmarked findings for a vault whose only verification-ish value is unparseable. `verification.stale` is unaffected: A note with a stale `last-verified` is always flagged.
|
|
64
|
+
|
|
65
|
+
## Remediation under `--apply`
|
|
66
|
+
|
|
67
|
+
Only two fixes are applied; everything else stays report-only.
|
|
68
|
+
|
|
69
|
+
- **Tag canonicalization**: For each note with a `tag-alias` finding, the helper invokes `{skill:kb-edit} --retag` once with the note's current tags, so that `kb-edit` remains the sole writer of frontmatter. `kb-edit` rewrites each tag through the KB's alias map.
|
|
70
|
+
- **Path-only wikilink rewrites**: A cross-file sweep that normalizes a link's stale path prefix when its basename resolves to exactly one note. Only path-qualified links (those containing a `/`) are repaired: A bare-basename link that resolves uniquely is valid, does not produce a finding, and is left untouched, so remediation never changes a vault's link style. The rewrite preserves any `|alias`, `#anchor`, and the path-qualified style; unresolved and ambiguous links are never auto-rewritten.
|
|
71
|
+
|
|
72
|
+
Each fix returns a per-finding result reporting `ok: true/false` and the operation invoked. A single fix failure does not abort the run.
|
|
73
|
+
|
|
74
|
+
### Report-only follow-ups
|
|
75
|
+
|
|
76
|
+
The remaining findings name the operator's next step:
|
|
77
|
+
|
|
78
|
+
- **Stale or unmarked verification** → re-confirm the note, then `kb-edit <path> --verify`.
|
|
79
|
+
- **Supersede defects** → repair with `kb-edit <old> --supersede-with <new>`, or correct the offending frontmatter field.
|
|
80
|
+
- **Taxonomy drift** → declare the folder in `.kb/taxonomy.yaml`, or move the notes to a declared domain. On a vault adopting a taxonomy for the first time, `kb taxonomy init` declares every folder that already contains notes in one pass.
|
|
81
|
+
- **Unresolved wikilinks, basename collisions, hardcoded paths** → resolve manually; these are too context-dependent to auto-fix.
|
|
82
|
+
|
|
83
|
+
## Process
|
|
84
|
+
|
|
85
|
+
### 1. Run the read-only report first
|
|
86
|
+
|
|
87
|
+
Always start without `--apply`. Read the findings and decide which report-only items warrant action.
|
|
88
|
+
|
|
89
|
+
```bash
|
|
90
|
+
node {harness_home_dir}/skills/kb-curate/kb-curate.mjs --kb coding
|
|
91
|
+
node {harness_home_dir}/skills/kb-curate/kb-curate.mjs --kb coding --stale-after 30
|
|
92
|
+
```
|
|
93
|
+
|
|
94
|
+
### 2. Apply the safe fixes when warranted
|
|
95
|
+
|
|
96
|
+
```bash
|
|
97
|
+
node {harness_home_dir}/skills/kb-curate/kb-curate.mjs --kb coding --apply
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
### 3. Handle the result
|
|
101
|
+
|
|
102
|
+
The helper prints a JSON object to stdout. On success the payload contains `ok: true`, the run `mode` (`report` or `apply`), the resolved `kb`, the `findings` array, a severity `summary`, and (under `--apply`) an `applied` array of per-fix results. Under `--apply`, the reported `findings` are the residual findings after the fixes ran.
|
|
103
|
+
|
|
104
|
+
On failure, `ok: false` plus a categorical `error` code:
|
|
105
|
+
|
|
106
|
+
| Code | What it means | What to do |
|
|
107
|
+
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
|
|
108
|
+
| `invalid-args` | Unknown flag, missing value, or a non-positive-integer `--stale-after`. | Correct the invocation. The message names the specific defect. |
|
|
109
|
+
| `invalid-config` | A malformed `.kb/config.yaml`, `.kb/tag-aliases.yaml`, or `.kb/taxonomy.yaml` in the store. | Fix the named file. The message names the offending file. |
|
|
110
|
+
| `no-kb-resolvable` | A KB could not be resolved: `--kb` did not match an entry, or `--kb` was absent and `.kb/` was not discoverable, or `--kb @default` was passed without a configured default. | Confirm the `--kb` name, run from inside the vault, or pass `--kb @default`. |
|
|
111
|
+
| `readonly-kb` | `--apply` was used against a KB marked `readonly: true` in `kb.yaml`. | Drop `--apply` for a read-only report, or use a writable KB. |
|
|
112
|
+
|
|
113
|
+
System failures (out-of-disk, permission denied) print to stderr and exit non-zero. They are out of band and never appear as a structured `error` code.
|
|
114
|
+
|
|
115
|
+
## Completion
|
|
116
|
+
|
|
117
|
+
A hygiene report for the resolved KB, partitioned by severity, with each report-only finding naming its follow-up command. Under `--apply`, the safe fixes are written and the residual findings plus per-fix results are reported so that the user can verify what changed and what remains.
|