Skip to content

docs: fix stale capability table + NOT-auto claims in kernel docs - #276

Merged
akromicc merged 1 commit into
mainfrom
docs/kernel-docs-refresh-2026-08
Aug 15, 2026
Merged

docs: fix stale capability table + NOT-auto claims in kernel docs#276
akromicc merged 1 commit into
mainfrom
docs/kernel-docs-refresh-2026-08

Conversation

@akromicc

Copy link
Copy Markdown
Contributor

Summary

  • permissions.md's addon-capability table was missing connector:read (real, enforced kind in security/context.go, used by cross-addon connector_get dispatch) — added.
  • Added a note that manifest v3's rbac{} block (manifest/v3/types.go) is schema-only: no Go code outside types.go consumes Manifest.RBAC, so it's not a live permission system yet. Prevents addon authors from building on a dead field.
  • dynamic-system.md's "What is NOT auto" table claimed computed columns needed a custom handler and said nothing about row-status automation — both are wrong/incomplete now: manifest v3 formulas[]/rollup and stage_field/stages[]/transitions[]/on_transition[] make both automatic. Fixed the table and added a short pointer to the SDK's manifest-spec.md (companion PR docs: refresh addon-authoring docs (v3 manifest, real publish flow, full WASM ABI) metacore-sdk#748) for the full field reference, rather than duplicating it here.

Scoped narrowly to verified factual errors/gaps in the kernel's internal docs (as opposed to addon-authoring docs, which live in metacore-sdk and were just refreshed there).

Test plan

  • Docs-only change, no code touched.

- add missing connector:read capability kind (security/context.go) to the
  addon-capability table in permissions.md
- document manifest v3 rbac{} as schema-only / unenforced (no Go consumer
  outside types.go) so addon authors don't build on a dead field
- correct dynamic-system.md's NOT-auto table: computed columns (formulas/
  rollup) and row-status automation (stage_field/stages/transitions) are
  now auto via manifest v3, not addon-handler-only as previously stated
@coderabbitai

coderabbitai Bot commented Aug 15, 2026

Copy link
Copy Markdown

Important

Review available on request

  • 🔍 Trigger review

Reviews should be triggered manually for repositories with fewer than 10 stars. Select Trigger review above or comment @coderabbitai review to review the latest changes. For a full review, comment @coderabbitai full review.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: fb5cd2fe-17b1-4b74-9ab0-19b917f2e214


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@akromicc
akromicc merged commit 0bbb14b into main Aug 15, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant