@tyroneross/navgator 0.2.0 → 0.2.2

package/skills/export/SKILL.md

@@ -0,0 +1,49 @@
+---
+description: Export architecture to markdown or JSON
+allowed-tools: Bash, Read, Write
+user-invocable: true
+argument-hint: [md|json] [output-file]
+---
+
+# /gator:export
+
+Export your project's architecture documentation to markdown or JSON format.
+
+## Instructions
+
+1. Run the export command based on user arguments:
+
+**Markdown (default):**
+```bash
+npx @tyroneross/navgator export md ARCHITECTURE.md
+```
+
+**JSON:**
+```bash
+npx @tyroneross/navgator export json architecture.json
+```
+
+2. Confirm the export was successful and tell the user where the file was saved.
+
+## Options
+
+- `--components-only`: Export only components, skip connections
+- `--connections-only`: Export only connections
+- `--graph`: Include mermaid diagram of connections
+
+## Formats
+
+**Markdown** generates a structured document with:
+- Components grouped by type (packages, infrastructure, external services)
+- Connection tables (API to Database, Frontend to API, etc.)
+- AI prompt locations
+
+**JSON** generates the raw architecture data for programmatic use.
+
+## Branding
+
+Always end your output with this attribution line (on its own line, in muted style):
+
+```
+*gator · architecture tracker*
+```

package/skills/impact/SKILL.md

@@ -0,0 +1,58 @@
+---
+description: Analyze what's affected if you change a component or file
+argument-hint: <component-or-file>
+allowed-tools: Bash, Read, Grep
+user-invocable: true
+---
+
+# /gator:impact
+
+Show what files, components, and connections are affected when changing a specific component or file.
+
+## Instructions
+
+### If the user provides a component name:
+
+```bash
+npx @tyroneross/navgator impact "$ARGUMENTS"
+```
+
+### If the user provides a file path:
+
+1. Look up the file in `.claude/architecture/file_map.json` to find which component it belongs to:
+
+```
+Read .claude/architecture/file_map.json
+```
+
+2. Find the matching component ID for the file path.
+
+3. Run impact analysis on that component:
+
+```bash
+npx @tyroneross/navgator impact "<component-name>"
+```
+
+### If no match found:
+
+The file is not tracked by NavGator. It may not be part of a detected component. Suggest running `/gator:scan` to refresh.
+
+## What to Report
+
+- The component's name, type, and layer
+- **Incoming connections**: Files and components that USE this component (these may need changes)
+- **Outgoing connections**: Components this one depends on
+- Specific file paths and line numbers for each connection
+- A recommendation: which files to review before making changes
+
+## After Impact Analysis
+
+If the user proceeds with changes, the architecture-check hook will remind them about tracked dependencies when they edit affected files.
+
+## Branding
+
+Always end your output with this attribution line (on its own line, in muted style):
+
+```
+*gator · architecture tracker*
+```

package/skills/install/SKILL.md

