@c4a/context-cli 0.7.5 → 0.7.8

package/indexers/bundles/context-code-indexer/references/article-catalog/adapter-integration-article-catalog.md

@@ -0,0 +1,20 @@
+# Article choices
+
+Use the current authority to choose an allowed intent and an applicable template. These are alternatives or complementary articles within one topic; do not generate every row. Author receives the chosen blueprint through its current workset. Missing evidence calls for an entry or a named investigation step, not invented conclusions.
+
+| Template | Reader article |
+| --- | --- |
+| `adapter-integration-c01-page` | 模块／知识入口 |
+| `adapter-integration-c03-page` | 术语与标识 |
+| `adapter-integration-c04-page` | 依赖与协作边界 |
+| `adapter-integration-c05-page` | 已知问题与排障 |
+| `adapter-integration-c07-page` | 从知识继续查源码 |
+| `adapter-integration-d02-page` | 业务流程与跨层链路 |
+| `adapter-integration-d04-page` | 运维与排障入口 |
+| `adapter-integration-f09-page` | 构建与部署 |
+| `adapter-integration-l01-page` | 公共能力与使用指南 |
+| `adapter-integration-l04-page` | 中间件、适配与运行模式 |
+| `adapter-integration-q03-page` | 用例目录 |
+| `adapter-integration-q05-page` | 测试数据与环境 |
+| `adapter-integration-s01-page` | 服务概览 |
+| `adapter-integration-s06-page` | 外部依赖 |

package/indexers/bundles/context-code-indexer/references/article-catalog/api-service-article-catalog.md

@@ -0,0 +1,20 @@
+# Article choices
+
+Use the current authority to choose an allowed intent and an applicable template. These are alternatives or complementary articles within one topic; do not generate every row. Author receives the chosen blueprint through its current workset. Missing evidence calls for an entry or a named investigation step, not invented conclusions.
+
+| Template | Reader article |
+| --- | --- |
+| `api-service-c01-page` | 模块／知识入口 |
+| `api-service-c03-page` | 术语与标识 |
+| `api-service-c04-page` | 依赖与协作边界 |
+| `api-service-c05-page` | 已知问题与排障 |
+| `api-service-c07-page` | 从知识继续查源码 |
+| `api-service-d02-page` | 业务流程与跨层链路 |
+| `api-service-d04-page` | 运维与排障入口 |
+| `api-service-f09-page` | 构建与部署 |
+| `api-service-q03-page` | 用例目录 |
+| `api-service-q05-page` | 测试数据与环境 |
+| `api-service-s01-page` | 服务概览 |
+| `api-service-s02-page` | API 目录 |
+| `api-service-s03-page` | API／操作详情 |
+| `api-service-s06-page` | 外部依赖 |

package/indexers/bundles/context-code-indexer/references/article-catalog/background-runtime-article-catalog.md

@@ -0,0 +1,19 @@
+# Article choices
+
+Use the current authority to choose an allowed intent and an applicable template. These are alternatives or complementary articles within one topic; do not generate every row. Author receives the chosen blueprint through its current workset. Missing evidence calls for an entry or a named investigation step, not invented conclusions.
+
+| Template | Reader article |
+| --- | --- |
+| `background-runtime-c01-page` | 模块／知识入口 |
+| `background-runtime-c03-page` | 术语与标识 |
+| `background-runtime-c04-page` | 依赖与协作边界 |
+| `background-runtime-c05-page` | 已知问题与排障 |
+| `background-runtime-c07-page` | 从知识继续查源码 |
+| `background-runtime-d02-page` | 业务流程与跨层链路 |
+| `background-runtime-d04-page` | 运维与排障入口 |
+| `background-runtime-f09-page` | 构建与部署 |
+| `background-runtime-q03-page` | 用例目录 |
+| `background-runtime-q05-page` | 测试数据与环境 |
+| `background-runtime-s01-page` | 服务概览 |
+| `background-runtime-s06-page` | 外部依赖 |
+| `background-runtime-s07-page` | 事件、任务与对账 |

package/indexers/bundles/context-code-indexer/references/article-catalog/cli-tool-article-catalog.md

@@ -0,0 +1,17 @@
+# Article choices
+
+Use the current authority to choose an allowed intent and an applicable template. These are alternatives or complementary articles within one topic; do not generate every row. Author receives the chosen blueprint through its current workset. Missing evidence calls for an entry or a named investigation step, not invented conclusions.
+
+| Template | Reader article |
+| --- | --- |
+| `cli-tool-c01-page` | 模块／知识入口 |
+| `cli-tool-c03-page` | 术语与标识 |
+| `cli-tool-c04-page` | 依赖与协作边界 |
+| `cli-tool-c05-page` | 已知问题与排障 |
+| `cli-tool-c07-page` | 从知识继续查源码 |
+| `cli-tool-d04-page` | 运维与排障入口 |
+| `cli-tool-f09-page` | 构建与部署 |
+| `cli-tool-l01-page` | 公共能力与使用指南 |
+| `cli-tool-q03-page` | 用例目录 |
+| `cli-tool-q05-page` | 测试数据与环境 |
+| `cli-tool-q06-page` | 工具与排障工具箱 |

package/indexers/bundles/context-code-indexer/references/article-catalog/component-library-article-catalog.md

@@ -0,0 +1,18 @@
+# Article choices
+
+Use the current authority to choose an allowed intent and an applicable template. These are alternatives or complementary articles within one topic; do not generate every row. Author receives the chosen blueprint through its current workset. Missing evidence calls for an entry or a named investigation step, not invented conclusions.
+
+| Template | Reader article |
+| --- | --- |
+| `component-library-c01-page` | 模块／知识入口 |
+| `component-library-c03-page` | 术语与标识 |
+| `component-library-c04-page` | 依赖与协作边界 |
+| `component-library-c05-page` | 已知问题与排障 |
+| `component-library-c07-page` | 从知识继续查源码 |
+| `component-library-d04-page` | 运维与排障入口 |
+| `component-library-f09-page` | 构建与部署 |
+| `component-library-l02-page` | 公共组件与组件家族 |
+| `component-library-l03-page` | 设计系统及基础规范 |
+| `component-library-l05-page` | 组件库总览与接入 |
+| `component-library-q03-page` | 用例目录 |
+| `component-library-q05-page` | 测试数据与环境 |

package/indexers/bundles/context-code-indexer/references/article-catalog/contract-source-article-catalog.md

@@ -0,0 +1,17 @@
+# Article choices
+
+Use the current authority to choose an allowed intent and an applicable template. These are alternatives or complementary articles within one topic; do not generate every row. Author receives the chosen blueprint through its current workset. Missing evidence calls for an entry or a named investigation step, not invented conclusions.
+
+| Template | Reader article |
+| --- | --- |
+| `contract-source-c01-page` | 模块／知识入口 |
+| `contract-source-c03-page` | 术语与标识 |
+| `contract-source-c04-page` | 依赖与协作边界 |
+| `contract-source-c05-page` | 已知问题与排障 |
+| `contract-source-c07-page` | 从知识继续查源码 |
+| `contract-source-d04-page` | 运维与排障入口 |
+| `contract-source-f06-page` | 类型模型 |
+| `contract-source-f09-page` | 构建与部署 |
+| `contract-source-q03-page` | 用例目录 |
+| `contract-source-q05-page` | 测试数据与环境 |
+| `contract-source-s02-page` | API 目录 |

package/indexers/bundles/context-code-indexer/references/article-catalog/data-sync-reconciliation-article-catalog.md

