npm - @rune-kit/rune - Versions diffs - 2.3.3 → 2.6.0 - Mend

@rune-kit/rune 2.3.3 → 2.6.0

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.

Files changed (77) hide show

package/README.md +86 -17
package/compiler/__tests__/pack-split.test.js +141 -1
package/compiler/__tests__/parser.test.js +147 -55
package/compiler/__tests__/scripts-bundling.test.js +283 -0
package/compiler/__tests__/skill-index.test.js +218 -0
package/compiler/__tests__/tier-override.test.js +41 -0
package/compiler/adapters/antigravity.js +71 -53
package/compiler/adapters/codex.js +4 -0
package/compiler/adapters/cursor.js +4 -0
package/compiler/adapters/generic.js +4 -0
package/compiler/adapters/openclaw.js +4 -0
package/compiler/adapters/opencode.js +4 -0
package/compiler/adapters/windsurf.js +4 -0
package/compiler/bin/rune.js +355 -355
package/compiler/doctor.js +11 -1
package/compiler/emitter.js +678 -386
package/compiler/parser.js +267 -247
package/compiler/transforms/scripts-path.js +18 -0
package/extensions/zalo/PACK.md +20 -1
package/extensions/zalo/references/conversation-management.md +214 -0
package/extensions/zalo/references/eval-scenarios.md +157 -0
package/extensions/zalo/references/listen-mode.md +237 -0
package/extensions/zalo/references/mcp-production.md +274 -0
package/extensions/zalo/references/multi-account-proxy.md +224 -0
package/extensions/zalo/references/vietqr-banking.md +160 -0
package/hooks/hooks.json +12 -0
package/hooks/intent-router/index.cjs +108 -0
package/hooks/pre-tool-guard/index.cjs +177 -68
package/package.json +63 -64
package/skills/brainstorm/SKILL.md +2 -0
package/skills/cook/SKILL.md +661 -648
package/skills/debug/SKILL.md +394 -392
package/skills/deploy/SKILL.md +2 -0
package/skills/fix/SKILL.md +283 -281
package/skills/marketing/SKILL.md +3 -0
package/skills/onboard/SKILL.md +7 -0
package/skills/plan/SKILL.md +344 -342
package/skills/preflight/SKILL.md +362 -360
package/skills/review/SKILL.md +491 -489
package/skills/scout/SKILL.md +1 -0
package/skills/sentinel/SKILL.md +319 -296
package/skills/sentinel/references/auth-crypto-reference.md +192 -0
package/skills/sentinel/references/desktop-security.md +201 -0
package/skills/sentinel/references/supply-chain.md +160 -0
package/skills/session-bridge/SKILL.md +1 -0
package/skills/slides/SKILL.md +142 -0
package/skills/slides/scripts/build-deck.js +158 -0
package/skills/team/SKILL.md +1 -0
package/skills/test/SKILL.md +587 -585
package/skills/verification/SKILL.md +1 -0
package/skills/watchdog/SKILL.md +2 -0
package/docs/ANTIGRAVITY-GAP-ANALYSIS.md +0 -369
package/docs/ARCHITECTURE.md +0 -332
package/docs/COMMUNITY-PACKS.md +0 -109
package/docs/CONTRIBUTING-L4.md +0 -215
package/docs/CROSS-IDE-ANALYSIS.md +0 -164
package/docs/EXTENSION-TEMPLATE.md +0 -126
package/docs/MESH-RULES.md +0 -34
package/docs/MULTI-PLATFORM.md +0 -804
package/docs/SKILL-DEPTH-AUDIT.md +0 -191
package/docs/SKILL-TEMPLATE.md +0 -118
package/docs/TRADE-MATRIX.md +0 -327
package/docs/VERSIONING.md +0 -91
package/docs/VISION.md +0 -263
package/docs/assets/demo-subtitles.srt +0 -215
package/docs/assets/end-card.html +0 -276
package/docs/assets/mesh-diagram.html +0 -654
package/docs/assets/thumbnail.html +0 -295
package/docs/guides/cli.md +0 -403
package/docs/guides/index.html +0 -1450
package/docs/index.html +0 -1005
package/docs/references/claudekit-analysis.md +0 -414
package/docs/references/voltagent-analysis.md +0 -189
package/docs/script.js +0 -495
package/docs/skills/index.html +0 -832
package/docs/style.css +0 -958
package/docs/video-demo-plan.md +0 -172

