class-ai-agent 1.6.1 → 1.6.2

package/.agent/rules/antigravity-overview.md

@@ -28,7 +28,7 @@ Supporting workflows: `debug`, `simplify`, `fix-issue`, `handoff`, `resume` in `
 - Prefer **tests first** and **small vertical slices** (see `.agents/skills/incremental-implementation/`).
 - Use **`.agents/references/`** for checklists (security, testing, performance, accessibility).
 - For **structural** code questions, prefer **CodeGraph** MCP tools per **`.agent/rules/codegraph.md`**.
-- When the user wants a **visual call graph**, use **OntoSight CLI** per **`.agent/rules/ontosight.md`** (`npx @royalsolution/ontosight`).
+- When the user wants a **visual call graph**, use **OntoSight CLI** per **`.agent/rules/ontosight.md`** (`npx @royalsolution/ontosight@0.2.0`).
 
 ## Agents (personas)
 

package/.agent/rules/codegraph.md

@@ -23,7 +23,7 @@ Use codegraph for **structural** questions — what calls what, what would break
 | "See several related symbols' source at once" | `codegraph_explore` |
 | "What files exist under path/" | `codegraph_files` |
 | "Is the index healthy?" | `codegraph_status` |
-| Visual exploration of a subgraph in browser | `npx @royalsolution/ontosight` (see **`.agent/rules/ontosight.md`**) |
+| Visual exploration of a subgraph in browser | `npx @royalsolution/ontosight@0.2.0` (see **`.agent/rules/ontosight.md`**) |
 | "Show/demonstrate impact of changing Z" | `codegraph_impact` → then OntoSight `--symbol Z` (see **`.agent/rules/ontosight.md`**) |
 
 ### Visualization

package/.agent/rules/ontosight.md

@@ -14,7 +14,7 @@ See **`.agent/rules/codegraph.md`** for MCP usage and **`.agents/references/onto
 | Goal | Use |
 |------|-----|
 | Find symbols, callers, traces, impact (text in chat) | `codegraph_*` MCP tools |
-| Visual exploration of a subgraph | `npx @royalsolution/ontosight` |
+| Visual exploration of a subgraph | `npx @royalsolution/ontosight@0.2.0` |
 | User says "show me the graph" | OntoSight CLI |
 | Impact / blast radius demonstration | `codegraph_impact` → summary → OntoSight CLI |
 
@@ -46,7 +46,7 @@ Do **not** run OntoSight to collect agent context — that duplicates CodeGraph
 3. Read **`.agents/skills/ui-ux-pro-max/IMPACT-DEMO.md`** — presentation checklist (use your tool's skills path: `.agents/skills/`, `.agents/skills/`, `.agents/skills/`)
 4. Optional: run ui-ux-pro-max searches from the playbook for chart/UX framing
 5. Summarize in chat: seed symbol, top impacted callers, risk tier, what the graph will highlight
-6. `npx @royalsolution/ontosight . --symbol <name> --path <dir> --hops 3 --max-nodes 200`
+6. `npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200`
 
 **Hop guidance:** use `--hops 3` (or `4` for deep trees) for impact demos; prefer `--path` over raising `--max-nodes` when truncated.
 
@@ -58,23 +58,23 @@ Do **not** run OntoSight to collect agent context — that duplicates CodeGraph
 
 1. `codegraph_search({ query: "<name>" })` → confirm file + kind
 2. Summarize in chat
-3. `npx @royalsolution/ontosight . --symbol <name> --path <dir-from-search>`
+3. `npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir-from-search>`
 
 **Feature area ("how does auth work?"):**
 
 1. `codegraph_context({ task: "authentication flow", maxNodes: 20 })`
 2. Summarize key symbols in chat
-3. `npx @royalsolution/ontosight . --task "authentication flow" --hops 2 --max-nodes 200`
+3. `npx @royalsolution/ontosight@0.2.0 . --task "authentication flow" --hops 2 --max-nodes 200`
 
 **Large repo:** prefer `--path` or `--symbol` before raising `--max-nodes`.
 
 ### Commands
 
 ```bash
-npx @royalsolution/ontosight .
-npx @royalsolution/ontosight . --symbol <name> --path <dir>
-npx @royalsolution/ontosight . --task "auth flow" --hops 2 --max-nodes 200
-npx @royalsolution/ontosight . --symbol <name> --path <dir> --hops 3 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 .
+npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir>
+npx @royalsolution/ontosight@0.2.0 . --task "auth flow" --hops 2 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200
 ```
 
 Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unless `ONTOSIGHT_SKIP_AUTO_INIT=1`). Ask the user before auto-init on very large repos.
@@ -83,7 +83,7 @@ Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unle
 
 | Requirement | Notes |
 |-------------|-------|
-| Node 20+ | For `npx @royalsolution/ontosight` |
+| Node 20+ | For `npx @royalsolution/ontosight@0.2.0` |
 | Python 3.11+ | Used by `ontosight-codegraph` |
 | uv (recommended) or pipx | Wrapper tries `uvx` first, then `pipx run` |
 | CodeGraph index | `.codegraph/codegraph.db` in project root |

package/.agents/references/codegraph.md

@@ -89,6 +89,6 @@ Example — correct:
 
 ## Visualization (OntoSight)
 
