chore(repo): public housecleaning — remove internal-only docs + sanitize comments#52
Merged
cloakmaster merged 2 commits intomainfrom Apr 30, 2026
Merged
Conversation
added 2 commits
April 30, 2026 10:02
…ize comments
Pre-A2A-Discussion outreach, the public repo carried a substantial
amount of internal strategy / personal scheduling material that
shouldn't be visible to TSC voices and security analysts clicking
through from Discussion #1803. This PR removes it and sanitizes the
comments + descriptions in surviving files.
## Removed (internal-only working docs, now gitignored)
- CLAUDE.md — Claude Code project memory; exposes "marketplace" /
"Agent Work Exchange" framing inconsistent with public positioning.
- PROJECT-PLAN.md — week-by-week build plan, abandon triggers, named
outreach targets.
- docs/foundation/{LOCKED.md, foxbook-foundation.md} — pinned non-
negotiables, internal SLOs, foundation doc.
- docs/outreach.md — three DMs + 10 named targets + send-discipline
rules.
- docs/distribution.md — internal product framing.
- docs/user-journey.md — sales-funnel framing.
- docs/pre-mortem-v1.md — internal v1 fail-mode analysis.
- docs/process/{pr-success-criteria, backfill-success-criteria}.md —
internal review process docs.
- docs/retros/day-{04,05,06,07}.md — daily build retros.
- docs/decisions/0006-protocol-not-marketplace.md — internal strategy
ADR (the "no marketplace" rule lives in TRADEMARK + RFC body now).
- docs/ops/preflight.md — internal preflight checklist with day-by-
day failure-mode references.
- port/ (entire directory) — context-transfer files from earlier
build phase (foundation v1, gemini-grilling, deep-research, etc.).
## Sanitized (comments + descriptions)
- README.md — removed Roadmap navlink + "Full roadmap" Status link
(PROJECT-PLAN.md gone).
- TRADEMARK.md — removed ADR 0006 §2 link; kept canonicality reasoning.
- docs/rfc-a2a-x-foxbook-extension.md — removed ADR 0006 cross-refs +
LOCKED.md ref; replaced "agent-hiring-gate runtime-safety primitive"
with neutral phrasing; replaced "Day-7 ships the contract; week-2
ships the implementation" with "signatures committed; implementation
in progress"; updated Worker URL to canonical https://transparency.foxbook.dev.
- docs/decisions/0001 + 0002 — removed docs/foundation/ cross-refs.
- docs/operations/env-vars.md — removed LOCKED.md cross-ref.
- schemas/{envelope/v1, x-foxbook.v1}.json — removed PROJECT-PLAN.md /
Day-7 / foundation/ references in description fields. Generated
TS+Python types regenerated.
- packages/sdk-claim/{src/claim, src/verify, src/index, package.json}
— replaced "Day-7 PR E ships signatures only" / "week-2 Distribution
Track" / "PROJECT-PLAN.md Cross-LLM Strategic Feedback" / "agent-
hiring-gate" / "RFC + outreach DMs + docs/distribution.md" with
neutral phrasing.
- packages/sdk-claim/src/verify.ts — DEFAULT_WORKER_BASE updated to
https://transparency.foxbook.dev (was workers.dev preview, now disabled).
- packages/db/src/schema/claims.ts + apps/api/src/firehose/types.ts —
removed Day-N references from JSDoc.
- core/src/crypto/ed25519.ts + core/scripts/bench-merkle-append.mjs —
removed foundation/ + PROJECT-PLAN.md cross-refs.
## Gitignore
Added internal-only paths so accidentally-recreated working files
don't get re-tracked: CLAUDE.md, PROJECT-PLAN.md, LOCKED.md,
docs/foundation/, docs/outreach.md, docs/distribution.md,
docs/user-journey.md, docs/pre-mortem-v1.md, docs/process/,
docs/retros/, port/.
## Public surface after this PR
- README, LICENSE, TRADEMARK
- docs/rfc-a2a-x-foxbook-extension.md (referenced from Discussion #1803)
- docs/decisions/0001-0005 (engineering ADRs; rationale-bearing context)
- docs/operations/env-vars.md (fork-it-and-run-it env reference)
- ops/evidence/ (adversarial-test transcript)
- ops/bench-results/ (bench artifacts)
- schemas/ (public protocol schemas)
- apps/, packages/, core/, adapters/ (code)
Two missed refs in verify.ts file header (lines 1 + 9). Replaced with neutral phrasing matching the rest of the cleanup pass.
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.
Pre-A2A-Discussion outreach revealed the public repo carried internal strategy + personal scheduling material that shouldn't be visible to TSC voices clicking through from #1803. This sweep removes it and sanitizes surviving files.
Removed (internal-only working docs; gitignored going forward)
Sanitized (comments + descriptions)
Gitignore additions
Internal-only paths added to `.gitignore` so accidentally-recreated working files don't get re-tracked.
Public surface after merge
Test plan