@@ -0,0 +1,19 @@
+# Article choices
+
+Use the current authority to choose an allowed intent and an applicable template. These are alternatives or complementary articles within one topic; do not generate every row. Author receives the chosen blueprint through its current workset. Missing evidence calls for an entry or a named investigation step, not invented conclusions.
+
+| Template | Reader article |
+| --- | --- |
+| `data-sync-reconciliation-c01-page` | 模块／知识入口 |
+| `data-sync-reconciliation-c03-page` | 术语与标识 |
+| `data-sync-reconciliation-c04-page` | 依赖与协作边界 |
+| `data-sync-reconciliation-c05-page` | 已知问题与排障 |
+| `data-sync-reconciliation-c07-page` | 从知识继续查源码 |
+| `data-sync-reconciliation-d02-page` | 业务流程与跨层链路 |
+| `data-sync-reconciliation-d04-page` | 运维与排障入口 |
+| `data-sync-reconciliation-f09-page` | 构建与部署 |
+| `data-sync-reconciliation-q03-page` | 用例目录 |
+| `data-sync-reconciliation-q05-page` | 测试数据与环境 |
+| `data-sync-reconciliation-s01-page` | 服务概览 |
+| `data-sync-reconciliation-s06-page` | 外部依赖 |
+| `data-sync-reconciliation-s07-page` | 事件、任务与对账 |

package/indexers/bundles/context-code-indexer/references/article-catalog/derived-generated-source-article-catalog.md

@@ -0,0 +1,17 @@
+# Article choices
+
+Use the current authority to choose an allowed intent and an applicable template. These are alternatives or complementary articles within one topic; do not generate every row. Author receives the chosen blueprint through its current workset. Missing evidence calls for an entry or a named investigation step, not invented conclusions.
+
+| Template | Reader article |
+| --- | --- |
+| `derived-generated-source-c01-page` | 模块／知识入口 |
+| `derived-generated-source-c03-page` | 术语与标识 |
+| `derived-generated-source-c04-page` | 依赖与协作边界 |
+| `derived-generated-source-c05-page` | 已知问题与排障 |
+| `derived-generated-source-c07-page` | 从知识继续查源码 |
+| `derived-generated-source-d04-page` | 运维与排障入口 |
+| `derived-generated-source-f06-page` | 类型模型 |
+| `derived-generated-source-f09-page` | 构建与部署 |
+| `derived-generated-source-q03-page` | 用例目录 |
+| `derived-generated-source-q05-page` | 测试数据与环境 |
+| `derived-generated-source-s02-page` | API 目录 |

package/indexers/bundles/context-code-indexer/references/article-catalog/domain-service-article-catalog.md

@@ -0,0 +1,23 @@
+# Article choices
+
+Use the current authority to choose an allowed intent and an applicable template. These are alternatives or complementary articles within one topic; do not generate every row. Author receives the chosen blueprint through its current workset. Missing evidence calls for an entry or a named investigation step, not invented conclusions.
+
+| Template | Reader article |
+| --- | --- |
+| `domain-service-c01-page` | 模块／知识入口 |
+| `domain-service-c02-page` | 业务概览 |
+| `domain-service-c03-page` | 术语与标识 |
+| `domain-service-c04-page` | 依赖与协作边界 |
+| `domain-service-c05-page` | 已知问题与排障 |
+| `domain-service-c07-page` | 从知识继续查源码 |
+| `domain-service-d02-page` | 业务流程与跨层链路 |
+| `domain-service-d03-page` | 业务规则 |
+| `domain-service-d04-page` | 运维与排障入口 |
+| `domain-service-f09-page` | 构建与部署 |
+| `domain-service-q03-page` | 用例目录 |
+| `domain-service-q05-page` | 测试数据与环境 |
+| `domain-service-s01-page` | 服务概览 |
+| `domain-service-s03-page` | API／操作详情 |
+| `domain-service-s04-page` | 领域模型 |
+| `domain-service-s05-page` | 数据模型 |
+| `domain-service-s06-page` | 外部依赖 |

package/indexers/bundles/context-code-indexer/references/article-catalog/event-consumer-article-catalog.md

