@xfey/tutti 0.1.14 → 0.1.16

package/dist/skills/index.js

@@ -9,8 +9,8 @@ export { MAX_SKILL_DIRECTORY_DEPTH, MAX_SKILL_FILE_BYTES, MAX_SKILL_FILE_COUNT,
 export { SkillServiceError } from "./errors.js";
 export { isValidSkillName, parseSkillMarkdown } from "./metadata.js";
 export { prepareUserSkillZipImport } from "./zip-import.js";
-export function getUserSkillsRoot(tuttiHome) {
-    return join(tuttiHome, USER_SKILLS_DIRECTORY_NAME);
+export function getProjectUserSkillsRoot(tuttiHome, projectId) {
+    return join(tuttiHome, "projects", projectId, USER_SKILLS_DIRECTORY_NAME);
 }
 function assertValidSkillName(skillName) {
     if (!isValidSkillName(skillName)) {
@@ -24,11 +24,10 @@ function ensureInside(parent, child) {
         throw new SkillServiceError("validation_failed", "Skill path is invalid");
     }
 }
-function skillDirectory(tuttiHome, skillName) {
+function skillDirectory(userSkillsRoot, skillName) {
     assertValidSkillName(skillName);
-    const root = getUserSkillsRoot(tuttiHome);
-    const directory = join(root, skillName);
-    ensureInside(root, directory);
+    const directory = join(userSkillsRoot, skillName);
+    ensureInside(userSkillsRoot, directory);
     return directory;
 }
 function readSkillMarkdown(filePath) {
@@ -63,18 +62,17 @@ function readSkillProjection(directory) {
         updatedAt: stat.mtime.toISOString(),
     });
 }
-export function listUserSkills(tuttiHome) {
-    const root = getUserSkillsRoot(tuttiHome);
-    if (!existsSync(root)) {
+export function listUserSkills(userSkillsRoot) {
+    if (!existsSync(userSkillsRoot)) {
         return [];
     }
     const items = [];
-    for (const entry of readdirSync(root, { withFileTypes: true })) {
+    for (const entry of readdirSync(userSkillsRoot, { withFileTypes: true })) {
         if (!entry.isDirectory() || !isValidSkillName(entry.name)) {
             continue;
         }
         try {
-            const projection = readSkillProjection(join(root, entry.name));
+            const projection = readSkillProjection(join(userSkillsRoot, entry.name));
             if (projection.name === entry.name) {
                 items.push(projection);
             }
@@ -85,8 +83,8 @@ export function listUserSkills(tuttiHome) {
     }
     return items.sort((left, right) => left.name.localeCompare(right.name));
 }
-export function readUserSkill(tuttiHome, skillName) {
-    const directory = skillDirectory(tuttiHome, skillName);
+export function readUserSkill(userSkillsRoot, skillName) {
+    const directory = skillDirectory(userSkillsRoot, skillName);
     const skillMdPath = join(directory, SKILL_MD_FILE_NAME);
     if (!existsSync(skillMdPath)) {
         throw new SkillServiceError("skill_not_found", "Skill does not exist");
@@ -110,19 +108,18 @@ export async function importUserSkillZip(options) {
         fileName: options.fileName,
     });
     return commitUserSkillImport({
-        tuttiHome: options.tuttiHome,
+        userSkillsRoot: options.userSkillsRoot,
         plan,
     });
 }
 export function commitUserSkillImport(options) {
     const candidate = options.plan;
-    const root = getUserSkillsRoot(options.tuttiHome);
-    mkdirSync(root, { recursive: true, mode: 0o700 });
-    const destination = skillDirectory(options.tuttiHome, candidate.skillName);
+    mkdirSync(options.userSkillsRoot, { recursive: true, mode: 0o700 });
+    const destination = skillDirectory(options.userSkillsRoot, candidate.skillName);
     const existed = existsSync(destination);
     const tempParent = mkdtempSync(join(tmpdir(), "tutti-skill-import-"));
     const tempSkillRoot = join(tempParent, candidate.skillName);
-    const backupPath = join(root, `.trash-${candidate.skillName}-${process.pid}-${Date.now()}`);
+    const backupPath = join(options.userSkillsRoot, `.trash-${candidate.skillName}-${process.pid}-${Date.now()}`);
     try {
         writeCandidateFiles(tempSkillRoot, candidate);
         if (existed) {
@@ -154,11 +151,11 @@ export function commitUserSkillImport(options) {
             kind: existed ? "replaced" : "created",
             skill_name: candidate.skillName,
         },
-        skill: readUserSkill(options.tuttiHome, candidate.skillName),
+        skill: readUserSkill(options.userSkillsRoot, candidate.skillName),
     };
 }
-export function deleteUserSkill(tuttiHome, skillName) {
-    const directory = skillDirectory(tuttiHome, skillName);
+export function deleteUserSkill(userSkillsRoot, skillName) {
+    const directory = skillDirectory(userSkillsRoot, skillName);
     if (!existsSync(directory)) {
         return { kind: "not_found", skill_name: skillName };
     }

package/migrations/0012_scratchpad_receipts.sql

@@ -0,0 +1,31 @@
+ALTER TABLE scratchpad
+  ADD COLUMN state TEXT NOT NULL DEFAULT 'ready' CHECK (state IN ('ready', 'submitted'));
+
+ALTER TABLE scratchpad
+  ADD COLUMN submitted_by_activity_ref TEXT;
+
+ALTER TABLE scratchpad
+  ADD COLUMN submitted_by_workflow_ref TEXT;
+
+ALTER TABLE scratchpad
+  ADD COLUMN submitted_at TEXT;
+
+CREATE TABLE IF NOT EXISTS scratchpad_receipts (
+  workflow_ref TEXT PRIMARY KEY,
+  activity_ref TEXT NOT NULL,
+  topic TEXT NOT NULL,
+  background_summary TEXT NOT NULL,
+  current_consensus_json TEXT NOT NULL CHECK (
+    json_valid(current_consensus_json) AND json_type(current_consensus_json) = 'array'
+  ),
+  open_questions_json TEXT NOT NULL CHECK (
+    json_valid(open_questions_json) AND json_type(open_questions_json) = 'array'
+  ),
+  task_changes_json TEXT NOT NULL CHECK (
+    json_valid(task_changes_json) AND json_type(task_changes_json) = 'array'
+  ),
+  submitted_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_scratchpad_receipts_submitted_at
+  ON scratchpad_receipts (submitted_at DESC, workflow_ref DESC);

package/migrations/README.md

@@ -24,10 +24,11 @@
 - `0009_project_timeline_events.sql`：新增 Timeline 专用 append-only durable event 表，用于记录缺少其他稳定 record 的 context sync、reference summary 与 promotion reconcile 轻量可观测性节点。
 - `0010_project_brief.sql`：新增 host-local Project Brief projection 表，用于保存四个 baseline Project Docs 的短摘要和 source fingerprint。
 - `0011_message_author_avatar.sql`：为消息作者增加可选 Relay account avatar 快照，保证跨浏览器查看历史消息时不依赖当前 viewer profile 或 presence sample。
+- `0012_scratchpad_receipts.sql`：为当前 Scratchpad 增加 `submitted` 状态字段，并新增已提交 Scratchpad 小票历史表。
 
 ## 当前实现状态
 
-- `0001_init.sql`、`0002_allow_sealed_round_successor_note.sql`、`0003_drop_scratchpad_source_message_refs.sql`、`0004_read_state.sql`、`0005_provider_usage.sql`、`0006_scratchpad_source_state.sql`、`0007_workspace_signal_read_state_scopes.sql`、`0008_provider_usage_anchors.sql`、`0009_project_timeline_events.sql`、`0010_project_brief.sql` 与 `0011_message_author_avatar.sql` 已存在，代表当前 host project SQLite schema contract。
+- `0001_init.sql`、`0002_allow_sealed_round_successor_note.sql`、`0003_drop_scratchpad_source_message_refs.sql`、`0004_read_state.sql`、`0005_provider_usage.sql`、`0006_scratchpad_source_state.sql`、`0007_workspace_signal_read_state_scopes.sql`、`0008_provider_usage_anchors.sql`、`0009_project_timeline_events.sql`、`0010_project_brief.sql`、`0011_message_author_avatar.sql` 与 `0012_scratchpad_receipts.sql` 已存在，代表当前 host project SQLite schema contract。
 - SQLite adapter、migration runner、checksum 校验、store metadata 初始化、transaction helper 与 command recovery scan helper 已实现。
 - 协作 repository 与 Control Plane 已实现第一批业务读写；Phase 7 首批已复用 `0001_init.sql` 中的 `tasks.latest_run_result_id`、`task_details.result_json` 与 `run_results` 表完成 Run result / checks / promotion 摘要持久化。Control Plane recovery resolver 与 task-bound continuation / retry 复用现有 schema；deterministic promotion reconcile 的业务 truth 仍写入最终 Run result / task detail result，Timeline 轻量节点写入 `project_timeline_events`，merge workspace 不进入 SQLite truth。`provider_usage_events` 只保存 token 计数、调用来源、模型名、记录时间和可空 anchor，不保存 provider secret、prompt 或 raw response。store 基础设施本身已经可以创建并迁移 `tutti.sqlite`。
 

package/node_modules/@tutti/shared/dist/schemas/api/index.d.ts

@@ -7,12 +7,12 @@ export { ProjectTimelineItemKindSchema, ProjectTimelineItemSchema, ProjectTimeli
 export { MAX_REFERENCE_STAGED_UPLOAD_BYTES, MAX_SKILL_ZIP_STAGED_UPLOAD_BYTES, MAX_STAGED_UPLOAD_BYTES, PresignedUploadPutSchema, ReferenceFileStartRelayUploadPayloadSchema, ReferenceStagedUploadReferenceProperties, RelayUploadProjectionSchema, RelayUploadPurposeSchema, Sha256DigestSchema, SkillZipStartRelayUploadPayloadSchema, SkillZipStagedUploadReferenceProperties, StagedUploadReferenceProperties, StagedUploadReferenceSchema, StartRelayUploadBodySchema, StartRelayUploadDispositionSchema, StartRelayUploadPayloadSchema, StartRelayUploadResponseSchema, StartRelayUploadResultSchema, maxStagedUploadBytesForPurpose, } from "./uploads.js";
 export { MarkReadBodySchema, MarkReadDispositionSchema, MarkReadPayloadSchema, MarkReadResponseSchema, MarkReadResultSchema, ReadStateScopeProjectionSchema, ReadStateScopeSchema, ReadStateSummaryProjectionSchema, } from "./read-state.js";
 export { GetMessagesRequestSchema, MessageAuthorSchema, MessageCreatedEventPayloadSchema, MessageKindSchema, MessageProjectionSchema, MessageReferenceFileRefSchema, MessageRefsSchema, MessageScopeSchema, MessageWindowSchema, ReferenceFileCategorySchema, SendMainChatMessageBodySchema, SendMainChatMessageCreatedDispositionSchema, SendMainChatMessageDispositionSchema, SendMainChatMessagePayloadSchema, SendMainChatMessageResponseSchema, SendMainChatMessageResultSchema, WorklistFeedbackItemSchema, WorklistFeedbackRefSchema, } from "./messages.js";
-export { CheckSkipReasonCodeSchema, ExternalSideEffectSummaryProjectionSchema, GetRecoverySummariesRequestSchema, GetRecoverySummariesResponseSchema, GetRecoverySummaryResponseSchema, RecoverySummaryProjectionSchema, ResultAnchorSchema, RunLineageSchema, RunResultProjectionSchema, ScratchpadProjectionSchema, TaskContractProjectionSchema, TaskDetailProjectionSchema, TaskDetailResultProjectionSchema, TaskModuleProjectionSchema, TaskProjectionSchema, TaskRunResultsPageSchema, TaskStatusSchema, WorklistProjectionSchema, } from "./work-items.js";
+export { CheckSkipReasonCodeSchema, ExternalSideEffectSummaryProjectionSchema, GetRecoverySummariesRequestSchema, GetRecoverySummariesResponseSchema, GetRecoverySummaryResponseSchema, RecoverySummaryProjectionSchema, ResultAnchorSchema, RunLineageSchema, RunResultProjectionSchema, ScratchpadProjectionSchema, ScratchpadReceiptProjectionSchema, TaskContractProjectionSchema, TaskDetailProjectionSchema, TaskDetailResultProjectionSchema, TaskModuleProjectionSchema, TaskProjectionSchema, TaskRunResultsPageSchema, TaskStatusSchema, WorklistProjectionSchema, } from "./work-items.js";
 export { ActiveApprovalProjectionSchema, ApprovalCommandProjectionSchema, ApprovalDecisionKindSchema, ApprovalDecisionOptionProjectionSchema, ApprovalDecisionToneSchema, ApprovalFileChangeProjectionSchema, ApprovalPermissionsProjectionSchema, ApprovalRequestKindSchema, ApprovalRequestProjectionSchema, ApprovalResolutionOutcomeSchema, ApprovalResolutionProjectionSchema, DecideApprovalBodySchema, DecideApprovalDispositionSchema, DecideApprovalPayloadSchema, DecideApprovalResponseSchema, DecideApprovalResultSchema, } from "./approvals.js";
 export { ActiveClarificationProjectionSchema, ClarificationChangedEventPayloadSchema, ClarificationOwnerProjectionSchema, ClarificationRequestPayloadSchema, ClarificationRoundProjectionSchema, ClarificationRoundSummaryProjectionSchema, ClarificationSuccessorRefSchema, ClarificationThreadProjectionSchema, ContextRefSchema, GetClarificationRoundMessagesRequestSchema, GetClarificationRoundResponseSchema, GetClarificationThreadResponseSchema, HumanInteractionPayloadSchema, HumanRequestPayloadSchema, SendClarificationRoundMessageBodySchema, SendClarificationRoundMessageDispositionSchema, SendClarificationRoundMessagePayloadSchema, SendClarificationRoundMessageResponseSchema, SendClarificationRoundMessageResultSchema, SubmitClarificationRoundBodySchema, SubmitClarificationRoundDispositionSchema, SubmitClarificationRoundPayloadSchema, SubmitClarificationRoundResponseSchema, SubmitClarificationRoundResultSchema, } from "./clarifications.js";
 export { GetProjectDocRequestSchema, GetProjectDocResponseSchema, GetProjectDocsResponseSchema, GetReferenceFilesRequestSchema, GetReferenceFilesResponseSchema, GetViewerAssetRequestSchema, GetViewerFileRequestSchema, GetViewerFileResponseSchema, GetViewerTreeRequestSchema, GetViewerTreeResponseSchema, ProjectDocKeySchema, ProjectDocParamsSchema, ProjectDocSummaryProjectionSchema, ReferenceDirectoryProjectionSchema, ReferenceFileProjectionSchema, ReferenceSummaryProjectionSchema, ReferenceTextReadBlockedReasonSchema, RefreshReferenceSummariesBodySchema, RefreshReferenceSummariesDispositionSchema, RefreshReferenceSummariesPayloadSchema, RefreshReferenceSummariesResponseSchema, RefreshReferenceSummariesResultSchema, UploadReferenceFileBodySchema, UploadReferenceFileDispositionSchema, UploadReferenceFilePayloadSchema, UploadReferenceFileResponseSchema, UploadReferenceFileResultSchema, ViewerAssetVariantSchema, ViewerFileContentProjectionSchema, ViewerFileProjectionSchema, ViewerPageSchema, ViewerPathSchema, ViewerRepoSnapshotSchema, ViewerTreeEntryProjectionSchema, ViewerTreeTextReadBlockedReasonSchema, ViewerUnreadableReasonSchema, } from "./viewer-reference.js";
 export { ArtifactKindSchema, ArtifactManifestPathSchema, ArtifactManifestSchema, ArtifactPreviewCommandPayloadSchema, ArtifactPreviewCommandResultSchema, ArtifactPreviewProjectionSchema, ArtifactPreviewStatusSchema, ArtifactServerManifestSchema, ArtifactStaticManifestSchema, ArtifactSummaryProjectionSchema, ArtifactTitleSchema, ArtifactProjectionSchema, GetArtifactsResponseSchema, HeartbeatArtifactPreviewBodySchema, HeartbeatArtifactPreviewDispositionSchema, HeartbeatArtifactPreviewResponseSchema, StartArtifactPreviewBodySchema, StartArtifactPreviewDispositionSchema, StartArtifactPreviewResponseSchema, StopArtifactPreviewBodySchema, StopArtifactPreviewDispositionSchema, StopArtifactPreviewResponseSchema, } from "./artifacts.js";
 export { DeleteSkillBodySchema, DeleteSkillDispositionSchema, DeleteSkillPayloadSchema, DeleteSkillResponseSchema, GetSkillParamsSchema, GetSkillResponseSchema, GetSkillsResponseSchema, ImportSkillZipBodySchema, ImportSkillZipDispositionSchema, ImportSkillZipPayloadSchema, ImportSkillZipResponseSchema, ImportSkillZipResultSchema, SkillDetailProjectionSchema, SkillNameSchema, SkillProjectionSchema, } from "./skills.js";
 export { ActivityEventProjectionSchema, ActivityEventSsePayloadSchema, ApprovalChangedEventPayloadSchema, ActivityProjectionSchema, ConnectionReadyEventPayloadSchema, ExecutionActivitySummarySchema, ExecutionStatusChangedEventPayloadSchema, ExecutionStatusKindSchema, ExecutionStatusProjectionSchema, ProcedureLaneSchema, ProviderConfigChangedEventPayloadSchema, QueryInvalidateEventPayloadSchema, ScratchpadUpdatedEventPayloadSchema, TaskDetailUpdatedEventPayloadSchema, TaskUpdatedEventPayloadSchema, WorklistChangedEventPayloadSchema, WorkspaceRecoveredEventPayloadSchema, } from "./runtime-events.js";
-export { ContextSyncBodySchema, ContextSyncDispositionSchema, ContextSyncPayloadSchema, ContextSyncResponseSchema, ContextSyncResultSchema, InitializeProjectDocsBodySchema, InitializeProjectDocsDispositionSchema, InitializeProjectDocsPayloadSchema, InitializeProjectDocsResponseSchema, InitializeProjectDocsResultSchema, ProjectDocsProcedureStartResultSchema, RefreshScratchpadDispositionSchema, RefreshScratchpadResultSchema, RunSchedulerNowBodySchema, RunSchedulerNowDispositionSchema, RunSchedulerNowPayloadSchema, RunSchedulerNowResponseSchema, SubmitWorklistBodySchema, SubmitWorklistDispositionSchema, SubmitWorklistPayloadSchema, SubmitWorklistResponseSchema, SubmitWorklistResultSchema, UpdateProjectDisplayNameBodySchema, UpdateProjectDisplayNameDispositionSchema, UpdateProjectDisplayNamePayloadSchema, UpdateProjectDisplayNameResponseSchema, UpdateProjectDisplayNameResultSchema, } from "./workspace-commands.js";
+export { ContextSyncBodySchema, ContextSyncDispositionSchema, ContextSyncPayloadSchema, ContextSyncResponseSchema, ContextSyncResultSchema, InitializeProjectDocsBodySchema, InitializeProjectDocsDispositionSchema, InitializeProjectDocsPayloadSchema, InitializeProjectDocsResponseSchema, InitializeProjectDocsResultSchema, ProjectDocsProcedureStartResultSchema, RefreshScratchpadDispositionSchema, RefreshScratchpadResultSchema, RunSchedulerNowBodySchema, RunSchedulerNowDispositionSchema, RunSchedulerNowPayloadSchema, RunSchedulerNowResponseSchema, SubmitWorklistBodySchema, SubmitWorklistDispositionSchema, SubmitWorklistPayloadSchema, SubmitWorklistResponseSchema, SubmitWorklistResultSchema, UpdateProjectDescriptionBodySchema, UpdateProjectDescriptionDispositionSchema, UpdateProjectDescriptionPayloadSchema, UpdateProjectDescriptionResponseSchema, UpdateProjectDescriptionResultSchema, UpdateProjectDisplayNameBodySchema, UpdateProjectDisplayNameDispositionSchema, UpdateProjectDisplayNamePayloadSchema, UpdateProjectDisplayNameResponseSchema, UpdateProjectDisplayNameResultSchema, } from "./workspace-commands.js";
 //# sourceMappingURL=index.d.ts.map

package/node_modules/@tutti/shared/dist/schemas/api/index.js

@@ -6,12 +6,12 @@ export { ProjectTimelineItemKindSchema, ProjectTimelineItemSchema, ProjectTimeli
 export { MAX_REFERENCE_STAGED_UPLOAD_BYTES, MAX_SKILL_ZIP_STAGED_UPLOAD_BYTES, MAX_STAGED_UPLOAD_BYTES, PresignedUploadPutSchema, ReferenceFileStartRelayUploadPayloadSchema, ReferenceStagedUploadReferenceProperties, RelayUploadProjectionSchema, RelayUploadPurposeSchema, Sha256DigestSchema, SkillZipStartRelayUploadPayloadSchema, SkillZipStagedUploadReferenceProperties, StagedUploadReferenceProperties, StagedUploadReferenceSchema, StartRelayUploadBodySchema, StartRelayUploadDispositionSchema, StartRelayUploadPayloadSchema, StartRelayUploadResponseSchema, StartRelayUploadResultSchema, maxStagedUploadBytesForPurpose, } from "./uploads.js";
 export { MarkReadBodySchema, MarkReadDispositionSchema, MarkReadPayloadSchema, MarkReadResponseSchema, MarkReadResultSchema, ReadStateScopeProjectionSchema, ReadStateScopeSchema, ReadStateSummaryProjectionSchema, } from "./read-state.js";
 export { GetMessagesRequestSchema, MessageAuthorSchema, MessageCreatedEventPayloadSchema, MessageKindSchema, MessageProjectionSchema, MessageReferenceFileRefSchema, MessageRefsSchema, MessageScopeSchema, MessageWindowSchema, ReferenceFileCategorySchema, SendMainChatMessageBodySchema, SendMainChatMessageCreatedDispositionSchema, SendMainChatMessageDispositionSchema, SendMainChatMessagePayloadSchema, SendMainChatMessageResponseSchema, SendMainChatMessageResultSchema, WorklistFeedbackItemSchema, WorklistFeedbackRefSchema, } from "./messages.js";
-export { CheckSkipReasonCodeSchema, ExternalSideEffectSummaryProjectionSchema, GetRecoverySummariesRequestSchema, GetRecoverySummariesResponseSchema, GetRecoverySummaryResponseSchema, RecoverySummaryProjectionSchema, ResultAnchorSchema, RunLineageSchema, RunResultProjectionSchema, ScratchpadProjectionSchema, TaskContractProjectionSchema, TaskDetailProjectionSchema, TaskDetailResultProjectionSchema, TaskModuleProjectionSchema, TaskProjectionSchema, TaskRunResultsPageSchema, TaskStatusSchema, WorklistProjectionSchema, } from "./work-items.js";
+export { CheckSkipReasonCodeSchema, ExternalSideEffectSummaryProjectionSchema, GetRecoverySummariesRequestSchema, GetRecoverySummariesResponseSchema, GetRecoverySummaryResponseSchema, RecoverySummaryProjectionSchema, ResultAnchorSchema, RunLineageSchema, RunResultProjectionSchema, ScratchpadProjectionSchema, ScratchpadReceiptProjectionSchema, TaskContractProjectionSchema, TaskDetailProjectionSchema, TaskDetailResultProjectionSchema, TaskModuleProjectionSchema, TaskProjectionSchema, TaskRunResultsPageSchema, TaskStatusSchema, WorklistProjectionSchema, } from "./work-items.js";
 export { ActiveApprovalProjectionSchema, ApprovalCommandProjectionSchema, ApprovalDecisionKindSchema, ApprovalDecisionOptionProjectionSchema, ApprovalDecisionToneSchema, ApprovalFileChangeProjectionSchema, ApprovalPermissionsProjectionSchema, ApprovalRequestKindSchema, ApprovalRequestProjectionSchema, ApprovalResolutionOutcomeSchema, ApprovalResolutionProjectionSchema, DecideApprovalBodySchema, DecideApprovalDispositionSchema, DecideApprovalPayloadSchema, DecideApprovalResponseSchema, DecideApprovalResultSchema, } from "./approvals.js";
 export { ActiveClarificationProjectionSchema, ClarificationChangedEventPayloadSchema, ClarificationOwnerProjectionSchema, ClarificationRequestPayloadSchema, ClarificationRoundProjectionSchema, ClarificationRoundSummaryProjectionSchema, ClarificationSuccessorRefSchema, ClarificationThreadProjectionSchema, ContextRefSchema, GetClarificationRoundMessagesRequestSchema, GetClarificationRoundResponseSchema, GetClarificationThreadResponseSchema, HumanInteractionPayloadSchema, HumanRequestPayloadSchema, SendClarificationRoundMessageBodySchema, SendClarificationRoundMessageDispositionSchema, SendClarificationRoundMessagePayloadSchema, SendClarificationRoundMessageResponseSchema, SendClarificationRoundMessageResultSchema, SubmitClarificationRoundBodySchema, SubmitClarificationRoundDispositionSchema, SubmitClarificationRoundPayloadSchema, SubmitClarificationRoundResponseSchema, SubmitClarificationRoundResultSchema, } from "./clarifications.js";
 export { GetProjectDocRequestSchema, GetProjectDocResponseSchema, GetProjectDocsResponseSchema, GetReferenceFilesRequestSchema, GetReferenceFilesResponseSchema, GetViewerAssetRequestSchema, GetViewerFileRequestSchema, GetViewerFileResponseSchema, GetViewerTreeRequestSchema, GetViewerTreeResponseSchema, ProjectDocKeySchema, ProjectDocParamsSchema, ProjectDocSummaryProjectionSchema, ReferenceDirectoryProjectionSchema, ReferenceFileProjectionSchema, ReferenceSummaryProjectionSchema, ReferenceTextReadBlockedReasonSchema, RefreshReferenceSummariesBodySchema, RefreshReferenceSummariesDispositionSchema, RefreshReferenceSummariesPayloadSchema, RefreshReferenceSummariesResponseSchema, RefreshReferenceSummariesResultSchema, UploadReferenceFileBodySchema, UploadReferenceFileDispositionSchema, UploadReferenceFilePayloadSchema, UploadReferenceFileResponseSchema, UploadReferenceFileResultSchema, ViewerAssetVariantSchema, ViewerFileContentProjectionSchema, ViewerFileProjectionSchema, ViewerPageSchema, ViewerPathSchema, ViewerRepoSnapshotSchema, ViewerTreeEntryProjectionSchema, ViewerTreeTextReadBlockedReasonSchema, ViewerUnreadableReasonSchema, } from "./viewer-reference.js";
 export { ArtifactKindSchema, ArtifactManifestPathSchema, ArtifactManifestSchema, ArtifactPreviewCommandPayloadSchema, ArtifactPreviewCommandResultSchema, ArtifactPreviewProjectionSchema, ArtifactPreviewStatusSchema, ArtifactServerManifestSchema, ArtifactStaticManifestSchema, ArtifactSummaryProjectionSchema, ArtifactTitleSchema, ArtifactProjectionSchema, GetArtifactsResponseSchema, HeartbeatArtifactPreviewBodySchema, HeartbeatArtifactPreviewDispositionSchema, HeartbeatArtifactPreviewResponseSchema, StartArtifactPreviewBodySchema, StartArtifactPreviewDispositionSchema, StartArtifactPreviewResponseSchema, StopArtifactPreviewBodySchema, StopArtifactPreviewDispositionSchema, StopArtifactPreviewResponseSchema, } from "./artifacts.js";
 export { DeleteSkillBodySchema, DeleteSkillDispositionSchema, DeleteSkillPayloadSchema, DeleteSkillResponseSchema, GetSkillParamsSchema, GetSkillResponseSchema, GetSkillsResponseSchema, ImportSkillZipBodySchema, ImportSkillZipDispositionSchema, ImportSkillZipPayloadSchema, ImportSkillZipResponseSchema, ImportSkillZipResultSchema, SkillDetailProjectionSchema, SkillNameSchema, SkillProjectionSchema, } from "./skills.js";
 export { ActivityEventProjectionSchema, ActivityEventSsePayloadSchema, ApprovalChangedEventPayloadSchema, ActivityProjectionSchema, ConnectionReadyEventPayloadSchema, ExecutionActivitySummarySchema, ExecutionStatusChangedEventPayloadSchema, ExecutionStatusKindSchema, ExecutionStatusProjectionSchema, ProcedureLaneSchema, ProviderConfigChangedEventPayloadSchema, QueryInvalidateEventPayloadSchema, ScratchpadUpdatedEventPayloadSchema, TaskDetailUpdatedEventPayloadSchema, TaskUpdatedEventPayloadSchema, WorklistChangedEventPayloadSchema, WorkspaceRecoveredEventPayloadSchema, } from "./runtime-events.js";
-export { ContextSyncBodySchema, ContextSyncDispositionSchema, ContextSyncPayloadSchema, ContextSyncResponseSchema, ContextSyncResultSchema, InitializeProjectDocsBodySchema, InitializeProjectDocsDispositionSchema, InitializeProjectDocsPayloadSchema, InitializeProjectDocsResponseSchema, InitializeProjectDocsResultSchema, ProjectDocsProcedureStartResultSchema, RefreshScratchpadDispositionSchema, RefreshScratchpadResultSchema, RunSchedulerNowBodySchema, RunSchedulerNowDispositionSchema, RunSchedulerNowPayloadSchema, RunSchedulerNowResponseSchema, SubmitWorklistBodySchema, SubmitWorklistDispositionSchema, SubmitWorklistPayloadSchema, SubmitWorklistResponseSchema, SubmitWorklistResultSchema, UpdateProjectDisplayNameBodySchema, UpdateProjectDisplayNameDispositionSchema, UpdateProjectDisplayNamePayloadSchema, UpdateProjectDisplayNameResponseSchema, UpdateProjectDisplayNameResultSchema, } from "./workspace-commands.js";
+export { ContextSyncBodySchema, ContextSyncDispositionSchema, ContextSyncPayloadSchema, ContextSyncResponseSchema, ContextSyncResultSchema, InitializeProjectDocsBodySchema, InitializeProjectDocsDispositionSchema, InitializeProjectDocsPayloadSchema, InitializeProjectDocsResponseSchema, InitializeProjectDocsResultSchema, ProjectDocsProcedureStartResultSchema, RefreshScratchpadDispositionSchema, RefreshScratchpadResultSchema, RunSchedulerNowBodySchema, RunSchedulerNowDispositionSchema, RunSchedulerNowPayloadSchema, RunSchedulerNowResponseSchema, SubmitWorklistBodySchema, SubmitWorklistDispositionSchema, SubmitWorklistPayloadSchema, SubmitWorklistResponseSchema, SubmitWorklistResultSchema, UpdateProjectDescriptionBodySchema, UpdateProjectDescriptionDispositionSchema, UpdateProjectDescriptionPayloadSchema, UpdateProjectDescriptionResponseSchema, UpdateProjectDescriptionResultSchema, UpdateProjectDisplayNameBodySchema, UpdateProjectDisplayNameDispositionSchema, UpdateProjectDisplayNamePayloadSchema, UpdateProjectDisplayNameResponseSchema, UpdateProjectDisplayNameResultSchema, } from "./workspace-commands.js";
 //# sourceMappingURL=index.js.map

package/node_modules/@tutti/shared/dist/schemas/api/runtime-events.d.ts

@@ -494,7 +494,7 @@ export declare const TaskDetailUpdatedEventPayloadSchema: import("@sinclair/type
 export declare const ScratchpadUpdatedEventPayloadSchema: import("@sinclair/typebox").TObject<{
     scratchpad: import("@sinclair/typebox").TObject<{
         id: import("@sinclair/typebox").TLiteral<"current">;
-        state: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"empty">, import("@sinclair/typebox").TLiteral<"ready">]>;
+        state: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"empty">, import("@sinclair/typebox").TLiteral<"ready">, import("@sinclair/typebox").TLiteral<"submitted">]>;
         topic: import("@sinclair/typebox").TString;
         background_summary: import("@sinclair/typebox").TString;
         current_consensus: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
@@ -502,6 +502,19 @@ export declare const ScratchpadUpdatedEventPayloadSchema: import("@sinclair/type
         task_changes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
         updated_by_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        submitted_by_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        submitted_by_workflow_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        submitted_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        receipts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            workflow_ref: import("@sinclair/typebox").TString;
+            activity_ref: import("@sinclair/typebox").TString;
+            topic: import("@sinclair/typebox").TString;
+            background_summary: import("@sinclair/typebox").TString;
+            current_consensus: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+            open_questions: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+            task_changes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+            submitted_at: import("@sinclair/typebox").TString;
+        }>>;
     }>;
     activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
 }>;

package/node_modules/@tutti/shared/dist/schemas/api/types.d.ts

@@ -7,14 +7,14 @@ import type { ProjectTimelineItemKindSchema, ProjectTimelineItemSchema, ProjectT
 import type { PresignedUploadPutSchema, RelayUploadProjectionSchema, RelayUploadPurposeSchema, Sha256DigestSchema, StagedUploadReferenceSchema, StartRelayUploadDispositionSchema, StartRelayUploadPayloadSchema, StartRelayUploadResultSchema } from "./uploads.js";
 import type { MarkReadDispositionSchema, MarkReadPayloadSchema, MarkReadResultSchema, ReadStateScopeProjectionSchema, ReadStateScopeSchema, ReadStateSummaryProjectionSchema } from "./read-state.js";
 import type { GetMessagesRequestSchema, MessageCreatedEventPayloadSchema, MessageProjectionSchema, MessageReferenceFileRefSchema, ReferenceFileCategorySchema, SendMainChatMessageCreatedDispositionSchema, SendMainChatMessageDispositionSchema, SendMainChatMessagePayloadSchema, SendMainChatMessageResultSchema, WorklistFeedbackItemSchema, WorklistFeedbackRefSchema } from "./messages.js";
-import type { CheckSkipReasonCodeSchema, ExternalSideEffectSummaryProjectionSchema, GetRecoverySummariesRequestSchema, GetRecoverySummaryResponseSchema, RecoverySummaryProjectionSchema, RunResultProjectionSchema, ScratchpadProjectionSchema, TaskContractProjectionSchema, TaskDetailProjectionSchema, TaskDetailResultProjectionSchema, TaskModuleProjectionSchema, TaskProjectionSchema, TaskStatusSchema, WorklistProjectionSchema } from "./work-items.js";
+import type { CheckSkipReasonCodeSchema, ExternalSideEffectSummaryProjectionSchema, GetRecoverySummariesRequestSchema, GetRecoverySummaryResponseSchema, RecoverySummaryProjectionSchema, RunResultProjectionSchema, ScratchpadProjectionSchema, ScratchpadReceiptProjectionSchema, TaskContractProjectionSchema, TaskDetailProjectionSchema, TaskDetailResultProjectionSchema, TaskModuleProjectionSchema, TaskProjectionSchema, TaskStatusSchema, WorklistProjectionSchema } from "./work-items.js";
 import type { ActiveApprovalProjectionSchema, ApprovalCommandProjectionSchema, ApprovalDecisionKindSchema, ApprovalDecisionOptionProjectionSchema, ApprovalFileChangeProjectionSchema, ApprovalPermissionsProjectionSchema, ApprovalRequestKindSchema, ApprovalRequestProjectionSchema, ApprovalResolutionOutcomeSchema, ApprovalResolutionProjectionSchema, DecideApprovalDispositionSchema, DecideApprovalPayloadSchema, DecideApprovalResultSchema } from "./approvals.js";
 import type { ActiveClarificationProjectionSchema, ClarificationChangedEventPayloadSchema, ClarificationOwnerProjectionSchema, ClarificationRequestPayloadSchema, ClarificationRoundProjectionSchema, ClarificationRoundSummaryProjectionSchema, ClarificationSuccessorRefSchema, ClarificationThreadProjectionSchema, ContextRefSchema, GetClarificationRoundMessagesRequestSchema, GetClarificationRoundResponseSchema, GetClarificationThreadResponseSchema, HumanInteractionPayloadSchema, HumanRequestPayloadSchema, SendClarificationRoundMessageDispositionSchema, SendClarificationRoundMessagePayloadSchema, SendClarificationRoundMessageResultSchema, SubmitClarificationRoundDispositionSchema, SubmitClarificationRoundPayloadSchema, SubmitClarificationRoundResultSchema } from "./clarifications.js";
 import type { GetProjectDocRequestSchema, GetProjectDocResponseSchema, GetProjectDocsResponseSchema, GetReferenceFilesRequestSchema, GetReferenceFilesResponseSchema, GetViewerAssetRequestSchema, GetViewerFileRequestSchema, GetViewerFileResponseSchema, GetViewerTreeRequestSchema, GetViewerTreeResponseSchema, ProjectDocKeySchema, ProjectDocParamsSchema, ProjectDocSummaryProjectionSchema, ReferenceDirectoryProjectionSchema, ReferenceFileProjectionSchema, ReferenceSummaryProjectionSchema, ReferenceTextReadBlockedReasonSchema, RefreshReferenceSummariesDispositionSchema, RefreshReferenceSummariesPayloadSchema, RefreshReferenceSummariesResultSchema, UploadReferenceFileDispositionSchema, UploadReferenceFilePayloadSchema, UploadReferenceFileResultSchema, ViewerAssetVariantSchema, ViewerFileContentProjectionSchema, ViewerFileProjectionSchema, ViewerPathSchema, ViewerRepoSnapshotSchema, ViewerTreeEntryProjectionSchema, ViewerTreeTextReadBlockedReasonSchema, ViewerUnreadableReasonSchema } from "./viewer-reference.js";
 import type { ArtifactKindSchema, ArtifactManifestPathSchema, ArtifactManifestSchema, ArtifactPreviewCommandPayloadSchema, ArtifactPreviewCommandResultSchema, ArtifactPreviewProjectionSchema, ArtifactPreviewStatusSchema, ArtifactProjectionSchema, ArtifactServerManifestSchema, ArtifactStaticManifestSchema, ArtifactSummaryProjectionSchema, GetArtifactsResponseSchema, HeartbeatArtifactPreviewDispositionSchema, StartArtifactPreviewDispositionSchema, StopArtifactPreviewDispositionSchema } from "./artifacts.js";
 import type { DeleteSkillDispositionSchema, DeleteSkillPayloadSchema, GetSkillParamsSchema, GetSkillResponseSchema, GetSkillsResponseSchema, ImportSkillZipDispositionSchema, ImportSkillZipPayloadSchema, ImportSkillZipResultSchema, SkillDetailProjectionSchema, SkillNameSchema, SkillProjectionSchema } from "./skills.js";
 import type { ActivityEventProjectionSchema, ActivityEventSsePayloadSchema, ApprovalChangedEventPayloadSchema, ActivityProjectionSchema, ConnectionReadyEventPayloadSchema, ExecutionActivitySummarySchema, ExecutionRuntimeActionSchema, ExecutionRuntimeSnapshotSchema, ExecutionRuntimeTokenUsageSchema, ExecutionStatusChangedEventPayloadSchema, ExecutionStatusKindSchema, ExecutionStatusProjectionSchema, ProcedureLaneSchema, ProviderConfigChangedEventPayloadSchema, QueryInvalidateEventPayloadSchema, ScratchpadUpdatedEventPayloadSchema, TaskDetailUpdatedEventPayloadSchema, TaskUpdatedEventPayloadSchema, WorklistChangedEventPayloadSchema, WorkspaceRecoveredEventPayloadSchema } from "./runtime-events.js";
-import type { ContextSyncDispositionSchema, ContextSyncPayloadSchema, ContextSyncResultSchema, InitializeProjectDocsDispositionSchema, InitializeProjectDocsPayloadSchema, InitializeProjectDocsResultSchema, RefreshScratchpadDispositionSchema, RefreshScratchpadResultSchema, RunSchedulerNowDispositionSchema, RunSchedulerNowPayloadSchema, SubmitWorklistDispositionSchema, SubmitWorklistPayloadSchema, SubmitWorklistResultSchema, UpdateProjectDisplayNameDispositionSchema, UpdateProjectDisplayNamePayloadSchema, UpdateProjectDisplayNameResultSchema } from "./workspace-commands.js";
+import type { ContextSyncDispositionSchema, ContextSyncPayloadSchema, ContextSyncResultSchema, InitializeProjectDocsDispositionSchema, InitializeProjectDocsPayloadSchema, InitializeProjectDocsResultSchema, RefreshScratchpadDispositionSchema, RefreshScratchpadResultSchema, RunSchedulerNowDispositionSchema, RunSchedulerNowPayloadSchema, SubmitWorklistDispositionSchema, SubmitWorklistPayloadSchema, SubmitWorklistResultSchema, UpdateProjectDescriptionDispositionSchema, UpdateProjectDescriptionPayloadSchema, UpdateProjectDescriptionResultSchema, UpdateProjectDisplayNameDispositionSchema, UpdateProjectDisplayNamePayloadSchema, UpdateProjectDisplayNameResultSchema } from "./workspace-commands.js";
 export type CursorPageRequest = Static<typeof CursorPageRequestSchema>;
 export type CursorPage<TItem> = {
     items: TItem[];
@@ -110,6 +110,7 @@ export type GetMessagesRequest = Static<typeof GetMessagesRequestSchema>;
 export type SendMainChatMessageResponse = CommandResponse<SendMainChatMessageDisposition, SendMainChatMessageResult>;
 export type MessageCreatedEventPayload = Static<typeof MessageCreatedEventPayloadSchema>;
 export type ScratchpadProjection = Static<typeof ScratchpadProjectionSchema>;
+export type ScratchpadReceiptProjection = Static<typeof ScratchpadReceiptProjectionSchema>;
 export type TaskStatus = Static<typeof TaskStatusSchema>;
 export type TaskModuleProjection = Static<typeof TaskModuleProjectionSchema>;
 export type TaskProjection = Static<typeof TaskProjectionSchema>;
@@ -216,6 +217,10 @@ export type UpdateProjectDisplayNamePayload = Static<typeof UpdateProjectDisplay
 export type UpdateProjectDisplayNameDisposition = Static<typeof UpdateProjectDisplayNameDispositionSchema>;
 export type UpdateProjectDisplayNameResult = Static<typeof UpdateProjectDisplayNameResultSchema>;
 export type UpdateProjectDisplayNameResponse = CommandResponse<UpdateProjectDisplayNameDisposition, UpdateProjectDisplayNameResult>;
+export type UpdateProjectDescriptionPayload = Static<typeof UpdateProjectDescriptionPayloadSchema>;
+export type UpdateProjectDescriptionDisposition = Static<typeof UpdateProjectDescriptionDispositionSchema>;
+export type UpdateProjectDescriptionResult = Static<typeof UpdateProjectDescriptionResultSchema>;
+export type UpdateProjectDescriptionResponse = CommandResponse<UpdateProjectDescriptionDisposition, UpdateProjectDescriptionResult>;
 export type InitializeProjectDocsPayload = Static<typeof InitializeProjectDocsPayloadSchema>;
 export type InitializeProjectDocsDisposition = Static<typeof InitializeProjectDocsDispositionSchema>;
 export type InitializeProjectDocsResult = Static<typeof InitializeProjectDocsResultSchema>;

package/node_modules/@tutti/shared/dist/schemas/api/work-items.d.ts

@@ -16,9 +16,19 @@ export declare const ResultAnchorSchema: import("@sinclair/typebox").TUnion<[imp
     kind: import("@sinclair/typebox").TLiteral<"clarification_round">;
     clarification_round_ref: import("@sinclair/typebox").TString;
 }>]>;
+export declare const ScratchpadReceiptProjectionSchema: import("@sinclair/typebox").TObject<{
+    workflow_ref: import("@sinclair/typebox").TString;
+    activity_ref: import("@sinclair/typebox").TString;
+    topic: import("@sinclair/typebox").TString;
+    background_summary: import("@sinclair/typebox").TString;
+    current_consensus: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    open_questions: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    task_changes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    submitted_at: import("@sinclair/typebox").TString;
+}>;
 export declare const ScratchpadProjectionSchema: import("@sinclair/typebox").TObject<{
     id: import("@sinclair/typebox").TLiteral<"current">;
-    state: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"empty">, import("@sinclair/typebox").TLiteral<"ready">]>;
+    state: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"empty">, import("@sinclair/typebox").TLiteral<"ready">, import("@sinclair/typebox").TLiteral<"submitted">]>;
     topic: import("@sinclair/typebox").TString;
     background_summary: import("@sinclair/typebox").TString;
     current_consensus: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
@@ -26,6 +36,19 @@ export declare const ScratchpadProjectionSchema: import("@sinclair/typebox").TOb
     task_changes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
     updated_by_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    submitted_by_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    submitted_by_workflow_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    submitted_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+    receipts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        workflow_ref: import("@sinclair/typebox").TString;
+        activity_ref: import("@sinclair/typebox").TString;
+        topic: import("@sinclair/typebox").TString;
+        background_summary: import("@sinclair/typebox").TString;
+        current_consensus: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+        open_questions: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+        task_changes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+        submitted_at: import("@sinclair/typebox").TString;
+    }>>;
 }>;
 export declare const TaskStatusSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"todo">, import("@sinclair/typebox").TLiteral<"running">, import("@sinclair/typebox").TLiteral<"pending">, import("@sinclair/typebox").TLiteral<"done">, import("@sinclair/typebox").TLiteral<"failed">]>;
 export declare const TaskModuleProjectionSchema: import("@sinclair/typebox").TObject<{

package/node_modules/@tutti/shared/dist/schemas/api/work-items.js

@@ -20,9 +20,19 @@ export const ResultAnchorSchema = Type.Union([
         clarification_round_ref: ClarificationRoundRefSchema,
     }, { additionalProperties: false }),
 ]);
+export const ScratchpadReceiptProjectionSchema = Type.Object({
+    workflow_ref: WorkflowInvocationRefSchema,
+    activity_ref: ActivityRefSchema,
+    topic: Type.String(),
+    background_summary: Type.String(),
+    current_consensus: Type.Array(Type.String()),
+    open_questions: Type.Array(Type.String()),
+    task_changes: Type.Array(Type.String()),
+    submitted_at: IsoDateTimeStringSchema,
+}, { additionalProperties: false });
 export const ScratchpadProjectionSchema = Type.Object({
     id: Type.Literal("current"),
-    state: Type.Union([Type.Literal("empty"), Type.Literal("ready")]),
+    state: Type.Union([Type.Literal("empty"), Type.Literal("ready"), Type.Literal("submitted")]),
     topic: Type.String(),
     background_summary: Type.String(),
     current_consensus: Type.Array(Type.String()),
@@ -30,6 +40,10 @@ export const ScratchpadProjectionSchema = Type.Object({
     task_changes: Type.Array(Type.String()),
     updated_by_activity_ref: Type.Optional(ActivityRefSchema),
     updated_at: Type.Optional(IsoDateTimeStringSchema),
+    submitted_by_activity_ref: Type.Optional(ActivityRefSchema),
+    submitted_by_workflow_ref: Type.Optional(WorkflowInvocationRefSchema),
+    submitted_at: Type.Optional(IsoDateTimeStringSchema),
+    receipts: Type.Array(ScratchpadReceiptProjectionSchema),
 }, { additionalProperties: false });
 export const TaskStatusSchema = Type.Union([
     Type.Literal("todo"),

package/node_modules/@tutti/shared/dist/schemas/api/workspace-commands.d.ts

@@ -20,7 +20,7 @@ export declare const RefreshScratchpadResultSchema: import("@sinclair/typebox").
     workflow_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
     scratchpad: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TObject<{
         id: import("@sinclair/typebox").TLiteral<"current">;
-        state: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"empty">, import("@sinclair/typebox").TLiteral<"ready">]>;
+        state: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"empty">, import("@sinclair/typebox").TLiteral<"ready">, import("@sinclair/typebox").TLiteral<"submitted">]>;
         topic: import("@sinclair/typebox").TString;
         background_summary: import("@sinclair/typebox").TString;
         current_consensus: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
@@ -28,6 +28,19 @@ export declare const RefreshScratchpadResultSchema: import("@sinclair/typebox").
         task_changes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
         updated_by_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        submitted_by_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        submitted_by_workflow_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        submitted_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        receipts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            workflow_ref: import("@sinclair/typebox").TString;
+            activity_ref: import("@sinclair/typebox").TString;
+            topic: import("@sinclair/typebox").TString;
+            background_summary: import("@sinclair/typebox").TString;
+            current_consensus: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+            open_questions: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+            task_changes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+            submitted_at: import("@sinclair/typebox").TString;
+        }>>;
     }>>;
 }>;
 export declare const SubmitWorklistPayloadSchema: import("@sinclair/typebox").TObject<{
@@ -44,7 +57,7 @@ export declare const SubmitWorklistDispositionSchema: import("@sinclair/typebox"
     kind: import("@sinclair/typebox").TLiteral<"stale_scratchpad">;
     current_scratchpad: import("@sinclair/typebox").TObject<{
         id: import("@sinclair/typebox").TLiteral<"current">;
-        state: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"empty">, import("@sinclair/typebox").TLiteral<"ready">]>;
+        state: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"empty">, import("@sinclair/typebox").TLiteral<"ready">, import("@sinclair/typebox").TLiteral<"submitted">]>;
         topic: import("@sinclair/typebox").TString;
         background_summary: import("@sinclair/typebox").TString;
         current_consensus: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
@@ -52,6 +65,19 @@ export declare const SubmitWorklistDispositionSchema: import("@sinclair/typebox"
         task_changes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
         updated_by_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
         updated_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        submitted_by_activity_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        submitted_by_workflow_ref: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        submitted_at: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+        receipts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            workflow_ref: import("@sinclair/typebox").TString;
+            activity_ref: import("@sinclair/typebox").TString;
+            topic: import("@sinclair/typebox").TString;
+            background_summary: import("@sinclair/typebox").TString;
+            current_consensus: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+            open_questions: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+            task_changes: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+            submitted_at: import("@sinclair/typebox").TString;
+        }>>;
     }>;
 }>, import("@sinclair/typebox").TObject<{
     kind: import("@sinclair/typebox").TLiteral<"provider_not_configured">;
@@ -121,6 +147,24 @@ export declare const UpdateProjectDisplayNameResultSchema: import("@sinclair/typ
 }>;
 export declare const UpdateProjectDisplayNameBodySchema: import("@sinclair/typebox").TSchema;
 export declare const UpdateProjectDisplayNameResponseSchema: import("@sinclair/typebox").TSchema;
+export declare const UpdateProjectDescriptionPayloadSchema: import("@sinclair/typebox").TObject<{
+    description: import("@sinclair/typebox").TString;
+}>;
+export declare const UpdateProjectDescriptionDispositionSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"updated">;
+}>, import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"unchanged">;
+}>, import("@sinclair/typebox").TObject<{
+    kind: import("@sinclair/typebox").TLiteral<"interrupted">;
+    retry_with_new_command_id: import("@sinclair/typebox").TLiteral<true>;
+}>]>;
+export declare const UpdateProjectDescriptionResultSchema: import("@sinclair/typebox").TObject<{
+    project: import("@sinclair/typebox").TObject<{
+        description: import("@sinclair/typebox").TString;
+    }>;
+}>;
+export declare const UpdateProjectDescriptionBodySchema: import("@sinclair/typebox").TSchema;
+export declare const UpdateProjectDescriptionResponseSchema: import("@sinclair/typebox").TSchema;
 export declare const InitializeProjectDocsPayloadSchema: import("@sinclair/typebox").TObject<{}>;
 export declare const InitializeProjectDocsDispositionSchema: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
     kind: import("@sinclair/typebox").TLiteral<"created">;

package/node_modules/@tutti/shared/dist/schemas/api/workspace-commands.js

@@ -99,6 +99,21 @@ export const UpdateProjectDisplayNameResultSchema = Type.Object({
 }, { additionalProperties: false });
 export const UpdateProjectDisplayNameBodySchema = commandEnvelopeSchema(UpdateProjectDisplayNamePayloadSchema);
 export const UpdateProjectDisplayNameResponseSchema = commandResponseWithResultSchema(UpdateProjectDisplayNameDispositionSchema, UpdateProjectDisplayNameResultSchema);
+export const UpdateProjectDescriptionPayloadSchema = Type.Object({
+    description: Type.String({ maxLength: 160 }),
+}, { additionalProperties: false });
+export const UpdateProjectDescriptionDispositionSchema = Type.Union([
+    Type.Object({ kind: Type.Literal("updated") }, { additionalProperties: false }),
+    Type.Object({ kind: Type.Literal("unchanged") }, { additionalProperties: false }),
+    InterruptedCommandDispositionSchema,
+]);
+export const UpdateProjectDescriptionResultSchema = Type.Object({
+    project: Type.Object({
+        description: Type.String({ maxLength: 160 }),
+    }, { additionalProperties: false }),
+}, { additionalProperties: false });
+export const UpdateProjectDescriptionBodySchema = commandEnvelopeSchema(UpdateProjectDescriptionPayloadSchema);
+export const UpdateProjectDescriptionResponseSchema = commandResponseWithResultSchema(UpdateProjectDescriptionDispositionSchema, UpdateProjectDescriptionResultSchema);
 export const InitializeProjectDocsPayloadSchema = Type.Object({}, { additionalProperties: false });
 export const InitializeProjectDocsDispositionSchema = Type.Union([
     Type.Object({ kind: Type.Literal("created") }, { additionalProperties: false }),

package/package.json

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

package/prompts/prompt-flow-map.md

@@ -24,8 +24,8 @@ Provider validation 也使用 OpenAI Responses API，但它只是启动前 crede
 - `project_context_bootstrap`：已对齐为 Codex app-server read-only + `read-project-docs` / `read-references` skills；只生成缺失 baseline context files 计划，写入仍归 `workspace-ops`。
 - `task_compile`：已对齐为 Codex app-server read-only + `read-project-docs` / `read-worklist` / `read-references` skills；Scratchpad / Worklist 紧凑视图仍作为直接权威输入，Project Docs / Worklist detail / References 仅在必要时按需读取；任务化 readiness 内聚在该 workflow 中，不新增独立 gate。
 - `context_sync`：已对齐为 Codex app-server read-only + `read-project-docs` / `read-worklist` / `read-references` skills；provider-facing direct input 为空，让 app-server 只读探索 repo，并输出 `summary` 与 `updates[].path/content`。
-- `workspace_write_run`：已对齐为 workspace-write + 精简 task contract 输入 + Project Docs / Worklist skills + user skills；存在 user skills 时通过 `skills/list.perCwdExtraUserRoots` 预热 `<TUTTI_HOME>/skills`；Reference Files 不再通过 built-in skill 暴露，若任务或项目文档指向 `docs/reference/` 中资料，Codex 可直接读取相关 repo 文件。
-- `follow_up_run`：已对齐为 workspace-write + 精简 task contract 输入 + continuation block + Project Docs / Worklist skills + user skills；存在 user skills 时同样预热 `<TUTTI_HOME>/skills` extra root；Reference Files 不再通过 built-in skill 暴露，若任务、项目文档或 clarification answer 指向 `docs/reference/` 中资料，Codex 可直接读取相关 repo 文件。
+- `workspace_write_run`：已对齐为 workspace-write + 精简 task contract 输入 + Project Docs / Worklist skills + user skills；存在 user skills 时通过 `skills/list.perCwdExtraUserRoots` 预热当前项目 `<TUTTI_HOME>/projects/<project_id>/skills`；Reference Files 不再通过 built-in skill 暴露，若任务或项目文档指向 `docs/reference/` 中资料，Codex 可直接读取相关 repo 文件。
+- `follow_up_run`：已对齐为 workspace-write + 精简 task contract 输入 + continuation block + Project Docs / Worklist skills + user skills；存在 user skills 时同样预热当前项目 `<TUTTI_HOME>/projects/<project_id>/skills` extra root；Reference Files 不再通过 built-in skill 暴露，若任务、项目文档或 clarification answer 指向 `docs/reference/` 中资料，Codex 可直接读取相关 repo 文件。
 - `pipeline_self_correction`：已对齐为 workspace-write + 精简 task contract 输入 + 精简 correction block；使用 `runs/task-retry.md` 和 `workspace_write_run` selection，在同一 active Run 记录终态前处理 no candidate diff、checks 失败、checks 修改候选或 deterministic promotion reconcile 失败等可自纠 feedback。
 - `follow_up_check`：保持 OpenAI SDK structured output；已收敛为只判断上游 `Run.needs_human` 的 task-bound answer，不接入 skill，不重查代码或协作上下文；provider-facing input 只保留精简 task contract、previous Run pause reason、原 clarification request 和 answers，provider raw output 使用 `{ result: ... }` 互斥分支，failed-task retry 从 active path 移除。
 - `reference_summary_refresh`：已对齐为 Codex app-server read-only + 单文件临时 `cwd`；workflow / activity refs、原始 path、blob、media type 和 file metadata 只留在 Control Plane 内部，不进入 prompt；provider raw output 使用 `{ result: ... }` 互斥分支，只输出 `summarized.summary` 或 `unavailable.reason`。
@@ -354,7 +354,7 @@ Provider raw 输出：根对象只包含 `result`；`result` 内二选一输出
 - `run_input_json.goal`：正式任务目标。
 - `run_input_json.scope`：正式任务边界，同时承接关键约束、非目标、假设和可观察验收信号。
 - 不传入 `context_entry_json`、task id、task summary、workflow / activity refs、Run lineage、dispatch context 或 run workspace 绝对路径。
-- 通过 `workspace_write_run` selection 可读取 Project Docs 与 Worklist，并可加载所有 enabled user skills；存在 user skills 时，app-server `skills/list` 会先收到 `<TUTTI_HOME>/skills` extra user root。
+- 通过 `workspace_write_run` selection 可读取 Project Docs 与 Worklist，并可加载所有 enabled user skills；存在 user skills 时，app-server `skills/list` 会先收到当前项目 `<TUTTI_HOME>/projects/<project_id>/skills` extra user root。
 - Reference Files 不通过 built-in skill 暴露；若任务契约或 Project Docs 指向 `docs/reference/` 中资料，Codex 可直接读取相关 repo 文件正文。
 - 不直接读取主群聊或 Scratchpad；这些不作为 hidden scope。
 
@@ -386,7 +386,7 @@ provider transient retry：如果本环节的 Codex app-server workspace-write t
 - `run_input_json.continuation.clarification.resolved_rounds[]`：截至当前 round 的已提交 task-bound clarification rounds；每轮包含 request payload 和人类回答消息原文。
 - `run_input_json.continuation.follow_up_check`：`resume` 判断的简短 summary，用于说明为什么本次可继续，但不能替代人类回答原文。
 - 不传入 `context_entry_json`、task id、task summary、workflow / activity refs、Run lineage、dispatch context 或 run workspace 绝对路径。
-- 通过 `follow_up_run` selection 可读取 Project Docs 与 Worklist，并可加载所有 enabled user skills；存在 user skills 时，app-server `skills/list` 会先收到 `<TUTTI_HOME>/skills` extra user root。
+- 通过 `follow_up_run` selection 可读取 Project Docs 与 Worklist，并可加载所有 enabled user skills；存在 user skills 时，app-server `skills/list` 会先收到当前项目 `<TUTTI_HOME>/projects/<project_id>/skills` extra user root。
 - Reference Files 不通过 built-in skill 暴露；若任务契约、Project Docs 或 clarification answer 指向 `docs/reference/` 中资料，Codex 可直接读取相关 repo 文件正文。
 - 不直接读取主群聊或 Scratchpad；这些不作为 hidden scope。
 
@@ -420,7 +420,7 @@ provider transient retry：continuation 的 retryable app-server failure 只重
 - `run_input_json.correction.guidance`：Run pipeline 根据 feedback reason 生成的本次 retry 直接修正目标。
 - `run_input_json.correction.promotion_failure?`：仅 promotion / promotion-reconcile 未能 promotion 时出现，包含机器生成 reason code 和短摘要。
 - 不传入 `context_entry_json`、task id、task summary、workflow / activity refs、Run lineage、dispatch context 或 run workspace 绝对路径。
-- 通过 `workspace_write_run` selection 可读取 Project Docs 与 Worklist，并可加载所有 enabled user skills；存在 user skills 时，app-server `skills/list` 会先收到 `<TUTTI_HOME>/skills` extra user root。
+- 通过 `workspace_write_run` selection 可读取 Project Docs 与 Worklist，并可加载所有 enabled user skills；存在 user skills 时，app-server `skills/list` 会先收到当前项目 `<TUTTI_HOME>/projects/<project_id>/skills` extra user root。
 
 输出：同初次 Task Run 的 `{ result: ... }` 互斥分支 schema。retry 不自报 `docs` 或 `changed_paths`。
 

package/prompts/skills/read-user-skills/SKILL.md

@@ -5,7 +5,7 @@ description: List and read Tutti user skills when the turn has skills scopes.
 
 # Read User Skills
 
-Use this skill when a Tutti app-server turn needs to answer questions about host machine-local user skills.
+Use this skill when a Tutti app-server turn needs to answer questions about the current project's host machine-local user skills.
 
 When a Tutti context API runtime hint is present and includes `skills:list`, list available user skills through: