konpeki 0.3.1 → 0.4.0

package/slides/decision-memo/index.tsx

@@ -1,85 +0,0 @@
-import type { ReactNode } from 'react';
-import '@fontsource/newsreader/latin-400.css';
-import '@fontsource/ibm-plex-sans/latin-400.css';
-import '@fontsource/ibm-plex-sans/latin-600.css';
-
-const green = '#164D3A';
-const ink = '#202B26';
-const muted = '#526159';
-function Copy({ x = 112, y, lines, size = 36, color = ink, bold = false }: {
-  x?: number; y: number; lines: string[]; size?: number; color?: string; bold?: boolean;
-}) {
-  return <text x={x} y={y} fill={color} fontSize={size} fontWeight={bold ? 600 : 400}>
-    {lines.map((line, i) => <tspan key={i} x={x} dy={i ? size * 1.35 : 0}>{line}</tspan>)}
-  </text>;
-}
-function Frame({ number, title, summary, children }: {
-  number: number; title: string[]; summary: string; children: ReactNode;
-}) {
-  return <svg xmlns="http://www.w3.org/2000/svg" width="1920" height="1080" viewBox="0 0 1920 1080"
-    role="img" aria-label={`${title.join(' ')}. ${summary}`} fontFamily="IBM Plex Sans" data-cedar-page={number}>
-    <rect width="1920" height="1080" fill="#FFFFFF" />
-    <text x="112" y="160" fontFamily="Newsreader" fontSize="82" fill={green}>
-      {title.map((line, i) => <tspan key={i} x="112" dy={i ? 90 : 0}>{line}</tspan>)}
-    </text>
-    {children}
-    <text x="1808" y="1024" textAnchor="end" fontSize="28" fill={muted}>{number} / 3</text>
-  </svg>;
-}
-
-const Tradeoff = () => <Frame number={1} title={['Suggested replies were faster;', 'quality signals were weaker.']}
-  summary="Cedar Support fictional trial, synthetic data. One week, 120 tickets per group. Standard versus suggested replies: median handling time 12 versus 9 minutes; quality passed 108 of 120 (90%) versus 102 of 120 (85%); reopened within seven days of closure 9 of 120 (7.5%) versus 15 of 120 (12.5%). Quality and reopening are separate measures; a passing ticket can reopen. Each rate uses all 120 tickets in its group.">
-  <Copy y={335} lines={['Cedar Support · One week · 120 tickets per group']} color={muted} />
-  <Copy x={900} y={443} lines={['Standard workflow']} size={32} bold />
-  <Copy x={1335} y={443} lines={['Suggested replies']} size={32} color={green} bold />
-  <line x1="112" x2="1808" y1="478" y2="478" stroke="#A4B2AA" />
-  <Copy y={553} lines={['Median handling time']} />
-  <Copy x={900} y={553} lines={['12 min']} size={46} />
-  <Copy x={1335} y={553} lines={['9 min']} size={46} color={green} />
-  <line x1="112" x2="1808" y1="601" y2="601" stroke="#D7DED9" />
-  <Copy y={676} lines={['Passed quality review']} />
-  <Copy x={900} y={676} lines={['108 / 120 · 90%']} size={40} />
-  <Copy x={1335} y={676} lines={['102 / 120 · 85%']} size={40} color={green} />
-  <line x1="112" x2="1808" y1="724" y2="724" stroke="#D7DED9" />
-  <Copy y={791} lines={['Reopened within 7 days', 'of closure']} size={34} />
-  <Copy x={900} y={791} lines={['9 / 120 · 7.5%']} size={40} />
-  <Copy x={1335} y={791} lines={['15 / 120 · 12.5%']} size={40} color={green} />
-  <line x1="112" x2="1808" y1="861" y2="861" stroke="#A4B2AA" />
-  <Copy y={922} lines={['Quality and reopening are separate measures: a passing ticket can reopen.',
-    'Fictional team; synthetic, hand-authored figures—not an actual trial.']} size={30} color={muted} />
-</Frame>;
-
-const Evidence = () => <Frame number={2} title={['The pattern warrants a better test,', 'not a causal claim.']}
-  summary="The observed median is 3 minutes lower, while quality pass rate is 5 percentage points lower and reopen rate 5 points higher. These are descriptive differences in synthetic data, not causal effects. Assignment was not randomized; ticket difficulty and agent experience were not controlled. There are no raw timing observations, variance estimates or confidence intervals. Medians cannot establish total hours saved. Labor costs and customer satisfaction were not measured.">
-  <Copy y={360} lines={['What the comparison shows']} size={38} color={green} bold />
-  <Copy y={433} lines={['3 minutes lower median handling time', '5 percentage points lower quality pass rate', '5 percentage points higher reopen rate']} size={37} />
-  <Copy x={1035} y={360} lines={['What could explain it']} size={38} color={green} bold />
-  <Copy x={1035} y={433} lines={['Assignment was not randomized.', 'Ticket difficulty and agent experience', 'were not controlled.']} size={37} />
-  <Copy y={677} lines={['Precision is unknown']} size={38} color={green} bold />
-  <Copy y={750} lines={['No raw timing observations, variance', 'estimates or confidence intervals.']} size={37} />
-  <Copy x={1035} y={677} lines={['Business impact is unknown']} size={38} color={green} bold />
-  <Copy x={1035} y={750} lines={['Medians cannot yield total hours saved.', 'No labor-cost or customer-satisfaction', 'results are available.']} size={37} />
-  <Copy y={948} lines={['These are descriptive differences in synthetic data, not estimates of treatment effects.']} size={30} color={muted} />
-</Frame>;
-
-const Decision = () => <Frame number={3} title={['Extend with a longer randomized trial', 'and retain human review.']}
-  summary="Recommendation to Cedar Support’s operations lead: authorize a longer randomized trial with comparable ticket categories and human review retained, rather than broad rollout. Agree quality and reopen-rate acceptance criteria before starting; no numerical thresholds have been set. Collect raw handling-time observations and both quality measures, retaining seven-day reopening follow-up. Decide whether speed improves while both quality guardrails are met; revise or stop expansion if either fails. These collection and decision details are recommendations, not observed results.">
-  <Copy y={347} lines={['Recommendation to Cedar Support’s operations lead']} size={34} color={muted} />
-  <Copy y={475} lines={['Before launch']} size={40} color={green} bold />
-  <Copy x={650} y={475} lines={['Agree quality and reopen-rate acceptance criteria.', 'No numerical thresholds have been set.']} size={38} />
-  <line x1="112" x2="1808" y1="578" y2="578" stroke="#D7DED9" />
-  <Copy y={651} lines={['During the trial']} size={40} color={green} bold />
-  <Copy x={650} y={651} lines={['Randomize across comparable ticket categories; retain human review.', 'Collect raw handling times and both quality measures.', 'Allow seven-day reopening follow-up after closure.']} size={35} />
-  <line x1="112" x2="1808" y1="798" y2="798" stroke="#D7DED9" />
-  <Copy y={871} lines={['At the decision']} size={40} color={green} bold />
-  <Copy x={650} y={871} lines={['Does speed improve while both quality guardrails are met?', 'Use the results to judge rollout; revise or stop expansion if either fails.']} size={35} />
-  <line x1="112" x2="1808" y1="968" y2="968" stroke="#A4B2AA" />
-</Frame>;
-
-export const meta = { title: 'Cedar Support — suggested replies decision', createdAt: '2026-09-12T14:00:00Z' };
-export const notes = [
-  'All figures are synthetic and supplied in PROMPT.md. Rates use 120 tickets in each group; quality review and reopening are not mutually exclusive.',
-  'Differences are arithmetic descriptions only. Non-random assignment and uncontrolled difficulty/experience prevent causal attribution.',
-  'The longer randomized trial, comparable categories, human review, and pre-agreed criteria are supplied proposals. Raw-time collection, complete follow-up and the decision sequence are author recommendations. Trial duration, sample size and thresholds require planning; none is invented here.',
-];
-export default [Tradeoff, Evidence, Decision];

