@reactive-skills/runtime 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -1,4 +1,12 @@
 
+## [0.4.1] - 2026-09-14
+
+- feat(runtime,axi): add mcp job tools, template jobId context, and flexible jobs cli arguments (2b31451)
+- feat(mcp): add reactive_switch_job and reactive_archive_job tools with active job indicators
+- feat(projections): expose jobId directly in ProjectionContext for Handlebars templates
+- feat(axi): support bidirectional argument ordering in jobs command (jobs list <skill> and jobs <skill> list)
+- docs: introduce PERFORMANCE-STANDARDS.md for P0-P3 latency budgets, caching tiers, and CRAP score limits
+
 ## [0.4.0] - 2026-09-14
 
 - feat(axi): implement native validate command for skill manifest and statechart verification (3b75a21)

package/README.md

@@ -2,7 +2,7 @@
 
 Reactive Skills Architecture (RSA) core runtime — FSM engine, event store, guard evaluator, projection engine, job manager, and MCP server.
 
-> 🚀 **What's New in v0.4.0:** Native `validate` command in AXI, first-class Job & Run Management, isolated event logs, and dual-write deliverable mirroring. [Read Full Release Notes →](https://github.com/Reactive-Skills/reactive-skills/releases/tag/v0.4.0) · [View Changelog](https://github.com/Reactive-Skills/reactive-skills/blob/main/CHANGELOG.md)
+> 🚀 **What's New in v0.4.1:** MCP job management tools (`reactive_switch_job`, `reactive_archive_job`), template-level `jobId` context, and `PERFORMANCE-STANDARDS.md`. [Read Full Release Notes →](https://github.com/Reactive-Skills/reactive-skills/releases/tag/v0.4.1) · [View Changelog](https://github.com/Reactive-Skills/reactive-skills/blob/main/CHANGELOG.md)
 
 ## Installation
 

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

@@ -3,6 +3,7 @@ import { EventStore } from './event-store.js';
 export interface ProjectionContext {
     skillName: string;
     currentState: string;
+    jobId?: string;
     context: Record<string, any>;
     events: SignalEvent[];
     transitions: {

package/dist/core/projection-engine.js

@@ -125,6 +125,7 @@ export class ProjectionEngine {
         const projContext = {
             skillName,
             currentState,
+            jobId: this.jobId,
             context,
             events,
             transitions,

package/dist/mcp/server.js

@@ -455,7 +455,10 @@ export function createReactiveMcpServer(options = {}) {
             const targetSkill = skill || defaultSkill;
             const jobManager = new JobManager(workspaceDir);
             const activeJobId = jobManager.getActiveJobId(targetSkill);
-            const jobs = jobManager.listJobs(targetSkill);
+            const jobs = jobManager.listJobs(targetSkill).map(j => ({
+                ...j,
+                isActive: j.id === activeJobId,
+            }));
             return {
                 content: [
                     {
@@ -476,6 +479,106 @@ export function createReactiveMcpServer(options = {}) {
             };
         }
     });
+    // 10. TOOL: reactive_switch_job
+    server.tool('reactive_switch_job', 'Switch the active execution job pointer for a reactive skill and synchronize deliverables', {
+        skill: z.string().optional().describe('Name of the reactive skill (defaults to active skill)'),
+        job_id: z.string().describe('Target job ID to set as active'),
+    }, async ({ skill, job_id }) => {
+        try {
+            const skillName = skill || defaultSkill;
+            const jobManager = new JobManager(workspaceDir);
+            const job = jobManager.getJob(skillName, job_id);
+            if (!job) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: `Job '${job_id}' not found for skill '${skillName}'` }) }],
+                    isError: true,
+                };
+            }
+            jobManager.setActiveJobId(skillName, job_id);
+            // Re-mirror deliverables: copy archive deliverables to root if they exist
+            const docsDir = path.join(workspaceDir, '.docs', skillName);
+            const archiveDir = path.join(docsDir, 'jobs', job_id);
+            let mirroredCount = 0;
+            if (fs.existsSync(archiveDir)) {
+                const files = fs.readdirSync(archiveDir);
+                for (const file of files) {
+                    const src = path.join(archiveDir, file);
+                    if (fs.statSync(src).isFile()) {
+                        const dest = path.join(docsDir, file);
+                        fs.copyFileSync(src, dest);
+                        mirroredCount++;
+                    }
+                }
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            skill: skillName,
+                            activeJobId: job_id,
+                            status: job.status,
+                            currentState: job.currentState,
+                            mirroredDeliverables: mirroredCount,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: err.message }) }],
+                isError: true,
+            };
+        }
+    });
+    // 11. TOOL: reactive_archive_job
+    server.tool('reactive_archive_job', 'Archive an execution job for a reactive skill and rotate active pointer if archived was active', {
+        skill: z.string().optional().describe('Name of the reactive skill (defaults to active skill)'),
+        job_id: z.string().optional().describe('Job ID to archive (defaults to active job)'),
+    }, async ({ skill, job_id }) => {
+        try {
+            const skillName = skill || defaultSkill;
+            const jobManager = new JobManager(workspaceDir);
+            const targetId = job_id || jobManager.getActiveJobId(skillName);
+            const currentActive = jobManager.getActiveJobId(skillName);
+            const job = jobManager.getJob(skillName, targetId);
+            if (!job) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: `Job '${targetId}' not found for skill '${skillName}'` }) }],
+                    isError: true,
+                };
+            }
+            jobManager.updateJob(skillName, targetId, {
+                status: 'archived',
+                completedAt: new Date().toISOString(),
+            });
+            let freshJobId = currentActive;
+            if (currentActive === targetId) {
+                const freshJob = jobManager.createJob(skillName, { setActive: true });
+                freshJobId = freshJob.id;
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            skill: skillName,
+                            archivedJobId: targetId,
+                            status: 'archived',
+                            activeJobId: freshJobId,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: err.message }) }],
+                isError: true,
+            };
+        }
+    });
     // RESOURCE 1: reactive://events
     server.resource('reactive-events', 'reactive://events', async (uri) => {
         const store = new EventStore({ enableSqlite: true });

package/package.json

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