docs: [verified] connect skills-first Roadmap to autonomous Target

scripts/roadmap.test.mjs

@@ -3,33 +3,32 @@ import assert from 'node:assert/strict';
 import {readFileSync} from 'node:fs';
 const read = path => readFileSync(path, 'utf8');
 
-test('Roadmap visibly assesses code and real delivery before adoption', () => {
+export const views = {
+  'strategy-roadmap': ['skills', 'autonomy'],
+  'strategy-roadmap-adoption': ['delivery', 'remaining'],
+  'strategy-roadmap-loop': ['understand', 'baseline', 'topology', 'use', 'collect', 'reassess'],
+};
+test('Roadmap has three visual levels and preserves human direction and Delivery discovery', () => {
   const page = read('docs/strategy/roadmap.mdx');
   const visible = page.split('<details>')[0];
-  const headings = [...visible.matchAll(/^## (.+)$/gm)].map(match => match[1]);
-  assert.deepEqual(headings, ['1. Understand code quality and delivery', '2. Fix critical readiness gaps', '3. Run a bounded pilot', '4. Expand only on evidence', '5. Sustain and improve']);
-  assert(visible.indexOf(' story />') < visible.indexOf('## 1.'));
-  for (const marker of ['representative repositories', 'tests and CI', 'maintainability', 'technical debt', 'security findings', 'actual SDLC', 'ownership', 'review and release', 'bottlenecks', 'baseline findings', 'process map', 'prioritized gaps', 'alongside the pilot', './measurement.mdx', './target-operating-model.mdx']) assert(visible.includes(marker), marker);
-  assert.equal((visible.match(/\*\*Output:/g) || []).length, 5);
-  assert.match(visible, /Recommended sequence/);
-  assert(!page.includes('### Foundation'));
-  for (const marker of ['revocation', 'exact-artifact approvals', 'idempotency', 'human takeover', 'sensitive decisions']) assert(page.includes(marker), marker);
+  assert.deepEqual([...visible.matchAll(/<ArchifyDiagram name="([^"]+)"/g)].map(m => m[1]), Object.keys(views));
+  assert.deepEqual([...visible.matchAll(/^## (.+)$/gm)].map(m => m[1]), ['Two stages toward Target', 'Stage 1: Delivery first', 'Improve within each phase', 'Delivery in practice']);
+  for (const marker of ['Humans direct, guide and review throughout', 'standardizes skills', 'foundation for Stage 2', 'future Autonomous Agent', 'not deployed autonomy', 'order is not yet decided', 'Delivery keeps improving', 'not as six global roadmap stages', 'what skills exist, how they relate, when they are used and how they work together', 'codebase structure', 'existing principles', 'system-logic source', 'tests', 'builds and packaging', 'deployments', 'practices, tooling, controls and problems', 'metrics/KPIs and a baseline', 'friction and feedback', './measurement.mdx', './target-operating-model.mdx']) assert(visible.includes(marker), marker);
+  for (const marker of ['revocation','exact-artifact approvals','idempotency','human takeover','sensitive decisions','security findings','reproducible baseline']) assert(page.includes(marker), marker);
+  assert(!/## [1-5]\.|Prepare foundations|Sustain and improve/.test(page));
 });
-
-test('both roadmap diagrams make assessment and readiness prerequisites to the pilot', () => {
-  const ids = ['assessment', 'readiness', 'pilot', 'expansion', 'sustain'];
-  for (const suffix of ['', '-mobile']) {
-    const diagram = JSON.parse(read(`diagrams/strategy-roadmap${suffix}.workflow.json`));
-    assert.equal(diagram.schema_version, 2);
-    assert.equal(diagram.diagram_type, 'workflow');
-    assert.deepEqual(diagram.mainPath, ids);
-    assert.deepEqual(diagram.nodes.map(n => n.id), ids);
-    assert.deepEqual(diagram.nodes.map(n => n.label), ['Understand today', 'Prepare foundations', 'Pilot', 'Expand', 'Sustain']);
-    assert.deepEqual(diagram.edges.map(e => [e.from,e.to]), ids.slice(1).map((id, i) => [ids[i],id]));
-    assert.equal(diagram.nodes[0].sublabel, 'Code quality and delivery processes understood.');
-    assert.equal(diagram.nodes[1].sublabel, 'Critical pilot gaps closed.');
-    assert(diagram.nodes.every(n => !n.sublabel.includes('Output:') && !n.tag && n.height === 240));
-    assert.deepEqual(diagram.nodes.map(n => n.col), suffix ? [0,0,0,0,0] : [0,1,2,3,4]);
-    assert.equal(diagram.lanes.length, 1);
+for (const [name, ids] of Object.entries(views)) test(`${name}: native graph, mobile parity and loop semantics`, () => {
+  const variants = ['', '-mobile'].map(suffix => JSON.parse(read(`diagrams/${name}${suffix}.workflow.json`)));
+  for (const [index, d] of variants.entries()) {
+    assert.equal(d.schema_version, 2);
+    assert.equal(d.diagram_type, 'workflow');
+    assert.deepEqual(d.mainPath, ids.length === 6 ? ids.slice(0,3) : ids);
+    assert.deepEqual(d.nodes.map(n => n.id), ids);
+    assert.deepEqual(d.edges.filter(e => e.role === 'main').map(e => [e.from,e.to]), ids.slice(1).map((id,i) => [ids[i],id]));
+    assert.deepEqual(d.edges.filter(e => e.role === 'return').map(e => [e.from,e.to]), ids.length === 6 ? [['reassess','understand']] : []);
+    if (index) assert(d.nodes.every(n => n.col === 0));
+    assert(d.nodes.every(n => n.sublabel && !n.tag && n.height === 240));
   }
+  const semantics = d => ({nodes:d.nodes.map(({col,yOffset,...n}) => n), edges:d.edges.map(({fromSide,toSide,route,...e}) => e)});
+  assert.deepEqual(semantics(variants[0]),semantics(variants[1]));
 });