class-ai-agent 1.5.1 → 1.6.2

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.
@@ -0,0 +1,101 @@
1
+ # Impact analysis demonstration — UX playbook
2
+
3
+ Use this playbook when presenting **CodeGraph impact analysis** with an **OntoSight** graph demo. It extends the [ui-ux-pro-max SKILL](SKILL.md) for a specific agent workflow — not a full design-system pass.
4
+
5
+ **Skill path by tool:** `.cursor/skills/ui-ux-pro-max/`, `.claude/skills/ui-ux-pro-max/`, `.kiro/skills/ui-ux-pro-max/`, `.agents/skills/ui-ux-pro-max/`
6
+
7
+ ---
8
+
9
+ ## When to use
10
+
11
+ User asks about blast radius, what breaks, downstream impact, or wants to **see** / **show** / **demonstrate** impact before a refactor, rename, or delete.
12
+
13
+ Pair with **`.cursor/rules/ontosight.mdc`** (or synced `ontosight` rule in your tool tree).
14
+
15
+ ---
16
+
17
+ ## ui-ux-pro-max searches (optional, recommended)
18
+
19
+ Run from project root. Adjust the skills path to match your tool.
20
+
21
+ ### Network graph UX
22
+
23
+ ```bash
24
+ python3 .cursor/skills/ui-ux-pro-max/scripts/search.py "relationship connection network graph" --domain chart
25
+ ```
26
+
27
+ Use for: drilldown + hover expectations; provide an adjacency-list or ranked table alternative (network graphs are poor for screen-reader-only users).
28
+
29
+ ### Impact tier framing
30
+
31
+ ```bash
32
+ python3 .cursor/skills/ui-ux-pro-max/scripts/search.py "root cause decomposition hierarchy drill-down" --domain chart
33
+ ```
34
+
35
+ Use for: grouping impact into tiers (direct callers vs transitive) in chat before opening the graph.
36
+
37
+ ### Progressive disclosure
38
+
39
+ ```bash
40
+ python3 .cursor/skills/ui-ux-pro-max/scripts/search.py "progressive disclosure loading feedback" --domain ux
41
+ ```
42
+
43
+ Use for: summary-before-graph; tell the user what OntoSight is loading and what they will see.
44
+
45
+ ---
46
+
47
+ ## Chat summary template
48
+
49
+ Present this **before** running `npx @royalsolution/ontosight@0.2.0`:
50
+
51
+ ### 1. Seed
52
+
53
+ - Symbol name, kind (function, class, …), file path
54
+
55
+ ### 2. Blast radius
56
+
57
+ Top 5–10 from `codegraph_impact`, in a **ranked table**:
58
+
59
+ | Rank | Symbol | File | Relationship |
60
+ |------|--------|------|--------------|
61
+ | 1 | … | … | direct caller |
62
+ | 2 | … | … | transitive |
63
+
64
+ Group by risk: **direct callers** (highest) vs **transitive** (lower).
65
+
66
+ ### 3. What the graph shows
67
+
68
+ - Seed node and `--hops` depth (typically 3 for impact demos)
69
+ - Note that OntoSight highlights critical / hub nodes in the topology table
70
+ - Mention interactive pan, zoom, and live CodeGraph re-query in the browser
71
+
72
+ ### 4. Action
73
+
74
+ Short line: *"Opening interactive impact graph…"* then run:
75
+
76
+ ```bash
77
+ npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir-from-search> --hops 3 --max-nodes 200
78
+ ```
79
+
80
+ ---
81
+
82
+ ## Accessibility notes
83
+
84
+ - **Always** include the ranked table — graph-only answers fail accessibility guidance for network visualizations.
85
+ - Keep table columns sortable by impact rank when possible in prose.
86
+ - If subgraph truncates, say so and offer a narrower `--path` before raising `--max-nodes`.
87
+
88
+ ---
89
+
90
+ ## Full agent workflow
91
+
92
+ ```text
93
+ 1. codegraph_search({ query: "<symbol>" })
94
+ 2. codegraph_impact({ query: "<symbol>" })
95
+ 3. Read this file (IMPACT-DEMO.md)
96
+ 4. Optional: ui-ux-pro-max chart/ux searches above
97
+ 5. Chat summary (template sections 1–3)
98
+ 6. npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200
99
+ ```
100
+
101
+ See **`.cursor/references/ontosight.md`** for flags and troubleshooting.
@@ -23,6 +23,14 @@ Use codegraph for **structural** questions — what calls what, what would break
23
23
  | "See several related symbols' source at once" | `codegraph_explore` |
