From 89edc5af6548c3b8cbcf850f223786df9a40f7d0 Mon Sep 17 00:00:00 2001 From: Wolfe-Jam Date: Thu, 12 Nov 2026 12:54:00 -0500 Subject: [PATCH] fix: Show each quote's file, and make the map work on phones and keyboards MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Source links always show repo › path and open the file (HEAD, the repo's default branch); a label is extra text - On a narrow screen, selecting a project, line or flow brings the panel into view - Flows keep keyboard focus on Next after each step - The map's svg is a group, so screen readers keep its project buttons - The "new" tag shows each link's own added date; the overview's added-links sentence comes from the data - Headline: documented lines are stated by a project's docs; examples and seams are labelled From goose's review of the whole repository at 709d522. Co-authored-by: goose Co-Authored-By: Claude Opus 5.5 --- index.html | 42 +++++++++++++++++++++++++++++++----------- 1 file changed, 31 insertions(+), 11 deletions(-) diff --git a/index.html b/index.html index 411fc51..746421e 100644 --- a/index.html +++ b/index.html @@ -122,7 +122,7 @@
Agentic AI Foundation · 10 projects · Nov 2026

The AAIF Full Stack

-

Ten projects, one map. The ten are the projects AAIF lists at aaif.io/projects. Every line on it is a link that one project's own documentation states, with the quote. Click a project to read it, or play a flow to see how they work together.

+

Ten projects, one map. The ten are the projects AAIF lists at aaif.io/projects. Every documented line on it is a link one project's own documentation states, with the quote; examples and open seams are labelled. Click a project to read it, or play a flow to see how they work together.

These are some of the paths to discover relationships between the projects. Share yours.

@@ -133,7 +133,7 @@

The AAIF Full Stack

-
+
@@ -197,8 +197,7 @@

Sources

const DOCS = Object.fromEntries(P.nodes.filter(n => n.docs).map(n => [n.id, n.docs])); const BANDS = [['Context', 20, 100], ['Agents & apps', 110, 190], ['Protocols', 205, 295], ['Gateways', 310, 400], ['Run & train', 405, 495]]; const GH = 'https://github.com/'; - const srcText = s => s.repo && s.path ? (s.label ? s.repo + ' (' + s.label + ')' : s.repo + '/blob/main/' + s.path) : (s.note || ''); - const EDGES = L.links.map(l => ({ id: l.id, a: l.from, b: l.to, t: l.title, q: l.quote, s: srcText(l.source), weak: l.kind === 'example', seam: l.kind === 'seam', isNew: !!l.added, bend: l.bend })); + const EDGES = L.links.map(l => ({ id: l.id, a: l.from, b: l.to, t: l.title, q: l.quote, s: l.source || {}, weak: l.kind === 'example', seam: l.kind === 'seam', added: l.added, bend: l.bend })); const FLOWS = Object.fromEntries(Object.entries(F.flows).map(([k, f]) => [k, { name: f.name, steps: f.steps.map(s => [s.link, s.caption]) }])); // One button per flow in data/flows.json, so a new flow needs no change here. const seamsToggle = document.getElementById('seams').closest('label'); @@ -215,7 +214,14 @@

Sources

