@ia-qa/self-healing 1.4.1 → 1.4.2

package/README.md

@@ -176,6 +176,24 @@ Run again with --apply to add the uncovered pages to config.pages.
 
 Then `ia-qa-heal map` captures their contracts as usual. Discovery never maps, heals, or edits a test — it only ever edits `config.json`, and only with `--apply`.
 
+## Visualize the app — `ia-qa-heal graph`
+
+Turn the mappings you already have into a **navigation graph** (page → page, derived from the `href` on each page's links — the same engine `map` uses for `_overview.md`). Read-only: it never rewrites your mapping files, it just renders them.
+
+```bash
+ia-qa-heal graph                              # Mermaid on stdout — paste into a PR comment or mermaid.live
+ia-qa-heal graph --format json                # ia-qa-graph@1 intermediate: { nodes[], edges[], meta }
+ia-qa-heal graph --format markdown --out nav-kb.md   # one card per page — a RAG chunk / Confluence page
+ia-qa-heal graph --format svg  --out nav.svg  # the same SVG map writes as _navigation.svg
+ia-qa-heal graph --format json | your-agent   # hand the graph to an agent to analyze
+```
+
+`--format` is one of `mermaid` (default) · `svg` · `json` · `markdown`; `--out <file>` writes to a file instead of stdout; `--open` opens it. `mermaid` and `svg` are the same views `map` already writes to `_navigation.md`/`_navigation.svg` — offered here for stdout/pipe.
+
+The **`json`** form is the portable `ia-qa-graph@1` IR — nodes carry `{ url, elementCount, entry, isolated }`, and `meta` carries the coverage gap (`unmapped`), collapsed hubs (`fans`), any `mesh`, and `entries`. It matches the node/edge shape the ia-qa.com Graph tool consumes, so it drops into other viewers (D3, Reagraph) without conversion.
+
+The **`markdown`** form linearizes the graph into one section per page — *what it is, where it links, what reaches it* — so a page is a self-contained chunk you can index in a **RAG knowledge base** (split on the `##` headings) or push to **Confluence** (`create_confluence_page` on the ia-qa MCP). It carries the navigation *relations* the per-page `map` contracts don't, and ends with a **Coverage gaps** list of linked-but-unmapped destinations.
+
 ## The one-verb loop: `ia-qa-heal run`
 
 `run` chains the whole loop and stops where a human belongs:

package/TUTORIAL.md

@@ -268,6 +268,14 @@ Plus, for the whole app:
   sentence, not 144 arrows). If your app is a pure catalogue, you get no graph and a note
   saying so, which is the honest answer.
 
+> 🕸️ **Want the graph on demand, or in another format?** `ia-qa-heal graph` re-emits it from
+> your mappings without re-mapping — `--format mermaid|svg|json|markdown` (default mermaid on
+> stdout, so it pipes into a PR comment or mermaid.live; `--out <file>` / `--open`). `json` is
+> the portable `ia-qa-graph@1` graph (`{nodes,edges,meta}`) for D3 / Reagraph or an agent;
+> **`markdown` gives one card per page** — a ready-made **RAG chunk** or **Confluence section**
+> (`create_confluence_page` on the ia-qa MCP), carrying the page-to-page relations the per-page
+> `.md` contracts don't. Read-only: it never rewrites the files above.
+
 Commit them.
 
 ---

package/dist/cli/graph.d.ts

@@ -0,0 +1 @@
+export declare function runGraph(args: string[]): Promise<void>;

package/dist/cli/graph.js

