Skip to content

ARCHITECTURE §6: the last cycle, from the side that was actually loose - #40

Merged
arpanghoshal merged 1 commit into
mainfrom
v0.12/2-cycle-and-properties
Sep 14, 2026
Merged

arpanghoshal merged 1 commit into
mainfrom
v0.12/2-cycle-and-properties

Conversation

@arpanghoshal

Copy link
Copy Markdown
Member

Pairs with the kernel PR of the same branch name.

§6 recorded policy <-> authority as the one cycle that stays. The reason was true but described one side only. The other side was authority.py importing the policy document grammar from policy.py, which is shared vocabulary rather than either axis's property; it now lives in grammar.py, below both, and SPEC-v0.3 §4.5's one-evaluator requirement is honoured more exactly than before.

Also here: the regenerated API reference, and three CLAIMS.md file paths the repointer cannot fix on its own, because it moves line numbers within a file and these symbols changed file.

all checks passed             (ruff, ruff format, 1727 passed)
api 83 pages 0 drifted · readiness 0 drifted · links 0 broken · lint 0 findings

🤖 Generated with Claude Code

§6 recorded `policy <-> authority` as the one cycle that stays, with a reason
that was true but described only one side: `_from_section` constructs an
`Authority` and `canonical_grants` consumes one, so neither moves below
`policy.py`, and moving their two callers up to `control.py` would change what
`policy_hash` is taken over.

The other side was `authority.py` importing eight names from `policy.py`, none
of them `Policy`: schemas, the strict loader, the condition grammar, type-strict
equality, key validation. That is the document grammar, and it is shared
vocabulary rather than either axis's property. It lives in `grammar.py` now.

The v0.3 exception is honoured more exactly rather than repealed. §4.5 requires
the two axes to share ONE condition evaluator; it is now owned by neither.

`CLAIMS.md` gains three corrected file paths the repointer cannot fix on its
own: it moves line numbers within a file and these symbols changed file.

Signed-off-by: arpan <contact@arpanghoshal.com>
@mintlify

mintlify Bot commented Sep 14, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
ctrlrun 🟢 Ready View Preview Sep 14, 2026, 10:09 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@coderabbitai

coderabbitai Bot commented Sep 14, 2026

Copy link
Copy Markdown

Warning

Review limit reached

Next included review available in 3 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: c4aa6659-b0ff-42f2-b174-e39d8cd64a00

📥 Commits

Reviewing files that changed from the base of the PR and between c9fb6d5 and 1c82ff0.

⛔ Files ignored due to path filters (4)
  • generated/readiness.full.mdx is excluded by !**/generated/**
  • generated/readiness.json is excluded by !**/generated/**
  • generated/readiness.mdx is excluded by !**/generated/**
  • generated/readiness.readme.md is excluded by !**/generated/**
📒 Files selected for processing (13)
  • docs.mdx
  • docs/ARCHITECTURE.md
  • docs/CLAIMS.md
  • docs/production/index.mdx
  • docs/reference/api/Authority.mdx
  • docs/reference/api/AuthorityResult.mdx
  • docs/reference/api/Condition.mdx
  • docs/reference/api/Delegation.mdx
  • docs/reference/api/Grant.mdx
  • docs/reference/api/Policy.mdx
  • docs/reference/api/Subject.mdx
  • docs/reference/api/authority-Budget.mdx
  • docs/reference/api/parse_conditions.mdx

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.

@arpanghoshal
arpanghoshal merged commit f832162 into main Sep 14, 2026
3 checks passed
@arpanghoshal
arpanghoshal deleted the v0.12/2-cycle-and-properties branch September 15, 2026 19:15
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