Skip to content

chore(trust): gate public claims on current main - #44

Draft
frankxai wants to merge 4 commits into
mainfrom
codex/current-main-public-truth
Draft

chore(trust): gate public claims on current main#44
frankxai wants to merge 4 commits into
mainfrom
codex/current-main-public-truth

Conversation

@frankxai

@frankxai frankxai commented Jul 25, 2026

Copy link
Copy Markdown
Owner

Outcome

Makes the current main branch honest and independently checkable without absorbing the 1,040-file v12 reset in #32.

What changes

  • replaces the public README and quick start with a source-first, partner-shareable proof surface;
  • measures 176 tracked SKILL.md paths honestly as 171 non-empty modules plus 5 named empty placeholders;
  • measures 83 top-level slash commands, 69 top-level agent profiles, 9 installable shell hooks, and 32 activation rules;
  • adds npm run verify:public-surface, including an isolated Claude install smoke test and an exact allowlist for the 5 empty placeholders;
  • aligns package and plugin metadata with the measured tree;
  • removes unsupported project-wide license metadata because no root license artifact exists;
  • states that this repository is not currently a Claude marketplace installation because .claude-plugin/marketplace.json is absent;
  • replaces two workstation-bound OpenCode MCP paths with repository-relative paths and gates against their return;
  • repairs the malformed health workflow, makes it run on relevant pull requests, and replaces false-green checks with blocking source checks;
  • promotes the exact seven-workspace typecheck from informational to blocking after a clean current-main run.

Exact source

  • base: 4be8e3828dd7a3c83c325cf40325ad22028336f1
  • head: 659921d46a13fb2b471d32c03a28d6cbd2b0379e
  • tree: b3cddeb289f9230c59783972637a225350bca4e4
  • four commits, 11 files

Local verification

  • node scripts/verify-public-surface.mjs — pass, isolated install included
  • npm run lint — 0 errors / 0 warnings
  • npm run observatory:test — 6/6 pass
  • npm run build:all — 7/7 workspace builds pass
  • npm run typecheck:all — 7/7 workspace typechecks pass
  • all tracked shell hooks parse with bash -n
  • bash -n install.sh — pass
  • workflow YAML parse — pass
  • git diff --check — pass

Exact-head cloud verification

  • CI run 30148558952 — success
  • ACOS Health Check run 30148558944 — success
  • CodeRabbit’s five findings from review 4778720641 were addressed; exact-head re-review is temporarily rate-limited

Deliberate boundaries

This draft does not create or choose a license, add a marketplace manifest, publish a package or release, change secrets or repository settings, merge, or absorb #32 wholesale.

Named-owner decisions still required:

  1. choose and publish project-wide legal terms;
  2. decide whether this repository should become a Claude marketplace source;
  3. authorize any tag, GitHub release, or registry publication;
  4. split provenance cleanup, hook wiring, empty-placeholder completion/removal, and platform certification into separately reviewable changes.

Summary by CodeRabbit

  • New Features

    • Added public-surface verification covering repository counts, version consistency, installation behavior, licensing statements, and marketplace metadata.
    • Added a verification command and integrated it into CI checks.
    • Updated MCP configuration to use portable repository-relative paths.
  • Documentation

    • Reworked the README and Quickstart guide with clearer installation, verification, platform, and licensing guidance.
    • Updated contribution terms and documented current repository capabilities and activation rules.
  • Bug Fixes

    • CI type checking is now blocking.
    • Added shell syntax validation for installers and hooks.

@gemini-code-assist

Copy link
Copy Markdown

Caution

The consumer version of Gemini Code Assist on GitHub has been sunset. All code review activity has officially ceased.

@coderabbitai

coderabbitai Bot commented Jul 25, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

This change adds a repository-wide public-surface verifier, updates metadata and documentation to measured claims, makes MCP paths portable, and integrates verification, shell syntax checks, and blocking typechecks into CI workflows.

Changes

Public Surface Verification

Layer / File(s) Summary
Verification engine and canonical metadata
.claude-plugin/plugin.json, package.json, opencode.json, scripts/verify-public-surface.mjs
Adds measured asset counts, metadata consistency checks, licensing and marketplace assertions, portability checks, and a temporary Claude installation smoke test exposed through verify:public-surface. MCP commands now use repository-relative paths.
Public claims and installation guidance
CLAUDE.md, CONTRIBUTING.md, QUICKSTART.md, README.md
Updates documented counts, installation steps, plugin status, activation rules, verification commands, contribution terms, and license status to match the verified repository surface.
Continuous integration enforcement
.github/workflows/acos-health-check.yml, .github/workflows/ci.yml
Runs public-surface verification and shell syntax checks on scoped workflow events, adds read-only permissions, and makes typechecking blocking in CI.

