Skip to content

Instructree v0.17.0 — find instructions hidden by nested project roots

Choose a tag to compare

View all tags
@kotobuki09 kotobuki09 released this 25 Aug 23:23
v0.17.0
2c3649f

Find AGENTS.md files hidden by nested project roots

instructree doctor now explains a subtle Codex failure mode: a nearer .git or configured project-root marker can stop discovery before plausible parent instructions are reached.

What's new

  • Inspect the boundary above the selected Codex project root without changing the effective instruction chain.
  • Report the first-precedence parent instruction candidate from each relevant ancestor up to the nearest outer project marker.
  • Preserve AGENTS.override.md, AGENTS.md, then configured-fallback precedence.
  • Render only share-safe labels such as <parent>/AGENTS.md; absolute home and repository paths remain redacted.
  • Keep clean nested projects quiet when the outer project has no instruction candidate.
  • Add a search-focused explanation and current source-pinned research for nested Git repositories, submodules, and worktrees.

The improvement targets the real root-boundary behavior documented in openai/codex#25651, the explicit warning request in openai/codex#30789, and the focused doctor request in openai/codex#30788. The implementation boundary is recorded in the source-pinned research note.

Verification

  • 70 tests across Node.js 20, 22, and 24 on Linux, macOS, and Windows.
  • All 9 CI jobs, Instructree code scanning, and GitHub Pages passed on commit 2c3649fc5a2c6be657994bbf5e132a5330269cd7.
  • Arbor development and fresh packed-install held-out evaluations both scored 100/100.
  • The exact 23-file release tarball installed and passed a custom-root, two-level parent-boundary fixture with correct override precedence and zero private-path leaks.
  • SHA-256: 94ee3ded21ffa8aa65f38e9c546fd6dfa3742814606e4a311fe3897e661c87be.
Assets 4
Loading