AGENTS.md@docker/fixtures git:20261018.7a2e8e2B

Immutable. This exact content never changes and is served at /api/v1/blob/8cbee61055cfba24.

# 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 |
|------|---------|
| `demo-scoped/.pi/dashboard/demo-scoped` | Marker file for project type `demo-scoped` (demo-plugin `projectTypes`). Folder materialized at `/fixtures/demo-scoped`; pinned by `plugin-embedded-app.spec.ts` F3–F5. See change: add-project-scoped-apps. |
| `demo-scoped/README.md` | Describes the `demo-scoped` fixture folder. See change: add-project-scoped-apps. |
| `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. |
| `kb-sample/docs/guide.md` | KB e2e fixture. Uniquely headed "Zanzibar Quokka Protocol" doc for the settings test-search scenario. See change: improve-kb-settings-sources-and-search. |
| `keycloak/README.md` | Importable Keycloak realm reference for identity-plane E2E (§11.2). Dashboard never ships/boots Keycloak; `keycloak-resolver` plugin settings (`packages/keycloak-resolver-plugin/src/configSchema.json`) point at operator IdP. See change: add-multi-user-identity-plane. |
| `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/apply-fix-race.mmd` | Broken `.mmd` (R5) for the real mtime race (X7); restored afterEach. See change: add-preview-apply-fix-to-file. |
| `sample-git/apply-fix.adoc` | AsciiDoc: broken `[source,mermaid]` (R5) + untouched plantuml block. Apply-fix e2e F13; restored afterEach. See change: add-preview-apply-fix-to-file. |
| `sample-git/apply-fix.md` | Markdown fixture: broken mermaid fence (R5) inside a list item. Apply-fix e2e mutates then restores it. Drives `apply-fix-to-file.spec.ts` F11. See change: add-preview-apply-fix-to-file. |
| `sample-git/apply-fix.mmd` | Broken `.mmd` (R5). Apply-fix e2e F12; restored afterEach. See change: add-preview-apply-fix-to-file. |
| `sample-git/doc.pdf` | Binary PDF in git sample fixture. Non-text payload for diff/preview coverage. |
| `sample-git/flow.mmd` | Tiny 3-node mermaid flowchart. Opened via `/session/:id/editor?file=flow.mmd` to exercise `MermaidViewer → MermaidBlock` with no markdown layer in `tests/e2e/mermaid-stability.spec.ts`. See change: fix-markdown-remount-storm. |
| `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/markup-broken.adoc` | AsciiDoc: bare `[mermaid]` `----` block (A1) + unterminated listing before `== Next` (A2). Read-only; drives `markup-repair.spec.ts` F12. See change: add-md-adoc-markup-repair. |
| `sample-git/mermaid-eof.md` | Markdown ending inside an unclosed ```` ```mermaid ```` fence (M1: renders, no endless loading). Read-only; drives `markup-repair.spec.ts` F13. See change: add-md-adoc-markup-repair. |
| `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/repair.adoc` | AsciiDoc fixture with a `[source,mermaid]` flowchart `A[call (x)]-->B` that fails as written; R5 auto-repair renders it. Drives `mermaid-repair.spec.ts`. See change: add-mermaid-auto-repair. |
| `sample-git/repair.md` | Markdown fixture with a ```` ```mermaid ```` flowchart `A[call (x)]-->B` that fails as written; R5 auto-repair renders it. Read-only (not dirtied) so shared-repo specs stay isolated. Drives `mermaid-repair.spec.ts`. See change: add-mermaid-auto-repair. |
| `sample-git/repair.mmd` | Broken `.mmd` flowchart (`A[call (x)]-->B`) fixed by R5 auto-repair in `MermaidViewer → MermaidBlock`. Drives `mermaid-repair.spec.ts`. See change: add-mermaid-auto-repair. |
| `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/sanitize.adoc` | AsciiDoc sanitizer E2E fixture: `:stem: latexmath` + `[stem]` `\sqrt{\frac{a}{b}}` block, `[cols="1,3"]` table (25%/75% col widths), mermaid + plantuml listing blocks. Used by `tests/e2e/asciidoc-preview.spec.ts` F6. See change: sanitize-untrusted-rendered-content. |
| `sample-git/styling.adoc` | AsciiDoc styling E2E fixture (change: asciidoc-support). Declares `:toc:` + 3 nested section levels, a `NOTE:` admonition, a `[frame=none,grid=none]` key/value table, a `[stripes=even,options="header"]` data table and a `[source,ts]` listing — one document covering every `.asciidoc-body` rule `asciidoc-preview.spec.ts` measures. Copied to the session cwd at container start. |
| `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. |