@@ -0,0 +1,19 @@
+# Article choices
+
+Use the current authority to choose an allowed intent and an applicable template. These are alternatives or complementary articles within one topic; do not generate every row. Author receives the chosen blueprint through its current workset. Missing evidence calls for an entry or a named investigation step, not invented conclusions.
+
+| Template | Reader article |
+| --- | --- |
+| `event-consumer-c01-page` | 模块／知识入口 |
+| `event-consumer-c03-page` | 术语与标识 |
+| `event-consumer-c04-page` | 依赖与协作边界 |
+| `event-consumer-c05-page` | 已知问题与排障 |
+| `event-consumer-c07-page` | 从知识继续查源码 |
+| `event-consumer-d02-page` | 业务流程与跨层链路 |
+| `event-consumer-d04-page` | 运维与排障入口 |
+| `event-consumer-f09-page` | 构建与部署 |
+| `event-consumer-q03-page` | 用例目录 |
+| `event-consumer-q05-page` | 测试数据与环境 |
+| `event-consumer-s01-page` | 服务概览 |
+| `event-consumer-s06-page` | 外部依赖 |
+| `event-consumer-s07-page` | 事件、任务与对账 |

package/indexers/bundles/context-code-indexer/references/article-catalog/gateway-facade-article-catalog.md

@@ -0,0 +1,21 @@
+# Article choices
+
+Use the current authority to choose an allowed intent and an applicable template. These are alternatives or complementary articles within one topic; do not generate every row. Author receives the chosen blueprint through its current workset. Missing evidence calls for an entry or a named investigation step, not invented conclusions.
+
+| Template | Reader article |
+| --- | --- |
+| `gateway-facade-c01-page` | 模块／知识入口 |
+| `gateway-facade-c03-page` | 术语与标识 |
+| `gateway-facade-c04-page` | 依赖与协作边界 |
+| `gateway-facade-c05-page` | 已知问题与排障 |
+| `gateway-facade-c07-page` | 从知识继续查源码 |
+| `gateway-facade-d02-page` | 业务流程与跨层链路 |
+| `gateway-facade-d04-page` | 运维与排障入口 |
+| `gateway-facade-f09-page` | 构建与部署 |
+| `gateway-facade-l04-page` | 中间件、适配与运行模式 |
+| `gateway-facade-q03-page` | 用例目录 |
+| `gateway-facade-q05-page` | 测试数据与环境 |
+| `gateway-facade-s01-page` | 服务概览 |
+| `gateway-facade-s02-page` | API 目录 |
+| `gateway-facade-s03-page` | API／操作详情 |
+| `gateway-facade-s06-page` | 外部依赖 |

package/indexers/bundles/context-code-indexer/references/article-catalog/monorepo-container-article-catalog.md

@@ -0,0 +1,17 @@
+# Article choices
+
+Use the current authority to choose an allowed intent and an applicable template. These are alternatives or complementary articles within one topic; do not generate every row. Author receives the chosen blueprint through its current workset. Missing evidence calls for an entry or a named investigation step, not invented conclusions.
+
+| Template | Reader article |
+| --- | --- |
+| `monorepo-container-c01-page` | 模块／知识入口 |
+| `monorepo-container-c03-page` | 术语与标识 |
+| `monorepo-container-c04-page` | 依赖与协作边界 |
+| `monorepo-container-c05-page` | 已知问题与排障 |
+| `monorepo-container-c07-page` | 从知识继续查源码 |
+| `monorepo-container-d01-page` | 领域架构与服务地图 |
+| `monorepo-container-d04-page` | 运维与排障入口 |
+| `monorepo-container-f09-page` | 构建与部署 |
+| `monorepo-container-f11-page` | 子应用目录与详情 |
+| `monorepo-container-q03-page` | 用例目录 |
+| `monorepo-container-q05-page` | 测试数据与环境 |

package/indexers/bundles/context-code-indexer/references/article-catalog/plugin-extension-article-catalog.md

