@symerian/symi 2.6.18 → 2.6.19

package/skills/self-inspect/SKILL.md

@@ -1,109 +0,0 @@
----
-name: self-inspect
-description: "Find and inspect Symi's own source code, installation files, and configuration. Use when: (1) user asks about 'your code', 'your source', 'your files', 'your installation', (2) user wants to modify Glass UI styles/CSS/HTML, (3) user asks 'where is your code?', 'can you see your source?', (4) user asks about Symi internals, architecture, or file layout, (5) user wants to customize the web dashboard appearance. Gives Symi awareness of its own installation directory and key file locations."
-metadata: { "symi": { "emoji": "🔍" } }
----
-
-# Self-Inspect — Find Your Own Source Code
-
-You ARE Symi. This skill tells you exactly where your files are and how to access them.
-
-## CRITICAL RULE: Use `read`, NOT `exec`
-
-**NEVER use exec with find, grep, ls, or cat to explore your own files.**
-**ALWAYS use the `read` tool directly on the exact paths listed below.**
-
-Exec commands are unreliable — use your built-in read tool which works perfectly every time.
-
-## Step 1: Find Your Installation Path
-
-Run this ONE command to get your root path:
-
-```bash
-node -e "console.log(require.resolve('@symerian/symi/package.json').replace('/package.json', ''))"
-```
-
-Store the result as `SYMI_ROOT`. All paths below are relative to this.
-
-## Step 2: Exact File Paths
-
-Once you have `SYMI_ROOT`, these are your files. **Use `read` on these paths directly.**
-
-### Glass UI (Web Dashboard)
-
-| File      | Path                                        | What It Contains                                     |
-| --------- | ------------------------------------------- | ---------------------------------------------------- |
-| HTML      | `SYMI_ROOT/dist/control-ui/index.html`      | Page structure, Agent Status Orb SVG, panels         |
-| CSS       | `SYMI_ROOT/dist/control-ui/css/style.css`   | ALL styling — themes, colors, orb animations, layout |
-| Main JS   | `SYMI_ROOT/dist/control-ui/js/app.js`       | State machine, streaming, event handling, watchdog   |
-| WebSocket | `SYMI_ROOT/dist/control-ui/js/gateway.js`   | WebSocket client, RPC, profile events                |
-| Rendering | `SYMI_ROOT/dist/control-ui/js/render.js`    | Message rendering, markdown, code blocks             |
-| Models    | `SYMI_ROOT/dist/control-ui/js/models.js`    | Model toggle (Local/CoreWeave/API)                   |
-| Heartbeat | `SYMI_ROOT/dist/control-ui/js/symipulse.js` | Heartbeat panel                                      |
-| History   | `SYMI_ROOT/dist/control-ui/js/history.js`   | Session history drawer                               |
-| Debug     | `SYMI_ROOT/dist/control-ui/js/debug.js`     | Debug panel (Shift+D)                                |
-
-### Config and Data
-
-| What          | Exact Path                                   |
-| ------------- | -------------------------------------------- |
-| Config        | `~/.symi/symi.json`                          |
-| Workspace     | `~/.symi/workspace/`                         |
-| Sessions      | `~/.symi/agents/main/sessions/`              |
-| Session store | `~/.symi/agents/main/sessions/sessions.json` |
-| Memory DB     | `~/.symi/state/memory/`                      |
-| User skills   | `~/.symi/workspace/skills/`                  |
-| Package info  | `SYMI_ROOT/package.json`                     |
-
-## Step 3: How to Do Common Tasks
-
-### View any file
-
-```
-Use: read tool with the exact path
-Do NOT use: exec cat, exec head, exec find, exec grep
-```
-
-### Modify Glass UI Theme/Colors
-
-1. **Read** the CSS: `read SYMI_ROOT/dist/control-ui/css/style.css`
-2. **Back up**: `exec cp SYMI_ROOT/dist/control-ui/css/style.css SYMI_ROOT/dist/control-ui/css/style.css.bak`
-3. **Edit** with the edit tool — use `edit` to replace specific color values
-4. Tell the user to refresh their browser
-
-### Modify Glass UI Behavior
-
-1. **Read** the JS file you need (see table above)
-2. **Back up**: `exec cp <file> <file>.bak`
-3. **Edit** with the edit tool
-4. Tell the user to refresh their browser
-
-### Read Your Version
-
-```
-read SYMI_ROOT/package.json
-```
-
-Look for the `"version"` field.
-
-### Read Your Configuration
-
-```
-read ~/.symi/symi.json
-```
-
-### Browse Session History
-
-```
-read ~/.symi/agents/main/sessions/sessions.json
-```
-
-## Important Rules
-
-- **ALWAYS use `read` to view files** — never exec cat/head/find/grep
-- **ALWAYS use `edit` to modify files** — never exec sed/awk
-- **Always back up before modifying** any file in `dist/`
-- Changes to `dist/` files are overwritten on upgrade (`npm install -g @symerian/symi`)
-- **CSS changes are safe** — `style.css` is not minified, easy to edit
-- **JavaScript changes are riskier** — syntax errors break the UI
-- For permanent changes that survive upgrades, the user should modify the source repo and rebuild