@xfey/tutti 0.1.14 → 0.1.16

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

@@ -5,6 +5,7 @@ import { createProjectId, ID_PREFIXES, isPrefixedId } from "@tutti/shared/ids";
 import { LaunchError } from "./errors.js";
 export const PROJECT_ID_GIT_CONFIG_KEY = "tutti.project-id";
 export const PROJECT_DISPLAY_NAME_GIT_CONFIG_KEY = "tutti.project-display-name";
+export const PROJECT_DESCRIPTION_GIT_CONFIG_KEY = "tutti.project-description";
 function runGitRaw(args, cwd) {
     const result = spawnSync("git", [...args], {
         cwd,
@@ -76,6 +77,29 @@ export function readProjectDisplayName(workspaceRoot) {
 export function writeProjectDisplayName(workspaceRoot, displayName) {
     runGit(["config", "--local", PROJECT_DISPLAY_NAME_GIT_CONFIG_KEY, displayName], resolve(workspaceRoot));
 }
+export function readProjectDescription(workspaceRoot) {
+    const result = runGitRaw(["config", "--local", "--get", PROJECT_DESCRIPTION_GIT_CONFIG_KEY], resolve(workspaceRoot));
+    if (result.status !== 0) {
+        return null;
+    }
+    const description = result.stdout.trim();
+    return description.length === 0 ? null : description;
+}
+export function writeProjectDescription(workspaceRoot, description) {
+    const workspace = resolve(workspaceRoot);
+    const trimmedDescription = description.trim();
+    if (trimmedDescription.length === 0) {
+        const result = runGitRaw(["config", "--local", "--unset", PROJECT_DESCRIPTION_GIT_CONFIG_KEY], workspace);
+        if (result.status === 0 || result.status === 5) {
+            return;
+        }
+        const stderr = result.stderr.trim();
+        throw new LaunchError("git_bootstrap_failed", stderr.length > 0
+            ? stderr
+            : `git config --local --unset ${PROJECT_DESCRIPTION_GIT_CONFIG_KEY} failed`, "Resolve the Git error and run `tutti launch` again.");
+    }
+    runGit(["config", "--local", PROJECT_DESCRIPTION_GIT_CONFIG_KEY, trimmedDescription], workspace);
+}
 export function ensureProjectIdentity(workspaceRoot, projectId = createProjectId()) {
     const existing = readProjectIdentity(workspaceRoot);
     if (existing.kind === "present") {

package/dist/server-shell/http/routes/agent-context-shared.d.ts

@@ -31,4 +31,5 @@ export type AgentContextRouteOptions = Pick<HostProjectApiRouteOptions, "project
 export declare function requireProjectStore(options: AgentContextRouteOptions): HostProjectStore;
 export declare function requireWorkspaceRoot(options: AgentContextRouteOptions): string;
 export declare function requireTuttiHome(options: AgentContextRouteOptions): string;
+export declare function requireProjectUserSkillsRoot(options: AgentContextRouteOptions): string;
 //# sourceMappingURL=agent-context-shared.d.ts.map

package/dist/server-shell/http/routes/agent-context-shared.js

@@ -1,3 +1,4 @@
+import { getProjectUserSkillsRoot } from "../../../skills/index.js";
 import { AgentContextBadRequestError } from "./agent-context-errors.js";
 export const AGENT_CONTEXT_BASE_PATH = "/internal/agent-context";
 export const MESSAGE_LIMIT_DEFAULT = 50;
@@ -41,4 +42,7 @@ export function requireTuttiHome(options) {
     }
     return options.tuttiHome;
 }
+export function requireProjectUserSkillsRoot(options) {
+    return getProjectUserSkillsRoot(requireTuttiHome(options), options.project.project_id);
+}
 //# sourceMappingURL=agent-context-shared.js.map

package/dist/server-shell/http/routes/agent-context-skills-routes.js

@@ -3,7 +3,7 @@ import { listUserSkills, readUserSkill, SkillServiceError, } from "../../../skil
 import { authorizeAgentContextRequest } from "./agent-context-auth.js";
 import { AgentContextBadRequestError } from "./agent-context-errors.js";
 import { boundedLimit, pageByOffset, queryString, truncateText } from "./agent-context-query.js";
-import { AGENT_CONTEXT_BASE_PATH, USER_SKILLS_LIMIT_DEFAULT, USER_SKILLS_LIMIT_MAX, USER_SKILL_MD_DEFAULT_MAX_CHARS, USER_SKILL_MD_MAX_CHARS, requireTuttiHome, } from "./agent-context-shared.js";
+import { AGENT_CONTEXT_BASE_PATH, USER_SKILLS_LIMIT_DEFAULT, USER_SKILLS_LIMIT_MAX, USER_SKILL_MD_DEFAULT_MAX_CHARS, USER_SKILL_MD_MAX_CHARS, requireProjectUserSkillsRoot, } from "./agent-context-shared.js";
 function skillUnavailable(input) {
     return {
         kind: "unavailable",
@@ -37,7 +37,7 @@ export function registerAgentContextSkillRoutes(app, options) {
             max: USER_SKILLS_LIMIT_MAX,
         });
         const cursor = queryString(request.query.cursor);
-        const page = pageByOffset(listUserSkills(requireTuttiHome(options)), {
+        const page = pageByOffset(listUserSkills(requireProjectUserSkillsRoot(options)), {
             endpoint: "skills",
             ...(cursor === undefined ? {} : { cursor }),
             limit,
@@ -59,7 +59,7 @@ export function registerAgentContextSkillRoutes(app, options) {
         });
         const skillName = request.params.skillName;
         try {
-            const skill = readUserSkill(requireTuttiHome(options), skillName);
+            const skill = readUserSkill(requireProjectUserSkillsRoot(options), skillName);
             const skillMd = truncateText(redactText(skill.skill_md), maxChars);
             return {
                 kind: "skill",

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

@@ -6,5 +6,6 @@ export declare function schedulerRunNowInvalidates(disposition: RunSchedulerNowD
 export declare function clarificationRoundInvalidates(roundId: ClarificationRoundRef): QueryInvalidationHint[];
 export declare function approvalInvalidates(): QueryInvalidationHint[];
 export declare function readStateInvalidates(): QueryInvalidationHint[];
+export declare function projectMetadataInvalidates(): QueryInvalidationHint[];
 export declare function projectDisplayNameInvalidates(): QueryInvalidationHint[];
 //# sourceMappingURL=invalidations.d.ts.map

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

@@ -51,7 +51,10 @@ export function approvalInvalidates() {
 export function readStateInvalidates() {
     return [{ kind: "read_state" }, { kind: "bootstrap" }];
 }
-export function projectDisplayNameInvalidates() {
+export function projectMetadataInvalidates() {
     return [{ kind: "workspace" }, { kind: "bootstrap" }];
 }
+export function projectDisplayNameInvalidates() {
+    return projectMetadataInvalidates();
+}
 //# sourceMappingURL=invalidations.js.map

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

@@ -88,7 +88,7 @@ export declare const HOST_PROJECT_COLLABORATION_OPENAPI_ROUTES: ({
             description: string;
             schema: 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>;
@@ -96,6 +96,19 @@ export declare const HOST_PROJECT_COLLABORATION_OPENAPI_ROUTES: ({
                 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;
+                }>>;
             }>;
             contentType?: never;
         };

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

@@ -435,6 +435,10 @@ export declare const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES: ({
                                 readonly type: "string";
                                 readonly minLength: 1;
                             };
+                            readonly description: {
+                                readonly type: "string";
+                                readonly maxLength: 160;
+                            };
                             readonly identity_source: {
                                 readonly type: "string";
                                 readonly enum: readonly ["git_config"];
@@ -631,6 +635,10 @@ export declare const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES: ({
                                         readonly type: "string";
                                         readonly minLength: 1;
                                     };
+                                    readonly description: {
+                                        readonly type: "string";
+                                        readonly maxLength: 160;
+                                    };
                                     readonly identity_source: {
                                         readonly type: "string";
                                         readonly enum: readonly ["git_config"];
@@ -941,7 +949,7 @@ export declare const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES: ({
                             readonly main_chat: import("@sinclair/typebox").TSchema;
                             readonly 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>;
@@ -949,6 +957,19 @@ export declare const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES: ({
                                 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;
+                                }>>;
                             }>;
                             readonly worklist: import("@sinclair/typebox").TObject<{
                                 modules: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{

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

@@ -1,4 +1,4 @@
-import { MarkReadBodySchema, MarkReadResponseSchema, ReadStateSummaryProjectionSchema, UpdateProjectDisplayNameBodySchema, UpdateProjectDisplayNameResponseSchema, } from "@tutti/shared/schemas/api";
+import { MarkReadBodySchema, MarkReadResponseSchema, ReadStateSummaryProjectionSchema, UpdateProjectDescriptionBodySchema, UpdateProjectDescriptionResponseSchema, UpdateProjectDisplayNameBodySchema, UpdateProjectDisplayNameResponseSchema, } from "@tutti/shared/schemas/api";
 import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
 import { BootstrapResponseSchema, ProviderConfigProjectionSchema, ProviderUsageProjectionSchema, SessionResponseSchema, WorkspaceResponseSchema, } from "./schemas.js";
 export const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES = [
@@ -57,6 +57,19 @@ export const HOST_PROJECT_WORKSPACE_OPENAPI_ROUTES = [
             },
         },
     },
+    {
+        method: "post",
+        path: `${HOST_PROJECT_API_BASE_PATH}/workspace/project-description`,
+        summary: "Update the current project description.",
+        tags: ["workspace"],
+        requestBody: UpdateProjectDescriptionBodySchema,
+        responses: {
+            200: {
+                description: "Project description update command response.",
+                schema: UpdateProjectDescriptionResponseSchema,
+            },
+        },
+    },
     {
         method: "get",
         path: `${HOST_PROJECT_API_BASE_PATH}/bootstrap`,

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

@@ -250,7 +250,7 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
             description: string;
             schema: 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>;
@@ -258,6 +258,19 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                 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;
+                }>>;
             }>;
             contentType?: never;
         };
@@ -1600,6 +1613,10 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                                 readonly type: "string";
                                 readonly minLength: 1;
                             };
+                            readonly description: {
+                                readonly type: "string";
+                                readonly maxLength: 160;
+                            };
                             readonly identity_source: {
                                 readonly type: "string";
                                 readonly enum: readonly ["git_config"];
@@ -1784,6 +1801,10 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                                         readonly type: "string";
                                         readonly minLength: 1;
                                     };
+                                    readonly description: {
+                                        readonly type: "string";
+                                        readonly maxLength: 160;
+                                    };
                                     readonly identity_source: {
                                         readonly type: "string";
                                         readonly enum: readonly ["git_config"];
@@ -2094,7 +2115,7 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                             readonly main_chat: import("@sinclair/typebox").TSchema;
                             readonly 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>;
@@ -2102,6 +2123,19 @@ export declare const HOST_PROJECT_OPENAPI_ROUTES: ({
                                 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;
+                                }>>;
                             }>;
                             readonly worklist: import("@sinclair/typebox").TObject<{
                                 modules: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{

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

@@ -1,6 +1,7 @@
-import type { GetMessagesRequest, SendClarificationRoundMessagePayload, SendMainChatMessagePayload, UpdateProjectDisplayNamePayload } from "@tutti/shared/schemas/api";
+import type { GetMessagesRequest, SendClarificationRoundMessagePayload, SendMainChatMessagePayload, UpdateProjectDescriptionPayload, UpdateProjectDisplayNamePayload } from "@tutti/shared/schemas/api";
 export declare function requireValidMessageWindowRequest(query: GetMessagesRequest): GetMessagesRequest;
 export declare function requireValidSendMainChatPayload(payload: SendMainChatMessagePayload): SendMainChatMessagePayload;
 export declare function requireValidRoundMessagePayload(payload: SendClarificationRoundMessagePayload): SendClarificationRoundMessagePayload;
 export declare function requireValidProjectDisplayNamePayload(payload: UpdateProjectDisplayNamePayload): UpdateProjectDisplayNamePayload;
+export declare function requireValidProjectDescriptionPayload(payload: UpdateProjectDescriptionPayload): UpdateProjectDescriptionPayload;
 //# sourceMappingURL=payload-validation.d.ts.map

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

@@ -33,4 +33,11 @@ export function requireValidProjectDisplayNamePayload(payload) {
     }
     return { display_name: displayName };
 }
+export function requireValidProjectDescriptionPayload(payload) {
+    const description = payload.description.trim();
+    if (description.length > 160) {
+        throw new HostProjectValidationError("Project description cannot exceed 160 characters");
+    }
+    return { description };
+}
 //# sourceMappingURL=payload-validation.js.map

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

@@ -440,6 +440,10 @@ export declare const WorkspaceResponseSchema: {
                     readonly type: "string";
                     readonly minLength: 1;
                 };
+                readonly description: {
+                    readonly type: "string";
+                    readonly maxLength: 160;
+                };
                 readonly identity_source: {
                     readonly type: "string";
                     readonly enum: readonly ["git_config"];
@@ -613,6 +617,10 @@ export declare const BootstrapResponseSchema: {
                             readonly type: "string";
                             readonly minLength: 1;
                         };
+                        readonly description: {
+                            readonly type: "string";
+                            readonly maxLength: 160;
+                        };
                         readonly identity_source: {
                             readonly type: "string";
                             readonly enum: readonly ["git_config"];
@@ -923,7 +931,7 @@ export declare const BootstrapResponseSchema: {
                 readonly main_chat: import("@sinclair/typebox").TSchema;
                 readonly 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>;
@@ -931,6 +939,19 @@ export declare const BootstrapResponseSchema: {
                     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;
+                    }>>;
                 }>;
                 readonly worklist: import("@sinclair/typebox").TObject<{
                     modules: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{

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

@@ -231,6 +231,7 @@ export const WorkspaceResponseSchema = {
             properties: {
                 project_id: ProjectIdSchema,
                 display_name: { type: "string", minLength: 1 },
+                description: { type: "string", maxLength: 160 },
                 identity_source: { type: "string", enum: ["git_config"] },
             },
         },

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

@@ -2,6 +2,7 @@ import type { QueryInvalidationHint } from "@tutti/shared/schemas/api";
 import type { HostProjectApiRouteOptions } from "./types.js";
 export declare function skillsChangedInvalidates(): QueryInvalidationHint[];
 export declare function requireTuttiHome(options: HostProjectApiRouteOptions): string;
+export declare function requireProjectUserSkillsRoot(options: HostProjectApiRouteOptions): string;
 export declare function withAsyncSkillServiceErrorMapping<T>(fn: () => Promise<T>): Promise<T>;
 export declare function withSkillServiceErrorMapping<T>(fn: () => T): T;
 //# sourceMappingURL=skills-helpers.d.ts.map

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

@@ -1,4 +1,4 @@
-import { SkillServiceError } from "../../../../skills/index.js";
+import { getProjectUserSkillsRoot, SkillServiceError } from "../../../../skills/index.js";
 import { HostProjectBadRequestError, HostProjectNotFoundError, HostProjectStoreUnavailableError, HostProjectValidationError, } from "./errors.js";
 export function skillsChangedInvalidates() {
     return [{ kind: "skills" }, { kind: "read_state" }, { kind: "bootstrap" }];
@@ -9,6 +9,9 @@ export function requireTuttiHome(options) {
     }
     return options.tuttiHome;
 }
+export function requireProjectUserSkillsRoot(options) {
+    return getProjectUserSkillsRoot(requireTuttiHome(options), options.project.project_id);
+}
 function toHostProjectSkillError(error) {
     switch (error.code) {
         case "invalid_skill_name":

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

@@ -4,7 +4,7 @@ import { recordReadNotificationEvent } from "../../../../collaboration-state/ind
 import { decideCommandIdempotencyReplay, executeIdempotentCommand, readCommandIdempotencyRecord, } from "../../../command-idempotency/index.js";
 import { HOST_PROJECT_API_BASE_PATH } from "./constants.js";
 import { requireHostProjectSession, requireProjectStore } from "./session-requirements.js";
-import { requireTuttiHome, skillsChangedInvalidates, withAsyncSkillServiceErrorMapping, withSkillServiceErrorMapping, } from "./skills-helpers.js";
+import { requireProjectUserSkillsRoot, skillsChangedInvalidates, withAsyncSkillServiceErrorMapping, withSkillServiceErrorMapping, } from "./skills-helpers.js";
 import { abortDownloadedStagedUpload, cleanupDownloadedStagedUpload, downloadStagedUpload, } from "./staged-uploads.js";
 export function registerSkillRoutes(app, { options, workspaceEvents, }) {
     app.get(`${HOST_PROJECT_API_BASE_PATH}/skills`, {
@@ -16,7 +16,7 @@ export function registerSkillRoutes(app, { options, workspaceEvents, }) {
     }, (request) => {
         requireHostProjectSession(request, options);
         return withSkillServiceErrorMapping(() => ({
-            items: listUserSkills(requireTuttiHome(options)),
+            items: listUserSkills(requireProjectUserSkillsRoot(options)),
         }));
     });
     app.get(`${HOST_PROJECT_API_BASE_PATH}/skills/:skillName`, {
@@ -28,7 +28,7 @@ export function registerSkillRoutes(app, { options, workspaceEvents, }) {
     }, (request) => {
         requireHostProjectSession(request, options);
         return withSkillServiceErrorMapping(() => ({
-            skill: readUserSkill(requireTuttiHome(options), request.params.skillName),
+            skill: readUserSkill(requireProjectUserSkillsRoot(options), request.params.skillName),
         }));
     });
     app.post(`${HOST_PROJECT_API_BASE_PATH}/skills/import`, {
@@ -78,7 +78,7 @@ export function registerSkillRoutes(app, { options, workspaceEvents, }) {
                         throw new Error("Staged skill upload was not downloaded");
                     }
                     const imported = commitUserSkillImport({
-                        tuttiHome: requireTuttiHome(options),
+                        userSkillsRoot: requireProjectUserSkillsRoot(options),
                         plan,
                     });
                     recordReadNotificationEvent(tx, {
@@ -148,7 +148,7 @@ export function registerSkillRoutes(app, { options, workspaceEvents, }) {
             payload: request.body.payload,
             ...(options.now === undefined ? {} : { now: options.now }),
             execute: (tx) => withSkillServiceErrorMapping(() => {
-                const disposition = deleteUserSkill(requireTuttiHome(options), request.body.payload.skill_name);
+                const disposition = deleteUserSkill(requireProjectUserSkillsRoot(options), request.body.payload.skill_name);
                 if (disposition.kind === "deleted") {
                     recordReadNotificationEvent(tx, {
                         scope: "skills",

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