Skip to content

fix(docs): correct dead references in generators/rust and generators/cli CLAUDE.md - #17610

Open
wallidsaydi-creator wants to merge 1 commit into
fern-api:mainfrom
wallidsaydi-creator:fix/claude-md-dead-references
Open

fix(docs): correct dead references in generators/rust and generators/cli CLAUDE.md#17610
wallidsaydi-creator wants to merge 1 commit into
fern-api:mainfrom
wallidsaydi-creator:fix/claude-md-dead-references

Conversation

@wallidsaydi-creator

@wallidsaydi-creator wallidsaydi-creator commented Sep 1, 2026

Copy link
Copy Markdown

Fixes #17581

Three dead references in agent-guidance files, re-verified against main @ 8bfa8e2 before filing this PR:

1. generators/rust/CLAUDE.md — phantom schema paths

The line pointed to generators/rust/codegen/src/custom-config/RustSdkCustomConfigSchema.ts and RustModelCustomConfigSchema.ts. Neither path has ever existed on main (custom-config/ holds BaseRustConfigSchema.ts / RustDependencySpecSchema.ts / CustomReadmeSectionSchema.ts — no Rust* files). The real schemas live in:

  • generators/rust/sdk/src/SdkCustomConfig.tsSdkCustomConfigSchema
  • generators/rust/model/src/ModelCustomConfig.tsModelCustomConfigSchema

Both extend BaseRustCustomConfigSchema from @fern-api/rust-codegen.

2. generators/cli/CLAUDE.md — deleted test files

The doc cited tests/cli_integration.rs and tests/openapi_fixture_wire.rs (deleted in #16056, ~4.4k lines removed during the binding/auth migration; neither file exists anywhere in the current tree) and attributed the ignore list to SDK_IGNORE in build.mjs. Per build.mjs's own header comment, the dev-only globs now live in sdk/.sdk-ignore.json as the canonical home, merged into SDK_IGNORE at build time. Updated to describe the current mechanism.

3. generators/cli/CLAUDE.md — deleted DESIGN.md

The customize/ guidance linked sdk/docs/DESIGN.md (deleted in #16264) and hedged it as "planned". The successor sdk/docs/customize.md exists and documents customization as shipped behavior, so the dead link is replaced and the stale hedge dropped.

All three are the exact class of drift that misdirects coding agents working in these directories — an agent following the rust line today searches for files that never existed.

Happy to adjust wording if you'd phrase the ignore-list description differently.


Devin Review

…E.md

- rust: point configuration schema to the real SdkCustomConfig.ts /
  ModelCustomConfig.ts (custom-config/ paths never existed on main)
- cli: replace deleted tests/cli_integration.rs + openapi_fixture_wire.rs
  with the current sdk/.sdk-ignore.json ignore mechanism
- cli: replace deleted sdk/docs/DESIGN.md with the live
  sdk/docs/customize.md and drop the stale 'planned' hedge

Fixes fern-api#17581
@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

@nitpickybot nitpickybot 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.

Docs-only PR fixing three stale file references in agent-guidance CLAUDE.md files. Paths and wording look consistent with the described current tree; nothing functional at risk. No blocking issues.


To request another review, comment /ai-review on this pull request.

@devin-ai-integration devin-ai-integration Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🔍 Devin Review: 1 flag

Not posted on this PR by your GitHub settings — view it in Devin Review. (Configure)

Devin Review

@wallidsaydi-creator wallidsaydi-creator changed the title docs: fix dead references in generators/rust and generators/cli CLAUDE.md fix(docs): correct dead references in generators/rust and generators/cli CLAUDE.md Sep 1, 2026
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.

generators/rust and generators/cli CLAUDE.md reference files that don't exist (phantom config schemas, deleted tests, dead DESIGN.md link)

1 participant