@@ -0,0 +1,153 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGraph = runGraph;
+const fs = __importStar(require("fs"));
+const config_1 = require("../config");
+const layout_1 = require("../layout");
+const overview_1 = require("../overview");
+const ir_1 = require("../graph/ir");
+const diff_1 = require("./diff");
+const summary_1 = require("./summary");
+/**
+ * `ia-qa-heal graph` — turn the mapped app into a navigation graph.
+ *
+ * Read-only: it loads `.ia-qa/mapping/*.json`, reuses the same overview engine
+ * `map` uses (`buildOverview` → `navigationGraph`), and emits the graph. It never
+ * rewrites `_overview.md`/`_navigation.*` — those belong to `map`; `graph` only
+ * shares the renderers. Default is Mermaid on stdout, so it pipes straight into a
+ * file, mermaid.live, or a PR comment (GitHub renders it).
+ *
+ * `mermaid`/`svg` are the same views `map` already writes to `_navigation.md`/`.svg`
+ * — offered here for stdout/pipe. `json` is the portable `ia-qa-graph@1` IR for
+ * D3/Reagraph/agents. `markdown` linearizes it into one card per page — a RAG
+ * chunk / Confluence section, carrying the navigation relations the per-page
+ * `map` contracts don't.
+ *
+ *   --format mermaid|svg|json|markdown   Output format (default mermaid)
+ *   --out <file>                         Write to a file instead of stdout
+ *   --open                               Open the output in the browser (implies a file)
+ *   --kind navigation                    Graph kind (only navigation for now)
+ */
+const FORMATS = ['mermaid', 'svg', 'json', 'markdown'];
+const DEFAULT_EXT = {
+    mermaid: 'md',
+    svg: 'svg',
+    json: 'json',
+    markdown: 'md',
+};
+async function runGraph(args) {
+    const opts = parseArgs(args);
+    const config = (0, config_1.loadConfig)();
+    const pages = (0, layout_1.collectPageMappings)((0, config_1.mappingDir)());
+    if (pages.length === 0) {
+        throw new Error('No mappings found in .ia-qa/mapping/. Run `ia-qa-heal map` first.');
+    }
+    const overview = (0, overview_1.buildOverview)(config, pages, (0, overview_1.collectLayouts)((0, config_1.layoutDir)()));
+    const graph = (0, overview_1.navigationGraph)(overview);
+    const ir = (0, ir_1.toGraphIR)(overview, graph);
+    const output = render(opts.format, ir, overview);
+    const hasDrawing = graph.nodes.length > 0;
+    // --open needs a file to point a browser at; default one when only --open is given.
+    const dest = opts.out ?? (opts.open ? `ia-qa-heal-graph.${DEFAULT_EXT[opts.format]}` : undefined);
+    if (dest) {
+        fs.writeFileSync(dest, output, 'utf8');
+        console.log(`✍  Wrote ${opts.format} graph → ${dest}`);
+        if (opts.open)
+            (0, diff_1.openInBrowser)(dest);
+    }
+    else {
+        process.stdout.write(output + '\n');
+    }
+    const drawn = graph.nodes.length;
+    const detail = [
+        `${ir.nodes.length} pages · ${ir.edges.length} links`,
+        hasDrawing ? `${drawn} drawn` : 'nothing selective to draw',
+        ir.meta.unmapped.length ? `${ir.meta.unmapped.length} uncovered` : null,
+    ].filter(Boolean);
+    (0, summary_1.summaryLine)('graph', 'ok', `${opts.format} navigation graph`, detail);
+}
+function render(format, ir, overview) {
+    switch (format) {
+        case 'mermaid':
+            // renderNavigation self-handles the empty case with an explanation.
+            return (0, overview_1.renderNavigation)(overview);
+        case 'svg':
+            return (0, overview_1.renderNavigationSvg)(overview);
+        case 'json':
+            return JSON.stringify(ir, null, 2);
+        case 'markdown':
+            return (0, ir_1.renderMarkdown)(ir);
+    }
+}
+function parseArgs(args) {
+    const opts = { format: 'mermaid', kind: 'navigation', open: false };
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        switch (a) {
+            case '--format': {
+                const value = args[++i];
+                if (!value || !FORMATS.includes(value)) {
+                    throw new Error(`--format needs one of ${FORMATS.join('|')}, got "${value ?? ''}".`);
+                }
+                opts.format = value;
+                break;
+            }
+            case '--kind': {
+                const value = args[++i];
+                if (value !== 'navigation') {
+                    throw new Error(`--kind only supports "navigation" for now, got "${value ?? ''}".`);
+                }
+                opts.kind = value;
+                break;
+            }
+            case '--out': {
+                const value = args[++i];
+                if (!value || value.startsWith('-')) {
+                    throw new Error('--out needs a file path, e.g. --out .ia-qa/graph.json.');
+                }
+                opts.out = value;
+                break;
+            }
+            case '--open':
+                opts.open = true;
+                break;
+            default:
+                throw new Error(`Unknown option "${a}" for \`graph\`. See \`ia-qa-heal help\`.`);
+        }
+    }
+    return opts;
+}
+//# sourceMappingURL=graph.js.map