24
24
  | "What files exist under path/" | `codegraph_files` |
25
25
  | "Is the index healthy?" | `codegraph_status` |
26
+ | Visual exploration of a subgraph in browser | `npx @royalsolution/ontosight@0.2.0` (see **`.kiro/rules/ontosight.md`**) |
27
+ | "Show/demonstrate impact of changing Z" | `codegraph_impact` → then OntoSight `--symbol Z` (see **`.kiro/rules/ontosight.md`**) |
28
+
29
+ ### Visualization
30
+
31
+ For interactive call-graph UI (user asks to "show the graph" or explore architecture visually), use **OntoSight CLI** after gathering context with `codegraph_*` tools. See **`.kiro/rules/ontosight.md`**.
32
+
33
+ For **impact demonstration** requests ("show impact", "blast radius", "what breaks if I change X"), run `codegraph_impact` first, present a text summary, then open OntoSight — never stop at MCP text alone when the user wants to see or show impact.
26
34
 
27
35
  ### Tool parameters (do not mix)
28
36
 
@@ -24,10 +24,11 @@ Supporting prompts: `debug`, `simplify`, `fix-issue`, `handoff`, `resume` in `.k
24
24
 
25
25
  ## Mandatory standards
26
26
 
27
- - Follow **`.kiro/steering/`** (`*.md` with YAML frontmatter). **`security.md`**, **`codegraph.md`**, and **`agent-continuity.md`** use `inclusion: always`; others often use `fileMatch`.
27
+ - Follow **`.kiro/steering/`** (`*.md` with YAML frontmatter). **`security.md`**, **`codegraph.md`**, **`ontosight.md`**, and **`agent-continuity.md`** use `inclusion: always`; others often use `fileMatch`.
28
28
  - Prefer **tests first** and **small vertical slices** (see `.kiro/skills/incremental-implementation/`).
29
29
  - Use **`.kiro/references/`** for checklists (security, testing, performance, accessibility).
30
30
  - For **structural** code questions, prefer **CodeGraph** MCP tools per **`.kiro/steering/codegraph.md`**.
31
+ - When the user wants a **visual call graph**, use **OntoSight CLI** per **`.kiro/steering/ontosight.md`** (`npx @royalsolution/ontosight@0.2.0`).
31
32
 
32
33
  ## Agents (personas)
33
34
 
@@ -0,0 +1,89 @@
1
+ ---
2
+ inclusion: always
3
+ description: "OntoSight CLI — visualize CodeGraph call subgraphs in the browser"
4
+ ---
5
+
6
+ ## OntoSight
7
+
8
+ [OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight) visualizes CodeGraph call subgraphs in an interactive browser UI. It is **not** an MCP server — there are no `ontosight_*` tools. Use **CodeGraph MCP** (`codegraph_*`) to answer structural questions in chat; use **OntoSight CLI** when the user wants a visual, interactive call graph.
9
+
10
+ See **`.kiro/rules/codegraph.md`** for MCP usage and **`.kiro/references/ontosight.md`** for full flags and troubleshooting.
11
+
12
+ ### CodeGraph MCP vs OntoSight
13
+
14
+ | Goal | Use |
15
+ |------|-----|
16
+ | Find symbols, callers, traces, impact (text in chat) | `codegraph_*` MCP tools |
17
+ | Visual exploration of a subgraph | `npx @royalsolution/ontosight@0.2.0` |
18
+ | User says "show me the graph" | OntoSight CLI |
19
+ | Impact / blast radius demonstration | `codegraph_impact` → summary → OntoSight CLI |
20
+
21
+ Rule of thumb: gather facts with CodeGraph MCP; open OntoSight when visualization helps the human explore complexity you already identified.
22
+
23
+ ### When to run OntoSight
24
+
25
+ Run (or suggest) OntoSight when the user:
26
+
27
+ - Asks to visualize, show, or explore a call graph or architecture
28
+ - Wants an interactive view after you surfaced symbols via `codegraph_search` / `codegraph_context`
29
+ - Is doing onboarding or architecture review and benefits from a graph UI
30
+ - Asks about **impact**, **blast radius**, or **what breaks** and wants to see or demonstrate scope (refactor, rename, delete)
31
+
32
+ Do **not** run OntoSight to collect agent context — that duplicates CodeGraph MCP and blocks the terminal while the browser is open.
33
+
34
+ ### Impact analysis demonstration
35
+
36
+ **Triggers** — open the graph, not only text:
37
+
38
+ - "impact", "blast radius", "what breaks", "what would break", "downstream", "affected by"
39
+ - "show impact", "demonstrate impact", "visualize impact"
40
+ - User is about to refactor, rename, or delete a symbol and wants to see scope
41
+
42
+ **Workflow** (mandatory order):
43
+
44
+ 1. `codegraph_search({ query: "<symbol>" })` — confirm name, file, kind
45
+ 2. `codegraph_impact({ query: "<symbol>" })` — ranked blast radius (chat facts)
46
+ 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/`)
47
+ 4. Optional: run ui-ux-pro-max searches from the playbook for chart/UX framing
48
+ 5. Summarize in chat: seed symbol, top impacted callers, risk tier, what the graph will highlight
49
+ 6. `npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200`
50
+
51
+ **Hop guidance:** use `--hops 3` (or `4` for deep trees) for impact demos; prefer `--path` over raising `--max-nodes` when truncated.
52
+
53
+ **UX rule:** always give a **text summary before** opening the browser (progressive disclosure); include a **ranked table** of top impacted symbols as an accessible alternative to the graph alone.
54
+
55
+ ### Suggested workflows
56
+
57
+ **Symbol the user named:**
58
+
59
+ 1. `codegraph_search({ query: "<name>" })` → confirm file + kind
60
+ 2. Summarize in chat
61
+ 3. `npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir-from-search>`
62
+
63
+ **Feature area ("how does auth work?"):**
64
+
65
+ 1. `codegraph_context({ task: "authentication flow", maxNodes: 20 })`
66
+ 2. Summarize key symbols in chat
67
+ 3. `npx @royalsolution/ontosight@0.2.0 . --task "authentication flow" --hops 2 --max-nodes 200`
68
+
69
+ **Large repo:** prefer `--path` or `--symbol` before raising `--max-nodes`.
70
+
71
+ ### Commands
72
+
73
+ ```bash
74
+ npx @royalsolution/ontosight@0.2.0 .
75
+ npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir>
76
+ npx @royalsolution/ontosight@0.2.0 . --task "auth flow" --hops 2 --max-nodes 200
77
+ npx @royalsolution/ontosight@0.2.0 . --symbol <name> --path <dir> --hops 3 --max-nodes 200
78
+ ```
79
+
80
+ 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.
81
+
82
+ ### Prerequisites
83
+
84
+ | Requirement | Notes |
85
+ |-------------|-------|
86
+ | Node 20+ | For `npx @royalsolution/ontosight@0.2.0` |
87
+ | Python 3.11+ | Used by `ontosight-codegraph` |
88
+ | uv (recommended) or pipx | Wrapper tries `uvx` first, then `pipx run` |
89
+ | CodeGraph index | `.codegraph/codegraph.db` in project root |
package/AGENTS.md CHANGED
@@ -34,6 +34,11 @@ Project guidance for AI coding agents:
34
34
 
