Make GitHub issues the canonical tracker#47
Merged
Conversation
|
Warning Review limit reached
More reviews will be available in 36 minutes and 11 seconds. Learn how PR review limits work. Your organization has used up its prepaid credits, and credit purchases are no longer available. Enable the review add-on in the billing tab to keep reviews running — you're only billed for reviews past your plan's rate limits ($0.25/file). ⌛ How to resolve this issue?After more reviews become available, a review can be triggered using the We recommend that you space out your commits to avoid hitting the rate limit. 🚦 How do rate limits work?CodeRabbit enforces hourly rate limits for each developer per organization. Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available. Please see our Fair Usage Limits Policy for further information. ℹ️ Review info⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (19)
📝 WalkthroughWalkthroughThis pull request migrates the git-cas project's work-tracking methodology from repo-local backlog lanes to GitHub Issues/Milestones as the canonical source of truth. It establishes GitHub issue templates for six tracking categories, introduces a design documentation template and framework, creates release-scale goalpost documents spanning versions v6.0.1 through v7.0.0, reorganizes archived documentation, and updates all process/contribution guidance to reflect the new model. ChangesGitHub-first tracking infrastructure and documentation reorg
Estimated code review effort🎯 3 (Moderate) | ⏱️ ~25 minutes Possibly related issues
Possibly related PRs
Poem
🚥 Pre-merge checks | ✅ 4 | ❌ 1❌ Failed checks (1 warning)
✅ Passed checks (4 passed)
✏️ Tip: You can configure your own custom pre-merge checks in the settings. ✨ Finishing Touches🧪 Generate unit tests (beta)
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. Comment |
Member
Author
|
@codex Self-review findings for PR #47. I reviewed
Severity count: Critical 1, High 1, Medium 4, Low 2. |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 3
Caution
Some comments are outside the diff and can’t be posted inline due to platform limitations.
⚠️ Outside diff range comments (1)
CLAUDE.md (1)
1-2:⚠️ Potential issue | 🔴 CriticalFix broken documentation link in
CLAUDE.md: addAGENTS.md(or change the redirect).
CLAUDE.mdnow redirects to./AGENTS.md, butAGENTS.mddoes not exist in the repository, so the displaced guidance is currently unavailable. This is a critical documentation regression.🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@CLAUDE.md` around lines 1 - 2, CLAUDE.md currently links to a non-existent AGENTS.md causing a broken redirect; fix it by either adding a new AGENTS.md with the displaced guidance (create AGENTS.md containing the intended documentation) or update the link in CLAUDE.md to point to the correct existing file or remove the redirect; ensure the link text and relative path in CLAUDE.md (the "AGENTS.md" reference) are updated to match the chosen fix.Source: Learnings
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@docs/archive/goalposts-pre-issues/v6.0.1/release-truth-closeout.md`:
- Line 10: Update the goalpost identity table entries to point to the archived
path: in docs/archive/goalposts-pre-issues/v6.0.1/release-truth-closeout.md
(L10) replace docs/goalposts/v6.0.1/release-truth-closeout.md with
docs/archive/goalposts-pre-issues/v6.0.1/release-truth-closeout.md; in
docs/archive/goalposts-pre-issues/v6.1.0/bounded-residency.md (L10) replace
docs/goalposts/v6.1.0/bounded-residency.md with
docs/archive/goalposts-pre-issues/v6.1.0/bounded-residency.md; in
docs/archive/goalposts-pre-issues/v6.2.0/operator-tui.md (L10) replace
docs/goalposts/v6.2.0/operator-tui.md with
docs/archive/goalposts-pre-issues/v6.2.0/operator-tui.md; and in
docs/archive/goalposts-pre-issues/v6.3.0/agent-automation-parity.md (L10)
replace docs/goalposts/v6.3.0/agent-automation-parity.md with
docs/archive/goalposts-pre-issues/v6.3.0/agent-automation-parity.md.
In `@docs/archive/goalposts-pre-issues/v6.4.0/browser-edge-read-path.md`:
- Line 10: Update the Goalpost doc metadata that currently references
`docs/goalposts/v6.4.0/browser-edge-read-path.md` so it instead points to the
archived location
`docs/archive/goalposts-pre-issues/v6.4.0/browser-edge-read-path.md`; locate the
metadata entry in the file and replace the old path string with the archived
path string to ensure cross-doc links resolve to the archived goalpost.
In `@docs/MARKDOWN_SURFACE.md`:
- Around line 48-49: Replace the tracked markdown link to the local-only
AGENTS.md (the `AGENTS.md` link in the line referencing CLAUDE.md) with plain
text "AGENTS.md" (or update it to point to a tracked/committed document) so the
docs link validator no longer tries to resolve `../AGENTS.md`; keep the
surrounding text the same but remove the markdown link syntax.
---
Outside diff comments:
In `@CLAUDE.md`:
- Around line 1-2: CLAUDE.md currently links to a non-existent AGENTS.md causing
a broken redirect; fix it by either adding a new AGENTS.md with the displaced
guidance (create AGENTS.md containing the intended documentation) or update the
link in CLAUDE.md to point to the correct existing file or remove the redirect;
ensure the link text and relative path in CLAUDE.md (the "AGENTS.md" reference)
are updated to match the chosen fix.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: defaults
Review profile: CHILL
Plan: Pro
Run ID: 22df6da6-cddd-4142-8e4e-002b59136af2
📒 Files selected for processing (143)
.github/ISSUE_TEMPLATE/bug.yml.github/ISSUE_TEMPLATE/config.yml.github/ISSUE_TEMPLATE/debt.yml.github/ISSUE_TEMPLATE/goalpost.yml.github/ISSUE_TEMPLATE/idea.yml.github/ISSUE_TEMPLATE/slice.yml.github/pull_request_template.mdBEARING.mdCHANGELOG.mdCLAUDE.mdCONTRIBUTING.mdGRAVEYARD.mdGUIDE.mdMETHOD.mdREADME.mdROADMAP.mdSTATUS.mdWORKFLOW.mddocs/BACKLOG/README.mddocs/DOCS_CHECKLIST.mddocs/MARKDOWN_SURFACE.mddocs/archive/README.mddocs/archive/backlog-pre-issues/bad-code/BAD-CODE-001_casservice-god-object.mddocs/archive/backlog-pre-issues/bad-code/DOC_api-plumbing-constructor-drift.mddocs/archive/backlog-pre-issues/bad-code/DOC_examples-uint8array-drift.mddocs/archive/backlog-pre-issues/bad-code/DOC_threat-model-scheme-drift.mddocs/archive/backlog-pre-issues/bad-code/RL_agent-cli-module-size.mddocs/archive/backlog-pre-issues/bad-code/RL_credential-resolution-duplication.mddocs/archive/backlog-pre-issues/bad-code/SEC_chunk-constructor-property-leak.mddocs/archive/backlog-pre-issues/bad-code/SEC_concurrency-upper-bound.mddocs/archive/backlog-pre-issues/bad-code/SEC_encode-slug-control-chars.mddocs/archive/backlog-pre-issues/bad-code/SEC_framebytes-upper-bound.mddocs/archive/backlog-pre-issues/bad-code/SEC_inline-passphrase-flags.mddocs/archive/backlog-pre-issues/bad-code/SEC_kdf-salt-min-length.mddocs/archive/backlog-pre-issues/bad-code/SEC_recipient-timing-oracle.mddocs/archive/backlog-pre-issues/bad-code/SEC_schema-hex-validation.mddocs/archive/backlog-pre-issues/bad-code/SEC_scrypt-memory-budget.mddocs/archive/backlog-pre-issues/bad-code/SEC_store-source-validation.mddocs/archive/backlog-pre-issues/bad-code/SEC_submanifest-array-limit.mddocs/archive/backlog-pre-issues/bad-code/SEC_submanifest-chunkcount-integrity.mddocs/archive/backlog-pre-issues/bad-code/SEC_submanifest-chunks-unvalidated.mddocs/archive/backlog-pre-issues/bad-code/SEC_vault-nonce-exhaustion-cap.mddocs/archive/backlog-pre-issues/bad-code/SEC_vault-passphrase-verifier-gap.mddocs/archive/backlog-pre-issues/bad-code/TR_casservice-decomposition-pressure.mddocs/archive/backlog-pre-issues/bad-code/TR_cryptoport-node-import.mddocs/archive/backlog-pre-issues/bad-code/TR_dead-decompress-method.mddocs/archive/backlog-pre-issues/bad-code/TR_domain-imports-infrastructure.mddocs/archive/backlog-pre-issues/bad-code/TR_persistence-adapter-materialization.mddocs/archive/backlog-pre-issues/bad-code/TR_platform-dependency-leaks.mddocs/archive/backlog-pre-issues/bad-code/TR_schema-node-buffer-import.mddocs/archive/backlog-pre-issues/bad-code/TR_vault-retry-jitter.mddocs/archive/backlog-pre-issues/bad-code/TUI_store-wizard-execution-gap.mddocs/archive/backlog-pre-issues/bad-code/vault-tree-memory-loading.mddocs/archive/backlog-pre-issues/cool-ideas/.gitkeepdocs/archive/backlog-pre-issues/cool-ideas/DX_open-cas-helper.mddocs/archive/backlog-pre-issues/cool-ideas/DX_slug-tree-path-helper.mddocs/archive/backlog-pre-issues/cool-ideas/OPS_release-doc-drift-guard.mddocs/archive/backlog-pre-issues/cool-ideas/SEC_aes-gcm-aad-binding.mddocs/archive/backlog-pre-issues/cool-ideas/SEC_fastcdc-dual-mask.mddocs/archive/backlog-pre-issues/cool-ideas/SEC_manifest-integrity-hash.mddocs/archive/backlog-pre-issues/cool-ideas/TR_adaptive-frame-sizing.mddocs/archive/backlog-pre-issues/cool-ideas/TR_browser-compression-adapter.mddocs/archive/backlog-pre-issues/cool-ideas/TR_content-aware-chunking.mddocs/archive/backlog-pre-issues/cool-ideas/TR_convergent-encryption.mddocs/archive/backlog-pre-issues/cool-ideas/TR_dedupe-efficiency-telemetry.mddocs/archive/backlog-pre-issues/cool-ideas/TR_dual-encryption-modes.mddocs/archive/backlog-pre-issues/cool-ideas/TR_manifest-diffing.mddocs/archive/backlog-pre-issues/cool-ideas/TR_manifest-signing.mddocs/archive/backlog-pre-issues/cool-ideas/TR_parallel-chunk-restore.mddocs/archive/backlog-pre-issues/cool-ideas/TR_streaming-decryption.mddocs/archive/backlog-pre-issues/cool-ideas/TR_structured-json-logging.mddocs/archive/backlog-pre-issues/cool-ideas/TR_vault-privacy-mode.mddocs/archive/backlog-pre-issues/cool-ideas/TUI_cli-adaptive-table.mddocs/archive/backlog-pre-issues/cool-ideas/TUI_operation-feed-drawer.mddocs/archive/backlog-pre-issues/cool-ideas/TUI_os-keychain-auto-discovery.mddocs/archive/backlog-pre-issues/cool-ideas/TUI_segmented-manifest-view.mddocs/archive/backlog-pre-issues/cool-ideas/TUI_title-screen-stats.mddocs/archive/backlog-pre-issues/cool-ideas/atomic-multi-store.mddocs/archive/backlog-pre-issues/cool-ideas/merkle-tree-explorer-tui.mddocs/archive/backlog-pre-issues/cool-ideas/selective-asset-replication.mddocs/archive/backlog-pre-issues/cool-ideas/streaming-cli-stdin.mddocs/archive/backlog-pre-issues/ideas/IDEA-001_streaming-convergent-encryption.mddocs/archive/backlog-pre-issues/v6.0.0-polish/POL-001_string-sludge-manifest-view.mddocs/archive/backlog-pre-issues/v6.0.0-polish/POL-002_string-sludge-vault-report.mddocs/archive/backlog-pre-issues/v6.0.0-polish/POL-003_string-sludge-encryption-card.mddocs/archive/backlog-pre-issues/v6.0.0-polish/POL-004_boundary-violation-history-timeline.mddocs/archive/backlog-pre-issues/v6.0.0-polish/POL-005_raw-ansi-progress.mddocs/archive/backlog-pre-issues/v6.0.0-polish/POL-006_magic-numbers-rhythm.mddocs/archive/backlog-pre-issues/v6.0.0-polish/POL-007_view-state-leakage.mddocs/archive/backlog-pre-issues/v6.0.0-polish/POL-008_manual-clipping.mddocs/archive/backlog-pre-issues/v6.0.0-polish/POL-009_transition-shaders.mddocs/archive/backlog-pre-issues/v6.0.0-polish/POL-010_heatmap-grid-math.mddocs/archive/backlog-pre-issues/v6.0.0-polish/POL-011_wizard-string-geometry.mddocs/archive/backlog-pre-issues/v6.0.0-polish/POL-012_asset-card-block.mddocs/archive/backlog-pre-issues/v6.0.0-polish/POL-013_merkle-explorer-block.mddocs/archive/backlog-pre-issues/v6.0.0-polish/POL-014_health-dashboard-block.mddocs/archive/backlog-pre-issues/v6.0.0-polish/POL-015_wizard-block.mddocs/archive/backlog-pre-issues/v6.0.0-polish/POL-016_operation-feed-block.mddocs/archive/backlog-pre-issues/v6.0.0-polish/POL-017_heatmap-block.mddocs/archive/backlog-pre-issues/v6.0.0/REL_audit-blocker-burn-down.mddocs/archive/backlog-pre-issues/v6.0.0/REL_breaking-changes-doc.mddocs/archive/backlog-pre-issues/v6.0.0/REL_docs-accuracy-audit.mddocs/archive/backlog-pre-issues/v6.0.0/REL_migration-script.mddocs/archive/backlog-pre-issues/v6.0.0/REL_signpost-rewrite.mddocs/archive/backlog-pre-issues/v6.0.0/REL_version-bump.mddocs/archive/backlog-pre-issues/v6.x-tui/TUI_accordion-detail-pane.mddocs/archive/backlog-pre-issues/v6.x-tui/TUI_animated-transitions.mddocs/archive/backlog-pre-issues/v6.x-tui/TUI_badge-components.mddocs/archive/backlog-pre-issues/v6.x-tui/TUI_box-surface-migration.mddocs/archive/backlog-pre-issues/v6.x-tui/TUI_framed-app-shell.mddocs/archive/backlog-pre-issues/v6.x-tui/TUI_fullscreen-detail-view.mddocs/archive/backlog-pre-issues/v6.x-tui/TUI_help-overlay.mddocs/archive/backlog-pre-issues/v6.x-tui/TUI_layout-primitives.mddocs/archive/backlog-pre-issues/v6.x-tui/TUI_merkle-dag-viewer.mddocs/archive/backlog-pre-issues/v6.x-tui/TUI_orphaned-chunk-health-check.mddocs/archive/backlog-pre-issues/v6.x-tui/TUI_pager-scrollable-content.mddocs/archive/backlog-pre-issues/v6.x-tui/TUI_status-bar.mddocs/archive/backlog-pre-issues/v6.x-tui/TUI_store-wizard.mddocs/archive/backlog-pre-issues/v6.x-tui/TUI_toast-notifications.mddocs/archive/goalposts-pre-issues/README.mddocs/archive/goalposts-pre-issues/v6.0.1/release-truth-closeout.mddocs/archive/goalposts-pre-issues/v6.1.0/bounded-residency.mddocs/archive/goalposts-pre-issues/v6.2.0/operator-tui.mddocs/archive/goalposts-pre-issues/v6.3.0/agent-automation-parity.mddocs/archive/goalposts-pre-issues/v6.4.0/browser-edge-read-path.mddocs/archive/goalposts-pre-issues/v7.0.0/protocol-audit-response.mddocs/audit/2026-05-04_ship-readiness.mddocs/design/0045-v6-1-bounded-residency/bounded-residency.mddocs/design/README.mddocs/legends/RL-relay.mddocs/legends/TR-truth.mddocs/method/backlog/README.mddocs/method/legends/RL_relay.mddocs/method/legends/TR_truth.mddocs/method/process.mddocs/method/retro/0021-store-write-backpressure/enforce-store-backpressure.mddocs/method/retro/0022-git-persistence-read-blob-stream/add-read-blob-stream.mddocs/method/retro/0023-casservice-read-blob-stream-integration/use-read-blob-stream-in-restore.mddocs/templates/design-doc.mdtest/unit/docs/casservice-decomposition.test.jstest/unit/docs/markdown-links.test.jstest/unit/docs/planning-surfaces.test.jstest/unit/docs/release-state.test.js
💤 Files with no reviewable changes (1)
- GRAVEYARD.md
Member
Author
|
@codex Code Lawyer self-audit found an additional issue while reviewing
|
Member
Author
|
Code Lawyer Activity Summary
Resolved review threads via GraphQL:
Validation on latest head git diff --check origin/main...HEAD
npx vitest run test/unit/docs/planning-surfaces.test.js test/unit/docs/markdown-links.test.js
npx eslint .
npm testResults:
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Tracker
Validation
npm test: 187 files passed, 1,644 tests passed, 2 skippeddocs/github-issues-trackerSummary by CodeRabbit
New Features
Documentation