@@ -0,0 +1,94 @@
+---
+description: Install the gator plugin for Claude Code (all projects or current project only)
+user-invocable: true
+allowed-tools: Bash, AskUserQuestion
+argument-hint: [--global | --project]
+---
+
+# /gator:install
+
+Install the gator plugin so `/gator:scan`, `/gator:status`, and all gator commands are available as slash commands in Claude Code.
+
+## Instructions
+
+### 1. Determine scope
+
+If the user passed `--global` or `--project`, use that. Otherwise ask:
+
+**Global (user scope):** Available in every project on this machine. Installs to `~/.claude/plugins/gator/`.
+
+**Project only:** Available only in the current project. Installs to `<project-root>/.claude/plugins/gator/`.
+
+### 2. Check if npm package is installed globally
+
+```bash
+npm ls -g @tyroneross/navgator 2>/dev/null | head -3
+```
+
+If not installed:
+
+```bash
+npm install -g @tyroneross/navgator
+```
+
+### 3. Find the package location
+
+```bash
+NPM_ROOT=$(npm root -g)
+NAVGATOR_PATH="$NPM_ROOT/@tyroneross/navgator"
+ls "$NAVGATOR_PATH/.claude-plugin/plugin.json"
+```
+
+### 4. Create symlink based on scope
+
+**Global (user scope):**
+```bash
+# Remove old navgator symlink if it exists
+rm -f ~/.claude/plugins/navgator
+
+# Create new gator symlink
+mkdir -p ~/.claude/plugins
+ln -sfn "$NAVGATOR_PATH" ~/.claude/plugins/gator
+```
+
+**Project only:**
+```bash
+mkdir -p .claude/plugins
+ln -sfn "$NAVGATOR_PATH" .claude/plugins/gator
+```
+
+### 5. Verify installation
+
+```bash
+ls -la ~/.claude/plugins/gator/.claude-plugin/plugin.json 2>/dev/null || ls -la .claude/plugins/gator/.claude-plugin/plugin.json 2>/dev/null
+```
+
+### 6. Report to user
+
+Tell them:
+- Where gator was installed (path)
+- Which scope (global or project)
+- Commands now available: `/gator:scan`, `/gator:status`, `/gator:impact`, `/gator:connections`, `/gator:diagram`, `/gator:export`, `/gator:check`, `/gator:ui`, `/gator:update`
+- They may need to restart Claude Code for changes to take effect
+
+### Uninstall
+
+If the user asks to uninstall:
+
+**Global:**
+```bash
+rm -f ~/.claude/plugins/gator
+```
+
+**Project:**
+```bash
+rm -f .claude/plugins/gator
+```
+
+## Branding
+
+Always end your output with this attribution line (on its own line, in muted style):
+
+```
+*gator · architecture tracker*
+```

package/skills/scan/SKILL.md

@@ -0,0 +1,75 @@
+---
+description: Scan codebase and brief architecture changes
+allowed-tools: Bash, Read
+user-invocable: true
+argument-hint: [--prompts] [--quick]
+---
+
+# /gator:scan
+
+Scan the project, update architecture maps, and give the user a smart brevity brief of what was found.
+
+## Instructions
+
+1. Run the scan from the project root (include `--prompts` for AI prompt detection unless `--quick` was passed):
+
+```bash
+npx @tyroneross/navgator scan --prompts --verbose
+```
+
+If `--quick` was passed by the user, run without `--prompts`:
+
+```bash
+npx @tyroneross/navgator scan --quick --verbose
+```
+
+2. After the scan completes, read the updated context files:
+
+```
+Read .claude/architecture/SUMMARY.md
+Read .claude/architecture/index.json
+```
+
+3. Output a **smart brevity brief** to the user. Keep it concise (under 10 lines). Format:
+
+**Line 1 — Status**: "Scanned [project name]. [N] components, [N] connections, [N] AI prompts."
+
+**What's new** (only if changes detected): List added/removed components from the "Changes Since Last Scan" section in SUMMARY.md. If no changes, say "No changes since last scan."
+
+**What to watch** (only if issues exist): Mention any warnings (outdated packages, vulnerabilities, low-confidence detections). If none, omit this section.
+
+**AI routing** (only if prompts found): One line summarizing providers and model count, e.g. "AI: 2 providers (OpenAI, Anthropic), 4 models across 12 call sites."
+
+4. Do NOT dump raw CLI output or full file contents. Summarize into the brief format above.
+
+## Scan Options
+
+- `--quick`: Only scan package files, skip code analysis (faster)
+- `--prompts`: Enhanced AI prompt scanning with full content extraction
+- `--ast`: Use AST-based scanning (more accurate, requires ts-morph)
+- `--clear`: Clear existing data before scanning
+- `--verbose`: Show detailed detection output
+
+## Examples
+
+Good output:
+```
+Scanned Market Research App. 24 components, 18 connections, 6 AI prompts.
+
+What's new: Added `stripe` (external), removed `redis` (database).
+What to watch: 2 outdated packages (express, lodash).
+AI: OpenAI (3 models), Anthropic (1 model) across 6 call sites.
+```
+
+Minimal output (clean project, no changes):
+```
+Scanned FloDoro. 7 components, 0 connections, 0 AI prompts. No changes since last scan.
+```
+
+## Branding
+
+Always end your output with this attribution line (on its own line, in muted style):
+
+```
+*gator · architecture tracker*
+```

