@hasna/loops 0.4.27 → 0.4.28

package/dist/types.d.ts

@@ -223,6 +223,16 @@ export interface WorkflowWorkItem {
     priority: number;
     status: WorkflowWorkItemStatus;
     attempts: number;
+    /**
+     * Consecutive non-productive "gate death" finishes (runs that failed at
+     * worktree prep or a fast triage/planner gate before any real work). Gate
+     * deaths refund their redispatch attempt, so this second counter bounds a
+     * deterministic infrastructure fault: at the ceiling the item is
+     * dead-lettered instead of retrying forever. Reset by a run that reaches
+     * the worker (success, productive failure, or tempfail) and by an
+     * operator requeue with attempts reset.
+     */
+    gateDeaths: number;
     nextAttemptAt?: string;
     leaseExpiresAt?: string;
     workflowId?: string;
@@ -233,6 +243,7 @@ export interface WorkflowWorkItem {
     updatedAt: string;
 }
 export interface UpsertWorkflowWorkItemInput {
+    id?: string;
     routeKey: string;
     idempotencyKey: string;
     invocationId: string;

package/docs/DEPLOYMENT_MODES.md

@@ -159,6 +159,12 @@ refuses to write a no-loss bundle unless the operator explicitly uses
 requires `--apply`; existing rows with the same id are updated only with
 `--replace`. The CLI creates a local SQLite backup before a safe apply.
 
+`loops self-hosted push` applies an additional self-hosted safety rule. Imported
+workflow definitions are archived, and imported loops are paused with
+`nextRunAt`/`retryScheduledFor` cleared. That safety normalization can re-archive
+or re-pause existing same-id rows even when `--replace` is not supplied; explicit
+preserve flags are reserved for deliberate activation.
+
 No-loss validation blocks unsupported or live state instead of silently
 dropping it. The current migration bundle does not preserve workflow invocation
 rows, workflow work items, workflow run/step/event history, or goal run history.

package/docs/USAGE.md

@@ -86,22 +86,25 @@ leases, running runs, leased work items). Inline command env values are not
 exported as secrets; bundles with redacted env values require
 `--allow-redacted` and are marked non-importable.
 
-Self-hosted sync commands are preview-only until the control-plane API exposes
-id-preserving import endpoints:
+Self-hosted sync commands compare local definitions with the control-plane API.
+`push` can apply through the id-preserving `/v1/import` endpoint; `migrate` and
+`pull` remain preview/blocked for remote state that lacks a full export surface:
 
 ```bash
 loops self-hosted migrate --dry-run
 loops self-hosted push --dry-run
+loops self-hosted push --apply --manifest-file ./self-hosted-push.json
 loops self-hosted pull --dry-run
 ```
 
-The preview may inspect `LOOPS_API_URL`/`HASNA_LOOPS_API_URL`, but it refuses
-remote apply because normal loop CRUD would generate new ids. Use
-`loops self-hosted runner-register` to verify runner registration against an
-API, then use `loops-runner run-once` for the current bounded non-workflow
+Self-hosted push is safe by default: workflows are archived and loops are
+paused with scheduling pointers cleared, including existing same-id rows that
+need re-neutralizing. `--replace` permits broader same-id data updates, but is
+not required for that safety normalization. Use `loops self-hosted
+runner-register` to verify runner registration against an API, then use
+`loops-runner run-once` for the current bounded non-workflow
 claim/execute/finalize protocol. `loops-serve migrate` applies the Postgres
-schema and `api_keys` table for a self-hosted control-plane host; the standalone
-CLI migration previews still do not perform id-preserving remote apply.
+schema and `api_keys` table for a self-hosted control-plane host.
 Runner registration is preview-only unless `--apply` is present.
 
 ## Install

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/loops",
-  "version": "0.4.27",
+  "version": "0.4.28",
   "description": "Persistent local loop and workflow runner for deterministic commands and headless AI coding agents",
   "type": "module",
   "main": "dist/index.js",
@@ -110,6 +110,7 @@
     "bun": ">=1.0.0"
   },
   "dependencies": {
+    "@hasna/contracts": "^0.5.1",
     "@hasna/events": "^0.1.9",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@openrouter/ai-sdk-provider": "2.9.1",
@@ -119,8 +120,7 @@
     "zod": "4.4.3"
   },
   "optionalDependencies": {
-    "@hasna/machines": "0.0.49",
-    "@hasna/contracts": "^0.4.2"
+    "@hasna/machines": "0.0.49"
   },
   "devDependencies": {
     "@types/bun": "latest",