feat: implement CPP01 C++20 card

tests/card_contract.test.mjs

@@ -0,0 +1,16 @@
+import assert from 'node:assert/strict';
+import { access, readFile } from 'node:fs/promises';
+import test from 'node:test';
+const source = JSON.parse(await readFile(new URL('../json/card_source.json', import.meta.url), 'utf8'));
+test('CPP01 identity and task order are stable', () => {
+  assert.equal(source.card.number, '01');
+  assert.equal(source.card.uuid, '3e2ca9fc-7e8c-5d50-9011-0de41114241c');
+  assert.deepEqual(source.tasks_order, ['task01', 'task02', 'task03']);
+  assert.match(JSON.stringify(source), /C\+\+20/);
+});
+test('all task programs and expected outputs exist', async () => {
+  for (const task of ['task01', 'task02', 'task03']) {
+    await access(new URL(`../src/${task}/main.cpp`, import.meta.url));
+    await access(new URL(`./expected/${task}.txt`, import.meta.url));
+  }
+});

tests/card_state_db.test.mjs

@@ -0,0 +1,67 @@
+import assert from 'node:assert/strict';
+import { mkdtemp, rm } from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import test from 'node:test';
+import { CardStateDatabase } from '../scripts/lib/card_state_db.mjs';
+
+test('card state survives closing and reopening SQLite', async () => {
+  const directory = await mkdtemp(path.join(os.tmpdir(), 'stem-card-state-'));
+  const file = path.join(directory, 'state.sqlite3');
+  const state = {
+    schema: 'stem-card-navigation.v2',
+    revision: 7,
+    selected_at: '2026-07-17T12:00:00.000Z',
+    snapshot_ref: 'task04.alloc5.cursor'
+  };
+
+  try {
+    const first = new CardStateDatabase(file);
+    first.write('navigation', state);
+    first.close();
+
+    const second = new CardStateDatabase(file);
+    assert.deepEqual(second.read('navigation'), state);
+    assert.equal(second.read('missing'), null);
+    second.close();
+  } finally {
+    await rm(directory, { recursive: true, force: true });
+  }
+});
+
+test('audit log is append-only, ordered and keeps navigation timestamps', async () => {
+  const directory = await mkdtemp(path.join(os.tmpdir(), 'stem-card-audit-'));
+  const file = path.join(directory, 'state.sqlite3');
+  try {
+    const database = new CardStateDatabase(file);
+    const navigation = {
+      task: { id: 'task04' },
+      block: { id: 'allocator-flow' },
+      phase: { id: 'alloc5' },
+      step: { id: 'alloc5-commit' },
+      snapshot_ref: 'task04.alloc5.commit'
+    };
+    const first = database.appendEvent({
+      eventType: 'navigation.activate',
+      actor: 'nvim',
+      navigation,
+      occurredAt: '2026-07-17T12:00:00.000Z',
+      payload: { source: 'F2' }
+    });
+    const second = database.appendEvent({
+      eventType: 'checkpoint.ready',
+      actor: 'nvim',
+      navigation,
+      occurredAt: '2026-07-17T12:00:01.000Z'
+    });
+    assert.equal(second.id, first.id + 1);
+    assert.deepEqual(
+      database.listEvents({ afterId: first.id, limit: 10 }).map(event => event.event_type),
+      ['checkpoint.ready']
+    );
+    assert.equal(database.listEvents()[0].snapshot_ref, navigation.snapshot_ref);
+    database.close();
+  } finally {
+    await rm(directory, { recursive: true, force: true });
+  }
+});

tests/expected/task01.txt

@@ -0,0 +1 @@
+sum=7

tests/expected/task02.txt

@@ -0,0 +1 @@
+external=5 internal_bias_result=8

tests/expected/task03.txt

@@ -0,0 +1 @@
+sensor=21 network=204