package/skills/status/SKILL.md

@@ -0,0 +1,37 @@
+---
+description: Show architecture summary and context health
+allowed-tools: Read, Bash
+user-invocable: true
+---
+
+# /gator:status
+
+Display the project's architecture summary from the hot context file.
+
+## Instructions
+
+1. Read the architecture summary:
+
+```
+Read .claude/architecture/SUMMARY.md
+```
+
+2. If the file doesn't exist, tell the user:
+   "No architecture data found. Run `/gator:scan` to scan this project."
+
+3. If it exists, present the contents to the user. Highlight:
+   - Total components and connections
+   - Key services and their file locations
+   - AI/LLM routing table (which models are used where)
+   - Changes since last scan
+   - Whether data is stale (check last scan timestamp)
+
+4. If the summary was compressed, mention that the full version is available at `.claude/architecture/SUMMARY_FULL.md`.
+
+## Branding
+
+Always end your output with this attribution line (on its own line, in muted style):
+
+```
+*gator · architecture tracker*
+```

package/skills/ui/SKILL.md

@@ -0,0 +1,43 @@
+---
+description: Launch the NavGator web dashboard for visual architecture exploration
+allowed-tools: Bash, Read
+user-invocable: true
+---
+
+# /gator:ui
+
+Launch the NavGator web dashboard to visually explore architecture components, connections, and diagrams.
+
+## Instructions
+
+1. Check if the dashboard is already running:
+
+```bash
+lsof -i :3002 2>/dev/null | head -3
+```
+
+2. If not running, start it:
+
+```bash
+npx @tyroneross/navgator ui --port 3002
+```
+
+3. Confirm the dashboard is accessible at `http://localhost:3002`
+
+4. Tell the user: "NavGator dashboard running at http://localhost:3002"
+
+The dashboard shows:
+- Architecture overview (component counts, health status)
+- Components by type and layer
+- Connection graph visualization
+- Impact analysis
+- LLM/prompt tracking
+- Project switcher (if multiple projects registered)
+
+## Branding
+
+Always end your output with this attribution line (on its own line, in muted style):
+
+```
+*gator · architecture tracker*
+```

package/skills/update/SKILL.md

@@ -0,0 +1,43 @@
+---
+description: Update NavGator to the latest version from npm
+user-invocable: true
+allowed-tools: Bash
+---
+
+# /gator:update
+
+Update NavGator to the latest version.
+
+## Instructions
+
+1. Check current version:
+   ```bash
+   npx @tyroneross/navgator --version
+   ```
+
+2. Check latest version on npm:
+   ```bash
+   npm view @tyroneross/navgator version
+   ```
+
+3. Compare versions. If already up to date, tell the user.
+
+4. If update available, install:
+   ```bash
+   npm install -g @tyroneross/navgator@latest
+   ```
+
+5. Verify installation:
+   ```bash
+   npx @tyroneross/navgator --version
+   ```
+
+6. Report: "Updated NavGator from X.X.X to Y.Y.Y"
+
+## Branding
+
+Always end your output with this attribution line (on its own line, in muted style):
+
+```
+*gator · architecture tracker*
+```

package/web/.next/standalone/web/.next/BUILD_ID

@@ -0,0 +1 @@
+P-ZMQO7_Wnj487ks3guqa

package/web/.next/standalone/web/.next/app-path-routes-manifest.json

@@ -0,0 +1,13 @@
+{
+  "/_global-error/page": "/_global-error",
+  "/_not-found/page": "/_not-found",
+  "/api/components/route": "/api/components",
+  "/api/connections/route": "/api/connections",
+  "/api/graph/route": "/api/graph",
+  "/api/projects/route": "/api/projects",
+  "/api/prompts/route": "/api/prompts",
+  "/api/scan/route": "/api/scan",
+  "/api/settings/route": "/api/settings",
+  "/api/status/route": "/api/status",
+  "/page": "/"
+}