package/dist/cli/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/cli/graph.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoDA,4BAkCC;AAtFD,uCAAyB;AACzB,sCAA8D;AAC9D,sCAAgD;AAChD,0CAMqB;AACrB,oCAAwD;AACxD,iCAAuC;AACvC,uCAAwC;AAExC;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,OAAO,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAU,CAAC;AAGhE,MAAM,WAAW,GAA2B;IAC1C,OAAO,EAAE,IAAI;IACb,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;IACZ,QAAQ,EAAE,IAAI;CACf,CAAC;AASK,KAAK,UAAU,QAAQ,CAAC,IAAc;IAC3C,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,IAAA,mBAAU,GAAE,CAAC;IAE5B,MAAM,KAAK,GAAG,IAAA,4BAAmB,EAAC,IAAA,mBAAU,GAAE,CAAC,CAAC;IAChD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACvF,CAAC;IAED,MAAM,QAAQ,GAAG,IAAA,wBAAa,EAAC,MAAM,EAAE,KAAK,EAAE,IAAA,yBAAc,EAAC,IAAA,kBAAS,GAAE,CAAC,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,IAAA,0BAAe,EAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,EAAE,GAAG,IAAA,cAAS,EAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAE1C,oFAAoF;IACpF,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAElG,IAAI,IAAI,EAAE,CAAC;QACT,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,MAAM,YAAY,IAAI,EAAE,CAAC,CAAC;QACvD,IAAI,IAAI,CAAC,IAAI;YAAE,IAAA,oBAAa,EAAC,IAAI,CAAC,CAAC;IACrC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;IACjC,MAAM,MAAM,GAAG;QACb,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,YAAY,EAAE,CAAC,KAAK,CAAC,MAAM,QAAQ;QACrD,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,2BAA2B;QAC3D,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,YAAY,CAAC,CAAC,CAAC,IAAI;KACxE,CAAC,MAAM,CAAC,OAAO,CAAa,CAAC;IAC9B,IAAA,qBAAW,EAAC,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,mBAAmB,EAAE,MAAM,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,MAAM,CAAC,MAAc,EAAE,EAAgC,EAAE,QAAgD;IAChH,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,oEAAoE;YACpE,OAAO,IAAA,2BAAgB,EAAC,QAAQ,CAAC,CAAC;QACpC,KAAK,KAAK;YACR,OAAO,IAAA,8BAAmB,EAAC,QAAQ,CAAC,CAAC;QACvC,KAAK,MAAM;YACT,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACrC,KAAK,UAAU;YACb,OAAO,IAAA,mBAAc,EAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,IAAI,GAAc,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC/E,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,QAAQ,CAAC,EAAE,CAAC;YACV,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACxB,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAe,CAAC,EAAE,CAAC;oBACjD,MAAM,IAAI,KAAK,CAAC,yBAAyB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,KAAK,IAAI,EAAE,IAAI,CAAC,CAAC;gBACvF,CAAC;gBACD,IAAI,CAAC,MAAM,GAAG,KAAe,CAAC;gBAC9B,MAAM;YACR,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACxB,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;oBAC3B,MAAM,IAAI,KAAK,CAAC,mDAAmD,KAAK,IAAI,EAAE,IAAI,CAAC,CAAC;gBACtF,CAAC;gBACD,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;gBAClB,MAAM;YACR,CAAC;YACD,KAAK,OAAO,CAAC,CAAC,CAAC;gBACb,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBACxB,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACpC,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;gBAC5E,CAAC;gBACD,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC;gBACjB,MAAM;YACR,CAAC;YACD,KAAK,QAAQ;gBACX,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;gBACjB,MAAM;YACR;gBACE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,2CAA2C,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli/index.js

