diff --git a/.github/workflows/system-one-code-locator.yml b/.github/workflows/system-one-code-locator.yml
new file mode 100644
index 00000000..c6c00577
--- /dev/null
+++ b/.github/workflows/system-one-code-locator.yml
@@ -0,0 +1,435 @@
+name: system-one-code-locator-experiment
+
+on:
+  push:
+    paths:
+      - "research/code-locator/src/**"
+      - "research/code-locator/tests/**"
+      - "research/code-locator/fixtures/**"
+      - "research/code-locator/docs/**"
+      - "research/code-locator/README.md"
+      - ".github/workflows/system-one-code-locator.yml"
+  pull_request:
+    paths:
+      - "research/code-locator/src/**"
+      - "research/code-locator/tests/**"
+      - "research/code-locator/fixtures/**"
+      - "research/code-locator/docs/**"
+      - "research/code-locator/README.md"
+      - ".github/workflows/system-one-code-locator.yml"
+  workflow_dispatch:
+    inputs:
+      subject_repository:
+        description: Repository used by the code-localization experiment
+        required: true
+        default: BestNathan/nession
+        type: string
+      subject_ref:
+        description: Git ref of the subject repository
+        required: true
+        default: staging
+        type: string
+      query:
+        description: Code-localization task
+        required: true
+        default: Help me optimize the websocket connection implementation
+        type: string
+      directory_threshold:
+        description: Directory Noul threshold
+        required: true
+        default: "0.35"
+        type: string
+      file_threshold:
+        description: File Noul threshold
+        required: true
+        default: "0.50"
+        type: string
+      line_threshold:
+        description: Source-line Noul threshold
+        required: true
+        default: "0.70"
+        type: string
+      batch_size:
+        description: Noul questions per TypeSafe request
+        required: true
+        default: "48"
+        type: string
+      model:
+        description: TypeSafe model alias
+        required: true
+        default: jev-latest
+        type: string
+      run_typesafe:
+        description: Run the real TypeSafe System One experiment
+        required: true
+        default: false
+        type: boolean
+
+permissions:
+  contents: read
+
+concurrency:
+  group: system-one-code-locator-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
+env:
+  QUERY: ${{ inputs.query || 'Help me optimize the websocket connection implementation' }}
+  DIRECTORY_THRESHOLD: ${{ inputs.directory_threshold || '0.35' }}
+  FILE_THRESHOLD: ${{ inputs.file_threshold || '0.50' }}
+  LINE_THRESHOLD: ${{ inputs.line_threshold || '0.70' }}
+  BATCH_SIZE: ${{ inputs.batch_size || '48' }}
+  TYPESAFE_MODEL: ${{ inputs.model || vars.TYPESAFE_MODEL || 'jev-latest' }}
+
+jobs:
+  offline:
+    name: Offline code-locator validation
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Prepare artifact directory
+        run: mkdir -p artifacts/system-one-code-locator/offline
+
+      - name: Run unit tests
+        shell: bash
+        run: |
+          set -o pipefail
+          python3 -m unittest discover             -s research/code-locator/tests             -p 'test_*.py'             -v 2>&1 | tee artifacts/system-one-code-locator/offline/tests.log
+
+      - name: Run deterministic fixture experiment
+        shell: bash
+        run: |
+          set -o pipefail
+          python3 research/code-locator/src/system_one_code_locator.py             research/code-locator/fixtures/repository             "$QUERY"             --offline-decider             --directory-threshold "$DIRECTORY_THRESHOLD"             --file-threshold "$FILE_THRESHOLD"             --line-threshold 0.60             --batch-size "$BATCH_SIZE"             --trace-file artifacts/system-one-code-locator/offline/trace.jsonl             --output-json artifacts/system-one-code-locator/offline/result.json             2>&1 | tee artifacts/system-one-code-locator/offline/run.log
+
+      - name: Save run metadata and summary
+        env:
+          RUN_ID: ${{ github.run_id }}
+          RUN_ATTEMPT: ${{ github.run_attempt }}
+          COMMIT_SHA: ${{ github.sha }}
+          REF_NAME: ${{ github.ref_name }}
+        run: |
+          python3 - <<'PY'
+          import json
+          import os
+          from pathlib import Path
+
+          root = Path("artifacts/system-one-code-locator/offline")
+          result = json.loads((root / "result.json").read_text())
+
+          metadata = {
+              "schema_version": 1,
+              "mode": "offline",
+              "query": os.environ["QUERY"],
+              "model": "offline-lexical-fixture",
+              "thresholds": {
+                  "directory": float(os.environ["DIRECTORY_THRESHOLD"]),
+                  "file": float(os.environ["FILE_THRESHOLD"]),
+                  "line": 0.60,
+              },
+              "batch_size": int(os.environ["BATCH_SIZE"]),
+              "github_run_id": os.environ["RUN_ID"],
+              "github_run_attempt": os.environ["RUN_ATTEMPT"],
+              "commit_sha": os.environ["COMMIT_SHA"],
+              "ref_name": os.environ["REF_NAME"],
+          }
+          (root / "run-manifest.json").write_text(
+              json.dumps(metadata, indent=2) + "\n",
+              encoding="utf-8",
+          )
+
+          lines = [
+              "# System One Code Locator — offline fixture",
+              "",
+              f"- Query: `{metadata['query']}`",
+              f"- Directories: {len(result.get('directories', []))}",
+              f"- Files: {len(result.get('files', []))}",
+              f"- Snippets: {len(result.get('snippets', []))}",
+              f"- Metrics: `{result.get('metrics', {})}`",
+          ]
+          (root / "summary.md").write_text("\n".join(lines) + "\n")
+          PY
+
+      - name: Publish summary
+        if: always()
+        run: |
+          if test -f artifacts/system-one-code-locator/offline/summary.md; then
+            cat artifacts/system-one-code-locator/offline/summary.md >> "$GITHUB_STEP_SUMMARY"
+          fi
+
+      - name: Upload offline experiment artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: system-one-code-locator-offline-${{ github.run_id }}-${{ github.run_attempt }}
+          path: artifacts/system-one-code-locator/offline/
+          if-no-files-found: error
+          retention-days: 90
+
+  typesafe:
+    name: Real TypeSafe code-locator experiment
+    if: ${{ github.event_name == 'workflow_dispatch' && inputs.run_typesafe }}
+    runs-on: ubuntu-24.04
+    environment: typesafe
+    timeout-minutes: 120
+
+    steps:
+      - name: Checkout Narness harness
+        uses: actions/checkout@v4
+        with:
+          path: narness
+          fetch-depth: 1
+          persist-credentials: false
+
+      - name: Checkout subject repository
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ inputs.subject_repository }}
+          ref: ${{ inputs.subject_ref }}
+          path: subject
+          fetch-depth: 1
+          persist-credentials: false
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Require TypeSafe credentials
+        env:
+          TYPESAFE_API_KEY: ${{ secrets.TYPESAFE_API_KEY || vars.TYPESAFE_API_KEY }}
+        run: |
+          test -n "$TYPESAFE_API_KEY" || {
+            echo "TYPESAFE_API_KEY is required in the typesafe environment." >&2
+            exit 2
+          }
+
+      - name: Prepare artifact directory
+        run: mkdir -p artifacts/system-one-code-locator/typesafe
+
+      - name: Save run manifest
+        env:
+          SUBJECT_REPOSITORY: ${{ inputs.subject_repository }}
+          SUBJECT_REF: ${{ inputs.subject_ref }}
+          RUN_ID: ${{ github.run_id }}
+          RUN_ATTEMPT: ${{ github.run_attempt }}
+          HARNESS_SHA: ${{ github.sha }}
+        run: |
+          python3 - <<'PY'
+          import json
+          import os
+          import subprocess
+          from pathlib import Path
+
+          def revision(path):
+              return subprocess.check_output(
+                  ["git", "-C", path, "rev-parse", "HEAD"],
+                  text=True,
+              ).strip()
+
+          payload = {
+              "schema_version": 1,
+              "mode": "typesafe",
+              "query": os.environ["QUERY"],
+              "model": os.environ["TYPESAFE_MODEL"],
+              "thresholds": {
+                  "directory": float(os.environ["DIRECTORY_THRESHOLD"]),
+                  "file": float(os.environ["FILE_THRESHOLD"]),
+                  "line": float(os.environ["LINE_THRESHOLD"]),
+              },
+              "batch_size": int(os.environ["BATCH_SIZE"]),
+              "harness": {
+                  "repository": os.environ.get("GITHUB_REPOSITORY"),
+                  "revision": revision("narness"),
+              },
+              "subject": {
+                  "repository": os.environ["SUBJECT_REPOSITORY"],
+                  "requested_ref": os.environ["SUBJECT_REF"],
+                  "revision": revision("subject"),
+              },
+              "github_run_id": os.environ["RUN_ID"],
+              "github_run_attempt": os.environ["RUN_ATTEMPT"],
+          }
+          root = Path("artifacts/system-one-code-locator/typesafe")
+          (root / "run-manifest.json").write_text(
+              json.dumps(payload, indent=2) + "\n",
+              encoding="utf-8",
+          )
+          PY
+
+      - name: Run real System One code locator
+        env:
+          TYPESAFE_API_KEY: ${{ secrets.TYPESAFE_API_KEY || vars.TYPESAFE_API_KEY }}
+          TYPESAFE_API_URL: ${{ vars.TYPESAFE_API_URL || 'https://api.typesafe.ai/v1/systemone' }}
+        shell: bash
+        run: |
+          set -o pipefail
+          python3 narness/research/code-locator/src/system_one_code_locator.py             subject             "$QUERY"             --directory-threshold "$DIRECTORY_THRESHOLD"             --file-threshold "$FILE_THRESHOLD"             --line-threshold "$LINE_THRESHOLD"             --batch-size "$BATCH_SIZE"             --model "$TYPESAFE_MODEL"             --trace-file artifacts/system-one-code-locator/typesafe/trace.jsonl             --output-json artifacts/system-one-code-locator/typesafe/result.json             2>&1 | tee artifacts/system-one-code-locator/typesafe/run.log
+
+      - name: Build research summary
+        if: always()
+        run: |
+          python3 - <<'PY'
+          import json
+          import os
+          from pathlib import Path
+
+          root = Path("artifacts/system-one-code-locator/typesafe")
+          manifest_path = root / "run-manifest.json"
+          result_path = root / "result.json"
+
+          lines = ["# System One Code Locator — TypeSafe run", ""]
+
+          if manifest_path.exists():
+              manifest = json.loads(manifest_path.read_text())
+              lines += [
+                  f"- Subject: `{manifest['subject']['repository']}@{manifest['subject']['revision']}`",
+                  f"- Query: `{manifest['query']}`",
+                  f"- Model: `{manifest['model']}`",
+                  f"- Thresholds: `{manifest['thresholds']}`",
+                  "",
+              ]
+
+          if result_path.exists():
+              result = json.loads(result_path.read_text())
+              lines += [
+                  "## Result",
+                  "",
+                  f"- Directories: {len(result.get('directories', []))}",
+                  f"- Files: {len(result.get('files', []))}",
+                  f"- Snippets: {len(result.get('snippets', []))}",
+                  f"- Metrics: `{result.get('metrics', {})}`",
+                  "",
+                  "### Selected files",
+                  "",
+              ]
+              lines += [
+                  f"- `{item['id']}` ({item['score']:.3f})"
+                  for item in result.get("files", [])
+              ]
+          else:
+              lines += [
+                  "## Result",
+                  "",
+                  "The experiment did not produce result.json. Inspect run.log and trace.jsonl.",
+              ]
+
+          summary = "\n".join(lines) + "\n"
+          (root / "summary.md").write_text(summary)
+          with open(Path(os.environ["GITHUB_STEP_SUMMARY"]), "a") as handle:
+              handle.write(summary)
+          PY
+        env:
+          PYTHONUNBUFFERED: "1"
+
+      - name: Upload TypeSafe experiment artifacts
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: system-one-code-locator-typesafe-${{ github.run_id }}-${{ github.run_attempt }}
+          path: artifacts/system-one-code-locator/typesafe/
+          if-no-files-found: warn
+          retention-days: 90
+
+  persist-record:
+    name: Persist experiment record
+    needs:
+      - offline
+      - typesafe
+    if: ${{ always() && github.event_name != 'pull_request' }}
+    runs-on: ubuntu-24.04
+    timeout-minutes: 10
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout experiment branch
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.ref_name }}
+          fetch-depth: 1
+          persist-credentials: true
+
+      - name: Download offline evidence
+        uses: actions/download-artifact@v4
+        continue-on-error: true
+        with:
+          name: system-one-code-locator-offline-${{ github.run_id }}-${{ github.run_attempt }}
+          path: .experiment-record/offline
+
+      - name: Download TypeSafe evidence
+        if: ${{ github.event_name == 'workflow_dispatch' && inputs.run_typesafe }}
+        uses: actions/download-artifact@v4
+        continue-on-error: true
+        with:
+          name: system-one-code-locator-typesafe-${{ github.run_id }}-${{ github.run_attempt }}
+          path: .experiment-record/typesafe
+
+      - name: Materialize repository record
+        env:
+          OFFLINE_RESULT: ${{ needs.offline.result }}
+          TYPESAFE_RESULT: ${{ needs.typesafe.result }}
+          RUN_URL: https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}
+        shell: bash
+        run: |
+          set -euo pipefail
+
+          stamp="$(TZ=Asia/Shanghai date +'%Y%m%dT%H%M%S%z')"
+          record="research/code-locator/runs/${stamp}-run-${GITHUB_RUN_ID}-attempt-${GITHUB_RUN_ATTEMPT}"
+          mkdir -p "$record"
+
+          if test -d .experiment-record/offline; then
+            mkdir -p "$record/offline"
+            cp -a .experiment-record/offline/. "$record/offline/"
+          fi
+
+          if test -d .experiment-record/typesafe; then
+            mkdir -p "$record/typesafe"
+            cp -a .experiment-record/typesafe/. "$record/typesafe/"
+          fi
+
+          {
+            echo "# System One Code Locator experiment"
+            echo
+            printf -- '- Recorded at: `%s` (UTC+8)\n' "$stamp"
+            printf -- '- GitHub run: [%s](%s)\n' "$GITHUB_RUN_ID" "$RUN_URL"
+            printf -- '- Run attempt: `%s`\n' "$GITHUB_RUN_ATTEMPT"
+            printf -- '- Event: `%s`\n' "$GITHUB_EVENT_NAME"
+            printf -- '- Repository: `%s`\n' "$GITHUB_REPOSITORY"
+            printf -- '- Ref: `%s`\n' "$GITHUB_REF_NAME"
+            printf -- '- Trigger SHA: `%s`\n' "$GITHUB_SHA"
+            printf -- '- Offline job: `%s`\n' "$OFFLINE_RESULT"
+            printf -- '- TypeSafe job: `%s`\n' "$TYPESAFE_RESULT"
+            echo
+            echo "## Evidence"
+            echo
+            echo "- [Offline evidence](offline/) when the offline validation produced an artifact."
+            echo "- [TypeSafe evidence](typesafe/) when a real TypeSafe experiment was requested."
+            echo
+            echo "The files in this directory are an immutable snapshot of the evidence produced by this workflow run."
+          } > "$record/README.md"
+
+          echo "RECORD_DIR=$record" >> "$GITHUB_ENV"
+
+      - name: Commit experiment record
+        shell: bash
+        run: |
+          set -euo pipefail
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+          git add "$RECORD_DIR"
+
+          if git diff --cached --quiet; then
+            echo "No experiment evidence to commit."
+            exit 0
+          fi
+
+          git commit -m "research: record code locator run ${GITHUB_RUN_ID}"
+          git pull --rebase origin "${GITHUB_REF_NAME}"
+          git push origin "HEAD:${GITHUB_REF_NAME}"
diff --git a/README.md b/README.md
index 06ec4a77..d80e5dc7 100644
--- a/README.md
+++ b/README.md
@@ -224,7 +224,7 @@ bash plugins/narness/scripts/narness-rust-test-integration.sh examples/rust-work
 
 The example contains a root workspace contract, a task Skill with progressive disclosure, unit and integration evidence, an environment declaration, and a stable CI required gate.
 
-The repository also contains research prototypes that are intentionally outside the canonical Narness runtime scope, including the [System One Kubernetes command generator](examples/system-one-k8s/README.md) used by the progressive-action-space topic.
+The repository also contains research prototypes that are intentionally outside the canonical Narness runtime scope, including the [System One Kubernetes command generator](examples/system-one-k8s/README.md) and [System One code locator](research/code-locator/README.md) used by the progressive-action-space topic.
 
 ## Adopt Narness
 
@@ -259,6 +259,7 @@ Start with [docs/adoption.md](docs/adoption.md):
 - [Change-to-Evidence Planning topic](docs/topics/change-to-evidence-planning/README.md)
 - [System One Progressive Action Spaces topic](docs/topics/system-one-progressive-action-space/README.md)
 - [System One Kubernetes command generator](examples/system-one-k8s/README.md)
+- [System One code locator](research/code-locator/README.md)
 - [AI Workspace architecture](docs/architecture.md)
 - [Adoption guide](docs/adoption.md)
 - [Runnable Rust example](examples/rust-workspace/README.md)
diff --git a/docs/topics/system-one-progressive-action-space/README.md b/docs/topics/system-one-progressive-action-space/README.md
index f13ae080..e5e5efd4 100644
--- a/docs/topics/system-one-progressive-action-space/README.md
+++ b/docs/topics/system-one-progressive-action-space/README.md
@@ -587,7 +587,57 @@ The result should distinguish between tasks that are naturally frontier-driven a
 - Can the same runtime interface serve Kubernetes, coding, and browser environments?
 - How much state should be sent to System One at each branch?
 
-## 18. Relationship to Narness
+## 18. Code localization experiment
+
+The second reference experiment applies the same progressive-disclosure idea to source-code localization.
+
+```text
+repository
+  -> directory candidates
+  -> relevant directories
+  -> file candidates
+  -> relevant files
+  -> source-line candidates
+  -> grounded code snippets
+```
+
+Unlike Kubernetes action selection, this stage is not a single-winner decision. Multiple directories, files, and source ranges can all be relevant, so the prototype uses independent Noul judgments rather than Choice.
+
+The harness owns traversal, filesystem IO, batching, thresholds, provenance, and range merging. System One only estimates candidate relevance.
+
+This broadens the working runtime abstraction:
+
+```text
+StateSpaceGenerator
+  -> CandidateSet
+  -> DecisionPrimitive
+  -> TransitionPolicy
+  -> EvidenceRecorder
+```
+
+The decision primitive can therefore vary by state:
+
+- `Choice` for selecting one grounded action from a local frontier;
+- `Noul` for independently retaining multiple relevant candidates;
+- deterministic short-circuiting where model judgment is unnecessary.
+
+See [Hierarchical Code Localization with System One](../../../research/code-locator/docs/design.md) for the hypotheses, threshold/recall analysis, evidence contract, and experiment plan.
+
+## 19. Research evidence workflows
+
+The experiments use separate workflows because they exercise different decision primitives, inputs, costs, and failure modes.
+
+- [System One Kubernetes experiment](../../../.github/workflows/system-one-k8s-experiment.yml) owns only the Kubernetes state-machine demo.
+- [System One Code Locator experiment](../../../.github/workflows/system-one-code-locator.yml) owns only hierarchical code localization.
+
+The Code Locator workflow has two layers:
+
+1. deterministic fixture validation on Code Locator changes, requiring no external model service;
+2. manually dispatched real-System-One localization against a configurable subject repository.
+
+Its artifact contains only Code Locator evidence: run metadata, execution log, `trace.jsonl`, `result.json`, and `summary.md`. This keeps repository-localization research independent from Kubernetes results and makes failures, costs, and parameter sweeps attributable to one experiment.
+
+## 20. Relationship to Narness
 
 Narness currently defines itself as AI Workspace Engineering and explicitly does not aim to become a general Agent Runtime.
 
@@ -599,9 +649,13 @@ It is still relevant because it explores a neighboring harness-engineering quest
 
 If the conclusions stabilize, some of them may graduate into Narness concepts around progressive disclosure, capability representation, deterministic execution, policy, evidence, and agent observability without requiring Narness itself to own a runtime.
 
-## Reference implementation
+## Reference implementations
 
-See [System One Kubernetes Command Generator](../../../examples/system-one-k8s/README.md).
+- [System One Kubernetes Command Generator](../../../examples/system-one-k8s/README.md)
+- [System One Code Locator](../../../research/code-locator/README.md)
+- [Code localization research note](../../../research/code-locator/docs/design.md)
+- [System One Kubernetes experiment workflow](../../../.github/workflows/system-one-k8s-experiment.yml)
+- [System One Code Locator experiment workflow](../../../.github/workflows/system-one-code-locator.yml)
 
 ## Related Narness topics
 
