Skip to content

Turn any idea, plan, or codebase into a beautiful interactive diagram. An agent skill for Claude Code, Codex, and more.

docs(erd): clarify domain-not-drawn expects a solid rectangle

tt-a1i32ba90c84465
diff --git a/archify/renderers/erd/render-erd.mjs b/archify/renderers/erd/render-erd.mjs
index 055e9454..57868c15 100644
--- a/archify/renderers/erd/render-erd.mjs
+++ b/archify/renderers/erd/render-erd.mjs
@@ -1066,7 +1066,7 @@ function validateEr() {
const offGrid = domain.offGrid.map((id) => `"${id}"`).join(', ');
const message = domain.reason === 'no-grid'
? `Domain "${domain.tag}" is named but cannot be drawn: ${offGrid} have no grid cells, and a band is measured from them. Give every member row/col cells, or drop the tag.`
- : `Domain "${domain.tag}" is named but cannot be drawn: ${listed} do not fill a solid block of grid cells, and a band around them would enclose cells the domain does not own. Move them into one block, or split the tag.`;
+ : `Domain "${domain.tag}" is named but cannot be drawn: ${listed} do not fill a solid rectangle of grid cells (a row, a column, or a filled block — not an L or diagonal), and a band around them would enclose cells the domain does not own. Move them into one block, or split the tag.`;
problems.push(message);
domainDetails.push({
code: 'erd/domain-not-drawn', severity: 'error', message,
@@ -1074,7 +1074,7 @@ function validateEr() {
evidence: { domain: domain.tag, entities: members, reason: domain.reason, offGrid: domain.offGrid },
supportedFixes: domain.reason === 'no-grid'
? ['Give every domain member row/col cells.', 'Drop the tag to group nothing.']
- : ['Give the domain members one solid block of grid cells.', 'Split the tag so each domain can be drawn as a band.', 'Drop the tag to group nothing.'],
+ : ['Give the domain members one solid rectangle of grid cells (a row, a column, or a filled block — not an L).', 'Split the tag so each domain can be drawn as a band.', 'Drop the tag to group nothing.'],
});
}
// The band draws the domain name, so a band the canvas cannot show would put
diff --git a/test/erd-rendering.test.mjs b/test/erd-rendering.test.mjs
index badb90c2..ef0d32d2 100644
--- a/test/erd-rendering.test.mjs
+++ b/test/erd-rendering.test.mjs
@@ -636,7 +636,7 @@ test('a contiguous domain draws a band and a scattered tag does not', () => {
const scattered = render(scatteredDiagram, scatteredDirectory);
assert.notEqual(scattered.status, 0, 'a tag split across the canvas must not render');
assert.match(scattered.stderr + scattered.stdout, /erd\/domain-not-drawn/);
- assert.match(scattered.stderr + scattered.stdout, /"alpha", "delta" do not fill a solid block/);
+ assert.match(scattered.stderr + scattered.stdout, /"alpha", "delta" do not fill a solid rectangle/);
assert.equal(fs.existsSync(scattered.output), false, 'the diagram is not written at all');
});
@@ -1073,7 +1073,7 @@ test('a domain that cannot be drawn as a band stops the render instead of losing
const ellRun = render(ell, ellDirectory);
assert.notEqual(ellRun.status, 0, 'an L-shaped domain must not be banded');
assert.match(ellRun.stderr + ellRun.stdout, /erd\/domain-not-drawn/);
- assert.match(ellRun.stderr + ellRun.stdout, /"a", "b", "c" do not fill a solid block/);
+ assert.match(ellRun.stderr + ellRun.stdout, /"a", "b", "c" do not fill a solid rectangle/);
assert.equal(fs.existsSync(ellRun.output), false, 'nothing is written when a domain cannot be named');
// Absolute coordinates have no cells to group, so a tag cannot be drawn there.
@@ -1097,7 +1097,7 @@ test('a domain that cannot be drawn as a band stops the render instead of losing
const sharedRun = render(shared, sharedDirectory);
assert.notEqual(sharedRun.status, 0, 'two tables in one cell must not render');
assert.match(sharedRun.stderr + sharedRun.stdout, /share grid cell/);
- assert.doesNotMatch(sharedRun.stderr + sharedRun.stdout, /do not fill a solid block/,
+ assert.doesNotMatch(sharedRun.stderr + sharedRun.stdout, /do not fill a solid rectangle/,
'the domain check defers to the placement error instead of blaming the block');
// A table with no tag groups nothing and stays placeable by coordinates.