@@ -10,6 +10,7 @@ const fix_1 = require("./fix");
 const ingest_1 = require("./ingest");
 const run_1 = require("./run");
 const discover_1 = require("./discover");
+const graph_1 = require("./graph");
 // dist/cli/ → package root; npm ships package.json in every tarball.
 const VERSION = require('../../package.json').version;
 const HELP = `ia-qa-heal — self-healing E2E toolkit (MVP)
@@ -42,6 +43,16 @@ Usage:
                                              _navigation.md/.svg (the nav graph, when there is
                                              selective structure to draw — a mesh or a fan is stated
                                              in the overview instead)
+  ia-qa-heal graph                         Turn the mapped app into a navigation graph (page→page,
+                                             derived from href — the same engine map uses). Read-only:
+                                             never rewrites _overview.md/_navigation.*
+                                             --format mermaid|svg|json|markdown  default mermaid (stdout;
+                                                       GitHub/mermaid.live render it). mermaid/svg are the
+                                                       views map already writes; json = ia-qa-graph@1 IR
+                                                       (for D3/Reagraph/agents); markdown = one card per
+                                                       page (a RAG chunk / Confluence section)
+                                             --out <file>  write to a file instead of stdout
+                                             --open        open the output in the browser (implies a file)
   ia-qa-heal baseline                      Promote .ia-qa/mapping/ → .ia-qa/baseline/, the reference
                                              diff compares against. Commit it. Drift needs two
                                              moments: without this there is only one, and a diff
@@ -145,6 +156,9 @@ async function main() {
         case 'ingest':
             await (0, ingest_1.runIngest)(rest);
             break;
+        case 'graph':
+            await (0, graph_1.runGraph)(rest);
+            break;
         case 'run':
             await (0, run_1.runRun)(rest);
             break;

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;AACA,sCAAuC;AACvC,iCAAiC;AACjC,+BAA+B;AAC/B,yCAAyC;AACzC,iCAAiC;AACjC,+BAA+B;AAC/B,qCAAqC;AACrC,+BAA+B;AAC/B,yCAAyC;AACzC,mCAAmC;AAEnC,qEAAqE;AACrE,MAAM,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,OAAiB,CAAC;AAEhE,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkFZ,CAAC;AAEF;;;;;;GAMG;AACH,SAAS,gBAAgB,CAAC,IAAc;IACtC,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,GAAuB,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;YACrB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACzB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;YAClF,CAAC;YACD,GAAG,GAAG,IAAI,CAAC;YACX,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QACD,IAAI,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC9B,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YAClC,SAAS;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;IACD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;AACvB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACxE,IAAA,mBAAU,EAAC,SAAS,CAAC,CAAC;IACxB,CAAC;IACD,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAChC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,MAAM;YACT,MAAM,IAAA,cAAO,GAAE,CAAC;YAChB,MAAM;QACR,KAAK,UAAU;YACb,MAAM,IAAA,sBAAW,EAAC,IAAI,CAAC,CAAC;YACxB,MAAM;QACR,KAAK,KAAK;YACR,MAAM,IAAA,YAAM,EAAC,GAAG,CAAC,CAAC;YAClB,MAAM;QACR,KAAK,UAAU;YACb,MAAM,IAAA,sBAAW,EAAC,IAAI,CAAC,CAAC;YACxB,MAAM;QACR,KAAK,MAAM;YACT,MAAM,IAAA,cAAO,EAAC,IAAI,CAAC,CAAC;YACpB,MAAM;QACR,KAAK,KAAK;YACR,MAAM,IAAA,YAAM,EAAC,IAAI,CAAC,CAAC;YACnB,MAAM;QACR,KAAK,QAAQ;YACX,MAAM,IAAA,kBAAS,EAAC,IAAI,CAAC,CAAC;YACtB,MAAM;QACR,KAAK,OAAO;YACV,MAAM,IAAA,gBAAQ,EAAC,IAAI,CAAC,CAAC;YACrB,MAAM;QACR,KAAK,KAAK;YACR,MAAM,IAAA,YAAM,EAAC,IAAI,CAAC,CAAC;YACnB,MAAM;QACR,KAAK,SAAS,CAAC;QACf,KAAK,WAAW,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACrB,MAAM;QACR,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI,CAAC;QACV,KAAK,SAAS;YACZ,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAClB,MAAM;QACR;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,SAAS,IAAI,EAAE,CAAC,CAAC;YAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/graph/ir.d.ts

@@ -0,0 +1,72 @@
+import type { AppOverview, NavigationGraph, HubFan, NavMesh, OffMapDestination } from '../overview';
+/**
+ * `ia-qa-graph@1` — a portable intermediate graph, `{ nodes, edges }`.
+ *
+ * It invents nothing: it projects the `AppOverview` + `NavigationGraph` that
+ * `overview.ts` already computes into one JSON shape that adapts to Mermaid,
+ * Graphviz/DOT, D3, Reagraph — and matches the node/edge shape the web
+ * `/devtools/graph` viewer consumes (`{id,type,label,meta}` / `{id,from,to,type}`),
+ * so a future "import graph JSON" needs no conversion.
+ *
+ * `nodes`/`edges` carry the *full* navigation (every mapped page, every deduped
+ * page→page link). The pruning `navigationGraph()` does for a readable drawing —
+ * collapsed fans, a mesh, isolated/entry pages — is not thrown away: it lives in
+ * `meta`, so a consumer can redraw the whole thing or honour the collapse, exactly
+ * as the Mermaid/SVG renderers do.
+ */
+export interface GraphNode {
+    id: string;
+    type: 'page';
+    label: string;
+    meta: {
+        url: string;
+        elementCount: number;
+        contract: string;
+        entry: boolean;
+        isolated: boolean;
+    };
+}
+export interface GraphEdge {
+    id: string;
+    from: string;
+    to: string;
+    type: 'nav';
+    label?: string;
+}
+export interface GraphIR {
+    schema: 'ia-qa-graph@1';
+    kind: 'navigation';
+    generatedAt: string;
+    baseUrl: string;
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    meta: {
+        /** Fans collapsed out of the drawing (a hub linking to N link-nowhere pages). */
+        fans: HubFan[];
+        /** Set when the survivors are a mesh, not a structure — else null. */
+        mesh: NavMesh | null;
+        /** Pages linked to nothing at all. */
+        isolated: string[];
+        /** Connected pages nothing links to — the way in (login, home). */
+        entries: string[];
+        /** Same-origin links to paths absent from config.pages — the coverage gap. */
+        unmapped: OffMapDestination[];
+        /** Cross-origin links, grouped by destination origin. */
+        external: OffMapDestination[];
+        /** App-wide role tally, most common first. */
+        roleCounts: Array<{
+            role: string;
+            count: number;
+        }>;
+    };
+}
+/** Project the overview + pruned graph into the canonical IR. Pure, no I/O. */
+export declare function toGraphIR(overview: AppOverview, graph: NavigationGraph): GraphIR;
+/**
+ * Linearize the IR into markdown — one section per page: what it is, where it links,
+ * and what reaches it. A page = one self-contained chunk, so it drops into a RAG
+ * index (split on the `##` headings) or a Confluence page as-is. This is the layer
+ * the raw JSON is not: a big JSON blob is a poor chunk; a page card is a good one.
+ * It carries the navigation relations the per-page `map` contracts don't.
+ */
+export declare function renderMarkdown(ir: GraphIR): string;

