docs: fix stale README Node version and source pointers #3

Merged
jercik merged 1 commit from docs/readme-requirements-and-source-pointers into main 2026-10-22 17:44:42 +00:00
Owner

Fixes three README errors that the review of #2 found in text that PR leaves unchanged: the Node.js minimum, the prompt file path, and the model pointers.

🤖 Generated with Claude Code

Fixes three README errors that the review of #2 found in text that PR leaves unchanged: the Node.js minimum, the prompt file path, and the model pointers. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
docs: fix stale README Node version and source pointers
All checks were successful
Checks / pr-flow-canary (pull_request) Has been skipped
Checks / reuse (pull_request) Successful in 4s
commit-msg / commitlint (pull_request) Successful in 10s
Checks / quality-checks (26.5.0) (pull_request) Successful in 39s
Checks / quality-checks (24.15.0) (pull_request) Successful in 42s
Review / Review (pull_request_target) Successful in 2m3s
1aa2b56dfa
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Review 01M5JAJSJW763V9GB1PVQ20DT6 — head 1aa2b56dfaa6719324ddaab071b1f7e825c73993

Review — j4k-oss/perplexity-agent-mcp @ f3140beaea

Scope: diff against base tree 202843f6ef87
Status: dispatched — coverage complete (4/4 slots terminal)
Facts: current review-wide projection

Computed under:

{
  "abandonment": "abandonment-v1",
  "anchor_recipe": 1,
  "batch_policy": "batch-v1",
  "coverage": "coverage-v3",
  "dispatch_policy": "dispatch-v2",
  "grounder_version": 1,
  "grounding_read_rule": "grounding-read-v1",
  "promotion_policy": "promotion-v1",
  "report": "report-v4",
  "tally": "tally-v1",
  "triage_settle": "triage-settle-v2"
}

Findings (1)

low — The testing section has no content

  • claim: 01M5JAMV6TQ9JQMSZXFTQDEPSR
  • anchor: README.md (snippet)
# Testing hooks
  • lens: writing-quality · arm: default
  • verdicts: 1 valid / 0 invalid / 0 uncertain
    • pass 01M5JAN7BVXT5265Q5BA70X6G6 · valid: The exact-grounded snippet establishes the heading. The reviewer specifically reports that README.md ends immediately after it, with no guidance or pointer beneath it; this supplies the empty-section mechanism beyond a bare assertion of inspection. The human-facing Structure guidance calls for deleting empty sections. Removing this heading eliminates a navigation stop that promises testing guidance and provides none, without losing any procedure or constraint. No batch evidence contradicts the reported end-of-file placement. Low severity is appropriate.
  • disposition: none

Readers looking for testing guidance reach a heading with nothing beneath it. It creates a navigation stop without answering a question or pointing to guidance.

The README ends immediately after # Testing hooks. The human-facing writing skill's Structure guidance says to delete a section with nothing to say rather than leave a placeholder. Remove this heading; it carries no testing procedure, prerequisite, or other useful meaning to preserve.

I read README.md in full and checked package.json, which defines the test command but is not referenced by this section. This is a documentation observation, not a test execution result. The finding would be refuted by content under the heading in the reviewed file; the supplied tree contains none.

Other claims

  • grounding-pending (0)
  • ungrounded (0)
  • rejected (0)
  • duplicate-of (0)
  • unadjudicated (0)

Coverage

Coverage pass: 01M5JAK4J7HNNX5J3YF5441N1A
Accounting: complete
Slot health: healthy

lens part arm unit status runs loss
restated-sets whole default no-claims 1 no
general-bug whole default no-claims 1 no
writing-quality whole default claims-emitted 1 no
project-docs whole default no-claims 1 no
  • test-trimming — skipped-by-dispatch: no tests changed; only README.md modified
  • unix-cli — skipped-by-dispatch: no CLI code or behavior changed; documentation text only
  • use-effect — skipped-by-dispatch: only README.md changed; no React code or Effects
  • react — skipped-by-dispatch: only README.md changed; no React components