35
35
  **Cross-tool continuity:** committed [`.agent/SESSION.md`](.agent/README.md) — use `/resume` at session start and `/handoff` at session end (see hub docs and `.agent/README.md`).
36
36
 
37
+ ## Code intelligence
38
+
39
+ - **CodeGraph MCP** (`codegraph_*`) — structural code search in chat; rules in each tool's `codegraph` rule file
40
+ - **OntoSight** (`npx @royalsolution/ontosight@0.2.0`) — interactive call-graph visualization in the browser; rules in each tool's `ontosight` rule file
41
+
37
42
  ## Maintainers
38
43
 
39
44
  Keep **`.claude/`**, **`.cursor/`**, **`.kiro/`**, and the Antigravity layout in sync when you change workflows or standards. After editing **`.cursor/`** (canonical), run **`npm run sync:all`** to refresh `.claude/`, `.kiro/`, `.agents/`, `.agent/rules/`, and `GEMINI.md`. To refresh vendored Supabase skills from upstream, run **`npm run sync:supabase-skills`**.
package/GEMINI.md CHANGED
@@ -52,7 +52,7 @@ Follow this workflow for feature development:
52
52
 
53
53
  Project standards are **`.agent/rules/*.md`**. They use YAML frontmatter:
54
54
 
55
- - **`trigger: always_on`** — Loaded every session (`antigravity-overview.md`, `security.md`, `codegraph.md`, `agent-continuity.md`)
55
+ - **`trigger: always_on`** — Loaded every session (`antigravity-overview.md`, `security.md`, `codegraph.md`, `ontosight.md`, `agent-continuity.md`)
56
56
  - **`trigger: glob`** — Loaded when active files match `globs`
