@kaddo/cli 3.120.0 → 3.121.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/core.js CHANGED
@@ -3555,6 +3555,9 @@ function buildPocReportContext(dir) {
3555
3555
  `Canonical conclusion: ${poc.conclusion}. Do not contradict it.`,
3556
3556
  "Use the 15 canonical sections. Mark missing evidence as Not evaluated, Not applicable, or No evidence available.",
3557
3557
  "Distinguish measured, calculated, estimated, and projected values. Never include secret values.",
3558
+ "Choose the representation that best communicates each grounded fact: Markdown tables for structured comparisons, Mermaid for grounded architecture, flows, or relationships, and prose for explanation and interpretation.",
3559
+ "Do not invent data, entities, relationships, priorities, or metrics to create a table or diagram. Do not use ASCII diagrams when Mermaid can represent the same grounded flow.",
3560
+ "In Traceability, use repository-relative Markdown links or paths. Never use file:/// URLs or local absolute filesystem paths.",
3558
3561
  "",
3559
3562
  "Selected sources:",
3560
3563
  sourceList
@@ -4846,6 +4849,49 @@ After a POC has a canonical conclusion and Core has prepared its deterministic r
4846
4849
  - Use \`Not evaluated in this POC.\`, \`Not applicable.\`, or \`No evidence available.\` when sources do not support a section.
4847
4850
  - Return a proposal for human review; Core persists it only after confirmation.
4848
4851
 
4852
+ ## Representation selection
4853
+
4854
+ - Use prose for context, interpretation, rationale, findings, and conclusions.
4855
+ - Use a Markdown table when supplied evidence has comparable rows, such as success criteria and
4856
+ outcomes, resources, experiments, measurements, costs, risks, recommendations, or traceability.
4857
+ - Use Mermaid only for architecture, topology, or flow relationships explicitly supported by the
4858
+ supplied sources. Prefer it to an ASCII diagram when both can represent the same grounded flow.
4859
+ - Tables and diagrams are communication tools, not completeness requirements. Do not produce one
4860
+ when the context does not support a useful representation.
4861
+ - Never invent table rows, diagram nodes or edges, statuses, priorities, metrics, or relationships
4862
+ to make a report look more complete.
4863
+ - Preserve measured, calculated, estimated, and projected semantics in every representation.
4864
+ - In Traceability, use repository-relative Markdown links or paths; never emit \`file:///\` URLs or
4865
+ local absolute filesystem paths.
4866
+
4867
+ ## Section representation guide
4868
+
4869
+ | Section | Preferred representation when supported by evidence |
4870
+ |---|---|
4871
+ | Executive Summary | Snapshot table and short prose |
4872
+ | Problem and Objective | Prose |
4873
+ | Hypothesis and Success Criteria | Evaluation matrix |
4874
+ | Scope, Constraints and Non-goals | Compact bullets or table |
4875
+ | Technical Approach and Architecture | Mermaid and prose |
4876
+ | Infrastructure and Project Resources | Table, with optional Mermaid |
4877
+ | Implementation and Relevant Technical Decisions | Table or concise prose |
4878
+ | Experiments and Validation | Validation matrix |
4879
+ | Results and Measurements | Measurement tables |
4880
+ | Cost and Efficiency Analysis | Comparison table |
4881
+ | Observability and Operational Findings | Table or prose |
4882
+ | Findings, Learnings, Limitations and Risks | Structured matrix |
4883
+ | Conclusion | Status and concise prose |
4884
+ | Recommendation and Next Steps | Recommendation matrix only when priority is evidenced |
4885
+ | Traceability and Sources | Relative-link table or list |
4886
+
4887
+ ## Quality checklist
4888
+
4889
+ - Structured evidence uses tables when clearer than prose.
4890
+ - Grounded architecture or flows use Mermaid when useful; no decorative or unsupported diagrams exist.
4891
+ - Tables and Mermaid preserve source grounding and measurement semantics.
4892
+ - Traceability contains repository-portable paths.
4893
+ - The report is scannable before reading the full narrative.
4894
+
4849
4895
  ## Required structure
4850
4896
 
4851
4897
  1. Executive Summary
package/dist/index.js CHANGED
@@ -3214,6 +3214,49 @@ After a POC has a canonical conclusion and Core has prepared its deterministic r
3214
3214
  - Use \`Not evaluated in this POC.\`, \`Not applicable.\`, or \`No evidence available.\` when sources do not support a section.
3215
3215
  - Return a proposal for human review; Core persists it only after confirmation.
3216
3216
 
3217
+ ## Representation selection
3218
+
3219
+ - Use prose for context, interpretation, rationale, findings, and conclusions.
3220
+ - Use a Markdown table when supplied evidence has comparable rows, such as success criteria and
3221
+ outcomes, resources, experiments, measurements, costs, risks, recommendations, or traceability.
3222
+ - Use Mermaid only for architecture, topology, or flow relationships explicitly supported by the
3223
+ supplied sources. Prefer it to an ASCII diagram when both can represent the same grounded flow.
3224
+ - Tables and diagrams are communication tools, not completeness requirements. Do not produce one
3225
+ when the context does not support a useful representation.
3226
+ - Never invent table rows, diagram nodes or edges, statuses, priorities, metrics, or relationships
3227
+ to make a report look more complete.
3228
+ - Preserve measured, calculated, estimated, and projected semantics in every representation.
3229
+ - In Traceability, use repository-relative Markdown links or paths; never emit \`file:///\` URLs or
3230
+ local absolute filesystem paths.
3231
+
3232
+ ## Section representation guide
3233
+
3234
+ | Section | Preferred representation when supported by evidence |
3235
+ |---|---|
3236
+ | Executive Summary | Snapshot table and short prose |
3237
+ | Problem and Objective | Prose |
3238
+ | Hypothesis and Success Criteria | Evaluation matrix |
3239
+ | Scope, Constraints and Non-goals | Compact bullets or table |
3240
+ | Technical Approach and Architecture | Mermaid and prose |
3241
+ | Infrastructure and Project Resources | Table, with optional Mermaid |
3242
+ | Implementation and Relevant Technical Decisions | Table or concise prose |
3243
+ | Experiments and Validation | Validation matrix |
3244
+ | Results and Measurements | Measurement tables |
3245
+ | Cost and Efficiency Analysis | Comparison table |
3246
+ | Observability and Operational Findings | Table or prose |
3247
+ | Findings, Learnings, Limitations and Risks | Structured matrix |
3248
+ | Conclusion | Status and concise prose |
3249
+ | Recommendation and Next Steps | Recommendation matrix only when priority is evidenced |
3250
+ | Traceability and Sources | Relative-link table or list |
3251
+
3252
+ ## Quality checklist
3253
+
3254
+ - Structured evidence uses tables when clearer than prose.
3255
+ - Grounded architecture or flows use Mermaid when useful; no decorative or unsupported diagrams exist.
3256
+ - Tables and Mermaid preserve source grounding and measurement semantics.
3257
+ - Traceability contains repository-portable paths.
3258
+ - The report is scannable before reading the full narrative.
3259
+
3217
3260
  ## Required structure
3218
3261
 
3219
3262
  1. Executive Summary
@@ -13110,6 +13153,9 @@ function buildPocReportContext(dir) {
13110
13153
  `Canonical conclusion: ${poc.conclusion}. Do not contradict it.`,
13111
13154
  "Use the 15 canonical sections. Mark missing evidence as Not evaluated, Not applicable, or No evidence available.",
13112
13155
  "Distinguish measured, calculated, estimated, and projected values. Never include secret values.",
13156
+ "Choose the representation that best communicates each grounded fact: Markdown tables for structured comparisons, Mermaid for grounded architecture, flows, or relationships, and prose for explanation and interpretation.",
13157
+ "Do not invent data, entities, relationships, priorities, or metrics to create a table or diagram. Do not use ASCII diagrams when Mermaid can represent the same grounded flow.",
13158
+ "In Traceability, use repository-relative Markdown links or paths. Never use file:/// URLs or local absolute filesystem paths.",
13113
13159
  "",
13114
13160
  "Selected sources:",
13115
13161
  sourceList
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@kaddo/cli",
3
- "version": "3.120.0",
3
+ "version": "3.121.0",
4
4
  "description": "Knowledge Driven Development toolkit",
5
5
  "license": "MIT",
6
6
  "repository": {