<!-- review:summary --> **Review** `01M5JAJSJW763V9GB1PVQ20DT6` — head `1aa2b56dfaa6719324ddaab071b1f7e825c73993` # Review — j4k-oss/perplexity-agent-mcp @ f3140beaeabc Scope: diff against base tree `202843f6ef87` Status: dispatched — coverage complete (4/4 slots terminal) Facts: current review-wide projection Computed under: ```json { "abandonment": "abandonment-v1", "anchor_recipe": 1, "batch_policy": "batch-v1", "coverage": "coverage-v3", "dispatch_policy": "dispatch-v2", "grounder_version": 1, "grounding_read_rule": "grounding-read-v1", "promotion_policy": "promotion-v1", "report": "report-v4", "tally": "tally-v1", "triage_settle": "triage-settle-v2" } ``` ## Findings (1) ### low — The testing section has no content - claim: `01M5JAMV6TQ9JQMSZXFTQDEPSR` - anchor: `README.md` (snippet) ``` # Testing hooks ``` - lens: writing-quality · arm: default - verdicts: 1 valid / 0 invalid / 0 uncertain - pass `01M5JAN7BVXT5265Q5BA70X6G6` · valid: The exact-grounded snippet establishes the heading. The reviewer specifically reports that README.md ends immediately after it, with no guidance or pointer beneath it; this supplies the empty-section mechanism beyond a bare assertion of inspection. The human-facing Structure guidance calls for deleting empty sections. Removing this heading eliminates a navigation stop that promises testing guidance and provides none, without losing any procedure or constraint. No batch evidence contradicts the reported end-of-file placement. Low severity is appropriate. - disposition: none > Readers looking for testing guidance reach a heading with nothing beneath it. It creates a navigation stop without answering a question or pointing to guidance. > > The README ends immediately after `# Testing hooks`. The human-facing writing skill's Structure guidance says to delete a section with nothing to say rather than leave a placeholder. Remove this heading; it carries no testing procedure, prerequisite, or other useful meaning to preserve. > > I read README.md in full and checked package.json, which defines the test command but is not referenced by this section. This is a documentation observation, not a test execution result. The finding would be refuted by content under the heading in the reviewed file; the supplied tree contains none. ## Other claims - grounding-pending (0) - ungrounded (0) - rejected (0) - duplicate-of (0) - unadjudicated (0) ## Coverage Coverage pass: 01M5JAK4J7HNNX5J3YF5441N1A Accounting: complete Slot health: healthy | lens | part | arm | unit status | runs | loss | | --- | --- | --- | --- | --- | --- | | restated-sets | whole | default | no-claims | 1 | no | | general-bug | whole | default | no-claims | 1 | no | | writing-quality | whole | default | claims-emitted | 1 | no | | project-docs | whole | default | no-claims | 1 | no | - test-trimming — skipped-by-dispatch: no tests changed; only README.md modified - unix-cli — skipped-by-dispatch: no CLI code or behavior changed; documentation text only - use-effect — skipped-by-dispatch: only README.md changed; no React code or Effects - react — skipped-by-dispatch: only README.md changed; no React components
@ -63,3 +62,4 @@
- Node.js v24.15.0 or newer
- A Perplexity API key
# Testing hooks

low — The testing section has no content

Readers looking for testing guidance reach a heading with nothing beneath it. It creates a navigation stop without answering a question or pointing to guidance.

The README ends immediately after # Testing hooks. The human-facing writing skill's Structure guidance says to delete a section with nothing to say rather than leave a placeholder. Remove this heading; it carries no testing procedure, prerequisite, or other useful meaning to preserve.

I read README.md in full and checked package.json, which defines the test command but is not referenced by this section. This is a documentation observation, not a test execution result. The finding would be refuted by content under the heading in the reviewed file; the supplied tree contains none.

lens writing-quality · arm default · tally 1 valid / 0 invalid / 0 uncertain
claim 01M5JAMV6TQ9JQMSZXFTQDEPSR of review 01M5JAJSJW763V9GB1PVQ20DT6

<!-- review:claim:01M5JAMV6TQ9JQMSZXFTQDEPSR --> **low** — The testing section has no content > Readers looking for testing guidance reach a heading with nothing beneath it. It creates a navigation stop without answering a question or pointing to guidance. > > The README ends immediately after `# Testing hooks`. The human-facing writing skill's Structure guidance says to delete a section with nothing to say rather than leave a placeholder. Remove this heading; it carries no testing procedure, prerequisite, or other useful meaning to preserve. > > I read README.md in full and checked package.json, which defines the test command but is not referenced by this section. This is a documentation observation, not a test execution result. The finding would be refuted by content under the heading in the reviewed file; the supplied tree contains none. lens `writing-quality` · arm `default` · tally 1 valid / 0 invalid / 0 uncertain claim `01M5JAMV6TQ9JQMSZXFTQDEPSR` of review `01M5JAJSJW763V9GB1PVQ20DT6`
jercik marked this conversation as resolved
Author
Owner

Replying to review comment #178000

Tracked in #4. The empty # Testing hooks heading is real and predates this PR (commit 5f333fa added it). #4 deletes it; it touches only the two lines at the end of the README, which this PR's Node.js requirement edit does not touch, and both merge cleanly in either order.

> Replying to review comment #178000 Tracked in https://code.j4k.dev/j4k-oss/perplexity-agent-mcp/pulls/4. The empty `# Testing hooks` heading is real and predates this PR (commit 5f333fa added it). #4 deletes it; it touches only the two lines at the end of the README, which this PR's Node.js requirement edit does not touch, and both merge cleanly in either order.
jercik merged commit 95a19e6fef into main 2026-10-22 17:44:42 +00:00
jercik deleted branch docs/readme-requirements-and-source-pointers 2026-10-22 17:44:42 +00:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
j4k-oss/perplexity-agent-mcp!3
No description provided.