package/dist/graph/ir.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toGraphIR = toGraphIR;
+exports.renderMarkdown = renderMarkdown;
+const NODE_PREFIX = 'page:';
+const nodeId = (name) => NODE_PREFIX + name;
+const slug = (name) => name.replace(/[^a-zA-Z0-9._-]+/g, '-');
+/** Project the overview + pruned graph into the canonical IR. Pure, no I/O. */
+function toGraphIR(overview, graph) {
+    const entries = new Set(graph.entries);
+    const isolated = new Set(graph.isolated);
+    const nodes = overview.pages.map((p) => ({
+        id: nodeId(p.name),
+        type: 'page',
+        label: p.name,
+        meta: {
+            url: p.url,
+            elementCount: p.elements,
+            contract: p.contract,
+            entry: entries.has(p.name),
+            isolated: isolated.has(p.name),
+        },
+    }));
+    const edges = overview.edges.map((e) => ({
+        id: `e:${slug(e.from)}>${slug(e.to)}`,
+        from: nodeId(e.from),
+        to: nodeId(e.to),
+        type: 'nav',
+    }));
+    return {
+        schema: 'ia-qa-graph@1',
+        kind: 'navigation',
+        generatedAt: overview.generatedAt,
+        baseUrl: overview.baseUrl,
+        nodes,
+        edges,
+        meta: {
+            fans: graph.fans,
+            mesh: graph.mesh ?? null,
+            isolated: graph.isolated,
+            entries: graph.entries,
+            unmapped: overview.unmapped,
+            external: overview.external,
+            roleCounts: overview.roleCounts,
+        },
+    };
+}
+/**
+ * Linearize the IR into markdown — one section per page: what it is, where it links,
+ * and what reaches it. A page = one self-contained chunk, so it drops into a RAG
+ * index (split on the `##` headings) or a Confluence page as-is. This is the layer
+ * the raw JSON is not: a big JSON blob is a poor chunk; a page card is a good one.
+ * It carries the navigation relations the per-page `map` contracts don't.
+ */
+function renderMarkdown(ir) {
+    const bare = (id) => id.replace(/^page:/, '');
+    const out = new Map();
+    const into = new Map();
+    for (const n of ir.nodes) {
+        out.set(n.label, []);
+        into.set(n.label, []);
+    }
+    for (const e of ir.edges) {
+        const f = bare(e.from);
+        const t = bare(e.to);
+        out.get(f)?.push(t);
+        into.get(t)?.push(f);
+    }
+    const lines = [
+        `# Navigation knowledge — ${ir.baseUrl}`,
+        '',
+        `> ${ir.nodes.length} pages · ${ir.edges.length} links · ${ir.meta.entries.length} entry points · ` +
+            `${ir.meta.unmapped.length} uncovered · generated ${ir.generatedAt}`,
+        '',
+        '_One section per page — what it is, where it links, and what reaches it. A page is one RAG chunk._',
+        '',
+    ];
+    for (const n of ir.nodes) {
+        const tags = [
+            `${n.meta.elementCount} interactive elements`,
+            n.meta.entry ? 'entry point (nothing links in)' : null,
+            n.meta.isolated ? 'isolated (no page links)' : null,
+        ]
+            .filter(Boolean)
+            .join(' · ');
+        const links = out.get(n.label) ?? [];
+        const from = into.get(n.label) ?? [];
+        lines.push(`## ${n.label}`);
+        lines.push(`URL: ${n.meta.url} · ${tags}`);
+        lines.push(`Links to: ${links.length ? links.join(', ') : '—'}`);
+        lines.push(`Reached from: ${from.length ? from.join(', ') : '—'}`);
+        lines.push('');
+    }
+    if (ir.meta.unmapped.length) {
+        lines.push('## Coverage gaps — linked but never mapped');
+        lines.push('');
+        lines.push('Same-origin destinations the suite links to but no page contract covers ' +
+            '(candidates for `ia-qa-heal discover`):');
+        lines.push('');
+        for (const d of [...ir.meta.unmapped].sort((a, b) => b.links - a.links)) {
+            lines.push(`- ${d.target} — ${d.links} link${d.links === 1 ? '' : 's'} from ` +
+                `${d.pages.length} page${d.pages.length === 1 ? '' : 's'}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=ir.js.map

package/dist/graph/ir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ir.js","sourceRoot":"","sources":["../../src/graph/ir.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ia-qa/self-healing",
-  "version": "1.4.1",
+  "version": "1.4.2",
   "description": "Local-first self-healing for UI tests: a local MCP server + CLI that map your app's pages to a role/name/selector contract, diff selector drift (PASS/FIX/BLOCK), and apply deterministic fixes to Cypress/Playwright/Selenium tests. Runs on your machine — nothing leaves it.",
   "keywords": [
     "self-healing",