diff --git a/research/code-locator/README.md b/research/code-locator/README.md
new file mode 100644
index 00000000..9c534649
--- /dev/null
+++ b/research/code-locator/README.md
@@ -0,0 +1,219 @@
+# System One Code Locator
+
+> Experimental research project. This is a localization harness, not a code-changing agent and not part of the canonical Narness runtime.
+
+This directory is the complete Code Locator research unit: implementation, fixtures, tests, design notes, pilot analyses, and immutable run records live together here.
+
+## Project layout
+
+```text
+research/code-locator/
+├── README.md
+├── src/
+│   └── system_one_code_locator.py
+├── tests/
+│   └── test_system_one_code_locator.py
+├── fixtures/
+│   └── repository/
+├── docs/
+│   ├── design.md
+│   └── pilots/
+│       └── nession-websocket-2026-09-23.md
+└── runs/
+    └── <time>-run-<run_id>-attempt-<n>/
+```
+
+The `src/`, `tests/`, and `fixtures/` directories define the experiment. `docs/` contains evolving research reasoning. `runs/` is append-only evidence produced by GitHub Actions.
+
+See [design.md](docs/design.md) for the hypotheses and experiment design, and [the first Nession pilot](docs/pilots/nession-websocket-2026-09-23.md) for the first real TypeSafe baseline.
+
+This project explores whether a fast System One model can localize code by repeatedly judging a progressively disclosed search space rather than driving repository browsing through a ReAct loop.
+
+Given a request such as:
+
+> Help me optimize the websocket connection implementation.
+
+and a repository root, the harness performs:
+
+```text
+repository
+  -> enumerate directory candidates
+  -> System One relevance scores
+  -> keep directories above threshold
+  -> enumerate files under retained directories
+  -> System One relevance scores
+  -> keep files above threshold
+  -> split retained files into source lines with small local context
+  -> System One relevance scores
+  -> merge adjacent relevant lines into snippets
+```
+
+The model never chooses filesystem tools, constructs paths, or controls traversal. The harness owns state expansion, thresholds, IO, provenance, batching, and result assembly.
+
+## Why Noul instead of Choice
+
+Directory, file, and line relevance are independent judgments: several candidates may all be relevant. The TypeSafe System One API's `noul` primitive returns a yes-probability for each question, so the runtime can retain every candidate whose score crosses the stage threshold.
+
+`choice` would instead normalize probability across candidates and force one winner, which is appropriate for the Kubernetes action-frontier demo but not for multi-hit code localization.
+
+## State progression
+
+```text
+RepositoryState
+  |
+  | deterministic enumeration
+  v
+DirectoryCandidate[]
+  |
+  | Noul relevance + low threshold
+  v
+RelevantDirectory[]
+  |
+  | deterministic enumeration
+  v
+FileCandidate[]
+  |
+  | Noul relevance + medium threshold
+  v
+RelevantFile[]
+  |
+  | read source + split on newlines
+  v
+LineCandidate[]
+  |
+  | Noul relevance + higher threshold
+  v
+RelevantLine[]
+  |
+  | deterministic range merge
+  v
+CodeSnippet[]
+```
+
+The defaults intentionally become stricter as the search gets deeper:
+
+```text
+directory >= 0.35
+file      >= 0.50
+line      >= 0.70
+```
+
+These are experiment parameters, not claimed optimal values. Early false negatives are especially expensive because pruning a directory removes its entire subtree. A future experiment should compare simple thresholds against threshold-plus-beam retention.
+
+## Run the deterministic fixture
+
+No API key is required:
+
+```bash
+python3 research/code-locator/src/system_one_code_locator.py \
+  research/code-locator/fixtures/repository \
+  "Help me optimize the websocket connection implementation" \
+  --offline-decider \
+  --line-threshold 0.60
+```
+
+The offline scorer is only a deterministic fixture implementation. It is not intended to emulate System One quality.
+
+## Run with TypeSafe System One
+
+```bash
+export TYPESAFE_API_KEY=...
+
+python3 research/code-locator/src/system_one_code_locator.py \
+  /path/to/repository \
+  "Help me optimize the websocket connection implementation"
+```
+
+Optional environment variables:
+
+```bash
+export TYPESAFE_API_URL=https://api.typesafe.ai/v1/systemone
+export TYPESAFE_MODEL=jev-latest
+```
+
+## Research trace
+
+Use `--trace-file` to create an append-only JSONL trace and `--output-json` to persist the final result:
+
+```bash
+python3 research/code-locator/src/system_one_code_locator.py \
+  /path/to/repository \
+  "Help me optimize the websocket connection implementation" \
+  --trace-file evidence/code-locator.trace.jsonl \
+  --output-json evidence/code-locator.result.json
+```
+
+The trace records:
+
+- the query, model, root, and thresholds;
+- every directory/file/line candidate disclosed by the harness;
+- every TypeSafe request body without credentials;
+- model responses reduced to candidate scores, latency, and token usage;
+- every threshold application and retained candidate set;
+- the final result and aggregate metrics.
+
+This makes a workflow run useful as research evidence rather than only as a pass/fail CI event.
+
+## Output contract
+
+The final result contains three provenance-preserving layers:
+
+```text
+relevant directories
+relevant files
+relevant snippets { path, start_line, end_line, score, content }
+```
+
+It also reports exposed/selected counts, model calls, token usage, and elapsed time.
+
+## Tests
+
+```bash
+python3 -m unittest discover \
+  -s research/code-locator/tests \
+  -p 'test_*.py' \
+  -v
+```
+
+The tests verify that the deterministic fixture finds the websocket client and that real API requests use independent Noul questions.
+
+## Dedicated research workflow
+
+Code Locator has its own GitHub Actions workflow:
+
+```text
+.github/workflows/system-one-code-locator.yml
+```
+
+It does not run the Kubernetes experiment.
+
+On relevant pushes and pull requests it runs only the deterministic Code Locator fixture and uploads:
+
+```text
+system-one-code-locator-offline-<run>-<attempt>/
+  run-manifest.json
+  tests.log
+  run.log
+  result.json
+  trace.jsonl
+  summary.md
+```
+
+A manual `workflow_dispatch` can additionally run the real TypeSafe experiment against a configurable subject repository. That job uses the `typesafe` environment and uploads a separate `system-one-code-locator-typesafe-*` artifact.
+
+After push or manual runs complete, a persist job writes the evidence permanently under `runs/<time>-run-<run_id>-attempt-<n>/`. Pull-request validation never writes back to the repository.
+
+## Research limitations
+
+The current prototype intentionally leaves several questions open:
+
+- whether whole-tree directory enumeration is better than recursive frontier expansion;
+- threshold calibration and compounding false-negative risk;
+- threshold-only pruning versus keeping a minimum semantic beam;
+- line-level scoring versus symbol/block/chunk-level scoring;
+- caching repeated judgments across nearby queries;
+- comparison against ripgrep, embeddings, language-server indexes, and System Two browsing;
+- evaluation against gold relevant-file and relevant-range labels;
+- escalation when no candidate survives a stage.
+
+See the [System One Progressive Action Spaces topic](../../docs/topics/system-one-progressive-action-space/README.md) for the shared model behind this demo and the Kubernetes command generator.
diff --git a/research/code-locator/docs/design.md b/research/code-locator/docs/design.md
new file mode 100644
index 00000000..a55f9eac
--- /dev/null
+++ b/research/code-locator/docs/design.md
@@ -0,0 +1,255 @@
+# Hierarchical Code Localization with System One
+
+> Research note for the System One Progressive Action Spaces topic.
+
+## Question
+
+Can a fast System One model locate task-relevant source code without running an open-ended ReAct browsing loop?
+
+The concrete example is:
+
+> Help me optimize the websocket connection implementation.
+
+The experiment treats repository exploration as progressive state disclosure. The harness deterministically exposes the next bounded candidate set; System One only estimates semantic relevance inside that set.
+
+## Working model
+
+```text
+Goal
+  +
+Observed repository structure
+  |
+  v
+Harness expands state
+  |
+  v
+Finite candidate set
+  |
+  v
+System One relevance judgment
+  |
+  v
+Harness prunes and expands again
+```
+
+For the initial prototype:
+
+```text
+repository
+  -> directories
+  -> files
+  -> source lines
+  -> merged code ranges
+```
+
+This is the same underlying shape as the Kubernetes experiment:
+
+```text
+Kubernetes:
+cluster -> namespaces -> pods -> containers -> grounded command
+
+Code localization:
+repository -> directories -> files -> lines -> grounded snippets
+```
+
+The domain adapter changes; the harness pattern does not.
+
+## System One is a semantic filter, not the navigator
+
+A ReAct implementation could repeatedly ask a model to decide which directory to list, which file to open, and which command to run. That gives the model control of both semantic judgment and exploration mechanics.
+
+The prototype separates those responsibilities:
+
+```text
+Harness
+  - enumerate candidates
+  - read files
+  - split content
+  - preserve provenance
+  - apply thresholds
+  - batch requests
+  - merge final ranges
+  - record evidence
+
+System One
+  - estimate whether each exposed candidate is relevant to the goal
+```
+
+This keeps deterministic operations outside the model and makes each model call independently inspectable.
+
+## Why independent probabilities matter
+
+Unlike action selection, localization is not a single-winner problem. A websocket change may involve a connection manager, hook, protocol type, retry policy, and tests at the same time.
+
+The experiment therefore uses one Noul question per candidate. Each candidate gets an independent relevance probability and the harness retains all candidates above the current threshold.
+
+This also makes threshold behavior explicit and measurable.
+
+## Threshold schedule and recall risk
+
+The initial schedule is deliberately recall-biased at the top and precision-biased near source content:
+
+```text
+directory >= 0.35
+file      >= 0.50
+line      >= 0.70
+```
+
+The exact values are experimental.
+
+A false positive at the directory stage only creates more downstream work. A false negative at the directory stage can permanently hide every relevant file below it. Therefore early-stage threshold calibration is a first-class runtime concern, not merely a model-tuning detail.
+
+A likely next design is:
+
+```text
+retain(all candidates >= threshold)
++
+retain(top_k minimum beam)
+```
+
+That would bound catastrophic early pruning while still reducing the search space.
+
+## Progressive disclosure is also a cost policy
+
+The model does not receive source code until a file survives earlier stages:
+
+```text
+directory stage
+  path + direct child names
+
+file stage
+  path + filename + extension + size
+
+line stage
+  line + small neighboring context
+```
+
+This means context volume grows only for candidates that survive previous semantic gates.
+
+The key hypothesis is not merely that System One is fast. It is that the harness can spend semantic judgment only where the current state justifies further disclosure.
+
+## Result provenance
+
+The final answer is not a bag of strings. It retains the path from coarse state to source evidence:
+
+```text
+RelevantDirectory
+  -> RelevantFile
+      -> RelevantLine
+          -> CodeSnippet(path, line range, score, content)
+```
+
+That provenance is required for later evaluation, explainability, cache design, and any System Two handoff.
+
+## Research hypotheses
+
+### H6: Progressive semantic pruning can replace agent-driven browsing for localization
+
+For tasks whose relevant code can be found through repository structure and local semantic evidence, repeated expand -> score -> prune transitions may locate useful source ranges without free-form planning.
+
+### H7: Early high recall matters more than uniform precision
+
+A stage-specific threshold schedule should outperform one global threshold because false-negative cost is asymmetric across the search tree.
+
+### H8: Harness-controlled disclosure reduces unnecessary context
+
+Reading source only after structural candidates survive should reduce model input compared with broad repository ingestion while retaining enough semantic signal to localize the implementation.
+
+### H9: The same runtime abstraction can support action selection and relevance filtering
+
+Kubernetes uses a grounded `Choice` frontier. Code localization uses independent `Noul` judgments. Both can share:
+
+```text
+StateSpaceGenerator
+  -> CandidateSet
+  -> DecisionPrimitive
+  -> TransitionPolicy
+  -> EvidenceRecorder
+```
+
+The important abstraction may therefore be broader than a state machine with a single decision type.
+
+## Evidence contract
+
+Every Code Locator run should preserve enough data to replay the localization surface without relying on GitHub Actions console retention.
+
+The dedicated Code Locator artifact contains only this experiment:
+
+```text
+run-manifest.json
+tests.log          # offline job
+run.log
+result.json
+trace.jsonl
+summary.md
+```
+
+The manifest records harness revision, subject repository and revision, workflow run identity, query, thresholds, batch size, and model.
+
+The JSONL trace records candidate disclosure, model requests, score responses, threshold decisions, latency, token usage, and final results. Authorization data is never recorded.
+
+Kubernetes evidence is intentionally excluded and is owned by the separate `system-one-k8s-experiment` workflow.
+
+## Workflow experiment design
+
+The dedicated [System One Code Locator workflow](../../../.github/workflows/system-one-code-locator.yml) has two roles.
+
+First, deterministic fixture validation runs only when the Code Locator implementation, its research notes, or its workflow changes.
+
+Second, a manual TypeSafe job runs the real System One model against a checked-out subject repository such as `BestNathan/nession`.
+
+The subject repository, ref, query, thresholds, batch size, and model are workflow inputs so repeated runs can vary one parameter while preserving the rest in the manifest.
+
+Artifacts are retained for 90 days. Each run should be treated as raw Code Locator research evidence, not as proof that the hypotheses are already true.
+
+## Metrics available immediately
+
+Without gold labels, the workflow can already measure operational behavior:
+
+- candidates exposed and retained at each stage;
+- pruning ratio by stage;
+- total model calls;
+- TypeSafe input/output tokens;
+- end-to-end elapsed time;
+- selected directories/files/source ranges;
+- stability across repeated runs and threshold settings.
+
+## Metrics requiring a benchmark dataset
+
+Claims about localization quality require pre-registered expected evidence, for example:
+
+```text
+query
+expected relevant files
+expected relevant line ranges or symbols
+allowed supporting files
+```
+
+That enables:
+
+- relevant-file recall;
+- relevant-file precision;
+- range recall / overlap;
+- false-prune stage attribution;
+- cost per successfully localized task;
+- comparison with ripgrep, embedding retrieval, LSP/index retrieval, and System Two browsing.
+
+## Next experiments
+
+1. Build a small gold dataset from real Nession changes and issue/PR history.
+2. Compare threshold-only pruning with threshold + minimum beam retention.
+3. Compare whole-tree directory scoring with recursively expanded directory frontiers.
+4. Replace line candidates with syntax-aware symbols or blocks while retaining line provenance.
+5. Add cache keys based on repository revision, goal, stage, and candidate content hash.
+6. Compare System One localization against a System Two coding agent under the same gold tasks and evidence contract.
+7. Test a System One -> System Two handoff where the fast locator supplies grounded code context to the reasoning model.
+
+## Pilot evidence
+
+- [Nession WebSocket localization pilot — 2026-09-23](pilots/nession-websocket-2026-09-23.md)
+
+The first real run confirmed useful semantic localization, while also showing that threshold-only whole-tree search spends most of its cost at the line layer. This is the baseline for the next recursive-beam / symbol-level experiment.
+
+## Reference implementation
+
+See the [Code Locator research root](../README.md).
diff --git a/research/code-locator/docs/pilots/nession-websocket-2026-09-23.md b/research/code-locator/docs/pilots/nession-websocket-2026-09-23.md
new file mode 100644
index 00000000..a6c6a1e1
--- /dev/null
+++ b/research/code-locator/docs/pilots/nession-websocket-2026-09-23.md
@@ -0,0 +1,195 @@
+# Pilot Run: Nession WebSocket Localization
+
+> Date: 2026-09-23  
+> Workflow run: 35817921653  
+> Subject: `BestNathan/nession@f6a08b41c946574cc14343c4c3bb808bc402e49f`  
+> Model: `jev-latest`
+
+## Query
+
+> Help me optimize the websocket connection implementation
+
+## Parameters
+
+```text
+directory threshold = 0.35
+file threshold      = 0.50
+line threshold      = 0.70
+batch size          = 48
+```
+
+## Outcome
+
+The real System One workflow completed successfully and produced a full research artifact.
+
+The highest-scoring files were strongly aligned with the requested implementation:
+
+| Score | File |
+|---:|---|
+| 0.93 | `crates/nession-server/src/server/websocket.rs` |
+| 0.92 | `crates/nession-agent/src/server/websocket.rs` |
+| 0.91 | `web/src/platform/socket/WebSocketService.ts` |
+| 0.88 | `web/src/shared/hooks/useWebSocket.ts` |
+| 0.86 | `crates/nession-cli/src/client/connection.rs` |
+| 0.86 | `web/src/app/useAppConnection.ts` |
+| 0.86 | `web/src/platform/terminal-runtime/ConnectionManager.ts` |
+| 0.84 | `web/src/platform/attach/relayServerConnection.ts` |
+
+The top snippets also landed on concrete WebSocket lifecycle behavior, including:
+
+- server-side ping/heartbeat handling;
+- WebSocket accept/split and connection setup;
+- reconnect and visibility-reconnect behavior;
+- client/agent WebSocket message loops;
+- connection-management code.
+
+This is evidence that repeated System One relevance judgments can recover semantically useful implementation surfaces without a ReAct browsing loop.
+
+## Cost and search-space behavior
+
+The same run also exposed a major weakness in the first prototype:
+
+```text
+directories exposed  = 382
+directories selected = 88
+
+files exposed         = 1040
+files selected        = 92
+
+lines exposed         = 25,189
+lines selected        = 1,308
+
+snippets              = 370
+
+model calls           = 601
+  directory            = 8
+  file                 = 22
+  line                 = 571
+
+input tokens          = 5,808,879
+  directory            = 67,063
+  file                 = 165,449
+  line                 = 5,576,367
+output tokens         = 502,109
+elapsed               = 125.7 s
+```
+
+The result quality was promising, but the search policy was too permissive. Line expansion alone accounted for 571 of 601 model calls and about 96% of input tokens.
+
+The main problem is not System One latency itself. The harness exposes too much state before applying a sufficiently strong budget.
+
+In particular:
+
+1. the prototype enumerates the whole directory tree before semantic pruning;
+2. a low directory threshold retains many overlapping parent/child directories;
+3. file discovery under those directories exposes a very large union of files;
+4. every retained file is then expanded into line candidates.
+
+This creates multiplicative fan-out:
+
+```text
+weak early pruning
+  -> many directories
+  -> many files
+  -> many lines
+  -> many System One questions
+```
+
+The pilot therefore supports the original hypothesis that early-stage recall matters, but also shows that threshold-only retention is not enough.
+
+## Transport-boundary finding
+
+An earlier attempt reached a Cloudflare 403 while scoring source lines.
+
+The blocked batch contained security-test code such as a path-traversal fixture:
+
+```text
+../etc/passwd
+```
+
+The API key and endpoint were valid: the Kubernetes System One experiment completed successfully in the same job.
+
+The fix was to separate **raw evidence** from the **model transport projection**:
+
+```text
+raw source candidate
+  -> preserved in local trace
+
+model projection
+  -> normalize string literal values
+  -> preserve identifiers / types / control flow
+  -> send to System One
+```
+
+This allowed the real code-localization run to complete while keeping the original source in the research artifact.
+
+This suggests a broader harness principle:
+
+> External model transport is itself an execution boundary. The runtime may need a safe semantic projection of observed state instead of blindly forwarding raw environment bytes.
+
+## Updated working hypothesis
+
+The pilot suggests that the next version should move from threshold-only breadth-first filtering toward a bounded semantic search policy.
+
+A stronger policy is:
+
+```text
+current frontier
+  -> System One score
+  -> retain above threshold
+  -> guarantee a minimum beam
+  -> enforce a maximum expansion budget
+  -> expand only retained states
+```
+
+For repository localization, the likely next hierarchy is:
+
+```text
+root
+  -> immediate child directories
+  -> recursively selected directories
+  -> files
+  -> symbols / blocks
+  -> lines
+```
+
+This is preferable to globally enumerating every directory before the first judgment.
+
+## Next experiment
+
+The next comparison should hold the query and subject revision constant and compare:
+
+### Baseline A — current prototype
+
+```text
+whole-tree directories
+-> threshold
+-> files
+-> threshold
+-> lines
+```
+
+### Candidate B — recursive semantic beam
+
+```text
+root children
+-> score
+-> threshold + top-k
+-> expand selected children
+-> repeat
+-> files
+-> symbols
+-> lines
+```
+
+Measure:
+
+- relevant-file recall;
+- model calls;
+- input/output tokens;
+- elapsed time;
+- candidates exposed at each level;
+- stage where any expected file is first pruned;
+- final snippet quality.
+
+The goal is not merely to make the current search cheaper. It is to test whether **progressive state disclosure plus a bounded semantic frontier** is the right primitive for System One code navigation.
diff --git a/research/code-locator/fixtures/repository/server/src/http.ts b/research/code-locator/fixtures/repository/server/src/http.ts
new file mode 100644
index 00000000..33d14544
--- /dev/null
+++ b/research/code-locator/fixtures/repository/server/src/http.ts
@@ -0,0 +1,3 @@
+export function startHttpServer() {
+  console.log('http server started');
+}
diff --git a/research/code-locator/fixtures/repository/web/src/api/user.ts b/research/code-locator/fixtures/repository/web/src/api/user.ts
new file mode 100644
index 00000000..97dff825
--- /dev/null
+++ b/research/code-locator/fixtures/repository/web/src/api/user.ts
@@ -0,0 +1,4 @@
+export async function loadUser(id: string) {
+  const response = await fetch(`/api/users/${id}`);
+  return response.json();
+}
diff --git a/research/code-locator/fixtures/repository/web/src/ws/client.ts b/research/code-locator/fixtures/repository/web/src/ws/client.ts
new file mode 100644
index 00000000..ee60f8fa
--- /dev/null
+++ b/research/code-locator/fixtures/repository/web/src/ws/client.ts
@@ -0,0 +1,19 @@
+export class WebSocketClient {
+  private socket?: WebSocket;
+  private reconnectTimer?: ReturnType<typeof setTimeout>;
+
+  connect(url: string) {
+    this.socket = new WebSocket(url);
+    this.socket.onopen = () => this.clearReconnect();
+    this.socket.onclose = () => this.scheduleReconnect(url);
+    this.socket.onerror = () => this.socket?.close();
+  }
+
+  private scheduleReconnect(url: string) {
+    this.reconnectTimer = setTimeout(() => this.connect(url), 1000);
+  }
+
+  private clearReconnect() {
+    if (this.reconnectTimer) clearTimeout(this.reconnectTimer);
+  }
+}
diff --git a/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/README.md b/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/README.md
new file mode 100644
index 00000000..0b0be0a1
--- /dev/null
+++ b/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/README.md
@@ -0,0 +1,18 @@
+# System One Code Locator experiment
+
+- Recorded at: `20260923T124028+0800` (UTC+8)
+- GitHub run: [35819260887](https://github.com/BestNathan/narness-engineering/actions/runs/35819260887)
+- Run attempt: `1`
+- Event: `push`
+- Repository: `BestNathan/narness-engineering`
+- Ref: `research/system-one-code-localization`
+- Trigger SHA: `805e169a08f0eb524d312842288458d074ecf61f`
+- Offline job: `success`
+- TypeSafe job: `skipped`
+
+## Evidence
+
+- [Offline evidence](offline/) when the offline validation produced an artifact.
+- [TypeSafe evidence](typesafe/) when a real TypeSafe experiment was requested.
+
+The files in this directory are an immutable snapshot of the evidence produced by this workflow run.
diff --git a/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/offline/result.json b/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/offline/result.json
new file mode 100644
index 00000000..bf1a55c4
--- /dev/null
+++ b/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/offline/result.json
@@ -0,0 +1,139 @@
+{
+  "query": "Help me optimize the websocket connection implementation",
+  "root": "/home/runner/work/narness-engineering/narness-engineering/examples/system-one-code-locator/fixtures/repository",
+  "model": "offline-lexical-fixture",
+  "thresholds": {
+    "directory": 0.35,
+    "file": 0.5,
+    "line": 0.6
+  },
+  "directories": [
+    {
+      "id": "web/src",
+      "payload": {
+        "path": "web/src",
+        "name": "src",
+        "child_directories": [
+          "api",
+          "ws"
+        ],
+        "direct_files": []
+      },
+      "score": 0.84
+    },
+    {
+      "id": "web/src/ws",
+      "payload": {
+        "path": "web/src/ws",
+        "name": "ws",
+        "child_directories": [],
+        "direct_files": [
+          "client.ts"
+        ]
+      },
+      "score": 0.84
+    },
+    {
+      "id": "server",
+      "payload": {
+        "path": "server",
+        "name": "server",
+        "child_directories": [
+          "src"
+        ],
+        "direct_files": []
+      },
+      "score": 0.62
+    },
+    {
+      "id": "server/src",
+      "payload": {
+        "path": "server/src",
+        "name": "src",
+        "child_directories": [],
+        "direct_files": [
+          "http.ts"
+        ]
+      },
+      "score": 0.62
+    },
+    {
+      "id": "web",
+      "payload": {
+        "path": "web",
+        "name": "web",
+        "child_directories": [
+          "src"
+        ],
+        "direct_files": []
+      },
+      "score": 0.62
+    },
+    {
+      "id": "web/src/api",
+      "payload": {
+        "path": "web/src/api",
+        "name": "api",
+        "child_directories": [],
+        "direct_files": [
+          "user.ts"
+        ]
+      },
+      "score": 0.62
+    }
+  ],
+  "files": [
+    {
+      "id": "web/src/ws/client.ts",
+      "payload": {
+        "path": "web/src/ws/client.ts",
+        "filename": "client.ts",
+        "extension": ".ts",
+        "size_bytes": 573
+      },
+      "score": 0.84
+    },
+    {
+      "id": "server/src/http.ts",
+      "payload": {
+        "path": "server/src/http.ts",
+        "filename": "http.ts",
+        "extension": ".ts",
+        "size_bytes": 76
+      },
+      "score": 0.62
+    },
+    {
+      "id": "web/src/api/user.ts",
+      "payload": {
+        "path": "web/src/api/user.ts",
+        "filename": "user.ts",
+        "extension": ".ts",
+        "size_bytes": 125
+      },
+      "score": 0.62
+    }
+  ],
+  "snippets": [
+    {
+      "path": "web/src/ws/client.ts",
+      "start_line": 1,
+      "end_line": 19,
+      "score": 0.96,
+      "content": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }"
+    }
+  ],
+  "metrics": {
+    "model_calls": 0,
+    "input_tokens": 0,
+    "output_tokens": 0,
+    "directories_exposed": 6,
+    "directories_selected": 6,
+    "files_exposed": 3,
+    "files_selected": 3,
+    "lines_exposed": 23,
+    "lines_selected": 16,
+    "snippets": 1,
+    "elapsed_ms": 1.884
+  }
+}
diff --git a/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/offline/run-manifest.json b/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/offline/run-manifest.json
new file mode 100644
index 00000000..8cb5ed15
--- /dev/null
+++ b/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/offline/run-manifest.json
@@ -0,0 +1,16 @@
+{
+  "schema_version": 1,
+  "mode": "offline",
+  "query": "Help me optimize the websocket connection implementation",
+  "model": "offline-lexical-fixture",
+  "thresholds": {
+    "directory": 0.35,
+    "file": 0.5,
+    "line": 0.6
+  },
+  "batch_size": 48,
+  "github_run_id": "35819260887",
+  "github_run_attempt": "1",
+  "commit_sha": "805e169a08f0eb524d312842288458d074ecf61f",
+  "ref_name": "research/system-one-code-localization"
+}
diff --git a/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/offline/run.log b/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/offline/run.log
new file mode 100644
index 00000000..87fd7c7f
--- /dev/null
+++ b/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/offline/run.log
@@ -0,0 +1,33 @@
+relevant directories:
+  0.840 web/src
+  0.840 web/src/ws
+  0.620 server
+  0.620 server/src
+  0.620 web
+  0.620 web/src/api
+relevant files:
+  0.840 web/src/ws/client.ts
+  0.620 server/src/http.ts
+  0.620 web/src/api/user.ts
+relevant snippets:
+  0.960 web/src/ws/client.ts:1-19
+1: export class WebSocketClient {
+2:   private socket?: WebSocket;
+3:   private reconnectTimer?: ReturnType<typeof setTimeout>;
+4: 
+5:   connect(url: string) {
+6:     this.socket = new WebSocket(url);
+7:     this.socket.onopen = () => this.clearReconnect();
+8:     this.socket.onclose = () => this.scheduleReconnect(url);
+9:     this.socket.onerror = () => this.socket?.close();
+10:   }
+11: 
+12:   private scheduleReconnect(url: string) {
+13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);
+14:   }
+15: 
+16:   private clearReconnect() {
+17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);
+18:   }
+19: }
+metrics: {"model_calls": 0, "input_tokens": 0, "output_tokens": 0, "directories_exposed": 6, "directories_selected": 6, "files_exposed": 3, "files_selected": 3, "lines_exposed": 23, "lines_selected": 16, "snippets": 1, "elapsed_ms": 1.884}
diff --git a/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/offline/summary.md b/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/offline/summary.md
new file mode 100644
index 00000000..2909f769
--- /dev/null
+++ b/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/offline/summary.md
@@ -0,0 +1,7 @@
+# System One Code Locator — offline fixture
+
+- Query: `Help me optimize the websocket connection implementation`
+- Directories: 6
+- Files: 3
+- Snippets: 1
+- Metrics: `{'model_calls': 0, 'input_tokens': 0, 'output_tokens': 0, 'directories_exposed': 6, 'directories_selected': 6, 'files_exposed': 3, 'files_selected': 3, 'lines_exposed': 23, 'lines_selected': 16, 'snippets': 1, 'elapsed_ms': 1.884}`
diff --git a/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/offline/tests.log b/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/offline/tests.log
new file mode 100644
index 00000000..e7b5dbe7
--- /dev/null
+++ b/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/offline/tests.log
@@ -0,0 +1,7 @@
+test_progressive_localization (test_system_one_code_locator.DemoTest.test_progressive_localization) ... ok
+test_request_uses_noul (test_system_one_code_locator.DemoTest.test_request_uses_noul) ... ok
+
+----------------------------------------------------------------------
+Ran 2 tests in 0.010s
+
+OK
diff --git a/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/offline/trace.jsonl b/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/offline/trace.jsonl
new file mode 100644
index 00000000..ebf28b06
--- /dev/null
+++ b/research/code-locator/runs/20260923T124028+0800-run-35819260887-attempt-1/offline/trace.jsonl
@@ -0,0 +1,17 @@
+{"event": "search_started", "model": "offline-lexical-fixture", "query": "Help me optimize the websocket connection implementation", "root": "/home/runner/work/narness-engineering/narness-engineering/examples/system-one-code-locator/fixtures/repository", "thresholds": {"directory": 0.35, "file": 0.5, "line": 0.6}, "timestamp": "2026-09-23T04:40:17.600455+00:00"}
+{"candidates": [{"id": "server", "payload": {"child_directories": ["src"], "direct_files": [], "name": "server", "path": "server"}}, {"id": "server/src", "payload": {"child_directories": [], "direct_files": ["http.ts"], "name": "src", "path": "server/src"}}, {"id": "web", "payload": {"child_directories": ["src"], "direct_files": [], "name": "web", "path": "web"}}, {"id": "web/src", "payload": {"child_directories": ["api", "ws"], "direct_files": [], "name": "src", "path": "web/src"}}, {"id": "web/src/api", "payload": {"child_directories": [], "direct_files": ["user.ts"], "name": "api", "path": "web/src/api"}}, {"id": "web/src/ws", "payload": {"child_directories": [], "direct_files": ["client.ts"], "name": "ws", "path": "web/src/ws"}}], "count": 6, "event": "candidates_exposed", "stage": "directory", "timestamp": "2026-09-23T04:40:17.600785+00:00"}
+{"event": "offline_scores", "scores": [{"id": "web/src", "score": 0.84}, {"id": "web/src/ws", "score": 0.84}, {"id": "server", "score": 0.62}, {"id": "server/src", "score": 0.62}, {"id": "web", "score": 0.62}, {"id": "web/src/api", "score": 0.62}], "stage": "directory", "timestamp": "2026-09-23T04:40:17.600939+00:00"}
+{"event": "threshold_applied", "input_count": 6, "selected": [{"id": "web/src", "payload": {"child_directories": ["api", "ws"], "direct_files": [], "name": "src", "path": "web/src"}, "score": 0.84}, {"id": "web/src/ws", "payload": {"child_directories": [], "direct_files": ["client.ts"], "name": "ws", "path": "web/src/ws"}, "score": 0.84}, {"id": "server", "payload": {"child_directories": ["src"], "direct_files": [], "name": "server", "path": "server"}, "score": 0.62}, {"id": "server/src", "payload": {"child_directories": [], "direct_files": ["http.ts"], "name": "src", "path": "server/src"}, "score": 0.62}, {"id": "web", "payload": {"child_directories": ["src"], "direct_files": [], "name": "web", "path": "web"}, "score": 0.62}, {"id": "web/src/api", "payload": {"child_directories": [], "direct_files": ["user.ts"], "name": "api", "path": "web/src/api"}, "score": 0.62}], "selected_count": 6, "stage": "directory", "threshold": 0.35, "timestamp": "2026-09-23T04:40:17.600975+00:00"}
+{"candidates": [{"id": "server/src/http.ts", "payload": {"extension": ".ts", "filename": "http.ts", "path": "server/src/http.ts", "size_bytes": 76}}, {"id": "web/src/api/user.ts", "payload": {"extension": ".ts", "filename": "user.ts", "path": "web/src/api/user.ts", "size_bytes": 125}}, {"id": "web/src/ws/client.ts", "payload": {"extension": ".ts", "filename": "client.ts", "path": "web/src/ws/client.ts", "size_bytes": 573}}], "count": 3, "event": "candidates_exposed", "stage": "file", "timestamp": "2026-09-23T04:40:17.601441+00:00"}
+{"event": "offline_scores", "scores": [{"id": "web/src/ws/client.ts", "score": 0.84}, {"id": "server/src/http.ts", "score": 0.62}, {"id": "web/src/api/user.ts", "score": 0.62}], "stage": "file", "timestamp": "2026-09-23T04:40:17.601499+00:00"}
+{"event": "threshold_applied", "input_count": 3, "selected": [{"id": "web/src/ws/client.ts", "payload": {"extension": ".ts", "filename": "client.ts", "path": "web/src/ws/client.ts", "size_bytes": 573}, "score": 0.84}, {"id": "server/src/http.ts", "payload": {"extension": ".ts", "filename": "http.ts", "path": "server/src/http.ts", "size_bytes": 76}, "score": 0.62}, {"id": "web/src/api/user.ts", "payload": {"extension": ".ts", "filename": "user.ts", "path": "web/src/api/user.ts", "size_bytes": 125}, "score": 0.62}], "selected_count": 3, "stage": "file", "threshold": 0.5, "timestamp": "2026-09-23T04:40:17.601523+00:00"}
+{"candidates": [{"id": "web/src/ws/client.ts:1", "payload": {"line": 1, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;", "path": "web/src/ws/client.ts", "text": "export class WebSocketClient {"}}, {"id": "web/src/ws/client.ts:2", "payload": {"line": 2, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: ", "path": "web/src/ws/client.ts", "text": "  private socket?: WebSocket;"}}, {"id": "web/src/ws/client.ts:3", "payload": {"line": 3, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {", "path": "web/src/ws/client.ts", "text": "  private reconnectTimer?: ReturnType<typeof setTimeout>;"}}, {"id": "web/src/ws/client.ts:5", "payload": {"line": 5, "nearby_lines": "3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();", "path": "web/src/ws/client.ts", "text": "  connect(url: string) {"}}, {"id": "web/src/ws/client.ts:6", "payload": {"line": 6, "nearby_lines": "4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);", "path": "web/src/ws/client.ts", "text": "    this.socket = new WebSocket(url);"}}, {"id": "web/src/ws/client.ts:7", "payload": {"line": 7, "nearby_lines": "5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();", "path": "web/src/ws/client.ts", "text": "    this.socket.onopen = () => this.clearReconnect();"}}, {"id": "web/src/ws/client.ts:8", "payload": {"line": 8, "nearby_lines": "6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }", "path": "web/src/ws/client.ts", "text": "    this.socket.onclose = () => this.scheduleReconnect(url);"}}, {"id": "web/src/ws/client.ts:9", "payload": {"line": 9, "nearby_lines": "7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: ", "path": "web/src/ws/client.ts", "text": "    this.socket.onerror = () => this.socket?.close();"}}, {"id": "web/src/ws/client.ts:10", "payload": {"line": 10, "nearby_lines": "8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: \n12:   private scheduleReconnect(url: string) {", "path": "web/src/ws/client.ts", "text": "  }"}}, {"id": "web/src/ws/client.ts:12", "payload": {"line": 12, "nearby_lines": "10:   }\n11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }", "path": "web/src/ws/client.ts", "text": "  private scheduleReconnect(url: string) {"}}, {"id": "web/src/ws/client.ts:13", "payload": {"line": 13, "nearby_lines": "11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: ", "path": "web/src/ws/client.ts", "text": "    this.reconnectTimer = setTimeout(() => this.connect(url), 1000);"}}, {"id": "web/src/ws/client.ts:14", "payload": {"line": 14, "nearby_lines": "12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: \n16:   private clearReconnect() {", "path": "web/src/ws/client.ts", "text": "  }"}}, {"id": "web/src/ws/client.ts:16", "payload": {"line": 16, "nearby_lines": "14:   }\n15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }", "path": "web/src/ws/client.ts", "text": "  private clearReconnect() {"}}, {"id": "web/src/ws/client.ts:17", "payload": {"line": 17, "nearby_lines": "15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "    if (this.reconnectTimer) clearTimeout(this.reconnectTimer);"}}, {"id": "web/src/ws/client.ts:18", "payload": {"line": 18, "nearby_lines": "16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "  }"}}, {"id": "web/src/ws/client.ts:19", "payload": {"line": 19, "nearby_lines": "17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "}"}}], "count": 16, "event": "candidates_exposed", "parent": "web/src/ws/client.ts", "stage": "line", "timestamp": "2026-09-23T04:40:17.601639+00:00"}
+{"event": "offline_scores", "scores": [{"id": "web/src/ws/client.ts:1", "score": 0.96}, {"id": "web/src/ws/client.ts:10", "score": 0.96}, {"id": "web/src/ws/client.ts:12", "score": 0.96}, {"id": "web/src/ws/client.ts:13", "score": 0.96}, {"id": "web/src/ws/client.ts:14", "score": 0.96}, {"id": "web/src/ws/client.ts:16", "score": 0.96}, {"id": "web/src/ws/client.ts:17", "score": 0.96}, {"id": "web/src/ws/client.ts:18", "score": 0.96}, {"id": "web/src/ws/client.ts:19", "score": 0.96}, {"id": "web/src/ws/client.ts:2", "score": 0.96}, {"id": "web/src/ws/client.ts:3", "score": 0.96}, {"id": "web/src/ws/client.ts:5", "score": 0.96}, {"id": "web/src/ws/client.ts:6", "score": 0.96}, {"id": "web/src/ws/client.ts:7", "score": 0.96}, {"id": "web/src/ws/client.ts:8", "score": 0.96}, {"id": "web/src/ws/client.ts:9", "score": 0.96}], "stage": "line", "timestamp": "2026-09-23T04:40:17.601809+00:00"}
+{"event": "threshold_applied", "input_count": 16, "parent": "web/src/ws/client.ts", "selected": [{"id": "web/src/ws/client.ts:1", "payload": {"line": 1, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;", "path": "web/src/ws/client.ts", "text": "export class WebSocketClient {"}, "score": 0.96}, {"id": "web/src/ws/client.ts:10", "payload": {"line": 10, "nearby_lines": "8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: \n12:   private scheduleReconnect(url: string) {", "path": "web/src/ws/client.ts", "text": "  }"}, "score": 0.96}, {"id": "web/src/ws/client.ts:12", "payload": {"line": 12, "nearby_lines": "10:   }\n11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }", "path": "web/src/ws/client.ts", "text": "  private scheduleReconnect(url: string) {"}, "score": 0.96}, {"id": "web/src/ws/client.ts:13", "payload": {"line": 13, "nearby_lines": "11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: ", "path": "web/src/ws/client.ts", "text": "    this.reconnectTimer = setTimeout(() => this.connect(url), 1000);"}, "score": 0.96}, {"id": "web/src/ws/client.ts:14", "payload": {"line": 14, "nearby_lines": "12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: \n16:   private clearReconnect() {", "path": "web/src/ws/client.ts", "text": "  }"}, "score": 0.96}, {"id": "web/src/ws/client.ts:16", "payload": {"line": 16, "nearby_lines": "14:   }\n15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }", "path": "web/src/ws/client.ts", "text": "  private clearReconnect() {"}, "score": 0.96}, {"id": "web/src/ws/client.ts:17", "payload": {"line": 17, "nearby_lines": "15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "    if (this.reconnectTimer) clearTimeout(this.reconnectTimer);"}, "score": 0.96}, {"id": "web/src/ws/client.ts:18", "payload": {"line": 18, "nearby_lines": "16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "  }"}, "score": 0.96}, {"id": "web/src/ws/client.ts:19", "payload": {"line": 19, "nearby_lines": "17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "}"}, "score": 0.96}, {"id": "web/src/ws/client.ts:2", "payload": {"line": 2, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: ", "path": "web/src/ws/client.ts", "text": "  private socket?: WebSocket;"}, "score": 0.96}, {"id": "web/src/ws/client.ts:3", "payload": {"line": 3, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {", "path": "web/src/ws/client.ts", "text": "  private reconnectTimer?: ReturnType<typeof setTimeout>;"}, "score": 0.96}, {"id": "web/src/ws/client.ts:5", "payload": {"line": 5, "nearby_lines": "3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();", "path": "web/src/ws/client.ts", "text": "  connect(url: string) {"}, "score": 0.96}, {"id": "web/src/ws/client.ts:6", "payload": {"line": 6, "nearby_lines": "4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);", "path": "web/src/ws/client.ts", "text": "    this.socket = new WebSocket(url);"}, "score": 0.96}, {"id": "web/src/ws/client.ts:7", "payload": {"line": 7, "nearby_lines": "5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();", "path": "web/src/ws/client.ts", "text": "    this.socket.onopen = () => this.clearReconnect();"}, "score": 0.96}, {"id": "web/src/ws/client.ts:8", "payload": {"line": 8, "nearby_lines": "6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }", "path": "web/src/ws/client.ts", "text": "    this.socket.onclose = () => this.scheduleReconnect(url);"}, "score": 0.96}, {"id": "web/src/ws/client.ts:9", "payload": {"line": 9, "nearby_lines": "7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: ", "path": "web/src/ws/client.ts", "text": "    this.socket.onerror = () => this.socket?.close();"}, "score": 0.96}], "selected_count": 16, "stage": "line", "threshold": 0.6, "timestamp": "2026-09-23T04:40:17.601842+00:00"}
+{"candidates": [{"id": "server/src/http.ts:1", "payload": {"line": 1, "nearby_lines": "1: export function startHttpServer() {\n2:   console.log('http server started');\n3: }", "path": "server/src/http.ts", "text": "export function startHttpServer() {"}}, {"id": "server/src/http.ts:2", "payload": {"line": 2, "nearby_lines": "1: export function startHttpServer() {\n2:   console.log('http server started');\n3: }", "path": "server/src/http.ts", "text": "  console.log('http server started');"}}, {"id": "server/src/http.ts:3", "payload": {"line": 3, "nearby_lines": "1: export function startHttpServer() {\n2:   console.log('http server started');\n3: }", "path": "server/src/http.ts", "text": "}"}}], "count": 3, "event": "candidates_exposed", "parent": "server/src/http.ts", "stage": "line", "timestamp": "2026-09-23T04:40:17.602025+00:00"}
+{"event": "offline_scores", "scores": [{"id": "server/src/http.ts:1", "score": 0.05}, {"id": "server/src/http.ts:2", "score": 0.05}, {"id": "server/src/http.ts:3", "score": 0.05}], "stage": "line", "timestamp": "2026-09-23T04:40:17.602081+00:00"}
+{"event": "threshold_applied", "input_count": 3, "parent": "server/src/http.ts", "selected": [], "selected_count": 0, "stage": "line", "threshold": 0.6, "timestamp": "2026-09-23T04:40:17.602104+00:00"}
+{"candidates": [{"id": "web/src/api/user.ts:1", "payload": {"line": 1, "nearby_lines": "1: export async function loadUser(id: string) {\n2:   const response = await fetch(`/api/users/${id}`);\n3:   return response.json();", "path": "web/src/api/user.ts", "text": "export async function loadUser(id: string) {"}}, {"id": "web/src/api/user.ts:2", "payload": {"line": 2, "nearby_lines": "1: export async function loadUser(id: string) {\n2:   const response = await fetch(`/api/users/${id}`);\n3:   return response.json();\n4: }", "path": "web/src/api/user.ts", "text": "  const response = await fetch(`/api/users/${id}`);"}}, {"id": "web/src/api/user.ts:3", "payload": {"line": 3, "nearby_lines": "1: export async function loadUser(id: string) {\n2:   const response = await fetch(`/api/users/${id}`);\n3:   return response.json();\n4: }", "path": "web/src/api/user.ts", "text": "  return response.json();"}}, {"id": "web/src/api/user.ts:4", "payload": {"line": 4, "nearby_lines": "2:   const response = await fetch(`/api/users/${id}`);\n3:   return response.json();\n4: }", "path": "web/src/api/user.ts", "text": "}"}}], "count": 4, "event": "candidates_exposed", "parent": "web/src/api/user.ts", "stage": "line", "timestamp": "2026-09-23T04:40:17.602173+00:00"}
+{"event": "offline_scores", "scores": [{"id": "web/src/api/user.ts:1", "score": 0.05}, {"id": "web/src/api/user.ts:2", "score": 0.05}, {"id": "web/src/api/user.ts:3", "score": 0.05}, {"id": "web/src/api/user.ts:4", "score": 0.05}], "stage": "line", "timestamp": "2026-09-23T04:40:17.602230+00:00"}
+{"event": "threshold_applied", "input_count": 4, "parent": "web/src/api/user.ts", "selected": [], "selected_count": 0, "stage": "line", "threshold": 0.6, "timestamp": "2026-09-23T04:40:17.602251+00:00"}
+{"event": "search_completed", "result": {"directories": [{"id": "web/src", "payload": {"child_directories": ["api", "ws"], "direct_files": [], "name": "src", "path": "web/src"}, "score": 0.84}, {"id": "web/src/ws", "payload": {"child_directories": [], "direct_files": ["client.ts"], "name": "ws", "path": "web/src/ws"}, "score": 0.84}, {"id": "server", "payload": {"child_directories": ["src"], "direct_files": [], "name": "server", "path": "server"}, "score": 0.62}, {"id": "server/src", "payload": {"child_directories": [], "direct_files": ["http.ts"], "name": "src", "path": "server/src"}, "score": 0.62}, {"id": "web", "payload": {"child_directories": ["src"], "direct_files": [], "name": "web", "path": "web"}, "score": 0.62}, {"id": "web/src/api", "payload": {"child_directories": [], "direct_files": ["user.ts"], "name": "api", "path": "web/src/api"}, "score": 0.62}], "files": [{"id": "web/src/ws/client.ts", "payload": {"extension": ".ts", "filename": "client.ts", "path": "web/src/ws/client.ts", "size_bytes": 573}, "score": 0.84}, {"id": "server/src/http.ts", "payload": {"extension": ".ts", "filename": "http.ts", "path": "server/src/http.ts", "size_bytes": 76}, "score": 0.62}, {"id": "web/src/api/user.ts", "payload": {"extension": ".ts", "filename": "user.ts", "path": "web/src/api/user.ts", "size_bytes": 125}, "score": 0.62}], "metrics": {"directories_exposed": 6, "directories_selected": 6, "elapsed_ms": 1.884, "files_exposed": 3, "files_selected": 3, "input_tokens": 0, "lines_exposed": 23, "lines_selected": 16, "model_calls": 0, "output_tokens": 0, "snippets": 1}, "model": "offline-lexical-fixture", "query": "Help me optimize the websocket connection implementation", "root": "/home/runner/work/narness-engineering/narness-engineering/examples/system-one-code-locator/fixtures/repository", "snippets": [{"content": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "end_line": 19, "path": "web/src/ws/client.ts", "score": 0.96, "start_line": 1}], "thresholds": {"directory": 0.35, "file": 0.5, "line": 0.6}}, "timestamp": "2026-09-23T04:40:17.602298+00:00"}
diff --git a/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/README.md b/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/README.md
new file mode 100644
index 00000000..8945b881
--- /dev/null
+++ b/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/README.md
@@ -0,0 +1,18 @@
+# System One Code Locator experiment
+
+- Recorded at: `20260923T124223+0800` (UTC+8)
+- GitHub run: [35819390521](https://github.com/BestNathan/narness-engineering/actions/runs/35819390521)
+- Run attempt: `1`
+- Event: `push`
+- Repository: `BestNathan/narness-engineering`
+- Ref: `research/system-one-code-localization`
+- Trigger SHA: `63aee26c65438d3b5a8bcff5e87fdd2f54f4bef1`
+- Offline job: `success`
+- TypeSafe job: `skipped`
+
+## Evidence
+
+- [Offline evidence](offline/) when the offline validation produced an artifact.
+- [TypeSafe evidence](typesafe/) when a real TypeSafe experiment was requested.
+
+The files in this directory are an immutable snapshot of the evidence produced by this workflow run.
diff --git a/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/offline/result.json b/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/offline/result.json
new file mode 100644
index 00000000..be7127d4
--- /dev/null
+++ b/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/offline/result.json
@@ -0,0 +1,139 @@
+{
+  "query": "Help me optimize the websocket connection implementation",
+  "root": "/home/runner/work/narness-engineering/narness-engineering/examples/system-one-code-locator/fixtures/repository",
+  "model": "offline-lexical-fixture",
+  "thresholds": {
+    "directory": 0.35,
+    "file": 0.5,
+    "line": 0.6
+  },
+  "directories": [
+    {
+      "id": "web/src",
+      "payload": {
+        "path": "web/src",
+        "name": "src",
+        "child_directories": [
+          "api",
+          "ws"
+        ],
+        "direct_files": []
+      },
+      "score": 0.84
+    },
+    {
+      "id": "web/src/ws",
+      "payload": {
+        "path": "web/src/ws",
+        "name": "ws",
+        "child_directories": [],
+        "direct_files": [
+          "client.ts"
+        ]
+      },
+      "score": 0.84
+    },
+    {
+      "id": "server",
+      "payload": {
+        "path": "server",
+        "name": "server",
+        "child_directories": [
+          "src"
+        ],
+        "direct_files": []
+      },
+      "score": 0.62
+    },
+    {
+      "id": "server/src",
+      "payload": {
+        "path": "server/src",
+        "name": "src",
+        "child_directories": [],
+        "direct_files": [
+          "http.ts"
+        ]
+      },
+      "score": 0.62
+    },
+    {
+      "id": "web",
+      "payload": {
+        "path": "web",
+        "name": "web",
+        "child_directories": [
+          "src"
+        ],
+        "direct_files": []
+      },
+      "score": 0.62
+    },
+    {
+      "id": "web/src/api",
+      "payload": {
+        "path": "web/src/api",
+        "name": "api",
+        "child_directories": [],
+        "direct_files": [
+          "user.ts"
+        ]
+      },
+      "score": 0.62
+    }
+  ],
+  "files": [
+    {
+      "id": "web/src/ws/client.ts",
+      "payload": {
+        "path": "web/src/ws/client.ts",
+        "filename": "client.ts",
+        "extension": ".ts",
+        "size_bytes": 573
+      },
+      "score": 0.84
+    },
+    {
+      "id": "server/src/http.ts",
+      "payload": {
+        "path": "server/src/http.ts",
+        "filename": "http.ts",
+        "extension": ".ts",
+        "size_bytes": 76
+      },
+      "score": 0.62
+    },
+    {
+      "id": "web/src/api/user.ts",
+      "payload": {
+        "path": "web/src/api/user.ts",
+        "filename": "user.ts",
+        "extension": ".ts",
+        "size_bytes": 125
+      },
+      "score": 0.62
+    }
+  ],
+  "snippets": [
+    {
+      "path": "web/src/ws/client.ts",
+      "start_line": 1,
+      "end_line": 19,
+      "score": 0.96,
+      "content": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }"
+    }
+  ],
+  "metrics": {
+    "model_calls": 0,
+    "input_tokens": 0,
+    "output_tokens": 0,
+    "directories_exposed": 6,
+    "directories_selected": 6,
+    "files_exposed": 3,
+    "files_selected": 3,
+    "lines_exposed": 23,
+    "lines_selected": 16,
+    "snippets": 1,
+    "elapsed_ms": 3.504
+  }
+}
diff --git a/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/offline/run-manifest.json b/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/offline/run-manifest.json
new file mode 100644
index 00000000..d8dd43f3
--- /dev/null
+++ b/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/offline/run-manifest.json
@@ -0,0 +1,16 @@
+{
+  "schema_version": 1,
+  "mode": "offline",
+  "query": "Help me optimize the websocket connection implementation",
+  "model": "offline-lexical-fixture",
+  "thresholds": {
+    "directory": 0.35,
+    "file": 0.5,
+    "line": 0.6
+  },
+  "batch_size": 48,
+  "github_run_id": "35819390521",
+  "github_run_attempt": "1",
+  "commit_sha": "63aee26c65438d3b5a8bcff5e87fdd2f54f4bef1",
+  "ref_name": "research/system-one-code-localization"
+}
diff --git a/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/offline/run.log b/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/offline/run.log
new file mode 100644
index 00000000..7e3c4b63
--- /dev/null
+++ b/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/offline/run.log
@@ -0,0 +1,33 @@
+relevant directories:
+  0.840 web/src
+  0.840 web/src/ws
+  0.620 server
+  0.620 server/src
+  0.620 web
+  0.620 web/src/api
+relevant files:
+  0.840 web/src/ws/client.ts
+  0.620 server/src/http.ts
+  0.620 web/src/api/user.ts
+relevant snippets:
+  0.960 web/src/ws/client.ts:1-19
+1: export class WebSocketClient {
+2:   private socket?: WebSocket;
+3:   private reconnectTimer?: ReturnType<typeof setTimeout>;
+4: 
+5:   connect(url: string) {
+6:     this.socket = new WebSocket(url);
+7:     this.socket.onopen = () => this.clearReconnect();
+8:     this.socket.onclose = () => this.scheduleReconnect(url);
+9:     this.socket.onerror = () => this.socket?.close();
+10:   }
+11: 
+12:   private scheduleReconnect(url: string) {
+13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);
+14:   }
+15: 
+16:   private clearReconnect() {
+17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);
+18:   }
+19: }
+metrics: {"model_calls": 0, "input_tokens": 0, "output_tokens": 0, "directories_exposed": 6, "directories_selected": 6, "files_exposed": 3, "files_selected": 3, "lines_exposed": 23, "lines_selected": 16, "snippets": 1, "elapsed_ms": 3.504}
diff --git a/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/offline/summary.md b/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/offline/summary.md
new file mode 100644
index 00000000..3383623c
--- /dev/null
+++ b/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/offline/summary.md
@@ -0,0 +1,7 @@
+# System One Code Locator — offline fixture
+
+- Query: `Help me optimize the websocket connection implementation`
+- Directories: 6
+- Files: 3
+- Snippets: 1
+- Metrics: `{'model_calls': 0, 'input_tokens': 0, 'output_tokens': 0, 'directories_exposed': 6, 'directories_selected': 6, 'files_exposed': 3, 'files_selected': 3, 'lines_exposed': 23, 'lines_selected': 16, 'snippets': 1, 'elapsed_ms': 3.504}`
diff --git a/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/offline/tests.log b/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/offline/tests.log
new file mode 100644
index 00000000..89daae97
--- /dev/null
+++ b/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/offline/tests.log
@@ -0,0 +1,7 @@
+test_progressive_localization (test_system_one_code_locator.DemoTest.test_progressive_localization) ... ok
+test_request_uses_noul (test_system_one_code_locator.DemoTest.test_request_uses_noul) ... ok
+
+----------------------------------------------------------------------
+Ran 2 tests in 0.006s
+
+OK
diff --git a/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/offline/trace.jsonl b/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/offline/trace.jsonl
new file mode 100644
index 00000000..e5dda16d
--- /dev/null
+++ b/research/code-locator/runs/20260923T124223+0800-run-35819390521-attempt-1/offline/trace.jsonl
@@ -0,0 +1,17 @@
+{"event": "search_started", "model": "offline-lexical-fixture", "query": "Help me optimize the websocket connection implementation", "root": "/home/runner/work/narness-engineering/narness-engineering/examples/system-one-code-locator/fixtures/repository", "thresholds": {"directory": 0.35, "file": 0.5, "line": 0.6}, "timestamp": "2026-09-23T04:42:11.954266+00:00"}
+{"candidates": [{"id": "server", "payload": {"child_directories": ["src"], "direct_files": [], "name": "server", "path": "server"}}, {"id": "server/src", "payload": {"child_directories": [], "direct_files": ["http.ts"], "name": "src", "path": "server/src"}}, {"id": "web", "payload": {"child_directories": ["src"], "direct_files": [], "name": "web", "path": "web"}}, {"id": "web/src", "payload": {"child_directories": ["api", "ws"], "direct_files": [], "name": "src", "path": "web/src"}}, {"id": "web/src/api", "payload": {"child_directories": [], "direct_files": ["user.ts"], "name": "api", "path": "web/src/api"}}, {"id": "web/src/ws", "payload": {"child_directories": [], "direct_files": ["client.ts"], "name": "ws", "path": "web/src/ws"}}], "count": 6, "event": "candidates_exposed", "stage": "directory", "timestamp": "2026-09-23T04:42:11.954915+00:00"}
+{"event": "offline_scores", "scores": [{"id": "web/src", "score": 0.84}, {"id": "web/src/ws", "score": 0.84}, {"id": "server", "score": 0.62}, {"id": "server/src", "score": 0.62}, {"id": "web", "score": 0.62}, {"id": "web/src/api", "score": 0.62}], "stage": "directory", "timestamp": "2026-09-23T04:42:11.955139+00:00"}
+{"event": "threshold_applied", "input_count": 6, "selected": [{"id": "web/src", "payload": {"child_directories": ["api", "ws"], "direct_files": [], "name": "src", "path": "web/src"}, "score": 0.84}, {"id": "web/src/ws", "payload": {"child_directories": [], "direct_files": ["client.ts"], "name": "ws", "path": "web/src/ws"}, "score": 0.84}, {"id": "server", "payload": {"child_directories": ["src"], "direct_files": [], "name": "server", "path": "server"}, "score": 0.62}, {"id": "server/src", "payload": {"child_directories": [], "direct_files": ["http.ts"], "name": "src", "path": "server/src"}, "score": 0.62}, {"id": "web", "payload": {"child_directories": ["src"], "direct_files": [], "name": "web", "path": "web"}, "score": 0.62}, {"id": "web/src/api", "payload": {"child_directories": [], "direct_files": ["user.ts"], "name": "api", "path": "web/src/api"}, "score": 0.62}], "selected_count": 6, "stage": "directory", "threshold": 0.35, "timestamp": "2026-09-23T04:42:11.955205+00:00"}
+{"candidates": [{"id": "server/src/http.ts", "payload": {"extension": ".ts", "filename": "http.ts", "path": "server/src/http.ts", "size_bytes": 76}}, {"id": "web/src/api/user.ts", "payload": {"extension": ".ts", "filename": "user.ts", "path": "web/src/api/user.ts", "size_bytes": 125}}, {"id": "web/src/ws/client.ts", "payload": {"extension": ".ts", "filename": "client.ts", "path": "web/src/ws/client.ts", "size_bytes": 573}}], "count": 3, "event": "candidates_exposed", "stage": "file", "timestamp": "2026-09-23T04:42:11.956097+00:00"}
+{"event": "offline_scores", "scores": [{"id": "web/src/ws/client.ts", "score": 0.84}, {"id": "server/src/http.ts", "score": 0.62}, {"id": "web/src/api/user.ts", "score": 0.62}], "stage": "file", "timestamp": "2026-09-23T04:42:11.956198+00:00"}
+{"event": "threshold_applied", "input_count": 3, "selected": [{"id": "web/src/ws/client.ts", "payload": {"extension": ".ts", "filename": "client.ts", "path": "web/src/ws/client.ts", "size_bytes": 573}, "score": 0.84}, {"id": "server/src/http.ts", "payload": {"extension": ".ts", "filename": "http.ts", "path": "server/src/http.ts", "size_bytes": 76}, "score": 0.62}, {"id": "web/src/api/user.ts", "payload": {"extension": ".ts", "filename": "user.ts", "path": "web/src/api/user.ts", "size_bytes": 125}, "score": 0.62}], "selected_count": 3, "stage": "file", "threshold": 0.5, "timestamp": "2026-09-23T04:42:11.956252+00:00"}
+{"candidates": [{"id": "web/src/ws/client.ts:1", "payload": {"line": 1, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;", "path": "web/src/ws/client.ts", "text": "export class WebSocketClient {"}}, {"id": "web/src/ws/client.ts:2", "payload": {"line": 2, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: ", "path": "web/src/ws/client.ts", "text": "  private socket?: WebSocket;"}}, {"id": "web/src/ws/client.ts:3", "payload": {"line": 3, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {", "path": "web/src/ws/client.ts", "text": "  private reconnectTimer?: ReturnType<typeof setTimeout>;"}}, {"id": "web/src/ws/client.ts:5", "payload": {"line": 5, "nearby_lines": "3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();", "path": "web/src/ws/client.ts", "text": "  connect(url: string) {"}}, {"id": "web/src/ws/client.ts:6", "payload": {"line": 6, "nearby_lines": "4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);", "path": "web/src/ws/client.ts", "text": "    this.socket = new WebSocket(url);"}}, {"id": "web/src/ws/client.ts:7", "payload": {"line": 7, "nearby_lines": "5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();", "path": "web/src/ws/client.ts", "text": "    this.socket.onopen = () => this.clearReconnect();"}}, {"id": "web/src/ws/client.ts:8", "payload": {"line": 8, "nearby_lines": "6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }", "path": "web/src/ws/client.ts", "text": "    this.socket.onclose = () => this.scheduleReconnect(url);"}}, {"id": "web/src/ws/client.ts:9", "payload": {"line": 9, "nearby_lines": "7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: ", "path": "web/src/ws/client.ts", "text": "    this.socket.onerror = () => this.socket?.close();"}}, {"id": "web/src/ws/client.ts:10", "payload": {"line": 10, "nearby_lines": "8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: \n12:   private scheduleReconnect(url: string) {", "path": "web/src/ws/client.ts", "text": "  }"}}, {"id": "web/src/ws/client.ts:12", "payload": {"line": 12, "nearby_lines": "10:   }\n11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }", "path": "web/src/ws/client.ts", "text": "  private scheduleReconnect(url: string) {"}}, {"id": "web/src/ws/client.ts:13", "payload": {"line": 13, "nearby_lines": "11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: ", "path": "web/src/ws/client.ts", "text": "    this.reconnectTimer = setTimeout(() => this.connect(url), 1000);"}}, {"id": "web/src/ws/client.ts:14", "payload": {"line": 14, "nearby_lines": "12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: \n16:   private clearReconnect() {", "path": "web/src/ws/client.ts", "text": "  }"}}, {"id": "web/src/ws/client.ts:16", "payload": {"line": 16, "nearby_lines": "14:   }\n15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }", "path": "web/src/ws/client.ts", "text": "  private clearReconnect() {"}}, {"id": "web/src/ws/client.ts:17", "payload": {"line": 17, "nearby_lines": "15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "    if (this.reconnectTimer) clearTimeout(this.reconnectTimer);"}}, {"id": "web/src/ws/client.ts:18", "payload": {"line": 18, "nearby_lines": "16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "  }"}}, {"id": "web/src/ws/client.ts:19", "payload": {"line": 19, "nearby_lines": "17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "}"}}], "count": 16, "event": "candidates_exposed", "parent": "web/src/ws/client.ts", "stage": "line", "timestamp": "2026-09-23T04:42:11.956484+00:00"}
+{"event": "offline_scores", "scores": [{"id": "web/src/ws/client.ts:1", "score": 0.96}, {"id": "web/src/ws/client.ts:10", "score": 0.96}, {"id": "web/src/ws/client.ts:12", "score": 0.96}, {"id": "web/src/ws/client.ts:13", "score": 0.96}, {"id": "web/src/ws/client.ts:14", "score": 0.96}, {"id": "web/src/ws/client.ts:16", "score": 0.96}, {"id": "web/src/ws/client.ts:17", "score": 0.96}, {"id": "web/src/ws/client.ts:18", "score": 0.96}, {"id": "web/src/ws/client.ts:19", "score": 0.96}, {"id": "web/src/ws/client.ts:2", "score": 0.96}, {"id": "web/src/ws/client.ts:3", "score": 0.96}, {"id": "web/src/ws/client.ts:5", "score": 0.96}, {"id": "web/src/ws/client.ts:6", "score": 0.96}, {"id": "web/src/ws/client.ts:7", "score": 0.96}, {"id": "web/src/ws/client.ts:8", "score": 0.96}, {"id": "web/src/ws/client.ts:9", "score": 0.96}], "stage": "line", "timestamp": "2026-09-23T04:42:11.956728+00:00"}
+{"event": "threshold_applied", "input_count": 16, "parent": "web/src/ws/client.ts", "selected": [{"id": "web/src/ws/client.ts:1", "payload": {"line": 1, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;", "path": "web/src/ws/client.ts", "text": "export class WebSocketClient {"}, "score": 0.96}, {"id": "web/src/ws/client.ts:10", "payload": {"line": 10, "nearby_lines": "8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: \n12:   private scheduleReconnect(url: string) {", "path": "web/src/ws/client.ts", "text": "  }"}, "score": 0.96}, {"id": "web/src/ws/client.ts:12", "payload": {"line": 12, "nearby_lines": "10:   }\n11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }", "path": "web/src/ws/client.ts", "text": "  private scheduleReconnect(url: string) {"}, "score": 0.96}, {"id": "web/src/ws/client.ts:13", "payload": {"line": 13, "nearby_lines": "11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: ", "path": "web/src/ws/client.ts", "text": "    this.reconnectTimer = setTimeout(() => this.connect(url), 1000);"}, "score": 0.96}, {"id": "web/src/ws/client.ts:14", "payload": {"line": 14, "nearby_lines": "12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: \n16:   private clearReconnect() {", "path": "web/src/ws/client.ts", "text": "  }"}, "score": 0.96}, {"id": "web/src/ws/client.ts:16", "payload": {"line": 16, "nearby_lines": "14:   }\n15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }", "path": "web/src/ws/client.ts", "text": "  private clearReconnect() {"}, "score": 0.96}, {"id": "web/src/ws/client.ts:17", "payload": {"line": 17, "nearby_lines": "15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "    if (this.reconnectTimer) clearTimeout(this.reconnectTimer);"}, "score": 0.96}, {"id": "web/src/ws/client.ts:18", "payload": {"line": 18, "nearby_lines": "16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "  }"}, "score": 0.96}, {"id": "web/src/ws/client.ts:19", "payload": {"line": 19, "nearby_lines": "17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "}"}, "score": 0.96}, {"id": "web/src/ws/client.ts:2", "payload": {"line": 2, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: ", "path": "web/src/ws/client.ts", "text": "  private socket?: WebSocket;"}, "score": 0.96}, {"id": "web/src/ws/client.ts:3", "payload": {"line": 3, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {", "path": "web/src/ws/client.ts", "text": "  private reconnectTimer?: ReturnType<typeof setTimeout>;"}, "score": 0.96}, {"id": "web/src/ws/client.ts:5", "payload": {"line": 5, "nearby_lines": "3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();", "path": "web/src/ws/client.ts", "text": "  connect(url: string) {"}, "score": 0.96}, {"id": "web/src/ws/client.ts:6", "payload": {"line": 6, "nearby_lines": "4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);", "path": "web/src/ws/client.ts", "text": "    this.socket = new WebSocket(url);"}, "score": 0.96}, {"id": "web/src/ws/client.ts:7", "payload": {"line": 7, "nearby_lines": "5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();", "path": "web/src/ws/client.ts", "text": "    this.socket.onopen = () => this.clearReconnect();"}, "score": 0.96}, {"id": "web/src/ws/client.ts:8", "payload": {"line": 8, "nearby_lines": "6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }", "path": "web/src/ws/client.ts", "text": "    this.socket.onclose = () => this.scheduleReconnect(url);"}, "score": 0.96}, {"id": "web/src/ws/client.ts:9", "payload": {"line": 9, "nearby_lines": "7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: ", "path": "web/src/ws/client.ts", "text": "    this.socket.onerror = () => this.socket?.close();"}, "score": 0.96}], "selected_count": 16, "stage": "line", "threshold": 0.6, "timestamp": "2026-09-23T04:42:11.956801+00:00"}
+{"candidates": [{"id": "server/src/http.ts:1", "payload": {"line": 1, "nearby_lines": "1: export function startHttpServer() {\n2:   console.log('http server started');\n3: }", "path": "server/src/http.ts", "text": "export function startHttpServer() {"}}, {"id": "server/src/http.ts:2", "payload": {"line": 2, "nearby_lines": "1: export function startHttpServer() {\n2:   console.log('http server started');\n3: }", "path": "server/src/http.ts", "text": "  console.log('http server started');"}}, {"id": "server/src/http.ts:3", "payload": {"line": 3, "nearby_lines": "1: export function startHttpServer() {\n2:   console.log('http server started');\n3: }", "path": "server/src/http.ts", "text": "}"}}], "count": 3, "event": "candidates_exposed", "parent": "server/src/http.ts", "stage": "line", "timestamp": "2026-09-23T04:42:11.957111+00:00"}
+{"event": "offline_scores", "scores": [{"id": "server/src/http.ts:1", "score": 0.05}, {"id": "server/src/http.ts:2", "score": 0.05}, {"id": "server/src/http.ts:3", "score": 0.05}], "stage": "line", "timestamp": "2026-09-23T04:42:11.957215+00:00"}
+{"event": "threshold_applied", "input_count": 3, "parent": "server/src/http.ts", "selected": [], "selected_count": 0, "stage": "line", "threshold": 0.6, "timestamp": "2026-09-23T04:42:11.957269+00:00"}
+{"candidates": [{"id": "web/src/api/user.ts:1", "payload": {"line": 1, "nearby_lines": "1: export async function loadUser(id: string) {\n2:   const response = await fetch(`/api/users/${id}`);\n3:   return response.json();", "path": "web/src/api/user.ts", "text": "export async function loadUser(id: string) {"}}, {"id": "web/src/api/user.ts:2", "payload": {"line": 2, "nearby_lines": "1: export async function loadUser(id: string) {\n2:   const response = await fetch(`/api/users/${id}`);\n3:   return response.json();\n4: }", "path": "web/src/api/user.ts", "text": "  const response = await fetch(`/api/users/${id}`);"}}, {"id": "web/src/api/user.ts:3", "payload": {"line": 3, "nearby_lines": "1: export async function loadUser(id: string) {\n2:   const response = await fetch(`/api/users/${id}`);\n3:   return response.json();\n4: }", "path": "web/src/api/user.ts", "text": "  return response.json();"}}, {"id": "web/src/api/user.ts:4", "payload": {"line": 4, "nearby_lines": "2:   const response = await fetch(`/api/users/${id}`);\n3:   return response.json();\n4: }", "path": "web/src/api/user.ts", "text": "}"}}], "count": 4, "event": "candidates_exposed", "parent": "web/src/api/user.ts", "stage": "line", "timestamp": "2026-09-23T04:42:11.957440+00:00"}
+{"event": "offline_scores", "scores": [{"id": "web/src/api/user.ts:1", "score": 0.05}, {"id": "web/src/api/user.ts:2", "score": 0.05}, {"id": "web/src/api/user.ts:3", "score": 0.05}, {"id": "web/src/api/user.ts:4", "score": 0.05}], "stage": "line", "timestamp": "2026-09-23T04:42:11.957545+00:00"}
+{"event": "threshold_applied", "input_count": 4, "parent": "web/src/api/user.ts", "selected": [], "selected_count": 0, "stage": "line", "threshold": 0.6, "timestamp": "2026-09-23T04:42:11.957598+00:00"}
+{"event": "search_completed", "result": {"directories": [{"id": "web/src", "payload": {"child_directories": ["api", "ws"], "direct_files": [], "name": "src", "path": "web/src"}, "score": 0.84}, {"id": "web/src/ws", "payload": {"child_directories": [], "direct_files": ["client.ts"], "name": "ws", "path": "web/src/ws"}, "score": 0.84}, {"id": "server", "payload": {"child_directories": ["src"], "direct_files": [], "name": "server", "path": "server"}, "score": 0.62}, {"id": "server/src", "payload": {"child_directories": [], "direct_files": ["http.ts"], "name": "src", "path": "server/src"}, "score": 0.62}, {"id": "web", "payload": {"child_directories": ["src"], "direct_files": [], "name": "web", "path": "web"}, "score": 0.62}, {"id": "web/src/api", "payload": {"child_directories": [], "direct_files": ["user.ts"], "name": "api", "path": "web/src/api"}, "score": 0.62}], "files": [{"id": "web/src/ws/client.ts", "payload": {"extension": ".ts", "filename": "client.ts", "path": "web/src/ws/client.ts", "size_bytes": 573}, "score": 0.84}, {"id": "server/src/http.ts", "payload": {"extension": ".ts", "filename": "http.ts", "path": "server/src/http.ts", "size_bytes": 76}, "score": 0.62}, {"id": "web/src/api/user.ts", "payload": {"extension": ".ts", "filename": "user.ts", "path": "web/src/api/user.ts", "size_bytes": 125}, "score": 0.62}], "metrics": {"directories_exposed": 6, "directories_selected": 6, "elapsed_ms": 3.504, "files_exposed": 3, "files_selected": 3, "input_tokens": 0, "lines_exposed": 23, "lines_selected": 16, "model_calls": 0, "output_tokens": 0, "snippets": 1}, "model": "offline-lexical-fixture", "query": "Help me optimize the websocket connection implementation", "root": "/home/runner/work/narness-engineering/narness-engineering/examples/system-one-code-locator/fixtures/repository", "snippets": [{"content": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "end_line": 19, "path": "web/src/ws/client.ts", "score": 0.96, "start_line": 1}], "thresholds": {"directory": 0.35, "file": 0.5, "line": 0.6}}, "timestamp": "2026-09-23T04:42:11.957700+00:00"}
diff --git a/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/README.md b/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/README.md
new file mode 100644
index 00000000..2313103a
--- /dev/null
+++ b/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/README.md
@@ -0,0 +1,18 @@
+# System One Code Locator experiment
+
+- Recorded at: `20260923T124813+0800` (UTC+8)
+- GitHub run: [35819796535](https://github.com/BestNathan/narness-engineering/actions/runs/35819796535)
+- Run attempt: `1`
+- Event: `push`
+- Repository: `BestNathan/narness-engineering`
+- Ref: `research/system-one-code-localization`
+- Trigger SHA: `4b25c9201595d49324844d7a72ceee393805c9de`
+- Offline job: `success`
+- TypeSafe job: `skipped`
+
+## Evidence
+
+- [Offline evidence](offline/) when the offline validation produced an artifact.
+- [TypeSafe evidence](typesafe/) when a real TypeSafe experiment was requested.
+
+The files in this directory are an immutable snapshot of the evidence produced by this workflow run.
diff --git a/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/offline/result.json b/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/offline/result.json
new file mode 100644
index 00000000..18d5fe4f
--- /dev/null
+++ b/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/offline/result.json
@@ -0,0 +1,139 @@
+{
+  "query": "Help me optimize the websocket connection implementation",
+  "root": "/home/runner/work/narness-engineering/narness-engineering/examples/system-one-code-locator/fixtures/repository",
+  "model": "offline-lexical-fixture",
+  "thresholds": {
+    "directory": 0.35,
+    "file": 0.5,
+    "line": 0.6
+  },
+  "directories": [
+    {
+      "id": "web/src",
+      "payload": {
+        "path": "web/src",
+        "name": "src",
+        "child_directories": [
+          "api",
+          "ws"
+        ],
+        "direct_files": []
+      },
+      "score": 0.84
+    },
+    {
+      "id": "web/src/ws",
+      "payload": {
+        "path": "web/src/ws",
+        "name": "ws",
+        "child_directories": [],
+        "direct_files": [
+          "client.ts"
+        ]
+      },
+      "score": 0.84
+    },
+    {
+      "id": "server",
+      "payload": {
+        "path": "server",
+        "name": "server",
+        "child_directories": [
+          "src"
+        ],
+        "direct_files": []
+      },
+      "score": 0.62
+    },
+    {
+      "id": "server/src",
+      "payload": {
+        "path": "server/src",
+        "name": "src",
+        "child_directories": [],
+        "direct_files": [
+          "http.ts"
+        ]
+      },
+      "score": 0.62
+    },
+    {
+      "id": "web",
+      "payload": {
+        "path": "web",
+        "name": "web",
+        "child_directories": [
+          "src"
+        ],
+        "direct_files": []
+      },
+      "score": 0.62
+    },
+    {
+      "id": "web/src/api",
+      "payload": {
+        "path": "web/src/api",
+        "name": "api",
+        "child_directories": [],
+        "direct_files": [
+          "user.ts"
+        ]
+      },
+      "score": 0.62
+    }
+  ],
+  "files": [
+    {
+      "id": "web/src/ws/client.ts",
+      "payload": {
+        "path": "web/src/ws/client.ts",
+        "filename": "client.ts",
+        "extension": ".ts",
+        "size_bytes": 573
+      },
+      "score": 0.84
+    },
+    {
+      "id": "server/src/http.ts",
+      "payload": {
+        "path": "server/src/http.ts",
+        "filename": "http.ts",
+        "extension": ".ts",
+        "size_bytes": 76
+      },
+      "score": 0.62
+    },
+    {
+      "id": "web/src/api/user.ts",
+      "payload": {
+        "path": "web/src/api/user.ts",
+        "filename": "user.ts",
+        "extension": ".ts",
+        "size_bytes": 125
+      },
+      "score": 0.62
+    }
+  ],
+  "snippets": [
+    {
+      "path": "web/src/ws/client.ts",
+      "start_line": 1,
+      "end_line": 19,
+      "score": 0.96,
+      "content": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }"
+    }
+  ],
+  "metrics": {
+    "model_calls": 0,
+    "input_tokens": 0,
+    "output_tokens": 0,
+    "directories_exposed": 6,
+    "directories_selected": 6,
+    "files_exposed": 3,
+    "files_selected": 3,
+    "lines_exposed": 23,
+    "lines_selected": 16,
+    "snippets": 1,
+    "elapsed_ms": 3.061
+  }
+}
diff --git a/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/offline/run-manifest.json b/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/offline/run-manifest.json
new file mode 100644
index 00000000..fe41255d
--- /dev/null
+++ b/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/offline/run-manifest.json
@@ -0,0 +1,16 @@
+{
+  "schema_version": 1,
+  "mode": "offline",
+  "query": "Help me optimize the websocket connection implementation",
+  "model": "offline-lexical-fixture",
+  "thresholds": {
+    "directory": 0.35,
+    "file": 0.5,
+    "line": 0.6
+  },
+  "batch_size": 48,
+  "github_run_id": "35819796535",
+  "github_run_attempt": "1",
+  "commit_sha": "4b25c9201595d49324844d7a72ceee393805c9de",
+  "ref_name": "research/system-one-code-localization"
+}
diff --git a/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/offline/run.log b/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/offline/run.log
new file mode 100644
index 00000000..53094705
--- /dev/null
+++ b/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/offline/run.log
@@ -0,0 +1,33 @@
+relevant directories:
+  0.840 web/src
+  0.840 web/src/ws
+  0.620 server
+  0.620 server/src
+  0.620 web
+  0.620 web/src/api
+relevant files:
+  0.840 web/src/ws/client.ts
+  0.620 server/src/http.ts
+  0.620 web/src/api/user.ts
+relevant snippets:
+  0.960 web/src/ws/client.ts:1-19
+1: export class WebSocketClient {
+2:   private socket?: WebSocket;
+3:   private reconnectTimer?: ReturnType<typeof setTimeout>;
+4: 
+5:   connect(url: string) {
+6:     this.socket = new WebSocket(url);
+7:     this.socket.onopen = () => this.clearReconnect();
+8:     this.socket.onclose = () => this.scheduleReconnect(url);
+9:     this.socket.onerror = () => this.socket?.close();
+10:   }
+11: 
+12:   private scheduleReconnect(url: string) {
+13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);
+14:   }
+15: 
+16:   private clearReconnect() {
+17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);
+18:   }
+19: }
+metrics: {"model_calls": 0, "input_tokens": 0, "output_tokens": 0, "directories_exposed": 6, "directories_selected": 6, "files_exposed": 3, "files_selected": 3, "lines_exposed": 23, "lines_selected": 16, "snippets": 1, "elapsed_ms": 3.061}
diff --git a/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/offline/summary.md b/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/offline/summary.md
new file mode 100644
index 00000000..51edd5e4
--- /dev/null
+++ b/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/offline/summary.md
@@ -0,0 +1,7 @@
+# System One Code Locator — offline fixture
+
+- Query: `Help me optimize the websocket connection implementation`
+- Directories: 6
+- Files: 3
+- Snippets: 1
+- Metrics: `{'model_calls': 0, 'input_tokens': 0, 'output_tokens': 0, 'directories_exposed': 6, 'directories_selected': 6, 'files_exposed': 3, 'files_selected': 3, 'lines_exposed': 23, 'lines_selected': 16, 'snippets': 1, 'elapsed_ms': 3.061}`
diff --git a/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/offline/tests.log b/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/offline/tests.log
new file mode 100644
index 00000000..acc7996d
--- /dev/null
+++ b/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/offline/tests.log
@@ -0,0 +1,7 @@
+test_progressive_localization (test_system_one_code_locator.DemoTest.test_progressive_localization) ... ok
+test_request_uses_noul (test_system_one_code_locator.DemoTest.test_request_uses_noul) ... ok
+
+----------------------------------------------------------------------
+Ran 2 tests in 0.011s
+
+OK
diff --git a/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/offline/trace.jsonl b/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/offline/trace.jsonl
new file mode 100644
index 00000000..6ffedf16
--- /dev/null
+++ b/research/code-locator/runs/20260923T124813+0800-run-35819796535-attempt-1/offline/trace.jsonl
@@ -0,0 +1,17 @@
+{"event": "search_started", "model": "offline-lexical-fixture", "query": "Help me optimize the websocket connection implementation", "root": "/home/runner/work/narness-engineering/narness-engineering/examples/system-one-code-locator/fixtures/repository", "thresholds": {"directory": 0.35, "file": 0.5, "line": 0.6}, "timestamp": "2026-09-23T04:48:04.435734+00:00"}
+{"candidates": [{"id": "server", "payload": {"child_directories": ["src"], "direct_files": [], "name": "server", "path": "server"}}, {"id": "server/src", "payload": {"child_directories": [], "direct_files": ["http.ts"], "name": "src", "path": "server/src"}}, {"id": "web", "payload": {"child_directories": ["src"], "direct_files": [], "name": "web", "path": "web"}}, {"id": "web/src", "payload": {"child_directories": ["api", "ws"], "direct_files": [], "name": "src", "path": "web/src"}}, {"id": "web/src/api", "payload": {"child_directories": [], "direct_files": ["user.ts"], "name": "api", "path": "web/src/api"}}, {"id": "web/src/ws", "payload": {"child_directories": [], "direct_files": ["client.ts"], "name": "ws", "path": "web/src/ws"}}], "count": 6, "event": "candidates_exposed", "stage": "directory", "timestamp": "2026-09-23T04:48:04.436271+00:00"}
+{"event": "offline_scores", "scores": [{"id": "web/src", "score": 0.84}, {"id": "web/src/ws", "score": 0.84}, {"id": "server", "score": 0.62}, {"id": "server/src", "score": 0.62}, {"id": "web", "score": 0.62}, {"id": "web/src/api", "score": 0.62}], "stage": "directory", "timestamp": "2026-09-23T04:48:04.436487+00:00"}
+{"event": "threshold_applied", "input_count": 6, "selected": [{"id": "web/src", "payload": {"child_directories": ["api", "ws"], "direct_files": [], "name": "src", "path": "web/src"}, "score": 0.84}, {"id": "web/src/ws", "payload": {"child_directories": [], "direct_files": ["client.ts"], "name": "ws", "path": "web/src/ws"}, "score": 0.84}, {"id": "server", "payload": {"child_directories": ["src"], "direct_files": [], "name": "server", "path": "server"}, "score": 0.62}, {"id": "server/src", "payload": {"child_directories": [], "direct_files": ["http.ts"], "name": "src", "path": "server/src"}, "score": 0.62}, {"id": "web", "payload": {"child_directories": ["src"], "direct_files": [], "name": "web", "path": "web"}, "score": 0.62}, {"id": "web/src/api", "payload": {"child_directories": [], "direct_files": ["user.ts"], "name": "api", "path": "web/src/api"}, "score": 0.62}], "selected_count": 6, "stage": "directory", "threshold": 0.35, "timestamp": "2026-09-23T04:48:04.436564+00:00"}
+{"candidates": [{"id": "server/src/http.ts", "payload": {"extension": ".ts", "filename": "http.ts", "path": "server/src/http.ts", "size_bytes": 76}}, {"id": "web/src/api/user.ts", "payload": {"extension": ".ts", "filename": "user.ts", "path": "web/src/api/user.ts", "size_bytes": 125}}, {"id": "web/src/ws/client.ts", "payload": {"extension": ".ts", "filename": "client.ts", "path": "web/src/ws/client.ts", "size_bytes": 573}}], "count": 3, "event": "candidates_exposed", "stage": "file", "timestamp": "2026-09-23T04:48:04.437284+00:00"}
+{"event": "offline_scores", "scores": [{"id": "web/src/ws/client.ts", "score": 0.84}, {"id": "server/src/http.ts", "score": 0.62}, {"id": "web/src/api/user.ts", "score": 0.62}], "stage": "file", "timestamp": "2026-09-23T04:48:04.437378+00:00"}
+{"event": "threshold_applied", "input_count": 3, "selected": [{"id": "web/src/ws/client.ts", "payload": {"extension": ".ts", "filename": "client.ts", "path": "web/src/ws/client.ts", "size_bytes": 573}, "score": 0.84}, {"id": "server/src/http.ts", "payload": {"extension": ".ts", "filename": "http.ts", "path": "server/src/http.ts", "size_bytes": 76}, "score": 0.62}, {"id": "web/src/api/user.ts", "payload": {"extension": ".ts", "filename": "user.ts", "path": "web/src/api/user.ts", "size_bytes": 125}, "score": 0.62}], "selected_count": 3, "stage": "file", "threshold": 0.5, "timestamp": "2026-09-23T04:48:04.437423+00:00"}
+{"candidates": [{"id": "web/src/ws/client.ts:1", "payload": {"line": 1, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;", "path": "web/src/ws/client.ts", "text": "export class WebSocketClient {"}}, {"id": "web/src/ws/client.ts:2", "payload": {"line": 2, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: ", "path": "web/src/ws/client.ts", "text": "  private socket?: WebSocket;"}}, {"id": "web/src/ws/client.ts:3", "payload": {"line": 3, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {", "path": "web/src/ws/client.ts", "text": "  private reconnectTimer?: ReturnType<typeof setTimeout>;"}}, {"id": "web/src/ws/client.ts:5", "payload": {"line": 5, "nearby_lines": "3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();", "path": "web/src/ws/client.ts", "text": "  connect(url: string) {"}}, {"id": "web/src/ws/client.ts:6", "payload": {"line": 6, "nearby_lines": "4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);", "path": "web/src/ws/client.ts", "text": "    this.socket = new WebSocket(url);"}}, {"id": "web/src/ws/client.ts:7", "payload": {"line": 7, "nearby_lines": "5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();", "path": "web/src/ws/client.ts", "text": "    this.socket.onopen = () => this.clearReconnect();"}}, {"id": "web/src/ws/client.ts:8", "payload": {"line": 8, "nearby_lines": "6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }", "path": "web/src/ws/client.ts", "text": "    this.socket.onclose = () => this.scheduleReconnect(url);"}}, {"id": "web/src/ws/client.ts:9", "payload": {"line": 9, "nearby_lines": "7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: ", "path": "web/src/ws/client.ts", "text": "    this.socket.onerror = () => this.socket?.close();"}}, {"id": "web/src/ws/client.ts:10", "payload": {"line": 10, "nearby_lines": "8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: \n12:   private scheduleReconnect(url: string) {", "path": "web/src/ws/client.ts", "text": "  }"}}, {"id": "web/src/ws/client.ts:12", "payload": {"line": 12, "nearby_lines": "10:   }\n11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }", "path": "web/src/ws/client.ts", "text": "  private scheduleReconnect(url: string) {"}}, {"id": "web/src/ws/client.ts:13", "payload": {"line": 13, "nearby_lines": "11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: ", "path": "web/src/ws/client.ts", "text": "    this.reconnectTimer = setTimeout(() => this.connect(url), 1000);"}}, {"id": "web/src/ws/client.ts:14", "payload": {"line": 14, "nearby_lines": "12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: \n16:   private clearReconnect() {", "path": "web/src/ws/client.ts", "text": "  }"}}, {"id": "web/src/ws/client.ts:16", "payload": {"line": 16, "nearby_lines": "14:   }\n15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }", "path": "web/src/ws/client.ts", "text": "  private clearReconnect() {"}}, {"id": "web/src/ws/client.ts:17", "payload": {"line": 17, "nearby_lines": "15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "    if (this.reconnectTimer) clearTimeout(this.reconnectTimer);"}}, {"id": "web/src/ws/client.ts:18", "payload": {"line": 18, "nearby_lines": "16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "  }"}}, {"id": "web/src/ws/client.ts:19", "payload": {"line": 19, "nearby_lines": "17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "}"}}], "count": 16, "event": "candidates_exposed", "parent": "web/src/ws/client.ts", "stage": "line", "timestamp": "2026-09-23T04:48:04.437633+00:00"}
+{"event": "offline_scores", "scores": [{"id": "web/src/ws/client.ts:1", "score": 0.96}, {"id": "web/src/ws/client.ts:10", "score": 0.96}, {"id": "web/src/ws/client.ts:12", "score": 0.96}, {"id": "web/src/ws/client.ts:13", "score": 0.96}, {"id": "web/src/ws/client.ts:14", "score": 0.96}, {"id": "web/src/ws/client.ts:16", "score": 0.96}, {"id": "web/src/ws/client.ts:17", "score": 0.96}, {"id": "web/src/ws/client.ts:18", "score": 0.96}, {"id": "web/src/ws/client.ts:19", "score": 0.96}, {"id": "web/src/ws/client.ts:2", "score": 0.96}, {"id": "web/src/ws/client.ts:3", "score": 0.96}, {"id": "web/src/ws/client.ts:5", "score": 0.96}, {"id": "web/src/ws/client.ts:6", "score": 0.96}, {"id": "web/src/ws/client.ts:7", "score": 0.96}, {"id": "web/src/ws/client.ts:8", "score": 0.96}, {"id": "web/src/ws/client.ts:9", "score": 0.96}], "stage": "line", "timestamp": "2026-09-23T04:48:04.437871+00:00"}
+{"event": "threshold_applied", "input_count": 16, "parent": "web/src/ws/client.ts", "selected": [{"id": "web/src/ws/client.ts:1", "payload": {"line": 1, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;", "path": "web/src/ws/client.ts", "text": "export class WebSocketClient {"}, "score": 0.96}, {"id": "web/src/ws/client.ts:10", "payload": {"line": 10, "nearby_lines": "8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: \n12:   private scheduleReconnect(url: string) {", "path": "web/src/ws/client.ts", "text": "  }"}, "score": 0.96}, {"id": "web/src/ws/client.ts:12", "payload": {"line": 12, "nearby_lines": "10:   }\n11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }", "path": "web/src/ws/client.ts", "text": "  private scheduleReconnect(url: string) {"}, "score": 0.96}, {"id": "web/src/ws/client.ts:13", "payload": {"line": 13, "nearby_lines": "11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: ", "path": "web/src/ws/client.ts", "text": "    this.reconnectTimer = setTimeout(() => this.connect(url), 1000);"}, "score": 0.96}, {"id": "web/src/ws/client.ts:14", "payload": {"line": 14, "nearby_lines": "12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: \n16:   private clearReconnect() {", "path": "web/src/ws/client.ts", "text": "  }"}, "score": 0.96}, {"id": "web/src/ws/client.ts:16", "payload": {"line": 16, "nearby_lines": "14:   }\n15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }", "path": "web/src/ws/client.ts", "text": "  private clearReconnect() {"}, "score": 0.96}, {"id": "web/src/ws/client.ts:17", "payload": {"line": 17, "nearby_lines": "15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "    if (this.reconnectTimer) clearTimeout(this.reconnectTimer);"}, "score": 0.96}, {"id": "web/src/ws/client.ts:18", "payload": {"line": 18, "nearby_lines": "16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "  }"}, "score": 0.96}, {"id": "web/src/ws/client.ts:19", "payload": {"line": 19, "nearby_lines": "17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "}"}, "score": 0.96}, {"id": "web/src/ws/client.ts:2", "payload": {"line": 2, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: ", "path": "web/src/ws/client.ts", "text": "  private socket?: WebSocket;"}, "score": 0.96}, {"id": "web/src/ws/client.ts:3", "payload": {"line": 3, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {", "path": "web/src/ws/client.ts", "text": "  private reconnectTimer?: ReturnType<typeof setTimeout>;"}, "score": 0.96}, {"id": "web/src/ws/client.ts:5", "payload": {"line": 5, "nearby_lines": "3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();", "path": "web/src/ws/client.ts", "text": "  connect(url: string) {"}, "score": 0.96}, {"id": "web/src/ws/client.ts:6", "payload": {"line": 6, "nearby_lines": "4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);", "path": "web/src/ws/client.ts", "text": "    this.socket = new WebSocket(url);"}, "score": 0.96}, {"id": "web/src/ws/client.ts:7", "payload": {"line": 7, "nearby_lines": "5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();", "path": "web/src/ws/client.ts", "text": "    this.socket.onopen = () => this.clearReconnect();"}, "score": 0.96}, {"id": "web/src/ws/client.ts:8", "payload": {"line": 8, "nearby_lines": "6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }", "path": "web/src/ws/client.ts", "text": "    this.socket.onclose = () => this.scheduleReconnect(url);"}, "score": 0.96}, {"id": "web/src/ws/client.ts:9", "payload": {"line": 9, "nearby_lines": "7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: ", "path": "web/src/ws/client.ts", "text": "    this.socket.onerror = () => this.socket?.close();"}, "score": 0.96}], "selected_count": 16, "stage": "line", "threshold": 0.6, "timestamp": "2026-09-23T04:48:04.437932+00:00"}
+{"candidates": [{"id": "server/src/http.ts:1", "payload": {"line": 1, "nearby_lines": "1: export function startHttpServer() {\n2:   console.log('http server started');\n3: }", "path": "server/src/http.ts", "text": "export function startHttpServer() {"}}, {"id": "server/src/http.ts:2", "payload": {"line": 2, "nearby_lines": "1: export function startHttpServer() {\n2:   console.log('http server started');\n3: }", "path": "server/src/http.ts", "text": "  console.log('http server started');"}}, {"id": "server/src/http.ts:3", "payload": {"line": 3, "nearby_lines": "1: export function startHttpServer() {\n2:   console.log('http server started');\n3: }", "path": "server/src/http.ts", "text": "}"}}], "count": 3, "event": "candidates_exposed", "parent": "server/src/http.ts", "stage": "line", "timestamp": "2026-09-23T04:48:04.438205+00:00"}
+{"event": "offline_scores", "scores": [{"id": "server/src/http.ts:1", "score": 0.05}, {"id": "server/src/http.ts:2", "score": 0.05}, {"id": "server/src/http.ts:3", "score": 0.05}], "stage": "line", "timestamp": "2026-09-23T04:48:04.438293+00:00"}
+{"event": "threshold_applied", "input_count": 3, "parent": "server/src/http.ts", "selected": [], "selected_count": 0, "stage": "line", "threshold": 0.6, "timestamp": "2026-09-23T04:48:04.438336+00:00"}
+{"candidates": [{"id": "web/src/api/user.ts:1", "payload": {"line": 1, "nearby_lines": "1: export async function loadUser(id: string) {\n2:   const response = await fetch(`/api/users/${id}`);\n3:   return response.json();", "path": "web/src/api/user.ts", "text": "export async function loadUser(id: string) {"}}, {"id": "web/src/api/user.ts:2", "payload": {"line": 2, "nearby_lines": "1: export async function loadUser(id: string) {\n2:   const response = await fetch(`/api/users/${id}`);\n3:   return response.json();\n4: }", "path": "web/src/api/user.ts", "text": "  const response = await fetch(`/api/users/${id}`);"}}, {"id": "web/src/api/user.ts:3", "payload": {"line": 3, "nearby_lines": "1: export async function loadUser(id: string) {\n2:   const response = await fetch(`/api/users/${id}`);\n3:   return response.json();\n4: }", "path": "web/src/api/user.ts", "text": "  return response.json();"}}, {"id": "web/src/api/user.ts:4", "payload": {"line": 4, "nearby_lines": "2:   const response = await fetch(`/api/users/${id}`);\n3:   return response.json();\n4: }", "path": "web/src/api/user.ts", "text": "}"}}], "count": 4, "event": "candidates_exposed", "parent": "web/src/api/user.ts", "stage": "line", "timestamp": "2026-09-23T04:48:04.438460+00:00"}
+{"event": "offline_scores", "scores": [{"id": "web/src/api/user.ts:1", "score": 0.05}, {"id": "web/src/api/user.ts:2", "score": 0.05}, {"id": "web/src/api/user.ts:3", "score": 0.05}, {"id": "web/src/api/user.ts:4", "score": 0.05}], "stage": "line", "timestamp": "2026-09-23T04:48:04.438577+00:00"}
+{"event": "threshold_applied", "input_count": 4, "parent": "web/src/api/user.ts", "selected": [], "selected_count": 0, "stage": "line", "threshold": 0.6, "timestamp": "2026-09-23T04:48:04.438636+00:00"}
+{"event": "search_completed", "result": {"directories": [{"id": "web/src", "payload": {"child_directories": ["api", "ws"], "direct_files": [], "name": "src", "path": "web/src"}, "score": 0.84}, {"id": "web/src/ws", "payload": {"child_directories": [], "direct_files": ["client.ts"], "name": "ws", "path": "web/src/ws"}, "score": 0.84}, {"id": "server", "payload": {"child_directories": ["src"], "direct_files": [], "name": "server", "path": "server"}, "score": 0.62}, {"id": "server/src", "payload": {"child_directories": [], "direct_files": ["http.ts"], "name": "src", "path": "server/src"}, "score": 0.62}, {"id": "web", "payload": {"child_directories": ["src"], "direct_files": [], "name": "web", "path": "web"}, "score": 0.62}, {"id": "web/src/api", "payload": {"child_directories": [], "direct_files": ["user.ts"], "name": "api", "path": "web/src/api"}, "score": 0.62}], "files": [{"id": "web/src/ws/client.ts", "payload": {"extension": ".ts", "filename": "client.ts", "path": "web/src/ws/client.ts", "size_bytes": 573}, "score": 0.84}, {"id": "server/src/http.ts", "payload": {"extension": ".ts", "filename": "http.ts", "path": "server/src/http.ts", "size_bytes": 76}, "score": 0.62}, {"id": "web/src/api/user.ts", "payload": {"extension": ".ts", "filename": "user.ts", "path": "web/src/api/user.ts", "size_bytes": 125}, "score": 0.62}], "metrics": {"directories_exposed": 6, "directories_selected": 6, "elapsed_ms": 3.061, "files_exposed": 3, "files_selected": 3, "input_tokens": 0, "lines_exposed": 23, "lines_selected": 16, "model_calls": 0, "output_tokens": 0, "snippets": 1}, "model": "offline-lexical-fixture", "query": "Help me optimize the websocket connection implementation", "root": "/home/runner/work/narness-engineering/narness-engineering/examples/system-one-code-locator/fixtures/repository", "snippets": [{"content": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "end_line": 19, "path": "web/src/ws/client.ts", "score": 0.96, "start_line": 1}], "thresholds": {"directory": 0.35, "file": 0.5, "line": 0.6}}, "timestamp": "2026-09-23T04:48:04.438729+00:00"}
diff --git a/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/README.md b/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/README.md
new file mode 100644
index 00000000..1e573a8a
--- /dev/null
+++ b/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/README.md
@@ -0,0 +1,18 @@
+# System One Code Locator experiment
+
+- Recorded at: `20260923T125121+0800` (UTC+8)
+- GitHub run: [35820001391](https://github.com/BestNathan/narness-engineering/actions/runs/35820001391)
+- Run attempt: `1`
+- Event: `push`
+- Repository: `BestNathan/narness-engineering`
+- Ref: `research/system-one-code-localization`
+- Trigger SHA: `fbf5c0f981e65a0d88ecb76ff8a8c9ea04958057`
+- Offline job: `success`
+- TypeSafe job: `skipped`
+
+## Evidence
+
+- [Offline evidence](offline/) when the offline validation produced an artifact.
+- [TypeSafe evidence](typesafe/) when a real TypeSafe experiment was requested.
+
+The files in this directory are an immutable snapshot of the evidence produced by this workflow run.
diff --git a/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/offline/result.json b/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/offline/result.json
new file mode 100644
index 00000000..f97454e9
--- /dev/null
+++ b/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/offline/result.json
@@ -0,0 +1,139 @@
+{
+  "query": "Help me optimize the websocket connection implementation",
+  "root": "/home/runner/work/narness-engineering/narness-engineering/research/code-locator/fixtures/repository",
+  "model": "offline-lexical-fixture",
+  "thresholds": {
+    "directory": 0.35,
+    "file": 0.5,
+    "line": 0.6
+  },
+  "directories": [
+    {
+      "id": "web/src",
+      "payload": {
+        "path": "web/src",
+        "name": "src",
+        "child_directories": [
+          "api",
+          "ws"
+        ],
+        "direct_files": []
+      },
+      "score": 0.84
+    },
+    {
+      "id": "web/src/ws",
+      "payload": {
+        "path": "web/src/ws",
+        "name": "ws",
+        "child_directories": [],
+        "direct_files": [
+          "client.ts"
+        ]
+      },
+      "score": 0.84
+    },
+    {
+      "id": "server",
+      "payload": {
+        "path": "server",
+        "name": "server",
+        "child_directories": [
+          "src"
+        ],
+        "direct_files": []
+      },
+      "score": 0.62
+    },
+    {
+      "id": "server/src",
+      "payload": {
+        "path": "server/src",
+        "name": "src",
+        "child_directories": [],
+        "direct_files": [
+          "http.ts"
+        ]
+      },
+      "score": 0.62
+    },
+    {
+      "id": "web",
+      "payload": {
+        "path": "web",
+        "name": "web",
+        "child_directories": [
+          "src"
+        ],
+        "direct_files": []
+      },
+      "score": 0.62
+    },
+    {
+      "id": "web/src/api",
+      "payload": {
+        "path": "web/src/api",
+        "name": "api",
+        "child_directories": [],
+        "direct_files": [
+          "user.ts"
+        ]
+      },
+      "score": 0.62
+    }
+  ],
+  "files": [
+    {
+      "id": "web/src/ws/client.ts",
+      "payload": {
+        "path": "web/src/ws/client.ts",
+        "filename": "client.ts",
+        "extension": ".ts",
+        "size_bytes": 573
+      },
+      "score": 0.84
+    },
+    {
+      "id": "server/src/http.ts",
+      "payload": {
+        "path": "server/src/http.ts",
+        "filename": "http.ts",
+        "extension": ".ts",
+        "size_bytes": 76
+      },
+      "score": 0.62
+    },
+    {
+      "id": "web/src/api/user.ts",
+      "payload": {
+        "path": "web/src/api/user.ts",
+        "filename": "user.ts",
+        "extension": ".ts",
+        "size_bytes": 125
+      },
+      "score": 0.62
+    }
+  ],
+  "snippets": [
+    {
+      "path": "web/src/ws/client.ts",
+      "start_line": 1,
+      "end_line": 19,
+      "score": 0.96,
+      "content": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }"
+    }
+  ],
+  "metrics": {
+    "model_calls": 0,
+    "input_tokens": 0,
+    "output_tokens": 0,
+    "directories_exposed": 6,
+    "directories_selected": 6,
+    "files_exposed": 3,
+    "files_selected": 3,
+    "lines_exposed": 23,
+    "lines_selected": 16,
+    "snippets": 1,
+    "elapsed_ms": 3.397
+  }
+}
diff --git a/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/offline/run-manifest.json b/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/offline/run-manifest.json
new file mode 100644
index 00000000..685a84ab
--- /dev/null
+++ b/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/offline/run-manifest.json
@@ -0,0 +1,16 @@
+{
+  "schema_version": 1,
+  "mode": "offline",
+  "query": "Help me optimize the websocket connection implementation",
+  "model": "offline-lexical-fixture",
+  "thresholds": {
+    "directory": 0.35,
+    "file": 0.5,
+    "line": 0.6
+  },
+  "batch_size": 48,
+  "github_run_id": "35820001391",
+  "github_run_attempt": "1",
+  "commit_sha": "fbf5c0f981e65a0d88ecb76ff8a8c9ea04958057",
+  "ref_name": "research/system-one-code-localization"
+}
diff --git a/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/offline/run.log b/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/offline/run.log
new file mode 100644
index 00000000..f920e198
--- /dev/null
+++ b/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/offline/run.log
@@ -0,0 +1,33 @@
+relevant directories:
+  0.840 web/src
+  0.840 web/src/ws
+  0.620 server
+  0.620 server/src
+  0.620 web
+  0.620 web/src/api
+relevant files:
+  0.840 web/src/ws/client.ts
+  0.620 server/src/http.ts
+  0.620 web/src/api/user.ts
+relevant snippets:
+  0.960 web/src/ws/client.ts:1-19
+1: export class WebSocketClient {
+2:   private socket?: WebSocket;
+3:   private reconnectTimer?: ReturnType<typeof setTimeout>;
+4: 
+5:   connect(url: string) {
+6:     this.socket = new WebSocket(url);
+7:     this.socket.onopen = () => this.clearReconnect();
+8:     this.socket.onclose = () => this.scheduleReconnect(url);
+9:     this.socket.onerror = () => this.socket?.close();
+10:   }
+11: 
+12:   private scheduleReconnect(url: string) {
+13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);
+14:   }
+15: 
+16:   private clearReconnect() {
+17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);
+18:   }
+19: }
+metrics: {"model_calls": 0, "input_tokens": 0, "output_tokens": 0, "directories_exposed": 6, "directories_selected": 6, "files_exposed": 3, "files_selected": 3, "lines_exposed": 23, "lines_selected": 16, "snippets": 1, "elapsed_ms": 3.397}
diff --git a/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/offline/summary.md b/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/offline/summary.md
new file mode 100644
index 00000000..ffb3fc84
--- /dev/null
+++ b/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/offline/summary.md
@@ -0,0 +1,7 @@
+# System One Code Locator — offline fixture
+
+- Query: `Help me optimize the websocket connection implementation`
+- Directories: 6
+- Files: 3
+- Snippets: 1
+- Metrics: `{'model_calls': 0, 'input_tokens': 0, 'output_tokens': 0, 'directories_exposed': 6, 'directories_selected': 6, 'files_exposed': 3, 'files_selected': 3, 'lines_exposed': 23, 'lines_selected': 16, 'snippets': 1, 'elapsed_ms': 3.397}`
diff --git a/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/offline/tests.log b/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/offline/tests.log
new file mode 100644
index 00000000..75e04e3f
--- /dev/null
+++ b/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/offline/tests.log
@@ -0,0 +1,7 @@
+test_progressive_localization (test_system_one_code_locator.DemoTest.test_progressive_localization) ... ok
+test_request_uses_noul (test_system_one_code_locator.DemoTest.test_request_uses_noul) ... ok
+
+----------------------------------------------------------------------
+Ran 2 tests in 0.009s
+
+OK
diff --git a/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/offline/trace.jsonl b/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/offline/trace.jsonl
new file mode 100644
index 00000000..10036c68
--- /dev/null
+++ b/research/code-locator/runs/20260923T125121+0800-run-35820001391-attempt-1/offline/trace.jsonl
@@ -0,0 +1,17 @@
+{"event": "search_started", "model": "offline-lexical-fixture", "query": "Help me optimize the websocket connection implementation", "root": "/home/runner/work/narness-engineering/narness-engineering/research/code-locator/fixtures/repository", "thresholds": {"directory": 0.35, "file": 0.5, "line": 0.6}, "timestamp": "2026-09-23T04:51:10.419056+00:00"}
+{"candidates": [{"id": "server", "payload": {"child_directories": ["src"], "direct_files": [], "name": "server", "path": "server"}}, {"id": "server/src", "payload": {"child_directories": [], "direct_files": ["http.ts"], "name": "src", "path": "server/src"}}, {"id": "web", "payload": {"child_directories": ["src"], "direct_files": [], "name": "web", "path": "web"}}, {"id": "web/src", "payload": {"child_directories": ["api", "ws"], "direct_files": [], "name": "src", "path": "web/src"}}, {"id": "web/src/api", "payload": {"child_directories": [], "direct_files": ["user.ts"], "name": "api", "path": "web/src/api"}}, {"id": "web/src/ws", "payload": {"child_directories": [], "direct_files": ["client.ts"], "name": "ws", "path": "web/src/ws"}}], "count": 6, "event": "candidates_exposed", "stage": "directory", "timestamp": "2026-09-23T04:51:10.419665+00:00"}
+{"event": "offline_scores", "scores": [{"id": "web/src", "score": 0.84}, {"id": "web/src/ws", "score": 0.84}, {"id": "server", "score": 0.62}, {"id": "server/src", "score": 0.62}, {"id": "web", "score": 0.62}, {"id": "web/src/api", "score": 0.62}], "stage": "directory", "timestamp": "2026-09-23T04:51:10.419878+00:00"}
+{"event": "threshold_applied", "input_count": 6, "selected": [{"id": "web/src", "payload": {"child_directories": ["api", "ws"], "direct_files": [], "name": "src", "path": "web/src"}, "score": 0.84}, {"id": "web/src/ws", "payload": {"child_directories": [], "direct_files": ["client.ts"], "name": "ws", "path": "web/src/ws"}, "score": 0.84}, {"id": "server", "payload": {"child_directories": ["src"], "direct_files": [], "name": "server", "path": "server"}, "score": 0.62}, {"id": "server/src", "payload": {"child_directories": [], "direct_files": ["http.ts"], "name": "src", "path": "server/src"}, "score": 0.62}, {"id": "web", "payload": {"child_directories": ["src"], "direct_files": [], "name": "web", "path": "web"}, "score": 0.62}, {"id": "web/src/api", "payload": {"child_directories": [], "direct_files": ["user.ts"], "name": "api", "path": "web/src/api"}, "score": 0.62}], "selected_count": 6, "stage": "directory", "threshold": 0.35, "timestamp": "2026-09-23T04:51:10.419941+00:00"}
+{"candidates": [{"id": "server/src/http.ts", "payload": {"extension": ".ts", "filename": "http.ts", "path": "server/src/http.ts", "size_bytes": 76}}, {"id": "web/src/api/user.ts", "payload": {"extension": ".ts", "filename": "user.ts", "path": "web/src/api/user.ts", "size_bytes": 125}}, {"id": "web/src/ws/client.ts", "payload": {"extension": ".ts", "filename": "client.ts", "path": "web/src/ws/client.ts", "size_bytes": 573}}], "count": 3, "event": "candidates_exposed", "stage": "file", "timestamp": "2026-09-23T04:51:10.420817+00:00"}
+{"event": "offline_scores", "scores": [{"id": "web/src/ws/client.ts", "score": 0.84}, {"id": "server/src/http.ts", "score": 0.62}, {"id": "web/src/api/user.ts", "score": 0.62}], "stage": "file", "timestamp": "2026-09-23T04:51:10.420917+00:00"}
+{"event": "threshold_applied", "input_count": 3, "selected": [{"id": "web/src/ws/client.ts", "payload": {"extension": ".ts", "filename": "client.ts", "path": "web/src/ws/client.ts", "size_bytes": 573}, "score": 0.84}, {"id": "server/src/http.ts", "payload": {"extension": ".ts", "filename": "http.ts", "path": "server/src/http.ts", "size_bytes": 76}, "score": 0.62}, {"id": "web/src/api/user.ts", "payload": {"extension": ".ts", "filename": "user.ts", "path": "web/src/api/user.ts", "size_bytes": 125}, "score": 0.62}], "selected_count": 3, "stage": "file", "threshold": 0.5, "timestamp": "2026-09-23T04:51:10.420969+00:00"}
+{"candidates": [{"id": "web/src/ws/client.ts:1", "payload": {"line": 1, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;", "path": "web/src/ws/client.ts", "text": "export class WebSocketClient {"}}, {"id": "web/src/ws/client.ts:2", "payload": {"line": 2, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: ", "path": "web/src/ws/client.ts", "text": "  private socket?: WebSocket;"}}, {"id": "web/src/ws/client.ts:3", "payload": {"line": 3, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {", "path": "web/src/ws/client.ts", "text": "  private reconnectTimer?: ReturnType<typeof setTimeout>;"}}, {"id": "web/src/ws/client.ts:5", "payload": {"line": 5, "nearby_lines": "3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();", "path": "web/src/ws/client.ts", "text": "  connect(url: string) {"}}, {"id": "web/src/ws/client.ts:6", "payload": {"line": 6, "nearby_lines": "4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);", "path": "web/src/ws/client.ts", "text": "    this.socket = new WebSocket(url);"}}, {"id": "web/src/ws/client.ts:7", "payload": {"line": 7, "nearby_lines": "5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();", "path": "web/src/ws/client.ts", "text": "    this.socket.onopen = () => this.clearReconnect();"}}, {"id": "web/src/ws/client.ts:8", "payload": {"line": 8, "nearby_lines": "6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }", "path": "web/src/ws/client.ts", "text": "    this.socket.onclose = () => this.scheduleReconnect(url);"}}, {"id": "web/src/ws/client.ts:9", "payload": {"line": 9, "nearby_lines": "7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: ", "path": "web/src/ws/client.ts", "text": "    this.socket.onerror = () => this.socket?.close();"}}, {"id": "web/src/ws/client.ts:10", "payload": {"line": 10, "nearby_lines": "8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: \n12:   private scheduleReconnect(url: string) {", "path": "web/src/ws/client.ts", "text": "  }"}}, {"id": "web/src/ws/client.ts:12", "payload": {"line": 12, "nearby_lines": "10:   }\n11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }", "path": "web/src/ws/client.ts", "text": "  private scheduleReconnect(url: string) {"}}, {"id": "web/src/ws/client.ts:13", "payload": {"line": 13, "nearby_lines": "11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: ", "path": "web/src/ws/client.ts", "text": "    this.reconnectTimer = setTimeout(() => this.connect(url), 1000);"}}, {"id": "web/src/ws/client.ts:14", "payload": {"line": 14, "nearby_lines": "12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: \n16:   private clearReconnect() {", "path": "web/src/ws/client.ts", "text": "  }"}}, {"id": "web/src/ws/client.ts:16", "payload": {"line": 16, "nearby_lines": "14:   }\n15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }", "path": "web/src/ws/client.ts", "text": "  private clearReconnect() {"}}, {"id": "web/src/ws/client.ts:17", "payload": {"line": 17, "nearby_lines": "15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "    if (this.reconnectTimer) clearTimeout(this.reconnectTimer);"}}, {"id": "web/src/ws/client.ts:18", "payload": {"line": 18, "nearby_lines": "16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "  }"}}, {"id": "web/src/ws/client.ts:19", "payload": {"line": 19, "nearby_lines": "17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "}"}}], "count": 16, "event": "candidates_exposed", "parent": "web/src/ws/client.ts", "stage": "line", "timestamp": "2026-09-23T04:51:10.421192+00:00"}
+{"event": "offline_scores", "scores": [{"id": "web/src/ws/client.ts:1", "score": 0.96}, {"id": "web/src/ws/client.ts:10", "score": 0.96}, {"id": "web/src/ws/client.ts:12", "score": 0.96}, {"id": "web/src/ws/client.ts:13", "score": 0.96}, {"id": "web/src/ws/client.ts:14", "score": 0.96}, {"id": "web/src/ws/client.ts:16", "score": 0.96}, {"id": "web/src/ws/client.ts:17", "score": 0.96}, {"id": "web/src/ws/client.ts:18", "score": 0.96}, {"id": "web/src/ws/client.ts:19", "score": 0.96}, {"id": "web/src/ws/client.ts:2", "score": 0.96}, {"id": "web/src/ws/client.ts:3", "score": 0.96}, {"id": "web/src/ws/client.ts:5", "score": 0.96}, {"id": "web/src/ws/client.ts:6", "score": 0.96}, {"id": "web/src/ws/client.ts:7", "score": 0.96}, {"id": "web/src/ws/client.ts:8", "score": 0.96}, {"id": "web/src/ws/client.ts:9", "score": 0.96}], "stage": "line", "timestamp": "2026-09-23T04:51:10.421445+00:00"}
+{"event": "threshold_applied", "input_count": 16, "parent": "web/src/ws/client.ts", "selected": [{"id": "web/src/ws/client.ts:1", "payload": {"line": 1, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;", "path": "web/src/ws/client.ts", "text": "export class WebSocketClient {"}, "score": 0.96}, {"id": "web/src/ws/client.ts:10", "payload": {"line": 10, "nearby_lines": "8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: \n12:   private scheduleReconnect(url: string) {", "path": "web/src/ws/client.ts", "text": "  }"}, "score": 0.96}, {"id": "web/src/ws/client.ts:12", "payload": {"line": 12, "nearby_lines": "10:   }\n11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }", "path": "web/src/ws/client.ts", "text": "  private scheduleReconnect(url: string) {"}, "score": 0.96}, {"id": "web/src/ws/client.ts:13", "payload": {"line": 13, "nearby_lines": "11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: ", "path": "web/src/ws/client.ts", "text": "    this.reconnectTimer = setTimeout(() => this.connect(url), 1000);"}, "score": 0.96}, {"id": "web/src/ws/client.ts:14", "payload": {"line": 14, "nearby_lines": "12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: \n16:   private clearReconnect() {", "path": "web/src/ws/client.ts", "text": "  }"}, "score": 0.96}, {"id": "web/src/ws/client.ts:16", "payload": {"line": 16, "nearby_lines": "14:   }\n15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }", "path": "web/src/ws/client.ts", "text": "  private clearReconnect() {"}, "score": 0.96}, {"id": "web/src/ws/client.ts:17", "payload": {"line": 17, "nearby_lines": "15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "    if (this.reconnectTimer) clearTimeout(this.reconnectTimer);"}, "score": 0.96}, {"id": "web/src/ws/client.ts:18", "payload": {"line": 18, "nearby_lines": "16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "  }"}, "score": 0.96}, {"id": "web/src/ws/client.ts:19", "payload": {"line": 19, "nearby_lines": "17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "path": "web/src/ws/client.ts", "text": "}"}, "score": 0.96}, {"id": "web/src/ws/client.ts:2", "payload": {"line": 2, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: ", "path": "web/src/ws/client.ts", "text": "  private socket?: WebSocket;"}, "score": 0.96}, {"id": "web/src/ws/client.ts:3", "payload": {"line": 3, "nearby_lines": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {", "path": "web/src/ws/client.ts", "text": "  private reconnectTimer?: ReturnType<typeof setTimeout>;"}, "score": 0.96}, {"id": "web/src/ws/client.ts:5", "payload": {"line": 5, "nearby_lines": "3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();", "path": "web/src/ws/client.ts", "text": "  connect(url: string) {"}, "score": 0.96}, {"id": "web/src/ws/client.ts:6", "payload": {"line": 6, "nearby_lines": "4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);", "path": "web/src/ws/client.ts", "text": "    this.socket = new WebSocket(url);"}, "score": 0.96}, {"id": "web/src/ws/client.ts:7", "payload": {"line": 7, "nearby_lines": "5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();", "path": "web/src/ws/client.ts", "text": "    this.socket.onopen = () => this.clearReconnect();"}, "score": 0.96}, {"id": "web/src/ws/client.ts:8", "payload": {"line": 8, "nearby_lines": "6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }", "path": "web/src/ws/client.ts", "text": "    this.socket.onclose = () => this.scheduleReconnect(url);"}, "score": 0.96}, {"id": "web/src/ws/client.ts:9", "payload": {"line": 9, "nearby_lines": "7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: ", "path": "web/src/ws/client.ts", "text": "    this.socket.onerror = () => this.socket?.close();"}, "score": 0.96}], "selected_count": 16, "stage": "line", "threshold": 0.6, "timestamp": "2026-09-23T04:51:10.421515+00:00"}
+{"candidates": [{"id": "server/src/http.ts:1", "payload": {"line": 1, "nearby_lines": "1: export function startHttpServer() {\n2:   console.log('http server started');\n3: }", "path": "server/src/http.ts", "text": "export function startHttpServer() {"}}, {"id": "server/src/http.ts:2", "payload": {"line": 2, "nearby_lines": "1: export function startHttpServer() {\n2:   console.log('http server started');\n3: }", "path": "server/src/http.ts", "text": "  console.log('http server started');"}}, {"id": "server/src/http.ts:3", "payload": {"line": 3, "nearby_lines": "1: export function startHttpServer() {\n2:   console.log('http server started');\n3: }", "path": "server/src/http.ts", "text": "}"}}], "count": 3, "event": "candidates_exposed", "parent": "server/src/http.ts", "stage": "line", "timestamp": "2026-09-23T04:51:10.421820+00:00"}
+{"event": "offline_scores", "scores": [{"id": "server/src/http.ts:1", "score": 0.05}, {"id": "server/src/http.ts:2", "score": 0.05}, {"id": "server/src/http.ts:3", "score": 0.05}], "stage": "line", "timestamp": "2026-09-23T04:51:10.421918+00:00"}
+{"event": "threshold_applied", "input_count": 3, "parent": "server/src/http.ts", "selected": [], "selected_count": 0, "stage": "line", "threshold": 0.6, "timestamp": "2026-09-23T04:51:10.421971+00:00"}
+{"candidates": [{"id": "web/src/api/user.ts:1", "payload": {"line": 1, "nearby_lines": "1: export async function loadUser(id: string) {\n2:   const response = await fetch(`/api/users/${id}`);\n3:   return response.json();", "path": "web/src/api/user.ts", "text": "export async function loadUser(id: string) {"}}, {"id": "web/src/api/user.ts:2", "payload": {"line": 2, "nearby_lines": "1: export async function loadUser(id: string) {\n2:   const response = await fetch(`/api/users/${id}`);\n3:   return response.json();\n4: }", "path": "web/src/api/user.ts", "text": "  const response = await fetch(`/api/users/${id}`);"}}, {"id": "web/src/api/user.ts:3", "payload": {"line": 3, "nearby_lines": "1: export async function loadUser(id: string) {\n2:   const response = await fetch(`/api/users/${id}`);\n3:   return response.json();\n4: }", "path": "web/src/api/user.ts", "text": "  return response.json();"}}, {"id": "web/src/api/user.ts:4", "payload": {"line": 4, "nearby_lines": "2:   const response = await fetch(`/api/users/${id}`);\n3:   return response.json();\n4: }", "path": "web/src/api/user.ts", "text": "}"}}], "count": 4, "event": "candidates_exposed", "parent": "web/src/api/user.ts", "stage": "line", "timestamp": "2026-09-23T04:51:10.422113+00:00"}
+{"event": "offline_scores", "scores": [{"id": "web/src/api/user.ts:1", "score": 0.05}, {"id": "web/src/api/user.ts:2", "score": 0.05}, {"id": "web/src/api/user.ts:3", "score": 0.05}, {"id": "web/src/api/user.ts:4", "score": 0.05}], "stage": "line", "timestamp": "2026-09-23T04:51:10.422236+00:00"}
+{"event": "threshold_applied", "input_count": 4, "parent": "web/src/api/user.ts", "selected": [], "selected_count": 0, "stage": "line", "threshold": 0.6, "timestamp": "2026-09-23T04:51:10.422287+00:00"}
+{"event": "search_completed", "result": {"directories": [{"id": "web/src", "payload": {"child_directories": ["api", "ws"], "direct_files": [], "name": "src", "path": "web/src"}, "score": 0.84}, {"id": "web/src/ws", "payload": {"child_directories": [], "direct_files": ["client.ts"], "name": "ws", "path": "web/src/ws"}, "score": 0.84}, {"id": "server", "payload": {"child_directories": ["src"], "direct_files": [], "name": "server", "path": "server"}, "score": 0.62}, {"id": "server/src", "payload": {"child_directories": [], "direct_files": ["http.ts"], "name": "src", "path": "server/src"}, "score": 0.62}, {"id": "web", "payload": {"child_directories": ["src"], "direct_files": [], "name": "web", "path": "web"}, "score": 0.62}, {"id": "web/src/api", "payload": {"child_directories": [], "direct_files": ["user.ts"], "name": "api", "path": "web/src/api"}, "score": 0.62}], "files": [{"id": "web/src/ws/client.ts", "payload": {"extension": ".ts", "filename": "client.ts", "path": "web/src/ws/client.ts", "size_bytes": 573}, "score": 0.84}, {"id": "server/src/http.ts", "payload": {"extension": ".ts", "filename": "http.ts", "path": "server/src/http.ts", "size_bytes": 76}, "score": 0.62}, {"id": "web/src/api/user.ts", "payload": {"extension": ".ts", "filename": "user.ts", "path": "web/src/api/user.ts", "size_bytes": 125}, "score": 0.62}], "metrics": {"directories_exposed": 6, "directories_selected": 6, "elapsed_ms": 3.397, "files_exposed": 3, "files_selected": 3, "input_tokens": 0, "lines_exposed": 23, "lines_selected": 16, "model_calls": 0, "output_tokens": 0, "snippets": 1}, "model": "offline-lexical-fixture", "query": "Help me optimize the websocket connection implementation", "root": "/home/runner/work/narness-engineering/narness-engineering/research/code-locator/fixtures/repository", "snippets": [{"content": "1: export class WebSocketClient {\n2:   private socket?: WebSocket;\n3:   private reconnectTimer?: ReturnType<typeof setTimeout>;\n4: \n5:   connect(url: string) {\n6:     this.socket = new WebSocket(url);\n7:     this.socket.onopen = () => this.clearReconnect();\n8:     this.socket.onclose = () => this.scheduleReconnect(url);\n9:     this.socket.onerror = () => this.socket?.close();\n10:   }\n11: \n12:   private scheduleReconnect(url: string) {\n13:     this.reconnectTimer = setTimeout(() => this.connect(url), 1000);\n14:   }\n15: \n16:   private clearReconnect() {\n17:     if (this.reconnectTimer) clearTimeout(this.reconnectTimer);\n18:   }\n19: }", "end_line": 19, "path": "web/src/ws/client.ts", "score": 0.96, "start_line": 1}], "thresholds": {"directory": 0.35, "file": 0.5, "line": 0.6}}, "timestamp": "2026-09-23T04:51:10.422385+00:00"}
diff --git a/research/code-locator/src/system_one_code_locator.py b/research/code-locator/src/system_one_code_locator.py
new file mode 100644
index 00000000..60b90a80
--- /dev/null
+++ b/research/code-locator/src/system_one_code_locator.py
@@ -0,0 +1,189 @@
+#!/usr/bin/env python3
+"""System One progressive code-localization research demo."""
+from __future__ import annotations
+import argparse, json, os, re, sys, time, urllib.error, urllib.request
+from datetime import datetime, timezone
+from pathlib import Path
+
+API_URL = "https://api.typesafe.ai/v1/systemone"
+MODEL = "jev-latest"
+IGNORE = {".git", ".idea", ".vscode", ".venv", "node_modules", "target", "dist", "build", "__pycache__"}
+SUFFIXES = {".py", ".rs", ".go", ".java", ".ts", ".tsx", ".js", ".jsx", ".vue", ".proto", ".sql", ".sh", ".yaml", ".yml", ".toml", ".md"}
+
+class Trace:
+    def __init__(self, path):
+        self.path = Path(path) if path else None
+        if self.path:
+            self.path.parent.mkdir(parents=True, exist_ok=True)
+            self.path.write_text("")
+    def emit(self, event, **data):
+        if self.path:
+            record = {"timestamp": datetime.now(timezone.utc).isoformat(), "event": event, **data}
+            with self.path.open("a", encoding="utf-8") as f:
+                f.write(json.dumps(record, ensure_ascii=False, sort_keys=True) + "\n")
+
+def model_projection(stage, payload):
+    """Project raw candidates into a transport-safe semantic view for the model.
+
+    Raw candidates remain in the local evidence trace. Source-line projections
+    normalize literal values so repository security tests do not look like live
+    attack payloads to an upstream WAF, while identifiers and code structure
+    remain visible to System One.
+    """
+    if stage != "line":
+        return payload
+    projected = dict(payload)
+    patterns = [
+        (r'"(?:\\.|[^"\\])*"', '"<string>"'),
+        (r"'(?:\\.|[^'\\])*'", "'<string>'"),
+        (r'`(?:\\.|[^`\\])*`', '`<string>`'),
+    ]
+    for key in ("text", "nearby_lines"):
+        value = projected.get(key)
+        if not isinstance(value, str):
+            continue
+        for pattern, replacement in patterns:
+            value = re.sub(pattern, replacement, value)
+        projected[key] = value
+    return projected
+
+class SystemOneScorer:
+    def __init__(self, key, trace, endpoint=API_URL, model=MODEL, batch_size=48):
+        self.key, self.trace, self.endpoint, self.model, self.batch_size = key, trace, endpoint, model, batch_size
+    def _request(self, payload):
+        body = json.dumps(payload).encode()
+        for attempt in range(4):
+            req = urllib.request.Request(self.endpoint, data=body, method="POST", headers={"Authorization": f"Bearer {self.key}", "Content-Type": "application/json"})
+            try:
+                with urllib.request.urlopen(req, timeout=60) as resp:
+                    return json.loads(resp.read().decode())
+            except urllib.error.HTTPError as exc:
+                detail = exc.read().decode(errors="replace")
+                if exc.code not in {429, 529}: raise RuntimeError(f"TypeSafe HTTP {exc.code}: {detail}") from exc
+                if attempt == 3: raise RuntimeError(f"TypeSafe HTTP {exc.code}: {detail}") from exc
+                time.sleep(2 ** attempt)
+    def score(self, query, stage, candidates):
+        out, usage = [], {"model_calls": 0, "input_tokens": 0, "output_tokens": 0}
+        for offset in range(0, len(candidates), self.batch_size):
+            batch = candidates[offset:offset+self.batch_size]
+            questions = {}
+            for i, candidate in enumerate(batch):
+                questions[f"candidate_{i}"] = {
+                    "type": "noul",
+                    "instructions": {"task": query, "stage": stage, "candidate": model_projection(stage, candidate["payload"]), "question": "Would retaining this candidate materially help locate or understand source code relevant to the task?"},
+                    "criteria": {"true": "Plausibly relevant; keep it, including indirect supporting code.", "false": "Unlikely to help locate or understand the requested implementation."},
+                }
+            payload = {"state": {"goal": query, "stage": stage, "candidate_count": len(batch)}, "model": self.model, "questions": questions}
+            self.trace.emit("system_one_request", stage=stage, batch=offset//self.batch_size, candidate_ids=[x["id"] for x in batch], request=payload)
+            started = time.perf_counter(); response = self._request(payload); latency = round((time.perf_counter()-started)*1000, 3)
+            u = response.get("usage", {}); usage["model_calls"] += 1
+            usage["input_tokens"] += int(u.get("input_tokens", 0) or 0); usage["output_tokens"] += int(u.get("output_tokens", 0) or 0)
+            scores = []
+            for i, candidate in enumerate(batch):
+                answer = response.get("answers", {}).get(f"candidate_{i}", {})
+                if answer.get("type") != "noul": raise RuntimeError(f"unexpected answer: {answer!r}")
+                item = {**candidate, "score": float(answer["noul"])}; out.append(item); scores.append({"id": item["id"], "score": item["score"]})
+            self.trace.emit("system_one_response", stage=stage, batch=offset//self.batch_size, latency_ms=latency, model=response.get("model"), usage=u, scores=scores)
+        return sorted(out, key=lambda x: (-x["score"], x["id"])), usage
+
+class OfflineScorer:
+    model = "offline-lexical-fixture"
+    def __init__(self, trace): self.trace = trace
+    def score(self, query, stage, candidates):
+        tokens = set(re.findall(r"[a-zA-Z][a-zA-Z0-9_]+", query.lower()))
+        if "websocket" in tokens: tokens |= {"ws", "socket", "connect", "connection", "reconnect"}
+        out = []
+        for c in candidates:
+            text = json.dumps(c["payload"]).lower(); hits = sum(t in text for t in tokens if len(t) >= 2)
+            score = 0.05 if hits == 0 else 0.62 if hits == 1 else 0.84 if hits == 2 else 0.96
+            out.append({**c, "score": score})
+        out.sort(key=lambda x: (-x["score"], x["id"])); self.trace.emit("offline_scores", stage=stage, scores=[{"id":x["id"],"score":x["score"]} for x in out])
+        return out, {"model_calls":0,"input_tokens":0,"output_tokens":0}
+
+def directories(root):
+    root = Path(root).resolve(); out = []
+    for current, dirs, files in os.walk(root):
+        dirs[:] = sorted(d for d in dirs if d not in IGNORE and not d.startswith("."))
+        p = Path(current)
+        if p == root: continue
+        rel = p.relative_to(root).as_posix()
+        out.append({"id": rel, "payload": {"path": rel, "name": p.name, "child_directories": dirs[:24], "direct_files": sorted(f for f in files if not f.startswith("."))[:40]}})
+    return out
+
+def files(root, selected_dirs):
+    root = Path(root).resolve(); found = {}
+    for d in selected_dirs:
+        base = root / d["payload"]["path"]
+        for current, dirs, names in os.walk(base):
+            dirs[:] = sorted(x for x in dirs if x not in IGNORE and not x.startswith("."))
+            for name in names:
+                p = Path(current) / name
+                if name.startswith(".") or p.suffix.lower() not in SUFFIXES: continue
+                try: size = p.stat().st_size
+                except OSError: continue
+                rel = p.relative_to(root).as_posix()
+                found[rel] = {"id": rel, "payload": {"path": rel, "filename": name, "extension": p.suffix.lower(), "size_bytes": size}}
+    return [found[k] for k in sorted(found)]
+
+def lines(root, file, radius=2):
+    path = Path(root).resolve() / file["payload"]["path"]
+    source = path.read_text(encoding="utf-8", errors="replace").splitlines(); out = []
+    for i, line in enumerate(source):
+        if not line.strip(): continue
+        start, end = max(0, i-radius), min(len(source), i+radius+1)
+        context = "\n".join(f"{n+1}: {source[n]}" for n in range(start, end))
+        out.append({"id": f"{file['id']}:{i+1}", "payload": {"path": file["payload"]["path"], "line": i+1, "text": line[:1200], "nearby_lines": context[:6000]}})
+    return out
+
+def snippets(root, path, scored, threshold, radius=2):
+    relevant = sorted((x for x in scored if x["score"] >= threshold), key=lambda x: x["payload"]["line"])
+    if not relevant: return []
+    source = (Path(root).resolve()/path).read_text(encoding="utf-8", errors="replace").splitlines(); ranges=[]
+    for item in relevant:
+        line=item["payload"]["line"]; start=max(1,line-radius); end=min(len(source),line+radius)
+        if ranges and start <= ranges[-1][1]+1: ranges[-1]=(ranges[-1][0], max(ranges[-1][1],end), max(ranges[-1][2],item["score"]))
+        else: ranges.append((start,end,item["score"]))
+    return [{"path":path,"start_line":s,"end_line":e,"score":score,"content":"\n".join(f"{n}: {source[n-1]}" for n in range(s,e+1))} for s,e,score in ranges]
+
+def run(root, query, scorer, trace, dt, ft, lt):
+    started=time.perf_counter(); usage={"model_calls":0,"input_tokens":0,"output_tokens":0}
+    def stage(name, candidates, threshold):
+        trace.emit("candidates_exposed", stage=name, count=len(candidates), candidates=candidates)
+        scored,u=scorer.score(query,name,candidates)
+        for k in usage: usage[k]+=u[k]
+        selected=[x for x in scored if x["score"]>=threshold]
+        trace.emit("threshold_applied", stage=name, threshold=threshold, input_count=len(scored), selected_count=len(selected), selected=selected)
+        return selected
+    trace.emit("search_started", root=str(Path(root).resolve()), query=query, model=scorer.model, thresholds={"directory":dt,"file":ft,"line":lt})
+    directory_candidates=directories(root); ds=stage("directory", directory_candidates, dt)
+    file_candidates=files(root,ds); fs=stage("file", file_candidates, ft); ss=[]; line_count=0; line_kept=0
+    for f in fs:
+        lc=lines(root,f); line_count += len(lc)
+        trace.emit("candidates_exposed", stage="line", parent=f["id"], count=len(lc), candidates=lc)
+        scored,u=scorer.score(query,"line",lc)
+        for k in usage: usage[k]+=u[k]
+        kept=[x for x in scored if x["score"]>=lt]; line_kept += len(kept)
+        trace.emit("threshold_applied", stage="line", parent=f["id"], threshold=lt, input_count=len(scored), selected_count=len(kept), selected=kept)
+        ss += snippets(root,f["payload"]["path"],scored,lt)
+    ss.sort(key=lambda x:(-x["score"],x["path"],x["start_line"]))
+    result={"query":query,"root":str(Path(root).resolve()),"model":scorer.model,"thresholds":{"directory":dt,"file":ft,"line":lt},"directories":ds,"files":fs,"snippets":ss,"metrics":{**usage,"directories_exposed":len(directory_candidates),"directories_selected":len(ds),"files_exposed":len(file_candidates),"files_selected":len(fs),"lines_exposed":line_count,"lines_selected":line_kept,"snippets":len(ss),"elapsed_ms":round((time.perf_counter()-started)*1000,3)}}
+    trace.emit("search_completed", result=result); return result
+
+def main(argv=None):
+    p=argparse.ArgumentParser(); p.add_argument("root"); p.add_argument("query"); p.add_argument("--directory-threshold",type=float,default=.35); p.add_argument("--file-threshold",type=float,default=.50); p.add_argument("--line-threshold",type=float,default=.70); p.add_argument("--batch-size",type=int,default=48); p.add_argument("--offline-decider",action="store_true"); p.add_argument("--trace-file"); p.add_argument("--output-json"); p.add_argument("--json",action="store_true"); p.add_argument("--typesafe-endpoint",default=os.getenv("TYPESAFE_API_URL",API_URL)); p.add_argument("--model",default=os.getenv("TYPESAFE_MODEL",MODEL)); a=p.parse_args(argv)
+    trace=Trace(a.trace_file)
+    if a.offline_decider: scorer=OfflineScorer(trace)
+    else:
+        key=os.getenv("TYPESAFE_API_KEY","")
+        if not key: print("TYPESAFE_API_KEY is required unless --offline-decider is used.",file=sys.stderr); return 2
+        scorer=SystemOneScorer(key,trace,a.typesafe_endpoint,a.model,a.batch_size)
+    result=run(a.root,a.query,scorer,trace,a.directory_threshold,a.file_threshold,a.line_threshold); payload=json.dumps(result,indent=2,ensure_ascii=False)
+    if a.output_json: Path(a.output_json).write_text(payload+"\n",encoding="utf-8")
+    if a.json: print(payload)
+    else:
+        print("relevant directories:"); [print(f"  {x['score']:.3f} {x['id']}") for x in result["directories"]]
+        print("relevant files:"); [print(f"  {x['score']:.3f} {x['id']}") for x in result["files"]]
+        print("relevant snippets:"); [print(f"  {x['score']:.3f} {x['path']}:{x['start_line']}-{x['end_line']}\n{x['content']}") for x in result["snippets"]]
+        print("metrics:",json.dumps(result["metrics"],ensure_ascii=False))
+    return 0 if result["files"] and result["snippets"] else 1
+if __name__ == "__main__": raise SystemExit(main())
diff --git a/research/code-locator/tests/test_system_one_code_locator.py b/research/code-locator/tests/test_system_one_code_locator.py
new file mode 100644
index 00000000..6a578311
--- /dev/null
+++ b/research/code-locator/tests/test_system_one_code_locator.py
@@ -0,0 +1,67 @@
+import importlib.util, pathlib, sys, tempfile, unittest
+
+PROJECT_ROOT=pathlib.Path(__file__).resolve().parents[1]
+MODULE_PATH=PROJECT_ROOT/'src'/'system_one_code_locator.py'
+SPEC=importlib.util.spec_from_file_location('system_one_code_locator',MODULE_PATH)
+MODULE=importlib.util.module_from_spec(SPEC)
+sys.modules[SPEC.name]=MODULE
+SPEC.loader.exec_module(MODULE)
+
+class DemoTest(unittest.TestCase):
+    def fixture(self):
+        return PROJECT_ROOT/'fixtures'/'repository'
+
+    def test_progressive_localization(self):
+        with tempfile.TemporaryDirectory() as temp:
+            trace=MODULE.Trace(pathlib.Path(temp)/'trace.jsonl')
+            scorer=MODULE.OfflineScorer(trace)
+            result=MODULE.run(
+                self.fixture(),
+                'Help me optimize the websocket connection implementation',
+                scorer,trace,.35,.50,.60,
+            )
+            self.assertIn('web/src/ws',[x['id'] for x in result['directories']])
+            self.assertIn('web/src/ws/client.ts',[x['id'] for x in result['files']])
+            self.assertTrue(any(
+                x['path']=='web/src/ws/client.ts' and 'WebSocket' in x['content']
+                for x in result['snippets']
+            ))
+            events=[
+                __import__('json').loads(x)['event']
+                for x in pathlib.Path(trace.path).read_text().splitlines()
+            ]
+            self.assertIn('search_started',events)
+            self.assertIn('threshold_applied',events)
+            self.assertIn('search_completed',events)
+
+    def test_request_uses_noul(self):
+        with tempfile.TemporaryDirectory() as temp:
+            trace=MODULE.Trace(pathlib.Path(temp)/'trace.jsonl')
+            scorer=MODULE.SystemOneScorer('test',trace)
+            candidates=[
+                {'id':'web/src/ws','payload':{'path':'web/src/ws'}},
+                {'id':'server','payload':{'path':'server'}},
+            ]
+            scorer._request=lambda payload: {
+                'model':'jev-test',
+                'answers':{
+                    f'candidate_{i}':{'type':'noul','noul':0.5}
+                    for i in range(2)
+                },
+                'usage':{'input_tokens':1,'output_tokens':1},
+            }
+            scored,_=scorer.score('optimize websocket','directory',candidates)
+            self.assertEqual(2,len(scored))
+            records=[
+                __import__('json').loads(x)
+                for x in pathlib.Path(trace.path).read_text().splitlines()
+            ]
+            request=next(
+                x for x in records if x['event']=='system_one_request'
+            )['request']
+            self.assertTrue(all(
+                q['type']=='noul' for q in request['questions'].values()
+            ))
+
+if __name__=='__main__':
+    unittest.main()