AGENTS.md@docker/fixtures git:20260824.881ffdaB

Immutable. This exact content is served forever at /api/v1/blob/c4f0625ed8ab66f1.

# DOX — docker/fixtures

Files in this directory. One row per file. Non-source area. See change: migrate-file-index-to-agents-tree. See change: fold-oversized-agents-directories.

| File | Purpose |
|------|---------|
| `kb-parent/.pi/dashboard/knowledge_base.json` | KB Copy-from-parent e2e fixture: parent repo config. sources:[{kind:filesystem,ref:"."}], origin=project. Worktree copies these sources via Copy-from-parent. Materialized writable at /fixtures/kb-parent by test-entrypoint.sh. See change: add-kb-folder-slot. |
| `kb-parent/gamma.md` | KB Copy-from-parent e2e fixture: parent markdown. Indexable chunk in parent repo. See change: add-kb-folder-slot. |
| `kb-parent/worktrees/kb-wt/delta.md` | KB Copy-from-parent e2e fixture: worktree markdown. Worktree ships NO knowledge_base.json (origin=defaults) until Copy-from-parent seeds sources[]; then reindex over ref "." indexes delta.md. `worktrees/` (not `.worktrees/`) so PathPicker lists it while parentRepoOf still derives /fixtures/kb-parent. See change: add-kb-folder-slot. |
| `kb-sample/.pi/dashboard/knowledge_base.json` | KB e2e fixture config. sources:[{kind:filesystem,ref:"."}] → /fixtures/kb-sample origin=project so folder-slot Index now indexes alpha.md+beta.md. Materialized writable at /fixtures/kb-sample by test-entrypoint.sh cp -a /fixtures-src → /fixtures. See change: add-kb-folder-slot. |
| `kb-sample/alpha.md` | KB e2e fixture markdown. Headings + widgets text → one indexable chunk. See change: add-kb-folder-slot. |
| `kb-sample/beta.md` | KB e2e fixture markdown. Second file → reindex reports 2 changed, chunks>1. See change: add-kb-folder-slot. |
| `make-eml-fixtures.mjs` | Generator for the EML e2e fixtures (`sample-git/rich.eml` + `sample-git/lazy.eml`). Writes multipart/mixed .eml with base64 parts. Run `node docker/fixtures/make-eml-fixtures.mjs`. See change: add-eml-preview. |
| `sample-git/.pi/flows/agents/e2e-alpha.md` | Synthetic e2e flow agent A (change: add-flow-plugin-e2e-tests). Frontmatter `model: @coding` (-> faux/faux-1 via faux role-preset), output `note`; body carries `[[flow-agent:alpha]]` so the faux `flow-agent-branch` scenario branches per agent. First step of the synthetic flow. |
| `sample-git/.pi/flows/agents/e2e-beta.md` | Synthetic e2e flow agent B (change: add-flow-plugin-e2e-tests). Like e2e-alpha with `[[flow-agent:beta]]`; declares input `upstream` (wired from alpha's `note`), output `note`. Terminal step of the synthetic flow. |
| `sample-git/.pi/flows/flows/e2e/synthetic/flow.yaml` | Synthetic 2-agent flow (change: add-flow-plugin-e2e-tests). Command `/e2e:synthetic`. pi-flows 0.3.2 discovers flows as DIRECTORIES (`<ns>/<name>/flow.yaml`) — loose `.yaml` files are ignored; every step needs explicit `type:`. `alpha` -> `beta` (blockedBy), each step task carries `[[faux:flow-agent-branch]]` so the faux provider replays a per-agent finish(); agents resolve to faux/faux-1. Drives flow-roundtrip.spec.ts. |
| `sample-git/doc.pdf` | Binary PDF in git sample fixture. Non-text payload for diff/preview coverage. |
| `sample-git/hello.txt` | Plain file content for git fixture. See change: docker-test-harness. |
| `openspec-board/openspec/config.yaml` | Makes `openspec-board` a valid OpenSpec project (`schema: spec-driven`). DEDICATED board-drop-targeting fixture, separate from `sample-git` so 64 extra cards do not change what every other openspec spec sees from `openspec list --json`. The `board-card-01 … board-card-64` change dirs are GENERATED at container start by `test-entrypoint.sh` (deep enough to overflow a column + the 64-card frame-budget workload) so they stay out of the repo. See change: fix-openspec-board-drop-targeting. |
| `sample-git/lazy.eml` | EML e2e fixture: HTML body + ONE PDF attachment, NO cid/remote refs. Drives the lazy-attachment-fetch assertion (zero `/api/file/eml-attachment` requests until expand). Generated by `make-eml-fixtures.mjs`. See change: add-eml-preview. |
| `sample-git/logo.png` | Binary PNG in git sample fixture. Non-text payload for diff/preview coverage. |
| `sample-git/notes.md` | Second tracked markdown file in the git fixture. Writable via `/api/file/write` (markdown-only) so the uncommitted-indicator E2E can dirty TWO files and commit a subset. See change: add-session-uncommitted-indicator-and-commit. |
| `sample-git/openspec/changes/archive/2026-07-15-e2e-archived-demo/design.md` | Archived-change fixture artifact. Archive-isolation guard (E8). See change: openspec-artifact-dialog-desktop. |
| `sample-git/openspec/changes/archive/2026-07-15-e2e-archived-demo/proposal.md` | Archived-change fixture artifact. Badge opens archive reader, not the dialog (E8). See change: openspec-artifact-dialog-desktop. |
| `sample-git/openspec/changes/archive/2026-07-15-e2e-archived-demo/specs/e2e-demo-cap/spec.md` | Archived-change fixture spec. Renders `S` in archive browser. See change: openspec-artifact-dialog-desktop. |
| `sample-git/openspec/changes/archive/2026-07-15-e2e-archived-demo/tasks.md` | Archived-change fixture tasks. See change: openspec-artifact-dialog-desktop. |
| `sample-git/openspec/changes/e2e-artifact-demo/design.md` | Active-change fixture design artifact → `D` badge. See change: openspec-artifact-dialog-desktop. |
| `sample-git/openspec/changes/e2e-artifact-demo/proposal.md` | Active-change fixture proposal → `P` badge; `openspec list` returns this change. See change: openspec-artifact-dialog-desktop. |
| `sample-git/openspec/changes/e2e-artifact-demo/specs/e2e-demo-cap/spec.md` | Active-change fixture spec → `S` badge + Specs-tab content. See change: openspec-artifact-dialog-desktop. |
| `sample-git/openspec/changes/e2e-artifact-demo/tasks.md` | Active-change fixture tasks → `T` badge (1 unchecked → in-progress). See change: openspec-artifact-dialog-desktop. |
| `sample-git/openspec/config.yaml` | Makes `sample-git` a valid OpenSpec project (`schema: spec-driven`) so `openspec list` yields the demo change → P/D/S/T badges. See change: openspec-artifact-dialog-desktop. |
| `sample-git/README.md` | Plain file content for git fixture (README). See change: docker-test-harness. |
| `sample-git/rich.eml` | EML e2e fixture: XSS subject (`<img onerror>`), body `<script>` + remote tracker `<img>` + `cid:logo@x` in `src` AND `<style> url()`, attachments PNG(cid inline)/PDF/JPEG/DOCX. Drives sandbox/escape/header/attachment/remote/cid e2e scenarios. Generated by `make-eml-fixtures.mjs`. See change: add-eml-preview. |
| `sample-git/tall.md` | Deliberately over-cap markdown (120 sections) for `tests/e2e/overlay-layout.spec.ts`: opened via `/folder/:cwd/view?path=tall.md` to exercise the tall-content half of the flush-dialog gate (panel clamps at `max-h-[92vh]`, a descendant becomes a working scroller). See change: fix-flush-dialog-scroll-and-close-collision. |
| `sample-hook-fail/.pi/settings.json` | E2E fixture: FAILING `worktreeInit` hook. gate `test ! -f .never-created` (always needsInit), run script echoes stderr + `exit 3`. Feeds failed-sticky + Retry assertions. Materialized as git repo by test-entrypoint.sh. See change: friendlier-worktree-init. |
| `sample-hook-fail/README.md` | Doc for the failing hook fixture. See change: friendlier-worktree-init. |
| `sample-hook-ok/.pi/settings.json` | E2E fixture: SLOW-SUCCESS `worktreeInit` hook. gate `test ! -f .initialized`, run script prints progress, `sleep 5`, `touch .initialized` (~5s window so a mid-run reload rehydrates). Named `-ok` (not `sample-hook`) so its basename is not a prefix of `sample-hook-fail` (PathPicker option regex collision). Materialized as git repo by test-entrypoint.sh; untrusted on first load. See change: friendlier-worktree-init. |
| `sample-hook-ok/README.md` | Doc for the slow-success hook fixture. See change: friendlier-worktree-init. |