incitaciones 0.5.0 → 0.6.0

package/README.md

@@ -93,8 +93,8 @@ After changing distilled content or manifest entries, run `just generate-pi-reso
 ### Publishing a new version
 
 ```bash
-npm version patch   # bumps to 0.2.1, creates a git tag
-npm version minor   # bumps to 0.3.0
+npm version patch   # bumps to 0.5.1, creates a git tag
+npm version minor   # bumps to 0.6.0
 npm version major   # bumps to 1.0.0
 
 git push --tags     # triggers CI → auto-publishes to npm

package/content/distilled/codebase-cartography/SKILL.md

@@ -31,6 +31,7 @@ Pick the entry level from the request:
 - Before gathering evidence for any map (and again before rendering), read `references/zoom-levels.md` — per-level evidence collection commands and text rendering formats.
 - Before any health check or when the user asks about "health", "smells", or refactoring targets, read `references/smell-signatures.md` — anti-pattern proxies, evidence requirements, severity ratings.
 - Before writing the final output, read `references/report-template.md` — output structure per mode.
+- When the user asks for an HTML export or a shareable version of the report, read the "Optional HTML Export" section at the end of `references/report-template.md`.
 
 ## Zoom Discipline
 
@@ -47,3 +48,4 @@ Pick the entry level from the request:
 - Prefer structural facts over narrative: dependency direction, counts, boundaries.
 - Health-check findings follow the evidence format in `references/smell-signatures.md` (pattern, evidence, quantity, severity) — never unanchored opinions.
 - Maps are diff-able artifacts: tables and Mermaid, not prose walls.
+- HTML export is derived output, produced only on request; the markdown report remains the artifact of record.

package/content/distilled/codebase-cartography/references/report-template.md

@@ -59,3 +59,17 @@ One finding block per pattern (format in `smell-signatures.md`), ordered by seve
 ```
 
 **Adjacent levels offered** — one line each, e.g. "meso map of ledger available on request".
+
+## Optional HTML Export
+
+Produce only on request ("export as HTML", "shareable report"). The markdown report is the source of truth; the HTML file is a derived, regenerable view — never hand-edit it, regenerate it from the markdown.
+
+Produce ONE self-contained file, `cartography-<level>-<target>.html` (e.g. `cartography-meso-payments-billing.html`; slugify the target with hyphens), next to the markdown report — or, if no report file was written this session, ask the user where to save it (default `docs/`). The zoom level in the name prevents exports of different levels overwriting each other.
+
+- **Self-contained:** one inline `<style>` block. No CDN, no external CSS/JS/fonts, no build step, no server. Must open correctly offline.
+- **No JavaScript:** diagrams render as styled `<pre>` blocks (text diagrams) or inline SVG producible without new dependencies. Keep the Mermaid source in the file (e.g. `<pre class="mermaid-source">`) so the diagram stays manipulable.
+- **Mirror, don't redesign:** same sections, same order, same content as the markdown report. The HTML adds presentation only (readable typography; `prefers-color-scheme` support optional).
+- **Deterministic:** stable section order, no timestamps, no generator metadata.
+- **Size guard:** render large reports as-is; never paginate, collapse, or add interactivity.
+
+Do not evolve the export into an application — no servers, frameworks, or interactive controls. If live interaction is requested, note it is out of scope for this skill.

package/content/manifest.json

@@ -3842,7 +3842,8 @@
               "references/report-template.md",
               "key relationships",
               "observations",
-              "open questions"
+              "open questions",
+              "html export"
             ]
           }
         ],
@@ -3882,7 +3883,8 @@
             "aliases": [
               "references/report-template.md",
               "report-template.md",
-              "report template"
+              "report template",
+              "html export"
             ]
           }
         ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "incitaciones",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Reusable prompts and skills for CLI LLM tools, with native pi package support.",
   "repository": {
     "type": "git",

package/pi-package/skills/codebase-cartography/SKILL.md

@@ -37,6 +37,7 @@ Pick the entry level from the request:
 - Before gathering evidence for any map (and again before rendering), read `references/zoom-levels.md` — per-level evidence collection commands and text rendering formats.
 - Before any health check or when the user asks about "health", "smells", or refactoring targets, read `references/smell-signatures.md` — anti-pattern proxies, evidence requirements, severity ratings.
 - Before writing the final output, read `references/report-template.md` — output structure per mode.
+- When the user asks for an HTML export or a shareable version of the report, read the "Optional HTML Export" section at the end of `references/report-template.md`.
 
 ## Zoom Discipline
 
@@ -53,3 +54,4 @@ Pick the entry level from the request:
 - Prefer structural facts over narrative: dependency direction, counts, boundaries.
 - Health-check findings follow the evidence format in `references/smell-signatures.md` (pattern, evidence, quantity, severity) — never unanchored opinions.
 - Maps are diff-able artifacts: tables and Mermaid, not prose walls.
+- HTML export is derived output, produced only on request; the markdown report remains the artifact of record.

package/pi-package/skills/codebase-cartography/references/report-template.md

@@ -59,3 +59,17 @@ One finding block per pattern (format in `smell-signatures.md`), ordered by seve
 ```
 
 **Adjacent levels offered** — one line each, e.g. "meso map of ledger available on request".
+
+## Optional HTML Export
+
+Produce only on request ("export as HTML", "shareable report"). The markdown report is the source of truth; the HTML file is a derived, regenerable view — never hand-edit it, regenerate it from the markdown.
+
+Produce ONE self-contained file, `cartography-<level>-<target>.html` (e.g. `cartography-meso-payments-billing.html`; slugify the target with hyphens), next to the markdown report — or, if no report file was written this session, ask the user where to save it (default `docs/`). The zoom level in the name prevents exports of different levels overwriting each other.
+
+- **Self-contained:** one inline `<style>` block. No CDN, no external CSS/JS/fonts, no build step, no server. Must open correctly offline.
+- **No JavaScript:** diagrams render as styled `<pre>` blocks (text diagrams) or inline SVG producible without new dependencies. Keep the Mermaid source in the file (e.g. `<pre class="mermaid-source">`) so the diagram stays manipulable.
+- **Mirror, don't redesign:** same sections, same order, same content as the markdown report. The HTML adds presentation only (readable typography; `prefers-color-scheme` support optional).
+- **Deterministic:** stable section order, no timestamps, no generator metadata.
+- **Size guard:** render large reports as-is; never paginate, collapse, or add interactivity.
+
+Do not evolve the export into an application — no servers, frameworks, or interactive controls. If live interaction is requested, note it is out of scope for this skill.