const byId = Object.fromEntries(NODES.map(n => [n.id, n])); const el = (tag, attrs, parent) => { const e = document.createElementNS(NS, tag); for (const k in attrs) e.setAttribute(k, attrs[k]); if (parent) parent.appendChild(e); return e; }; const esc = s => String(s).replace(/[&<>"]/g, c => ({ '&': '&', '<': '<', '>': '>', '"': '"' }[c])); - const srcLink = s => s.includes('/blob/') ? `${esc(s.replace('/blob/main/', ' › '))}` : (/^[\w.-]+\/[\w.-]+/.test(s) && !s.includes(' · ') ? `${esc(s)}` : esc(s)); + // The source file, always shown and linked (HEAD = the repo's default branch); a label adds context. + const srcLink = s => s.repo && s.path + ? `${esc(s.repo + ' › ' + s.path)}${s.label ? ' · ' + esc(s.label) : ''}` + : esc(s.note || ''); + const MONTHS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']; + const shortDate = d => { const [y, m, day] = d.split('-').map(Number); return `${MONTHS[m - 1]} ${day}`; }; + // On a narrow screen the panel sits below the map: bring it into view when something is selected. + const reveal = () => { if (window.matchMedia('(max-width: 960px)').matches && panel.getBoundingClientRect().top > window.innerHeight * 0.6) panel.scrollIntoView({ block: 'start', behavior: matchMedia('(prefers-reduced-motion: reduce)').matches ? 'auto' : 'smooth' }); }; function port(n, tx, ty) { const dx = tx - n.x, dy = ty - n.y; @@ -273,7 +279,7 @@

Sources

return `${n.stage} stage`; } function edgeItem(e) { - return `
  • ${e.seam ? 'Open seam' : e.weak ? 'Example only' : 'Documented'}${e.isNew ? '· new Nov 3' : ''}${esc(e.t)}
    ${esc(e.q)}
    ${srcLink(e.s)}
  • `; + return `
  • ${e.seam ? 'Open seam' : e.weak ? 'Example only' : 'Documented'}${e.added ? `· new ${shortDate(e.added)}` : ''}${esc(e.t)}
    ${esc(e.q)}
    ${srcLink(e.s)}
  • `; } function showNode(id) { @@ -284,12 +290,14 @@

    Sources

    panel.innerHTML = `

    ${esc(n.layer)} · ${esc(n.kind)}

    ${esc(n.name)}

    ${stageChip(n)}

    ${esc(n.role)}

    ` + (n.ext ? '' : `
    Contributed by
    ${esc(n.origin)}
    Joined AAIF
    ${esc(n.joined)}
    Docs
    ${esc(DOCS[n.id].replace(/^https:\/\/(www\.)?/, ''))}
    Repository
    ${esc(n.repo.replace('https://github.com/', ''))}
    `) + `

    ${es.length} ${es.length === 1 ? 'link' : 'links'} on the map

    `; + reveal(); } function showEdge(eid) { setFlow(null); const e = EDGES.find(x => x.id === eid); highlight([e.a, e.b], [eid]); panel.innerHTML = `

    ${esc(byId[e.a].name)} ↔ ${esc(byId[e.b].name)}

    ${esc(e.t)}

    `; + reveal(); } let flow = null, step = 0; @@ -297,7 +305,8 @@

    Sources

    flow = key; step = 0; document.querySelectorAll('[data-flow]').forEach(b => b.setAttribute('aria-pressed', String(b.dataset.flow === key))); } - function renderFlow() { + // focusStepper: after a step, keep keyboard focus on the stepper instead of losing it to the page. + function renderFlow(focusStepper) { const f = FLOWS[flow], [eid, caption] = f.steps[step], e = EDGES.find(x => x.id === eid); if (e.seam && !seamsBox.checked) { seamsBox.checked = true; applySeams(); } const seen = f.steps.slice(0, step + 1).map(s => s[0]); @@ -307,17 +316,28 @@

    Sources

    edgeEls[eid].path.classList.add('on'); panel.innerHTML = `

    Flow · step ${step + 1} of ${f.steps.length}

    ${esc(f.name)}

    ${esc(caption)}

    ` + `
    ${step + 1}/${f.steps.length}
    `; - document.getElementById('prev').onclick = () => { if (step > 0) { step--; renderFlow(); } }; - document.getElementById('next').onclick = () => { step = step === f.steps.length - 1 ? 0 : step + 1; renderFlow(); }; + document.getElementById('prev').onclick = () => { if (step > 0) { step--; renderFlow(true); } }; + document.getElementById('next').onclick = () => { step = step === f.steps.length - 1 ? 0 : step + 1; renderFlow(true); }; + if (focusStepper) document.getElementById('next').focus(); } - document.querySelectorAll('[data-flow]').forEach(b => b.addEventListener('click', () => { setFlow(b.dataset.flow); renderFlow(); })); + document.querySelectorAll('[data-flow]').forEach(b => b.addEventListener('click', () => { setFlow(b.dataset.flow); renderFlow(true); reveal(); })); + // The overview's sentence about recently added links, from the data's "added" dates. + function addedNote() { + const dates = [...new Set(EDGES.filter(e => e.added).map(e => e.added))].sort(); + const n = EDGES.filter(e => e.added).length; + if (!n) return ''; + const words = ['No', 'One', 'Two', 'Three', 'Four', 'Five', 'Six', 'Seven', 'Eight', 'Nine']; + const count = n < 10 ? words[n] : String(n); + const when = dates.length === 1 ? `the ${shortDate(dates[0])} check` : `checks from ${shortDate(dates[0])} to ${shortDate(dates[dates.length - 1])}`; + return `${count} ${n === 1 ? 'link was' : 'links were'} added in ${when}; ${n === 1 ? 'its panel says' : 'their panels say'} “new”.`; + } function overview() { highlight([], []); const doc = EDGES.filter(e => !e.seam && !e.weak).length, ex = EDGES.filter(e => e.weak).length, sm = EDGES.filter(e => e.seam).length; panel.innerHTML = `

    10 projects · ${doc} documented links · ${ex} example · ${sm} open seams

    How the stack fits

    ` + `

    MCP sits in the middle: six of the other nine projects document a link to it. A2A is the second protocol, for agent-to-agent traffic, and both gateways now document carrying it. Above them, goose reads AGENTS.md and loads Agent Skills. Below them, the two gateways route the traffic, and OpenSandbox and OpenEnv give agents a place to run and to learn.

    ` + - `

    All ten projects now have a stage on the technical committee’s table. Three links were added in the Nov 3 check; their panels say “new”.

    ` + + `

    All ten projects now have a stage on the technical committee’s table. ${addedNote()}

    ` + `

    Click any project or line. Play a flow to step through it.

    `; } const themeBtn = document.getElementById('theme');