Skip to content

chore: scrub private-repo references from public tree - #832

Merged
JuliusBrussee merged 1 commit into
mainfrom
chore/scrub-private-repo-refs
Aug 12, 2026
Merged

chore: scrub private-repo references from public tree#832
JuliusBrussee merged 1 commit into
mainfrom
chore/scrub-private-repo-refs

Conversation

@JuliusBrussee

Copy link
Copy Markdown
Owner

Summary

Scrubs leftover references to the private caveman-cloud monorepo from the public export. This is a comment/doc-only change β€” no behavior, test assertions, or generated constants were altered.

What was removed/fixed (94 files):

  • ~100 ADR citations ((ADR 0031), [ADR 0024](../../docs/decisions/0024-....md)) across CLI/proxy/engine/mem/shrink/shared source comments, docs, and test assertion-message strings. docs/decisions/ doesn't exist in this repo, so every one of these links was already dead. The described invariant/behavior was preserved inline in every case; only the citation was dropped.
  • Broken links to other private-only doc lanes that also don't exist here: docs/prd/*.md, docs/design.md, docs/CAVEMAN_LEARN_SPEC.md, docs/UNIVERSAL_AGENT_WRAP_SPEC.md, docs/FASTCONTEXT_EXPLORER_SPEC.md, docs/SAVINGS_ACCOUNTING.md, docs/research/*, docs/superpowers/*, and root PRODUCTS.yaml.
  • # public/<path> β€” ... first-line titles in ~30 CLAUDE.md/AGENTS.md files, corrected to the package's real repo-root-relative path (e.g. packages/cli/CLAUDE.md: # public/cli β†’ # packages/cli; mcp/CLAUDE.md: # public/mcp β†’ # mcp).
  • public/cli and cloud/web/cloud/gateway-managed literal path leaks in comments, generated-file headers, and one CLI-printed string, reworded or corrected to match this repo's actual layout.
  • Generator headers regenerated for byte-consistency: agents/compile.mjs, integrations/compile.mjs, and skills/compile.mjs stamp // GENERATED by public/<dir>/compile.mjs ... into 5 committed *.generated.ts files under packages/cli/src/. Fixed the generator source strings, then re-ran all three compilers so the generated headers stay byte-consistent with their generators (only the header lines changed in each generated file).

Deliberately NOT touched (per the do-not-touch list):

  • ~/.caveman-cloud/ β€” the CLI's local config directory on user machines, a real product path, not a repo reference. All occurrences stay.
  • "Caveman Cloud" as the public product/service name in prose (README, SECURITY, marketing copy).
  • caveman.so / api.caveman.so β€” public endpoints.
  • scripts/install-local-cli.sh / .ps1 β€” the public/cli mentions there are real dual-layout fallback logic (checks public/cli then packages/cli then cli/), not leaked references; left untouched per "do not change any logic or path checks."
  • integrations/compile.mjs's cloud/web path in the webDir existence-check logic and its accompanying comment β€” real code that only writes there when a private-repo checkout has that directory; only the two printed cloud/web-mentioning strings elsewhere (in skills/compile.mjs) were reworded.
  • Any test logic/assertions, struct fields, function signatures, or generated data constants (keys, checksums, versions) β€” only comments and human-readable message strings were edited.
  • ../../CLAUDE.md (root)-style relative links with an incorrect ../ depth (present in ~15 files) β€” these point at a file that genuinely exists in this repo, so they're a pre-existing path-depth bug from the directory-flattening at export time, not a private-repo leak. Left as-is; flagging here as a possible follow-up.

Verification

  • git grep -in "adr 00\|docs/decisions\|public/cli" β†’ zero hits except the two intentional scripts/install-local-cli.{sh,ps1} fallback-logic occurrences (real code, not comments).
  • Broader sweep for docs/prd/, docs/design.md, docs/CAVEMAN_LEARN_SPEC, docs/UNIVERSAL_AGENT_WRAP_SPEC, docs/FASTCONTEXT_EXPLORER_SPEC, docs/SAVINGS_ACCOUNTING, docs/research, docs/superpowers, PRODUCTS.yaml, cloud/gateway-managed, ^# public/ titles β†’ zero hits.
  • cd packages/cli && npx tsc --noEmit β†’ passes cleanly.
  • go build ./... (from repo root, Go 1.26.5 available) β†’ passes cleanly.
  • git diff --stat reviewed file-by-file: every changed line is a comment, doc line, assertion-message string, a CLI-printed string, or a generator-header string as described above.

Test plan

  • git grep verification (zero hits, see above)
  • tsc --noEmit in packages/cli
  • go build ./... from repo root
  • Manual diff review confirming no executable logic changed

πŸ€– Generated with Claude Code

https://claude.ai/code/session_01DLNTYJU8vMEdDWpV7e7k7Z

Removes ADR citations (decision records live in the private repo;
links were broken here) while keeping every described invariant
inline, and fixes generator headers / doc titles that leaked the
private monorepo layout (public/cli, cloud/web). Comments and docs
only β€” no behavior change.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DLNTYJU8vMEdDWpV7e7k7Z
@JuliusBrussee
JuliusBrussee merged commit d4ef06b into main Aug 12, 2026
9 of 10 checks passed
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