Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 20 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,11 +18,14 @@ on SaaS observability config, especially where the person doing the work is the
| Track | Question | Status |
| --- | --- | --- |
| Track 1 | Do compiled trajectories survive site churn? | Harness in progress — **no gate number yet** |
| Track 2 | Is there a vertical where the counterparty hypothesis holds? | Search in progress |
| Track 3 | Narrative / pitch | Placeholders only until Track 1 + 2 land |
| Track 2 | Is there a vertical where the counterparty hypothesis holds? | **FAIL — no vertical locked** ([C5 DECISION](docs/research/vertical-search/DECISION.md), [ADR-0004](docs/decisions/ADR-0004-vertical-track2-fail.md)) |
| Track 3 | Narrative / pitch | Wave-1 draft in [docs/pitch/](docs/pitch/); all performance claims **[PENDING TRACK-1]** |

Week-0 census (**observability config**): **FAIL** — 2 survivors of 70; archived under
`docs/research/census-week0/`.
Two consecutive vertical FAILs — Week-0 observability config (2 survivors of 70,
archived under [docs/research/census-week0/](docs/research/census-week0/)) and Track-2
counterparty (2 of 75, 0 DURABLE) — mean the company now rests on the Track-1
mechanism number. See
[README-narrative.md §6](docs/README-narrative.md#6-where-evidence-stands-now).

## Public repo — write accordingly

Expand Down Expand Up @@ -50,6 +53,12 @@ npm install
npm run ci
```

`npm run ci` is the one command that must be green before any PR: secret-scan,
contract validation, lint, typecheck, unit tests, then the end-to-end integration
test, in that order. The privacy canary (`npm run test:canary`) is merge-blocking
as a separate CI job. Full command list and the pre-PR checklist:
[docs/DEVELOPMENT.md](docs/DEVELOPMENT.md).

Contracts live in `contracts/`. Wave-1 agents build against those schemas — not
against each other.

Expand All @@ -59,10 +68,17 @@ against each other.
contracts/ # JSON Schema — build against these
src/testbed|recorder|compiler|runner|cache|metrics/
experiments/gate-v1/ # throwaway gate harness
scripts/ # secret-scan, contract validation, branch protection, testbed compose
tests/unit|canary|integration/
artifacts/ # committed compiled bundles
docs/ # map: docs/README.md
archive/ # superseded scaffolds (Python hello) + preserved history
```

How the six packages connect: [docs/architecture.md](docs/architecture.md).
Where the project is and what to pick up next: [docs/ROADMAP.md](docs/ROADMAP.md).
How to run, test, and ship a change: [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md).

## Stack

TypeScript + Node 20+ + Playwright — see [ADR-0001](docs/decisions/ADR-0001-typescript-node-playwright.md).
Expand Down
2 changes: 1 addition & 1 deletion docs/INTEGRITY-AUDIT.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ D2 consolidator pass (2026-07-25), **after** C4 + C5 merges. **Surfaces conflict
| D-01 **FOUNDER** | Historical A7 / early Wave-1 “conditionally credible” seller-portal lead | C4 ALREADY_SOLVED + **C5 FAIL** (do not lock “because A7 said so”) | Adjudicated by C5; residual deck slides may still lag | **Critical** if old pitch used without C5 cite |
| D-02 **FOUNDER** | PRD §8: Grafana Cloud + Datadog anchors | ADR-0003 OSS bed; A8/C5 reject those locks | Residual PRD body | **Critical** |
| D-03 **FOUNDER** | Pitch “no gate number” / unset thresholds | PRD §9 proposed 80/90/~50/70 | Unset measured vs proposed | **High** |
| D-04 | Root README Track 3 “placeholders only” | Pitch pack + C5 on main | Stale status | Medium |
| D-04 | (was) Root README Track 2 “search in progress” / Track 3 “placeholders only” | C5 FAIL + ADR-0004; pitch pack on main | **Resolved** — status table now records Track 2 FAIL and Track 3 Wave-1 draft, each citing the artifact | Resolved in README; deck/objections prose may still lag (D-01, E-12) |
| D-05 | Early D1 proof-points: PRD absent / C5 pending | Files + C5 FAIL on main | Stale diligence | Medium — register refreshed |
| D-06 | PRD §8 “pivot if <~6 survivors” | A8/C5 executed ≤2 FAIL gates | Different fail lines | Medium — historical |
| D-07 | (was) Objections denying two FAILs | A8 + C5 | **Updated in this PR** to present-tense two FAILs | Resolved in objections; deck may lag |
Expand Down
7 changes: 5 additions & 2 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ Integrity surface: **[INTEGRITY-AUDIT.md](./INTEGRITY-AUDIT.md)**.
| [architecture.md](./architecture.md) | How the six `src/` packages connect: loop diagram, package/artifact tables, real vs stubbed, invariants | draft | 2026-07-25 | Owns the **chain** between packages; `gate/*.md` own one hop each. Records two unwired hops (issue #52) |
| [README-narrative.md](./README-narrative.md) | Story: thesis → census kill → pivot → two tracks → evidence now | draft | 2026-07-25 | Includes C5 FAIL |
| [INTEGRITY-AUDIT.md](./INTEGRITY-AUDIT.md) | Unsourced claims, placeholders, LOW load-bearing, contradictions | draft | 2026-07-25 | Surfaces conflicts; does not pick winners |
| [../README.md](../README.md) | Repo root status | living | 2026-07-25 | May lag Track 3 / C5 — see INTEGRITY-AUDIT |
| [../README.md](../README.md) | Repo root status | living | 2026-07-25 (status table refreshed) | Track 2 **FAIL** / Track 3 Wave-1 draft now match C5 + ADR-0004; INTEGRITY-AUDIT D-04 resolved |
| [../CONTRIBUTING.md](../CONTRIBUTING.md) | Hard rules + YAML frontmatter standard | living | 2026-07-24 | Doc-shape source of truth |

---
Expand Down Expand Up @@ -140,7 +140,10 @@ precondition); M5 and M7 can run in parallel; M6 is blocked on the M4 gate numbe

## Open questions / what I could not verify

- Root README Track 2/3 status lines are still stale (INTEGRITY-AUDIT D-04) — tracked as issue #54.
- ~~Root README Track 2/3 status lines are still stale (INTEGRITY-AUDIT D-04) — tracked as issue #54.~~
**Resolved** — the root README status table now records Track 2 as FAIL and Track 3 as a
Wave-1 draft, both citing in-repo artifacts. The residual deck/objections prose flagged by
D-01 and E-12 is a separate, still-open lag.
- Founder post-Track-1 choice (intermediary reframe vs shut search) — C5 next action; not decided in docs.
- Measured gate number — still unset; do not invent.
- Whether to buy GitHub Secret Protection. Non-provider patterns and validity checks are
Expand Down
Loading