@nodeint/migent 0.1.5 → 0.1.6

package/dist/templates/migent/references/schema-workflow.yaml

@@ -13,7 +13,16 @@ requires:
   workflow: plan
 
 stages:
+  - id: prepare
+    description: Check the tree before the draft.
+    # No role: Migent runs verify and does not start an agent.
+    verify:
+      - pnpm build
+    verify_timeout: 1800
+    depends_on: []
+
   - id: draft
+    description: Write the draft.
     role: planner
     # model is a name under models in config.yaml, not a provider model id.
     model: planner
@@ -21,7 +30,8 @@ stages:
     # Only keys the adapter marks overridable are stored on the provider session.
     options:
       reasoning-effort: high
-    depends_on: []
+    depends_on:
+      - prepare
     # max_revisions is allowed only when a route returns to this stage.
     max_revisions: 2
     instructions:

package/dist/templates/migent/references/sessions.md

@@ -0,0 +1,65 @@
+# Sessions: uncommon run and resume cases
+
+The everyday commands are in SKILL.md. This file covers the rest.
+
+## Prerequisite session (`--prior`)
+
+If the workflow's `requires` block names a prerequisite workflow and decision,
+find the session:
+
+```
+migent session list --workflow <workflow-id> --status completed --json
+```
+
+Then pass its id with `--prior <session-id>`. `session continue` accepts
+`--prior` too.
+
+## Several blocked stages
+
+When more than one stage is blocked, `session continue` needs the stage:
+
+```
+migent session continue <session-id> --stage <stage> --reply "<reply>"
+```
+
+The other stages stay blocked.
+
+## Cancelled session (exit 130)
+
+Ask the user first. `session continue <session-id>` resumes that same
+execution. A cut-off verify runs again. A cancelled stage with no role
+reruns its verify list in place and does not open a provider. Role status
+and `--reply` are in the skill's Resume section.
+
+## Limits
+
+Accepted by workflow `session run` and by `session continue`.
+
+| Flag | Meaning |
+| --- | --- |
+| `--max-dispatches <n>` | Stage dispatches allowed in this command (default 20). |
+| `--unlimited-dispatches` | Removes the dispatch ceiling. Use only if the user agrees. |
+
+A failed stage stays stopped until `session continue`. That command runs the
+stage and does not sleep until an old `retry_at`. Exit 3 is `stage_failed`.
+Exit 8 is `quota` for `--once` and `--stage`, which do not wait. Exit 130
+during a wait disarms the timer. A single role result uses 0, 1, and 130.
+Exit 6 remains only the path that reopened more than one role execution.
+
+## `--once` and revision counts
+
+`session continue <id>` resets revision counts. `session continue <id> --once`
+advances one stage and does not.
+
+## Config changed during a session
+
+A session keeps the workflow, models, and role instructions it started with.
+Later edits warn on stderr and do not change it. Run `migent doctor --json`
+and tell the user. To adopt the current versions:
+
+```
+migent session continue <session-id> --refresh-workflow
+migent session run --session <session-id> --workflow <workflow> --refresh-workflow
+```
+
+The second form is for starting a prepared session.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodeint/migent",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Compose AI coding agents into repeatable engineering workflows.",
   "keywords": [
     "ai",
@@ -43,9 +43,9 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.8.1",
-    "@nodeint/migent-adapters": "0.1.5",
-    "@nodeint/migent-kernel": "0.1.5",
-    "@nodeint/migent-registry": "0.1.5",
+    "@nodeint/migent-adapters": "0.1.6",
+    "@nodeint/migent-kernel": "0.1.6",
+    "@nodeint/migent-registry": "0.1.6",
     "commander": "^14.0.2",
     "picocolors": "^1.1.1"
   },