dominds 1.8.9 → 1.8.11

package/README.md

@@ -225,6 +225,23 @@ dominds
 3. In the app, create a new dialog with **shadow member** `@fuxi` (Fuxi is hidden by default; use the “Shadow members” picker in the dialog creation modal). Until you add visible members, you’ll mostly work through shadow members.
 4. Tell `@fuxi` your product idea and ask it to propose and apply a suitable agentic team configuration by updating `.minds/team.yaml` (Fuxi has the `team_mgmt` toolset scoped to `.minds/**`).
 
+## Build from source
+
+When developing Dominds itself, use the integrated build entry from the repo root:
+
+```bash
+pnpm run clean
+pnpm run build
+pnpm run lint:types
+```
+
+Notes:
+
+- `pnpm run build` is the canonical full build. It runs backend first, then frontend.
+- `pnpm run build:backend` and `pnpm run build:frontend` are sub-steps for focused debugging. They are not the recommended "full rebuild" command.
+- Do not manually run multiple top-level build commands in parallel. They share `dist/` outputs, so concurrent runs can create racey, misleading results.
+- The backend build may still let pnpm build independent workspace packages concurrently according to the workspace dependency graph. That scheduler-controlled concurrency is expected.
+
 ## Core Philosophy
 
 Dominds is designed for long-running product development and operations, with a “division of labor” constitution:

package/README.zh.md

@@ -106,6 +106,23 @@ https://github.com/longrun-ai/dominds-feat-dev
 - `--shared-rtws` 仅用于调试，会直接使用 `tests/script-rtws`，禁止并发运行多个用例。
 - 需要保留失败现场时，设置 `DOMINDS_TEST_RTWS_KEEP_TMP=1`，测试 CLI 会保留临时 rtws 路径。
 
