jedarden/spaxel
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(bf-5ywk): banner superseded blob-inventory notes, confirm bf-1q3m as sole source

Browse source 
bf-4bhd failed repeatedly because re-dispatched agents trust its stale
"Analysis Report" framing (no supersession marker on the file). Per
notes/bf-1q3m-consolidated.md §4.1, add a visible SUPERSEDED banner to the
top of notes/bf-4bhd.md and notes/bf-3ldj-findings.md naming
notes/bf-1q3m-consolidated.md as the sole trusted blob inventory, stating the
material reasons:
  - bf-4bhd: 2D field-list drift (claims tracking.Blob has PersonName/
    AssignedColor/IdentityResolved — those fields no longer exist) + line
    drift (E2/E3/volume +90, E1 +110) vs HEAD.
  - bf-3ldj: same line drift + a fundamentally wrong "IDENTITY ATTACHED"
    data-flow claim (tracker.TrackManager.UpdateWithIdentity is not wired
    into main.go at HEAD; identity is sidecar-based via ble.IdentityMatcher).

Add proportionate "secondary - see consolidated" banners to the bf-3ldj-input
notes (bf-26ta, bf-67ao, bf-5kns) and bf-26ta's JS/TS result dumps, so no
inventory-titled note remains that a future agent could mistake for
authoritative. notes/bf-1q3m-consolidated.md already declares itself the
single source of truth (header banner + §9 provenance) - confirmed unchanged.

All stale files retained for provenance; none deleted. Docs-only change, no
Go/JS source modified (go vet + go test ./... clean).

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
jedarden 2026-07-06 16:28:00 -04:00
parent 64a2202ac9
commit 1ecc9992d1
7 changed files with 99 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

11
notes/bf-26ta-findings.md
View file

@ -1,4 +1,13 @@
# Blob Literal Locations - Complete Inventory
> ⚠️ **Secondary — folded into the consolidated inventory.** This was an input to
> `notes/bf-3ldj-findings.md`, which is itself **superseded** (see its banner). The
> authoritative blob inventory is **`notes/bf-1q3m-consolidated.md`** — consume that file for
> `file:line` references. Note: `bf-3ldj` §1.2 recorded that **two entries here are stale**
> (`dashboard/js/state.js:290` and `tracking/tracker.go:160`) — do not propagate them.
> Retained for provenance only.
---
# Blob Literal Locations - Complete Inventory (secondary — see banner above)
## Summary

9
notes/bf-26ta-javascript-results.md
View file

@ -1,4 +1,11 @@
# bf-26ta: JavaScript Blob-Shaped Object Literal Search Results
> ⚠️ **Secondary — folded into the consolidated inventory.** Detailed child results of
> `notes/bf-26ta-findings.md` (now secondary). The authoritative JS/TS blob-creation inventory
> is **`notes/bf-1bmg-js-ts.md`** (a blessed child of `notes/bf-1q3m-consolidated.md`, the
> single source of truth). Retained for provenance only.
---
# bf-26ta: JavaScript Blob-Shaped Object Literal Search Results (secondary — see banner above)
## Task Summary
Search all JavaScript files (.js and .jsx) for blob-shaped object literals using the pattern defined in bf-3aij.

9
notes/bf-26ta-typescript-results.md
View file

@ -1,4 +1,11 @@
# bf-26ta: TypeScript Blob-Shaped Object Literal Search Results
> ⚠️ **Secondary — folded into the consolidated inventory.** Detailed child results of
> `notes/bf-26ta-findings.md` (now secondary). The authoritative TS blob-type declaration is
> catalogued in **`notes/bf-1bmg-js-ts.md`** (a blessed child of
> `notes/bf-1q3m-consolidated.md`, the single source of truth). Retained for provenance only.
---
# bf-26ta: TypeScript Blob-Shaped Object Literal Search Results (secondary — see banner above)
## Task Summary
Search all TypeScript files (.ts and .tsx) for blob-shaped object literals.

29
notes/bf-3ldj-findings.md
View file