Estimated code review effort: 4 (Complex) | ~45 minutes

Sequence Diagram(s)

sequenceDiagram
  participant CI
  participant VerifyPublicSurface
  participant Repository
  participant InstallScript
  participant TemporaryClaudeHome
  CI->>VerifyPublicSurface: run npm run verify:public-surface
  VerifyPublicSurface->>Repository: measure assets and validate claims
  VerifyPublicSurface->>InstallScript: run minimal Claude installation
  InstallScript->>TemporaryClaudeHome: install generated files
  VerifyPublicSurface->>TemporaryClaudeHome: compare counts and required state
  VerifyPublicSurface-->>CI: return success report or failure
Loading

Possibly related PRs

🚥 Pre-merge checks | ✅ 3 | ❌ 2

❌ Failed checks (2 warnings)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
Description check ⚠️ Warning The description is detailed, but it doesn't follow the required template sections like Summary, Change Type, Frank DNA Alignment, Testing, and Related Issues. Rewrite it to match the template and add the missing sections, including the structural-change checklist where applicable.
✅ Passed checks (3 passed)
Check name Status Explanation
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Title check ✅ Passed The title is concise and accurately reflects the PR's main change: gating public claims on the current main branch.
✨ Finishing Touches
📝 Generate docstrings
  • Create stacked PR
  • Commit on current branch
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/current-main-public-truth

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.

Copy link
Copy Markdown
Owner Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Jul 25, 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.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 5

🤖 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 @.github/workflows/acos-health-check.yml:
- Around line 6-23: Update the pull_request paths filter in the health-check
workflow to include .claude-plugin/marketplace.json, ensuring marketplace
manifest-only changes trigger the health gate while preserving the existing
paths.

In `@QUICKSTART.md`:
- Around line 20-23: Update the installation inspection command in QUICKSTART.md
lines 20-23 and README.md lines 55-59 to remove the max-depth restriction, using
find on the full CLAUDE_HOME tree so all installed files, including skills and
hooks, are listed.

In `@scripts/verify-public-surface.mjs`:
- Around line 179-190: Update the root license filename filter in
verifyLicenseTruth to recognize hyphenated license stems such as LICENSE-MIT,
while retaining case-insensitive matching and support for existing suffix
formats. Keep the subsequent canonical metadata assertions unchanged.
- Around line 211-214: Update verifyPortablePublicConfig to inspect every local
MCP entrypoint in canonical.opencode rather than only matching home-directory
paths. Parse the MCP configuration and assert each local entrypoint is relative
or uses an explicitly portable form, rejecting all absolute filesystem paths
including locations such as /opt.
- Around line 143-168: Extend the verification around requiredReadmeClaims and
the canonical plugin stats checks to validate every published metric variant,
including the corresponding counts in CLAUDE.md and QUICKSTART.md and each entry
in plugin.json stats.verifiedBy. Define one canonical expected-value map and
derive all assertions from it so README, documentation claims, plugin stats, and
verification metadata cannot drift independently.
🪄 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 Plus

Run ID: 10575d6e-02fe-43e8-b464-e4e8f5413a15

📥 Commits

Reviewing files that changed from the base of the PR and between 4be8e38 and ebb675e.

⛔ Files ignored due to path filters (1)
  • package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing (10)
  • .claude-plugin/plugin.json
  • .github/workflows/acos-health-check.yml
  • .github/workflows/ci.yml
  • CLAUDE.md
  • CONTRIBUTING.md
  • QUICKSTART.md
  • README.md
  • opencode.json
  • package.json
  • scripts/verify-public-surface.mjs

Comment thread .github/workflows/acos-health-check.yml
Comment thread QUICKSTART.md
Comment thread scripts/verify-public-surface.mjs Outdated
Comment thread scripts/verify-public-surface.mjs
Comment thread scripts/verify-public-surface.mjs

Copy link
Copy Markdown
Owner Author

@coderabbitai review

All five findings from review 4778720641 were addressed at exact head 659921d46a13fb2b471d32c03a28d6cbd2b0379e. Both exact-head workflows are green: CI 30148558952 and ACOS Health Check 30148558944.

@coderabbitai

coderabbitai Bot commented Jul 25, 2026

Copy link
Copy Markdown

@frankxai Thanks for confirming the exact head and successful checks. I’ll review the updated PR state. 🐇

✅ 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.

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