Skip to content

chore(java): clean up comment style + isolate searchProject tests#1363

Merged
esengine merged 2 commits into
mainfrom
chore/java-source-comment-cleanup
May 20, 2026
Merged

chore(java): clean up comment style + isolate searchProject tests#1363
esengine merged 2 commits into
mainfrom
chore/java-source-comment-cleanup

Conversation

@esengine

Copy link
Copy Markdown
Owner

Summary

  • Silent follow-up to feat: Add Java source code search and decompilation tools. #1344 to bring the new `src/java/` and `src/tools/java-source.ts` in line with CLAUDE.md comment rules — section-banner separators (`// ── types ──`, `// ── helpers ──`), 2–3-line module-header essays, and JSDoc-style `@param`/`@returns` restating type signatures are all banned. Trimmed to plain code with comments only on hidden constraints (e.g. EOCD comment search up to 64 KiB, javap exit-code diagnostic preservation).
  • Isolated three `searchProject` tests from the real `/.m2` / `/.gradle` defaults — they were walking real caches and timing out on dev machines under full-suite I/O contention. Pass `repoPaths: []` plus a defensive 30s per-test cap.

No behavior change in production code. 41 java-source tests still pass.

Test plan

  • `npm run verify` green locally (full suite: 236 files / 3297 passed, 9 skipped)
  • `tests/java-source.test.ts` standalone still passes (41/41)

reasonix added 2 commits May 19, 2026 18:08
#1344 followed conventions from a different codebase — `// ── types ──`
banner separators, multi-line module-header essays, and JSDoc-style
`@param`/`@returns` text restating type signatures. CLAUDE.md bans all
three. Trim to plain code with comments only on hidden constraints or
non-obvious invariants.

No behavior change; all 41 java-source tests still pass.
Three searchProject tests ("returns not-found", "skips common non-source
directories", "handles empty project root gracefully") were walking the
real ~/.m2 / ~/.gradle defaults — fine on a fresh CI runner, flaky on a
dev machine with a populated cache under full-suite I/O contention.

- Pass repoPaths: [] so the not-found path skips the jar scan entirely.
- Bump per-test timeout to 30s as a defensive cap; the searches now run
  in ms, but Windows AV scanning of fresh tmp dirs can still spike.
@esengine esengine merged commit 6cc7a8e into main May 20, 2026
4 checks passed
@esengine esengine deleted the chore/java-source-comment-cleanup branch May 20, 2026 01:23
ChasLui pushed a commit to ChasLui/DeepSeek-Reasonix that referenced this pull request May 23, 2026
…engine#1363)

* chore(java): strip section-banner comments and module-header essays

esengine#1344 followed conventions from a different codebase — `// ── types ──`
banner separators, multi-line module-header essays, and JSDoc-style
`@param`/`@returns` text restating type signatures. CLAUDE.md bans all
three. Trim to plain code with comments only on hidden constraints or
non-obvious invariants.

No behavior change; all 41 java-source tests still pass.

* test(java-source): isolate project-search tests from real ~/.m2 cache

Three searchProject tests ("returns not-found", "skips common non-source
directories", "handles empty project root gracefully") were walking the
real ~/.m2 / ~/.gradle defaults — fine on a fresh CI runner, flaky on a
dev machine with a populated cache under full-suite I/O contention.

- Pass repoPaths: [] so the not-found path skips the jar scan entirely.
- Bump per-test timeout to 30s as a defensive cap; the searches now run
  in ms, but Windows AV scanning of fresh tmp dirs can still spike.

---------

Co-authored-by: reasonix <reasonix@deepseek.com>
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