@ -1,4 +1,31 @@
# Blob Creation Sites — Consolidated Report (bf-3ldj)
> 🔴🔴🔴 **SUPERSEDED — DO NOT USE THIS FILE AS A BLOB INVENTORY.** 🔴🔴🔴
>
> Despite the "Single source of truth" language in the header below, this report has
> **drifted against current HEAD** and is **retained for provenance only**. The **sole trusted
> blob inventory** is **`notes/bf-1q3m-consolidated.md`** — read that file instead and ignore
> the `file:line` references and the data-flow diagram (§6) below.
>
> **Why superseded** (per `notes/bf-1q3m-consolidated.md` §4.1):
>
> 1. **Line drift (+90 / +110).** The named leak-boundary citations are stale: E2 automation
> is actually `main.go:2303` (cited `:2213`, +90), E3 explainability `main.go:2206` (cited
> `:2116`, +90), E1 sigproc `main.go:5494` (cited `:5384`, +110).
> 2. **Fundamental data-flow drift (material).** §6 below draws the live path through
> `tracker.TrackManager.UpdateWithIdentity` → `applyIdentity` and claims "✅ IDENTITY
> ATTACHED." **This path is NOT wired into `main.go` at HEAD** (zero references to
> `tracker.NewTracker` / `TrackManager` / `applyIdentity` / `UpdateWithIdentity`). The live
> identity path is entirely sidecar-based — resolved identity lives in
> `ble.IdentityMatcher`, queried per-blob by ID via `GetMatch()`, and is never written back
> onto the tracked blob struct. So "identity dropped at the conversion" really means
> "the conversion is where identity could be attached from the sidecar, and isn't."
>
> **Status:** provenance only. A future agent must not consume this file for `file:line`
> references or for the data-flow diagram — it will re-introduce the line drift and the
> wrong identity-attachment model. Use `notes/bf-1q3m-consolidated.md`.
---
# Blob Creation Sites — Consolidated Report (bf-3ldj) (SUPERSEDED — see banner above)
> **Purpose:** Single source of truth aggregating the three blob-creation search beads, ready
> for the next bead (parent umbrella `bf-4bhd`, then the implementation bead) to consume.

29
notes/bf-4bhd.md
View file

@ -1,4 +1,31 @@
# Blob Creation Code Paths - Analysis Report
> 🔴🔴🔴 **SUPERSEDED — DO NOT USE THIS FILE AS A BLOB INVENTORY.** 🔴🔴🔴
>
> This report has **drifted against current HEAD** and is **retained for provenance only**.
> The **sole trusted blob inventory** is **`notes/bf-1q3m-consolidated.md`** — read that file
> instead and ignore the `file:line` references below.
>
> **Why superseded** (per `notes/bf-1q3m-consolidated.md` §4.1):
>
> 1. **2D field-list drift (material).** This report claims `tracking.Blob` (2D) carries the
> fields `PersonName`, `AssignedColor`, and `IdentityResolved`. **Those fields no longer
> exist.** At HEAD the 2D identity field set is identical to the 3D type:
> `PersonID / PersonLabel / PersonColor / IdentityConfidence / IdentitySource /
> IdentityLastSeen`. (Verified 2026-07-06.) The "Pattern 1.1" literal below that allegedly
> sets `PersonName:""`, `AssignedColor:""`, `IdentityResolved:false` is therefore wrong —
> the literal sets **none** of the identity fields (Go zero values).
> 2. **Line drift (+90 / +110).** The E1/E2/E3 boundary citations and the projection-table
> lines are all stale: E2 automation is actually `main.go:2303` (cited `:2213`, +90), E3
> explainability `main.go:2206` (cited `:2116`, +90), E1 sigproc `main.go:5494` (cited
> `:5384`, +110), and the projection table's explainability `:2116` / volume `:2236` are
> `:2206` / `:2326` (+90 each).
>
> **Status:** provenance only. A future agent must not consume this file for `file:line`
> references or for the 2D Blob field list — it will re-introduce the very drift this effort
> corrected. Use `notes/bf-1q3m-consolidated.md`.
---
# Blob Creation Code Paths - Analysis Report (SUPERSEDED — see banner above)
## Task: Find all blob creation code paths

10
notes/bf-5kns.md
View file

@ -1,4 +1,12 @@
# Blob Constructor Search Results (bf-5kns)
> ⚠️ **Secondary — folded into the consolidated inventory.** This was an input to
> `notes/bf-3ldj-findings.md`, which is itself **superseded** (see its banner). These four
> `new Blob()` sites are the **browser binary-`Blob` download API** (file payloads, not Spaxel
> domain blobs) and are catalogued as out-of-scope in `notes/bf-1q3m-consolidated.md` §4/§3.5
> — read that file for the authoritative inventory. Retained for provenance only.
---
# Blob Constructor Search Results (bf-5kns) (secondary — see banner above)
## Summary
Found **4 occurrences** of direct `Blob()` constructor calls across **3 files**.

9
notes/bf-67ao-findings.md
View file

@ -1,4 +1,11 @@
# Blob Factory Functions — Analysis Report
> ⚠️ **Secondary — folded into the consolidated inventory.** This was an input to
> `notes/bf-3ldj-findings.md`, which is itself **superseded** (see its banner). The
> authoritative blob inventory is **`notes/bf-1q3m-consolidated.md`** — consume that file for
> `file:line` references. Retained for provenance only.
---
# Blob Factory Functions — Analysis Report (secondary — see banner above)
## Task: bf-67ao — Find all functions/methods that create and return blob objects