-For interactive call-graph exploration in the browser, use **[OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight)** (`npx @royalsolution/ontosight`). Gather facts with `codegraph_*` first; open OntoSight when the user wants a visual UI. See [`.cursor/references/ontosight.md`](ontosight.md).
+For interactive call-graph exploration in the browser, use **[OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight)** (`npx @royalsolution/ontosight@0.2.0`). Gather facts with `codegraph_*` first; open OntoSight when the user wants a visual UI. See [`.cursor/references/ontosight.md`](ontosight.md).
 
 Upstream: [colbymchenry/codegraph](https://github.com/colbymchenry/codegraph)

package/.agents/references/ontosight.md

@@ -2,6 +2,8 @@
 
 [OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight) visualizes [CodeGraph](https://github.com/colbymchenry/codegraph) call subgraphs in an interactive browser UI. **class-ai-agent** installs usage rules across all four agent trees; invocation is via `npx` (no npm dependency).
 
+**Recommended version:** `@royalsolution/ontosight@0.2.0` (pins PyPI `ontosight-codegraph` 0.2.0). Use unpinned `npx @royalsolution/ontosight@0.2.0` only when the user explicitly wants latest.
+
 OntoSight complements CodeGraph MCP — use `codegraph_*` for structural facts in chat; use OntoSight when the user wants visual exploration. See also [`.cursor/references/codegraph.md`](codegraph.md).
 
 ## Per-tool wiring
@@ -17,13 +19,13 @@ OntoSight complements CodeGraph MCP — use `codegraph_*` for structural facts i
 
 ```bash
 # Full project — seeds from highest fan-in symbols
-npx @royalsolution/ontosight .
+npx @royalsolution/ontosight@0.2.0 .
 
 # Seed around a symbol (optionally scoped to a path)
-npx @royalsolution/ontosight . --symbol view_graph --path src/auth/
+npx @royalsolution/ontosight@0.2.0 . --symbol view_graph --path src/auth/
 
 # Task-scoped subgraph (keyword FTS seeding)
-npx @royalsolution/ontosight . --task "auth flow" --hops 2 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 . --task "auth flow" --hops 2 --max-nodes 200
 ```
 
 Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unless `ONTOSIGHT_SKIP_AUTO_INIT=1`).
@@ -48,7 +50,7 @@ Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unle
 ```text
 1. codegraph_search({ query: "view_graph" })     → confirm file + kind
 2. Tell user what you found
-3. npx @royalsolution/ontosight . --symbol view_graph --path <dir-from-search>
+3. npx @royalsolution/ontosight@0.2.0 . --symbol view_graph --path <dir-from-search>
 ```
 
 ### Feature area ("how does auth work?")
@@ -56,7 +58,7 @@ Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unle
 ```text
 1. codegraph_context({ task: "authentication flow", maxNodes: 20 })
 2. Summarize key symbols in chat
-3. npx @royalsolution/ontosight . --task "authentication flow" --hops 2 --max-nodes 200
+3. npx @royalsolution/ontosight@0.2.0 . --task "authentication flow" --hops 2 --max-nodes 200
 ```
 
 ### Impact analysis demonstration
@@ -73,13 +75,13 @@ When the user wants to **know** or **see** impact (blast radius, what breaks, do
 3. Read skills/ui-ux-pro-max/IMPACT-DEMO.md  → UX presentation checklist
 4. Optional: ui-ux-pro-max chart/ux searches (see playbook)
 5. Summarize in chat (seed, ranked table, what graph shows)
-6. npx @royalsolution/ontosight . --symbol <name> --path <dir> --hops 3 --max-nodes 200
+6. npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200
 ```
 
 **Example:**
 
 ```bash
-npx @royalsolution/ontosight . --symbol deleteUser --path src/services/ --hops 3 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 . --symbol deleteUser --path src/services/ --hops 3 --max-nodes 200
 ```
 
 **UX:** Always text summary before opening the browser; include a ranked table of top impacted symbols (accessible alternative to graph-only). See [IMPACT-DEMO.md](../skills/ui-ux-pro-max/IMPACT-DEMO.md).
@@ -104,7 +106,7 @@ npx @colbymchenry/codegraph init -i
 
 | Requirement | Notes |
 |-------------|-------|
-| Node 20+ | For `npx @royalsolution/ontosight` |
+| Node 20+ | For `npx @royalsolution/ontosight@0.2.0` |
 | Python 3.11+ | Used by `ontosight-codegraph` |
 | uv (recommended) or pipx | Wrapper tries `uvx` first, then `pipx run` |
 | CodeGraph index | `.codegraph/codegraph.db` in project root |

package/.agents/skills/ui-ux-pro-max/IMPACT-DEMO.md

@@ -46,7 +46,7 @@ Use for: summary-before-graph; tell the user what OntoSight is loading and what
 
 ## Chat summary template
 
-Present this **before** running `npx @royalsolution/ontosight`:
+Present this **before** running `npx @royalsolution/ontosight@0.2.0`:
 
 ### 1. Seed
 
@@ -74,7 +74,7 @@ Group by risk: **direct callers** (highest) vs **transitive** (lower).
 Short line: *"Opening interactive impact graph…"* then run:
 
 ```bash
-npx @royalsolution/ontosight . --symbol <name> --path <dir-from-search> --hops 3 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir-from-search> --hops 3 --max-nodes 200
 ```
 
 ---
@@ -95,7 +95,7 @@ npx @royalsolution/ontosight . --symbol <name> --path <dir-from-search> --hops 3
 3. Read this file (IMPACT-DEMO.md)
 4. Optional: ui-ux-pro-max chart/ux searches above
 5. Chat summary (template sections 1–3)
-6. npx @royalsolution/ontosight . --symbol <name> --path <dir> --hops 3 --max-nodes 200
+6. npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200
 ```
 
 See **`.agents/references/ontosight.md`** for flags and troubleshooting.

package/.claude/CLAUDE.md

@@ -132,7 +132,7 @@ This project includes **[OntoSight](https://www.npmjs.com/package/@royalsolution
 | Setup reference | `.claude/references/ontosight.md` |
 | Shared index | `.codegraph/` (same as CodeGraph) |
 
-Use `codegraph_*` MCP tools to gather structural facts in chat; run `npx @royalsolution/ontosight .` when the user wants a visual call graph. For **impact analysis demos**, follow `skills/ui-ux-pro-max/IMPACT-DEMO.md` (search → `codegraph_impact` → summary → graph). Requires Node 20+, Python 3.11+, and uv or pipx.
+Use `codegraph_*` MCP tools to gather structural facts in chat; run `npx @royalsolution/ontosight@0.2.0 .` when the user wants a visual call graph. For **impact analysis demos**, follow `skills/ui-ux-pro-max/IMPACT-DEMO.md` (search → `codegraph_impact` → summary → graph). Requires Node 20+, Python 3.11+, and uv or pipx.
 
 ---
 

package/.claude/references/ontosight.md

@@ -2,6 +2,8 @@
 
 [OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight) visualizes [CodeGraph](https://github.com/colbymchenry/codegraph) call subgraphs in an interactive browser UI. **class-ai-agent** installs usage rules across all four agent trees; invocation is via `npx` (no npm dependency).
 
+**Recommended version:** `@royalsolution/ontosight@0.2.0` (pins PyPI `ontosight-codegraph` 0.2.0). Use unpinned `npx @royalsolution/ontosight@0.2.0` only when the user explicitly wants latest.
+
 OntoSight complements CodeGraph MCP — use `codegraph_*` for structural facts in chat; use OntoSight when the user wants visual exploration. See also [`.cursor/references/codegraph.md`](codegraph.md).
 
 ## Per-tool wiring
@@ -17,13 +19,13 @@ OntoSight complements CodeGraph MCP — use `codegraph_*` for structural facts i
 
 ```bash
 # Full project — seeds from highest fan-in symbols
-npx @royalsolution/ontosight .
+npx @royalsolution/ontosight@0.2.0 .
 
 # Seed around a symbol (optionally scoped to a path)
-npx @royalsolution/ontosight . --symbol view_graph --path src/auth/
+npx @royalsolution/ontosight@0.2.0 . --symbol view_graph --path src/auth/
 
 # Task-scoped subgraph (keyword FTS seeding)
-npx @royalsolution/ontosight . --task "auth flow" --hops 2 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 . --task "auth flow" --hops 2 --max-nodes 200
 ```
 
 Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unless `ONTOSIGHT_SKIP_AUTO_INIT=1`).
@@ -48,7 +50,7 @@ Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unle
 ```text
 1. codegraph_search({ query: "view_graph" })     → confirm file + kind
 2. Tell user what you found
-3. npx @royalsolution/ontosight . --symbol view_graph --path <dir-from-search>
+3. npx @royalsolution/ontosight@0.2.0 . --symbol view_graph --path <dir-from-search>
 ```
 
 ### Feature area ("how does auth work?")
@@ -56,7 +58,7 @@ Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unle
 ```text
 1. codegraph_context({ task: "authentication flow", maxNodes: 20 })
 2. Summarize key symbols in chat
-3. npx @royalsolution/ontosight . --task "authentication flow" --hops 2 --max-nodes 200
+3. npx @royalsolution/ontosight@0.2.0 . --task "authentication flow" --hops 2 --max-nodes 200
 ```
 
 ### Impact analysis demonstration
@@ -73,13 +75,13 @@ When the user wants to **know** or **see** impact (blast radius, what breaks, do
 3. Read skills/ui-ux-pro-max/IMPACT-DEMO.md  → UX presentation checklist
 4. Optional: ui-ux-pro-max chart/ux searches (see playbook)
 5. Summarize in chat (seed, ranked table, what graph shows)
-6. npx @royalsolution/ontosight . --symbol <name> --path <dir> --hops 3 --max-nodes 200
+6. npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200
 ```
 
 **Example:**
 
 ```bash
-npx @royalsolution/ontosight . --symbol deleteUser --path src/services/ --hops 3 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 . --symbol deleteUser --path src/services/ --hops 3 --max-nodes 200
 ```
 
 **UX:** Always text summary before opening the browser; include a ranked table of top impacted symbols (accessible alternative to graph-only). See [IMPACT-DEMO.md](../skills/ui-ux-pro-max/IMPACT-DEMO.md).
@@ -104,7 +106,7 @@ npx @colbymchenry/codegraph init -i
 
 | Requirement | Notes |
 |-------------|-------|
-| Node 20+ | For `npx @royalsolution/ontosight` |
+| Node 20+ | For `npx @royalsolution/ontosight@0.2.0` |
 | Python 3.11+ | Used by `ontosight-codegraph` |
 | uv (recommended) or pipx | Wrapper tries `uvx` first, then `pipx run` |
 | CodeGraph index | `.codegraph/codegraph.db` in project root |

package/.claude/rules/codegraph.md

@@ -19,7 +19,7 @@ Use codegraph for **structural** questions — what calls what, what would break
 | "See several related symbols' source at once" | `codegraph_explore` |
 | "What files exist under path/" | `codegraph_files` |
 | "Is the index healthy?" | `codegraph_status` |
-| Visual exploration of a subgraph in browser | `npx @royalsolution/ontosight` (see **`.claude/rules/ontosight.md`**) |
+| Visual exploration of a subgraph in browser | `npx @royalsolution/ontosight@0.2.0` (see **`.claude/rules/ontosight.md`**) |
 | "Show/demonstrate impact of changing Z" | `codegraph_impact` → then OntoSight `--symbol Z` (see **`.claude/rules/ontosight.md`**) |
 
 ### Visualization

package/.claude/rules/ontosight.md

@@ -10,7 +10,7 @@ See **`.claude/rules/codegraph.md`** for MCP usage and **`.claude/references/ont
 | Goal | Use |
 |------|-----|
 | Find symbols, callers, traces, impact (text in chat) | `codegraph_*` MCP tools |
-| Visual exploration of a subgraph | `npx @royalsolution/ontosight` |
+| Visual exploration of a subgraph | `npx @royalsolution/ontosight@0.2.0` |
 | User says "show me the graph" | OntoSight CLI |
 | Impact / blast radius demonstration | `codegraph_impact` → summary → OntoSight CLI |
 
@@ -42,7 +42,7 @@ Do **not** run OntoSight to collect agent context — that duplicates CodeGraph
 3. Read **`.claude/skills/ui-ux-pro-max/IMPACT-DEMO.md`** — presentation checklist (use your tool's skills path: `.claude/skills/`, `.kiro/skills/`, `.agents/skills/`)
 4. Optional: run ui-ux-pro-max searches from the playbook for chart/UX framing
 5. Summarize in chat: seed symbol, top impacted callers, risk tier, what the graph will highlight
-6. `npx @royalsolution/ontosight . --symbol <name> --path <dir> --hops 3 --max-nodes 200`
+6. `npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200`
 
 **Hop guidance:** use `--hops 3` (or `4` for deep trees) for impact demos; prefer `--path` over raising `--max-nodes` when truncated.
 
@@ -54,23 +54,23 @@ Do **not** run OntoSight to collect agent context — that duplicates CodeGraph
 
 1. `codegraph_search({ query: "<name>" })` → confirm file + kind
 2. Summarize in chat
-3. `npx @royalsolution/ontosight . --symbol <name> --path <dir-from-search>`
+3. `npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir-from-search>`
 
 **Feature area ("how does auth work?"):**
 
 1. `codegraph_context({ task: "authentication flow", maxNodes: 20 })`
 2. Summarize key symbols in chat
-3. `npx @royalsolution/ontosight . --task "authentication flow" --hops 2 --max-nodes 200`
+3. `npx @royalsolution/ontosight@0.2.0 . --task "authentication flow" --hops 2 --max-nodes 200`
 
 **Large repo:** prefer `--path` or `--symbol` before raising `--max-nodes`.
 
 ### Commands
 
 ```bash
-npx @royalsolution/ontosight .
-npx @royalsolution/ontosight . --symbol <name> --path <dir>
-npx @royalsolution/ontosight . --task "auth flow" --hops 2 --max-nodes 200
-npx @royalsolution/ontosight . --symbol <name> --path <dir> --hops 3 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 .
+npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir>
+npx @royalsolution/ontosight@0.2.0 . --task "auth flow" --hops 2 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200
 ```
 
 Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unless `ONTOSIGHT_SKIP_AUTO_INIT=1`). Ask the user before auto-init on very large repos.
@@ -79,7 +79,7 @@ Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unle
 
 | Requirement | Notes |
 |-------------|-------|
-| Node 20+ | For `npx @royalsolution/ontosight` |
+| Node 20+ | For `npx @royalsolution/ontosight@0.2.0` |
 | Python 3.11+ | Used by `ontosight-codegraph` |
 | uv (recommended) or pipx | Wrapper tries `uvx` first, then `pipx run` |
 | CodeGraph index | `.codegraph/codegraph.db` in project root |

package/.claude/skills/ui-ux-pro-max/IMPACT-DEMO.md

@@ -46,7 +46,7 @@ Use for: summary-before-graph; tell the user what OntoSight is loading and what
 
 ## Chat summary template
 
-Present this **before** running `npx @royalsolution/ontosight`:
+Present this **before** running `npx @royalsolution/ontosight@0.2.0`:
 
 ### 1. Seed
 
@@ -74,7 +74,7 @@ Group by risk: **direct callers** (highest) vs **transitive** (lower).
 Short line: *"Opening interactive impact graph…"* then run:
 
 ```bash
-npx @royalsolution/ontosight . --symbol <name> --path <dir-from-search> --hops 3 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir-from-search> --hops 3 --max-nodes 200
 ```
 
 ---
@@ -95,7 +95,7 @@ npx @royalsolution/ontosight . --symbol <name> --path <dir-from-search> --hops 3
 3. Read this file (IMPACT-DEMO.md)
 4. Optional: ui-ux-pro-max chart/ux searches above
 5. Chat summary (template sections 1–3)
-6. npx @royalsolution/ontosight . --symbol <name> --path <dir> --hops 3 --max-nodes 200
+6. npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200
 ```
 
 See **`.cursor/references/ontosight.md`** for flags and troubleshooting.

package/.cursor/CURSOR.md

@@ -91,7 +91,7 @@ This project includes **[OntoSight](https://www.npmjs.com/package/@royalsolution
 | Setup reference | `.cursor/references/ontosight.md` |
 | Shared index | `.codegraph/` (same as CodeGraph) |
 
-Use `codegraph_*` MCP tools to gather structural facts in chat; run `npx @royalsolution/ontosight .` when the user wants a visual call graph. For **impact analysis demos**, follow `skills/ui-ux-pro-max/IMPACT-DEMO.md` (search → `codegraph_impact` → summary → graph). Requires Node 20+, Python 3.11+, and uv or pipx.
+Use `codegraph_*` MCP tools to gather structural facts in chat; run `npx @royalsolution/ontosight@0.2.0 .` when the user wants a visual call graph. For **impact analysis demos**, follow `skills/ui-ux-pro-max/IMPACT-DEMO.md` (search → `codegraph_impact` → summary → graph). Requires Node 20+, Python 3.11+, and uv or pipx.
 
 ---
 

package/.cursor/references/codegraph.md

@@ -86,6 +86,6 @@ Example — correct:
 
 ## Visualization (OntoSight)
 
-For interactive call-graph exploration in the browser, use **[OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight)** (`npx @royalsolution/ontosight`). Gather facts with `codegraph_*` first; open OntoSight when the user wants a visual UI. See [`.cursor/references/ontosight.md`](ontosight.md).
+For interactive call-graph exploration in the browser, use **[OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight)** (`npx @royalsolution/ontosight@0.2.0`). Gather facts with `codegraph_*` first; open OntoSight when the user wants a visual UI. See [`.cursor/references/ontosight.md`](ontosight.md).
 
 Upstream: [colbymchenry/codegraph](https://github.com/colbymchenry/codegraph)

package/.cursor/references/ontosight.md

@@ -2,6 +2,8 @@
 
 [OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight) visualizes [CodeGraph](https://github.com/colbymchenry/codegraph) call subgraphs in an interactive browser UI. **class-ai-agent** installs usage rules across all four agent trees; invocation is via `npx` (no npm dependency).
 
+**Recommended version:** `@royalsolution/ontosight@0.2.0` (pins PyPI `ontosight-codegraph` 0.2.0). Use unpinned `npx @royalsolution/ontosight@0.2.0` only when the user explicitly wants latest.
+
 OntoSight complements CodeGraph MCP — use `codegraph_*` for structural facts in chat; use OntoSight when the user wants visual exploration. See also [`.cursor/references/codegraph.md`](codegraph.md).
 
 ## Per-tool wiring
@@ -17,13 +19,13 @@ OntoSight complements CodeGraph MCP — use `codegraph_*` for structural facts i
 
 ```bash
 # Full project — seeds from highest fan-in symbols
-npx @royalsolution/ontosight .
+npx @royalsolution/ontosight@0.2.0 .
 
 # Seed around a symbol (optionally scoped to a path)
-npx @royalsolution/ontosight . --symbol view_graph --path src/auth/
+npx @royalsolution/ontosight@0.2.0 . --symbol view_graph --path src/auth/
 
 # Task-scoped subgraph (keyword FTS seeding)
-npx @royalsolution/ontosight . --task "auth flow" --hops 2 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 . --task "auth flow" --hops 2 --max-nodes 200
 ```
 
 Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unless `ONTOSIGHT_SKIP_AUTO_INIT=1`).
@@ -48,7 +50,7 @@ Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unle
 ```text
 1. codegraph_search({ query: "view_graph" })     → confirm file + kind
 2. Tell user what you found
-3. npx @royalsolution/ontosight . --symbol view_graph --path <dir-from-search>
+3. npx @royalsolution/ontosight@0.2.0 . --symbol view_graph --path <dir-from-search>
 ```
 
 ### Feature area ("how does auth work?")
@@ -56,7 +58,7 @@ Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unle
 ```text
 1. codegraph_context({ task: "authentication flow", maxNodes: 20 })
 2. Summarize key symbols in chat
-3. npx @royalsolution/ontosight . --task "authentication flow" --hops 2 --max-nodes 200
+3. npx @royalsolution/ontosight@0.2.0 . --task "authentication flow" --hops 2 --max-nodes 200
 ```
 
 ### Impact analysis demonstration
@@ -73,13 +75,13 @@ When the user wants to **know** or **see** impact (blast radius, what breaks, do
 3. Read skills/ui-ux-pro-max/IMPACT-DEMO.md  → UX presentation checklist
 4. Optional: ui-ux-pro-max chart/ux searches (see playbook)
 5. Summarize in chat (seed, ranked table, what graph shows)
-6. npx @royalsolution/ontosight . --symbol <name> --path <dir> --hops 3 --max-nodes 200
+6. npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200
 ```
 
 **Example:**
 
 ```bash
-npx @royalsolution/ontosight . --symbol deleteUser --path src/services/ --hops 3 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 . --symbol deleteUser --path src/services/ --hops 3 --max-nodes 200
 ```
 
 **UX:** Always text summary before opening the browser; include a ranked table of top impacted symbols (accessible alternative to graph-only). See [IMPACT-DEMO.md](../skills/ui-ux-pro-max/IMPACT-DEMO.md).
@@ -104,7 +106,7 @@ npx @colbymchenry/codegraph init -i
 
 | Requirement | Notes |
 |-------------|-------|
-| Node 20+ | For `npx @royalsolution/ontosight` |
+| Node 20+ | For `npx @royalsolution/ontosight@0.2.0` |
 | Python 3.11+ | Used by `ontosight-codegraph` |
 | uv (recommended) or pipx | Wrapper tries `uvx` first, then `pipx run` |
 | CodeGraph index | `.codegraph/codegraph.db` in project root |

package/.cursor/rules/codegraph.mdc

@@ -23,7 +23,7 @@ Use codegraph for **structural** questions — what calls what, what would break
 | "See several related symbols' source at once" | `codegraph_explore` |
 | "What files exist under path/" | `codegraph_files` |
 | "Is the index healthy?" | `codegraph_status` |
-| Visual exploration of a subgraph in browser | `npx @royalsolution/ontosight` (see **`.cursor/rules/ontosight.mdc`**) |
+| Visual exploration of a subgraph in browser | `npx @royalsolution/ontosight@0.2.0` (see **`.cursor/rules/ontosight.mdc`**) |
 | "Show/demonstrate impact of changing Z" | `codegraph_impact` → then OntoSight `--symbol Z` (see **`.cursor/rules/ontosight.mdc`**) |
 
 ### Visualization

package/.cursor/rules/cursor-overview.mdc

@@ -28,7 +28,7 @@ Supporting prompts: `debug`, `simplify`, `fix-issue`, `handoff`, `resume` in `.c
 - Prefer **tests first** and **small vertical slices** (see `.cursor/skills/incremental-implementation/`).
 - Use **`.cursor/references/`** for checklists (security, testing, performance, accessibility).
 - For **structural** code questions (symbols, callers, callees, traces, impact), prefer **CodeGraph** MCP tools (`codegraph_*`) per **`.cursor/rules/codegraph.mdc`** instead of grep/read exploration loops.
-- When the user wants a **visual call graph**, use **OntoSight CLI** per **`.cursor/rules/ontosight.mdc`** (`npx @royalsolution/ontosight`).
+- When the user wants a **visual call graph**, use **OntoSight CLI** per **`.cursor/rules/ontosight.mdc`** (`npx @royalsolution/ontosight@0.2.0`).
 
 ## Agents (personas)
 

package/.cursor/rules/ontosight.mdc

@@ -14,7 +14,7 @@ See **`.cursor/rules/codegraph.mdc`** for MCP usage and **`.cursor/references/on
 | Goal | Use |
 |------|-----|
 | Find symbols, callers, traces, impact (text in chat) | `codegraph_*` MCP tools |
-| Visual exploration of a subgraph | `npx @royalsolution/ontosight` |
+| Visual exploration of a subgraph | `npx @royalsolution/ontosight@0.2.0` |
 | User says "show me the graph" | OntoSight CLI |
 | Impact / blast radius demonstration | `codegraph_impact` → summary → OntoSight CLI |
 
@@ -46,7 +46,7 @@ Do **not** run OntoSight to collect agent context — that duplicates CodeGraph
 3. Read **`.cursor/skills/ui-ux-pro-max/IMPACT-DEMO.md`** — presentation checklist (use your tool's skills path: `.claude/skills/`, `.kiro/skills/`, `.agents/skills/`)
 4. Optional: run ui-ux-pro-max searches from the playbook for chart/UX framing
 5. Summarize in chat: seed symbol, top impacted callers, risk tier, what the graph will highlight
-6. `npx @royalsolution/ontosight . --symbol <name> --path <dir> --hops 3 --max-nodes 200`
+6. `npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200`
 
 **Hop guidance:** use `--hops 3` (or `4` for deep trees) for impact demos; prefer `--path` over raising `--max-nodes` when truncated.
 
@@ -58,23 +58,23 @@ Do **not** run OntoSight to collect agent context — that duplicates CodeGraph
 
 1. `codegraph_search({ query: "<name>" })` → confirm file + kind
 2. Summarize in chat
-3. `npx @royalsolution/ontosight . --symbol <name> --path <dir-from-search>`
+3. `npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir-from-search>`
 
 **Feature area ("how does auth work?"):**
 
 1. `codegraph_context({ task: "authentication flow", maxNodes: 20 })`
 2. Summarize key symbols in chat
-3. `npx @royalsolution/ontosight . --task "authentication flow" --hops 2 --max-nodes 200`
+3. `npx @royalsolution/ontosight@0.2.0 . --task "authentication flow" --hops 2 --max-nodes 200`
 
 **Large repo:** prefer `--path` or `--symbol` before raising `--max-nodes`.
 
 ### Commands
 
 ```bash
-npx @royalsolution/ontosight .
-npx @royalsolution/ontosight . --symbol <name> --path <dir>
-npx @royalsolution/ontosight . --task "auth flow" --hops 2 --max-nodes 200
-npx @royalsolution/ontosight . --symbol <name> --path <dir> --hops 3 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 .
+npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir>
+npx @royalsolution/ontosight@0.2.0 . --task "auth flow" --hops 2 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200
 ```
 
 Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unless `ONTOSIGHT_SKIP_AUTO_INIT=1`). Ask the user before auto-init on very large repos.
@@ -83,7 +83,7 @@ Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unle
 
 | Requirement | Notes |
 |-------------|-------|
-| Node 20+ | For `npx @royalsolution/ontosight` |
+| Node 20+ | For `npx @royalsolution/ontosight@0.2.0` |
 | Python 3.11+ | Used by `ontosight-codegraph` |
 | uv (recommended) or pipx | Wrapper tries `uvx` first, then `pipx run` |
 | CodeGraph index | `.codegraph/codegraph.db` in project root |

package/.cursor/skills/ui-ux-pro-max/IMPACT-DEMO.md

@@ -46,7 +46,7 @@ Use for: summary-before-graph; tell the user what OntoSight is loading and what
 
 ## Chat summary template
 
-Present this **before** running `npx @royalsolution/ontosight`:
+Present this **before** running `npx @royalsolution/ontosight@0.2.0`:
 
 ### 1. Seed
 
@@ -74,7 +74,7 @@ Group by risk: **direct callers** (highest) vs **transitive** (lower).
 Short line: *"Opening interactive impact graph…"* then run:
 
 ```bash
-npx @royalsolution/ontosight . --symbol <name> --path <dir-from-search> --hops 3 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir-from-search> --hops 3 --max-nodes 200
 ```
 
 ---
@@ -95,7 +95,7 @@ npx @royalsolution/ontosight . --symbol <name> --path <dir-from-search> --hops 3
 3. Read this file (IMPACT-DEMO.md)
 4. Optional: ui-ux-pro-max chart/ux searches above
 5. Chat summary (template sections 1–3)
-6. npx @royalsolution/ontosight . --symbol <name> --path <dir> --hops 3 --max-nodes 200
+6. npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200
 ```
 
 See **`.cursor/references/ontosight.md`** for flags and troubleshooting.

package/.kiro/KIRO.md

@@ -99,7 +99,7 @@ This project includes **[OntoSight](https://www.npmjs.com/package/@royalsolution
 | Setup reference | `.kiro/references/ontosight.md` |
 | Shared index | `.codegraph/` (same as CodeGraph) |
 
-Use `codegraph_*` MCP tools to gather structural facts in chat; run `npx @royalsolution/ontosight .` when the user wants a visual call graph. For **impact analysis demos**, follow `skills/ui-ux-pro-max/IMPACT-DEMO.md` (search → `codegraph_impact` → summary → graph). Requires Node 20+, Python 3.11+, and uv or pipx.
+Use `codegraph_*` MCP tools to gather structural facts in chat; run `npx @royalsolution/ontosight@0.2.0 .` when the user wants a visual call graph. For **impact analysis demos**, follow `skills/ui-ux-pro-max/IMPACT-DEMO.md` (search → `codegraph_impact` → summary → graph). Requires Node 20+, Python 3.11+, and uv or pipx.
 
 ---
 

package/.kiro/references/codegraph.md

@@ -85,6 +85,6 @@ Example — correct:
 
 ## Visualization (OntoSight)
 
-For interactive call-graph exploration in the browser, use **[OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight)** (`npx @royalsolution/ontosight`). Gather facts with `codegraph_*` first; open OntoSight when the user wants a visual UI. See [`.cursor/references/ontosight.md`](ontosight.md).
+For interactive call-graph exploration in the browser, use **[OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight)** (`npx @royalsolution/ontosight@0.2.0`). Gather facts with `codegraph_*` first; open OntoSight when the user wants a visual UI. See [`.cursor/references/ontosight.md`](ontosight.md).
 
 Upstream: [colbymchenry/codegraph](https://github.com/colbymchenry/codegraph)

package/.kiro/references/ontosight.md

@@ -2,6 +2,8 @@
 
 [OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight) visualizes [CodeGraph](https://github.com/colbymchenry/codegraph) call subgraphs in an interactive browser UI. **class-ai-agent** installs usage rules across all four agent trees; invocation is via `npx` (no npm dependency).
 
+**Recommended version:** `@royalsolution/ontosight@0.2.0` (pins PyPI `ontosight-codegraph` 0.2.0). Use unpinned `npx @royalsolution/ontosight@0.2.0` only when the user explicitly wants latest.
+
 OntoSight complements CodeGraph MCP — use `codegraph_*` for structural facts in chat; use OntoSight when the user wants visual exploration. See also [`.cursor/references/codegraph.md`](codegraph.md).
 
 ## Per-tool wiring
@@ -17,13 +19,13 @@ OntoSight complements CodeGraph MCP — use `codegraph_*` for structural facts i
 
 ```bash
 # Full project — seeds from highest fan-in symbols
-npx @royalsolution/ontosight .
+npx @royalsolution/ontosight@0.2.0 .
 
 # Seed around a symbol (optionally scoped to a path)
-npx @royalsolution/ontosight . --symbol view_graph --path src/auth/
+npx @royalsolution/ontosight@0.2.0 . --symbol view_graph --path src/auth/
 
 # Task-scoped subgraph (keyword FTS seeding)
-npx @royalsolution/ontosight . --task "auth flow" --hops 2 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 . --task "auth flow" --hops 2 --max-nodes 200
 ```
 
 Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unless `ONTOSIGHT_SKIP_AUTO_INIT=1`).
@@ -48,7 +50,7 @@ Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unle
 ```text
 1. codegraph_search({ query: "view_graph" })     → confirm file + kind
 2. Tell user what you found
-3. npx @royalsolution/ontosight . --symbol view_graph --path <dir-from-search>
+3. npx @royalsolution/ontosight@0.2.0 . --symbol view_graph --path <dir-from-search>
 ```
 
 ### Feature area ("how does auth work?")
@@ -56,7 +58,7 @@ Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unle
 ```text
 1. codegraph_context({ task: "authentication flow", maxNodes: 20 })
 2. Summarize key symbols in chat
-3. npx @royalsolution/ontosight . --task "authentication flow" --hops 2 --max-nodes 200
+3. npx @royalsolution/ontosight@0.2.0 . --task "authentication flow" --hops 2 --max-nodes 200
 ```
 
 ### Impact analysis demonstration
@@ -73,13 +75,13 @@ When the user wants to **know** or **see** impact (blast radius, what breaks, do
 3. Read skills/ui-ux-pro-max/IMPACT-DEMO.md  → UX presentation checklist
 4. Optional: ui-ux-pro-max chart/ux searches (see playbook)
 5. Summarize in chat (seed, ranked table, what graph shows)
-6. npx @royalsolution/ontosight . --symbol <name> --path <dir> --hops 3 --max-nodes 200
+6. npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200
 ```
 
 **Example:**
 
 ```bash
-npx @royalsolution/ontosight . --symbol deleteUser --path src/services/ --hops 3 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 . --symbol deleteUser --path src/services/ --hops 3 --max-nodes 200
 ```
 
 **UX:** Always text summary before opening the browser; include a ranked table of top impacted symbols (accessible alternative to graph-only). See [IMPACT-DEMO.md](../skills/ui-ux-pro-max/IMPACT-DEMO.md).
@@ -104,7 +106,7 @@ npx @colbymchenry/codegraph init -i
 
 | Requirement | Notes |
 |-------------|-------|
-| Node 20+ | For `npx @royalsolution/ontosight` |
+| Node 20+ | For `npx @royalsolution/ontosight@0.2.0` |
 | Python 3.11+ | Used by `ontosight-codegraph` |
 | uv (recommended) or pipx | Wrapper tries `uvx` first, then `pipx run` |
 | CodeGraph index | `.codegraph/codegraph.db` in project root |

package/.kiro/skills/ui-ux-pro-max/IMPACT-DEMO.md

@@ -46,7 +46,7 @@ Use for: summary-before-graph; tell the user what OntoSight is loading and what
 
 ## Chat summary template
 
-Present this **before** running `npx @royalsolution/ontosight`:
+Present this **before** running `npx @royalsolution/ontosight@0.2.0`:
 
 ### 1. Seed
 
@@ -74,7 +74,7 @@ Group by risk: **direct callers** (highest) vs **transitive** (lower).
 Short line: *"Opening interactive impact graph…"* then run:
 
 ```bash
-npx @royalsolution/ontosight . --symbol <name> --path <dir-from-search> --hops 3 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir-from-search> --hops 3 --max-nodes 200
 ```
 
 ---
@@ -95,7 +95,7 @@ npx @royalsolution/ontosight . --symbol <name> --path <dir-from-search> --hops 3
 3. Read this file (IMPACT-DEMO.md)
 4. Optional: ui-ux-pro-max chart/ux searches above
 5. Chat summary (template sections 1–3)
-6. npx @royalsolution/ontosight . --symbol <name> --path <dir> --hops 3 --max-nodes 200
+6. npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200
 ```
 
 See **`.cursor/references/ontosight.md`** for flags and troubleshooting.

package/.kiro/steering/codegraph.md

@@ -23,7 +23,7 @@ Use codegraph for **structural** questions — what calls what, what would break
 | "See several related symbols' source at once" | `codegraph_explore` |
 | "What files exist under path/" | `codegraph_files` |
 | "Is the index healthy?" | `codegraph_status` |
-| Visual exploration of a subgraph in browser | `npx @royalsolution/ontosight` (see **`.kiro/rules/ontosight.md`**) |
+| Visual exploration of a subgraph in browser | `npx @royalsolution/ontosight@0.2.0` (see **`.kiro/rules/ontosight.md`**) |
 | "Show/demonstrate impact of changing Z" | `codegraph_impact` → then OntoSight `--symbol Z` (see **`.kiro/rules/ontosight.md`**) |
 
 ### Visualization

package/.kiro/steering/kiro-overview.md

@@ -28,7 +28,7 @@ Supporting prompts: `debug`, `simplify`, `fix-issue`, `handoff`, `resume` in `.k
 - Prefer **tests first** and **small vertical slices** (see `.kiro/skills/incremental-implementation/`).
 - Use **`.kiro/references/`** for checklists (security, testing, performance, accessibility).
 - For **structural** code questions, prefer **CodeGraph** MCP tools per **`.kiro/steering/codegraph.md`**.
-- When the user wants a **visual call graph**, use **OntoSight CLI** per **`.kiro/steering/ontosight.md`** (`npx @royalsolution/ontosight`).
+- When the user wants a **visual call graph**, use **OntoSight CLI** per **`.kiro/steering/ontosight.md`** (`npx @royalsolution/ontosight@0.2.0`).
 
 ## Agents (personas)
 

package/.kiro/steering/ontosight.md

@@ -14,7 +14,7 @@ See **`.kiro/rules/codegraph.md`** for MCP usage and **`.kiro/references/ontosig
 | Goal | Use |
 |------|-----|
 | Find symbols, callers, traces, impact (text in chat) | `codegraph_*` MCP tools |
-| Visual exploration of a subgraph | `npx @royalsolution/ontosight` |
+| Visual exploration of a subgraph | `npx @royalsolution/ontosight@0.2.0` |
 | User says "show me the graph" | OntoSight CLI |
 | Impact / blast radius demonstration | `codegraph_impact` → summary → OntoSight CLI |
 
@@ -46,7 +46,7 @@ Do **not** run OntoSight to collect agent context — that duplicates CodeGraph
 3. Read **`.kiro/skills/ui-ux-pro-max/IMPACT-DEMO.md`** — presentation checklist (use your tool's skills path: `.claude/skills/`, `.kiro/skills/`, `.agents/skills/`)
 4. Optional: run ui-ux-pro-max searches from the playbook for chart/UX framing
 5. Summarize in chat: seed symbol, top impacted callers, risk tier, what the graph will highlight
-6. `npx @royalsolution/ontosight . --symbol <name> --path <dir> --hops 3 --max-nodes 200`
+6. `npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200`
 
 **Hop guidance:** use `--hops 3` (or `4` for deep trees) for impact demos; prefer `--path` over raising `--max-nodes` when truncated.
 
@@ -58,23 +58,23 @@ Do **not** run OntoSight to collect agent context — that duplicates CodeGraph
 
 1. `codegraph_search({ query: "<name>" })` → confirm file + kind
 2. Summarize in chat
-3. `npx @royalsolution/ontosight . --symbol <name> --path <dir-from-search>`
+3. `npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir-from-search>`
 
 **Feature area ("how does auth work?"):**
 
 1. `codegraph_context({ task: "authentication flow", maxNodes: 20 })`
 2. Summarize key symbols in chat
-3. `npx @royalsolution/ontosight . --task "authentication flow" --hops 2 --max-nodes 200`
+3. `npx @royalsolution/ontosight@0.2.0 . --task "authentication flow" --hops 2 --max-nodes 200`
 
 **Large repo:** prefer `--path` or `--symbol` before raising `--max-nodes`.
 
 ### Commands
 
 ```bash
-npx @royalsolution/ontosight .
-npx @royalsolution/ontosight . --symbol <name> --path <dir>
-npx @royalsolution/ontosight . --task "auth flow" --hops 2 --max-nodes 200
-npx @royalsolution/ontosight . --symbol <name> --path <dir> --hops 3 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 .
+npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir>
+npx @royalsolution/ontosight@0.2.0 . --task "auth flow" --hops 2 --max-nodes 200
+npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200
 ```
 
 Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unless `ONTOSIGHT_SKIP_AUTO_INIT=1`). Ask the user before auto-init on very large repos.
@@ -83,7 +83,7 @@ Auto-creates the CodeGraph index when `.codegraph/codegraph.db` is missing (unle
 
 | Requirement | Notes |
 |-------------|-------|
-| Node 20+ | For `npx @royalsolution/ontosight` |
+| Node 20+ | For `npx @royalsolution/ontosight@0.2.0` |
 | Python 3.11+ | Used by `ontosight-codegraph` |
 | uv (recommended) or pipx | Wrapper tries `uvx` first, then `pipx run` |
 | CodeGraph index | `.codegraph/codegraph.db` in project root |

package/AGENTS.md

@@ -37,7 +37,7 @@ Project guidance for AI coding agents:
 ## Code intelligence
 
 - **CodeGraph MCP** (`codegraph_*`) — structural code search in chat; rules in each tool's `codegraph` rule file
-- **OntoSight** (`npx @royalsolution/ontosight`) — interactive call-graph visualization in the browser; rules in each tool's `ontosight` rule file
+- **OntoSight** (`npx @royalsolution/ontosight@0.2.0`) — interactive call-graph visualization in the browser; rules in each tool's `ontosight` rule file
 
 ## Maintainers
 

package/GEMINI.md

@@ -101,7 +101,7 @@ This project includes **[OntoSight](https://www.npmjs.com/package/@royalsolution
 | Setup reference | `.agents/references/ontosight.md` |
 | Shared index | `.codegraph/` (same as CodeGraph) |
 
-Use `codegraph_*` MCP tools to gather structural facts in chat; run `npx @royalsolution/ontosight .` when the user wants a visual call graph. Requires Node 20+, Python 3.11+, and uv or pipx.
+Use `codegraph_*` MCP tools to gather structural facts in chat; run `npx @royalsolution/ontosight@0.2.0 .` when the user wants a visual call graph. For **impact analysis demos**, follow `skills/ui-ux-pro-max/IMPACT-DEMO.md` (search → `codegraph_impact` → summary → graph). Requires Node 20+, Python 3.11+, and uv or pipx.
 
 ---
 

package/README.md

@@ -18,7 +18,7 @@ Open-source AI agent scaffolding by **Royal Solution** — use it in your own pr
   <a href="https://www.npmjs.com/package/class-ai-agent"><img src="https://img.shields.io/npm/v/class-ai-agent?label=npm&logo=npm&style=flat-square" alt="npm version" /></a>
   <img src="https://img.shields.io/badge/node-%3E%3D16.7-339933?logo=node.js&logoColor=white&style=flat-square" alt="Node.js 16.7+" />
   <img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License MIT" />
-  <img src="https://img.shields.io/badge/version-1.6.1-blue?style=flat-square" alt="Version" />
+  <img src="https://img.shields.io/badge/version-1.6.2-blue?style=flat-square" alt="Version" />
 </p>
 
 </div>
@@ -58,7 +58,7 @@ Open-source AI agent scaffolding by **Royal Solution** — use it in your own pr
 | **13 topic rules** | Code style, security, API, DB, testing, git, and more (same ideas in both trees) |
 | **`npx` installer** | Copies the folders into your project in one command |
 | **CodeGraph** | MCP + usage rules for Cursor and Kiro; Antigravity via user `mcp_config.json`; local index via [CodeGraph](https://github.com/colbymchenry/codegraph) |
-| **OntoSight** | Visual call-graph UI via `npx @royalsolution/ontosight`; usage rules synced to all four agent trees |
+| **OntoSight** | Visual call-graph UI via `npx @royalsolution/ontosight@0.2.0`; usage rules synced to all four agent trees |
 | **Agent continuity** | Committed **`.agent/SESSION.md`** — `/resume` and `/handoff` across Cursor, Claude Code, Kiro, and Antigravity |
 
 Root **`AGENTS.md`** links hubs: **`.cursor/CURSOR.md`**, **`.kiro/KIRO.md`**, **`.claude/CLAUDE.md`**, **`GEMINI.md`**.
@@ -151,7 +151,8 @@ npm exec -- class-ai-agent --dir /path/to/your/project
 | **Kiro** | `.kiro/steering/ontosight.md`, `.kiro/references/ontosight.md` |
 | **Claude Code** | `.claude/rules/ontosight.md`, `.claude/references/ontosight.md` |
 | **Antigravity** | `.agent/rules/ontosight.md`, `.agents/references/ontosight.md` |
-| **Quick start** | `npx @royalsolution/ontosight .` (auto-inits CodeGraph index if missing) |
+| **Quick start** | `npx @royalsolution/ontosight@0.2.0 .` (auto-inits CodeGraph index if missing) |
+| **Pinned version** | `@royalsolution/ontosight@0.2.0` (`ontosight-codegraph` 0.2.0 on PyPI) |
 | **Requirements** | Node 20+, Python 3.11+, uv or pipx; shares `.codegraph/` with CodeGraph |
 | **Troubleshooting** | `.cursor/references/ontosight.md` |
 | **Impact demos** | `skills/ui-ux-pro-max/IMPACT-DEMO.md` — `codegraph_impact` → UX summary → graph |
@@ -160,7 +161,7 @@ Example agent workflow (feature area):
 
 ```text
 1. codegraph_context({ task: "auth flow", maxNodes: 20 })  → answer in chat
-2. npx @royalsolution/ontosight . --task "auth flow" --hops 2   → open graph for user
+2. npx @royalsolution/ontosight@0.2.0 . --task "auth flow" --hops 2   → open graph for user
 ```
 
 Example **impact analysis** demo:
@@ -169,7 +170,7 @@ Example **impact analysis** demo:
 1. codegraph_search({ query: "deleteUser" })
 2. codegraph_impact({ query: "deleteUser" })  → ranked blast radius in chat
 3. Follow IMPACT-DEMO.md (ui-ux-pro-max presentation)
-4. npx @royalsolution/ontosight . --symbol deleteUser --path src/services/ --hops 3
+4. npx @royalsolution/ontosight@0.2.0 . --symbol deleteUser --path src/services/ --hops 3
 ```
 
 ---
@@ -436,6 +437,10 @@ Ship thin end-to-end slices (DB + API + UI), not “all models first, then all r
 
 
 
+### 1.6.2 — 2026-06-19
+
+- Pin agent OntoSight CLI invocations to **`@royalsolution/ontosight@0.2.0`** (latest; `ontosight-codegraph` 0.2.0)
+
 ### 1.6.1 — 2026-06-19
 
 - Add **impact analysis demonstration** workflow: `codegraph_impact` → UX summary → OntoSight graph
@@ -444,7 +449,7 @@ Ship thin end-to-end slices (DB + API + UI), not “all models first, then all r
 
 ### 1.6.0 — 2026-06-19
 
-- Integrate **[OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight)** — visual CodeGraph call subgraphs via `npx @royalsolution/ontosight`
+- Integrate **[OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight)** — visual CodeGraph call subgraphs via `npx @royalsolution/ontosight@0.2.0`
 - Add always-on `ontosight` rules and references synced to Cursor, Claude Code, Kiro, and Antigravity
 - Cross-link CodeGraph rules with OntoSight visualization workflows
 

package/bin/class-ai-agent.cjs

@@ -40,7 +40,7 @@ CodeGraph:
   (Node 20+ recommended). Set CODEGRAPH_SKIP_INIT=1 to skip indexing.
 
 OntoSight:
-  Visual call graphs: npx @royalsolution/ontosight .
+  Visual call graphs: npx @royalsolution/ontosight@0.2.0 .
   Agent rules installed at .cursor/rules/ontosight.mdc (and synced trees).
   Requires Node 20+, Python 3.11+, uv or pipx.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "class-ai-agent",
-  "version": "1.6.1",
+  "version": "1.6.2",
   "description": "Production-grade AI agent configuration for Claude Code, Cursor, Kiro & Antigravity",
   "license": "MIT",
   "repository": {