chore(repo): hygiene pass — gitignore, RFC dedupe, governance docs - #3
Open
jlromeiro wants to merge 4 commits into
Open
chore(repo): hygiene pass — gitignore, RFC dedupe, governance docs#3jlromeiro wants to merge 4 commits into
jlromeiro wants to merge 4 commits into
Conversation
Two hygiene fixes in one commit: 1. .gitignore expanded to exclude internal materials that were untracked but at risk if anyone did `git add .`: - docs/pitch/ (CEO teleprompter, slide notes, 2-pagers) - docs/outreach/LETTERS-BR-*.md, EMAIL-TEMPLATES, DEMO-FLOW, TRACKER - docs/superpowers/ (internal design specs + plans) - bench-options-pitches.json - .claude/, .agents/, skills-lock.json, prompt-assistente/ - .playwright-mcp/, *-forced-visible.png - .vscode/, .idea/ Untracked count drops from 32 to 6 (the remainder is publishable content: blog/, social/, PATENT-PLEDGE.md untracked-by-design until INPI deposit confirms, plus an SVG diagram). 2. Removed legacy RFC duplicates that lived in docs/ alongside the canonical versions in docs/rfc/: - docs/TRUST-SCORE-RFC-DRAFT.md (v0.1, superseded by docs/rfc/x402-trust-score.md v0.2) - docs/QOS-COOPERATIVE-SPEC.md (superseded by docs/rfc/x402-qos-cooperative.md) Three external-facing references updated to point at the canonical paths: README.md, docs/DEPLOY.md, public/docs.html. Internal code comments in index.js still reference the old paths; those will be updated when the surrounding code is refactored. Also fixes a small README typo: the opening quote was duplicated on lines 8 and 10. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Two governance files that the project was missing: SECURITY.md - Preferred reporting via GitHub Security Advisory + email fallback - 24h ack / 7d assessment / 30d patch target for high-severity - 90-day responsible disclosure window - In-scope (Shield, Broker, RFC, public site) vs out-of-scope (Solana RPC nodes, Solana protocol, third-party SDKs) CONTRIBUTING.md - What this project is (reference impl + RFCs as source of truth) - How to contribute (issue-first for non-trivial; RFC-first for protocol changes) - Dev setup, PR checklist, code style - Patent guidance (links to PATENT-PLEDGE.md when published) Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Follow-up to commit 6abc328 which removed the legacy duplicates at docs/TRUST-SCORE-RFC-DRAFT.md and docs/QOS-COOPERATIVE-SPEC.md. This commit updates the remaining internal references that still pointed at the deleted paths: - index.js (5 comments) — companion-spec pointer + cooperative QoS fallback comments. The line 86 comment also had a copy-paste error pointing at the trust-score draft when the surrounding context is about cooperative QoS; fixed to the right spec. - lib/detection.js header — 5-signal taxonomy citation. - examples/operator-qos-reference.js — header doc pointer. - tools/assistant/rag/09-referencias-links.md — RAG reference. - docs/rfc/x402-qos-cooperative.md (3 inline links) — the canonical cooperative-QoS RFC was linking to the deleted trust-score legacy path; corrected to the canonical sibling. No behavior change. Pure documentation pointers. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Three legacy logo image files that were deleted from the working tree but never committed. The brand identity moved to the x402 favicon (commit b2dbafa, May 10) — these RPC Priority logos are no longer referenced by anything in the repo. Verified no active reference to "Logo RPC" or "Logo.jpeg" remains in the codebase. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
|
Kilo Code Review could not run — your account is out of credits. Add credits or switch to a free model to enable reviews on this change. |
7 tasks
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
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
Repo-hygiene-only PR. No protocol changes, no behavior changes. 4 commits clean up risk and presentability gaps surfaced by an internal audit.
This PR is independent of #2 (RFC v0.2 spec) and the in-flight
feat/trust-score-v0.2-implPR (formula module). Order of merge does not matter.What's in each commit
6abc328— chore(repo): expand .gitignore + remove stale RFC duplicatesTwo fixes in one:
.gitignoreexpanded to exclude internal materials that were untracked but at risk of accidental commit viagit add .:docs/pitch/(CEO teleprompter, slide notes, 2-pagers)docs/outreach/LETTERS-BR-*.md,EMAIL-TEMPLATES.md,DEMO-FLOW.md,TRACKER.mddocs/superpowers/(internal design specs + plans)bench-options-pitches.json,.claude/,.agents/,skills-lock.json,prompt-assistente/.playwright-mcp/,*-forced-visible.png,.vscode/,.idea/docs/that lived alongside canonical versions indocs/rfc/:docs/TRUST-SCORE-RFC-DRAFT.md(v0.1, superseded bydocs/rfc/x402-trust-score.md)docs/QOS-COOPERATIVE-SPEC.md(superseded bydocs/rfc/x402-qos-cooperative.md)README.md,docs/DEPLOY.md,public/docs.html) to point at the canonical paths.c660745— docs: add SECURITY.md + CONTRIBUTING.mdTwo governance files the project was missing:
3ad670c— chore(refs): point internal references to canonical RFC pathsFollow-up to commit
6abc328updating remaining references that still pointed at deleted paths:index.js(5 comments) — companion-spec pointers + cooperative QoS fallback. Line 86 had a copy-paste error pointing at trust-score draft when surrounding context was about cooperative QoS; corrected.lib/detection.jsheader — 5-signal taxonomy citation.examples/operator-qos-reference.js— header doc pointer.tools/assistant/rag/09-referencias-links.md— RAG reference.docs/rfc/x402-qos-cooperative.md(3 inline links) — canonical RFC was linking to deleted trust-score legacy path.No behavior change. Pure documentation pointers.
16d8f23— chore(brand): remove legacy RPC logosThree logo files (
docs/Logo RPC.jpg,docs/Logo RPC.png,docs/Logo.jpeg) deleted from working tree but never committed. Brand identity moved to x402 favicon (commitb2dbafa, May 10) — these RPC Priority logos are no longer referenced.Test plan
git statusafter merge shows no leaked internal files (verify against the gitignore additions list)npm teststill passes (no source code changed beyond comment text)npx markdown-link-check README.mdfind docs/ -name "TRUST-SCORE-RFC-DRAFT*" -o -name "QOS-COOPERATIVE-SPEC*"returns emptygrep -r "TRUST-SCORE-RFC-DRAFT\|QOS-COOPERATIVE-SPEC" --include="*.{js,md,html}"returns only matches insidedocs/files that are about-to-be-moved internal docs (PENDENCIAS-ESTRATEGICAS, outreach/, REFERENCIA-TECNICA-DETALHADA — all flagged for migration todocs/context/in a future doc-cleanup PR)🤖 Generated with Claude Code