57
57
  - **`trigger: model_decision`** — Activated by intent (persona rules)
58
58
 
@@ -63,6 +63,7 @@ Project standards are **`.agent/rules/*.md`**. They use YAML frontmatter:
63
63
  | Data & naming | `naming-conventions`, `database` |
64
64
  | Ops & quality | `security`, `monitoring`, `testing`, `git-workflow`, `system-design` |
65
65
  | Code intelligence | `codegraph` (MCP usage; see below) |
66
+ | Code visualization | `ontosight` (CLI; see below) |
66
67
  | Agent continuity | `agent-continuity` (`.agent/SESSION.md` handoff) |
67
68
 
68
69
  ---
@@ -90,6 +91,20 @@ If the index is missing, run `npx @colbymchenry/codegraph init -i` in the projec
90
91
 
91
92
  ---
92
93
 
94
+ ## Code visualization (OntoSight)
95
+
96
+ This project includes **[OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight)** for interactive CodeGraph call subgraphs in the browser.
97
+
98
+ | Item | Location |
99
+ |------|----------|
100
+ | Usage rules | `.agent/rules/ontosight.md` |
101
+ | Setup reference | `.agents/references/ontosight.md` |
102
+ | Shared index | `.codegraph/` (same as CodeGraph) |
103
+
104
+ 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.
105
+
106
+ ---
107
+
93
108
  ## Agent personas
94
109
 
95
110
  Instructions live in **`.agents/agents/`**. Invoke by **referencing** the file (paste or attach in chat).
@@ -130,6 +145,7 @@ Reusable playbooks: **`.agents/skills/*/SKILL.md`** (and related `.md` files whe
130
145
  | `performance-checklist.md` | Performance |
131
146
  | `accessibility-checklist.md` | WCAG-oriented checks |
132
147
  | `codegraph.md` | CodeGraph setup (all tools) |
148
+ | `ontosight.md` | OntoSight CLI for visual call graphs |
133
149
  | `mcp-antigravity.md` | Antigravity MCP config (`mcp_config.json`) |
134
150
  | `agent-continuity.md` | Session handoff and `/resume` / `/handoff` |
135
151
  | `supabase.md` | Supabase skills, MCP OAuth, secrets |
package/README.md CHANGED
@@ -18,7 +18,7 @@ Open-source AI agent scaffolding by **Royal Solution** — use it in your own pr
18
18
  <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>
19
19
  <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+" />
20
20
  <img src="https://img.shields.io/badge/license-MIT-blue?style=flat-square" alt="License MIT" />
21
- <img src="https://img.shields.io/badge/version-1.5.1-blue?style=flat-square" alt="Version" />
21
+ <img src="https://img.shields.io/badge/version-1.6.2-blue?style=flat-square" alt="Version" />
22
22
  </p>
23
23
 
24
24
  </div>
@@ -30,6 +30,7 @@ Open-source AI agent scaffolding by **Royal Solution** — use it in your own pr
30
30
  - [Why use this](#why-use-this)
31
31
  - [Install (quick)](#install-quick)
32
32
  - [CodeGraph (code intelligence)](#codegraph-code-intelligence)
33
+ - [OntoSight (code visualization)](#ontosight-code-visualization)
33
34
  - [Agent continuity (cross-tool)](#agent-continuity-cross-tool)
34
35
  - [Overview](#overview)
35
36
  - [Development workflow](#development-workflow)
@@ -57,6 +58,7 @@ Open-source AI agent scaffolding by **Royal Solution** — use it in your own pr
57
58
  | **13 topic rules** | Code style, security, API, DB, testing, git, and more (same ideas in both trees) |
58
59
  | **`npx` installer** | Copies the folders into your project in one command |
59
60
  | **CodeGraph** | MCP + usage rules for Cursor and Kiro; Antigravity via user `mcp_config.json`; local index via [CodeGraph](https://github.com/colbymchenry/codegraph) |
61
+ | **OntoSight** | Visual call-graph UI via `npx @royalsolution/ontosight@0.2.0`; usage rules synced to all four agent trees |
60
62
  | **Agent continuity** | Committed **`.agent/SESSION.md`** — `/resume` and `/handoff` across Cursor, Claude Code, Kiro, and Antigravity |
61
63
 
62
64
  Root **`AGENTS.md`** links hubs: **`.cursor/CURSOR.md`**, **`.kiro/KIRO.md`**, **`.claude/CLAUDE.md`**, **`GEMINI.md`**.
@@ -138,6 +140,41 @@ npm exec -- class-ai-agent --dir /path/to/your/project
138
140
 
139
141
  ---
140
142
 
143
+ ## OntoSight (code visualization)
144
+
145
+ [class-ai-agent](https://www.npmjs.com/package/class-ai-agent) integrates **[OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight)** — interactive CodeGraph call subgraphs in the browser. OntoSight complements CodeGraph MCP: use `codegraph_*` for facts in chat; use OntoSight when the user wants a visual graph.
146
+
147
+ | Topic | Details |
148
+ |-------|---------|
149
+ | **What you get** | Always-on usage rules across Cursor, Claude Code, Kiro, and Antigravity |
150
+ | **Cursor** | `.cursor/rules/ontosight.mdc`, `.cursor/references/ontosight.md` |
151
+ | **Kiro** | `.kiro/steering/ontosight.md`, `.kiro/references/ontosight.md` |
152
+ | **Claude Code** | `.claude/rules/ontosight.md`, `.claude/references/ontosight.md` |
153
+ | **Antigravity** | `.agent/rules/ontosight.md`, `.agents/references/ontosight.md` |
154
+ | **Quick start** | `npx @royalsolution/ontosight@0.2.0 .` (auto-inits CodeGraph index if missing) |
155
+ | **Pinned version** | `@royalsolution/ontosight@0.2.0` (`ontosight-codegraph` 0.2.0 on PyPI) |
156
+ | **Requirements** | Node 20+, Python 3.11+, uv or pipx; shares `.codegraph/` with CodeGraph |
157
+ | **Troubleshooting** | `.cursor/references/ontosight.md` |
158
+ | **Impact demos** | `skills/ui-ux-pro-max/IMPACT-DEMO.md` — `codegraph_impact` → UX summary → graph |
159
+
160
+ Example agent workflow (feature area):
161
+
162
+ ```text
163
+ 1. codegraph_context({ task: "auth flow", maxNodes: 20 }) → answer in chat
164
+ 2. npx @royalsolution/ontosight@0.2.0 . --task "auth flow" --hops 2 → open graph for user
165
+ ```
166
+
167
+ Example **impact analysis** demo:
168
+
169
+ ```text
170
+ 1. codegraph_search({ query: "deleteUser" })
171
+ 2. codegraph_impact({ query: "deleteUser" }) → ranked blast radius in chat
172
+ 3. Follow IMPACT-DEMO.md (ui-ux-pro-max presentation)
173
+ 4. npx @royalsolution/ontosight@0.2.0 . --symbol deleteUser --path src/services/ --hops 3
174
+ ```
175
+
176
+ ---
177
+
141
178
  ## Overview
142
179
 
143
180
  This repo ships **four parallel layouts** so you can use the same habits in Claude Code, Cursor, Kiro, and Antigravity:
@@ -153,12 +190,12 @@ What is inside:
153
190
 
154
191
  - **Structured workflow** (Spec → Plan → Build → Test → Review → Ship)
155
192
  - **10 specialized agents** (markdown personas under `agents/`)
156
- - **13 mandatory topic rules** (plus **`cursor-overview.mdc`**, **`codegraph.mdc`**, and **`agent-continuity.mdc`** under `.cursor/rules/`)
193
+ - **13 mandatory topic rules** (plus **`cursor-overview.mdc`**, **`codegraph.mdc`**, **`ontosight.mdc`**, and **`agent-continuity.mdc`** under `.cursor/rules/`)
157
194
  - **11 workflow prompts** under `commands/` (includes `handoff`, `resume`)
158
195
  - **9 skills** (TDD, code review, incremental implementation, deploy, security review, agent continuity, UI/UX Pro Max, **supabase**, **supabase-postgres-best-practices**)
159
- - **7 reference docs** (security, testing, performance, accessibility, codegraph, agent-continuity, **supabase**)
196
+ - **8 reference docs** (security, testing, performance, accessibility, codegraph, ontosight, agent-continuity, **supabase**)
160
197
  - **`.agent/SESSION.md`** for cross-tool session handoff
161
- - **CodeGraph + Supabase MCP** for Cursor and Kiro (`.cursor/mcp.json`, `.kiro/settings/mcp.json`); Antigravity via user `mcp_config.json` (example in `.agents/references/mcp-antigravity.md`)
198
+ - **CodeGraph + Supabase MCP** for Cursor and Kiro (`.cursor/mcp.json`, `.kiro/settings/mcp.json`); Antigravity via user `mcp_config.json` (example in `.agents/references/mcp-antigravity.md`); **OntoSight CLI** for visual call graphs
162
199
 
163
200
  Keep **`.claude/`**, **`.cursor/`**, **`.kiro/`**, and the Antigravity layout in sync when you change standards. After editing `.cursor/` (canonical), run **`npm run sync:all`** to refresh `.claude/`, `.kiro/`, `.agents/`, `.agent/rules/`, and `GEMINI.md`.
164
201
 
@@ -242,7 +279,7 @@ Same ideas as `.claude/` for `commands/`, `agents/`, `skills/`, `references/`. D
242
279
  | Item | Role |
243
280
  |------|------|
244
281
  | **`CURSOR.md`** | Hub (like `CLAUDE.md`, Cursor-focused) |
245
- | **`rules/*.mdc`** | Project rules + YAML; **`security.mdc`**, **`cursor-overview.mdc`**, **`codegraph.mdc`** are central |
282
+ | **`rules/*.mdc`** | Project rules + YAML; **`security.mdc`**, **`cursor-overview.mdc`**, **`codegraph.mdc`**, **`ontosight.mdc`** are central |
246
283
  | **`mcp.json`** | MCP servers (CodeGraph) |
247
284
  | **`settings.json`** | Path hints (mirrors Claude layout) |
248
285
  | **`AGENTS.md`** (repo root) | Entry pointer for Cursor |
@@ -254,9 +291,9 @@ Same ideas as `.claude/` for `commands/`, `agents/`, `skills/`, `references/`. D
254
291
  ├── settings.json
255
292
  ├── commands/
256
293
  ├── agents/
257
- ├── rules/ # 16 × .mdc (13 topics + cursor-overview + codegraph + agent-continuity)
294
+ ├── rules/ # 17 × .mdc (13 topics + cursor-overview + codegraph + ontosight + agent-continuity)
258
295
  ├── skills/
259
- └── references/ # includes codegraph.md
296
+ └── references/ # includes codegraph.md, ontosight.md
260
297
  ```
261
298
 
262
299
  After install, **`.codegraph/`** (generated index) lives at the project root and should stay gitignored.
@@ -400,6 +437,22 @@ Ship thin end-to-end slices (DB + API + UI), not “all models first, then all r
400
437
 
401
438
 
402
439
 
440
+ ### 1.6.2 — 2026-06-19
441
+
442
+ - Pin agent OntoSight CLI invocations to **`@royalsolution/ontosight@0.2.0`** (latest; `ontosight-codegraph` 0.2.0)
443
+
444
+ ### 1.6.1 — 2026-06-19
445
+
446
+ - Add **impact analysis demonstration** workflow: `codegraph_impact` → UX summary → OntoSight graph
447
+ - New `skills/ui-ux-pro-max/IMPACT-DEMO.md` playbook (ui-ux-pro-max chart/UX framing, accessible ranked table)
448
+ - Extend `ontosight` and `codegraph` rules with impact triggers and visualization cross-links
449
+
450
+ ### 1.6.0 — 2026-06-19
451
+
452
+ - Integrate **[OntoSight](https://www.npmjs.com/package/@royalsolution/ontosight)** — visual CodeGraph call subgraphs via `npx @royalsolution/ontosight@0.2.0`
453
+ - Add always-on `ontosight` rules and references synced to Cursor, Claude Code, Kiro, and Antigravity
454
+ - Cross-link CodeGraph rules with OntoSight visualization workflows
455
+
403
456
  ### 1.5.1 — 2026-06-17
404
457
 
405
458
  - Sync package-lock.json version with package.json
@@ -39,6 +39,11 @@ CodeGraph:
39
39
  After install, runs "npx @colbymchenry/codegraph init -i" in the target directory
40
40
  (Node 20+ recommended). Set CODEGRAPH_SKIP_INIT=1 to skip indexing.
41
41
 
42
+ OntoSight:
43
+ Visual call graphs: npx @royalsolution/ontosight@0.2.0 .
44
+ Agent rules installed at .cursor/rules/ontosight.mdc (and synced trees).
45
+ Requires Node 20+, Python 3.11+, uv or pipx.
46
+
42
47
  Supabase:
43
48
  Bundled skills under skills/supabase/ and skills/supabase-postgres-best-practices/.
44
49
  MCP: https://mcp.supabase.com/mcp (OAuth on first use). Reload Cursor / restart Kiro after install.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "class-ai-agent",
3
- "version": "1.5.1",
3
+ "version": "1.6.2",
4
4
  "description": "Production-grade AI agent configuration for Claude Code, Cursor, Kiro & Antigravity",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -19,6 +19,7 @@
19
19
  "antigravity",
20
20
  "gemini",
21
21
  "codegraph",
22
+ "ontosight",
22
23
  "supabase",
23
24
  "ai",
24
25
  "agent",
@@ -49,6 +50,6 @@
49
50
  "sync:all": "node scripts/sync-all.mjs",
50
51
  "sync:supabase-skills": "node scripts/sync-supabase-skills.mjs",
51
52
  "release:readme": "node scripts/update-readme-release.mjs",
52
- "test:cli": "node bin/class-ai-agent.cjs --help && node bin/class-ai-agent.cjs --version && node -e \"const fs=require('fs');const c=JSON.parse(fs.readFileSync('.cursor/mcp.json','utf8'));const k=JSON.parse(fs.readFileSync('.kiro/settings/mcp.json','utf8'));if(!c.mcpServers?.codegraph||!k.mcpServers?.codegraph)throw new Error('missing codegraph MCP');if(!c.mcpServers?.supabase?.url?.includes('mcp.supabase.com')||!k.mcpServers?.supabase?.url?.includes('mcp.supabase.com'))throw new Error('missing supabase MCP');if(!fs.existsSync('.cursor/skills/supabase/SKILL.md')||!fs.existsSync('.cursor/skills/supabase-postgres-best-practices/SKILL.md'))throw new Error('missing supabase skills');if(!fs.existsSync('.claude/skills/supabase/SKILL.md'))throw new Error('missing claude supabase skill');if(!fs.existsSync('.agents/skills/supabase/SKILL.md'))throw new Error('missing antigravity supabase skill');if(!fs.existsSync('.cursor/references/supabase.md'))throw new Error('missing supabase reference');if(!fs.existsSync('.agents/references/mcp-antigravity.md'))throw new Error('missing mcp-antigravity reference');if(!fs.existsSync('scripts/sync-supabase-skills.mjs'))throw new Error('missing sync-supabase-skills');if(!fs.existsSync('.cursor/rules/codegraph.mdc'))throw new Error('missing codegraph.mdc');if(!fs.existsSync('.claude/rules/codegraph.md'))throw new Error('missing claude codegraph rule');if(!fs.existsSync('.kiro/steering/codegraph.md'))throw new Error('missing kiro codegraph steering');if(!fs.existsSync('.agent/rules/codegraph.md'))throw new Error('missing antigravity codegraph rule');if(!fs.existsSync('.agent/SESSION.template.md'))throw new Error('missing SESSION.template');if(!fs.existsSync('.cursor/rules/agent-continuity.mdc'))throw new Error('missing agent-continuity.mdc');if(!fs.existsSync('.kiro/steering/agent-continuity.md'))throw new Error('missing kiro agent-continuity steering');if(!fs.existsSync('.agent/rules/agent-continuity.md'))throw new Error('missing antigravity agent-continuity rule');if(!fs.existsSync('.cursor/commands/handoff.md')||!fs.existsSync('.cursor/commands/resume.md'))throw new Error('missing handoff/resume commands');if(!fs.existsSync('.agents/workflows/handoff.md')||!fs.existsSync('.agents/workflows/resume.md'))throw new Error('missing antigravity handoff/resume workflows');if(!fs.existsSync('GEMINI.md'))throw new Error('missing GEMINI.md');if(!fs.existsSync('scripts/sync-antigravity-from-cursor.mjs'))throw new Error('missing sync-antigravity script');\" && node scripts/check-parity.mjs"
53
+ "test:cli": "node bin/class-ai-agent.cjs --help && node bin/class-ai-agent.cjs --version && node -e \"const fs=require('fs');const c=JSON.parse(fs.readFileSync('.cursor/mcp.json','utf8'));const k=JSON.parse(fs.readFileSync('.kiro/settings/mcp.json','utf8'));if(!c.mcpServers?.codegraph||!k.mcpServers?.codegraph)throw new Error('missing codegraph MCP');if(!c.mcpServers?.supabase?.url?.includes('mcp.supabase.com')||!k.mcpServers?.supabase?.url?.includes('mcp.supabase.com'))throw new Error('missing supabase MCP');if(!fs.existsSync('.cursor/skills/supabase/SKILL.md')||!fs.existsSync('.cursor/skills/supabase-postgres-best-practices/SKILL.md'))throw new Error('missing supabase skills');if(!fs.existsSync('.claude/skills/supabase/SKILL.md'))throw new Error('missing claude supabase skill');if(!fs.existsSync('.agents/skills/supabase/SKILL.md'))throw new Error('missing antigravity supabase skill');if(!fs.existsSync('.cursor/references/supabase.md'))throw new Error('missing supabase reference');if(!fs.existsSync('.agents/references/mcp-antigravity.md'))throw new Error('missing mcp-antigravity reference');if(!fs.existsSync('scripts/sync-supabase-skills.mjs'))throw new Error('missing sync-supabase-skills');if(!fs.existsSync('.cursor/rules/codegraph.mdc'))throw new Error('missing codegraph.mdc');if(!fs.existsSync('.claude/rules/codegraph.md'))throw new Error('missing claude codegraph rule');if(!fs.existsSync('.kiro/steering/codegraph.md'))throw new Error('missing kiro codegraph steering');if(!fs.existsSync('.agent/rules/codegraph.md'))throw new Error('missing antigravity codegraph rule');if(!fs.existsSync('.cursor/rules/ontosight.mdc'))throw new Error('missing ontosight.mdc');if(!fs.existsSync('.claude/rules/ontosight.md'))throw new Error('missing claude ontosight rule');if(!fs.existsSync('.kiro/steering/ontosight.md'))throw new Error('missing kiro ontosight steering');if(!fs.existsSync('.agent/rules/ontosight.md'))throw new Error('missing antigravity ontosight rule');if(!fs.existsSync('.cursor/references/ontosight.md'))throw new Error('missing ontosight reference');if(!fs.existsSync('.agent/SESSION.template.md'))throw new Error('missing SESSION.template');if(!fs.existsSync('.cursor/rules/agent-continuity.mdc'))throw new Error('missing agent-continuity.mdc');if(!fs.existsSync('.kiro/steering/agent-continuity.md'))throw new Error('missing kiro agent-continuity steering');if(!fs.existsSync('.agent/rules/agent-continuity.md'))throw new Error('missing antigravity agent-continuity rule');if(!fs.existsSync('.cursor/commands/handoff.md')||!fs.existsSync('.cursor/commands/resume.md'))throw new Error('missing handoff/resume commands');if(!fs.existsSync('.agents/workflows/handoff.md')||!fs.existsSync('.agents/workflows/resume.md'))throw new Error('missing antigravity handoff/resume workflows');if(!fs.existsSync('GEMINI.md'))throw new Error('missing GEMINI.md');if(!fs.existsSync('scripts/sync-antigravity-from-cursor.mjs'))throw new Error('missing sync-antigravity script');if(!fs.existsSync('.cursor/skills/ui-ux-pro-max/IMPACT-DEMO.md'))throw new Error('missing IMPACT-DEMO.md');\" && node scripts/check-parity.mjs"
53
54
  }
54
55
  }