Skip to content

docs: add research notes on capture, lane reviews and scoring - #6

Closed
SamGu-NRX wants to merge 6 commits into
mainfrom
t3/research
Closed

SamGu-NRX wants to merge 6 commits into
mainfrom
t3/research

Conversation

@SamGu-NRX

@SamGu-NRX SamGu-NRX commented Sep 26, 2026 •

Copy link
Copy Markdown
Owner

What changed

docs/research/ gets six notes and an index. Each answers one question for the person who owns that part of the plan, and builds on docs/00 through docs/05 rather than replacing them.

  • t3-capture-surfaces.md (everyone): what each phone surface can measure. AR on iPhone needs native code, which an App Clip can supply without a full install; Android Chrome's WebXR has tracking but its export is untested; iPhone Safari has no WebXR AR. It ends with the path to Android after the hackathon.
  • t3-no-lidar-capture.md (lanes A and B): how an iPhone without LiDAR measures the wall line, positions along the wall, the facing gap and overhead clearance, using ground-contact taps, a vertical plane built from them, and two-view triangulation. Accuracy figures are hypotheses, with a one-hour tape test to settle them.
  • t3-first-try-capture.md (lane A): the evidence each check needs, the finish rule, close-up gates for the meter label and panel, the homeowner's screens, and a first trial with four staged cases. It proposes ending the walk at one fully evidenced spot. The plan and docs/05 keep the walk-to-both-ends rule, so that proposal needs the team's decision.
  • t3-lane-c-review.md (lane C): what the solver specification must settle before it approves or rejects a site, plus test cases in rules.yaml parameter terms.
  • t3-scoring-protocol.md (lane D): how to compare capture methods on one to three houses against an independent tape survey, and what that evidence can and cannot show.

The notes propose; the lane owners decide.

Why

Most homeowners have no LiDAR, and the plan's answer for them was to leave the facing gap and headroom UNSURE. These notes test whether ordinary phones can do better, and review the lane plans before code hardens around them. Two experiments build on them: the measurement rig in experiments/measure-lab and the scoring harness in #4.

Base's material stays out

Following AGENTS.md, no note quotes or summarizes what Base gave the team. Numbers come only from Base's public help page, the codes (IRC R328, NEC 110.26 and 706.15) and the team's own docs. Every other threshold is a named rules.yaml parameter marked for Base to set. Solver test cases that depend on Base-specific policy stay in the team's private notes.

Verification

  • An independent reviewer checked each note against its sources and against the private criteria, and flagged overclaims or leaks. Every flagged sentence was fixed, including a final pass that searched for summaries of Base policy behavior.
  • Every relative link in the notes resolves, and git diff --check passes.
  • No code changed, and no measurement ran on a phone. The accuracy numbers stay hypotheses until the measure-lab trial.

Checklist

  • The scope is focused; related changes belong together
  • I explained what changed and why
  • N/A: before and after images or video. Documentation only.

🤖 Generated with Claude Code

Six notes from the agents working beside the four lanes, each answering
one question for one lane owner: what each phone surface can measure,
how an iPhone without LiDAR measures the placement quantities, how the
capture knows it has enough before the homeowner leaves, challenger
reviews of the lane A and lane C plans (with solver test cases), and a
scoring protocol for comparing capture methods against a tape survey.
Thresholds without a public source appear as rules.yaml parameters.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@codemetrics-ai

Copy link
Copy Markdown

Note

Review skipped

Codemetrics is installed on this repository, but it hasn't been added to your team yet.

To enable AI code reviews for this repo, go to your dashboard and add house-scanning to your team's repositories.

@vercel

vercel Bot commented Sep 26, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated
house-scanning-web Ignored Ignored Preview Sep 26, 2026 10:13am UTC

@coderabbitai

coderabbitai Bot commented Sep 26, 2026 •

Copy link
Copy Markdown

Warning

Review limit reached

Next included review available in 55 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: dde295cf-87dd-4b92-bf30-f3d65dd1d7ab

📥 Commits

Reviewing files that changed from the base of the PR and between eb9d480 and 9737e3f.

📒 Files selected for processing (6)
  • docs/research/README.md
  • docs/research/t3-capture-surfaces.md
  • docs/research/t3-first-try-capture.md
  • docs/research/t3-lane-c-review.md
  • docs/research/t3-no-lidar-capture.md
  • docs/research/t3-scoring-protocol.md

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@github-actions github-actions Bot added the size:L 100-499 effective changed lines. label Sep 26, 2026
SamGu-NRX and others added 4 commits September 25, 2026 22:17
A pass on a borderline survey is a missed review, not an unsafe pass, so
unsafe always means the survey shows the spot breaks a rule.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Code <noreply@anthropic.com>
The ground-truth section described a meters-based file mapped to Site
Model v0.1, a contract that was removed before the setup merged. It now
defers to the formats in experiments/scoring/README.md (feet, survey ids,
sha256 capture and rules ids) and names the Measure Lab importer for the
AR row. The recorder is Measure Lab until the lane A app records
sessions, and the projection gate names the capture-contract probe.
Survey outcomes use the harness's strict rule, and decisions made
without their measurement are counted separately.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Code <noreply@anthropic.com>
@SamGu-NRX

Copy link
Copy Markdown
Owner Author

@coderabbitai review

@coderabbitai

coderabbitai Bot commented Sep 26, 2026 •

Copy link
Copy Markdown
⚠️ Action not completed

Review rate limited.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

Its gaps (capture ending at the wall ends instead of when each check has
evidence, no per-spot evidence tracking, LiDAR in the acceptance case) are
handled by the iOS app's coverage map and gap loop and by the decision that
LiDAR is optional. No other note or branch links to it.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
@SamGu-NRX

Copy link
Copy Markdown
Owner Author

Closing without merging. These notes were written for the four lanes, which the client and server team split replaced. They link to docs that #14 deleted, and their content has since been built: the scoring protocol into #4, no-LiDAR capture into #7, first-try capture into #10, and the solver review into #11's tests. The branch stays. #4's one citation of the scoring protocol now points to a permanent copy.

@SamGu-NRX SamGu-NRX closed this Sep 26, 2026
SamGu-NRX pushed a commit that referenced this pull request Oct 15, 2026
* Sync b1-detection breadth work from the Project store (no result file yet)

* Sync b1-detection breadth work from the Project store (no result file yet)

* Sync b1-detection breadth work from the Project store (result file B1-detection.md)
@SamGu-NRX
SamGu-NRX deleted the t3/research branch October 15, 2026 11:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:L 100-499 effective changed lines.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant