Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

chore(ok): delete PROJECT.md and STORIES.md, synthetic perf fixtures, fold Q6-Q8 (#4175)

Andrew Mikofalvy658e56f41d77
diff --git a/packages/app/package.json b/packages/app/package.json
index 709ae3e8e..5ba0cd1e9 100644
--- a/packages/app/package.json
+++ b/packages/app/package.json
@@ -35,6 +35,7 @@
"test:visual:update": "playwright test --config playwright.visual.config.ts --update-snapshots",
"test:perf": "vitest run tests/stress/component-blocks.perf.test.ts",
"test:a11y": "playwright test --config playwright.a11y.config.ts",
+ "perf:fixtures": "tsx tests/perf/fixtures/generate.ts",
"perf:profile": "tsx tests/perf/profile.ts",
"sweep:cache-regime": "tsx tests/perf/profile.ts --scenario=sweep-cache-regime",
"sweep:convention-cap-graduation": "tsx tests/perf/profile.ts --scenario=sweep-convention-cap-graduation",
diff --git a/packages/app/scripts/perf-prod.sh b/packages/app/scripts/perf-prod.sh
index 791f22b52..5d4782f9a 100755
--- a/packages/app/scripts/perf-prod.sh
+++ b/packages/app/scripts/perf-prod.sh
@@ -13,7 +13,7 @@
# Examples:
# # G2 regression-gate capture (canonical reference per V2 SPEC §11):
# packages/app/scripts/perf-prod.sh --scenario=cold-pool-warm \
-# --env="OK_PERF_BIG_DOC=STORIES"
+# --env="OK_PERF_BIG_DOC=perf-fixtures/medium-doc"
#
# # G4 mode-toggle with 10 runs:
# packages/app/scripts/perf-prod.sh --scenario=mode-toggle --runs=10
diff --git a/packages/app/src/components/EditorActivityPool.test.ts b/packages/app/src/components/EditorActivityPool.test.ts
index 6d92ff071..279b020e6 100644
--- a/packages/app/src/components/EditorActivityPool.test.ts
+++ b/packages/app/src/components/EditorActivityPool.test.ts
@@ -233,7 +233,7 @@ describe('LARGE_DOC_CHAR_THRESHOLD', () => {
expect(LARGE_DOC_CHAR_THRESHOLD).toBeGreaterThan(200_000);
});
- test('is safely below PROJECT.md-class docs (≥3 MB) so they trigger defer-mount', () => {
+ test('is safely below perf-fixtures/big-doc.md-class docs (≥3 MB) so they trigger defer-mount', () => {
expect(LARGE_DOC_CHAR_THRESHOLD).toBeLessThan(1_000_000);
});
});
diff --git a/packages/app/src/components/EditorActivityPool.tsx b/packages/app/src/components/EditorActivityPool.tsx
index e05cd9f86..b9d38e3c8 100644
--- a/packages/app/src/components/EditorActivityPool.tsx
+++ b/packages/app/src/components/EditorActivityPool.tsx
@@ -90,7 +90,7 @@ const TextDocEditor = lazy(async () => ({
* Value rationale (500_000 chars ≈ 500 KB plain text):
* - README.md / AGENTS.md / CLAUDE.md (≤150 KB) — BELOW. No change from
* pre-mount-both default; toggle stays instant.
- * - PROJECT.md (multi-MB) — ABOVE. Cold load skips the non-active
+ * - perf-fixtures/big-doc.md (3.25 MB, generated) — ABOVE. Cold load skips the non-active
* editor's initial mount+parse; first toggle pays the cost; subsequent
* toggles are instant.
*
diff --git a/packages/app/tests/perf/fixtures/generate.ts b/packages/app/tests/perf/fixtures/generate.ts
new file mode 100644
index 000000000..a8cffcec1
--- /dev/null
+++ b/packages/app/tests/perf/fixtures/generate.ts
@@ -0,0 +1,8 @@
+import { writeSyntheticFixtures } from './synthetic-doc.ts';
+
+const force = process.argv.includes('--force');
+
+for (const result of writeSyntheticFixtures({ force })) {
+ const state = result.written ? `wrote ${result.bytes} bytes` : 'already present, kept';
+ console.log(`${result.path}: ${state}`);
+}
diff --git a/packages/app/tests/perf/fixtures/synthetic-doc.ts b/packages/app/tests/perf/fixtures/synthetic-doc.ts
new file mode 100644
index 000000000..ab278f6e9
--- /dev/null
+++ b/packages/app/tests/perf/fixtures/synthetic-doc.ts
@@ -0,0 +1,319 @@
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+export interface SyntheticDocSpec {
+ readonly docName: string;
+ readonly fileName: string;
+ readonly title: string;
+ readonly targetBytes: number;
+ readonly linkCount: number;
+ readonly wideRowChars: number;
+ readonly seed: number;
+}
+
+export const BIG_DOC: SyntheticDocSpec = {
+ docName: 'perf-fixtures/big-doc',
+ fileName: 'big-doc.md',
+ title: 'Synthetic big document',
+ targetBytes: 3_250_000,
+ linkCount: 768,
+ wideRowChars: 3000,
+ seed: 0x0b16_d0c5,
+};
+
+export const MEDIUM_DOC: SyntheticDocSpec = {
+ docName: 'perf-fixtures/medium-doc',
+ fileName: 'medium-doc.md',
+ title: 'Synthetic medium document',
+ targetBytes: 530_000,
+ linkCount: 176,
+ wideRowChars: 0,
+ seed: 0x0aed_d0c5,
+};
+
+export const SYNTHETIC_DOCS: readonly SyntheticDocSpec[] = [BIG_DOC, MEDIUM_DOC];
+
+const HERE = dirname(fileURLToPath(import.meta.url));
+
+export const FIXTURES_DIR = resolve(HERE, '..', '..', '..', '..', '..', 'perf-fixtures');
+
+const WORDS = [
+ 'anchor',
+ 'baseline',
+ 'branch',
+ 'buffer',
+ 'cache',
+ 'canonical',
+ 'capture',
+ 'channel',
+ 'checkpoint',
+ 'client',
+ 'collaboration',
+ 'commit',
+ 'conflict',
+ 'context',
+ 'cursor',
+ 'decoration',
+ 'delta',
+ 'document',
+ 'editor',
+ 'fragment',
+ 'graph',
+ 'heading',
+ 'history',
+ 'index',
+ 'invariant',
+ 'latency',
+ 'layout',
+ 'lifecycle',
+ 'listener',
+ 'marker',
+ 'merge',
+ 'namespace',
+ 'observer',
+ 'origin',
+ 'outline',
+ 'paragraph',
+ 'persistence',
+ 'portal',
+ 'presence',
+ 'protocol',
+ 'render',
+ 'replica',
+ 'schema',
+ 'segment',
+ 'session',
+ 'snapshot',
+ 'source',
+ 'stream',
+ 'surface',
+ 'timeline',
+ 'token',
+ 'transaction',
+ 'viewport',
+ 'watcher',
+ 'workspace',
+];
+
+const CODE_LINES = [
+ 'const doc = new Y.Doc();',
+ 'const text = doc.getText("source");',
+ 'doc.transact(() => text.insert(0, "hello"), origin);',
+ 'provider.on("synced", () => console.log("ready"));',
+ 'export function markerFor(name: string): string | null {',
+ ' return DOC_MARKERS[name] ?? null;',
+ '}',
+ 'await page.goto(target + "/#/" + encodeURIComponent(docName));',
+ 'const longest = tasks.reduce((m, t) => Math.max(m, t.duration), 0);',
+ 'if (bytes > threshold) deferMount(editor);',
+];
+
+function mulberry32(seed: number): () => number {
+ let a = seed >>> 0;
+ return () => {
+ a = (a + 0x6d2b79f5) >>> 0;
+ let t = a;
+ t = Math.imul(t ^ (t >>> 15), t | 1);
+ t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+ return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+ };
+}
+
+class Writer {
+ private readonly parts: string[] = [];
+ private length = 0;
+
+ push(chunk: string): void {
+ this.parts.push(chunk);
+ this.length += chunk.length;
+ }
+
+ get bytes(): number {
+ return this.length;
+ }
+
+ toString(): string {
+ return this.parts.join('');
+ }
+}
+
+class Generator {
+ private readonly rng: () => number;
+ private readonly out = new Writer();
+ private linksEmitted = 0;
+ private sectionIndex = 0;
+
+ constructor(private readonly spec: SyntheticDocSpec) {
+ this.rng = mulberry32(spec.seed);
+ }
+
+ private int(min: number, max: number): number {
+ return min + Math.floor(this.rng() * (max - min + 1));
+ }
+
+ private word(): string {
+ return WORDS[Math.floor(this.rng() * WORDS.length)] ?? 'document';
+ }
+
+ private capitalized(): string {
+ const w = this.word();
+ return w.charAt(0).toUpperCase() + w.slice(1);
+ }
+
+ private words(count: number): string {
+ const acc: string[] = [];
+ for (let i = 0; i < count; i++) acc.push(this.word());
+ return acc.join(' ');
+ }
+
+ private linkDue(): boolean {
+ if (this.linksEmitted >= this.spec.linkCount) return false;
+ const perLink = this.spec.targetBytes / this.spec.linkCount;
+ return this.out.bytes >= this.linksEmitted * perLink;
+ }
+
+ private link(): string {
+ this.linksEmitted += 1;
+ const n = this.linksEmitted;
+ const target =
+ n % 3 === 0
+ ? `https://example.com/${this.word()}/${this.word()}-${n}`
+ : n % 3 === 1
+ ? `../reports/${this.word()}-${this.word()}/REPORT.md`
+ : `#${this.word()}-${n}`;
+ return `[${this.words(this.int(1, 3))}](${target})`;
+ }
+
+ private span(): string {
+ const roll = this.rng();
+ if (roll < 0.12) return `**${this.words(this.int(1, 3))}**`;
+ if (roll < 0.24) return `\`${this.word()}.${this.word()}\``;
+ if (roll < 0.3) return `*${this.words(this.int(1, 2))}*`;
+ return this.words(this.int(2, 6));
+ }
+
+ private sentence(): string {
+ const spans: string[] = [this.capitalized()];
+ const count = this.int(2, 6);
+ for (let i = 0; i < count; i++) spans.push(this.span());
+ if (this.linkDue()) spans.push(this.link());
+ return `${spans.join(' ')}.`;
+ }
+
+ private paragraph(): string {
+ const count = this.int(2, 5);
+ const acc: string[] = [];
+ for (let i = 0; i < count; i++) acc.push(this.sentence());
+ return `${acc.join(' ')}\n\n`;
+ }
+
+ private list(): string {
+ const count = this.int(3, 6);
+ const acc: string[] = [];
+ for (let i = 0; i < count; i++) {
+ const nested = this.rng() < 0.3 ? `\n - ${this.sentence()}` : '';
+ acc.push(`- ${this.sentence()}${nested}`);
+ }
+ return `${acc.join('\n')}\n\n`;
+ }
+
+ private cell(wide: boolean): string {
+ if (!wide) return this.words(this.int(2, 7));
+ const acc: string[] = [];
+ let len = 0;
+ while (len < this.spec.wideRowChars) {
+ const s = this.sentence();
+ acc.push(s);
+ len += s.length + 1;
+ }
+ return acc.join(' ');
+ }
+
+ private table(): string {
+ const cols = this.int(3, 5);
+ const header = Array.from({ length: cols }, () => this.capitalized());
+ const rows = this.int(6, 12);
+ const lines: string[] = [
+ `| ${header.join(' | ')} |`,
+ `| ${header.map(() => '---').join(' | ')} |`,
+ ];
+ for (let r = 0; r < rows; r++) {
+ const wide = this.spec.wideRowChars > 0 && r % 5 === 2;
+ const cells: string[] = [];
+ for (let c = 0; c < cols; c++) {
+ cells.push(c === cols - 1 && wide ? this.cell(true) : this.cell(false));
+ }
+ lines.push(`| ${cells.join(' | ')} |`);
+ }
+ return `${lines.join('\n')}\n\n`;
+ }
+
+ private code(): string {
+ const count = this.int(3, 8);
+ const lines: string[] = [];
+ for (let i = 0; i < count; i++) {
+ lines.push(CODE_LINES[Math.floor(this.rng() * CODE_LINES.length)] ?? '');
+ }
+ return `\`\`\`ts\n${lines.join('\n')}\n\`\`\`\n\n`;
+ }
+
+ private quote(): string {
+ return `> ${this.sentence()}\n>\n> ${this.sentence()}\n\n`;
+ }
+
+ private section(): void {
+ this.sectionIndex += 1;
+ const n = this.sectionIndex;
+ this.out.push(`## ${n}. ${this.capitalized()} ${this.words(this.int(1, 3))}\n\n`);
+ const paragraphs = this.int(2, 4);
+ for (let i = 0; i < paragraphs; i++) this.out.push(this.paragraph());
+ if (n % 2 === 0) {
+ this.out.push(`### ${this.capitalized()} ${this.words(2)}\n\n`);
+ this.out.push(this.paragraph());
+ }
+ this.out.push(this.list());
+ if (n % 3 === 0) this.out.push(this.table());
+ if (n % 4 === 0) this.out.push(this.code());
+ if (n % 5 === 0) this.out.push(this.quote());
+ }
+
+ generate(): string {
+ this.out.push(`# ${this.spec.title}\n\n`);
+ this.out.push(
+ `Generated by \`packages/app/tests/perf/fixtures/synthetic-doc.ts\` from seed ${this.spec.seed}. Every sentence is filler; only the shape matters.\n\n`,
+ );
+ while (this.out.bytes < this.spec.targetBytes) this.section();
+ while (this.linksEmitted < this.spec.linkCount) {
+ this.out.push(`${this.capitalized()} ${this.words(3)} ${this.link()}.\n\n`);
+ }
+ return this.out.toString();
+ }
+}
+
+export function generateSyntheticDoc(spec: SyntheticDocSpec): string {
+ return new Generator(spec).generate();
+}
+
+export function countLinks(markdown: string): number {
+ return (markdown.match(/\]\(/g) ?? []).length;
+}
+
+export interface WriteResult {
+ readonly path: string;
+ readonly bytes: number;
+ readonly written: boolean;
+}
+
+export function writeSyntheticFixtures(options: { force?: boolean } = {}): WriteResult[] {
+ mkdirSync(FIXTURES_DIR, { recursive: true });
+ return SYNTHETIC_DOCS.map((spec) => {
+ const path = join(FIXTURES_DIR, spec.fileName);
+ if (!options.force && existsSync(path)) {
+ return { path, bytes: 0, written: false };
+ }
+ const content = generateSyntheticDoc(spec);
+ writeFileSync(path, content, 'utf8');
+ return { path, bytes: Buffer.byteLength(content, 'utf8'), written: true };
+ });
+}
diff --git a/packages/app/tests/perf/lib/doc-markers.ts b/packages/app/tests/perf/lib/doc-markers.ts
index b695d752c..5f39d7dab 100644
--- a/packages/app/tests/perf/lib/doc-markers.ts
+++ b/packages/app/tests/perf/lib/doc-markers.ts
@@ -1,9 +1,11 @@
+import { BIG_DOC, MEDIUM_DOC } from '../fixtures/synthetic-doc.ts';
+
export const DOC_MARKERS: Record<string, string> = {
README: 'Local-first knowledge base',
- PROJECT: 'Build an agent-native knowledge platform',
CLAUDE: 'Bun monorepo',
AGENTS: 'Bun monorepo',
- STORIES: 'Now phase workstreams',
+ [BIG_DOC.docName]: BIG_DOC.title,
+ [MEDIUM_DOC.docName]: MEDIUM_DOC.title,
};
export function markerFor(docName: string): string | null {
diff --git a/packages/app/tests/perf/probes/tiptap-destroy-leak.test.ts b/packages/app/tests/perf/probes/tiptap-destroy-leak.test.ts
index 14cb7a826..52f6672e1 100644
--- a/packages/app/tests/perf/probes/tiptap-destroy-leak.test.ts
+++ b/packages/app/tests/perf/probes/tiptap-destroy-leak.test.ts
@@ -142,7 +142,7 @@ describe('tiptap-destroy-leak probe CLI shape', () => {
test('parseCliArgs accepts default args (no flags)', () => {
const args = parseCliArgs([]);
expect(args.target).toBe('http://localhost:5173');
- expect(args.doc).toBe('PROJECT');
+ expect(args.doc).toBe('perf-fixtures/big-doc');
expect(args.cycles).toBe(10);
expect(args.topN).toBe(20);
expect(args.updateBaseline).toBe(false);
@@ -199,7 +199,7 @@ describe('tiptap-destroy-leak probe CLI shape', () => {
schemaVersion: 1,
measuredAt: new Date().toISOString(),
target: 'http://localhost:5173',
- doc: 'PROJECT',
+ doc: 'perf-fixtures/big-doc',
cycles: 10,
cycleHeapsMb: [120],
leakRateMbPerCycle: 0,
@@ -221,7 +221,7 @@ describe('tiptap-destroy-leak probe CLI shape', () => {
schemaVersion: 1,
measuredAt: new Date().toISOString(),
target: 'http://localhost:5173',
- doc: 'PROJECT',
+ doc: 'perf-fixtures/big-doc',
cycles: 10,
cycleHeapsMb: cycleHeaps,
leakRateMbPerCycle: computeLeakRateMbPerCycle(cycleHeaps),
@@ -247,7 +247,7 @@ describe('tiptap-destroy-leak probe CLI shape', () => {
test('ProbeOptions + ProbeResult types are exported (compile-time check)', () => {
const sample: ProbeOptions = {
target: 'http://localhost:5173',
- doc: 'PROJECT',
+ doc: 'perf-fixtures/big-doc',
cycles: 10,
outDir: '/tmp',
topN: 20,
diff --git a/packages/app/tests/perf/probes/tiptap-destroy-leak.ts b/packages/app/tests/perf/probes/tiptap-destroy-leak.ts
index a4cd3f377..176e2f184 100644
--- a/packages/app/tests/perf/probes/tiptap-destroy-leak.ts
+++ b/packages/app/tests/perf/probes/tiptap-destroy-leak.ts
@@ -9,7 +9,7 @@ import { markerFor } from '../lib/doc-markers.ts';
const HERE = dirname(fileURLToPath(import.meta.url));
const DEFAULT_TARGET = 'http://localhost:5173';
-const DEFAULT_DOC = 'PROJECT';
+const DEFAULT_DOC = 'perf-fixtures/big-doc';
const DEFAULT_CYCLES = 10;
const DEFAULT_TOP_N = 20;
const DEFAULT_OUT_DIR = resolve(
diff --git a/packages/app/tests/perf/profile.ts b/packages/app/tests/perf/profile.ts
index 387f3b10e..61ff22227 100644
--- a/packages/app/tests/perf/profile.ts
+++ b/packages/app/tests/perf/profile.ts
@@ -6,6 +6,7 @@ import { dirname, resolve } from 'node:path';
import { fileURLToPath } from 'node:url';
import { type Browser, chromium, type Page, type Request, type Response } from '@playwright/test';
import type { PerfCollector, ProfilerRenderEvent } from '../../src/lib/perf/types.ts';
+import { writeSyntheticFixtures } from './fixtures/synthetic-doc.ts';
import { traceEnd, traceStart } from './lib/cdp-tracer.ts';
import type {
NetworkRequestRecord,
@@ -103,6 +104,10 @@ async function loadScenario(name: string): Promise<ScenarioDefinition> {
}
async function runScenario(args: CliArgs): Promise<void> {
+ for (const fixture of writeSyntheticFixtures()) {
+ if (fixture.written)
+ console.log(`[perf] generated fixture ${fixture.path} (${fixture.bytes} bytes)`);
+ }
const scen = await loadScenario(args.scenario);
const opts: ScenarioOptions = {
diff --git a/packages/app/tests/perf/scenarios/activity-mount-sweep.ts b/packages/app/tests/perf/scenarios/activity-mount-sweep.ts
index f2d1991ca..40847a545 100644
--- a/packages/app/tests/perf/scenarios/activity-mount-sweep.ts
+++ b/packages/app/tests/perf/scenarios/activity-mount-sweep.ts
@@ -11,7 +11,13 @@ const ACTIVITY_MOUNT_LIMITS = [1, 3, 5, 10, 20] as const;
const PEER_COUNTS = [0, 1, 3, 5] as const;
const MEASUREMENT_WINDOW_MS = 10_000;
const TARGET_DOC = 'AGENTS';
-const SWEEP_DOC_POOL = ['AGENTS', 'README', 'CLAUDE', 'STORIES', 'PROJECT'];
+const SWEEP_DOC_POOL = [
+ 'AGENTS',
+ 'README',
+ 'CLAUDE',
+ 'perf-fixtures/medium-doc',
+ 'perf-fixtures/big-doc',
+];
const WAIT_CONTENT_MS = 60_000;
const HUMAN_PROFILE: TypingProfile = {
diff --git a/packages/app/tests/perf/scenarios/cold-load-big-doc.ts b/packages/app/tests/perf/scenarios/cold-load-big-doc.ts
index 1c2a88498..9957f78a4 100644
--- a/packages/app/tests/perf/scenarios/cold-load-big-doc.ts
+++ b/packages/app/tests/perf/scenarios/cold-load-big-doc.ts
@@ -1,7 +1,7 @@
import { installLongtaskObserver, readLongtasks } from '../lib/longtask-observer.ts';
import { defineScenario } from '../lib/scenario.ts';
-const BIG_DOC = process.env.OK_PERF_BIG_DOC ?? 'PROJECT';
+const BIG_DOC = process.env.OK_PERF_BIG_DOC ?? 'perf-fixtures/big-doc';
const PM_READY_CHARS = 500;
@@ -9,7 +9,8 @@ const PM_READY_TIMEOUT_MS = 90_000;
export default defineScenario({
name: 'cold-load-big-doc',
- description: 'Cold-load a large doc (default PROJECT.md) and measure TTI + longest task.',
+ description:
+ 'Cold-load a large doc (default perf-fixtures/big-doc.md) and measure TTI + longest task.',
async run(ctx) {
const { page, opts } = ctx;
diff --git a/packages/app/tests/perf/scenarios/cold-pool-warm.ts b/packages/app/tests/perf/scenarios/cold-pool-warm.ts
index 97f8887c9..8c27427e8 100644
--- a/packages/app/tests/perf/scenarios/cold-pool-warm.ts
+++ b/packages/app/tests/perf/scenarios/cold-pool-warm.ts
@@ -27,26 +27,26 @@
* cost within this window.
*
* Regression-gate invocation (canonical):
- * OK_PERF_BIG_DOC=STORIES bun run perf:profile --scenario=cold-pool-warm
+ * OK_PERF_BIG_DOC=perf-fixtures/medium-doc bun run perf:profile --scenario=cold-pool-warm
*
- * STORIES is the designated reference doc (≈176 MarkView portals, fits
+ * perf-fixtures/medium-doc is the designated reference doc (≈176 MarkView portals, fits
* the ≤200-view target band). Baseline: 541 ms. Target:
- * < 300 ms. Depends on doc-markers.ts entry for STORIES — without it the
+ * < 300 ms. Depends on doc-markers.ts entry for perf-fixtures/medium-doc — without it the
* scenario falls through to a content-length heuristic that races against
* still-Activity-mounted previous docs and produces pmLen numbers matching
* the wrong editor.
*
- * Default (BIG_DOC=PROJECT) is a 768-view stress case used for attribution
+ * Default (BIG_DOC=perf-fixtures/big-doc) is a 768-view stress case used for attribution
* measurements and precedent #27 validation — informative but outside the
* regression-gate target scope. Use it for "how bad was the worst case" and
- * the STORIES invocation for "does the current code still hit the gate."
+ * the perf-fixtures/medium-doc invocation for "does the current code still hit the gate."
*/
import { markerFor } from '../lib/doc-markers.ts';
import { installLongtaskObserver, readLongtasks } from '../lib/longtask-observer.ts';
import { defineScenario } from '../lib/scenario.ts';
-const BIG_DOC = process.env.OK_PERF_BIG_DOC ?? 'PROJECT';
+const BIG_DOC = process.env.OK_PERF_BIG_DOC ?? 'perf-fixtures/big-doc';
const WARM_DOC = process.env.OK_PERF_SMALL_DOC ?? 'README';
const EVICT_DOCS_DEFAULT = ['AGENTS', 'CLAUDE', 'README'];
diff --git a/packages/app/tests/perf/scenarios/g4-profile-decomposition.ts b/packages/app/tests/perf/scenarios/g4-profile-decomposition.ts
index 01bd7d86c..a7cc3cddc 100644
--- a/packages/app/tests/perf/scenarios/g4-profile-decomposition.ts
+++ b/packages/app/tests/perf/scenarios/g4-profile-decomposition.ts
@@ -8,7 +8,7 @@ import { correlateLongtasksWithMarks } from '../lib/correlate-longtasks.ts';
import { installLongtaskObserver, readLongtasks } from '../lib/longtask-observer.ts';
import { defineScenario } from '../lib/scenario.ts';
-const BIG_DOC = process.env.OK_PERF_BIG_DOC ?? 'PROJECT';
+const BIG_DOC = process.env.OK_PERF_BIG_DOC ?? 'perf-fixtures/big-doc';
const PM_READY_CHARS = 500;
const PM_READY_TIMEOUT_MS = 90_000;
@@ -145,7 +145,7 @@ function lastMarkByName(marks: UserMark[], name: string): UserMark | null {
export default defineScenario({
name: 'g4-profile-decomposition',
description:
- 'Profile probe: decomposes PROJECT.md cold-MISS longest-task into JS / layout / style halves and cold-LOAD into IDB / WS / PM phases.',
+ 'Profile probe: decomposes perf-fixtures/big-doc.md cold-MISS longest-task into JS / layout / style halves and cold-LOAD into IDB / WS / PM phases.',
async run(ctx) {
const { page, cdp, opts } = ctx;
diff --git a/packages/app/tests/perf/scenarios/m2-cache-hit-reparent.ts b/packages/app/tests/perf/scenarios/m2-cache-hit-reparent.ts
index 76404bbcd..b1306eaed 100644
--- a/packages/app/tests/perf/scenarios/m2-cache-hit-reparent.ts
+++ b/packages/app/tests/perf/scenarios/m2-cache-hit-reparent.ts
@@ -2,11 +2,11 @@ import { markerFor } from '../lib/doc-markers.ts';
import { installLongtaskObserver, readLongtasks } from '../lib/longtask-observer.ts';
import { defineScenario } from '../lib/scenario.ts';
-const TARGET_DOC = process.env.OK_PERF_M2_DOC ?? 'PROJECT';
+const TARGET_DOC = process.env.OK_PERF_M2_DOC ?? 'perf-fixtures/big-doc';
const MARKER_KEY = process.env.OK_PERF_M2_MARKER_KEY ?? TARGET_DOC;
const VIEW_COUNT_HINT = process.env.OK_PERF_M2_VIEW_COUNT ?? '';
const PRIMING_DOC = process.env.OK_PERF_M2_PRIMING ?? 'README';
-const EVICT_DOCS_DEFAULT = ['AGENTS', 'CLAUDE', 'STORIES'];
+const EVICT_DOCS_DEFAULT = ['AGENTS', 'CLAUDE', 'perf-fixtures/medium-doc'];
const EVICT_DOCS = (process.env.OK_PERF_M2_EVICT_DOCS ?? EVICT_DOCS_DEFAULT.join(','))
.split(',')
.map((s) => s.trim())
diff --git a/packages/app/tests/perf/scenarios/m3-defer-mount-sweep.ts b/packages/app/tests/perf/scenarios/m3-defer-mount-sweep.ts
index 36e051602..8c4736381 100644
--- a/packages/app/tests/perf/scenarios/m3-defer-mount-sweep.ts
+++ b/packages/app/tests/perf/scenarios/m3-defer-mount-sweep.ts
@@ -3,7 +3,7 @@ import { installLongtaskObserver } from '../lib/longtask-observer.ts';
import { defineScenario } from '../lib/scenario.ts';
const DEFAULT_THRESHOLDS = [Number.MAX_SAFE_INTEGER, 1_500_000, 500_000, 200_000, 100_000, 0];
-const DEFAULT_DOCS = ['README', 'AGENTS', 'STORIES'];
+const DEFAULT_DOCS = ['README', 'AGENTS', 'perf-fixtures/medium-doc'];
const THRESHOLDS = (
process.env.OK_PERF_M3_THRESHOLDS
diff --git a/packages/app/tests/perf/scenarios/memory-per-editor.ts b/packages/app/tests/perf/scenarios/memory-per-editor.ts
index bde9b5a19..f7f924615 100644
--- a/packages/app/tests/perf/scenarios/memory-per-editor.ts
+++ b/packages/app/tests/perf/scenarios/memory-per-editor.ts
@@ -7,7 +7,7 @@ const DOC_BUCKETS = (
? process.env.OK_PERF_M1_DOCS.split(',')
.map((s) => s.trim())
.filter(Boolean)
- : ['README', 'AGENTS', 'PROJECT']
+ : ['README', 'AGENTS', 'perf-fixtures/big-doc']
) as readonly string[];
const LEAK_CYCLES = Number(process.env.OK_PERF_M1_LEAK_CYCLES ?? 10);
const MOUNT_TEN_COUNT = Number(process.env.OK_PERF_M1_MOUNT_COUNT ?? 10);
@@ -192,7 +192,13 @@ export default defineScenario({
`${doc} per-editor: ${round2(perEditor)} MB (B′=${round2(stageBMb)} → C=${round2(stageCMb)})`,
);
- const otherDocs = ['README', 'AGENTS', 'CLAUDE', 'STORIES', 'PROJECT'];
+ const otherDocs = [
+ 'README',
+ 'AGENTS',
+ 'CLAUDE',
+ 'perf-fixtures/medium-doc',
+ 'perf-fixtures/big-doc',
+ ];
for (let i = 0; i < MOUNT_TEN_COUNT; i++) {
const next = otherDocs[i % otherDocs.length];
await page.goto(`${opts.target}/#/${encodeURIComponent(next)}`, {
diff --git a/packages/app/tests/perf/scenarios/mode-toggle.ts b/packages/app/tests/perf/scenarios/mode-toggle.ts
index 2e4f95891..2d0417f48 100644
--- a/packages/app/tests/perf/scenarios/mode-toggle.ts
+++ b/packages/app/tests/perf/scenarios/mode-toggle.ts
@@ -2,7 +2,7 @@ import { markerFor } from '../lib/doc-markers.ts';
import { installLongtaskObserver } from '../lib/longtask-observer.ts';
import { defineScenario } from '../lib/scenario.ts';
-const BIG_DOC = process.env.OK_PERF_BIG_DOC ?? 'PROJECT';
+const BIG_DOC = process.env.OK_PERF_BIG_DOC ?? 'perf-fixtures/big-doc';
const WAIT_CONTENT_MS = 90_000;
const FALLBACK_PM_CHARS = 500;
diff --git a/packages/app/tests/perf/scenarios/warm-switch-cached.ts b/packages/app/tests/perf/scenarios/warm-switch-cached.ts
index 38d025378..c45bdb919 100644
--- a/packages/app/tests/perf/scenarios/warm-switch-cached.ts
+++ b/packages/app/tests/perf/scenarios/warm-switch-cached.ts
@@ -4,7 +4,7 @@ import { defineScenario } from '../lib/scenario.ts';
const DOC_A = process.env.OK_PERF_DOC_A ?? 'README';
const DOC_B = process.env.OK_PERF_DOC_B ?? 'AGENTS';
-const EVICT_DOCS_DEFAULT = ['STORIES', 'PROJECT'];
+const EVICT_DOCS_DEFAULT = ['perf-fixtures/medium-doc', 'perf-fixtures/big-doc'];
const EVICT_DOCS = (process.env.OK_PERF_EVICT_DOCS ?? EVICT_DOCS_DEFAULT.join(','))
.split(',')
.map((s) => s.trim())
diff --git a/packages/app/tests/perf/scenarios/warm-switch.ts b/packages/app/tests/perf/scenarios/warm-switch.ts
index e56a0650c..14bbe5d65 100644
--- a/packages/app/tests/perf/scenarios/warm-switch.ts
+++ b/packages/app/tests/perf/scenarios/warm-switch.ts
@@ -25,7 +25,7 @@ import { installLongtaskObserver } from '../lib/longtask-observer.ts';
import { defineScenario } from '../lib/scenario.ts';
const SMALL_DOC = process.env.OK_PERF_SMALL_DOC ?? 'README';
-const BIG_DOC = process.env.OK_PERF_BIG_DOC ?? 'PROJECT';
+const BIG_DOC = process.env.OK_PERF_BIG_DOC ?? 'perf-fixtures/big-doc';
const WAIT_CONTENT_MS = 90_000;