package/docs/assets/thumbnail.html DELETED Viewed

@@ -1,295 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="UTF-8">
-<title>Rune Demo — YouTube Thumbnail</title>
-<style>
-  @import url('https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@700&family=JetBrains+Mono:wght@700&family=Inter:wght@500;600&display=swap');
-  * { margin: 0; padding: 0; box-sizing: border-box; }
-  body {
-    width: 1280px;
-    height: 720px;
-    overflow: hidden;
-    font-family: 'Inter', sans-serif;
-  }
-  .thumbnail {
-    width: 1280px;
-    height: 720px;
-    background: #0a0e17;
-    position: relative;
-    display: flex;
-  }
-  /* Left side: terminal mockup */
-  .terminal-side {
-    flex: 1;
-    padding: 40px 20px 40px 50px;
-    display: flex;
-    flex-direction: column;
-    justify-content: center;
-    position: relative;
-    z-index: 2;
-  }
-  .terminal {
-    background: #0d1117;
-    border: 1px solid #30363d;
-    border-radius: 12px;
-    overflow: hidden;
-    box-shadow: 0 20px 60px rgba(0,0,0,0.5), 0 0 80px rgba(99,102,241,0.1);
-    max-width: 580px;
-  }
-  .terminal-bar {
-    background: #161b22;
-    padding: 10px 16px;
-    display: flex;
-    align-items: center;
-    gap: 8px;
-  }
-  .terminal-dot {
-    width: 12px;
-    height: 12px;
-    border-radius: 50%;
-  }
-  .terminal-dot.red { background: #ff5f57; }
-  .terminal-dot.yellow { background: #febc2e; }
-  .terminal-dot.green { background: #28c840; }
-  .terminal-title {
-    color: #7d8590;
-    font-size: 12px;
-    margin-left: 8px;
-    font-family: 'Inter', sans-serif;
-  }
-  .terminal-body {
-    padding: 20px 24px;
-    font-family: 'JetBrains Mono', monospace;
-    font-size: 14px;
-    line-height: 1.7;
-  }
-  .prompt {
-    color: #7d8590;
-  }
-  .prompt .path {
-    color: #58a6ff;
-  }
-  .prompt .arrow {
-    color: #3fb950;
-  }
-  .cmd {
-    color: #e6edf3;
-    font-weight: 700;
-  }
-  .cmd .skill {
-    color: #d2a8ff;
-  }
-  .output {
-    color: #7d8590;
-    margin-left: 0;
-    font-size: 12.5px;
-  }
-  .output .success {
-    color: #3fb950;
-  }
-  .output .highlight {
-    color: #ffa657;
-  }
-  .output .skill-name {
-    color: #79c0ff;
-  }
-  .output .phase {
-    color: #d2a8ff;
-  }
-  .line-gap {
-    height: 8px;
-  }
-  /* Right side: text overlay */
-  .text-side {
-    width: 420px;
-    display: flex;
-    flex-direction: column;
-    justify-content: center;
-    align-items: flex-start;
-    padding: 50px 50px 50px 30px;
-    position: relative;
-    z-index: 2;
-  }
-  .badge {
-    background: rgba(239, 68, 68, 0.15);
-    border: 1px solid rgba(239, 68, 68, 0.3);
-    color: #fca5a5;
-    font-size: 13px;
-    font-weight: 600;
-    padding: 6px 14px;
-    border-radius: 6px;
-    margin-bottom: 20px;
-    letter-spacing: 0.5px;
-  }
-  .hero-number {
-    font-family: 'Space Grotesk', sans-serif;
-    font-size: 120px;
-    font-weight: 700;
-    color: #f8fafc;
-    line-height: 0.9;
-    letter-spacing: -4px;
-  }
-  .hero-label {
-    font-family: 'Space Grotesk', sans-serif;
-    font-size: 48px;
-    font-weight: 700;
-    color: #f8fafc;
-    line-height: 1;
-    margin-top: -4px;
-  }
-  .hero-sub {
-    font-size: 18px;
-    color: #94a3b8;
-    margin-top: 16px;
-    line-height: 1.5;
-    font-weight: 500;
-  }
-  .hero-sub .accent {
-    color: #a5b4fc;
-    font-weight: 600;
-  }
-  .tagline {
-    margin-top: 24px;
-    font-size: 14px;
-    color: #64748b;
-    font-style: italic;
-    letter-spacing: 0.5px;
-  }
-  /* Gradient glow behind */
-  .bg-glow {
-    position: absolute;
-    top: 50%;
-    left: 50%;
-    transform: translate(-50%, -50%);
-    width: 800px;
-    height: 600px;
-    background: radial-gradient(ellipse, rgba(99,102,241,0.08) 0%, transparent 60%);
-    z-index: 1;
-    pointer-events: none;
-  }
-  .bg-glow-2 {
-    position: absolute;
-    top: 20%;
-    right: 0;
-    width: 500px;
-    height: 400px;
-    background: radial-gradient(ellipse, rgba(239,68,68,0.06) 0%, transparent 60%);
-    z-index: 1;
-    pointer-events: none;
-  }
-  /* Logo corner */
-  .logo {
-    position: absolute;
-    bottom: 30px;
-    right: 40px;
-    display: flex;
-    align-items: center;
-    gap: 10px;
-    z-index: 3;
-  }
-  .logo-icon {
-    width: 32px;
-    height: 32px;
-    background: linear-gradient(135deg, #ef4444, #6366f1);
-    border-radius: 8px;
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    color: white;
-    font-family: 'Space Grotesk', sans-serif;
-    font-weight: 700;
-    font-size: 16px;
-  }
-  .logo-text {
-    font-family: 'Space Grotesk', sans-serif;
-    font-size: 20px;
-    font-weight: 700;
-    color: #e2e8f0;
-    letter-spacing: -0.5px;
-  }
-</style>
-</head>
-<body>
-<div class="thumbnail">
-  <div class="bg-glow"></div>
-  <div class="bg-glow-2"></div>
-  <!-- Left: Terminal -->
-  <div class="terminal-side">
-    <div class="terminal">
-      <div class="terminal-bar">
-        <div class="terminal-dot red"></div>
-        <div class="terminal-dot yellow"></div>
-        <div class="terminal-dot green"></div>
-        <span class="terminal-title">~/my-saas-app</span>
-      </div>
-      <div class="terminal-body">
-        <div><span class="prompt"><span class="path">~/app</span> <span class="arrow">$</span></span> <span class="cmd">/rune <span class="skill">cook</span> "add Stripe billing"</span></div>
-        <div class="line-gap"></div>
-        <div class="output"><span class="phase">[Phase 1]</span> <span class="skill-name">scout</span> scanning codebase...</div>
-        <div class="output"><span class="phase">[Phase 2]</span> <span class="skill-name">plan</span> creating implementation steps</div>
-        <div class="output"><span class="phase">[Phase 3]</span> <span class="highlight">adversary</span> red-teaming plan...</div>
-        <div class="output">  <span style="color:#ff7b72">! Missing webhook signature check</span></div>
-        <div class="output"><span class="phase">[Phase 4]</span> <span class="skill-name">test</span> writing failing tests (TDD)</div>
-        <div class="output"><span class="phase">[Phase 5]</span> <span class="skill-name">fix</span> implementing code...</div>
-        <div class="output"><span class="phase">[Phase 6]</span> <span class="skill-name">sentinel</span> + <span class="skill-name">review</span> + <span class="skill-name">preflight</span></div>
-        <div class="output"><span class="success">&#10004; All 8 phases complete. Ready to ship.</span></div>
-      </div>
-    </div>
-  </div>
-  <!-- Right: Text -->
-  <div class="text-side">
-    <div class="badge">OPEN SOURCE &bull; MIT</div>
-    <div class="hero-number">57</div>
-    <div class="hero-label">Skills</div>
-    <div class="hero-sub">
-      Turn your AI assistant from a <span class="accent">chatbot</span> into an <span class="accent">engineering team</span>
-    </div>
-    <div class="tagline">"Less skills. Deeper connections."</div>
-  </div>
-  <!-- Logo -->
-  <div class="logo">
-    <div class="logo-icon">R</div>
-    <span class="logo-text">Rune</span>
-  </div>
-</div>
-</body>
-</html>

package/docs/guides/cli.md DELETED Viewed

@@ -1,403 +0,0 @@
-# Rune CLI
-The Rune CLI compiles 55 AI coding skills into any IDE platform. One skill mesh, every editor.
----
-## Quick Start
-**Step 1** -- Install and initialize in your project:
-```bash
-cd your-project
-npx @rune-kit/rune init
-```
-Rune auto-detects your platform (Cursor, Windsurf, Antigravity) and compiles skills into the correct format.
-**Step 2** -- Start your AI assistant:
-```bash
-# Cursor / Windsurf / Antigravity / Generic
-# Open your editor -- skills are loaded automatically from the rules directory.
-# Claude Code -- no compilation needed, Rune runs as a native plugin:
-claude
-```
-**Step 3** -- Verify the setup:
-```bash
-npx @rune-kit/rune doctor
-```
-That's it. 55 skills are now active in your AI assistant.
-> **Pro Tip**: For Claude Code, skip the CLI entirely. Install Rune as a plugin:
-> `claude plugin add rune-kit/rune` -- skills load natively with zero compilation.
----
-## Commands
-### `rune init`
-Interactive setup. Detects your platform, creates `rune.config.json`, and compiles all skills in one step.
-```bash
-npx @rune-kit/rune init
-```
-```
-  +----------------------------------------------+
-  |  Rune -- Less skills. Deeper connections.      |
-  +----------------------------------------------+
-  -> Detected: cursor
-  -> Created rune.config.json
-  -> Built 55 skills + 12 extensions to .cursor/rules/
-```
-**Flags**:
-| Flag | Description | Example |
-|------|-------------|---------|
-| `--platform <name>` | Override auto-detection | `rune init --platform windsurf` |
-| `--extensions <list>` | Enable specific extension packs | `rune init --extensions @rune/ui,@rune/backend` |
-| `--disable <skills>` | Disable specific skills | `rune init --disable video-creator,asset-creator` |
-If Claude Code is detected (`.claude-plugin/` exists), init exits early with a message -- no compilation needed.
----
-### `rune build`
-Recompile skills using existing config. Run after updating Rune or changing `rune.config.json`.
-```bash
-npx @rune-kit/rune build
-```
-```
-  [parse]     Discovering skills...
-  [transform] Platform: cursor
-  [transform] Resolved 142 cross-references
-  [transform] Resolved 87 tool-name references
-  [emit]      55 skills + 12 extensions
-  -> Built 67 files to .cursor/rules/
-```
-**Flags**:
-| Flag | Description | Example |
-|------|-------------|---------|
-| `--platform <name>` | Override config platform | `rune build --platform windsurf` |
-| `--output <dir>` | Override output directory | `rune build --output ../other-project` |
-| `--disable <skills>` | Disable specific skills | `rune build --disable trend-scout` |
-> **Pro Tip**: Use `--output` to compile Rune into multiple projects from a single source.
----
-### `rune doctor`
-Validate compiled output. Checks that all skill files exist, cross-references resolve, and config is valid.
-```bash
-npx @rune-kit/rune doctor
-```
-Exits with code 0 if healthy, code 1 if issues found. Useful in CI pipelines.
-**Flags**:
-| Flag | Description |
-|------|-------------|
-| `--platform <name>` | Override config platform |
----
-### `rune help`
-Show available commands and flags.
-```bash
-npx @rune-kit/rune help
-```
----
-## Platforms
-Rune compiles to 5 platforms. Each gets skills in its native format.
-| Platform | Output Directory | File Format | Detection Marker |
-|----------|-----------------|-------------|------------------|
-| Claude Code | _(native plugin)_ | `.md` (SKILL.md) | `.claude-plugin/` |
-| Cursor | `.cursor/rules/` | `.mdc` | `.cursor/` |
-| Windsurf | `.windsurf/rules/` | `.md` | `.windsurf/` |
-| Antigravity | `.agent/rules/` | `.md` | `.agent/` |
-| Generic | `.ai/rules/` | `.md` | _(fallback)_ |
-| OpenClaw | `.openclaw/rune/` | `.md` + manifest | `.openclaw/` |
-### Claude Code
-Rune is a native Claude Code plugin. No compilation needed.
-```bash
-# Install as plugin (recommended)
-claude plugin add rune-kit/rune
-# Or use Rune as a local plugin during development
-claude --plugin-dir /path/to/rune
-```
-Skills load directly from `skills/*/SKILL.md`. The CLI detects `.claude-plugin/` and skips compilation:
-```
-  -> Claude Code detected -- Rune works as a native plugin. No compilation needed.
-```
-### Cursor
-Skills compile to `.cursor/rules/*.mdc` (Cursor's rule format).
-```bash
-npx @rune-kit/rune init --platform cursor
-```
-Output: `.cursor/rules/rune-cook.mdc`, `.cursor/rules/rune-plan.mdc`, etc.
-Each skill file gets a Cursor-compatible header with `alwaysApply: false` frontmatter. Cross-references between skills are rewritten to `rune-<skill-name>` format.
-### Windsurf
-Skills compile to `.windsurf/rules/*.md`.
-```bash
-npx @rune-kit/rune init --platform windsurf
-```
-Output: `.windsurf/rules/rune-cook.md`, `.windsurf/rules/rune-plan.md`, etc.
-### Antigravity
-Skills compile to `.agent/rules/*.md` (Google Antigravity format).
-```bash
-npx @rune-kit/rune init --platform antigravity
-```
-Output: `.agent/rules/rune-cook.md`, `.agent/rules/rune-plan.md`, etc.
-### Generic
-Fallback for any AI IDE that reads markdown rules from a directory.
-```bash
-npx @rune-kit/rune init --platform generic
-```
-Output: `.ai/rules/rune-cook.md`, `.ai/rules/rune-plan.md`, etc.
-### OpenClaw
-Skills compile to an OpenClaw plugin structure with manifest, TypeScript entry point, and skill files.
-```bash
-npx @rune-kit/rune init --platform openclaw
-```
-Output structure:
-```
-.openclaw/rune/
-  openclaw.plugin.json       # Plugin manifest
-  src/index.ts               # register(api) entry point
-  skills/                    # Compiled skill files
-    rune-cook.md
-    rune-plan.md
-    rune-skill-router.md
-    ...
-```
-After building, add Rune to your OpenClaw config (`openclaw.json`):
-```json
-{
-  "plugins": {
-    "load": {
-      "paths": ["./.openclaw/rune"]
-    },
-    "entries": {
-      "rune": {
-        "enabled": true
-      }
-    }
-  }
-}
-```
-The generated `src/index.ts` registers a `before_agent_start` hook that injects the skill-router instructions, so OpenClaw routes tasks through Rune skills automatically.
-> **Pro Tip**: If you also use the NeuralMemory plugin, Rune coexists with it --
-> NeuralMemory occupies the `memory` slot while Rune occupies `skills`.
----
-## Auto-Detection
-When you run `rune init` without `--platform`, Rune checks for these markers in order:
-| Priority | Marker | Platform |
-|----------|--------|----------|
-| 1 | `.claude-plugin/` | Claude Code (exits early) |
-| 2 | `.cursor/` | Cursor |
-| 3 | `.windsurf/` | Windsurf |
-| 4 | `.agent/` | Antigravity |
-| 5 | _(none found)_ | Prompts for selection |
-If no marker is found, Rune shows the available platforms and asks you to choose. Unknown input defaults to `generic`.
----
-## Configuration
-`rune init` creates a `rune.config.json` in your project root:
-```json
-{
-  "$schema": "https://rune-kit.github.io/rune/config-schema.json",
-  "version": 1,
-  "platform": "cursor",
-  "source": "/path/to/rune",
-  "skills": {
-    "disabled": []
-  },
-  "extensions": {
-    "enabled": null
-  },
-  "output": {
-    "index": true
-  }
-}
-```
-| Field | Type | Description |
-|-------|------|-------------|
-| `platform` | string | Target platform (cursor, windsurf, antigravity, generic) |
-| `source` | string | Path to Rune installation (auto-set by init) |
-| `skills.disabled` | string[] | Skills to exclude from compilation |
-| `extensions.enabled` | string[] or null | Extension packs to include (`null` = all) |
-| `output.index` | boolean | Generate index file listing all compiled skills |
-Edit this file directly, then run `rune build` to recompile.
-> **Pro Tip**: Commit `rune.config.json` to your repo so teammates get the same skill configuration.
----
-## Extension Packs
-Rune ships 12 free extension packs (L4 layer). Each adds domain-specific skills.
-| Pack | Skills | Domain |
-|------|--------|--------|
-| `@rune/ui` | 5 | UI component patterns, design systems |
-| `@rune/backend` | 5 | API design, database patterns, auth |
-| `@rune/devops` | 7 | CI/CD, Docker, Kubernetes, chaos testing |
-| `@rune/mobile` | 5 | React Native, Flutter, mobile UX |
-| `@rune/security` | 5 | OWASP, pen testing, threat modeling |
-| `@rune/trading` | 7 | Backtesting, quant analysis, market data |
-| `@rune/saas` | 5 | Multi-tenancy, billing, onboarding |
-| `@rune/ecommerce` | 5 | Cart, checkout, inventory, payments |
-| `@rune/ai-ml` | 6 | LLM architecture, prompt patterns, ML ops |
-| `@rune/gamedev` | 5 | Game loops, ECS, physics, assets |
-| `@rune/content` | 5 | CMS, SEO, content pipelines |
-| `@rune/analytics` | 5 | SQL patterns, data validation, dashboards |
-**Enable specific packs**:
-```bash
-npx @rune-kit/rune init --extensions @rune/ui,@rune/backend,@rune/trading
-```
-**Enable all packs** (default):
-```bash
-npx @rune-kit/rune init
-# extensions.enabled = null means all packs are included
-```
-**Disable via config**:
-```json
-{
-  "extensions": {
-    "enabled": ["@rune/ui", "@rune/backend"]
-  }
-}
-```
----
-## Pro Tips
-**CI Integration** -- Add Rune build to your CI pipeline to keep skills in sync:
-```yaml
-# .github/workflows/rune.yml
-- name: Compile Rune skills
-  run: npx @rune-kit/rune build
-- name: Validate output
-  run: npx @rune-kit/rune doctor
-```
-**Monorepo Setup** -- Compile to multiple packages from one Rune source:
-```bash
-npx @rune-kit/rune build --output packages/frontend --platform cursor
-npx @rune-kit/rune build --output packages/backend --platform generic
-```
-**Selective Skills** -- Disable skills you don't need to reduce noise:
-```bash
-npx @rune-kit/rune init --disable video-creator,asset-creator,trend-scout
-```
-**Keep Updated** -- Pull latest skills and recompile:
-```bash
-cd /path/to/rune && git pull
-cd /your/project && npx @rune-kit/rune build
-```
----
-## Troubleshooting
-**"No platform configured"** when running `rune build`:
-- Run `rune init` first to create `rune.config.json`.
-**"Unknown platform"** during init:
-- Check available platforms: `cursor`, `windsurf`, `antigravity`, `generic`.
-- Claude Code users don't need the CLI -- install as a plugin instead.
-**Skills not loading in Cursor**:
-- Verify files exist in `.cursor/rules/`.
-- Check that files have `.mdc` extension.
-- Restart Cursor to pick up new rule files.
-**Skills not loading in Windsurf / Antigravity**:
-- Verify files exist in the correct rules directory.
-- Check that your editor version supports the rules feature.
-**"No rune.config.json found"** when running `rune doctor`:
-- Run `rune init` to generate the config file.
-**Build errors on specific skills**:
-- Check the error output for the skill name and issue.
-- Use `--disable <skill>` to skip problematic skills temporarily.
-- Report issues at https://github.com/rune-kit/rune/issues.