@xfey/tutti 0.1.45 → 0.1.46

package/README.md

@@ -26,6 +26,7 @@
 ## 当前状态
 
 - 已具备 Fastify host shell、后台 host manager CLI 套件、带 `service status / stop / restart`、卸载前 `shutdown`、并发启动锁、版本替换、独立 browser context、idle / package update cleanup 与私有日志的机器级 Local Console、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 project 的空群聊会由 collaboration-state 幂等写入一条 Tutti 欢迎消息；它不经过 browser message command，不触发 `@tutti`、Chat read-state、Scratchpad 或 Timeline / execution 流程。
 - Host server 与 Local Console 支持在显式 `webStatic.root` 或 packaged `web/` 存在时服务 Web 静态产物；`/api/*`、SSE、health、host-local control 和 `/local-console/*` API 不被 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 service --help` / `tutti service status` / `tutti shutdown --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 存在。

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, hasMainChatTaskResultMessage, hasMainChatWorklistCompileMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readMessageProjectionById, readMainChatMessageWindow, readMainChatMessagesAfter, readMainChatMessagesAfterCursor, readMainChatMessagesBeforeCursor, } from "./messages.js";
+export { createMainChatAgentMessage, createMainChatMessage, createMainChatSystemMessage, ensureInitialProjectWelcomeMessage, 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, hasMainChatTaskResultMessage, hasMainChatWorklistCompileMessage, hasMainChatWorklistFeedbackMessage, readCompletedWorklistFeedbackTaskIds, readMessageProjectionById, readMainChatMessageWindow, readMainChatMessagesAfter, readMainChatMessagesAfterCursor, readMainChatMessagesBeforeCursor, } from "./messages.js";
+export { createMainChatAgentMessage, createMainChatMessage, createMainChatSystemMessage, ensureInitialProjectWelcomeMessage, 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

@@ -1,12 +1,21 @@
 import { type MessageId, type RunResultId, type TaskId, type WorkflowInvocationRef } from "@tutti/shared/ids";
 import type { MessageProjection, MessageWindow } from "@tutti/shared/schemas/api";
-import type { SqliteDatabase } from "../store/index.js";
+import { type SqliteDatabase } from "../store/index.js";
 import type { CreateMainChatAgentMessageInput, CreateMainChatMessageInput, CreateMainChatSystemMessageInput, ReadMainChatMessagesAfterOptions, ReadMessageWindowOptions } from "./types.js";
 import type { MessageRow } from "./storage-types.js";
 export declare function mapMessageRow(row: MessageRow, db?: SqliteDatabase): MessageProjection;
 export declare function createMainChatMessage(db: SqliteDatabase, input: CreateMainChatMessageInput): MessageProjection;
 export declare function createMainChatSystemMessage(db: SqliteDatabase, input: CreateMainChatSystemMessageInput): MessageProjection;
 export declare function createMainChatAgentMessage(db: SqliteDatabase, input: CreateMainChatAgentMessageInput): MessageProjection;
+/**
+ * Seeds onboarding copy only while a project chat is still empty. The direct
+ * repository write is intentional: this is not user discussion, so it must not
+ * trigger the chat assistant, read-state notifications, or Scratchpad work.
+ */
+export declare function ensureInitialProjectWelcomeMessage(db: SqliteDatabase, input: {
+    projectName: string;
+    now?: () => Date;
+}): MessageProjection | null;
 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;

package/dist/collaboration-state/messages.js

@@ -1,6 +1,18 @@
 import { createMessageId, } from "@tutti/shared/ids";
+import { withHostStoreTransaction } from "../store/index.js";
 import { clampLimit, decodeCursor, messageCursor, nowIso, parseJson, stringifyJson, } from "./serialization.js";
 import { recordReadNotificationEvent } from "./read-state.js";
+function escapeMarkdownText(value) {
+    return value.replace(/[!-/:-@[-`{-~]/gu, "\\$&");
+}
+function initialProjectWelcomeMessage(projectName) {
+    const normalizedProjectName = projectName.trim().replace(/\s+/gu, " ") || "this project";
+    return [
+        `Welcome to ${escapeMarkdownText(normalizedProjectName)} 👋`,
+        "This is where your team can shape ideas, align on goals, and bring the project to life. Tutti will keep the Scratchpad updated as the conversation develops.",
+        "When you’re ready, click Run to begin implementation. You can also mention `@tutti` whenever you need help.",
+    ].join("\n\n");
+}
 function readClarificationCardForMessage(db, messageId) {
     const row = db
         .prepare(`
@@ -148,7 +160,7 @@ export function createMainChatSystemMessage(db, input) {
     }
     return message;
 }
-export function createMainChatAgentMessage(db, input) {
+function insertMainChatAgentMessage(db, input, options) {
     const createdAt = nowIso(input.now);
     const id = createMessageId();
     db.prepare(`
@@ -165,13 +177,15 @@ export function createMainChatAgentMessage(db, input) {
       )
       VALUES (?, 'main_chat', 'agent', 'tutti', 'Tutti', 'agent_text', ?, ?, ?)
     `).run(id, input.body, input.refs === undefined ? null : stringifyJson(input.refs), createdAt);
-    recordReadNotificationEvent(db, {
-        scope: "chat",
-        source_kind: "message",
-        source_ref: id,
-        actor: { kind: "agent", ref: "tutti" },
-        occurred_at: createdAt,
-    });
+    if (options.recordReadState) {
+        recordReadNotificationEvent(db, {
+            scope: "chat",
+            source_kind: "message",
+            source_ref: id,
+            actor: { kind: "agent", ref: "tutti" },
+            occurred_at: createdAt,
+        });
+    }
     const message = {
         id,
         scope: { kind: "main_chat" },
@@ -185,6 +199,27 @@ export function createMainChatAgentMessage(db, input) {
     }
     return message;
 }
+export function createMainChatAgentMessage(db, input) {
+    return insertMainChatAgentMessage(db, input, { recordReadState: true });
+}
+/**
+ * Seeds onboarding copy only while a project chat is still empty. The direct
+ * repository write is intentional: this is not user discussion, so it must not
+ * trigger the chat assistant, read-state notifications, or Scratchpad work.
+ */
+export function ensureInitialProjectWelcomeMessage(db, input) {
+    return withHostStoreTransaction(db, (tx) => {
+        const existing = tx.prepare("SELECT 1 AS found FROM messages LIMIT 1").get();
+        if (existing !== undefined) {
+            return null;
+        }
+        return insertMainChatAgentMessage(tx, {
+            body: initialProjectWelcomeMessage(input.projectName),
+            refs: { scratchpad_source: "exclude" },
+            ...(input.now === undefined ? {} : { now: input.now }),
+        }, { recordReadState: false });
+    });
+}
 export function readMessageProjectionById(db, messageId) {
     const row = db
         .prepare(`
@@ -330,7 +365,11 @@ export function readMainChatMessageWindow(db, options = {}) {
                 .all(target.created_at, target.created_at, target.id, afterLimit + 1);
             hasOlder = olderRows.length > beforeLimit;
             hasNewer = newerRows.length > afterLimit;
-            rows = [...olderRows.slice(0, beforeLimit).reverse(), target, ...newerRows.slice(0, afterLimit)];
+            rows = [
+                ...olderRows.slice(0, beforeLimit).reverse(),
+                target,
+                ...newerRows.slice(0, afterLimit),
+            ];
         }
     }
     else if (before !== null) {

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

@@ -3,6 +3,7 @@ import { serializeRuntimeLogLine } from "@tutti/shared/utils";
 import { completeRelayUpload, resolveRelayUpload } from "@tutti/relay-client";
 import { ApprovalRequestManager } from "../../approvals/index.js";
 import { ReadOnlyChatAssistant } from "../../chat-assistant/index.js";
+import { ensureInitialProjectWelcomeMessage } from "../../collaboration-state/index.js";
 import { resolveControlPlaneCommandRecovery } from "../../control-plane/command-recovery.js";
 import { Phase5ControlPlane } from "../../control-plane/index.js";
 import { resolveProjectOpenAiProcedureWorkflowRunner } from "../../control-plane/workflows/index.js";
@@ -156,6 +157,7 @@ export async function startForegroundHostServer(options) {
     };
     let projectDisplayName = readProjectDisplayName(options.preparation.workspace_root) ??
         (basename(options.preparation.workspace_root) || options.preparation.project_id);
+    ensureInitialProjectWelcomeMessage(store.db, { projectName: projectDisplayName, now });
     let projectDescription = readProjectDescription(options.preparation.workspace_root) ?? "";
     const projectContext = {
         workspaceRoot: options.preparation.workspace_root,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfey/tutti",
-  "version": "0.1.45",
+  "version": "0.1.46",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",