package/slides/delivery-plan/PROMPT.md

@@ -1,45 +0,0 @@
-Make a three-page delivery-plan briefing for the sponsor and delivery team
-at Harbor. Show the original schedule, the current forecast and the decision
-needed now. Make dependencies and release gates clear.
-
-Include a baseline-versus-forecast timeline on a shared date axis, distinguishing
-completed work from forecast work. Show dependency arrows and release gates.
-
----
-
-Harbor is a fictional membership service moving its member directory to a new
-system. This is a hand-authored status packet as of the end of 14 October 2026.
-The schedule uses Monday–Friday working days, with no holidays in this scenario.
-
-Original baseline, agreed 2 October:
-- Import: 5–9 October, owned by data lead Ana.
-- Validation: 12–14 October, owned by QA lead Ben.
-- Staff training: 15–16 October, owned by operations lead Cora.
-- Launch: 19 October, subject to sponsor approval.
-
-Actual progress: import started on 5 October and finished on 14 October.
-The input file contained duplicate member identifiers; resolving them delayed
-completion. Import completion does not mean validation has passed. Validation
-and training have not started. Training materials are ready.
-
-Dependencies: validation starts after import completion and requires three
-working days. Training starts after validation passes and requires two working
-days. Launch is no earlier than the next working day after training completes.
-No work overlaps these stages in the current plan.
-
-Current forecast, assuming no new defects: validation on 15, 16 and 19 October;
-training on 20–21 October; launch on 22 October. These are forecast dates, not
-completed work or a launch commitment.
-
----
-
-Validation must reconcile member counts and required fields against the approved
-input and resolve every duplicate identifier. An unresolved discrepancy blocks
-training and launch. The operations lead must confirm staff readiness after
-training; the sponsor then decides whether to release. No validation result is
-available yet.
-
-Ask the sponsor to accept the revised forecast and reserve staff for 20–21
-October. If the original date is immovable, the team needs a separate scope
-decision and revised plan; no safe shortcut has been established. Do not present
-skipping validation as a way to recover the schedule.

package/slides/delivery-plan/index.tsx

