@xfey/tutti 0.1.28 → 0.1.30

package/README.md

@@ -27,7 +27,7 @@
 - 已具备 Fastify host shell、后台 host manager CLI 套件、Dev Runner、Host Project API、SSE、SQLite store、collaboration-state、workspace read-state、project timeline observability helper、Control Plane、Procedure / Run、workspace-ops、checks、Relay staged upload finalize、user skills 文件服务、artifacts 可视化产物查看层和 OpenAI / Codex provider 接入。
 - Host server 支持在显式 `webStatic.root` 或 packaged `web/` 存在时服务 Web 静态产物；`/api/*`、SSE、health 和 host-local control 不被 SPA fallback 吞掉。
 - Root `pack:dry-run` 会先清理 build output、重新构建，再复制 `apps/web/dist` 到 package-local `web/`，生成临时 staging `@xfey/tutti` artifact，并校验 npm pack 文件列表包含 CLI、migrations、prompts、Web index、bundled `@tutti/shared` / `@tutti/relay-client` 以及它们的外部 runtime dependencies，同时排除源码、source map、日志、SQLite、`.env`、`.tutti-dev` 与测试产物。
-- Root `smoke:packed-cli` 同样从干净 build output 生成 staging `@xfey/tutti` tarball、在临时目录安装，并验证 SQLite native binding、`tutti --help` / `tutti launch --help` / `tutti --version`、migrations、prompts、Web static index、bundled internal dependencies、bundled external runtime dependencies、CLI QR dependency、仓库锁定的 `@openai/codex` binary 可执行性和临时全局安装路径；该 smoke 不需要 Tutti source repo 存在。
+- Root `smoke:packed-cli` 同样从干净 build output 生成 staging `@xfey/tutti` tarball、在临时目录安装，并验证 SQLite native binding、`tutti --help` / `tutti launch --help` / `tutti archive --help` / `tutti --version`、migrations、prompts、Web static index、bundled internal dependencies、bundled external runtime dependencies、CLI QR dependency、仓库锁定的 `@openai/codex` binary 可执行性和临时全局安装路径；该 smoke 不需要 Tutti source repo 存在。
 - `prompts/` 是所有模型-facing prompt、指令模板和 Codex 执行模板的统一落点；长 prompt 不内联在 TypeScript 中。
 - Host Project API 只信任 Relay tunnel metadata 注入的 `relay_session_context`；direct loopback 缺少可信 context 时不作为浏览器工作区入口。
 - 详细模块落点见 `src/README.md`；logger redaction、command idempotency、schema、provider 与 Codex 边界以 `docs/system/` 对应 canonical 文档为准。

package/dist/collaboration-state/index.d.ts

@@ -1,6 +1,6 @@
 export { CollaborationStateCursorError } from "./serialization.js";
 export { createIdleExecutionStatusProjection } from "./execution-status.js";
-export { createMainChatAgentMessage, createMainChatMessage, createMainChatSystemMessage, hasMainChatArtifactPreviewMessage, hasMainChatWorklistCompileMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readMessageProjectionById, readMainChatMessageWindow, readMainChatMessagesAfter, readMainChatMessagesAfterCursor, readMainChatMessagesBeforeCursor, } from "./messages.js";
+export { createMainChatAgentMessage, createMainChatMessage, createMainChatSystemMessage, hasMainChatArtifactPreviewMessage, hasMainChatTaskResultMessage, hasMainChatWorklistCompileMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readMessageProjectionById, readMainChatMessageWindow, readMainChatMessagesAfter, readMainChatMessagesAfterCursor, readMainChatMessagesBeforeCursor, } from "./messages.js";
 export { createEmptyScratchpadProjection, readScratchpadReceiptSourceRefs, readScratchpadProjection, submitScratchpadProjection, upsertScratchpadProjection, } from "./scratchpad.js";
 export { advanceScratchpadTaskCompileSourceCursor, markScratchpadRefreshFailed, markScratchpadRefreshStarted, markScratchpadRefreshSucceeded, markScratchpadSourceDirty, readScratchpadSourceState, } from "./scratchpad-source-state.js";
 export { deleteStaleClarificationSubmitReplayHints, readActiveClarificationProjection, readClarificationRoundProjection, readClarificationRoundsForThread, readClarificationThreadResponse, readSealedClarificationRoundsWithoutSuccessor, readSubmittedTaskCompileClarificationRounds, readSubmittedTaskCompileClarificationRoundsAfterCursor, } from "./clarification-records.js";