+### 本仓库源码构建
+
+开发 Dominds 本体时，推荐把仓库根目录下的完整构建入口当成唯一标准用法：
+
+```bash
+pnpm run clean
+pnpm run build
+pnpm run lint:types
+```
+
+说明：
+
+- `pnpm run build` 才是标准的一体构建入口；它会先构建 backend，再构建 frontend。
+- `pnpm run build:backend` / `pnpm run build:frontend` 只是便于聚焦排障的子步骤，不应被当成“完整重建”的推荐命令。
+- 不要手工并行执行多个顶层构建命令，例如同时跑两个 `pnpm run build`，或把 `pnpm run build` 与 `pnpm run build:backend` 并行跑。它们会共享 `dist/` 产物目录，容易制造竞态与误导性结果。
+- `build:backend` 内部的 `pnpm -r ... run build` 仍可能按依赖图并发构建彼此独立的 workspace package；这是 pnpm 调度器控制的正常行为，与“手工并行多个顶层 build”不是一回事。
+
 ## 快速上手（推荐：通过模板创建运行时工作区）
 
 ```bash

package/dist/access-control.d.ts

@@ -1,4 +1,12 @@
-import type { LanguageCode } from './shared/types/language';
+/**
+ * Module: access-control
+ *
+ * Directory/file-extension based access control helpers:
+ * - `matchesPattern` for glob-like directory scope matching (supports `*` and `**`)
+ * - `hasReadAccess`/`hasWriteAccess` to evaluate member permissions
+ * - `getAccessDeniedMessage` to format denial responses
+ */
+import type { LanguageCode } from '@longrun-ai/kernel/types/language';
 import { Team } from './team';
 /**
  * Directory-specific pattern matching for access control.

package/dist/access-control.js

@@ -7,14 +7,6 @@ exports.matchesPattern = matchesPattern;
 exports.hasReadAccess = hasReadAccess;
 exports.hasWriteAccess = hasWriteAccess;
 exports.getAccessDeniedMessage = getAccessDeniedMessage;
-/**
- * Module: access-control
- *
- * Directory/file-extension based access control helpers:
- * - `matchesPattern` for glob-like directory scope matching (supports `*` and `**`)
- * - `hasReadAccess`/`hasWriteAccess` to evaluate member permissions
- * - `getAccessDeniedMessage` to format denial responses
- */
 const path_1 = __importDefault(require("path"));
 const log_1 = require("./log");
 function isEncapsulatedTaskPath(targetPath) {

package/dist/apps/assigned-port.d.ts

@@ -1,4 +1,4 @@
-import type { DomindsAppInstallJsonV1 } from './app-json';
+import type { DomindsAppInstallJsonV1 } from '@longrun-ai/kernel/app-json';
 import type { AppsResolutionEntry } from './resolution-file';
 export type AssignedPortResolutionReason = 'no_frontend' | 'kept_existing' | 'selected_default' | 'allocated_stable_range' | 'reassigned_from_existing_conflict' | 'reassigned_from_existing_unbindable';
 export type AssignedPortResolution = Readonly<{

package/dist/apps/dialog-run-controls.d.ts

@@ -1,4 +1,4 @@
-import type { I18nText } from '../shared/types/i18n';
+import type { I18nText } from '@longrun-ai/kernel/types/i18n';
 export type AppDialogRunControlMeta = Readonly<{
     appId: string;
     descriptionI18n?: I18nText;

package/dist/apps/resolution-file.d.ts

@@ -1,4 +1,4 @@
-import type { DomindsAppInstallJsonV1 } from './app-json';
+import { type DomindsAppInstallJsonV1 } from '@longrun-ai/kernel/app-json';
 export type AppsResolutionSchemaVersion = 1;
 export type AppsResolutionSource = Readonly<{
     kind: 'npx';

package/dist/apps/resolution-file.js

@@ -15,7 +15,7 @@ exports.setResolvedAppAssignedPort = setResolvedAppAssignedPort;
 const promises_1 = __importDefault(require("node:fs/promises"));
 const node_path_1 = __importDefault(require("node:path"));
 const yaml_1 = __importDefault(require("yaml"));
-const app_json_1 = require("./app-json");
+const app_json_1 = require("@longrun-ai/kernel/app-json");
 exports.APPS_RESOLUTION_REL_PATH = node_path_1.default.join('.apps', 'resolution.yaml');
 function isRecord(v) {
     return typeof v === 'object' && v !== null && !Array.isArray(v);

package/dist/apps/run-app-json.d.ts

@@ -1,4 +1,4 @@
-import { type DomindsAppInstallJsonV1 } from './app-json';
+import { type DomindsAppInstallJsonV1 } from '@longrun-ai/kernel/app-json';
 export declare function runDomindsAppJsonViaNpx(params: {
     spec: string;
     cwdAbs: string;

package/dist/apps/run-app-json.js

@@ -9,7 +9,7 @@ const child_process_1 = require("child_process");
 const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
 const util_1 = require("util");
-const app_json_1 = require("./app-json");
+const app_json_1 = require("@longrun-ai/kernel/app-json");
 const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
 function isRecord(v) {
     return typeof v === 'object' && v !== null && !Array.isArray(v);

package/dist/apps/run-control.d.ts

@@ -1,4 +1,5 @@
-import type { DomindsAppRunControlContext, DomindsAppRunControlResult } from '../apps-host/app-host-contract';
+import type { DomindsAppRunControlBlock, DomindsAppRunControlContext, DomindsAppRunControlResult } from '@longrun-ai/kernel/app-host-contract';
+export declare function renderAppRunControlBlockForPreDrive(block: DomindsAppRunControlBlock): string;
 export declare function applyAppDialogRunControl(params: {
     controlId: string;
     payload: DomindsAppRunControlContext;

package/dist/apps/run-control.js

@@ -1,11 +1,48 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderAppRunControlBlockForPreDrive = renderAppRunControlBlockForPreDrive;
 exports.applyAppDialogRunControl = applyAppDialogRunControl;
 exports.applyRegisteredAppDialogRunControls = applyRegisteredAppDialogRunControls;
 const log_1 = require("../log");
 const dialog_run_controls_1 = require("./dialog-run-controls");
 const runtime_1 = require("./runtime");
 const log = (0, log_1.createLogger)('apps-run-control');
+function formatOwnerRef(block) {
+    const owner = block.owner;
+    if (owner.kind === 'human')
+        return 'the human approver';
+    return owner.memberId;
+}
+function formatTargetRef(block) {
+    return block.targetRef.title ?? block.targetRef.id;
+}
+function canProjectAwaitAppAction(block) {
+    if (block.actionClass === 'select') {
+        return Array.isArray(block.optionsSummary) && block.optionsSummary.length > 0;
+    }
+    return true;
+}
+function projectAppActionLabel(block) {
+    if (block.actionClass === 'input')
+        return 'Provide information';
+    if (block.actionClass === 'confirm')
+        return 'Confirm and continue';
+    return 'Choose an option';
+}
+function renderAppRunControlBlockForPreDrive(block) {
+    if (block.blockKind === 'await_members') {
+        const waitingList = block.waitingFor.map((entry) => entry.memberId).join(', ');
+        return `Blocked while waiting for ${waitingList} on ${formatTargetRef(block)}. ${block.promptSummary}`;
+    }
+    if (block.blockKind === 'await_human') {
+        const suffix = block.question ?? block.promptSummary;
+        return `Blocked: human input is required for ${formatTargetRef(block)}. ${suffix}`;
+    }
+    if (!canProjectAwaitAppAction(block)) {
+        return `View problem details. ${block.title}: ${block.promptSummary}`;
+    }
+    return `${projectAppActionLabel(block)} via ${formatOwnerRef(block)} for ${formatTargetRef(block)}. ${block.promptSummary}`;
+}
 async function applyAppDialogRunControl(params) {
     const controlId = params.controlId.trim();
     if (controlId === '') {
@@ -19,6 +56,7 @@ async function applyAppDialogRunControl(params) {
     return await hostClient.applyRunControl(controlId, params.payload);
 }
 async function applyRegisteredAppDialogRunControls(payload) {
+    let recoveryAction;
     for (const control of (0, dialog_run_controls_1.listAppDialogRunControls)()) {
         let result;
         try {
@@ -42,6 +80,12 @@ async function applyRegisteredAppDialogRunControls(payload) {
         if (result.kind === 'reject') {
             return result;
         }
+        if (result.kind === 'block') {
+            return result;
+        }
+        if (recoveryAction === undefined && result.recoveryAction !== undefined) {
+            recoveryAction = result.recoveryAction;
+        }
     }
-    return { kind: 'continue' };
+    return recoveryAction ? { kind: 'allow', recoveryAction } : { kind: 'allow' };
 }

package/dist/apps-host/client.d.ts

@@ -1,7 +1,7 @@
-import type { DomindsAppHostReminderUpdateResult, DomindsAppHostToolResult, DomindsAppInstallJsonV1, DomindsAppReminderApplyRequest, DomindsAppReminderApplyResult } from '../apps/app-json';
+import type { DomindsAppDynamicToolsetsContext, DomindsAppReminderOwnerApplyContext, DomindsAppReminderOwnerRenderContext, DomindsAppReminderOwnerUpdateContext, DomindsAppRunControlContext, DomindsAppRunControlResult } from '@longrun-ai/kernel/app-host-contract';
+import type { DomindsAppHostReminderUpdateResult, DomindsAppHostToolResult, DomindsAppInstallJsonV1, DomindsAppReminderApplyRequest, DomindsAppReminderApplyResult } from '@longrun-ai/kernel/app-json';
 import type { ChatMessage } from '../llm/client';
 import type { ToolArguments } from '../tool';
-import type { DomindsAppDynamicToolsetsContext, DomindsAppReminderOwnerApplyContext, DomindsAppReminderOwnerRenderContext, DomindsAppReminderOwnerUpdateContext, DomindsAppRunControlContext, DomindsAppRunControlResult } from './app-host-contract';
 import type { AppsHostMessageToKernel } from './ipc-types';
 export type EnabledAppForHost = Readonly<{
     appId: string;

package/dist/apps-host/client.js

@@ -100,6 +100,22 @@ function parseMessageToKernel(v) {
         const callId = asString(v['callId']);
         if (!callId)
             throw new Error('Invalid run_control_result message: callId required');
+        const ok = v['ok'];
+        if (ok === true) {
+            return {
+                type,
+                callId,
+                ok: true,
+                result: v['result'],
+            };
+        }
+        if (ok === false) {
+            const errorText = asString(v['errorText']);
+            if (!errorText) {
+                throw new Error('Invalid run_control_result message: errorText required when ok=false');
+            }
+            return { type, callId, ok: false, errorText };
+        }
         return v;
     }
     throw new Error(`Invalid IPC message from apps-host: unknown type '${type}'`);

package/dist/apps-host/host.js

@@ -298,12 +298,100 @@ function validateHostInstance(host, appId) {
 function isValidRunControlResult(result) {
     if (!isRecord(result))
         return false;
+    if (result['kind'] === 'allow') {
+        const recoveryAction = result['recoveryAction'];
+        if (recoveryAction === undefined)
+            return true;
+        if (!isRecord(recoveryAction))
+            return false;
+        return (recoveryAction['actionId'] === 'continue' &&
+            typeof recoveryAction['promptSummary'] === 'string' &&
+            recoveryAction['promptSummary'].trim() !== '');
+    }
     if (result['kind'] === 'reject') {
         return typeof result['errorText'] === 'string' && result['errorText'].trim() !== '';
     }
-    if (result['kind'] !== 'continue')
+    if (result['kind'] !== 'block')
         return false;
-    return true;
+    return isValidRunControlBlock(result['block']);
+}
+function isValidRunControlBlock(block) {
+    if (!isRecord(block))
+        return false;
+    if (!isValidRunControlOwner(block['owner']))
+        return false;
+    if (!isValidRunControlTargetRef(block['targetRef']))
+        return false;
+    if (typeof block['title'] !== 'string' || block['title'].trim() === '')
+        return false;
+    if (typeof block['promptSummary'] !== 'string' || block['promptSummary'].trim() === '') {
+        return false;
+    }
+    if (block['blockKind'] === 'await_members') {
+        return isValidRunControlMemberRefs(block['waitingFor']) && block['waitingFor'].length > 0;
+    }
+    if (block['blockKind'] === 'await_human') {
+        const question = block['question'];
+        const optionsSummary = block['optionsSummary'];
+        if (question !== undefined && (typeof question !== 'string' || question.trim() === ''))
+            return false;
+        return optionsSummary === undefined || isStringArray(optionsSummary);
+    }
+    if (block['blockKind'] === 'await_app_action') {
+        if (block['actionClass'] !== 'input' &&
+            block['actionClass'] !== 'select' &&
+            block['actionClass'] !== 'confirm') {
+            return false;
+        }
+        if (typeof block['actionId'] !== 'string' || block['actionId'].trim() === '')
+            return false;
+        if (block['resolutionMode'] !== 'explicit_continue' &&
+            block['resolutionMode'] !== 'auto_resume') {
+            return false;
+        }
+        return block['optionsSummary'] === undefined || isStringArray(block['optionsSummary']);
+    }
+    return false;
+}
+function isValidRunControlOwner(owner) {
+    if (!isRecord(owner))
+        return false;
+    if (owner['kind'] === 'human')
+        return true;
+    if (owner['kind'] !== 'member')
+        return false;
+    if (typeof owner['memberId'] !== 'string' || owner['memberId'].trim() === '')
+        return false;
+    return owner['roleIds'] === undefined || isStringArray(owner['roleIds']);
+}
+function isValidRunControlTargetRef(targetRef) {
+    if (!isRecord(targetRef))
+        return false;
+    const kind = targetRef['kind'];
+    if (kind !== 'taskdoc' &&
+        kind !== 'phase' &&
+        kind !== 'gate' &&
+        kind !== 'change' &&
+        kind !== 'role' &&
+        kind !== 'member') {
+        return false;
+    }
+    if (typeof targetRef['id'] !== 'string' || targetRef['id'].trim() === '')
+        return false;
+    if (targetRef['title'] === undefined)
+        return true;
+    return typeof targetRef['title'] === 'string' && targetRef['title'].trim() !== '';
+}
+function isValidRunControlMemberRefs(value) {
+    if (!Array.isArray(value))
+        return false;
+    return value.every((entry) => {
+        if (!isRecord(entry))
+            return false;
+        if (typeof entry['memberId'] !== 'string' || entry['memberId'].trim() === '')
+            return false;
+        return entry['roleIds'] === undefined || isStringArray(entry['roleIds']);
+    });
 }
 async function initOnce(msg) {
     for (const app of msg.apps) {

package/dist/apps-host/ipc-types.d.ts

@@ -1,6 +1,7 @@
-import type { DomindsAppDialogReminderRequestBatch, DomindsAppHostReminderUpdateResult, DomindsAppInstallJsonV1, DomindsAppReminderApplyRequest, DomindsAppReminderApplyResult, DomindsAppReminderState } from '../apps/app-json';
+import type { DomindsAppRunControlResult } from '@longrun-ai/kernel/app-host-contract';
+import type { DomindsAppDialogReminderRequestBatch, DomindsAppHostReminderUpdateResult, DomindsAppInstallJsonV1, DomindsAppReminderApplyRequest, DomindsAppReminderApplyResult, DomindsAppReminderState } from '@longrun-ai/kernel/app-json';
+import type { LanguageCode } from '@longrun-ai/kernel/types/language';
 import type { ChatMessage } from '../llm/client';
-import type { LanguageCode } from '../shared/types/language';
 import type { ToolArguments, ToolCallOutput } from '../tool';
 export type AppsHostKernelInitMessage = Readonly<{
     type: 'init';
@@ -180,12 +181,7 @@ export type AppsHostRunControlResultMessage = Readonly<{
     callId: string;
 } & (Readonly<{
     ok: true;
-    result: Readonly<{
-        kind: 'continue';
-    }> | Readonly<{
-        kind: 'reject';
-        errorText: string;
-    }>;
+    result: DomindsAppRunControlResult;
 }> | Readonly<{
     ok: false;
     errorText: string;

package/dist/course-transition.d.ts

@@ -1,4 +1,4 @@
+import type { LanguageCode } from '@longrun-ai/kernel/types/language';
 import type { Dialog } from './dialog';
-import type { LanguageCode } from './shared/types/language';
 export declare function buildClearedMindInvalidationNotice(language: LanguageCode): string;
 export declare function notifyWaitingDialogsOfClearedMind(dialog: Dialog): Promise<number>;

package/dist/dialog-display-state.d.ts

@@ -15,10 +15,10 @@
  * - Broadcasting is optional: when configured, display-state updates are pushed to all WS clients
  *   so multi-tab views converge without polling.
  */
+import type { DialogDisplayState, DialogInterruptionReason } from '@longrun-ai/kernel/types/display-state';
+import type { DialogExecutionMarker } from '@longrun-ai/kernel/types/storage';
+import type { WebSocketMessage } from '@longrun-ai/kernel/types/wire';
 import { DialogID, type Dialog } from './dialog';
-import type { DialogDisplayState, DialogInterruptionReason } from './shared/types/display-state';
-import type { DialogExecutionMarker } from './shared/types/storage';
-import type { WebSocketMessage } from './shared/types/wire';
 type StopRequestedReason = 'user_stop' | 'emergency_stop';
 export type RunControlCountsSnapshot = {
     proceeding: number;

package/dist/dialog-fork.d.ts

@@ -1,4 +1,4 @@
-import type { DialogStatusKind } from './shared/types/wire';
+import type { DialogStatusKind } from '@longrun-ai/kernel/types/wire';
 type ForkDialogAction = Readonly<{
     kind: 'draft_user_text';
     userText: string;

package/dist/dialog-fork.js

@@ -6,9 +6,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.forkRootDialogTreeAtGeneration = forkRootDialogTreeAtGeneration;
 const promises_1 = __importDefault(require("node:fs/promises"));
 const node_path_1 = __importDefault(require("node:path"));
+const storage_1 = require("@longrun-ai/kernel/types/storage");
 const dialog_1 = require("./dialog");
 const persistence_1 = require("./persistence");
-const storage_1 = require("./shared/types/storage");
 const time_1 = require("./shared/utils/time");
 const id_1 = require("./utils/id");
 const FORK_BASELINE_ANCHOR = (0, storage_1.toRootGenerationAnchor)({

package/dist/dialog.d.ts

@@ -1,9 +1,23 @@
+/**
+ * Module: dialog
+ *
+ * Provides the `Dialog` object for orchestrating conversations:
+ * - Tracks messages, agent identity, optional supdialog/subdialog relationships
+ * - Receivers for streaming LLM output and tool results
+ * - Helpers for spawning subdialogs and prompting human input
+ * - Persistence support for dialog state and message history
+ *
+ * Architecture (Phase 2):
+ * - `Dialog` - Abstract base class for all dialogs
+ * - `RootDialog` - Root dialog with subdialog registry
+ * - `SubDialog` - Subdialog with root dialog reference and dynamic supdialog resolution
+ */
+import type { ContextHealthSnapshot } from '@longrun-ai/kernel/types/context-health';
+import type { DialogEvent, ReminderContent, WebSearchCallAction } from '@longrun-ai/kernel/types/dialog';
+import type { DialogPrompt, DialogRunControlSpec, DialogSubdialogReplyTarget, DriveIntent } from '@longrun-ai/kernel/types/drive-intent';
+import type { LanguageCode } from '@longrun-ai/kernel/types/language';
+import type { CalleeCourseNumber, CalleeGenerationSeqNumber, CallingCourseNumber, DialogMetadataFile, HumanQuestion, ProviderData, ReasoningPayload, ToolArguments as StoredToolArguments } from '@longrun-ai/kernel/types/storage';
 import { ChatMessage, FuncResultMsg } from './llm/client';
-import type { ContextHealthSnapshot } from './shared/types/context-health';
-import type { DialogEvent, ReminderContent, WebSearchCallAction } from './shared/types/dialog';
-import type { DialogPrompt, DialogRunControlSpec, DialogSubdialogReplyTarget, DriveIntent } from './shared/types/drive-intent';
-import type { LanguageCode } from './shared/types/language';
-import type { CalleeCourseNumber, CalleeGenerationSeqNumber, CallingCourseNumber, DialogMetadataFile, HumanQuestion, ProviderData, ReasoningPayload, ToolArguments as StoredToolArguments } from './shared/types/storage';
 import type { JsonValue } from './tool';
 import { Reminder, ReminderOptions, ReminderOwner } from './tool';
 type NewCourseHookResult = {
@@ -30,6 +44,9 @@ type NewCourseHook = (args: {
     prompt: DialogPrompt;
     runControl?: DialogRunControlSpec;
 }) => Promise<NewCourseHookResult>;
+export type DialogSuspensionStatusOptions = Readonly<{
+    allowPendingSubdialogs?: boolean;
+}>;
 export declare class DialogID {
     readonly selfId: string;
     readonly rootId: string;
@@ -196,13 +213,14 @@ export declare abstract class Dialog {
     /**
      * Check if dialog can be driven (not suspended for Q4H or subdialogs).
      */
-    canDrive(): Promise<boolean>;
+    canDrive(options?: DialogSuspensionStatusOptions): Promise<boolean>;
     /**
      * Get suspension status for logging/debugging.
      */
-    getSuspensionStatus(): Promise<{
+    getSuspensionStatus(options?: DialogSuspensionStatusOptions): Promise<{
         q4h: boolean;
         subdialogs: boolean;
+        blockingSubdialogs: boolean;
         canDrive: boolean;
     }>;
     get pendingSubdialogIds(): ReadonlyArray<DialogID>;

package/dist/dialog.js

@@ -1,53 +1,6 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DialogStore = exports.RootDialog = exports.SubDialog = exports.Dialog = exports.DialogID = void 0;
-/**
- * Module: dialog
- *
- * Provides the `Dialog` object for orchestrating conversations:
- * - Tracks messages, agent identity, optional supdialog/subdialog relationships
- * - Receivers for streaming LLM output and tool results
- * - Helpers for spawning subdialogs and prompting human input
- * - Persistence support for dialog state and message history
- *
- * Architecture (Phase 2):
- * - `Dialog` - Abstract base class for all dialogs
- * - `RootDialog` - Root dialog with subdialog registry
- * - `SubDialog` - Subdialog with root dialog reference and dynamic supdialog resolution
- */
 const util_1 = require("util");
 const evt_registry_1 = require("./evt-registry");
 const log_1 = require("./log");
@@ -314,21 +267,22 @@ class Dialog {
     /**
      * Check if dialog can be driven (not suspended for Q4H or subdialogs).
      */
-    async canDrive() {
-        const hasQ4H = await this.hasPendingQ4H();
-        const hasSubdialogs = await this.hasPendingSubdialogs();
-        return !hasQ4H && !hasSubdialogs;
+    async canDrive(options) {
+        const suspension = await this.getSuspensionStatus(options);
+        return suspension.canDrive;
     }
     /**
      * Get suspension status for logging/debugging.
      */
-    async getSuspensionStatus() {
+    async getSuspensionStatus(options) {
         const hasQ4H = await this.hasPendingQ4H();
         const hasSubdialogs = await this.hasPendingSubdialogs();
+        const blockingSubdialogs = hasSubdialogs && options?.allowPendingSubdialogs !== true;
         return {
             q4h: hasQ4H,
             subdialogs: hasSubdialogs,
-            canDrive: !hasQ4H && !hasSubdialogs,
+            blockingSubdialogs,
+            canDrive: !hasQ4H && !blockingSubdialogs,
         };
     }
     get pendingSubdialogIds() {
@@ -851,8 +805,6 @@ class Dialog {
                 runControl: runControlSpec,
             });
         }
-        const { notifyWaitingDialogsOfClearedMind } = await Promise.resolve().then(() => __importStar(require('./course-transition')));
-        await notifyWaitingDialogsOfClearedMind(this);
     }
     // Proxy methods for DialogStore - route calls through dialog object instead of direct dlgStore access
     async receiveFuncResult(result) {

package/dist/docs/app-constitution.md

@@ -248,6 +248,49 @@ If the root manifest / team config uses the wrong app id (for example, still dec
 
 So even without `<rtws>/.apps/configuration.yaml` or `<rtws>/.apps/resolution.yaml`, as long as `.minds/app.yaml` declares dependencies, the kernel still resolves local apps via the default strategy; if the root manifest has no dependencies, the effective enabled apps set is empty.
 
+### `phase-gate` first slice: frozen decisions
+
+The following frozen decisions exist to let `phase-gate` become the first recommended TypeScript app without prematurely turning the whole change-governance space into a generic engine. The goal here is to freeze the smallest set of boundaries that would otherwise keep churning kernel contracts, host projection, product recovery actions, and user-facing copy.
+
+This first slice only covers a single change moving through `intake -> routing -> advancement`, plus the two high-value product states `blocked` and `exception in progress`. The only loops included for the first slice are `blocking follow-up`, `exception handling`, and `rollback/recovery`. The first-slice object model stays limited to `change dossier`, `governance decision`, `recovery action`, and `route context`.
+
+#### `Routing` must produce required governance semantics
+
+- `Routing` is not merely “record that the change entered the flow”. It must produce the minimum business truth needed for later governance.
+- For the first slice, that truth must include at least:
+  - the current governance intensity (for example large/medium/small, or an equivalent tiering),
+  - the responsibility boundary (who may continue by default, and who has blocking/approval authority),
+  - whether the default advancement path is allowed.
+- These semantics should live inside the existing `route context + governance decision` surface. Do not introduce a fifth first-slice object just to carry them.
+- Once the flow enters `exception in progress`, the decision must also carry scope, time limit, approving responsibility, and compensating action(s); otherwise a constrained exception degrades into an ungoverned bypass.
+
+#### Minimal formal input contract for `pre-drive decision -> host projection`
+
+- The key first-slice contract is not “push app-private vocabulary into kernel”. It is to freeze how an app expresses whether the host may continue driving.
+- The target direction should widen the current `continue | reject` shape into a formal surface that can express `allow / reject / block`; and for now `block` should carry only mechanism-level orchestration primitives such as `await_members`, `await_human`, and `await_app_action`.
+- For `await_app_action`, the app must provide at least the following stable fields before the host may project it into a product-level recovery action:
+  - `actionClass`
+  - `actionId`
+  - `owner`
+  - `resolutionMode`
+  - `targetRef`
+  - enough target/summary material such as `title`, `promptSummary`, and, for `select`, `optionsSummary`
+- Admission responsibility belongs to host projection: the app provides structured material; the host decides whether the material is sufficient for a concrete recovery action or must be uniformly downgraded to the fallback diagnostic path.
+- This contract should be frozen before implementation starts. `dominds/packages/kernel/src/app-host-contract.ts` still exposes `DomindsAppRunControlResult` as only `continue | reject`, while existing `phase-gate` contract tests already depend on richer blocked / primary-action structures. That gap is the current hard blocker.
+
+#### `Resume advancement` is a product action, not an implicit state jump
+
+- The first slice must expose one explicit, product-level recovery action: `resume advancement`.
+- The reason is simple: `blocking follow-up`, `exception handling`, and `rollback/recovery` only cover “handle the abnormal condition first”. They do not answer “how does the user clearly re-enter the main path once the abnormal condition is resolved?”
+- So after follow-up is completed, an exception is granted/closed, or recovery finishes, host projection must be able to surface a clear “you may now resume advancement” action, instead of hiding that step inside a silent state transition or an implementation detail.
+
+#### Unified fallback label: `View problem details`
+
+- When the app does not provide enough structured material to form a concrete recovery action, the product layer must not surface hollow action classes or implementation placeholders. It should uniformly downgrade to the `inspect_problem` path.
+- The default external label for that path is now fixed as: `View problem details`.
+- Internal identifiers such as `inspect_problem`, `select`, `confirm`, `input`, `driver`, `wiring`, and `host adapter` should not appear in user-facing primary sentences by default.
+- If implementation keeps internal names such as `input`, the projected user copy should still say something like “Provide information” or “Fill in information”, not the raw internal identifier.
+
 ## App-provided `.minds/**` assets
 
 ### Asset types and goals