@@ -1,105 +0,0 @@
-import type { ReactNode } from 'react';
-import { fontsReady } from '../../lib/typeface.ts';
-
-await fontsReady;
-const ink = '#172B36', muted = '#50616B', accent = '#006B74', line = '#CAD3D7';
-function Label({ x, y, children, size = 32, color = ink, weight = 400 }: { x: number; y: number; children: ReactNode; size?: number; color?: string; weight?: number }) {
-  return <text x={x} y={y} fontSize={size} fill={color} fontWeight={weight}>{children}</text>;
-}
-function Frame({ title, subtitle, page, description, children }: { title: string; subtitle: string; page: number; description: string; children: ReactNode }) {
-  return <svg xmlns="http://www.w3.org/2000/svg" width="1920" height="1080" viewBox="0 0 1920 1080" fontFamily="IBM Plex Sans" role="img" aria-label={`${title}. ${description}`} data-page={page}>
-    <rect width="1920" height="1080" fill="#FFFFFF" />
-    <Label x={100} y={140} size={64} weight={600}>{title}</Label>
-    <Label x={100} y={207} size={32} color={muted}>{subtitle}</Label>
-    {children}
-    <Label x={1705} y={1020} size={26} color={muted}>{page} / 3</Label>
-  </svg>;
-}
-const x = (day: number) => 440 + (day - 5) * 70;
-function Gate({ day, y }: { day: number; y: number }) {
-  return <path d={`M${x(day)} ${y - 12} l12 12 -12 12 -12 -12 Z`} fill="white" stroke={accent} strokeWidth={3} />;
-}
-function Arrow({ from, to, y }: { from: number; to: number; y: number }) {
-  return <path d={`M${x(from)} ${y} V${y + 29} H${x(to)} V${y + 82} m-7 -10 7 10 7 -10`} stroke={accent} strokeWidth={3} fill="none" />;
-}
-const Schedule = () => <Frame page={1} title="Launch moves from 19 to 22 October" subtitle="Import is complete. The remaining dates are a forecast, assuming no new defects." description="Shared calendar axis, October 5–22. Baseline agreed October 2: import October 5–9, validation 12–14, training 15–16, launch 19 subject to sponsor approval. Actual import October 5–14. Forecast validation October 15, 16 and 19; training 20–21; launch 22. Arrows connect non-overlapping forecast stages; diamonds mark validation pass, readiness confirmation and sponsor release gates.">
-  <rect x={100} y={263} width={38} height={16} fill="none" stroke={muted} strokeWidth={2} />
-  <Label x={153} y={282} size={27}>Baseline · agreed 2 Oct</Label>
-  <rect x={500} y={263} width={38} height={16} fill={accent} />
-  <Label x={553} y={282} size={27}>Completed</Label>
-  <rect x={755} y={263} width={38} height={16} fill="none" stroke={accent} strokeDasharray="6 4" strokeWidth={3} />
-  <Label x={808} y={282} size={27}>Forecast</Label>
-  <path d="M1050 259 l12 12 -12 12 -12 -12 Z" stroke={accent} strokeWidth={3} fill="white" />
-  <Label x={1076} y={282} size={27}>Release gate</Label>
-  <Label x={1440} y={282} size={27} color={muted}>Shaded = weekend</Label>
-  {[10, 11, 17, 18].map(day => <rect key={day} x={x(day)} y={326} width={70} height={499} fill="#F0F3F4" />)}
-  {Array.from({ length: 18 }, (_, i) => i + 5).map(day => <g key={day}>
-    <Label x={x(day) + 18} y={352} size={26} color={muted}>{day}</Label>
-    <line x1={x(day)} x2={x(day)} y1={367} y2={825} stroke="#E6EBED" />
-  </g>)}
-  <Label x={100} y={320} size={25} color={muted}>October 2026</Label>
-  <Label x={100} y={355} size={25} color={muted}>As of end of 14 Oct</Label>
-  {[['Import', 'Ana · data lead'], ['Validation', 'Ben · QA lead'], ['Training', 'Cora · operations'], ['Launch', 'Sponsor approval']].map(([stage, owner], i) => <g key={stage}>
-    <Label x={100} y={409 + i * 108} size={34} weight={600}>{stage}</Label>
-    <Label x={100} y={447 + i * 108} size={26} color={muted}>{owner}</Label>
-    <line x1={100} x2={1770} y1={474 + i * 108} y2={474 + i * 108} stroke={line} />
-  </g>)}
-  {[[5, 10, 389], [12, 15, 497], [15, 17, 605]].map(([a, b, y]) => <rect key={y} x={x(a)} y={y} width={x(b) - x(a)} height={17} fill="white" stroke={muted} strokeWidth={2} />)}
-  <path d={`M${x(19) + 35} 711 l10 10 -10 10 -10 -10 Z`} fill="white" stroke={muted} strokeWidth={2} />
-  <rect x={x(5)} y={424} width={x(15) - x(5)} height={26} fill={accent} />
-  <Label x={x(5) + 18} y={445} size={23} color="white" weight={500}>5–14 Oct · complete</Label>
-  {[[15, 17, 532], [19, 20, 532], [20, 22, 640]].map(([a, b, y]) => <rect key={`${a}-${y}`} x={x(a)} y={y} width={x(b) - x(a)} height={26} fill="white" stroke={accent} strokeWidth={3} strokeDasharray="7 4" />)}
-  <Arrow from={15} to={15} y={450} />
-  <Arrow from={20} to={20} y={558} />
-  <Arrow from={22} to={22.5} y={666} />
-  <Gate day={20} y={545} /><Gate day={22} y={653} /><Gate day={22.5} y={761} />
-  <Label x={100} y={885} size={32} weight={500}>Duplicate member identifiers delayed import completion.</Label>
-  <Label x={100} y={931} size={29} color={muted}>Mon–Fri working days; no holidays. No stage overlap. Import complete does not mean validation passed.</Label>
-  <Label x={100} y={972} size={25} color={muted}>Diamonds at bar ends mark completion gates; launch diamonds mark release dates.</Label>
-</Frame>;
-
-const Gates = () => <Frame page={2} title="Every release gate still needs evidence" subtitle="Validation and training have not started. No validation result is available yet." description="Validation must reconcile member counts and required fields against approved input and resolve every duplicate identifier. An unresolved discrepancy blocks training and launch. Training follows validation pass and lasts two working days. Cora confirms staff readiness after training; sponsor then decides whether to release. Launch no earlier than next working day after training completes.">
-  <Label x={100} y={331} size={28} color={muted}>FORECAST STAGE</Label>
-  <Label x={670} y={331} size={28} color={muted}>EVIDENCE REQUIRED TO PROCEED</Label>
-  <line x1={100} x2={1800} y1={357} y2={357} stroke={line} />
-  <Label x={100} y={413} size={38} weight={600}>Validation · Ben</Label>
-  <Label x={100} y={461} size={30} color={accent}>15, 16 & 19 Oct · 3 working days</Label>
-  <Label x={670} y={413} size={34}>Reconcile member counts and required fields</Label>
-  <Label x={670} y={459} size={34}>against approved input; resolve every duplicate ID.</Label>
-  <Label x={670} y={511} size={29} color={accent} weight={500}>Any unresolved discrepancy blocks training and launch.</Label>
-  <line x1={100} x2={1800} y1={553} y2={553} stroke={line} />
-  <Label x={100} y={611} size={38} weight={600}>Staff training · Cora</Label>
-  <Label x={100} y={659} size={30} color={accent}>20–21 Oct · 2 working days</Label>
-  <Label x={670} y={611} size={34}>Start only after validation passes.</Label>
-  <Label x={670} y={657} size={34}>Operations lead confirms staff readiness afterward.</Label>
-  <Label x={670} y={709} size={29} color={muted}>Training materials are ready; staff readiness is not yet confirmed.</Label>
-  <line x1={100} x2={1800} y1={751} y2={751} stroke={line} />
-  <Label x={100} y={809} size={38} weight={600}>Release · Sponsor</Label>
-  <Label x={100} y={857} size={30} color={accent}>22 Oct · conditional forecast</Label>
-  <Label x={670} y={809} size={34}>Sponsor decides after staff readiness is confirmed.</Label>
-  <Label x={670} y={855} size={34}>No earlier than the next working day after training.</Label>
-  <line x1={100} x2={1800} y1={901} y2={901} stroke={line} />
-</Frame>;
-
-const Decision = () => <Frame page={3} title="Accept the forecast and reserve staff now" subtitle="Sponsor decision requested · Keep the release gates intact." description="Ask sponsor to accept the revised conditional launch forecast for October 22 and reserve staff for training October 20–21. Forecast assumes no new defects and is not a launch commitment. If October 19 is immovable, a separate scope decision and revised plan are needed. No safe shortcut has been established; do not skip validation.">
-  <Label x={100} y={367} size={48} weight={600}>Accept 22 October</Label>
-  <Label x={100} y={424} size={34}>as the revised launch forecast,</Label>
-  <Label x={100} y={470} size={34}>assuming no new defects.</Label>
-  <Label x={100} y={540} size={30} color={accent} weight={500}>A forecast, not a launch commitment.</Label>
-  <Label x={1010} y={367} size={48} weight={600}>Reserve 20–21 October</Label>
-  <Label x={1010} y={424} size={34}>for staff training with Cora.</Label>
-  <Label x={1010} y={470} size={34}>Materials are ready.</Label>
-  <Label x={1010} y={540} size={30} color={accent} weight={500}>Training starts only after validation passes.</Label>
-  <line x1={100} x2={1800} y1={641} y2={641} stroke={line} />
-  <Label x={100} y={723} size={42} weight={600}>If 19 October is immovable</Label>
-  <Label x={100} y={785} size={36}>The team needs a separate scope decision and a revised plan.</Label>
-  <Label x={100} y={846} size={36}>No safe shortcut has been established. Do not skip validation.</Label>
-</Frame>;
-
-export default [Schedule, Gates, Decision];
-export const meta = { title: 'Harbor — Delivery plan', createdAt: '2026-09-12T00:00:00Z' };
-export const notes = [
-  'Fictional, hand-authored packet as of end of 14 October 2026. Baseline agreed 2 October. Calendar axis is continuous, weekends shaded; forecast validation has no work on 17–18 October. Diamonds occur at stage completion boundaries or the launch date. All future stages and gates are conditional.',
-  'Import started 5 October and finished 14 October after duplicate member identifiers were resolved. Import completion is not evidence of validation passing. The validation gate still requires all stated checks.',
-  'Request acceptance of the revised forecast and reserve staff, not unconditional release authorization. No safe shortcut has been established for retaining the original launch date.',
-];