package/dist/collaboration-state/index.js

@@ -1,6 +1,6 @@
 export { CollaborationStateCursorError } from "./serialization.js";
 export { createIdleExecutionStatusProjection } from "./execution-status.js";
-export { createMainChatAgentMessage, createMainChatMessage, createMainChatSystemMessage, hasMainChatArtifactPreviewMessage, hasMainChatWorklistCompileMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readMessageProjectionById, readMainChatMessageWindow, readMainChatMessagesAfter, readMainChatMessagesAfterCursor, readMainChatMessagesBeforeCursor, } from "./messages.js";
+export { createMainChatAgentMessage, createMainChatMessage, createMainChatSystemMessage, hasMainChatArtifactPreviewMessage, hasMainChatTaskResultMessage, hasMainChatWorklistCompileMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readMessageProjectionById, readMainChatMessageWindow, readMainChatMessagesAfter, readMainChatMessagesAfterCursor, readMainChatMessagesBeforeCursor, } from "./messages.js";
 export { createEmptyScratchpadProjection, readScratchpadReceiptSourceRefs, readScratchpadProjection, submitScratchpadProjection, upsertScratchpadProjection, } from "./scratchpad.js";
 export { advanceScratchpadTaskCompileSourceCursor, markScratchpadRefreshFailed, markScratchpadRefreshStarted, markScratchpadRefreshSucceeded, markScratchpadSourceDirty, readScratchpadSourceState, } from "./scratchpad-source-state.js";
 export { deleteStaleClarificationSubmitReplayHints, readActiveClarificationProjection, readClarificationRoundProjection, readClarificationRoundsForThread, readClarificationThreadResponse, readSealedClarificationRoundsWithoutSuccessor, readSubmittedTaskCompileClarificationRounds, readSubmittedTaskCompileClarificationRoundsAfterCursor, } from "./clarification-records.js";

package/dist/collaboration-state/messages.d.ts

