ultra-builder-pro-cli 0.18.0 → 0.19.1

package/hooks/pre_stop_check.py

@@ -34,7 +34,7 @@ def main() -> None:
         print(f"[pre_stop_check] cannot inspect Context Spine: {exc}", file=sys.stderr)
         allow_stop()
         return
-    if breadcrumb and breadcrumb.get("change_id"):
+    if breadcrumb and breadcrumb.get("workflow"):
         allowed = ", ".join(breadcrumb.get("allowed_transitions") or []) or "none"
         required = breadcrumb.get("required_transition") or "none"
         print(

package/hooks/workflow_checkpoint.py

@@ -33,7 +33,7 @@ def main() -> None:
         print(f"[workflow_checkpoint] cannot inspect Context Spine: {exc}", file=sys.stderr)
         print(json.dumps({}))
         return
-    if not breadcrumb or not breadcrumb.get("change_id"):
+    if not breadcrumb or not breadcrumb.get("workflow"):
         print(json.dumps({}))
         return
 

package/hooks/workflow_context.py

@@ -28,7 +28,7 @@ def main() -> None:
     except ContextSpineError as exc:
         print(f"[workflow_context] cannot inspect Context Spine: {exc}", file=sys.stderr)
         breadcrumb = None
-    if breadcrumb:
+    if breadcrumb and breadcrumb.get("workflow"):
         context = render_breadcrumb(root, breadcrumb)
     else:
         print(json.dumps({}))

package/hooks/workflow_resume.py

@@ -64,7 +64,7 @@ def main() -> None:
     text = None
     try:
         breadcrumb = read_breadcrumb(root)
-        if breadcrumb:
+        if breadcrumb and breadcrumb.get("workflow"):
             text = render_breadcrumb(root, breadcrumb)
     except ContextSpineError as exc:
         print(f"[workflow_resume] cannot inspect Context Spine: {exc}", file=sys.stderr)

package/mcp-server/server.cjs

@@ -818,16 +818,28 @@ function appendHookLifecycleEvent({ rootDir, action, hookInput = {} } = {}) {
   const db = openStateDb(dbPath);
   try {
     ensureSchemaVersion(db);
-    const change = db.prepare(
-      `SELECT id FROM changes WHERE status IN ('active', 'blocked', 'ready')
+    const workflow = db.prepare(
+      `SELECT change_id, task_id FROM workflow_runs
+       WHERE status IN ('active', 'blocked', 'ready') AND change_id IS NOT NULL
        ORDER BY updated_at DESC, rowid DESC LIMIT 1`,
     ).get();
+    if (!workflow) return { recorded: false, reason: 'NO_ACTIVE_WORKFLOW' };
+    const change = db.prepare(
+      `SELECT id FROM changes
+       WHERE id = ? AND status IN ('active', 'blocked', 'ready')`,
+    ).get(workflow.change_id);
     if (!change) return { recorded: false, reason: 'NO_ACTIVE_CHANGE' };
-    const task = db.prepare(
-      `SELECT id FROM tasks WHERE change_id = ? AND status IN ('in_progress', 'pending', 'blocked')
-       ORDER BY CASE status WHEN 'in_progress' THEN 0 WHEN 'blocked' THEN 1 ELSE 2 END,
-                updated_at DESC, rowid DESC LIMIT 1`,
-    ).get(change.id);
+    const task = workflow.task_id
+      ? db.prepare(
+        `SELECT id FROM tasks
+         WHERE id = ? AND change_id = ?
+           AND status IN ('in_progress', 'pending', 'blocked')`,
+      ).get(workflow.task_id, change.id)
+      : db.prepare(
+        `SELECT id FROM tasks WHERE change_id = ? AND status IN ('in_progress', 'pending', 'blocked')
+         ORDER BY CASE status WHEN 'in_progress' THEN 0 WHEN 'blocked' THEN 1 ELSE 2 END,
+                  updated_at DESC, rowid DESC LIMIT 1`,
+      ).get(change.id);
     const payload = {
       agent_id: hookMetadata(hookInput.agent_id),
       agent_type: hookMetadata(hookInput.agent_type),

package/package.json

@@ -1,11 +1,10 @@
 {
   "name": "ultra-builder-pro-cli",
-  "version": "0.18.0",
-  "description": "Multi-runtime installer for the Ultra Builder Pro agent engineering system — deploys commands, agents, skills, hooks, and MCP server to Claude Code, OpenCode, Codex CLI, and Kimi Code.",
+  "version": "0.19.1",
+  "description": "Explicitly invoked Ultra Builder Pro workflows for Claude Code, OpenCode, Codex CLI, and Kimi Code, with project-local MCP authority and lifecycle recovery.",
   "bin": {
     "ultra-builder-pro-cli": "bin/install.js",
     "ubp": "bin/install.js",
-    "ubp-handbook": "bin/handbook.js",
     "ubp-orchestrator": "bin/orchestrator.js",
     "ultra-tools": "ultra-tools/cli.cjs"
   },
@@ -56,7 +55,7 @@
     "docs/COMMIT-HASH-BACKFILL.md",
     "docs/DECISIONS.md",
     "docs/STATE-DB-ACCESS-POLICY.md",
-    "docs/USER-HANDBOOK-CONTRACT.md",
+    "docs/PLUGIN-ISOLATION-CONTRACT.md",
     "docs/RUNTIME-COMPAT-MATRIX.md",
     "!**/__pycache__/**",
     "!**/*.pyc",

package/skills/ultra-change/SKILL.md

@@ -60,9 +60,10 @@ meaning is coupled. Downstream task, context, test, or review evidence affected
 change must become stale and be regenerated; never keep old evidence green by prompt
 assertion.
 
-If research is required, invoke `ultra-research` with the recorded disposition. If the
-contract is sufficiently evidenced, the host may recommend `ultra-plan`. `change.context`
-is compiled only for an actual plan, implementation, test, or review consumer.
+If research is required, recommend `ultra-research` with the recorded disposition. If
+the contract is sufficiently evidenced, recommend `ultra-plan`. Return and wait for an
+explicit user invocation; do not start either workflow. `change.context` is compiled
+only for an actual plan, implementation, test, or review consumer.
 
 Stable implementation discoveries use the approval-gated specification-learning
 transitions. External memory and graph providers retain their own content; Ultra stores

package/skills/ultra-init/SKILL.md

@@ -75,7 +75,8 @@ Read the returned `allowed_transitions` and `required_transition`:
 - a required transition represents a hard recovery invariant and must be followed;
 - otherwise the host model recommends among the allowed capabilities using the user's
   goal and current evidence;
-- start `ultra-research` only when the user invoked it or the host selects it after init.
+- never invoke another public Ultra workflow automatically; recommend the best allowed
+  capability and wait for an explicit user invocation.
 
 Report classification, scope, schema and backup result, Git state, init workflow id,
 baseline state, and allowed transitions. Do not claim that a baseline is ready until a