[philmcneely]

Adds docs/HEAL_SERVICE_SPEC.md, the spec for one heal service that this framework and the TypeScript framework both call over HTTP, and links it from the README.

It records the decisions made on 2026-11-05:

• Repo: the service repo stays private until it is tested, commented and documented.
• Code: it reuses the existing locator-healing code instead of a rewrite.
• Fingerprint file: .heal/fingerprints.json is kept out of git by default and cached in CI.
• Test ids: the client sends the project's test-id attribute.
• Structural or positional locators: a heal whose only unique locator is structural or positional ends needs_human in phase 1.

Docs only; no code changes.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota. Try requesting a review at a lower effort level.

[philmcneely]

No changes made. Copilot's only review on this PR says it could not run because the reviewer's quota ran out. That review has no code or inline comments, and the PR has no other review comments, so there is nothing to fix. To get a real review, re-request Copilot at a lower effort level, or after the quota resets.

🤖 Generated with Claude Code

[github-actions]

✅ All smoke tests passed! View report

[github-actions]

✅ All chromium login tests passed! View report

[github-actions]

✅ All firefox login tests passed! View report

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota. Try requesting a review at a lower effort level.

[philmcneely]

No changes made again. Copilot's second review attempt also failed on quota, the same as the first, and contains no feedback. This PR (README.md, docs/HEAL_SERVICE_SPEC.md) still has no inline or review comments to address, and smoke/chromium/firefox CI is green. Re-request the review once quota resets or at a lower effort level.