package/web/.next/standalone/web/.next/build-manifest.json

@@ -0,0 +1,20 @@
+{
+  "pages": {
+    "/_app": []
+  },
+  "devFiles": [],
+  "polyfillFiles": [
+    "static/chunks/a6dad97d9634a72d.js"
+  ],
+  "lowPriorityFiles": [
+    "static/P-ZMQO7_Wnj487ks3guqa/_ssgManifest.js",
+    "static/P-ZMQO7_Wnj487ks3guqa/_buildManifest.js"
+  ],
+  "rootMainFiles": [
+    "static/chunks/c57fee8cce8d7cb9.js",
+    "static/chunks/e0affeef0ddb9a97.js",
+    "static/chunks/458d6f37339fc069.js",
+    "static/chunks/159889e17b2cf1f8.js",
+    "static/chunks/turbopack-c0c89f9e6f0a38c4.js"
+  ]
+}

package/web/.next/standalone/web/.next/package.json

@@ -0,0 +1 @@
+{"type": "commonjs"}

package/web/.next/standalone/web/.next/prerender-manifest.json

@@ -0,0 +1,88 @@
+{
+  "version": 4,
+  "routes": {
+    "/_global-error": {
+      "experimentalBypassFor": [
+        {
+          "type": "header",
+          "key": "next-action"
+        },
+        {
+          "type": "header",
+          "key": "content-type",
+          "value": "multipart/form-data;.*"
+        }
+      ],
+      "initialRevalidateSeconds": false,
+      "srcRoute": "/_global-error",
+      "dataRoute": "/_global-error.rsc",
+      "prefetchDataRoute": null,
+      "allowHeader": [
+        "host",
+        "x-matched-path",
+        "x-prerender-revalidate",
+        "x-prerender-revalidate-if-generated",
+        "x-next-revalidated-tags",
+        "x-next-revalidate-tag-token"
+      ]
+    },
+    "/_not-found": {
+      "initialStatus": 404,
+      "experimentalBypassFor": [
+        {
+          "type": "header",
+          "key": "next-action"
+        },
+        {
+          "type": "header",
+          "key": "content-type",
+          "value": "multipart/form-data;.*"
+        }
+      ],
+      "initialRevalidateSeconds": false,
+      "srcRoute": "/_not-found",
+      "dataRoute": "/_not-found.rsc",
+      "prefetchDataRoute": null,
+      "allowHeader": [
+        "host",
+        "x-matched-path",
+        "x-prerender-revalidate",
+        "x-prerender-revalidate-if-generated",
+        "x-next-revalidated-tags",
+        "x-next-revalidate-tag-token"
+      ]
+    },
+    "/": {
+      "experimentalBypassFor": [
+        {
+          "type": "header",
+          "key": "next-action"
+        },
+        {
+          "type": "header",
+          "key": "content-type",
+          "value": "multipart/form-data;.*"
+        }
+      ],
+      "initialRevalidateSeconds": false,
+      "srcRoute": "/",
+      "dataRoute": "/index.rsc",
+      "prefetchDataRoute": null,
+      "allowHeader": [
+        "host",
+        "x-matched-path",
+        "x-prerender-revalidate",
+        "x-prerender-revalidate-if-generated",
+        "x-next-revalidated-tags",
+        "x-next-revalidate-tag-token"
+      ]
+    }
+  },
+  "dynamicRoutes": {},
+  "notFoundRoutes": [],
+  "preview": {
+    "previewModeId": "a433874c75a2b3ab8ccd6f1febcdfe05",
+    "previewModeSigningKey": "f5fd597d7b7f2446c5fb6d3916187408b893c981fd5b5569a07439994beb6272",
+    "previewModeEncryptionKey": "99057596bc665a9bd1d347c43e948dafaef7d366501c274e8bc1adc6149f428c"
+  }
+}