class-ai-agent 1.6.2 → 1.6.4

package/README.md

@@ -1,6 +1,12 @@
-# AI Agent Project
+# class-ai-agent
 
-**Production-grade configuration for [Claude Code](https://code.claude.com/docs), [Cursor](https://cursor.com), [Kiro](https://kiro.dev), and [Antigravity](https://antigravity.google)** — shared rules, specialized agents, workflow prompts, and checklists you can drop into any repository.
+**Give your AI coding agents the same discipline your team expects from production software.**
+
+AI assistants like [Cursor](https://cursor.com), [Claude Code](https://code.claude.com/docs), [Kiro](https://kiro.dev), and [Antigravity](https://antigravity.google) move fast—but without shared rules, workflows, and handoff, every session starts from zero and quality depends on whoever wrote the prompt last. **class-ai-agent** is open-source scaffolding you drop into any repository: structured workflows, security guardrails, specialized agent personas, and code intelligence that stays with the project—not in a single chat thread.
+
+Install once with `npx class-ai-agent`. You get four parallel layouts (`.cursor/`, `.claude/`, `.kiro/`, `.agents/` + `GEMINI.md`) wired to the same habits: Spec → Plan → Build → Test → Review → Ship. Session continuity lives in committed [`.agent/SESSION.md`](.agent/SESSION.md), so you can switch IDE, teammate, or model and resume with `/handoff` and `/resume`. CodeGraph and OntoSight rules, Supabase skills, and MCP configs ship pre-configured for Cursor and Kiro.
+
+**Built for:** developers who want AI speed without sacrificing standards · teams aligning multiple AI tools · repos where security, TDD, and review are non-negotiable.
 
 <div align="center">
 
@@ -18,7 +24,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.2-blue?style=flat-square" alt="Version" />
+  <img src="https://img.shields.io/badge/version-1.6.4-blue?style=flat-square" alt="Version" />
 </p>
 
 </div>
@@ -151,7 +157,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@0.2.0 .` (auto-inits CodeGraph index if missing) |
+| **Quick start** | `npx @royalsolution/ontosight@0.2.0 "<workspace-root>"` — pass absolute workspace root (not bare `.`); auto-inits CodeGraph index if missing |
+| **Project graph** | Preflight with `codegraph_status`; seeds from `codegraph_search` in same project — see `.cursor/rules/ontosight.mdc` |
 | **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` |
@@ -160,19 +167,23 @@ npm exec -- class-ai-agent --dir /path/to/your/project
 Example agent workflow (feature area):
 
 ```text
-1. codegraph_context({ task: "auth flow", maxNodes: 20 })  → answer in chat
-2. npx @royalsolution/ontosight@0.2.0 . --task "auth flow" --hops 2   → open graph for user
+0. codegraph_status({ projectPath: "<workspace-root>" })
+1. codegraph_context({ task: "auth flow", maxNodes: 20, projectPath: "<workspace-root>" })  → answer in chat
+2. npx @royalsolution/ontosight@0.2.0 "<workspace-root>" --task "auth flow" --hops 2   → open graph for user
 ```
 
 Example **impact analysis** demo:
 
 ```text
-1. codegraph_search({ query: "deleteUser" })
-2. codegraph_impact({ query: "deleteUser" })  → ranked blast radius in chat
+0. codegraph_status({ projectPath: "<workspace-root>" })
+1. codegraph_search({ query: "<symbol>", projectPath: "<workspace-root>" })
+2. codegraph_impact({ query: "<symbol>", projectPath: "<workspace-root>" })  → ranked blast radius in chat
 3. Follow IMPACT-DEMO.md (ui-ux-pro-max presentation)
-4. npx @royalsolution/ontosight@0.2.0 . --symbol deleteUser --path src/services/ --hops 3
+4. npx @royalsolution/ontosight@0.2.0 "<workspace-root>" --symbol <name> --path <dir> --hops 3
 ```
 
+**Wrong graph in browser?** OntoSight defaults to shell `cwd` — always pass the absolute workspace root as `[project-path]`. See `.cursor/references/ontosight.md` troubleshooting.
+
 ---
 
 ## Overview
@@ -437,6 +448,21 @@ Ship thin end-to-end slices (DB + API + UI), not “all models first, then all r
 
 
 
+
+
+
+
+### 1.6.4 — 2026-06-19
+
+- Professional README hero introduction — outcome-led copy for developers and teams using Cursor, Claude Code, Kiro, and Antigravity
+- Update npm package description to highlight rules, workflows, agents, CodeGraph, and cross-tool session handoff
+
+### 1.6.3 — 2026-06-19
+
+- Add **Project graph fidelity** rules for OntoSight — mandatory `codegraph_status` preflight, absolute workspace root as `[project-path]`, seed binding from CodeGraph MCP
+- Replace fragile bare `.` OntoSight examples with `<workspace-root>` across rules, references, IMPACT-DEMO, README, and CLI help
+- Add wrong-graph troubleshooting (foreign repo symbols, MCP/OntoSight path mismatch)
+
 ### 1.6.2 — 2026-06-19
 
 - Pin agent OntoSight CLI invocations to **`@royalsolution/ontosight@0.2.0`** (latest; `ontosight-codegraph` 0.2.0)

package/bin/class-ai-agent.cjs

@@ -40,7 +40,9 @@ CodeGraph:
   (Node 20+ recommended). Set CODEGRAPH_SKIP_INIT=1 to skip indexing.
 
 OntoSight:
-  Visual call graphs: npx @royalsolution/ontosight@0.2.0 .
+  Visual call graphs: npx @royalsolution/ontosight@0.2.0 "<workspace-root>"
+  Pass absolute workspace root as [project-path] (not bare .) so the browser loads this project's graph.
+  Preflight with codegraph_status; seed --symbol from codegraph_search in the same project.
   Agent rules installed at .cursor/rules/ontosight.mdc (and synced trees).
   Requires Node 20+, Python 3.11+, uv or pipx.
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "class-ai-agent",
-  "version": "1.6.2",
-  "description": "Production-grade AI agent configuration for Claude Code, Cursor, Kiro & Antigravity",
+  "version": "1.6.4",
+  "description": "Production-grade AI agent scaffolding for Cursor, Claude Code, Kiro & Antigravity — rules, workflows, agents, CodeGraph, and cross-tool handoff.",
   "license": "MIT",
   "repository": {
     "type": "git",