@xfey/tutti 0.1.14 → 0.1.15

package/dist/server-shell/http/routes/project-api/system-routes.js

@@ -1,11 +1,11 @@
-import { UpdateProjectDisplayNameBodySchema, UpdateProjectDisplayNameResponseSchema, } from "@tutti/shared/schemas/api";
+import { UpdateProjectDescriptionBodySchema, UpdateProjectDescriptionResponseSchema, UpdateProjectDisplayNameBodySchema, UpdateProjectDisplayNameResponseSchema, } from "@tutti/shared/schemas/api";
 import { BootstrapResponseSchema, GetEventsRequestSchema, OpenApiDocumentProjectionSchema, ProviderConfigProjectionSchema, ProviderUsageProjectionSchema, SessionResponseSchema, WorkspaceResponseSchema, } from "./schemas.js";
 import { executeIdempotentCommand } from "../../../command-idempotency/index.js";
 import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
 import { openWorkspaceEventStream } from "./events-stream.js";
-import { projectDisplayNameInvalidates } from "./invalidations.js";
+import { projectMetadataInvalidates } from "./invalidations.js";
 import { buildHostProjectOpenApiDocument } from "./openapi.js";
-import { requireValidProjectDisplayNamePayload } from "./payload-validation.js";
+import { requireValidProjectDescriptionPayload, requireValidProjectDisplayNamePayload, } from "./payload-validation.js";
 import { requireHostProjectSession, requireProjectStore, } from "./session-requirements.js";
 import { buildBootstrapSnapshots, resolveWorkspaceProjection, } from "./workspace-projections.js";
 function updateProjectDisplayName(options, payload) {
@@ -24,6 +24,27 @@ function updateProjectDisplayName(options, payload) {
         result: { project: { display_name: nextName } },
     };
 }