@@ -0,0 +1,17 @@
+# Article choices
+
+Use the current authority to choose an allowed intent and an applicable template. These are alternatives or complementary articles within one topic; do not generate every row. Author receives the chosen blueprint through its current workset. Missing evidence calls for an entry or a named investigation step, not invented conclusions.
+
+| Template | Reader article |
+| --- | --- |
+| `plugin-extension-c01-page` | 模块／知识入口 |
+| `plugin-extension-c03-page` | 术语与标识 |
+| `plugin-extension-c04-page` | 依赖与协作边界 |
+| `plugin-extension-c05-page` | 已知问题与排障 |
+| `plugin-extension-c07-page` | 从知识继续查源码 |
+| `plugin-extension-d04-page` | 运维与排障入口 |
+| `plugin-extension-f09-page` | 构建与部署 |
+| `plugin-extension-l01-page` | 公共能力与使用指南 |
+| `plugin-extension-l04-page` | 中间件、适配与运行模式 |
+| `plugin-extension-q03-page` | 用例目录 |
+| `plugin-extension-q05-page` | 测试数据与环境 |

package/indexers/bundles/context-code-indexer/references/article-catalog/sdk-library-article-catalog.md

@@ -0,0 +1,18 @@
+# Article choices
+
+Use the current authority to choose an allowed intent and an applicable template. These are alternatives or complementary articles within one topic; do not generate every row. Author receives the chosen blueprint through its current workset. Missing evidence calls for an entry or a named investigation step, not invented conclusions.
+
+| Template | Reader article |
+| --- | --- |
+| `sdk-library-c01-page` | 模块／知识入口 |
+| `sdk-library-c03-page` | 术语与标识 |
+| `sdk-library-c04-page` | 依赖与协作边界 |
+| `sdk-library-c05-page` | 已知问题与排障 |
+| `sdk-library-c07-page` | 从知识继续查源码 |
+| `sdk-library-d04-page` | 运维与排障入口 |
+| `sdk-library-f09-page` | 构建与部署 |
+| `sdk-library-l01-page` | 公共能力与使用指南 |
+| `sdk-library-l03-page` | 设计系统及基础规范 |
+| `sdk-library-l04-page` | 中间件、适配与运行模式 |
+| `sdk-library-q03-page` | 用例目录 |
+| `sdk-library-q05-page` | 测试数据与环境 |

package/indexers/bundles/context-code-indexer/references/article-catalog/storage-repository-article-catalog.md

@@ -0,0 +1,19 @@
+# Article choices
+
+Use the current authority to choose an allowed intent and an applicable template. These are alternatives or complementary articles within one topic; do not generate every row. Author receives the chosen blueprint through its current workset. Missing evidence calls for an entry or a named investigation step, not invented conclusions.
+
+| Template | Reader article |
+| --- | --- |
+| `storage-repository-c01-page` | 模块／知识入口 |
+| `storage-repository-c03-page` | 术语与标识 |
+| `storage-repository-c04-page` | 依赖与协作边界 |
+| `storage-repository-c05-page` | 已知问题与排障 |
+| `storage-repository-c07-page` | 从知识继续查源码 |
+| `storage-repository-d02-page` | 业务流程与跨层链路 |
+| `storage-repository-d04-page` | 运维与排障入口 |
+| `storage-repository-f09-page` | 构建与部署 |
+| `storage-repository-q03-page` | 用例目录 |
+| `storage-repository-q05-page` | 测试数据与环境 |
+| `storage-repository-s01-page` | 服务概览 |
+| `storage-repository-s05-page` | 数据模型 |
+| `storage-repository-s06-page` | 外部依赖 |

package/indexers/bundles/context-code-indexer/references/article-catalog/web-application-article-catalog.md

@@ -0,0 +1,30 @@
+# Article choices
+
+Use the current authority to choose an allowed intent and an applicable template. These are alternatives or complementary articles within one topic; do not generate every row. Author receives the chosen blueprint through its current workset. Missing evidence calls for an entry or a named investigation step, not invented conclusions.
+
+| Template | Reader article |
+| --- | --- |
+| `web-application-c01-page` | 模块／知识入口 |
+| `web-application-c02-page` | 业务概览 |
+| `web-application-c03-page` | 术语与标识 |
+| `web-application-c04-page` | 依赖与协作边界 |
+| `web-application-c05-page` | 已知问题与排障 |
+| `web-application-c07-page` | 从知识继续查源码 |
+| `web-application-d02-page` | 业务流程与跨层链路 |
+| `web-application-d03-page` | 业务规则 |
+| `web-application-d04-page` | 运维与排障入口 |
+| `web-application-f01-page` | 架构 |
+| `web-application-f02-page` | 路由与页面地图 |
+| `web-application-f03-page` | 页面／用户任务详情 |
+| `web-application-f04-page` | 状态与数据流 |
+| `web-application-f05-page` | API 集成 |
+| `web-application-f06-page` | 类型模型 |
+| `web-application-f07-page` | 应用内组件与复用边界 |
+| `web-application-f08-page` | 样式与设计系统 |
+| `web-application-f09-page` | 构建与部署 |
+| `web-application-f10-page` | 宿主与微前端 |
+| `web-application-f11-page` | 子应用目录与详情 |
+| `web-application-f12-page` | 应用内部组件定位与修改指南 |
+| `web-application-q03-page` | 用例目录 |
+| `web-application-q05-page` | 测试数据与环境 |
+| `web-application-s04-page` | 领域模型 |

package/indexers/bundles/context-code-indexer/references/composers/public-contract.md

@@ -10,7 +10,7 @@ Run only for an effective `public-contract` composer workset. Consume the
 workset-scoped `PrimaryResultView`; do not inspect a broader repository or
 replace the primary Result.
 
-Require an evidenced `public-surface` fact and its owning primary `content`
+Require an evidenced `code-symbol` fact and its owning primary `content`
 Artifact. Propose a `contract` Artifact only when the view establishes stable
 consumer identities, entrypoints, behavior, constraints, and evidence. Group
 related exports, commands, routes, or extension points by the public concept a
@@ -21,3 +21,15 @@ Artifact policy variant, and cite evidence already present in the view. Return
 only a post-author `derived-artifact-proposal` fragment. If either required
 input is absent or no independent reader question is supported, return the
 normal layer-fragment result with `fragments: []`.
+
+The `code-symbol` kind is the parser-backed fact carrier, not a guarantee that
+an independent contract page is useful. Check its public entrypoints, visibility,
+types and resolution limits. Do not turn declaration-only information into a
+runtime guarantee, or duplicate an API table already present in the primary page.
+
+Keep the distinction between display targets and supporting implementation/type
+facts when assessing a derived page. An empty fragment avoids an unnecessary
+derived page; it does not certify that a primary table is correct. Report a
+concrete discrepancy for the existing Review/repair flow, without replacing the
+primary Result or silently changing its generated rows. Stay within this
+Composer's declared result schema and actions.

package/indexers/bundles/context-code-indexer/references/diagrams.md

@@ -0,0 +1,122 @@
+# Source-grounded diagrams
+
+Use a diagram only when it clarifies a reader task better than prose or a table.
+This guidance applies to existing templates and selected article programs alike.
+It does not require a diagram, create a new article type, or add a completion gate.
+
+## Choose the representation
+
+| Reader question | Representation | Place in the article |
+| --- | --- | --- |
+| Which layers or services depend on each other? | Mermaid `flowchart LR` | Architecture or dependencies, after the scope |
+| What action happens next, including failures? | Mermaid `flowchart TD` | Behavior or business flow |
+| Who communicates, and in what order? | Mermaid `sequenceDiagram` | Request, integration or event processing |
+| What changes state, under which conditions? | Mermaid `stateDiagram-v2` | State behavior, alongside transition evidence |
+| How are persisted entities related? | Mermaid `erDiagram` | Data model, beside the entity/relationship table |
+| Where are files, articles or component parts? | Fenced `text` tree | Entry map or composition |
+| What are exact fields, routes, keys or source locations? | Markdown table | Contract, catalog or source references |
+| What does a component or visual foundation look like? | Authorized source image with caption and text | Usage or design foundation; diagrams do not prove visual appearance |
+
+A domain concept relationship can use a labeled flowchart rather than pretending
+it is a database ER model. Unrelated entities belong in a catalog table. Do not
+infer transitions from enum order, cardinality from field names, runtime calls
+from package dependencies, or sequencing from a list of imports.
+
+## Writing and evidence
+
+Start with one sentence stating what the diagram explains and its applicable
+scope/version. Follow it with a short explanation and source coordinates or a
+compact node/edge-to-source table. The reader must still have a useful next
+inspection step when the consumer cannot render Mermaid. Keep Mermaid fenced
+source in the article; do not replace the only editable representation with an image.
+
+Every asserted relationship needs support in the authorized source. A registered
+route does not prove runtime access; a client contract does not prove a call.
+Stop at a named external boundary when its implementation is unavailable and say
+what material is needed next. Keep proposals and historical accounts explicitly
+labeled; notes and conversations do not automatically establish current behavior.
+Do not copy a source diagram without checking its version and evidence scope.
+
+One diagram answers one question. Split an unreadable graph by responsibility,
+not an arbitrary node limit. Link related diagrams instead of repeating them in
+an overview, API page and source-entry page. A short page can omit the diagram.
+
+## Style
+
+- Prefer simple Mermaid constructs: flowchart, sequenceDiagram, stateDiagram-v2
+  and erDiagram. Use `text` for trees, not large ASCII boxes for relationships.
+- Prefer left-to-right for architecture and top-to-bottom for decisions. Use
+  subgraphs only for real ownership, process or deployment boundaries.
+- Use short stable ASCII node IDs and quoted human-readable labels in the reader's
+  language. Preserve exact service, API and state identifiers where they matter.
+- Label edges with the relation or action. Sequence arrows show communication;
+  state arrows show a named trigger/condition. Do not reuse an unexplained arrow
+  for imports, runtime calls and data ownership.
+- Keep default theme and simple shapes. Avoid custom HTML, scripts, click actions,
+  remote icons, theme directives and color-only meanings. Do not hardcode a canvas
+  size; let the consumer theme and layout render it.
+- Put long paths and citations outside node labels. Unknown relationships are
+  explained in text, not connected speculatively to make the picture complete.
+- An optional syntax/render warning is not a writing gate. Correct malformed
+  syntax or retain the accurate textual explanation; do not invent evidence to
+  satisfy a diagram checker. Never claim rendering was tested unless it was.
+
+## Small anonymous examples
+
+The following fragments demonstrate notation only; they are not facts to copy.
+Use only the fragment whose relationships are supported by the current source.
+
+Architecture: the two arrows describe different, explicit relationships.
+
+```mermaid
+flowchart LR
+  page["Order page"] -->|requests| api["Order API"]
+  api -->|writes| store["Order repository"]
+```
+
+Decision flow: a failed validation has a visible outcome.
+
+```mermaid
+flowchart TD
+  submit["Submit draft"] --> valid{"Input valid?"}
+  valid -->|yes| save["Save order"]
+  valid -->|no| feedback["Keep draft and show error"]
+```
+
+Sequence: branches are supported outcomes, not asserted deployment success.
+
+```mermaid
+sequenceDiagram
+  participant UI as Order page
+  participant API as Order API
+  UI->>API: Submit draft
+  alt Invalid input
+    API-->>UI: Validation error
+  else Valid input
+    API-->>UI: Order identifier
+  end
+```
+
+State: include this only when the transition implementation or specification is known.
+
+```mermaid
+stateDiagram-v2
+  Draft --> Submitted: submit / validation succeeds
+  Submitted --> Cancelled: cancel / cancellation allowed
+```
+
+ER: the cardinality must come from a schema or supported relationship contract.
+
+```mermaid
+erDiagram
+  ORDER ||--|{ ORDER_LINE : contains
+```
+
+Tree: directory membership does not imply runtime invocation.
+
+```text
+Order module
+├── Entry and scope
+├── Request contract
+└── Source investigation
+```