Skip to content

docs(modules): reconcile marketplace v1 citations with merged HT-79 charter (HT-79) - #92

Merged
zaridan merged 1 commit into
mainfrom
docs/ht-79-marketplace-citations
Jul 19, 2026
Merged

docs(modules): reconcile marketplace v1 citations with merged HT-79 charter (HT-79)#92
zaridan merged 1 commit into
mainfrom
docs/ht-79-marketplace-citations

Conversation

@zaridan

@zaridan zaridan commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

What

specs/modules/marketplace-v1.md was drafted while the HT-79 charter amendment was still an unmerged branch. It carried a sequencing note asking for a citation re-check against the merged text "before this spec is accepted." That amendment merged as PR #86 (b528971), so the re-check is now due — this PR does it.

Docs-only. No spec substance, decisions, or design changed. Status deliberately stays draft for the maintainer review — accepting the spec is the maintainer's call, not this PR's.

Citations verified against merged CHARTER.md §3/§4/§5

All check out as written, no change needed:

Spec Claim Merged charter
§1 Marketplace is a launch-day component of Phase 3, "not deferred to 'once demand justifies it'" Amendment note verbatim: "moves from 'a later phase, once demand justifies it' to a launch-day component of Phase 3"
§1 Proven first as the project's own dogfood install path §3: "live at public launch, proven first as the project's own dogfood install path"; §5: "all having served as Resonant IQ's own install path through the dogfood phase"
§1 §3's module boundary names the marks and "the official marketplace" as assets staying with the company §3 module boundary, verbatim
§8 Counsel items — commercial module license text + terms of sale before real money Amendment note, quoted verbatim in the spec already
§10.4 Phase 3 names "the knowledge base and AI-powered modules"; KB is content-as-code per §4 §5 Phase 3 and §4, both verbatim

Changes made

  1. Sequencing note replaced with a "Citation basis" line recording the merged commit (b528971, PR docs(charter): marketplace becomes a launch-day component of Phase 3 (HT-79) #86) and the date of the re-check.

  2. One mis-citation corrected (§8). The spec attributed the plugin exception's counsel deadline to "CHARTER.md §7" — but CHARTER.md §7 is Governance. The deadline is set in CHARTER.md §3's module boundary, and "§7" there names the AGPL-3.0 §7 additional permission, not a charter section. The same sentence's parenthetical pointed at "this spec's §3" for the reference, but this spec's §3 is Service architecture and never mentions the exception — dangling for the same reason. Both replaced with a direct quote of the merged amendment.

    Note: the changelog's CodeRabbit entry claims this §7 numbering was "disambiguated" in an earlier pass. It was not — the mis-citation survived. The substance was always right (deadline unchanged; every v1 module is out-of-process and needs no exception); only the pointer was wrong.

  3. One wording tightening (§10.4). The KB-plus-AI-modules launch lineup was described as what Phase 3 "currently implies." The amended text names those modules outright, which strengthens the conflict that decision point raises rather than weakening it. Changed "implies" → "names outright."

  4. Changelog entry added recording this pass.

Open questions for the maintainer

None new. No merged charter text contradicts a spec decision — the reconciliation was purely citational.

Worth restating that the spec's own §10.4 remains open and unresolved by design: whether the content-as-code KB fits this spec's tarball-to-Vercel-deploy pipeline, or needs its own distribution mechanism. The merged Phase 3 text naming the KB as leading the catalog makes that decision slightly more pointed than the draft's "implies" wording suggested, but it was already flagged as charter-affecting and explicitly left to you.

🤖 Generated with Claude Code

…harter (HT-79)

The HT-79 charter amendment merged as PR #86 (b528971), discharging the
spec's sequencing note, which asked for a citation re-check against the
merged text before acceptance.

All CHARTER.md citations re-verified against merged §3/§4/§5: the
launch-day Phase 3 claim, the marks-and-marketplace asset list, the
amendment's verbatim counsel-items sentence, and the Phase 3 launch
lineup all check out as written.

One mis-citation corrected: the plugin exception's counsel deadline was
attributed to "CHARTER.md §7," but CHARTER.md §7 is Governance — the
deadline is set in §3's module boundary, where "§7" names the AGPL-3.0
§7 additional permission. Its parenthetical pointing at "this spec's §3"
was dangling for the same reason. Replaced with a direct quote of the
merged amendment.

Docs-only; no substantive change. Status stays "draft for TJ review".

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jul 19, 2026

Copy link
Copy Markdown

Warning

Review limit reached

@zaridan, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 15 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 3ff22c31-bbd1-4efe-9a22-6f88a8176c68

📥 Commits

Reviewing files that changed from the base of the PR and between a0fb9eb and 182d751.

📒 Files selected for processing (1)
  • specs/modules/marketplace-v1.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/ht-79-marketplace-citations

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

@zaridan

zaridan commented Jul 19, 2026

Copy link
Copy Markdown
Contributor Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Jul 19, 2026

Copy link
Copy Markdown
✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

@zaridan
zaridan merged commit df89a4c into main Jul 19, 2026
5 checks passed
@zaridan
zaridan deleted the docs/ht-79-marketplace-citations branch July 19, 2026 21:54
zaridan added a commit that referenced this pull request Jul 19, 2026
Our Pro Plus plan is not unlimited — it applies adaptive per-developer
limits once recent activity reaches the 95th percentile among CodeRabbit
users. We crossed that on 2026-07-19 (15 PRs merged in a day). PR #92
was never reviewed as a result, and its status check still reported
"pass / Review completed": a skipped review is indistinguishable from a
clean one. Usage-based billing is deliberately not enabled, so the lever
is volume.

Two changes, both narrow:

- auto_incremental_review: false — the default re-runs a full review on
  every push, so our rebase-on-feedback loop burns three or four reviews
  per PR for one set of findings. One review per PR, no loss of coverage.
- ignore_title_keywords: chore(ci), docs(status) — mechanical PRs with
  nothing for a reviewer to find. Deliberately narrow substring matches
  so chore(engine) and docs(modules) are still reviewed.

Specs stay in scope on purpose: PR #87 was docs-only and CodeRabbit found
nine real defects in it. Prose in this repo carries engineering substance.

Config validated against CodeRabbit's published JSON schema (ajv,
draft2020) rather than written from assumption.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
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