+function updateProjectDescription(options, payload) {
+    const currentDescription = options.project.description ?? "";
+    const nextDescription = payload.description;
+    if (currentDescription === nextDescription) {
+        return {
+            disposition: { kind: "unchanged" },
+            result: { project: { description: currentDescription } },
+        };
+    }
+    options.updateProjectDescription?.(nextDescription);
+    if (nextDescription.length === 0) {
+        delete options.project.description;
+    }
+    else {
+        options.project.description = nextDescription;
+    }
+    return {
+        disposition: { kind: "updated" },
+        result: { project: { description: nextDescription } },
+    };
+}
 export function registerSystemRoutes(app, { options, workspaceEvents, }) {
     app.get(`${HOST_PROJECT_API_BASE_PATH}/openapi.json`, {
         schema: {
@@ -97,7 +118,7 @@ export function registerSystemRoutes(app, { options, workspaceEvents, }) {
             ...(options.now === undefined ? {} : { now: options.now }),
             execute: () => updateProjectDisplayName(options, payload),
         });
-        const invalidates = projectDisplayNameInvalidates();
+        const invalidates = projectMetadataInvalidates();
         const response = {
             command_id: execution.command_id,
             disposition: execution.disposition,
@@ -118,6 +139,47 @@ export function registerSystemRoutes(app, { options, workspaceEvents, }) {
         }
         return response;
     });
+    app.post(`${HOST_PROJECT_API_BASE_PATH}/workspace/project-description`, {
+        schema: {
+            body: UpdateProjectDescriptionBodySchema,
+            response: {
+                200: UpdateProjectDescriptionResponseSchema,
+            },
+        },
+    }, (request) => {
+        requireHostProjectSession(request, options);
+        const store = requireProjectStore(options);
+        const payload = requireValidProjectDescriptionPayload(request.body.payload);
+        const execution = executeIdempotentCommand({
+            db: store.db,
+            command_id: request.body.command_id,
+            command_name: "workspace.update_project_description",
+            target_ref: `project:${options.project.project_id}`,
+            payload,
+            ...(options.now === undefined ? {} : { now: options.now }),
+            execute: () => updateProjectDescription(options, payload),
+        });
+        const invalidates = projectMetadataInvalidates();
+        const response = {
+            command_id: execution.command_id,
+            disposition: execution.disposition,
+            invalidates,
+        };
+        if (execution.result !== undefined) {
+            response.result = execution.result;
+        }
+        if (!execution.replayed) {
+            workspaceEvents.publish({
+                event_type: "query.invalidate",
+                payload: {
+                    reason: "bulk_state_change",
+                    message: "Project description changed.",
+                },
+                invalidates,
+            });
+        }
+        return response;
+    });
     app.get(`${HOST_PROJECT_API_BASE_PATH}/bootstrap`, {
         schema: {
             response: {

package/dist/server-shell/http/routes/project-api/types.d.ts

@@ -75,6 +75,7 @@ export type HostProjectApiRouteOptions = {
     project: {
         project_id: ProjectId;
         display_name: string;
+        description?: string;
         identity_source: "git_config";
     };
     server: {
@@ -98,6 +99,7 @@ export type HostProjectApiRouteOptions = {
     capabilities?: Partial<Omit<HostProjectApiCapabilities, "browser_secret_write">>;
     getRepo?: () => HostRepoProjection;
     updateProjectDisplayName?: (displayName: string) => void;
+    updateProjectDescription?: (description: string) => void;
     resolveStagedUpload?: (uploadId: RelayUploadProjection["upload_id"]) => Promise<ResolvedStagedUpload>;
     workspaceOps?: {
         workspaceRoot: string;

package/dist/skills/index.d.ts

@@ -1,3 +1,4 @@
+import type { ProjectId } from "@tutti/shared/ids";
 import type { SkillDetailProjection, SkillProjection } from "@tutti/shared/schemas/api";
 import { type UserSkillImportPlan } from "./zip-import.js";
 export { MAX_SKILL_DIRECTORY_DEPTH, MAX_SKILL_FILE_BYTES, MAX_SKILL_FILE_COUNT, MAX_SKILL_TOTAL_UNCOMPRESSED_BYTES, MAX_SKILL_ZIP_BYTES, SKILL_MD_FILE_NAME, USER_SKILLS_DIRECTORY_NAME, } from "./constants.js";
@@ -25,17 +26,17 @@ export type UserSkillImportResult = {
     disposition: UserSkillImportDisposition;
     skill: SkillDetailProjection;
 };
-export declare function getUserSkillsRoot(tuttiHome: string): string;
-export declare function listUserSkills(tuttiHome: string): SkillProjection[];
-export declare function readUserSkill(tuttiHome: string, skillName: string): SkillDetailProjection;
+export declare function getProjectUserSkillsRoot(tuttiHome: string, projectId: ProjectId): string;
+export declare function listUserSkills(userSkillsRoot: string): SkillProjection[];
+export declare function readUserSkill(userSkillsRoot: string, skillName: string): SkillDetailProjection;
 export declare function importUserSkillZip(options: {
-    tuttiHome: string;
+    userSkillsRoot: string;
     zipBuffer: Buffer;
     fileName: string;
 }): Promise<UserSkillImportResult>;
 export declare function commitUserSkillImport(options: {
-    tuttiHome: string;
+    userSkillsRoot: string;
     plan: UserSkillImportPlan;
 }): UserSkillImportResult;
-export declare function deleteUserSkill(tuttiHome: string, skillName: string): UserSkillDeleteDisposition;
+export declare function deleteUserSkill(userSkillsRoot: string, skillName: string): UserSkillDeleteDisposition;
 //# sourceMappingURL=index.d.ts.map

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/node_modules/@tutti/shared/dist/schemas/api/index.d.ts

@@ -14,5 +14,5 @@ export { GetProjectDocRequestSchema, GetProjectDocResponseSchema, GetProjectDocs
 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

@@ -13,5 +13,5 @@ export { GetProjectDocRequestSchema, GetProjectDocResponseSchema, GetProjectDocs
 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/types.d.ts

@@ -14,7 +14,7 @@ import type { GetProjectDocRequestSchema, GetProjectDocResponseSchema, GetProjec
 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[];
@@ -216,6 +216,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/workspace-commands.d.ts

@@ -121,6 +121,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.15",
   "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: