specrails-desktop 2.57.1 → 2.58.0

package/server/dist/project-router-spending.js

@@ -9,6 +9,7 @@ const workspace_resolution_1 = require("./workspace-resolution");
 const ai_invocations_1 = require("./modules/accounting/runtime/ai-invocations");
 const spending_1 = require("./modules/accounting/runtime/spending");
 const ticket_store_1 = require("./modules/specs/runtime/ticket-store");
+const legacy_launch_telemetry_1 = require("./modules/loops/runtime/legacy-launch-telemetry");
 /**
  * Parse + clamp a `tzOffsetMinutes` query param (minutes east of UTC, the value
  * `Date.prototype.getTimezoneOffset()` negates). Non-numeric / out-of-range
@@ -39,6 +40,22 @@ function localDayBoundsUtc(tzOffsetMinutes, now = Date.now()) {
 }
 function registerSpendingRoutes(deps) {
     const { router, registry, ctx, ticketPath } = deps;
+    router.get('/:projectId/analytics/legacy-launches', (req, res) => {
+        if (req.query.since !== undefined && typeof req.query.since !== 'string') {
+            res.status(400).json({ error: 'invalid_since' });
+            return;
+        }
+        try {
+            res.json({ ...(0, legacy_launch_telemetry_1.readLegacyLaunchSummary)(ctx(req).db, req.query.since), retirementEvidence: 'not-evaluated' });
+        }
+        catch (error) {
+            if (error instanceof RangeError) {
+                res.status(400).json({ error: 'invalid_since' });
+                return;
+            }
+            res.status(503).json({ error: 'legacy_telemetry_unavailable' });
+        }
+    });
     // Build a YAML-store-backed title resolver for getSpending's 4th arg
     // (BUG-ANALYTICS-18/36). Without it, topTickets keeps ticketTitle:null and the
     // client mislabels every live ticket "Deleted ticket #N". Returns undefined

package/server/dist/project-router.js

@@ -262,9 +262,11 @@ function createProjectRouter(registry) {
         res.json({ blueprint: snapshot.blueprint, progress: snapshot.progress });
     });
     // Milestone launch chain (premium-milestone-progress D3): "Launch Milestone
-    // N" is server-owned — chunked into ≤3-spec rails, launched through the
-    // ordinary rails launch route, and (sequential) chained on each chunk's
-    // delivered branch. The client keeps NO plan in browser storage.
+    // N" is server-owned — one spec per rail in dependency order, launched
+    // through the ordinary rails launch route and chained on each spec's
+    // delivered branch. Always sequential: the retired `mode: 'parallel'` is
+    // accepted for old clients and runs sequentially (the response echoes
+    // `mode: 'sequential'`). `autoAdvance` defaults to true.
     router.post('/:projectId/blueprint/milestones/:n/launch', async (req, res) => {
         const projectCtx = ctx(req);
         const n = Number.parseInt(String(req.params.n), 10);
@@ -274,7 +276,7 @@ function createProjectRouter(registry) {
         }
         const rawMode = (req.body ?? {}).mode;
         if (rawMode !== undefined && rawMode !== 'sequential' && rawMode !== 'parallel') {
-            res.status(400).json({ error: "mode must be 'sequential' or 'parallel'" });
+            res.status(400).json({ error: "mode must be 'sequential'" });
             return;
         }
         const rawAuto = (req.body ?? {}).autoAdvance;
@@ -288,9 +290,9 @@ function createProjectRouter(registry) {
             return;
         }
         try {
-            const result = await chains.start(n, rawMode ?? 'sequential', { autoAdvance: rawAuto });
+            const result = await chains.start(n, { autoAdvance: rawAuto });
             if (result.ok) {
-                res.status(202).json({ chainId: result.chainId, launched: result.launched, pending: result.pending });
+                res.status(202).json({ chainId: result.chainId, mode: 'sequential', launched: result.launched, pending: result.pending });
             }
             else {
                 res.status(result.status).json({ error: result.error, ...(result.detail ? { detail: result.detail } : {}), ...(result.chainId ? { chainId: result.chainId } : {}) });

package/server/dist/schemas/agent-runtime.schema.json

@@ -13,7 +13,7 @@
       "verification": { "type": "object", "additionalProperties": false, "properties": { "maxConcurrency": { "type": "integer", "minimum": 1, "maximum": 4 } } }
     } },
     "guardrails": { "type": "object", "additionalProperties": false, "properties": { "plan-validation": { "type": "boolean" }, "genuine-blocking-question": { "type": "boolean" }, "plan-language-hint": { "type": "boolean" }, "frozen-plan-writes": { "type": "boolean" }, "primary-language": { "type": "boolean" }, "duplicate-sibling": { "type": "boolean" }, "one-test-per-module": { "type": "boolean" }, "empty-write": { "type": "boolean" }, "evidence-gated-ticking": { "type": "boolean" }, "inventory-retry": { "type": "boolean" }, "synthetic-corrections": { "type": "boolean" }, "silent-group-closure": { "type": "boolean" }, "verify-per-group": { "type": "boolean" }, "test-reachability": { "type": "boolean" }, "exit-code-honesty": { "type": "boolean" }, "environment-repair": { "type": "boolean" }, "lockfile-repair": { "type": "boolean" }, "verify-idle-timeout": { "type": "boolean" } } },
-    "rolePrompts": { "type": "object", "additionalProperties": false, "properties": {
+    "rolePrompts": { "type": "object", "propertyNames": { "pattern": "^[a-z][a-z0-9-]{0,63}$" }, "additionalProperties": { "type": "string", "minLength": 1, "maxLength": 20000, "pattern": "\\S" }, "properties": {
       "architect": { "type": "string", "minLength": 1, "maxLength": 20000, "pattern": "\\S" },
       "developer": { "type": "string", "minLength": 1, "maxLength": 20000, "pattern": "\\S" },
       "reviewer": { "type": "string", "minLength": 1, "maxLength": 20000, "pattern": "\\S" },
@@ -35,6 +35,98 @@
       } }
     ] } },
     "fixer": { "$ref": "#/definitions/agent" },
+    "roles": {
+      "type": "object",
+      "propertyNames": {
+        "pattern": "^[a-z][a-z0-9-]{0,63}$",
+        "not": {
+          "const": "fixer"
+        }
+      },
+      "additionalProperties": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "provider",
+          "access",
+          "artifacts"
+        ],
+        "dependencies": {
+          "escalation": [
+            "model"
+          ]
+        },
+        "properties": {
+          "effort": {
+            "$ref": "#/definitions/effort"
+          },
+          "thinking": {
+            "type": "string",
+            "enum": [
+              "on",
+              "off"
+            ],
+            "description": "OpenAI-compatible engines only: private thinking (chat_template_kwargs.enable_thinking). Default off."
+          },
+          "escalation": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "model"
+            ],
+            "properties": {
+              "model": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 256,
+                "pattern": "^[^-\\r\\n\\u0000][^\\r\\n\\u0000]*$"
+              },
+              "effort": {
+                "$ref": "#/definitions/effort"
+              }
+            }
+          },
+          "provider": {
+            "$ref": "#/definitions/id"
+          },
+          "model": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256,
+            "pattern": "^[^-\\r\\n\\u0000][^\\r\\n\\u0000]*$"
+          },
+          "maxTurns": {
+            "$ref": "#/definitions/positiveInteger"
+          },
+          "access": {
+            "enum": [
+              "read",
+              "write"
+            ]
+          },
+          "artifacts": {
+            "enum": [
+              "none",
+              "tasks-checkboxes",
+              "all"
+            ]
+          },
+          "prompt": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 20000,
+            "pattern": "\\S"
+          },
+          "openspecSkill": {
+            "enum": [
+              "openspec-ff-change",
+              "openspec-apply-change",
+              "openspec-verify-change"
+            ]
+          }
+        }
+      }
+    },
     "agents": { "type": "object", "additionalProperties": false, "required": ["architect", "developer", "reviewer"], "properties": {
       "architect": { "$ref": "#/definitions/agent" }, "developer": { "$ref": "#/definitions/agent" }, "reviewer": { "$ref": "#/definitions/agent" }
     } },

package/server/dist/schemas/workflow-definition.schema.json

@@ -0,0 +1,312 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://specrails.dev/schemas/workflow-definition/1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "id",
+    "version",
+    "title",
+    "journal",
+    "change",
+    "entry",
+    "maxTransitions",
+    "roles",
+    "nodes"
+  ],
+  "properties": {
+    "schemaVersion": {
+      "const": 1
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z0-9][a-z0-9-]{0,63}$"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{64}$"
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 120
+    },
+    "journal": {
+      "enum": [
+        "ledger-only",
+        "implementation"
+      ]
+    },
+    "change": {
+      "enum": [
+        "new",
+        "existing",
+        "none"
+      ]
+    },
+    "entry": {
+      "$ref": "#/$defs/nodeId"
+    },
+    "maxTransitions": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 10000
+    },
+    "budget": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "maxCostUsd": {
+          "type": "number",
+          "exclusiveMinimum": 0
+        },
+        "maxTokens": {
+          "type": "integer",
+          "minimum": 1
+        },
+        "maxDurationMs": {
+          "type": "integer",
+          "minimum": 1000
+        }
+      }
+    },
+    "policies": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "failFast": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10,
+          "default": 2
+        },
+        "noProgress": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10,
+          "default": 2
+        },
+        "historyMaxChars": {
+          "type": "integer",
+          "minimum": 200,
+          "maximum": 20000,
+          "default": 1500
+        },
+        "concurrency": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 8,
+          "default": 1
+        }
+      }
+    },
+    "roles": {
+      "type": "array",
+      "items": {
+        "$ref": "#/$defs/roleId"
+      },
+      "uniqueItems": true
+    },
+    "nodes": {
+      "type": "object",
+      "minProperties": 1,
+      "propertyNames": {
+        "$ref": "#/$defs/nodeId"
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/node"
+      }
+    },
+    "components": {
+      "type": "object",
+      "propertyNames": {
+        "pattern": "^[a-z0-9][a-z0-9-]{0,63}$"
+      },
+      "additionalProperties": {
+        "$ref": "#/$defs/componentBody"
+      }
+    },
+    "delivery": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "requiresVerified": {
+          "type": "boolean"
+        }
+      }
+    }
+  },
+  "$defs": {
+    "nodeId": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,119}$",
+      "not": {
+        "enum": [
+          "START",
+          "END",
+          "__start__",
+          "__end__",
+          "next"
+        ]
+      }
+    },
+    "roleId": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]{0,63}$"
+    },
+    "engine": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "provider"
+      ],
+      "properties": {
+        "provider": {
+          "type": "string"
+        },
+        "model": {
+          "type": "string"
+        },
+        "effort": {
+          "type": "string"
+        },
+        "thinking": {
+          "enum": [
+            "on",
+            "off"
+          ]
+        }
+      }
+    },
+    "retry": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "maxAttempts": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10
+        },
+        "backoffMs": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 600000
+        },
+        "retryOn": {
+          "type": "array",
+          "items": {
+            "enum": [
+              "idle_timeout",
+              "timeout",
+              "provider_request_error",
+              "session_not_found",
+              "invalid_structured_output"
+            ]
+          }
+        }
+      }
+    },
+    "ends": {
+      "type": "object",
+      "propertyNames": {
+        "pattern": "^[a-z][a-z0-9-]{0,31}$"
+      },
+      "additionalProperties": {
+        "oneOf": [
+          {
+            "$ref": "#/$defs/nodeId"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      }
+    },
+    "node": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "params",
+        "ends"
+      ],
+      "properties": {
+        "kind": {
+          "enum": [
+            "prompt",
+            "role-turn",
+            "decider",
+            "condition",
+            "assign",
+            "verify",
+            "shell",
+            "openspec-validate",
+            "openspec-archive",
+            "approval",
+            "question",
+            "gate",
+            "map",
+            "join",
+            "component",
+            "implementation",
+            "end"
+          ]
+        },
+        "params": {
+          "type": "object"
+        },
+        "ends": {
+          "$ref": "#/$defs/ends"
+        },
+        "retry": {
+          "$ref": "#/$defs/retry"
+        },
+        "label": {
+          "type": "string",
+          "maxLength": 80
+        }
+      }
+    },
+    "componentBody": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "entry",
+        "nodes"
+      ],
+      "properties": {
+        "entry": {
+          "$ref": "#/$defs/nodeId"
+        },
+        "maxTransitions": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10000
+        },
+        "inputs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "outputs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "nodes": {
+          "type": "object",
+          "minProperties": 1,
+          "propertyNames": {
+            "$ref": "#/$defs/nodeId"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/node"
+          }
+        }
+      }
+    }
+  }
+}

package/server/dist/vitest-setup.js

@@ -6,6 +6,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const fs_1 = require("fs");
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
+const supertest_1 = __importDefault(require("supertest"));
+// Supertest starts fixtures on the default (usually IPv6) wildcard socket but
+// builds an IPv4 URL. On hosts with separate port namespaces that URL can reach
+// an unrelated local service. Connect to the family actually owned by the fixture.
+// Keep Supertest responsible for starting and closing its ephemeral servers.
+const transportMarker = Symbol.for('specrails.supertest.address-family');
+const testPrototype = supertest_1.default.Test.prototype;
+if (!testPrototype[transportMarker]) {
+    const serverAddress = testPrototype.serverAddress;
+    testPrototype.serverAddress = function (server, requestPath) {
+        const original = serverAddress.call(this, server, requestPath);
+        const address = server.address();
+        if (address && typeof address !== 'string' && address.family === 'IPv6'
+            && (address.address === '::' || address.address === '::1')) {
+            const url = new URL(original);
+            url.hostname = '[::1]';
+            return url.toString();
+        }
+        return original;
+    };
+    testPrototype[transportMarker] = true;
+}
 /**
  * Test safety net: NEVER let a test write the relocation registry into the
  * developer's real `$HOME/.specrails/registry.json`.

package/server/dist/worktree-overlay.js

@@ -511,7 +511,7 @@ function refreshLegacyInstructions(text) {
     return text.replace(/<!-- specrails-managed:start -->[\s\S]*?<!-- specrails-managed:end -->/g, block => {
         if (!block.includes('skills/sr-*'))
             return block;
-        return '<!-- specrails-managed:start -->\n\n# Specrails agent runtime\n\nFollow the frozen repository scope and official OpenSpec workflow supplied for your role. The host coordinates architect, developer, verification and reviewer; do not launch nested implement or batch-implement orchestration. Read project README, manifests, contracts and relevant nested instructions. Report incomplete tasks and permission blockers with their repository and path.\n\n<!-- specrails-managed:end -->';
+        return '<!-- specrails-managed:start -->\n\n# Specrails agent runtime\n\nFollow the frozen repository scope and official OpenSpec workflow supplied for your role. The host coordinates architect, developer, verification and reviewer; do not launch nested implement orchestration. Read project README, manifests, contracts and relevant nested instructions. Report incomplete tasks and permission blockers with their repository and path.\n\n<!-- specrails-managed:end -->';
     });
 }
 /** Copy `src` → `dest` only when `dest` does not exist. Records `rel`. */