Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.
HTML agent-skillsai-agentsarchitecture-diagramclaude-codeclaude-skillscodexcoding-agentsdeepseek-harnessdeveloper-toolsdiagramsdiagrams-as-codedsh-pluginflowchartllmmermaidopencodesequence-diagramsoftware-architecturesystem-designvisualization
Accept two common callout drafts instead of failing them
tt-a1i838aeaa63b55
diff --git a/archify/explainer/parse.mjs b/archify/explainer/parse.mjsindex 86b08d76..33019da2 100644--- a/archify/explainer/parse.mjs+++ b/archify/explainer/parse.mjs@@ -90,6 +90,9 @@ export function parseExplainer(sourceText, { inputPath, output } = {}) {}function addBlock(block, at, until, rows = []) {if (!panel) { fail(at + 1,block.type,'Blocks must follow a question panel heading.','## What should I know?'); return; }+ // A block named after its own panel points at the same place; keep both reachable instead of failing.+ // Diagrams keep their ID because node and route links name it.+ if (block.id && block.id === panel.id && block.type !== 'diagram') block.id = `${panel.id}-${block.type}`;block.id ||= stable(block.type,`${panel.id}\0${JSON.stringify(block)}`);if (block.type === 'comparison') for (const row of block.rows) row.id ||= stable('row', `${block.id}\0${row.label}`);const pointer = `/panels/${panelIndex}/blocks/${panel.blocks.length}`;@@ -162,6 +165,12 @@ export function parseExplainer(sourceText, { inputPath, output } = {}) {} else {// A directive row never starts with an empty cell; "|| id |" is a line-number prefix copied from a file viewer.while (cursor<lines.length && lines[cursor].trim() && !/^(?:#{1,2}\s|@)/u.test(lines[cursor].trim())) { rows.push({cells:cells(lines[cursor].replace(/^(\s*)\|\|(?=\s)/u,'$1|'),cursor),line:cursor}); cursor++; }+ // A callout with no rows takes the plain paragraph that follows it as its text.+ if (type==='callout' && !rows.length && a.text===undefined) {+ let next=cursor; while (next<lines.length && !lines[next].trim()) next++;+ const paragraph=[]; while (next<lines.length && lines[next].trim() && !/^(?:#{1,2}\s|@|\||[-*+]\s|\d+\.\s|```|~~~)/u.test(lines[next].trim())) { paragraph.push({cells:[lines[next].trim()],line:next}); next++; }+ if (paragraph.length) { rows.push(...paragraph); cursor=next; }+ }}const allowed = {source:['title','url','path','lines','revision'],meta:['locale','quality_profile','repo_url','repo_revision','repo_provider','repo_link_mode'],answer:['scope'],diff --git a/test/explainer-parser.test.mjs b/test/explainer-parser.test.mjsindex e1668566..52e67ac8 100644--- a/test/explainer-parser.test.mjs+++ b/test/explainer-parser.test.mjs@@ -148,3 +148,12 @@ test('plain code fences become literal snippets, diff fences become diffs, and tassert.equal(parseExplainer(draft('```js\nopen()')).document,null);assert.equal(parseExplainer(draft('```js lines=1:2\nx\n```')).document,null);});++test('a callout may take the following paragraph and may share its panel ID without failing',()=>{+ const {document}=parse('# Title\n\nAnswer.\n\n## Pitfalls {#pitfalls}\n\n@callout id=pitfalls level=warning title="Stop first"\n\nDo not pay before checking the deed.\nAsk for the owner ID.\n\n## Next {#next}\n\nText.');+ const callout=document.panels[0].blocks[0];+ assert.equal(document.panels[0].blocks.length,1);+ assert.equal(callout.id,'pitfalls-callout');+ assert.equal(callout.text,'Do not pay before checking the deed.\nAsk for the owner ID.');+ assert.equal(parseExplainer('# T\n\nA.\n\n## Q {#flow}\n\n@sequence id=flow\n| a | b | hi |').document,null,'a diagram keeps its ID, so a clash with its panel still fails');+});