@reactive-skills/runtime 0.1.0 → 0.1.1

package/README.md

@@ -67,5 +67,5 @@ Dual-mode event sourcing:
 
 ## License
 
-MIT
-
+MIT
+

package/dist/cli/dev.js

@@ -4,15 +4,15 @@ import path from 'node:path';
 const args = process.argv.slice(2);
 const command = args[0];
 function printHelp() {
-    console.log(`
-reactive-skills-dev: Developer CLI for Reactive Skills Architecture
-
-Usage:
-  reactive-skills-dev init <name>         Scaffold new reactive skill in skills/<name>/
-  reactive-skills-dev upgrade <path>      Convert legacy SKILL.md to reactive format
-  reactive-skills-dev inspect <skill>     Print statechart, transitions, and guards
-  reactive-skills-dev migrate [path]      Retroactively migrate project to latest schema
-  reactive-skills-dev sync               Sync skills to all agent config directories
+    console.log(`
+reactive-skills-dev: Developer CLI for Reactive Skills Architecture
+
+Usage:
+  reactive-skills-dev init <name>         Scaffold new reactive skill in skills/<name>/
+  reactive-skills-dev upgrade <path>      Convert legacy SKILL.md to reactive format
+  reactive-skills-dev inspect <skill>     Print statechart, transitions, and guards
+  reactive-skills-dev migrate [path]      Retroactively migrate project to latest schema
+  reactive-skills-dev sync               Sync skills to all agent config directories
   `);
 }
 async function main() {
@@ -53,7 +53,11 @@ async function main() {
     }
     // INSPECT
     if (command === 'inspect') {
-        const skillPath = args[1] && !args[1].startsWith('--') ? args[1] : 'skills/synthesis';
+        const skillPath = args[1] && !args[1].startsWith('--') ? args[1] : '';
+        if (!skillPath) {
+            console.error('Skill path required. Usage: reactive-skills-dev inspect <skill-path>');
+            process.exit(1);
+        }
         const targetDir = path.resolve(process.cwd(), skillPath);
         const { FSMEngine } = await import('../core/fsm-engine.js');
         const engine = new FSMEngine({ skillDir: targetDir });

package/dist/cli/index.js

@@ -8,21 +8,21 @@ const args = process.argv.slice(2);
 const command = args[0];
 const isJson = args.includes('--json');
 function printHelp() {
-    console.log(`
-⚡ reactive-skills: Agent Experience Interface for Reactive Skills
-
-Usage:
-  reactive-skills mcp                 Run the stdio Model Context Protocol (MCP) server
-  reactive-skills install <skill>     Install skill globally and sync
-  reactive-skills migrate [path]      Retroactively migrate project to latest schema
-  reactive-skills state [skill]       Get active state slice and prompt
-  reactive-skills emit <signal>       Emit signal and step state machine
-  reactive-skills query "<sql>"       Query SQLite event store
-  reactive-skills inspect <skill>     Inspect statechart and transitions
-  reactive-skills events [limit]      Tail event store ledger
-  reactive-skills sync                Sync skills across agent platforms
-  reactive-skills init <name>         Scaffold new reactive skill
-  reactive-skills upgrade <path>      Upgrade legacy SKILL.md
+    console.log(`
+⚡ reactive-skills: Agent Experience Interface for Reactive Skills
+
+Usage:
+  reactive-skills mcp                 Run the stdio Model Context Protocol (MCP) server
+  reactive-skills install <skill>     Install skill globally and sync
+  reactive-skills migrate [path]      Retroactively migrate project to latest schema
+  reactive-skills state [skill]       Get active state slice and prompt
+  reactive-skills emit <signal>       Emit signal and step state machine
+  reactive-skills query "<sql>"       Query SQLite event store
+  reactive-skills inspect <skill>     Inspect statechart and transitions
+  reactive-skills events [limit]      Tail event store ledger
+  reactive-skills sync                Sync skills across agent platforms
+  reactive-skills init <name>         Scaffold new reactive skill
+  reactive-skills upgrade <path>      Upgrade legacy SKILL.md
   `);
 }
 async function main() {
@@ -97,7 +97,11 @@ async function main() {
     }
     // 2. GET ACTIVE STATE SLICE
     if (command === 'state') {
-        const skillPath = args[1] && !args[1].startsWith('--') ? args[1] : path.resolve(process.cwd(), 'skills', 'synthesis');
+        const skillPath = args[1] && !args[1].startsWith('--') ? args[1] : '';
+        if (!skillPath) {
+            console.error(JSON.stringify({ error: 'Skill path or name required. Usage: reactive-skills state <skill-path>' }));
+            process.exit(1);
+        }
         const targetDir = path.resolve(process.cwd(), skillPath);
         if (!fs.existsSync(targetDir)) {
             console.error(JSON.stringify({ error: `Skill path not found: ${targetDir}` }));
@@ -120,9 +124,10 @@ async function main() {
     if (command === 'emit') {
         const signalName = args[1];
         if (!signalName) {
-            console.error(JSON.stringify({ error: 'Signal name required. Usage: reactive-skills emit <SIGNAL> [--payload JSON]' }));
+            console.error(JSON.stringify({ error: 'Signal name required. Usage: reactive-skills emit <SIGNAL> [--skill path] [--payload JSON]' }));
             process.exit(1);
         }
+        const skillArg = args[2] && !args[2].startsWith('--') ? args[2] : (args.find(a => a.startsWith('--skill='))?.split('=')[1] || '');
         let payload = {};
         const payloadIdx = args.indexOf('--payload');
         if (payloadIdx !== -1 && args[payloadIdx + 1]) {
@@ -133,8 +138,9 @@ async function main() {
                 payload = { raw: args[payloadIdx + 1] };
             }
         }
-        const skillPath = path.resolve(process.cwd(), 'skills', 'synthesis');
-        const store = new EventStore({ enableSqlite: true, skillId: 'synthesis' });
+        const skillPath = skillArg ? path.resolve(process.cwd(), skillArg) : process.cwd();
+        const skillId = path.basename(skillPath);
+        const store = new EventStore({ enableSqlite: true, skillId });
         const engine = new FSMEngine({ skillDir: skillPath, eventStore: store });
         const result = await engine.handleSignal(signalName, payload);
         console.log(JSON.stringify(result, null, 2));
@@ -159,7 +165,11 @@ async function main() {
     }
     // 5. INSPECT SKILL
     if (command === 'inspect') {
-        const skillPath = args[1] && !args[1].startsWith('--') ? args[1] : 'skills/synthesis';
+        const skillPath = args[1] && !args[1].startsWith('--') ? args[1] : '';
+        if (!skillPath) {
+            console.error(JSON.stringify({ error: 'Skill path required. Usage: reactive-skills inspect <skill-path>' }));
+            process.exit(1);
+        }
         const targetDir = path.resolve(process.cwd(), skillPath);
         const engine = new FSMEngine({ skillDir: targetDir });
         const manifest = engine.getManifest();

package/dist/core/event-store.js

@@ -33,60 +33,60 @@ export class SQLiteStorageDriver {
         this.initTables();
     }
     initTables() {
-        this.db.exec(`
-      CREATE TABLE IF NOT EXISTS events (
-        id TEXT PRIMARY KEY,
-        event_id TEXT,
-        seq INTEGER NOT NULL,
-        timestamp TEXT NOT NULL,
-        occurred_at TEXT,
-        type TEXT NOT NULL,
-        event_type TEXT,
-        state TEXT,
-        source TEXT,
-        causation_id TEXT,
-        correlation_id TEXT,
-        request_id TEXT,
-        trace_parent TEXT,
-        skill_id TEXT,
-        run_id TEXT,
-        parent_run_id TEXT,
-        schema_version TEXT,
-        payload TEXT NOT NULL
-      );
-      CREATE INDEX IF NOT EXISTS idx_events_seq ON events(seq);
-      CREATE INDEX IF NOT EXISTS idx_events_type ON events(type);
-      CREATE INDEX IF NOT EXISTS idx_events_state ON events(state);
-
-      CREATE TABLE IF NOT EXISTS projections (
-        name TEXT PRIMARY KEY,
-        content TEXT NOT NULL,
-        updated_at TEXT NOT NULL
-      );
-
-      CREATE TABLE IF NOT EXISTS state_snapshots (
-        seq INTEGER PRIMARY KEY,
-        state TEXT NOT NULL,
-        context TEXT NOT NULL,
-        created_at TEXT NOT NULL
-      );
-
-      CREATE TABLE IF NOT EXISTS projection_watermarks (
-        name TEXT PRIMARY KEY,
-        event_seq INTEGER NOT NULL,
-        projection_version TEXT NOT NULL,
-        updated_at TEXT NOT NULL
-      );
-      CREATE TABLE IF NOT EXISTS schema_version (
-        version INTEGER PRIMARY KEY,
-        applied_at TEXT NOT NULL
-      );
-      CREATE TABLE IF NOT EXISTS seq_counter (
-        id INTEGER PRIMARY KEY,
-        last_seq INTEGER NOT NULL
-      );
-      INSERT OR IGNORE INTO seq_counter (id, last_seq) VALUES (1, 0);
-      INSERT OR IGNORE INTO schema_version (version, applied_at) VALUES (2, datetime('now'));
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS events (
+        id TEXT PRIMARY KEY,
+        event_id TEXT,
+        seq INTEGER NOT NULL,
+        timestamp TEXT NOT NULL,
+        occurred_at TEXT,
+        type TEXT NOT NULL,
+        event_type TEXT,
+        state TEXT,
+        source TEXT,
+        causation_id TEXT,
+        correlation_id TEXT,
+        request_id TEXT,
+        trace_parent TEXT,
+        skill_id TEXT,
+        run_id TEXT,
+        parent_run_id TEXT,
+        schema_version TEXT,
+        payload TEXT NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_events_seq ON events(seq);
+      CREATE INDEX IF NOT EXISTS idx_events_type ON events(type);
+      CREATE INDEX IF NOT EXISTS idx_events_state ON events(state);
+
+      CREATE TABLE IF NOT EXISTS projections (
+        name TEXT PRIMARY KEY,
+        content TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS state_snapshots (
+        seq INTEGER PRIMARY KEY,
+        state TEXT NOT NULL,
+        context TEXT NOT NULL,
+        created_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS projection_watermarks (
+        name TEXT PRIMARY KEY,
+        event_seq INTEGER NOT NULL,
+        projection_version TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS schema_version (
+        version INTEGER PRIMARY KEY,
+        applied_at TEXT NOT NULL
+      );
+      CREATE TABLE IF NOT EXISTS seq_counter (
+        id INTEGER PRIMARY KEY,
+        last_seq INTEGER NOT NULL
+      );
+      INSERT OR IGNORE INTO seq_counter (id, last_seq) VALUES (1, 0);
+      INSERT OR IGNORE INTO schema_version (version, applied_at) VALUES (2, datetime('now'));
     `);
         this.ensureSchemaVersion();
     }
@@ -125,9 +125,9 @@ export class SQLiteStorageDriver {
         }
     }
     insertEvent(event) {
-        const stmt = this.db.prepare(`
-      INSERT INTO events (id, event_id, seq, timestamp, occurred_at, type, event_type, state, source, causation_id, correlation_id, request_id, trace_parent, skill_id, run_id, parent_run_id, schema_version, payload)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        const stmt = this.db.prepare(`
+      INSERT INTO events (id, event_id, seq, timestamp, occurred_at, type, event_type, state, source, causation_id, correlation_id, request_id, trace_parent, skill_id, run_id, parent_run_id, schema_version, payload)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
     `);
         stmt.run(event.id, event.event_id || event.id, event.seq, event.timestamp, event.occurred_at || event.timestamp, event.type, event.event_type || event.type, event.state || null, event.source || null, event.causation_id || event.causationId || null, event.correlation_id || null, event.request_id || null, event.trace_parent || null, event.skill_id || null, event.run_id || null, event.parent_run_id || null, event.schema_version || null, JSON.stringify(event.payload));
     }
@@ -189,15 +189,15 @@ export class SQLiteStorageDriver {
         return stmt.all(...params);
     }
     saveSnapshot(seq, state, context) {
-        const stmt = this.db.prepare(`
-      INSERT OR REPLACE INTO state_snapshots (seq, state, context, created_at)
-      VALUES (?, ?, ?, ?)
+        const stmt = this.db.prepare(`
+      INSERT OR REPLACE INTO state_snapshots (seq, state, context, created_at)
+      VALUES (?, ?, ?, ?)
     `);
         stmt.run(seq, state, JSON.stringify(context), new Date().toISOString());
     }
     getLatestSnapshot() {
-        const stmt = this.db.prepare(`
-      SELECT * FROM state_snapshots ORDER BY seq DESC LIMIT 1
+        const stmt = this.db.prepare(`
+      SELECT * FROM state_snapshots ORDER BY seq DESC LIMIT 1
     `);
         const row = stmt.get();
         if (!row)
@@ -209,9 +209,9 @@ export class SQLiteStorageDriver {
         };
     }
     saveProjectionWatermark(name, eventSeq, projectionVersion) {
-        const stmt = this.db.prepare(`
-      INSERT OR REPLACE INTO projection_watermarks (name, event_seq, projection_version, updated_at)
-      VALUES (?, ?, ?, ?)
+        const stmt = this.db.prepare(`
+      INSERT OR REPLACE INTO projection_watermarks (name, event_seq, projection_version, updated_at)
+      VALUES (?, ?, ?, ?)
     `);
         stmt.run(name, eventSeq, projectionVersion, new Date().toISOString());
     }
@@ -223,15 +223,15 @@ export class SQLiteStorageDriver {
             : null;
     }
     saveProjection(name, content) {
-        const stmt = this.db.prepare(`
-      INSERT OR REPLACE INTO projections (name, content, updated_at)
-      VALUES (?, ?, ?)
+        const stmt = this.db.prepare(`
+      INSERT OR REPLACE INTO projections (name, content, updated_at)
+      VALUES (?, ?, ?)
     `);
         stmt.run(name, content, new Date().toISOString());
     }
     getProjection(name) {
-        const stmt = this.db.prepare(`
-      SELECT content FROM projections WHERE name = ?
+        const stmt = this.db.prepare(`
+      SELECT content FROM projections WHERE name = ?
     `);
         const row = stmt.get(name);
         return row ? row.content : null;
@@ -270,11 +270,11 @@ export class SQLiteStorageDriver {
         };
     }
     clear() {
-        this.db.exec(`
-      DELETE FROM events;
-      DELETE FROM projections;
-      DELETE FROM state_snapshots;
-      DELETE FROM projection_watermarks;
+        this.db.exec(`
+      DELETE FROM events;
+      DELETE FROM projections;
+      DELETE FROM state_snapshots;
+      DELETE FROM projection_watermarks;
     `);
     }
     /**
@@ -282,12 +282,12 @@ export class SQLiteStorageDriver {
      * clean slate. Used by EventStore.rebuildFromJsonl().
      */
     clearAll() {
-        this.db.exec(`
-      DELETE FROM events;
-      DELETE FROM projections;
-      DELETE FROM state_snapshots;
-      DELETE FROM projection_watermarks;
-      DELETE FROM seq_counter;
+        this.db.exec(`
+      DELETE FROM events;
+      DELETE FROM projections;
+      DELETE FROM state_snapshots;
+      DELETE FROM projection_watermarks;
+      DELETE FROM seq_counter;
     `);
         this.db.exec(`INSERT OR IGNORE INTO seq_counter (id, last_seq) VALUES (1, 0)`);
     }

package/dist/core/fsm-engine.d.ts

@@ -35,6 +35,7 @@ export declare class FSMEngine {
     getActiveStatePath(): string[];
     getContext(): Record<string, any>;
     updateContext(updates: Record<string, any>): void;
+    getSkillDir(): string;
     getEventStore(): EventStore;
     getEventContext(): EventContext;
     isStrictExecution(): boolean;

package/dist/core/fsm-engine.js

@@ -158,6 +158,9 @@ export class FSMEngine {
     updateContext(updates) {
         this.context = { ...this.context, ...updates };
     }
+    getSkillDir() {
+        return this.skillDir;
+    }
     getEventStore() {
         return this.eventStore;
     }

package/dist/core/migration.js

@@ -13,7 +13,7 @@ export class ProjectMigrator {
         if (!fs.existsSync(absDir)) {
             throw new Error(`Target project directory does not exist: ${absDir}`);
         }
-        const docsDir = path.join(absDir, '.docs', 'synthesis');
+        const docsDir = path.join(absDir, '.docs');
         if (!fs.existsSync(docsDir)) {
             fs.mkdirSync(docsDir, { recursive: true });
         }

package/dist/mcp/server.js

@@ -10,7 +10,7 @@ import { EventStore } from '../core/event-store.js';
 import { SkillManifestSchema } from '../core/types.js';
 export function createReactiveMcpServer(options = {}) {
     const workspaceDir = options.workspaceDir || process.cwd();
-    let defaultSkill = options.defaultSkill || 'synthesis';
+    let defaultSkill = options.defaultSkill || 'test-fsm';
     const server = new McpServer({
         name: 'reactive-skills-server',
         version: '1.0.0',
@@ -29,15 +29,45 @@ export function createReactiveMcpServer(options = {}) {
     }
     function getEngine(skillName = defaultSkill) {
         if (engines.has(skillName)) {
-            return engines.get(skillName);
+            const cached = engines.get(skillName);
+            if (fs.existsSync(cached.getSkillDir())) {
+                return cached;
+            }
+            engines.delete(skillName);
         }
         const candidatePaths = [
             path.resolve(workspaceDir, 'skills', skillName),
+            path.resolve(workspaceDir, 'skills', `_${skillName}_skill`),
             path.resolve(workspaceDir, skillName),
+            path.resolve(workspaceDir, '..', 'skills', skillName),
             path.join(os.homedir(), '.agents', 'skills', skillName),
             path.join(os.homedir(), '.gemini', 'config', 'skills', skillName),
+            path.join(os.homedir(), '.kilocode', 'skills', skillName),
         ];
-        const skillDir = candidatePaths.find(p => fs.existsSync(p));
+        let skillDir = candidatePaths.find(p => fs.existsSync(p));
+        if (!skillDir) {
+            const skillsRoot = path.resolve(workspaceDir, 'skills');
+            if (fs.existsSync(skillsRoot)) {
+                for (const entry of fs.readdirSync(skillsRoot, { withFileTypes: true })) {
+                    if (entry.isDirectory()) {
+                        const cand = path.join(skillsRoot, entry.name);
+                        const yamlFile = path.join(cand, 'skill.yaml');
+                        if (fs.existsSync(yamlFile)) {
+                            try {
+                                const parsed = yaml.load(fs.readFileSync(yamlFile, 'utf8'));
+                                if (parsed?.name === skillName) {
+                                    skillDir = cand;
+                                    break;
+                                }
+                            }
+                            catch {
+                                // ignore
+                            }
+                        }
+                    }
+                }
+            }
+        }
         if (!skillDir) {
             throw new Error(`Skill '${skillName}' not found in workspace or global registry.`);
         }
@@ -427,7 +457,6 @@ export function createReactiveMcpServer(options = {}) {
             };
         }
         const docCandidates = [
-            path.resolve(workspaceDir, '.docs', 'synthesis', `${safeName}.md`),
             path.resolve(workspaceDir, '.docs', `${safeName}.md`),
             path.resolve(workspaceDir, `${safeName}.md`),
         ];

package/dist/sync/cli.js

@@ -61,38 +61,38 @@ function parseArgs(args) {
     return result;
 }
 function printHelp() {
-    console.log(`
-reactive-skills sync-engine: Locked mirror/PUT skill synchronization
-
-Usage:
-  reactive-skills sync-engine [source] [targets...] [flags]
-
-Arguments:
-  source                Source skills directory (default: ~/.agents/skills)
-  target                One or more target directories (default: all known satellites)
-
-Flags:
-  --source, -s <dir>    Source skills directory
-  --target, -t <dir>    Add a target directory (repeatable)
-  --skill <name>        Sync a specific skill only
-  --dry-run             Preview changes without writing
-  --mirror              Mirror mode (default, only supported mode): destination
-                        becomes identical to source distributable payload
-  --force               Accepted but no-op (mirror is the only mode)
-  --no-backup           Skip timestamped backup before overwrite
-  --json                Machine-readable JSON output
-  --help, -h            Show this help
-
-Satellites (default targets):
-  ~/.agents/skills
-  ~/.claude/skills
-  ~/.codex/skills
-  ~/.gemini/config/skills
-  ~/.pi/skills
-  ~/.kilocode/skills
-  ~/.copilot/skills
-  ~/.hermes/skills
-  ~/.crew/skills
+    console.log(`
+reactive-skills sync-engine: Locked mirror/PUT skill synchronization
+
+Usage:
+  reactive-skills sync-engine [source] [targets...] [flags]
+
+Arguments:
+  source                Source skills directory (default: ~/.agents/skills)
+  target                One or more target directories (default: all known satellites)
+
+Flags:
+  --source, -s <dir>    Source skills directory
+  --target, -t <dir>    Add a target directory (repeatable)
+  --skill <name>        Sync a specific skill only
+  --dry-run             Preview changes without writing
+  --mirror              Mirror mode (default, only supported mode): destination
+                        becomes identical to source distributable payload
+  --force               Accepted but no-op (mirror is the only mode)
+  --no-backup           Skip timestamped backup before overwrite
+  --json                Machine-readable JSON output
+  --help, -h            Show this help
+
+Satellites (default targets):
+  ~/.agents/skills
+  ~/.claude/skills
+  ~/.codex/skills
+  ~/.gemini/config/skills
+  ~/.pi/skills
+  ~/.kilocode/skills
+  ~/.copilot/skills
+  ~/.hermes/skills
+  ~/.crew/skills
 `);
 }
 function defaultTargets() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reactive-skills/runtime",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Reactive Skills Architecture (RSA) core runtime — FSM engine, event store, guard evaluator, projection engine, MCP server",
   "type": "module",
   "main": "dist/index.js",