@@ -9,6 +9,7 @@ export declare function createMainChatSystemMessage(db: SqliteDatabase, input: C
 export declare function createMainChatAgentMessage(db: SqliteDatabase, input: CreateMainChatAgentMessageInput): MessageProjection;
 export declare function readMessageProjectionById(db: SqliteDatabase, messageId: MessageId): MessageProjection | null;
 export declare function hasMainChatWorklistFeedbackMessage(db: SqliteDatabase, feedbackKey: string): boolean;
+export declare function hasMainChatTaskResultMessage(db: SqliteDatabase, resultKey: string): boolean;
 export declare function hasMainChatWorklistCompileMessage(db: SqliteDatabase, workflowRef: WorkflowInvocationRef): boolean;
 export declare function hasMainChatArtifactPreviewMessage(db: SqliteDatabase, runResultId: RunResultId): boolean;
 export declare function readCompletedWorklistFeedbackTaskIds(db: SqliteDatabase): Set<TaskId>;

package/dist/collaboration-state/messages.js

@@ -207,6 +207,18 @@ export function hasMainChatWorklistFeedbackMessage(db, feedbackKey) {
         .get(feedbackKey);
     return row !== undefined;
 }
+export function hasMainChatTaskResultMessage(db, resultKey) {
+    const row = db
+        .prepare(`
+        SELECT 1 AS exists_flag
+        FROM messages
+        WHERE scope_kind = 'main_chat'
+          AND json_extract(refs_json, '$.task_result.result_key') = ?
+        LIMIT 1
+      `)
+        .get(resultKey);
+    return row !== undefined;
+}
 export function hasMainChatWorklistCompileMessage(db, workflowRef) {
     const row = db
         .prepare(`

package/dist/control-plane/index.d.ts

@@ -48,7 +48,6 @@ export declare class Phase5ControlPlane {
     private readScratchpadRefreshBlocker;
     private publishTaskRunStarted;
     private publishRunResultRecorded;
-    private maybePublishArtifactPreviewMessage;
     private publishRunTransition;
     private handleRunTerminalTransition;
     private tryRunTaskArrivalScheduler;

package/dist/control-plane/index.js

@@ -1,4 +1,4 @@
-import { createMainChatAgentMessage, hasMainChatArtifactPreviewMessage, readWorklistProjection, } from "../collaboration-state/index.js";
+import { readWorklistProjection } from "../collaboration-state/index.js";
 import { ProcedureEngine } from "../procedure-engine/index.js";
 import { RunEngine } from "../run-engine/index.js";
 import { publishProcedureTransition as publishProcedureTransitionEvent, publishRunResultRecorded as publishRunResultRecordedEvent, publishRunTransition as publishRunTransitionEvent, publishTaskRunStarted as publishTaskRunStartedEvent, } from "./event-publishers.js";
@@ -15,11 +15,7 @@ import { startControlPlaneTaskBoundFollowUpCheck } from "./follow-up-start.js";
 import { runControlPlaneSchedulerForTaskArrival, runControlPlaneSchedulerNow, } from "./run-scheduler.js";
 import { startControlPlaneRunForTask } from "./run-start.js";
 import { runSendClarificationRoundMessage, runSubmitClarificationRound, } from "./clarification-commands.js";
-import { emitWorklistCompletedFeedback, emitWorklistFailedFeedback, } from "./worklist-terminal-feedback.js";
-import { mainChatInvalidates } from "./invalidations.js";
-function artifactPreviewChangedPaths(paths) {
-    return paths?.some((path) => path === "tutti.artifact.json") ?? false;
-}
+import { emitTaskCompletedResultMessage, emitTaskFailedResultMessage, } from "./worklist-terminal-feedback.js";
 export class Phase5ControlPlane {
     engine;
     runEngine;
@@ -274,40 +270,6 @@ export class Phase5ControlPlane {
     }
     publishRunResultRecorded(recorded) {
         publishRunResultRecordedEvent(this.events, recorded);
-        this.maybePublishArtifactPreviewMessage(recorded);
-    }
-    maybePublishArtifactPreviewMessage(recorded) {
-        const result = recorded.task_detail.detail.result;
-        if (result.promotion?.status !== "promoted" ||
-            !artifactPreviewChangedPaths(result.changed_paths)) {
-            return;
-        }
-        const runResultId = recorded.run_result.id;
-        if (hasMainChatArtifactPreviewMessage(this.store.db, runResultId)) {
-            return;
-        }
-        const title = "Preview updated";
-        const message = createMainChatAgentMessage(this.store.db, {
-            body: `${title}\n\nThe current artifact preview was updated by "${recorded.task.title}". Open Artifacts to review the latest preview.`,
-            refs: {
-                scratchpad_source: "exclude",
-                task_id: recorded.task.id,
-                activity_ref: recorded.run_result.activity_ref,
-                artifact_preview: {
-                    kind: "artifact_preview",
-                    title,
-                    status: "updated",
-                    task_id: recorded.task.id,
-                    run_result_id: runResultId,
-                },
-            },
-            now: this.now,
-        });
-        this.events.publish({
-            event_type: "message.created",
-            payload: { message },
-            invalidates: mainChatInvalidates(),
-        });
     }
     publishRunTransition(state) {
         publishRunTransitionEvent({
@@ -321,14 +283,27 @@ export class Phase5ControlPlane {
     }
     handleRunTerminalTransition(state) {
         if (state.activity.status === "finished") {
+            if (state.activity.task_id !== undefined) {
+                emitTaskCompletedResultMessage({
+                    store: this.store,
+                    events: this.events,
+                    taskId: state.activity.task_id,
+                    activityRef: state.activity.activity_ref,
+                    ...(this.projectContext === undefined
+                        ? {}
+                        : { workspaceRoot: this.projectContext.workspaceRoot }),
+                    now: this.now,
+                });
+            }
             this.maybeScheduleAfterRunCompletion();
             return;
         }
         if (state.activity.status === "failed" && state.activity.task_id !== undefined) {
-            emitWorklistFailedFeedback({
+            emitTaskFailedResultMessage({
                 store: this.store,
                 events: this.events,
                 taskId: state.activity.task_id,
+                activityRef: state.activity.activity_ref,
                 now: this.now,
             });
         }
@@ -348,14 +323,6 @@ export class Phase5ControlPlane {
         if (this.tryRunTaskArrivalScheduler()) {
             return;
         }
-        emitWorklistCompletedFeedback({
-            store: this.store,
-            events: this.events,
-            ...(this.projectContext === undefined
-                ? {}
-                : { workspaceRoot: this.projectContext.workspaceRoot }),
-            now: this.now,
-        });
         this.maybeStartContextSyncAfterWorklistCompletion();
     }
     worklistCompletionContextSyncTrigger() {

package/dist/control-plane/task-compile-output.js

@@ -1,5 +1,5 @@
-import { applyTaskCompileProposal, createMainChatAgentMessage, hasMainChatWorklistCompileMessage, readCompiledTaskSummariesByWorkflowRef, openNextTaskCompileClarificationRound, openTaskCompileClarificationRound, readWorklistProjection, submitScratchpadProjection, } from "../collaboration-state/index.js";
-import { clarificationInvalidates, mainChatInvalidates, taskCompileInvalidates, } from "./invalidations.js";
+import { applyTaskCompileProposal, openNextTaskCompileClarificationRound, openTaskCompileClarificationRound, readWorklistProjection, submitScratchpadProjection, } from "../collaboration-state/index.js";
+import { clarificationInvalidates, taskCompileInvalidates, } from "./invalidations.js";
 import { normalizeTaskCompileProposal } from "./task-proposal.js";
 const EMPTY_INITIAL_WORKLIST_CLARIFICATION = {
     title: "Worklist scope needed",
@@ -9,51 +9,6 @@ const EMPTY_INITIAL_WORKLIST_CLARIFICATION = {
 function countWorklistTasks(worklist) {
     return worklist.modules.reduce((count, module) => count + module.tasks.length, 0);
 }
-function taskCountLabel(count) {
-    return count === 1 ? "1 task" : `${count} tasks`;
-}
-function worklistCompileFallback(input) {
-    const lines = [input.title, ""];
-    for (const task of input.tasks) {
-        lines.push(`- ${task.title} (${task.module_name})`);
-        if (task.summary.trim().length > 0) {
-            lines.push(`  ${task.summary}`);
-        }
-    }
-    lines.push("", "Open Worklist to review the compiled tasks.");
-    return lines.join("\n");
-}
-function publishWorklistCompileMessage(input) {
-    if (hasMainChatWorklistCompileMessage(input.store.db, input.workflowRef)) {
-        return;
-    }
-    const tasks = readCompiledTaskSummariesByWorkflowRef(input.store.db, input.workflowRef);
-    if (tasks.length === 0) {
-        return;
-    }
-    const title = `Compiled ${taskCountLabel(tasks.length)} into Worklist`;
-    const message = createMainChatAgentMessage(input.store.db, {
-        body: worklistCompileFallback({ title, tasks }),
-        refs: {
-            scratchpad_source: "exclude",
-            workflow_ref: input.workflowRef,
-            activity_ref: input.activityRef,
-            worklist_compile: {
-                kind: "worklist_compile",
-                workflow_ref: input.workflowRef,
-                title,
-                task_count: tasks.length,
-                tasks,
-            },
-        },
-        now: input.now,
-    });
-    input.events.publish({
-        event_type: "message.created",
-        payload: { message },
-        invalidates: mainChatInvalidates(),
-    });
-}
 function openTaskCompileNeedsHuman(input) {
     const opened = input.continueFromRoundId === undefined
         ? openTaskCompileClarificationRound(input.store.db, {
@@ -155,13 +110,6 @@ export function applyTaskCompileProcedureOutput(input) {
         },
         invalidates: taskCompileInvalidates(),
     });
-    publishWorklistCompileMessage({
-        store: input.store,
-        events: input.events,
-        workflowRef: input.workflowRef,
-        activityRef: input.activityRef,
-        now: input.now,
-    });
     if (input.continueFromRoundId !== undefined) {
         return {
             kind: "completed",

package/dist/control-plane/worklist-terminal-feedback.d.ts

@@ -1,4 +1,4 @@
-import type { TaskId } from "@tutti/shared/ids";
+import type { ActivityRef, TaskId } from "@tutti/shared/ids";
 import type { MessageProjection } from "@tutti/shared/schemas/api";
 import type { HostProjectStore } from "../store/index.js";
 import type { WorkspaceEventBus } from "../server-shell/http/workspace-events.js";
@@ -8,6 +8,14 @@ type EmitWorklistFeedbackInput = {
     workspaceRoot?: string;
     now: () => Date;
 };
+export declare function emitTaskCompletedResultMessage(input: EmitWorklistFeedbackInput & {
+    taskId: TaskId;
+    activityRef?: ActivityRef;
+}): MessageProjection | null;
+export declare function emitTaskFailedResultMessage(input: EmitWorklistFeedbackInput & {
+    taskId: TaskId;
+    activityRef?: ActivityRef;
+}): MessageProjection | null;
 export declare function emitWorklistCompletedFeedback(input: EmitWorklistFeedbackInput): MessageProjection | null;
 export declare function emitWorklistFailedFeedback(input: EmitWorklistFeedbackInput & {
     taskId: TaskId;

package/dist/control-plane/worklist-terminal-feedback.js

@@ -1,5 +1,5 @@
 import { readViewerFile, referenceFileSourceForPath, referenceMediaTypeForPath, referenceTuttiGroupForPath, } from "../workspace-ops/index.js";
-import { createMainChatAgentMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readTaskDetailProjection, readWorklistProjection, } from "../collaboration-state/index.js";
+import { createMainChatAgentMessage, hasMainChatTaskResultMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readTaskDetailProjection, readWorklistProjection, } from "../collaboration-state/index.js";
 import { mainChatInvalidates } from "./invalidations.js";
 const BODY_ITEM_LIMIT = 12;
 function summaryText(value, fallback) {
@@ -177,6 +177,104 @@ function markdownFallback(feedback) {
     }
     return lines.join("\n");
 }
+function taskResultKey(item) {
+    return `task-result:${item.status}:${item.task_id}:${item.latest_run_result_id ?? "no-result"}`;
+}
+function taskResultFallback(result) {
+    const moduleText = result.module_name === undefined ? "" : ` (${result.module_name})`;
+    const lines = [result.title, "", `${result.task_title}${moduleText}`, ""];
+    if (result.final_note !== undefined && result.final_note.trim().length > 0) {
+        lines.push(result.final_note.trim(), "");
+    }
+    if (result.generated_files !== undefined && result.generated_files.length > 0) {
+        lines.push("Generated files:");
+        for (const file of result.generated_files) {
+            lines.push(`- ${file.name}`);
+        }
+        lines.push("");
+    }
+    if (result.summary.trim().length > 0) {
+        lines.push(result.summary.trim(), "");
+    }
+    if (result.status === "failed") {
+        lines.push("Review the Worklist task detail for the failure context.");
+    }
+    else {
+        lines.push("Open the Worklist task detail to review the result.");
+    }
+    return lines.join("\n");
+}
+function publishTaskResultMessage(input, result) {
+    if (hasMainChatTaskResultMessage(input.store.db, result.result_key)) {
+        return null;
+    }
+    const message = createMainChatAgentMessage(input.store.db, {
+        body: taskResultFallback(result),
+        refs: {
+            scratchpad_source: "exclude",
+            task_id: result.task_id,
+            ...(result.activity_ref === undefined ? {} : { activity_ref: result.activity_ref }),
+            task_result: result,
+        },
+        now: input.now,
+    });
+    input.events.publish({
+        event_type: "message.created",
+        payload: { message },
+        invalidates: mainChatInvalidates(),
+    });
+    return message;
+}
+export function emitTaskCompletedResultMessage(input) {
+    const entry = readWorklistTaskEntries(input.store).find((item) => item.task.id === input.taskId);
+    if (entry === undefined || entry.task.status !== "done") {
+        return null;
+    }
+    const item = feedbackItemFromEntry(entry);
+    const finalNote = userNoteCandidateFromEntry(entry);
+    const generatedFiles = generatedFilesForCompletedEntries(input, [entry]);
+    const result = {
+        kind: "task_result",
+        status: "completed",
+        title: "Task completed",
+        task_id: item.task_id,
+        task_title: item.title,
+        result_key: taskResultKey(item),
+        summary: item.summary,
+        ...(item.module_name === undefined ? {} : { module_name: item.module_name }),
+        ...(item.latest_run_result_id === undefined
+            ? {}
+            : { latest_run_result_id: item.latest_run_result_id }),
+        ...(input.activityRef === undefined ? {} : { activity_ref: input.activityRef }),
+        ...(finalNote === undefined ? {} : { final_note: finalNote }),
+        ...(generatedFiles.length === 0 ? {} : { generated_files: generatedFiles }),
+    };
+    return publishTaskResultMessage(input, result);
+}
+export function emitTaskFailedResultMessage(input) {
+    const entry = readWorklistTaskEntries(input.store).find((item) => item.task.id === input.taskId);
+    if (entry === undefined || entry.task.status !== "failed") {
+        return null;
+    }
+    const item = feedbackItemFromEntry(entry);
+    const errorCode = entry.detail?.detail.result.error_code;
+    const result = {
+        kind: "task_result",
+        status: "failed",
+        title: "Task failed",
+        task_id: item.task_id,
+        task_title: item.title,
+        result_key: taskResultKey(item),
+        summary: item.summary,
+        ...(item.module_name === undefined ? {} : { module_name: item.module_name }),
+        ...(item.latest_run_result_id === undefined
+            ? {}
+            : { latest_run_result_id: item.latest_run_result_id }),
+        ...(input.activityRef === undefined ? {} : { activity_ref: input.activityRef }),
+        ...(errorCode === undefined ? {} : { error_code: errorCode }),
+    };
+    return publishTaskResultMessage(input, result);
+}
 function publishFeedbackMessage(input, feedback) {
     if (hasExistingFeedback(input.store, feedback.feedback_key)) {
         return null;

package/dist/server-shell/cli/args.d.ts

@@ -15,12 +15,21 @@ export type CliCommand = {
 } | {
     kind: "ps";
     manage: boolean;
+    all: boolean;
 } | {
     kind: "stop";
     target?: string;
 } | {
     kind: "invite";
     target?: string;
+} | {
+    kind: "archive";
+    target: string;
+    yes: boolean;
+} | {
+    kind: "forget";
+    target: string;
+    yes: boolean;
 } | {
     kind: "logs";
     target?: string;

package/dist/server-shell/cli/args.js

@@ -49,10 +49,7 @@ function readOptionalTarget(args) {
 export function parseCliArgs(argv, cwd = process.cwd()) {
     const args = [...argv];
     const command = args.shift();
-    if (command === undefined ||
-        command === "--help" ||
-        command === "-h" ||
-        command === "help") {
+    if (command === undefined || command === "--help" || command === "-h" || command === "help") {
         return { kind: "help", ...(args[0] === undefined ? {} : { topic: args[0] }) };
     }
     if (command === "--version" || command === "-v" || command === "version") {
@@ -115,17 +112,22 @@ export function parseCliArgs(argv, cwd = process.cwd()) {
     }
     if (command === "ps") {
         let manage = false;
+        let all = false;
         for (const arg of args) {
             if (arg === "--manage") {
                 manage = true;
                 continue;
             }
+            if (arg === "--all") {
+                all = true;
+                continue;
+            }
             if (isHelpArg(arg)) {
                 return { kind: "help", topic: "ps" };
             }
             throw new LaunchError("git_bootstrap_failed", `Unsupported option: ${arg}`, "Use `tutti ps --help` to see supported ps options.");
         }
-        return { kind: "ps", manage };
+        return { kind: "ps", manage, all };
     }
     if (command === "stop") {
         if (hasHelpArg(args)) {
@@ -141,6 +143,54 @@ export function parseCliArgs(argv, cwd = process.cwd()) {
         const target = readOptionalTarget(args);
         return { kind: "invite", ...(target === undefined ? {} : { target }) };
     }
+    if (command === "archive") {
+        if (hasHelpArg(args)) {
+            return { kind: "help", topic: "archive" };
+        }
+        let target;
+        let yes = false;
+        for (const arg of args) {
+            if (arg === "--yes") {
+                yes = true;
+                continue;
+            }
+            if (arg.startsWith("--")) {
+                throw new LaunchError("git_bootstrap_failed", `Unsupported option: ${arg}`, "Run `tutti archive --help` to see supported archive options.");
+            }
+            if (target !== undefined) {
+                throw new LaunchError("git_bootstrap_failed", "Only one archive target is supported", "Run `tutti archive <target> [--yes]`.");
+            }
+            target = arg;
+        }
+        if (target === undefined) {
+            throw new LaunchError("project_target_not_found", "Archive requires a project target", "Run `tutti archive <project-id> [--yes]`.");
+        }
+        return { kind: "archive", target, yes };
+    }
+    if (command === "forget") {
+        if (hasHelpArg(args)) {
+            return { kind: "help", topic: "forget" };
+        }
+        let target;
+        let yes = false;
+        for (const arg of args) {
+            if (arg === "--yes") {
+                yes = true;
+                continue;
+            }
+            if (arg.startsWith("--")) {
+                throw new LaunchError("git_bootstrap_failed", `Unsupported option: ${arg}`, "Run `tutti forget --help` to see supported forget options.");
+            }
+            if (target !== undefined) {
+                throw new LaunchError("git_bootstrap_failed", "Only one forget target is supported", "Run `tutti forget <target> [--yes]`.");
+            }
+            target = arg;
+        }
+        if (target === undefined) {
+            throw new LaunchError("project_target_not_found", "Forget requires a project target", "Run `tutti forget <project-id> [--yes]`.");
+        }
+        return { kind: "forget", target, yes };
+    }
     if (command === "logs") {
         if (hasHelpArg(args)) {
             return { kind: "help", topic: "logs" };

package/dist/server-shell/cli/cli.js

@@ -1,16 +1,18 @@
 #!/usr/bin/env node
 import { formatCliError } from "./errors.js";
 import { parseCliArgs } from "./args.js";
-import { runBackgroundLaunchCommand, runForegroundLaunchCommand, runInternalHostRunCommand, } from "./launch-command.js";
+import { confirmTextFromTty, runBackgroundLaunchCommand, runForegroundLaunchCommand, runInternalHostRunCommand, } from "./launch-command.js";
 import { resolveExistingProjectContext } from "./project-resolver.js";
 import { runProviderSetupTui } from "./provider-tui.js";
-import { runDoctorCommand, runInviteCommand, runLogsCommand, runProviderStatusCommand, runPsManageCommand, runPsCommand, runStopCommand, } from "./runtime-commands.js";
+import { runArchiveCommand, runDoctorCommand, runForgetCommand, runInviteCommand, runLogsCommand, runProviderStatusCommand, runPsManageCommand, runPsCommand, runStopCommand, } from "./runtime-commands.js";
 import { readCliVersion } from "./version.js";
 const HELP_TEXT = `Usage:
   tutti launch [target] [--yes] [--foreground]
-  tutti ps [--manage]
+  tutti ps [--manage] [--all]
   tutti invite [target]
   tutti stop [target]
+  tutti archive <target> [--yes]
+  tutti forget <target> [--yes]
   tutti logs [target] [--tail 120]
   tutti provider setup [target]
   tutti provider status [target]
@@ -42,10 +44,11 @@ Commands:
   status   Show the redacted provider status for a project.
 `;
 const PS_HELP_TEXT = `Usage:
-  tutti ps [--manage]
+  tutti ps [--manage] [--all]
 
 Options:
   --manage   Open the keyboard project manager.
+  --all      Include stopped and binding-only machine projects.
 `;
 const INVITE_HELP_TEXT = `Usage:
   tutti invite [target]
@@ -57,6 +60,24 @@ const STOP_HELP_TEXT = `Usage:
 
 Stops the background Tutti host for a project.
 `;
+const ARCHIVE_HELP_TEXT = `Usage:
+  tutti archive <target> [--yes]
+
+Archives the Relay project for all members after safely stopping its host.
+Memberships and machine-local project state are retained.
+
+Options:
+  --yes   Confirm global Relay archive in a non-interactive terminal.
+`;
+const FORGET_HELP_TEXT = `Usage:
+  tutti forget <target> [--yes]
+
+Deletes this project's machine-local state after safely stopping its host.
+It does not archive the Relay project or change other members.
+
+Options:
+  --yes   Confirm destructive local deletion in a non-interactive terminal.
+`;
 const LOGS_HELP_TEXT = `Usage:
   tutti logs [target] [--tail 120]
 
@@ -83,6 +104,12 @@ function helpForTopic(topic) {
     if (topic === "stop") {
         return STOP_HELP_TEXT;
     }
+    if (topic === "archive") {
+        return ARCHIVE_HELP_TEXT;
+    }
+    if (topic === "forget") {
+        return FORGET_HELP_TEXT;
+    }
     if (topic === "logs") {
         return LOGS_HELP_TEXT;
     }
@@ -147,15 +174,27 @@ try {
             break;
         case "ps":
             if (command.manage) {
-                await runPsManageCommand();
+                await runPsManageCommand({ all: command.all });
             }
             else {
-                process.stdout.write(`${await runPsCommand()}\n`);
+                process.stdout.write(`${await runPsCommand({ all: command.all })}\n`);
             }
             break;
         case "stop":
             process.stdout.write(`${await runStopCommand(command.target)}\n`);
             break;
+        case "archive":
+            process.stdout.write(`${await runArchiveCommand(command.target, {
+                yes: command.yes,
+                confirm: confirmTextFromTty,
+            })}\n`);
+            break;
+        case "forget":
+            process.stdout.write(`${await runForgetCommand(command.target, {
+                yes: command.yes,
+                confirm: confirmTextFromTty,
+            })}\n`);
+            break;
         case "invite":
             process.stdout.write(`${await runInviteCommand(command.target)}\n`);
             break;
@@ -169,7 +208,7 @@ try {
             process.stdout.write(`${runProviderStatusCommand(command.target)}\n`);
             break;
         case "doctor":
-            process.stdout.write(`${runDoctorCommand(command.target)}\n`);
+            process.stdout.write(`${await runDoctorCommand(command.target)}\n`);
             break;
     }
 }

package/dist/server-shell/cli/errors.d.ts

@@ -1,4 +1,4 @@
-export type LaunchErrorCode = "unsafe_project_root" | "unsupported_tutti_schema" | "project_identity_conflict" | "git_bootstrap_failed" | "sensitive_file_detected" | "relay_unavailable" | "relay_registration_failed" | "host_not_running" | "project_target_ambiguous" | "project_target_not_found" | "provider_configuration_required" | "provider_setup_cancelled" | "provider_validation_failed" | "store_migration_failed" | "existing_server_unhealthy" | "takeover_rejected" | "takeover_failed" | "port_unavailable";
+export type LaunchErrorCode = "unsafe_project_root" | "unsupported_tutti_schema" | "project_identity_conflict" | "git_bootstrap_failed" | "sensitive_file_detected" | "relay_unavailable" | "relay_registration_failed" | "host_not_running" | "archive_confirmation_required" | "archive_rejected" | "forget_confirmation_required" | "forget_rejected" | "project_target_ambiguous" | "project_target_not_found" | "provider_configuration_required" | "provider_setup_cancelled" | "provider_validation_failed" | "store_migration_failed" | "existing_server_unhealthy" | "takeover_rejected" | "takeover_failed" | "port_unavailable";
 export declare class LaunchError extends Error {
     readonly code: LaunchErrorCode;
     readonly next: string;

package/dist/server-shell/cli/errors.js

@@ -44,7 +44,12 @@ export function formatCliError(error) {
         if (error.code === "provider_setup_cancelled") {
             return ["Tutti command cancelled", "", `Reason: ${redactText(error.message)}`].join("\n");
         }
-        const lines = ["Tutti command failed", "", `Code: ${error.code}`, `Reason: ${formatBoundedText(error.message)}`];
+        const lines = [
+            "Tutti command failed",
+            "",
+            `Code: ${error.code}`,
+            `Reason: ${formatBoundedText(error.message)}`,
+        ];
         const detailLines = Object.entries(error.details)
             .filter(([, value]) => value !== undefined)
             .map(([key, value]) => `Detail ${key}: ${formatBoundedDetail(value)}`);

package/dist/server-shell/cli/host-lifecycle.d.ts

@@ -37,6 +37,7 @@ export type StartLaunchProjectOptions = LaunchPreparationOptions & {
     connectRelayHostTunnel?: RelayHostTunnelConnector;
     probeRuntimeEndpoint?: HostRuntimeEndpointProbe;
     registerRelayHostConnection?: RelayHostConnectionRegistrar;
+    reconnectWaitMs?: number;
     shutdownWaitMs?: number;
 };
 export type FormatLaunchLifecycleResultOptions = {