package/slides/drawing-references.md

@@ -1,32 +0,0 @@
-# React/SVG drawing references
-
-These 18 fictional examples preserve the earlier authoring approach: React/SVG
-source, original briefs and reviewed screenshots. Use them for drawing, typography
-and layout techniques; **they cannot be imported directly into the editor**.
-For editable documents, see the [native gallery](README.md).
-
-To adapt trusted source, follow the [conversion guide](../docs/development.md#reactsvg-drawing-references)
-and inspect the result in the canvas. These files are not runnable app routes.
-npm includes source and briefs; screenshots remain in the repository and show
-the historical browser renders, not export or cross-application fidelity.
-
-| Example / source | Brief | Screenshots |
-| --- | --- | --- |
-| [Patchnote — product introduction](product-introduction/index.tsx) | [Brief](product-introduction/PROMPT.md) | [Images](product-introduction/screenshots/) |
-| [Parcel Relay — architecture and sequence](architecture/index.tsx) | [Brief](architecture/PROMPT.md) | [Images](architecture/screenshots/) |
-| [Fieldnote — experiment](experiment/index.tsx) | [Brief](experiment/PROMPT.md) | [Images](experiment/screenshots/) |
-| [Lantern — incident workflow](incident-workflow/index.tsx) | [Brief](incident-workflow/PROMPT.md) | [Images](incident-workflow/screenshots/) |
-| [Moss — comparison](comparison/index.tsx) | [Brief](comparison/PROMPT.md) | [Images](comparison/screenshots/) |
-| [Juniper — migration](migration/index.tsx) | [Brief](migration/PROMPT.md) | [Images](migration/screenshots/) |
-| [Clearpath — OG images](og-images/index.tsx) | [Brief](og-images/PROMPT.md) | [Images](og-images/screenshots/) |
-| [Alder — article briefing](article-brief/index.tsx) | [Brief](article-brief/PROMPT.md) | [Images](article-brief/screenshots/) |
-| [Waymark — results explanation](results-explanation/index.tsx) | [Brief](results-explanation/PROMPT.md) | [Images](results-explanation/screenshots/) |
-| [Dockline — retrospective](retrospective/index.tsx) | [Brief](retrospective/PROMPT.md) | [Images](retrospective/screenshots/) |
-| [Fern — research and stacked bars](research-brief/index.tsx) | [Brief](research-brief/PROMPT.md) | [Images](research-brief/screenshots/) |
-| [Cedar Support — decision memo](decision-memo/index.tsx) | [Brief](decision-memo/PROMPT.md) | [Images](decision-memo/screenshots/) |
-| [Harbor — delivery plan and Gantt](delivery-plan/index.tsx) | [Brief](delivery-plan/PROMPT.md) | [Images](delivery-plan/screenshots/) |
-| [Folio — teaching](teaching/index.tsx) | [Brief](teaching/PROMPT.md) | [Images](teaching/screenshots/) |
-| [Tide — line chart](line-chart/index.tsx) | [Brief](line-chart/PROMPT.md) | [Images](line-chart/screenshots/) |
-| [Birch — grouped bar chart](bar-chart/index.tsx) | [Brief](bar-chart/PROMPT.md) | [Images](bar-chart/screenshots/) |
-| [Fieldnote — vertical and paired bars](vertical-bar-charts/index.tsx) | [Brief](vertical-bar-charts/PROMPT.md) | [Images](vertical-bar-charts/screenshots/) |
-| [Brook — Sankey chart](sankey/index.tsx) | [Brief](sankey/PROMPT.md) | [Images](sankey/screenshots/) |

package/slides/experiment/PROMPT.md

@@ -1,44 +0,0 @@
-Make a three-page presentation for the engineering team at Fieldnote explaining
-an experiment with batching search-index updates. Help them weigh indexing
-throughput against how long users wait for a document to become searchable,
-and decide what to test next.
-
----
-
-Fieldnote is a fictional document workspace. Its current indexer processes
-document updates individually. The team tested batches of 20 and 100 updates
-against that baseline.
-
-Each configuration processed the same fixed set of 60,000 document updates
-on the same machine, starting with an empty queue and an identical index.
-An update's visibility delay runs from submission until the updated document
-appears in search. Each configuration was run once.
-
-Individual updates:
-- Total processing time: 300 seconds.
-- Median visibility delay: 1.2 seconds.
-- 95th-percentile visibility delay: 2.4 seconds.
-
-Batches of 20:
-- Total processing time: 200 seconds.
-- Median visibility delay: 1.8 seconds.
-- 95th-percentile visibility delay: 4.1 seconds.
-
-Batches of 100:
-- Total processing time: 150 seconds.
-- Median visibility delay: 4.9 seconds.
-- 95th-percentile visibility delay: 11.8 seconds.
-
-All configurations produced the expected final document versions, with no
-missing updates in the final check. These are synthetic, hand-authored results.
-There are no repeated runs, uncertainty estimates or production measurements.
-
----
-
-The team's proposed acceptance criteria are at least 250 updates per second
-and a 95th-percentile visibility delay no greater than 5 seconds.
-
-Recommend which configuration deserves a follow-up test. Explain why the
-fastest configuration is not necessarily the best fit. The next experiment
-should repeat the runs and include both sparse arrivals and bursts, since
-a fixed workload does not establish behavior under live traffic.

package/slides/experiment/index.tsx

@@ -1,127 +0,0 @@
-import type { ReactNode } from 'react';
-import '@fontsource/ibm-plex-sans/latin-400.css';
-import '@fontsource/ibm-plex-sans/latin-500.css';
-import '@fontsource/ibm-plex-sans/latin-600.css';
-
-const ink = '#172B3A';
-const muted = '#52616C';
-const accent = '#096F78';
-const rule = '#B9C4CA';
-const results = [
-  { name: 'Individual', time: 300, median: 1.2, p95: 2.4 },
-  { name: 'Batch of 20', time: 200, median: 1.8, p95: 4.1 },
-  { name: 'Batch of 100', time: 150, median: 4.9, p95: 11.8 },
-];
-
-function Copy({ x = 112, y, size = 36, weight = 400, color = ink, children, anchor = 'start' }: {
-  x?: number; y: number; size?: number; weight?: number; color?: string;
-  children: ReactNode; anchor?: 'start' | 'middle' | 'end';
-}) {
-  return <text x={x} y={y} fontSize={size} fontWeight={weight} fill={color} textAnchor={anchor}>{children}</text>;
-}
-
-function Frame({ page, title, description, children }: {
-  page: number; title: string; description: string; children: ReactNode;
-}) {
-  return <svg xmlns="http://www.w3.org/2000/svg" width="1920" height="1080" viewBox="0 0 1920 1080"
-    fontFamily="IBM Plex Sans, sans-serif" role="img" aria-label={`${title}. ${description}`} data-fieldnote-page={page}>
-    <rect width="1920" height="1080" fill="#FFFFFF" />
-    <Copy y={158} size={68} weight={600}>{title}</Copy>
-    {children}
-    <Copy x={1808} y={1020} size={28} color={muted} anchor="end">{page} / 3</Copy>
-  </svg>;
-}
-
-const Evidence = () => <Frame page={1} title="Batching buys speed at a freshness cost"
-  description="Fieldnote is a fictional document workspace. Synthetic, hand-authored results, one run per configuration. The same 60,000 updates ran on the same machine, starting with an empty queue and identical index. Individual: 300 seconds, 200 updates per second, median delay 1.2 seconds, p95 2.4 seconds. Batch of 20: 200 seconds, 300 updates per second, median 1.8 seconds, p95 4.1 seconds. Batch of 100: 150 seconds, 400 updates per second, median 4.9 seconds, p95 11.8 seconds. Visibility delay is submission to search. All final versions were correct, with no missing updates; no repeated runs, uncertainty estimates or production measurements.">
-  <Copy y={237} size={36} color={muted}>Fieldnote is a fictional workspace; its indexer handles updates individually.</Copy>
-  <Copy y={291} size={36} color={muted}>Same 60,000 updates · same machine · empty queue · identical starting index</Copy>
-
-  <Copy y={403} size={30} weight={500}>Configuration</Copy>
-  <Copy x={770} y={383} size={30} weight={500} anchor="end">Processing</Copy>
-  <Copy x={770} y={425} size={30} color={muted} anchor="end">seconds</Copy>
-  <Copy x={1090} y={383} size={30} weight={500} anchor="end">Throughput</Copy>
-  <Copy x={1090} y={425} size={30} color={muted} anchor="end">updates / sec</Copy>
-  <Copy x={1450} y={383} size={30} weight={500} anchor="end">Median delay</Copy>
-  <Copy x={1450} y={425} size={30} color={muted} anchor="end">seconds</Copy>
-  <Copy x={1808} y={383} size={30} weight={500} anchor="end">95th-percentile delay</Copy>
-  <Copy x={1808} y={425} size={30} color={muted} anchor="end">seconds</Copy>
-  {[460, 565, 670, 775].map(y => <line key={y} x1={112} x2={1808} y1={y} y2={y} stroke={rule} strokeWidth={2} />)}
-  {results.map((r, i) => <g key={r.name}>
-    <Copy y={528 + i * 105} size={40} weight={500}>{r.name}</Copy>
-    <Copy x={770} y={528 + i * 105} size={42} anchor="end">{r.time}</Copy>
-    <Copy x={1090} y={528 + i * 105} size={42} anchor="end">{60000 / r.time}</Copy>
-    <Copy x={1450} y={528 + i * 105} size={42} anchor="end">{r.median.toFixed(1)}</Copy>
-    <Copy x={1808} y={528 + i * 105} size={42} anchor="end">{r.p95.toFixed(1)}</Copy>
-  </g>)}
-  <Copy y={832} size={30} color={muted}>Visibility delay: submission → searchable document. Throughput: 60,000 ÷ processing seconds.</Copy>
-  <Copy y={884} size={30}>All final document versions matched expectations; no missing updates in the final check.</Copy>
-  <Copy y={949} size={30} color={muted}>Synthetic, hand-authored results · one run each · no uncertainty estimates or production measurements</Copy>
-</Frame>;
-
-function Bars({ kind, x, width }: { kind: 'rate' | 'delay'; x: number; width: number }) {
-  const rate = kind === 'rate';
-  const max = rate ? 400 : 12;
-  const target = rate ? 250 : 5;
-  const thresholdX = x + target / max * width;
-  return <g>
-    <Copy x={x} y={348} size={38} weight={500}>{rate ? 'Throughput · updates / sec' : '95th-percentile delay · seconds'}</Copy>
-    <Copy x={x} y={397} size={30} color={muted}>{rate ? 'At least 250 required' : 'No more than 5 required'}</Copy>
-    <line x1={thresholdX} x2={thresholdX} y1={440} y2={762} stroke={ink} strokeDasharray="9 9" strokeWidth={2} />
-    {results.map((r, i) => {
-      const value = rate ? 60000 / r.time : r.p95;
-      const pass = rate ? value >= target : value <= target;
-      const y = 468 + i * 110;
-      return <g key={r.name}>
-        <rect x={x} y={y} width={value / max * width} height={44} fill={i === 1 ? accent : muted} />
-        <Copy x={x + width + 24} y={y + 34} size={30} weight={500}>{value}{pass ? ' ✓' : ' ×'}</Copy>
-      </g>;
-    })}
-    <line x1={x} x2={x + width} y1={768} y2={768} stroke={rule} strokeWidth={2} />
-    {(rate ? [0, 100, 200, 300, 400] : [0, 3, 6, 9, 12]).map(tick => <g key={tick}>
-      <line x1={x + tick / max * width} x2={x + tick / max * width} y1={768} y2={780} stroke={rule} strokeWidth={2} />
-      <Copy x={x + tick / max * width} y={820} size={28} anchor="middle" color={muted}>{tick}</Copy>
-    </g>)}
-  </g>;
-}
-
-const Decision = () => <Frame page={2} title="Batches of 20 deserve the follow-up test"
-  description="Only batches of 20 meet both proposed acceptance criteria in these single synthetic runs: at least 250 updates per second and p95 delay no greater than 5 seconds. Individual: 200 updates per second fails throughput, 2.4 seconds passes delay. Batch of 20: 300 and 4.1 both pass. Batch of 100: 400 passes throughput, 11.8 fails delay. The fastest configuration exceeds the delay ceiling by 6.8 seconds. These results support a follow-up test, not a production rollout.">
-  <Copy y={237} size={36} color={muted}>Only this configuration meets both proposed criteria in the single-run results.</Copy>
-  {results.map((r, i) => <Copy key={r.name} y={502 + i * 110} size={34} weight={i === 1 ? 600 : 400} color={i === 1 ? accent : ink}>{r.name}</Copy>)}
-  <Bars kind="rate" x={445} width={485} />
-  <Bars kind="delay" x={1170} width={485} />
-  <Copy x={112} y={893} size={34}>Batch of 100 is fastest, but its p95 delay exceeds the ceiling by 6.8 seconds.</Copy>
-  <Copy x={112} y={949} size={30} color={muted}>Synthetic, one run each. ✓ meets criterion · × misses criterion. This supports testing, not rollout.</Copy>
-</Frame>;
-
-const Next = () => <Frame page={3} title="Repeat the runs, then vary the arrival pattern"
-  description="Prioritize batches of 20 and retain individual and batch-of-100 controls. Repeat runs under the original fixed-workload conditions and report run-to-run variability rather than selecting the best run. Include sparse arrivals to measure waits for a partial batch, recording the flush policy; include bursts to measure queue growth and recovery. Measure throughput, median and p95 submission-to-search delay, and final-version correctness. A fixed workload does not establish live-traffic behavior. Reassess batches of 20 against at least 250 updates per second under offered load and p95 no greater than 5 seconds; revise batching or flushing and retest if either fails.">
-  <Copy y={237} size={36} color={muted}>Prioritize batches of 20; retain individual updates and batches of 100 as controls.</Copy>
-
-  <Copy y={363} size={42} weight={600}>Repeat the fixed workload</Copy>
-  <Copy y={425} size={34}>Keep the machine, starting index and</Copy>
-  <Copy y={471} size={34}>60,000 updates comparable. Report</Copy>
-  <Copy y={517} size={34}>run-to-run variability, not the best run.</Copy>
-
-  <Copy x={1000} y={363} size={42} weight={600}>Exercise sparse arrivals and bursts</Copy>
-  <Copy x={1000} y={425} size={34}>Sparse: measure waiting for a partial batch;</Copy>
-  <Copy x={1000} y={471} size={34}>record the policy for flushing that batch.</Copy>
-  <Copy x={1000} y={539} size={34}>Bursts: track queue growth and recovery,</Copy>
-  <Copy x={1000} y={585} size={34}>including submission-to-search delay.</Copy>
-
-  <line x1={112} x2={1808} y1={650} y2={650} stroke={rule} strokeWidth={2} />
-  <Copy y={717} size={40} weight={600} color={accent}>Use both gates before advancing</Copy>
-  <Copy y={777} size={34}>Recheck ≥250 updates/sec under offered load and p95 delay ≤5 sec;</Copy>
-  <Copy y={823} size={34}>track median delay and final-version correctness. If either gate fails, revise</Copy>
-  <Copy y={869} size={34}>batching or flushing and retest. Sparse traffic tests freshness, not peak capacity.</Copy>
-  <Copy y={949} size={30} color={muted}>The fixed workload does not establish live-traffic behavior. No production measurements exist yet.</Copy>
-</Frame>;
-
-export const meta = { title: 'Fieldnote: batching search-index updates' };
-export const notes = [
-  'Source: the unchanged PROMPT.md. Fieldnote and all results are fictional. Values are not production evidence.',
-  'Recommendation is limited to a follow-up test. Rates are derived from 60,000 updates divided by processing time.',
-  'Repeated controls, recording the flush policy and queue recovery are proposed implementation details, not measured findings. No flush policy or repetition count was supplied.',
-];
-export default [Evidence, Decision, Next];

package/slides/github-cover/PROMPT.md

@@ -1,21 +0,0 @@
-# Brief
-
-> i'd like a cover image for github repo. build it with konpeki
-
-## Adaptation
-
-- Assumed a 1280×640 GitHub social preview; unspecified mode resolved to default.
-- Use the existing blue mark, white canvas and IBM Plex Sans. Lead with “Konpeki”
-  and “Create clear visuals with your coding agent.”
-- Arrange different canvas sizes on a consistent grid, with white backgrounds
-  and text, image, chart, diagram and table motifs. Avoid labels or a single
-  workflow that suggests these are the only possible outputs.
-- A generated concept informed placement; the final uses editable text and
-  vectors, not a flattened concept image.
-
-## Sources
-
-- Product: [README](../../README.md) and [workflow](../../docs/workflow.md).
-- Brand: [project mark](../../src/assets/konpeki-mark.png) and bundled IBM Plex
-  Sans under its existing font license.
-- Canvas motifs are conceptual, not screenshots.

package/slides/github-cover/README.md

@@ -1,21 +0,0 @@
-# GitHub repository cover
-
-[composition.json](composition.json) holds the editable text and vectors;
-[cover.png](cover.png) is its 1280×640 Konpeki PNG export.
-The varied canvas sizes illustrate possible formats, not a fixed workflow.
-
-Open from the repository root, edit, then choose **Export PNG**:
-
-```sh
-mise exec -- pnpm konpeki preview slides/github-cover/composition.json
-```
-
-Refresh [public/og.png](../../public/og.png) for the playground's social cards.
-Uploading the cover to GitHub's repository social-preview setting is separate.
-
-[Brief and sources](PROMPT.md). [author.ts](author.ts) reconstructs the initial
-composition using Node.js and ImageMagick; **it overwrites canvas edits**.
-
-Original review: validation, typecheck and build passed; all five components and
-IBM Plex Sans loaded. Inspected the 1280×640 export and a 640×320 copy for alignment,
-clipping and legibility.

package/slides/github-cover/author.ts

@@ -1,67 +0,0 @@
-import {execFileSync} from 'node:child_process';
-import {writeFileSync} from 'node:fs';
-import {fileURLToPath} from 'node:url';
-import {assertComposition} from '../../composition/validate.ts';
-import {compositionSchema, type CompositionComponent, type CompositionDocument, type VectorElement} from '../../composition/types.ts';
-
-// Reproduce the existing mark's alpha silhouette as editable vector geometry.
-const mask=execFileSync('magick',[fileURLToPath(new URL('../../src/assets/konpeki-mark.png',import.meta.url)),'-alpha','extract','-threshold','50%','-depth','8','gray:-']);
-let outline='';
-for(let y=0;y<128;y++)for(let x=0;x<128;x++){
-  if(mask[y*128+x]<128)continue;
-  const start=x;
-  while(x+1<128&&mask[y*128+x+1]>=128)x++;
-  outline+=`M${start} ${y}h${x-start+1}v1H${start}Z`;
-}
-const ink='#202630',blue='#007fb5',lightGray='#b2bdc2';
-const text=(id:string,content:string,x:number,y:number,width:number,height:number,size:number,weight:400|600=600):CompositionComponent=>({
-  id,kind:'text-block',content,slotIds:[`${id}-content`],preferredRect:{x,y,width,height},
-  textStyle:{size,weight,lineHeight:1.18,color:'ink',font:'heading'},
-  appearance:{role:id==='brand'?'title':'body',alignment:'start',border:'none',rule:'none'},
-});
-const elements:VectorElement[]=[
-  {id:'cover-frame',kind:'rect',attributes:{x:10,y:8,width:260,height:140,rx:8,fill:'#ffffff',stroke:blue,'stroke-width':2.5}},
-  {id:'cover-mark',kind:'rect',attributes:{x:28,y:28,width:42,height:42,rx:4,fill:blue}},
-  {id:'cover-title',kind:'rect',attributes:{x:86,y:29,width:144,height:13,rx:3,fill:lightGray}},
-  {id:'cover-copy-1',kind:'rect',attributes:{x:86,y:53,width:112,height:7,rx:3,fill:lightGray}},
-  {id:'cover-copy-2',kind:'rect',attributes:{x:28,y:102,width:164,height:7,rx:3,fill:lightGray}},
-  {id:'cover-accent',kind:'rect',attributes:{x:211,y:96,width:39,height:28,rx:4,fill:'#eaf6fb'}},
-  {id:'square-frame',kind:'rect',attributes:{x:292,y:8,width:140,height:140,rx:8,fill:'#ffffff',stroke:blue,'stroke-width':2.5}},
-  {id:'square-title',kind:'rect',attributes:{x:311,y:28,width:82,height:10,rx:3,fill:lightGray}},
-  {id:'square-bar-1',kind:'rect',attributes:{x:314,y:93,width:18,height:31,rx:3,fill:blue}},
-  {id:'square-bar-2',kind:'rect',attributes:{x:342,y:72,width:18,height:52,rx:3,fill:'#5cb9df'}},
-  {id:'square-bar-3',kind:'rect',attributes:{x:370,y:52,width:18,height:72,rx:3,fill:'#9adbed'}},
-  {id:'square-baseline',kind:'path',attributes:{d:'M307 126H410',fill:'none',stroke:lightGray,'stroke-width':2}},
-  {id:'portrait-frame',kind:'rect',attributes:{x:10,y:172,width:145,height:230,rx:8,fill:'#ffffff',stroke:blue,'stroke-width':2.5}},
-  {id:'portrait-title',kind:'rect',attributes:{x:28,y:193,width:94,height:11,rx:3,fill:lightGray}},
-  {id:'portrait-visual',kind:'rect',attributes:{x:28,y:224,width:109,height:81,rx:5,fill:'#eaf6fb'}},
-  {id:'portrait-rule',kind:'path',attributes:{d:'M45 285L76 247 96 270 122 236',fill:'none',stroke:blue,'stroke-width':4}},
-  {id:'portrait-copy-1',kind:'rect',attributes:{x:28,y:326,width:92,height:7,rx:3,fill:lightGray}},
-  {id:'portrait-copy-2',kind:'rect',attributes:{x:28,y:344,width:108,height:7,rx:3,fill:lightGray}},
-  {id:'portrait-copy-3',kind:'rect',attributes:{x:28,y:362,width:74,height:7,rx:3,fill:lightGray}},
-  {id:'slide-frame',kind:'rect',attributes:{x:180,y:172,width:252,height:144,rx:8,fill:'#ffffff',stroke:blue,'stroke-width':2.5}},
-  {id:'slide-title',kind:'rect',attributes:{x:199,y:190,width:115,height:11,rx:3,fill:lightGray}},
-  {id:'diagram-path',kind:'path',attributes:{d:'M305 251V270H231V278M305 270H379V278',fill:'none',stroke:lightGray,'stroke-width':3}},
-  {id:'diagram-parent',kind:'rect',attributes:{x:284,y:215,width:42,height:36,rx:7,fill:blue}},
-  {id:'diagram-child-1',kind:'rect',attributes:{x:210,y:278,width:42,height:25,rx:6,fill:'#eaf6fb',stroke:blue,'stroke-width':2}},
-  {id:'diagram-child-2',kind:'rect',attributes:{x:358,y:278,width:42,height:25,rx:6,fill:'#eaf6fb',stroke:blue,'stroke-width':2}},
-  {id:'table-frame',kind:'rect',attributes:{x:180,y:338,width:252,height:64,rx:8,fill:'#ffffff',stroke:blue,'stroke-width':2.5}},
-  {id:'table-header',kind:'rect',attributes:{x:181,y:339,width:250,height:20,rx:7,fill:'#eaf6fb'}},
-  {id:'table-grid',kind:'path',attributes:{d:'M250 339V401M330 339V401M181 359H431M181 380H431',fill:'none',stroke:lightGray,'stroke-width':2}},
-  {id:'table-emphasis',kind:'rect',attributes:{x:196,y:365,width:38,height:8,rx:3,fill:blue}},
-];
-const components:CompositionComponent[]=[
-  text('brand','Konpeki',150,120,480,110,84),
-  {id:'brand-mark',kind:'image',slotIds:['brand-mark-content'],preferredRect:{x:64,y:143,width:66,height:66},customVisual:{format:'vector',viewBox:{x:0,y:0,width:128,height:128},description:'Konpeki blue brush mark',elements:[{id:'mark-silhouette',kind:'path',attributes:{d:outline,fill:blue}}]}},
-  text('promise','Create clear visuals',64,302,680,90,62),
-  text('audience','with your coding agent.',64,400,660,76,44,400),
-  {id:'visual-family',kind:'image',slotIds:['visual-family-content'],preferredRect:{x:772,y:106,width:444,height:412},customVisual:{format:'vector',viewBox:{x:0,y:0,width:444,height:412},description:'Aligned white canvases using Konpeki text, image, bar chart, line chart, diagram and table components.',elements}},
-];
-const document:CompositionDocument={schema:compositionSchema,title:'Konpeki GitHub cover',authoringMode:'default',theme:{id:'plex',mode:'paper'},slides:[{
-  id:'github-cover',name:'GitHub repository cover',canvas:{width:1280,height:640},innerPadding:{top:64,right:64,bottom:64,left:64},pageNumber:{style:'none',color:'muted'},
-  audience:'Developers discovering Konpeki on GitHub',question:'What can I create with Konpeki and my coding agent?',intendedViewingSize:'social',components,
-  contentSlots:components.map(c=>({id:c.slotIds[0],label:c.id,role:'body',required:true,instruction:c.kind==='text-block'?c.content??'':c.customVisual?.description??''})),
-  groups:[],relationships:[],readingOrder:components.map(c=>({kind:'component',id:c.id})),paintOrder:components.map(c=>c.id),
-}]};
-assertComposition(document);
-writeFileSync(new URL('composition.json',import.meta.url),JSON.stringify(document,null,2)+'\n');