@xopcai/xopc 0.0.125 → 0.0.127

package/dist/src/projects/project-service.d.ts

@@ -1,5 +1,5 @@
 import { ProjectStore } from './project-store.js';
-import type { CreateProjectInput, Project, ProjectListQuery, ProjectListResult, ProjectWithDetails, UpdateProjectInput } from './types.js';
+import type { CreateProjectInput, Project, ProjectListQuery, ProjectListResult, ProjectWithDetails, SidebarProjectListQuery, UpdateProjectInput } from './types.js';
 import { type WorkspaceProjectMatch } from './workspace-project.js';
 export type ProjectSuggestion = {
     projectId: string;
@@ -15,6 +15,7 @@ export declare class ProjectService {
     get(id: string): Project | null;
     getBySlug(slug: string): Project | null;
     list(query?: ProjectListQuery): ProjectListResult;
+    listWithSidebarSessions(query?: SidebarProjectListQuery): ProjectListResult;
     findByWorkspaceRoot(workspaceRoot: string, options?: {
         excludeProjectId?: string;
     }): Project | null;
@@ -29,6 +30,8 @@ export declare class ProjectService {
         autoCreate?: boolean;
     }): WorkspaceProjectMatch | null;
     update(id: string, input: UpdateProjectInput): Project;
+    pin(id: string): Project;
+    unpin(id: string): Project;
     delete(id: string): void;
     getWithDetails(id: string): ProjectWithDetails | null;
     attachSession(sessionKey: string, projectId: string): void;

package/dist/src/projects/project-service.js

@@ -1,5 +1,6 @@
 import { getSessionMetadata } from "../storage/sqlite/session-repository.js";
 import "../storage/sqlite/index.js";
+import { changedFieldsFromPatch, emitActivity, systemActivityActor, systemActivitySource } from "../activity/emitter.js";
 import { ProjectStore } from "./project-store.js";
 import { bindGoalToProject, listProjectGoalIds, unbindGoalFromProject } from "./goal-bind.js";
 import { bindSessionToProject, listProjectSessionKeys, unbindSessionFromProject } from "./session-bind.js";
@@ -36,12 +37,34 @@ var ProjectService = class {
 		}
 		const name = input.name?.trim() || inferProjectNameFromWorkspaceRoot(workspaceRoot) || "";
 		const slug = input.slug?.trim() || this.store.generateSlug(name);
-		return this.store.create({
+		const project = this.store.create({
 			...input,
 			name,
 			slug,
 			workspaceRoot
 		});
+		emitActivity({
+			type: "project.created",
+			primaryObject: {
+				kind: "project",
+				id: project.id,
+				title: project.name
+			},
+			actor: systemActivityActor(),
+			source: systemActivitySource(),
+			payload: {
+				name: project.name,
+				workspaceRoot: project.workspaceRoot,
+				brief: project.brief
+			},
+			scopes: [{
+				scopeKind: "project",
+				scopeId: project.id,
+				reason: "object_owner"
+			}],
+			nowMs: project.createdAt
+		});
+		return project;
 	}
 	get(id) {
 		return this.store.get(id);
@@ -52,6 +75,9 @@ var ProjectService = class {
 	list(query) {
 		return this.store.list(query);
 	}
+	listWithSidebarSessions(query) {
+		return this.store.listWithSidebarSessions(query);
+	}
 	findByWorkspaceRoot(workspaceRoot, options = {}) {
 		const target = canonicalWorkspacePath(workspaceRoot);
 		if (!target) return null;
@@ -118,7 +144,44 @@ var ProjectService = class {
 			else throw new ProjectWorkspaceMissingError(workspaceRoot);
 			patch.workspaceRoot = workspaceRoot;
 		}
-		return this.store.update(id, patch);
+		const before = this.store.get(id);
+		const project = this.store.update(id, patch);
+		const changes = changedFieldsFromPatch(patch, ["createWorkspaceRoot"]);
+		const type = before?.status !== project.status ? "project.status_changed" : before?.workspaceRoot !== project.workspaceRoot ? "project.workspace_changed" : "project.updated";
+		emitActivity({
+			type,
+			primaryObject: {
+				kind: "project",
+				id: project.id,
+				title: project.name
+			},
+			actor: systemActivityActor(),
+			source: systemActivitySource(),
+			payload: {
+				changes,
+				...type === "project.status_changed" ? {
+					from: before?.status,
+					to: project.status
+				} : {},
+				...type === "project.workspace_changed" ? {
+					from: before?.workspaceRoot,
+					to: project.workspaceRoot
+				} : {}
+			},
+			scopes: [{
+				scopeKind: "project",
+				scopeId: project.id,
+				reason: "object_owner"
+			}],
+			nowMs: project.updatedAt
+		});
+		return project;
+	}
+	pin(id) {
+		return this.update(id, { pinnedAt: Date.now() });
+	}
+	unpin(id) {
+		return this.update(id, { pinnedAt: null });
 	}
 	delete(id) {
 		this.store.delete(id);

package/dist/src/projects/project-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-service.js","names":[],"sources":["../../../src/projects/project-service.ts"],"sourcesContent":["import { getSessionMetadata } from '../storage/sqlite/index.js';\nimport { ProjectStore } from './project-store.js';\nimport { bindGoalToProject, listProjectGoalIds, unbindGoalFromProject } from './goal-bind.js';\nimport { bindSessionToProject, listProjectSessionKeys, unbindSessionFromProject } from './session-bind.js';\nimport type { CreateProjectInput, Project, ProjectListQuery, ProjectListResult, ProjectWithDetails, UpdateProjectInput } from './types.js';\nimport {\n  canonicalWorkspacePath,\n  ensureWorkspaceDirectory,\n  inferProjectNameFromWorkspaceRoot,\n  isPathSameOrInsideWorkspace,\n  isSafeAutoCreateWorkspaceRoot,\n  ProjectWorkspaceConflictError,\n  ProjectWorkspaceMissingError,\n  resolveWorkspaceProjectRoot,\n  workspaceDirectoryExists,\n  type WorkspaceProjectMatch,\n} from './workspace-project.js';\n\nexport type ProjectSuggestion = {\n  projectId: string;\n  projectName: string;\n  score: number;\n  reason: string;\n};\n\nexport class ProjectService {\n  constructor(private readonly store = new ProjectStore()) {}\n\n  private listAllProjects(): Project[] {\n    const items: Project[] = [];\n    let offset = 0;\n    const limit = 500;\n    while (true) {\n      const page = this.list({ limit, offset });\n      items.push(...page.items);\n      if (!page.hasMore || page.items.length === 0) break;\n      offset += page.items.length;\n    }\n    return items;\n  }\n\n  create(input: CreateProjectInput): Project {\n    const rawWorkspaceRoot = input.workspaceRoot?.trim();\n    const workspaceRoot = rawWorkspaceRoot ? canonicalWorkspacePath(rawWorkspaceRoot) : undefined;\n    if (rawWorkspaceRoot && !workspaceRoot) {\n      throw new Error('Invalid workspace root');\n    }\n    if (workspaceRoot) {\n      const existing = this.findByWorkspaceRoot(workspaceRoot);\n      if (existing) throw new ProjectWorkspaceConflictError(existing);\n      if (!workspaceDirectoryExists(workspaceRoot)) {\n        if (input.createWorkspaceRoot === true) {\n          ensureWorkspaceDirectory(workspaceRoot);\n        } else {\n          throw new ProjectWorkspaceMissingError(workspaceRoot);\n        }\n      }\n    }\n    const name = input.name?.trim() || inferProjectNameFromWorkspaceRoot(workspaceRoot) || '';\n    const slug = input.slug?.trim() || this.store.generateSlug(name);\n    return this.store.create({ ...input, name, slug, workspaceRoot });\n  }\n\n  get(id: string): Project | null {\n    return this.store.get(id);\n  }\n\n  getBySlug(slug: string): Project | null {\n    return this.store.findBySlug(slug);\n  }\n\n  list(query?: ProjectListQuery): ProjectListResult {\n    return this.store.list(query);\n  }\n\n  findByWorkspaceRoot(workspaceRoot: string, options: { excludeProjectId?: string } = {}): Project | null {\n    const target = canonicalWorkspacePath(workspaceRoot);\n    if (!target) return null;\n    for (const project of this.listAllProjects()) {\n      if (options.excludeProjectId && project.id === options.excludeProjectId) continue;\n      const projectRoot = canonicalWorkspacePath(project.workspaceRoot);\n      if (projectRoot && isPathSameOrInsideWorkspace(projectRoot, target) && isPathSameOrInsideWorkspace(target, projectRoot)) {\n        return project;\n      }\n    }\n    return null;\n  }\n\n  resolveForWorkspacePath(workspacePath: string): { project: Project; reason: 'exact' | 'contained' } | null {\n    const target = canonicalWorkspacePath(workspacePath);\n    if (!target) return null;\n    let best: { project: Project; root: string; reason: 'exact' | 'contained' } | null = null;\n    for (const project of this.listAllProjects()) {\n      const root = canonicalWorkspacePath(project.workspaceRoot);\n      if (!root || !isPathSameOrInsideWorkspace(root, target)) continue;\n      const reason = isPathSameOrInsideWorkspace(root, target) && isPathSameOrInsideWorkspace(target, root) ? 'exact' : 'contained';\n      if (!best || root.length > best.root.length) {\n        best = { project, root, reason };\n      }\n    }\n    return best ? { project: best.project, reason: best.reason } : null;\n  }\n\n  resolveOrCreateForWorkspacePath(input: {\n    workspacePath: string;\n    agentId?: string;\n    defaultAgentId?: string;\n    autoCreate?: boolean;\n  }): WorkspaceProjectMatch | null {\n    const existing = this.resolveForWorkspacePath(input.workspacePath);\n    if (existing) return { project: existing.project, reason: existing.reason, created: false };\n    if (!input.autoCreate) return null;\n    const workspaceRoot = resolveWorkspaceProjectRoot(input.workspacePath) ?? canonicalWorkspacePath(input.workspacePath);\n    if (!workspaceRoot || !isSafeAutoCreateWorkspaceRoot(workspaceRoot)) return null;\n    const rootExisting = this.resolveForWorkspacePath(workspaceRoot);\n    if (rootExisting) return { project: rootExisting.project, reason: rootExisting.reason, created: false };\n    const project = this.create({\n      name: inferProjectNameFromWorkspaceRoot(workspaceRoot) ?? undefined,\n      workspaceRoot,\n      defaultAgentId: Object.hasOwn(input, 'defaultAgentId') ? input.defaultAgentId : input.agentId,\n    });\n    return { project, reason: 'auto_created', created: true };\n  }\n\n  update(id: string, input: UpdateProjectInput): Project {\n    const patch = { ...input };\n    if (input.workspaceRoot !== undefined && input.workspaceRoot !== null && input.workspaceRoot.trim()) {\n      const workspaceRoot = canonicalWorkspacePath(input.workspaceRoot);\n      if (!workspaceRoot) {\n        throw new Error('Invalid workspace root');\n      }\n      const existing = this.findByWorkspaceRoot(workspaceRoot, { excludeProjectId: id });\n      if (existing) throw new ProjectWorkspaceConflictError(existing);\n      if (!workspaceDirectoryExists(workspaceRoot)) {\n        if (input.createWorkspaceRoot === true) {\n          ensureWorkspaceDirectory(workspaceRoot);\n        } else {\n          throw new ProjectWorkspaceMissingError(workspaceRoot);\n        }\n      }\n      patch.workspaceRoot = workspaceRoot;\n    }\n    return this.store.update(id, patch);\n  }\n\n  delete(id: string): void {\n    this.store.delete(id);\n  }\n\n  getWithDetails(id: string): ProjectWithDetails | null {\n    return this.store.getWithDetails(id);\n  }\n\n  attachSession(sessionKey: string, projectId: string): void {\n    bindSessionToProject(sessionKey, projectId);\n  }\n\n  detachSession(sessionKey: string): void {\n    unbindSessionFromProject(sessionKey);\n  }\n\n  listSessionKeys(projectId: string, limit?: number, offset?: number): string[] {\n    return listProjectSessionKeys(projectId, limit, offset);\n  }\n\n  attachGoal(goalId: string, projectId: string): void {\n    bindGoalToProject(goalId, projectId);\n  }\n\n  detachGoal(goalId: string): void {\n    unbindGoalFromProject(goalId);\n  }\n\n  listGoalIds(projectId: string, limit?: number, offset?: number): string[] {\n    return listProjectGoalIds(projectId, limit, offset);\n  }\n\n  suggestProjectsForSession(sessionKey: string): ProjectSuggestion[] {\n    const session = getSessionMetadata(sessionKey);\n    if (!session) return [];\n    const projects = this.list({ status: 'active', limit: 500 }).items;\n    const haystack = [session.key, session.name, session.routing?.agentId, session.sourceChannel, ...(session.tags ?? [])]\n      .filter(Boolean)\n      .join(' ')\n      .toLowerCase();\n    const suggestions: ProjectSuggestion[] = [];\n    for (const project of projects) {\n      let score = 0;\n      const reasons: string[] = [];\n      if (haystack.includes(project.slug.toLowerCase())) {\n        score += 10;\n        reasons.push('session metadata matches project slug');\n      }\n      for (const token of project.name.toLowerCase().split(/\\s+/).filter((t) => t.length >= 3)) {\n        if (haystack.includes(token)) {\n          score += 3;\n          reasons.push(`matches ${token}`);\n          break;\n        }\n      }\n      if (score > 0) {\n        suggestions.push({ projectId: project.id, projectName: project.name, score, reason: reasons.join(', ') });\n      }\n    }\n    return suggestions.sort((a, b) => b.score - a.score).slice(0, 5);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"project-service.js","names":[],"sources":["../../../src/projects/project-service.ts"],"sourcesContent":["import { changedFieldsFromPatch, emitActivity, systemActivityActor, systemActivitySource } from '../activity/emitter.js';\nimport { getSessionMetadata } from '../storage/sqlite/index.js';\nimport { ProjectStore } from './project-store.js';\nimport { bindGoalToProject, listProjectGoalIds, unbindGoalFromProject } from './goal-bind.js';\nimport { bindSessionToProject, listProjectSessionKeys, unbindSessionFromProject } from './session-bind.js';\nimport type { CreateProjectInput, Project, ProjectListQuery, ProjectListResult, ProjectWithDetails, SidebarProjectListQuery, UpdateProjectInput } from './types.js';\nimport {\n  canonicalWorkspacePath,\n  ensureWorkspaceDirectory,\n  inferProjectNameFromWorkspaceRoot,\n  isPathSameOrInsideWorkspace,\n  isSafeAutoCreateWorkspaceRoot,\n  ProjectWorkspaceConflictError,\n  ProjectWorkspaceMissingError,\n  resolveWorkspaceProjectRoot,\n  workspaceDirectoryExists,\n  type WorkspaceProjectMatch,\n} from './workspace-project.js';\n\nexport type ProjectSuggestion = {\n  projectId: string;\n  projectName: string;\n  score: number;\n  reason: string;\n};\n\nexport class ProjectService {\n  constructor(private readonly store = new ProjectStore()) {}\n\n  private listAllProjects(): Project[] {\n    const items: Project[] = [];\n    let offset = 0;\n    const limit = 500;\n    while (true) {\n      const page = this.list({ limit, offset });\n      items.push(...page.items);\n      if (!page.hasMore || page.items.length === 0) break;\n      offset += page.items.length;\n    }\n    return items;\n  }\n\n  create(input: CreateProjectInput): Project {\n    const rawWorkspaceRoot = input.workspaceRoot?.trim();\n    const workspaceRoot = rawWorkspaceRoot ? canonicalWorkspacePath(rawWorkspaceRoot) : undefined;\n    if (rawWorkspaceRoot && !workspaceRoot) {\n      throw new Error('Invalid workspace root');\n    }\n    if (workspaceRoot) {\n      const existing = this.findByWorkspaceRoot(workspaceRoot);\n      if (existing) throw new ProjectWorkspaceConflictError(existing);\n      if (!workspaceDirectoryExists(workspaceRoot)) {\n        if (input.createWorkspaceRoot === true) {\n          ensureWorkspaceDirectory(workspaceRoot);\n        } else {\n          throw new ProjectWorkspaceMissingError(workspaceRoot);\n        }\n      }\n    }\n    const name = input.name?.trim() || inferProjectNameFromWorkspaceRoot(workspaceRoot) || '';\n    const slug = input.slug?.trim() || this.store.generateSlug(name);\n    const project = this.store.create({ ...input, name, slug, workspaceRoot });\n    emitActivity({\n      type: 'project.created',\n      primaryObject: { kind: 'project', id: project.id, title: project.name },\n      actor: systemActivityActor(),\n      source: systemActivitySource(),\n      payload: {\n        name: project.name,\n        workspaceRoot: project.workspaceRoot,\n        brief: project.brief,\n      },\n      scopes: [{ scopeKind: 'project', scopeId: project.id, reason: 'object_owner' }],\n      nowMs: project.createdAt,\n    });\n    return project;\n  }\n\n  get(id: string): Project | null {\n    return this.store.get(id);\n  }\n\n  getBySlug(slug: string): Project | null {\n    return this.store.findBySlug(slug);\n  }\n\n  list(query?: ProjectListQuery): ProjectListResult {\n    return this.store.list(query);\n  }\n\n  listWithSidebarSessions(query?: SidebarProjectListQuery): ProjectListResult {\n    return this.store.listWithSidebarSessions(query);\n  }\n\n  findByWorkspaceRoot(workspaceRoot: string, options: { excludeProjectId?: string } = {}): Project | null {\n    const target = canonicalWorkspacePath(workspaceRoot);\n    if (!target) return null;\n    for (const project of this.listAllProjects()) {\n      if (options.excludeProjectId && project.id === options.excludeProjectId) continue;\n      const projectRoot = canonicalWorkspacePath(project.workspaceRoot);\n      if (projectRoot && isPathSameOrInsideWorkspace(projectRoot, target) && isPathSameOrInsideWorkspace(target, projectRoot)) {\n        return project;\n      }\n    }\n    return null;\n  }\n\n  resolveForWorkspacePath(workspacePath: string): { project: Project; reason: 'exact' | 'contained' } | null {\n    const target = canonicalWorkspacePath(workspacePath);\n    if (!target) return null;\n    let best: { project: Project; root: string; reason: 'exact' | 'contained' } | null = null;\n    for (const project of this.listAllProjects()) {\n      const root = canonicalWorkspacePath(project.workspaceRoot);\n      if (!root || !isPathSameOrInsideWorkspace(root, target)) continue;\n      const reason = isPathSameOrInsideWorkspace(root, target) && isPathSameOrInsideWorkspace(target, root) ? 'exact' : 'contained';\n      if (!best || root.length > best.root.length) {\n        best = { project, root, reason };\n      }\n    }\n    return best ? { project: best.project, reason: best.reason } : null;\n  }\n\n  resolveOrCreateForWorkspacePath(input: {\n    workspacePath: string;\n    agentId?: string;\n    defaultAgentId?: string;\n    autoCreate?: boolean;\n  }): WorkspaceProjectMatch | null {\n    const existing = this.resolveForWorkspacePath(input.workspacePath);\n    if (existing) return { project: existing.project, reason: existing.reason, created: false };\n    if (!input.autoCreate) return null;\n    const workspaceRoot = resolveWorkspaceProjectRoot(input.workspacePath) ?? canonicalWorkspacePath(input.workspacePath);\n    if (!workspaceRoot || !isSafeAutoCreateWorkspaceRoot(workspaceRoot)) return null;\n    const rootExisting = this.resolveForWorkspacePath(workspaceRoot);\n    if (rootExisting) return { project: rootExisting.project, reason: rootExisting.reason, created: false };\n    const project = this.create({\n      name: inferProjectNameFromWorkspaceRoot(workspaceRoot) ?? undefined,\n      workspaceRoot,\n      defaultAgentId: Object.hasOwn(input, 'defaultAgentId') ? input.defaultAgentId : input.agentId,\n    });\n    return { project, reason: 'auto_created', created: true };\n  }\n\n  update(id: string, input: UpdateProjectInput): Project {\n    const patch = { ...input };\n    if (input.workspaceRoot !== undefined && input.workspaceRoot !== null && input.workspaceRoot.trim()) {\n      const workspaceRoot = canonicalWorkspacePath(input.workspaceRoot);\n      if (!workspaceRoot) {\n        throw new Error('Invalid workspace root');\n      }\n      const existing = this.findByWorkspaceRoot(workspaceRoot, { excludeProjectId: id });\n      if (existing) throw new ProjectWorkspaceConflictError(existing);\n      if (!workspaceDirectoryExists(workspaceRoot)) {\n        if (input.createWorkspaceRoot === true) {\n          ensureWorkspaceDirectory(workspaceRoot);\n        } else {\n          throw new ProjectWorkspaceMissingError(workspaceRoot);\n        }\n      }\n      patch.workspaceRoot = workspaceRoot;\n    }\n    const before = this.store.get(id);\n    const project = this.store.update(id, patch);\n    const changes = changedFieldsFromPatch(patch as Record<string, unknown>, ['createWorkspaceRoot']);\n    const type = before?.status !== project.status\n      ? 'project.status_changed'\n      : before?.workspaceRoot !== project.workspaceRoot\n        ? 'project.workspace_changed'\n        : 'project.updated';\n    emitActivity({\n      type,\n      primaryObject: { kind: 'project', id: project.id, title: project.name },\n      actor: systemActivityActor(),\n      source: systemActivitySource(),\n      payload: {\n        changes,\n        ...(type === 'project.status_changed' ? { from: before?.status, to: project.status } : {}),\n        ...(type === 'project.workspace_changed' ? { from: before?.workspaceRoot, to: project.workspaceRoot } : {}),\n      },\n      scopes: [{ scopeKind: 'project', scopeId: project.id, reason: 'object_owner' }],\n      nowMs: project.updatedAt,\n    });\n    return project;\n  }\n\n  pin(id: string): Project {\n    return this.update(id, { pinnedAt: Date.now() });\n  }\n\n  unpin(id: string): Project {\n    return this.update(id, { pinnedAt: null });\n  }\n\n  delete(id: string): void {\n    this.store.delete(id);\n  }\n\n  getWithDetails(id: string): ProjectWithDetails | null {\n    return this.store.getWithDetails(id);\n  }\n\n  attachSession(sessionKey: string, projectId: string): void {\n    bindSessionToProject(sessionKey, projectId);\n  }\n\n  detachSession(sessionKey: string): void {\n    unbindSessionFromProject(sessionKey);\n  }\n\n  listSessionKeys(projectId: string, limit?: number, offset?: number): string[] {\n    return listProjectSessionKeys(projectId, limit, offset);\n  }\n\n  attachGoal(goalId: string, projectId: string): void {\n    bindGoalToProject(goalId, projectId);\n  }\n\n  detachGoal(goalId: string): void {\n    unbindGoalFromProject(goalId);\n  }\n\n  listGoalIds(projectId: string, limit?: number, offset?: number): string[] {\n    return listProjectGoalIds(projectId, limit, offset);\n  }\n\n  suggestProjectsForSession(sessionKey: string): ProjectSuggestion[] {\n    const session = getSessionMetadata(sessionKey);\n    if (!session) return [];\n    const projects = this.list({ status: 'active', limit: 500 }).items;\n    const haystack = [session.key, session.name, session.routing?.agentId, session.sourceChannel, ...(session.tags ?? [])]\n      .filter(Boolean)\n      .join(' ')\n      .toLowerCase();\n    const suggestions: ProjectSuggestion[] = [];\n    for (const project of projects) {\n      let score = 0;\n      const reasons: string[] = [];\n      if (haystack.includes(project.slug.toLowerCase())) {\n        score += 10;\n        reasons.push('session metadata matches project slug');\n      }\n      for (const token of project.name.toLowerCase().split(/\\s+/).filter((t) => t.length >= 3)) {\n        if (haystack.includes(token)) {\n          score += 3;\n          reasons.push(`matches ${token}`);\n          break;\n        }\n      }\n      if (score > 0) {\n        suggestions.push({ projectId: project.id, projectName: project.name, score, reason: reasons.join(', ') });\n      }\n    }\n    return suggestions.sort((a, b) => b.score - a.score).slice(0, 5);\n  }\n}\n"],"mappings":"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"}

package/dist/src/projects/project-store.d.ts

@@ -1,4 +1,4 @@
-import type { CreateProjectInput, Project, ProjectListQuery, ProjectListResult, ProjectWithDetails, UpdateProjectInput } from './types.js';
+import type { CreateProjectInput, Project, ProjectListQuery, ProjectListResult, SidebarProjectListQuery, ProjectWithDetails, UpdateProjectInput } from './types.js';
 export type ProjectRow = {
     project_id: string;
     name: string;
@@ -12,6 +12,7 @@ export type ProjectRow = {
     created_at: number;
     updated_at: number;
     last_active_at: number | null;
+    pinned_at: number | null;
 };
 export declare function slugifyProjectName(name: string): string;
 export declare class ProjectStore {
@@ -19,6 +20,7 @@ export declare class ProjectStore {
     get(id: string): Project | null;
     findBySlug(slug: string): Project | null;
     list(query?: ProjectListQuery): ProjectListResult;
+    listWithSidebarSessions(query?: SidebarProjectListQuery): ProjectListResult;
     update(id: string, input: UpdateProjectInput): Project;
     delete(id: string): void;
     getSessionCount(id: string): number;

package/dist/src/projects/project-store.js

@@ -23,7 +23,8 @@ function projectFromRow(row) {
 		instructions: row.instructions ?? void 0,
 		createdAt: row.created_at,
 		updatedAt: row.updated_at,
-		lastActiveAt: row.last_active_at ?? void 0
+		lastActiveAt: row.last_active_at ?? void 0,
+		pinnedAt: row.pinned_at ?? void 0
 	};
 }
 function clampLimit(limit, fallback = 50) {
@@ -80,13 +81,14 @@ var ProjectStore = class {
 			instructions: trimOptional(input.instructions),
 			createdAt: now,
 			updatedAt: now,
-			lastActiveAt: now
+			lastActiveAt: now,
+			pinnedAt: void 0
 		};
 		runSqliteWriteTransaction((db) => {
 			db.prepare(`INSERT INTO projects (
           project_id, name, slug, description, status, default_agent_id, workspace_root,
-          brief, instructions, created_at, updated_at, last_active_at
-        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(project.id, project.name, project.slug, project.description ?? null, project.status, project.defaultAgentId ?? null, project.workspaceRoot ?? null, project.brief ?? null, project.instructions ?? null, project.createdAt, project.updatedAt, project.lastActiveAt ?? null);
+          brief, instructions, created_at, updated_at, last_active_at, pinned_at
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(project.id, project.name, project.slug, project.description ?? null, project.status, project.defaultAgentId ?? null, project.workspaceRoot ?? null, project.brief ?? null, project.instructions ?? null, project.createdAt, project.updatedAt, project.lastActiveAt ?? null, project.pinnedAt ?? null);
 			syncProjectFts(db, project);
 		});
 		return project;
@@ -128,6 +130,53 @@ var ProjectStore = class {
 			hasMore: offset + limit < total
 		};
 	}
+	listWithSidebarSessions(query = {}) {
+		const projectConditions = [];
+		const sessionConditions = [`s.hidden_from_session_list = 0`, `s.session_type = 'chat'`];
+		const params = [];
+		if (query.status) {
+			const statuses = Array.isArray(query.status) ? query.status : [query.status];
+			projectConditions.push(`p.status IN (${statuses.map(() => "?").join(", ")})`);
+			params.push(...statuses);
+		}
+		if (query.updatedAfter !== void 0) {
+			const clauses = [`s.updated_at >= ?`];
+			params.push(query.updatedAfter);
+			if (query.includePinned) clauses.push(`s.status = 'pinned'`);
+			const includeSessionKey = query.includeSessionKey?.trim();
+			if (includeSessionKey) {
+				clauses.push(`s.session_key = ?`);
+				params.push(includeSessionKey);
+			}
+			sessionConditions.push(`(${clauses.join(" OR ")})`);
+		}
+		const whereParts = [...projectConditions, ...sessionConditions];
+		const where = whereParts.length ? `WHERE ${whereParts.join(" AND ")}` : "";
+		const limit = clampLimit(query.limit, 50);
+		const offset = Math.max(0, Math.floor(query.offset ?? 0));
+		const db = getSqliteDatabase();
+		const total = db.prepare(`SELECT COUNT(DISTINCT p.project_id) AS total
+         FROM projects p
+         JOIN sessions s ON s.project_id = p.project_id
+         ${where}`).get(...params).total;
+		return {
+			items: db.prepare(`SELECT p.*, MAX(s.updated_at) AS latest_session_at
+         FROM projects p
+         JOIN sessions s ON s.project_id = p.project_id
+         ${where}
+         GROUP BY p.project_id
+         ORDER BY
+           CASE WHEN p.pinned_at IS NULL THEN 1 ELSE 0 END ASC,
+           p.pinned_at DESC,
+           latest_session_at DESC,
+           p.updated_at DESC
+         LIMIT ? OFFSET ?`).all(...params, limit, offset).map(projectFromRow),
+			total,
+			limit,
+			offset,
+			hasMore: offset + limit < total
+		};
+	}
 	update(id, input) {
 		const before = this.get(id);
 		if (!before) throw new Error(`Project not found: ${id}`);
@@ -140,12 +189,13 @@ var ProjectStore = class {
 			...input.workspaceRoot !== void 0 ? { workspaceRoot: nullableText(input.workspaceRoot) ?? void 0 } : {},
 			...input.brief !== void 0 ? { brief: nullableText(input.brief) ?? void 0 } : {},
 			...input.instructions !== void 0 ? { instructions: nullableText(input.instructions) ?? void 0 } : {},
+			...input.pinnedAt !== void 0 ? { pinnedAt: input.pinnedAt ?? void 0 } : {},
 			updatedAt: Date.now()
 		};
 		runSqliteWriteTransaction((db) => {
 			db.prepare(`UPDATE projects SET
-          name = ?, description = ?, status = ?, default_agent_id = ?, workspace_root = ?, brief = ?, instructions = ?, updated_at = ?
-         WHERE project_id = ?`).run(next.name, next.description ?? null, next.status, next.defaultAgentId ?? null, next.workspaceRoot ?? null, next.brief ?? null, next.instructions ?? null, next.updatedAt, id);
+          name = ?, description = ?, status = ?, default_agent_id = ?, workspace_root = ?, brief = ?, instructions = ?, pinned_at = ?, updated_at = ?
+         WHERE project_id = ?`).run(next.name, next.description ?? null, next.status, next.defaultAgentId ?? null, next.workspaceRoot ?? null, next.brief ?? null, next.instructions ?? null, next.pinnedAt ?? null, next.updatedAt, id);
 			syncProjectFts(db, next);
 		});
 		return this.get(id);

package/dist/src/projects/project-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"project-store.js","names":[],"sources":["../../../src/projects/project-store.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { escapeFts5Query } from '../storage/sqlite/fts.js';\nimport { getSqliteDatabase, runSqliteWriteTransaction } from '../storage/sqlite/transaction.js';\nimport type {\n  CreateProjectInput,\n  Project,\n  ProjectListQuery,\n  ProjectListResult,\n  ProjectStatus,\n  ProjectWithDetails,\n  UpdateProjectInput,\n} from './types.js';\n\nexport type ProjectRow = {\n  project_id: string;\n  name: string;\n  slug: string;\n  description: string | null;\n  status: string;\n  default_agent_id: string | null;\n  workspace_root: string | null;\n  brief: string | null;\n  instructions: string | null;\n  created_at: number;\n  updated_at: number;\n  last_active_at: number | null;\n};\n\nfunction trimOptional(value: string | null | undefined): string | undefined {\n  if (value == null) return undefined;\n  const trimmed = value.trim();\n  return trimmed || undefined;\n}\n\nfunction nullableText(value: string | null | undefined): string | null {\n  if (value == null) return null;\n  const trimmed = value.trim();\n  return trimmed || null;\n}\n\nfunction projectFromRow(row: ProjectRow): Project {\n  return {\n    id: row.project_id,\n    name: row.name,\n    slug: row.slug,\n    description: row.description ?? undefined,\n    status: row.status as ProjectStatus,\n    defaultAgentId: row.default_agent_id ?? undefined,\n    workspaceRoot: row.workspace_root ?? undefined,\n    brief: row.brief ?? undefined,\n    instructions: row.instructions ?? undefined,\n    createdAt: row.created_at,\n    updatedAt: row.updated_at,\n    lastActiveAt: row.last_active_at ?? undefined,\n  };\n}\n\nfunction clampLimit(limit: number | undefined, fallback = 50): number {\n  return Math.min(500, Math.max(1, Math.floor(limit ?? fallback)));\n}\n\nfunction normalizeName(name: string): string {\n  const trimmed = name.trim();\n  if (!trimmed) throw new Error('Project name is required');\n  return trimmed;\n}\n\nexport function slugifyProjectName(name: string): string {\n  const slug = name\n    .trim()\n    .toLowerCase()\n    .normalize('NFKD')\n    .replace(/[\\u0300-\\u036f]/g, '')\n    .replace(/[^\\p{L}\\p{N}]+/gu, '-')\n    .replace(/^-+|-+$/g, '')\n    .slice(0, 80);\n  return slug || `project-${Date.now()}`;\n}\n\nfunction projectSortColumn(sortBy: ProjectListQuery['sortBy']): string {\n  switch (sortBy) {\n    case 'createdAt':\n      return 'created_at';\n    case 'name':\n      return 'LOWER(name)';\n    case 'updatedAt':\n    default:\n      return 'updated_at';\n  }\n}\n\nfunction projectSortExpression(sortBy: ProjectListQuery['sortBy']): string {\n  const column = projectSortColumn(sortBy);\n  return column === 'LOWER(name)' ? 'LOWER(p.name)' : `p.${column}`;\n}\n\nfunction projectFtsContent(project: Project): string {\n  return [\n    project.name,\n    project.slug,\n    project.description,\n    project.workspaceRoot,\n    project.brief,\n    project.instructions,\n    project.defaultAgentId,\n  ]\n    .filter((value): value is string => Boolean(value?.trim()))\n    .join('\\n');\n}\n\nfunction syncProjectFts(\n  db: ReturnType<typeof getSqliteDatabase>,\n  project: Project,\n): void {\n  db.prepare(`DELETE FROM projects_fts WHERE project_id = ?`).run(project.id);\n  db.prepare(`INSERT INTO projects_fts (content, project_id) VALUES (?, ?)`).run(\n    projectFtsContent(project),\n    project.id,\n  );\n}\n\nexport class ProjectStore {\n  create(input: CreateProjectInput): Project {\n    const now = Date.now();\n    const name = normalizeName(input.name);\n    const slug = input.slug?.trim() || slugifyProjectName(name);\n    const project: Project = {\n      id: randomUUID(),\n      name,\n      slug,\n      description: trimOptional(input.description),\n      status: 'active',\n      defaultAgentId: trimOptional(input.defaultAgentId),\n      workspaceRoot: trimOptional(input.workspaceRoot),\n      brief: trimOptional(input.brief),\n      instructions: trimOptional(input.instructions),\n      createdAt: now,\n      updatedAt: now,\n      lastActiveAt: now,\n    };\n\n    runSqliteWriteTransaction((db) => {\n      db.prepare(\n        `INSERT INTO projects (\n          project_id, name, slug, description, status, default_agent_id, workspace_root,\n          brief, instructions, created_at, updated_at, last_active_at\n        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n      ).run(\n        project.id,\n        project.name,\n        project.slug,\n        project.description ?? null,\n        project.status,\n        project.defaultAgentId ?? null,\n        project.workspaceRoot ?? null,\n        project.brief ?? null,\n        project.instructions ?? null,\n        project.createdAt,\n        project.updatedAt,\n        project.lastActiveAt ?? null,\n      );\n      syncProjectFts(db, project);\n    });\n    return project;\n  }\n\n  get(id: string): Project | null {\n    const row = getSqliteDatabase()\n      .prepare(`SELECT * FROM projects WHERE project_id = ?`)\n      .get(id) as ProjectRow | undefined;\n    return row ? projectFromRow(row) : null;\n  }\n\n  findBySlug(slug: string): Project | null {\n    const row = getSqliteDatabase()\n      .prepare(`SELECT * FROM projects WHERE slug = ?`)\n      .get(slug.trim()) as ProjectRow | undefined;\n    return row ? projectFromRow(row) : null;\n  }\n\n  list(query: ProjectListQuery = {}): ProjectListResult {\n    const conditions: string[] = [];\n    const params: Array<string | number> = [];\n    const search = query.search?.trim();\n    const ftsQuery = search ? escapeFts5Query(search) : '';\n    if (query.status) {\n      const statuses = Array.isArray(query.status) ? query.status : [query.status];\n      conditions.push(`p.status IN (${statuses.map(() => '?').join(', ')})`);\n      params.push(...statuses);\n    }\n    if (ftsQuery) {\n      conditions.push(`p.project_id IN (SELECT project_id FROM projects_fts WHERE projects_fts MATCH ?)`);\n      params.push(ftsQuery);\n    }\n    const where = conditions.length ? `WHERE ${conditions.join(' AND ')}` : '';\n    const limit = clampLimit(query.limit, 50);\n    const offset = Math.max(0, Math.floor(query.offset ?? 0));\n    const sortOrder = query.sortOrder === 'asc' ? 'ASC' : 'DESC';\n    const sortColumn = projectSortExpression(query.sortBy);\n    const db = getSqliteDatabase();\n    const total = (db.prepare(`SELECT COUNT(*) AS total FROM projects p ${where}`).get(...params) as { total: number }).total;\n    const rows = db\n      .prepare(`SELECT p.* FROM projects p ${where} ORDER BY ${sortColumn} ${sortOrder} LIMIT ? OFFSET ?`)\n      .all(...params, limit, offset) as ProjectRow[];\n    return { items: rows.map(projectFromRow), total, limit, offset, hasMore: offset + limit < total };\n  }\n\n  update(id: string, input: UpdateProjectInput): Project {\n    const before = this.get(id);\n    if (!before) throw new Error(`Project not found: ${id}`);\n    const next = {\n      ...before,\n      ...(input.name !== undefined ? { name: normalizeName(input.name) } : {}),\n      ...(input.description !== undefined ? { description: nullableText(input.description) ?? undefined } : {}),\n      ...(input.status !== undefined ? { status: input.status } : {}),\n      ...(input.defaultAgentId !== undefined ? { defaultAgentId: nullableText(input.defaultAgentId) ?? undefined } : {}),\n      ...(input.workspaceRoot !== undefined ? { workspaceRoot: nullableText(input.workspaceRoot) ?? undefined } : {}),\n      ...(input.brief !== undefined ? { brief: nullableText(input.brief) ?? undefined } : {}),\n      ...(input.instructions !== undefined ? { instructions: nullableText(input.instructions) ?? undefined } : {}),\n      updatedAt: Date.now(),\n    } satisfies Project;\n\n    runSqliteWriteTransaction((db) => {\n      db.prepare(\n        `UPDATE projects SET\n          name = ?, description = ?, status = ?, default_agent_id = ?, workspace_root = ?, brief = ?, instructions = ?, updated_at = ?\n         WHERE project_id = ?`,\n      ).run(\n        next.name,\n        next.description ?? null,\n        next.status,\n        next.defaultAgentId ?? null,\n        next.workspaceRoot ?? null,\n        next.brief ?? null,\n        next.instructions ?? null,\n        next.updatedAt,\n        id,\n      );\n      syncProjectFts(db, next);\n    });\n    return this.get(id)!;\n  }\n\n  delete(id: string): void {\n    runSqliteWriteTransaction((db) => {\n      db.prepare(`UPDATE sessions SET project_id = NULL WHERE project_id = ?`).run(id);\n      db.prepare(`UPDATE goals SET project_id = NULL WHERE project_id = ?`).run(id);\n      db.prepare(`UPDATE workflow_runs SET project_id = NULL WHERE project_id = ?`).run(id);\n      db.prepare(`UPDATE automations SET project_id = NULL WHERE project_id = ?`).run(id);\n      db.prepare(`UPDATE memory_records SET project_id = NULL WHERE project_id = ?`).run(id);\n      db.prepare(`DELETE FROM projects_fts WHERE project_id = ?`).run(id);\n      db.prepare(`DELETE FROM projects WHERE project_id = ?`).run(id);\n    });\n  }\n\n  getSessionCount(id: string): number {\n    return (getSqliteDatabase()\n      .prepare(`SELECT COUNT(*) AS total FROM sessions WHERE project_id = ? AND hidden_from_session_list = 0`)\n      .get(id) as { total: number }).total;\n  }\n\n  getGoalCount(id: string): number {\n    return (getSqliteDatabase().prepare(`SELECT COUNT(*) AS total FROM goals WHERE project_id = ?`).get(id) as { total: number }).total;\n  }\n\n  getActiveGoalCount(id: string): number {\n    return (getSqliteDatabase()\n      .prepare(`SELECT COUNT(*) AS total FROM goals WHERE project_id = ? AND status IN ('active', 'paused', 'blocked', 'needs_input')`)\n      .get(id) as { total: number }).total;\n  }\n\n  getRecentSessions(id: string, limit = 5): ProjectWithDetails['recentSessions'] {\n    const rows = getSqliteDatabase()\n      .prepare(\n        `SELECT session_key, name, updated_at, agent_id FROM sessions\n         WHERE project_id = ? AND hidden_from_session_list = 0 ORDER BY updated_at DESC LIMIT ?`,\n      )\n      .all(id, clampLimit(limit, 5)) as Array<{ session_key: string; name: string | null; updated_at: number; agent_id: string }>;\n    return rows.map((row) => ({\n      key: row.session_key,\n      name: row.name ?? undefined,\n      updatedAt: new Date(row.updated_at).toISOString(),\n      agentId: row.agent_id,\n    }));\n  }\n\n  getRecentWorkflowRuns(id: string, limit = 5): ProjectWithDetails['recentWorkflowRuns'] {\n    const rows = getSqliteDatabase()\n      .prepare(\n        `SELECT run_id, definition_id, status, created_at_ms FROM workflow_runs\n         WHERE project_id = ? ORDER BY created_at_ms DESC LIMIT ?`,\n      )\n      .all(id, clampLimit(limit, 5)) as Array<{ run_id: string; definition_id: string; status: string; created_at_ms: number }>;\n    return rows.map((row) => ({ runId: row.run_id, definitionId: row.definition_id, status: row.status, createdAt: row.created_at_ms }));\n  }\n\n  getWithDetails(id: string): ProjectWithDetails | null {\n    const project = this.get(id);\n    if (!project) return null;\n    return {\n      ...project,\n      sessionCount: this.getSessionCount(id),\n      goalCount: this.getGoalCount(id),\n      activeGoalCount: this.getActiveGoalCount(id),\n      recentSessions: this.getRecentSessions(id),\n      recentWorkflowRuns: this.getRecentWorkflowRuns(id),\n    };\n  }\n\n  generateSlug(name: string): string {\n    const base = slugifyProjectName(name);\n    let candidate = base;\n    let counter = 2;\n    while (this.findBySlug(candidate)) {\n      candidate = `${base}-${counter}`;\n      counter += 1;\n    }\n    return candidate;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"project-store.js","names":[],"sources":["../../../src/projects/project-store.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\nimport { escapeFts5Query } from '../storage/sqlite/fts.js';\nimport { getSqliteDatabase, runSqliteWriteTransaction } from '../storage/sqlite/transaction.js';\nimport type {\n  CreateProjectInput,\n  Project,\n  ProjectListQuery,\n  ProjectListResult,\n  ProjectStatus,\n  SidebarProjectListQuery,\n  ProjectWithDetails,\n  UpdateProjectInput,\n} from './types.js';\n\nexport type ProjectRow = {\n  project_id: string;\n  name: string;\n  slug: string;\n  description: string | null;\n  status: string;\n  default_agent_id: string | null;\n  workspace_root: string | null;\n  brief: string | null;\n  instructions: string | null;\n  created_at: number;\n  updated_at: number;\n  last_active_at: number | null;\n  pinned_at: number | null;\n};\n\nfunction trimOptional(value: string | null | undefined): string | undefined {\n  if (value == null) return undefined;\n  const trimmed = value.trim();\n  return trimmed || undefined;\n}\n\nfunction nullableText(value: string | null | undefined): string | null {\n  if (value == null) return null;\n  const trimmed = value.trim();\n  return trimmed || null;\n}\n\nfunction projectFromRow(row: ProjectRow): Project {\n  return {\n    id: row.project_id,\n    name: row.name,\n    slug: row.slug,\n    description: row.description ?? undefined,\n    status: row.status as ProjectStatus,\n    defaultAgentId: row.default_agent_id ?? undefined,\n    workspaceRoot: row.workspace_root ?? undefined,\n    brief: row.brief ?? undefined,\n    instructions: row.instructions ?? undefined,\n    createdAt: row.created_at,\n    updatedAt: row.updated_at,\n    lastActiveAt: row.last_active_at ?? undefined,\n    pinnedAt: row.pinned_at ?? undefined,\n  };\n}\n\nfunction clampLimit(limit: number | undefined, fallback = 50): number {\n  return Math.min(500, Math.max(1, Math.floor(limit ?? fallback)));\n}\n\nfunction normalizeName(name: string): string {\n  const trimmed = name.trim();\n  if (!trimmed) throw new Error('Project name is required');\n  return trimmed;\n}\n\nexport function slugifyProjectName(name: string): string {\n  const slug = name\n    .trim()\n    .toLowerCase()\n    .normalize('NFKD')\n    .replace(/[\\u0300-\\u036f]/g, '')\n    .replace(/[^\\p{L}\\p{N}]+/gu, '-')\n    .replace(/^-+|-+$/g, '')\n    .slice(0, 80);\n  return slug || `project-${Date.now()}`;\n}\n\nfunction projectSortColumn(sortBy: ProjectListQuery['sortBy']): string {\n  switch (sortBy) {\n    case 'createdAt':\n      return 'created_at';\n    case 'name':\n      return 'LOWER(name)';\n    case 'updatedAt':\n    default:\n      return 'updated_at';\n  }\n}\n\nfunction projectSortExpression(sortBy: ProjectListQuery['sortBy']): string {\n  const column = projectSortColumn(sortBy);\n  return column === 'LOWER(name)' ? 'LOWER(p.name)' : `p.${column}`;\n}\n\nfunction projectFtsContent(project: Project): string {\n  return [\n    project.name,\n    project.slug,\n    project.description,\n    project.workspaceRoot,\n    project.brief,\n    project.instructions,\n    project.defaultAgentId,\n  ]\n    .filter((value): value is string => Boolean(value?.trim()))\n    .join('\\n');\n}\n\nfunction syncProjectFts(\n  db: ReturnType<typeof getSqliteDatabase>,\n  project: Project,\n): void {\n  db.prepare(`DELETE FROM projects_fts WHERE project_id = ?`).run(project.id);\n  db.prepare(`INSERT INTO projects_fts (content, project_id) VALUES (?, ?)`).run(\n    projectFtsContent(project),\n    project.id,\n  );\n}\n\nexport class ProjectStore {\n  create(input: CreateProjectInput): Project {\n    const now = Date.now();\n    const name = normalizeName(input.name);\n    const slug = input.slug?.trim() || slugifyProjectName(name);\n    const project: Project = {\n      id: randomUUID(),\n      name,\n      slug,\n      description: trimOptional(input.description),\n      status: 'active',\n      defaultAgentId: trimOptional(input.defaultAgentId),\n      workspaceRoot: trimOptional(input.workspaceRoot),\n      brief: trimOptional(input.brief),\n      instructions: trimOptional(input.instructions),\n      createdAt: now,\n      updatedAt: now,\n      lastActiveAt: now,\n      pinnedAt: undefined,\n    };\n\n    runSqliteWriteTransaction((db) => {\n      db.prepare(\n        `INSERT INTO projects (\n          project_id, name, slug, description, status, default_agent_id, workspace_root,\n          brief, instructions, created_at, updated_at, last_active_at, pinned_at\n        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,\n      ).run(\n        project.id,\n        project.name,\n        project.slug,\n        project.description ?? null,\n        project.status,\n        project.defaultAgentId ?? null,\n        project.workspaceRoot ?? null,\n        project.brief ?? null,\n        project.instructions ?? null,\n        project.createdAt,\n        project.updatedAt,\n        project.lastActiveAt ?? null,\n        project.pinnedAt ?? null,\n      );\n      syncProjectFts(db, project);\n    });\n    return project;\n  }\n\n  get(id: string): Project | null {\n    const row = getSqliteDatabase()\n      .prepare(`SELECT * FROM projects WHERE project_id = ?`)\n      .get(id) as ProjectRow | undefined;\n    return row ? projectFromRow(row) : null;\n  }\n\n  findBySlug(slug: string): Project | null {\n    const row = getSqliteDatabase()\n      .prepare(`SELECT * FROM projects WHERE slug = ?`)\n      .get(slug.trim()) as ProjectRow | undefined;\n    return row ? projectFromRow(row) : null;\n  }\n\n  list(query: ProjectListQuery = {}): ProjectListResult {\n    const conditions: string[] = [];\n    const params: Array<string | number> = [];\n    const search = query.search?.trim();\n    const ftsQuery = search ? escapeFts5Query(search) : '';\n    if (query.status) {\n      const statuses = Array.isArray(query.status) ? query.status : [query.status];\n      conditions.push(`p.status IN (${statuses.map(() => '?').join(', ')})`);\n      params.push(...statuses);\n    }\n    if (ftsQuery) {\n      conditions.push(`p.project_id IN (SELECT project_id FROM projects_fts WHERE projects_fts MATCH ?)`);\n      params.push(ftsQuery);\n    }\n    const where = conditions.length ? `WHERE ${conditions.join(' AND ')}` : '';\n    const limit = clampLimit(query.limit, 50);\n    const offset = Math.max(0, Math.floor(query.offset ?? 0));\n    const sortOrder = query.sortOrder === 'asc' ? 'ASC' : 'DESC';\n    const sortColumn = projectSortExpression(query.sortBy);\n    const db = getSqliteDatabase();\n    const total = (db.prepare(`SELECT COUNT(*) AS total FROM projects p ${where}`).get(...params) as { total: number }).total;\n    const rows = db\n      .prepare(`SELECT p.* FROM projects p ${where} ORDER BY ${sortColumn} ${sortOrder} LIMIT ? OFFSET ?`)\n      .all(...params, limit, offset) as ProjectRow[];\n    return { items: rows.map(projectFromRow), total, limit, offset, hasMore: offset + limit < total };\n  }\n\n  listWithSidebarSessions(query: SidebarProjectListQuery = {}): ProjectListResult {\n    const projectConditions: string[] = [];\n    const sessionConditions = [\n      `s.hidden_from_session_list = 0`,\n      `s.session_type = 'chat'`,\n    ];\n    const params: Array<string | number> = [];\n\n    if (query.status) {\n      const statuses = Array.isArray(query.status) ? query.status : [query.status];\n      projectConditions.push(`p.status IN (${statuses.map(() => '?').join(', ')})`);\n      params.push(...statuses);\n    }\n\n    if (query.updatedAfter !== undefined) {\n      const clauses = [`s.updated_at >= ?`];\n      params.push(query.updatedAfter);\n      if (query.includePinned) {\n        clauses.push(`s.status = 'pinned'`);\n      }\n      const includeSessionKey = query.includeSessionKey?.trim();\n      if (includeSessionKey) {\n        clauses.push(`s.session_key = ?`);\n        params.push(includeSessionKey);\n      }\n      sessionConditions.push(`(${clauses.join(' OR ')})`);\n    }\n\n    const whereParts = [...projectConditions, ...sessionConditions];\n    const where = whereParts.length ? `WHERE ${whereParts.join(' AND ')}` : '';\n    const limit = clampLimit(query.limit, 50);\n    const offset = Math.max(0, Math.floor(query.offset ?? 0));\n    const db = getSqliteDatabase();\n    const total = (db\n      .prepare(\n        `SELECT COUNT(DISTINCT p.project_id) AS total\n         FROM projects p\n         JOIN sessions s ON s.project_id = p.project_id\n         ${where}`,\n      )\n      .get(...params) as { total: number }).total;\n    const rows = db\n      .prepare(\n        `SELECT p.*, MAX(s.updated_at) AS latest_session_at\n         FROM projects p\n         JOIN sessions s ON s.project_id = p.project_id\n         ${where}\n         GROUP BY p.project_id\n         ORDER BY\n           CASE WHEN p.pinned_at IS NULL THEN 1 ELSE 0 END ASC,\n           p.pinned_at DESC,\n           latest_session_at DESC,\n           p.updated_at DESC\n         LIMIT ? OFFSET ?`,\n      )\n      .all(...params, limit, offset) as ProjectRow[];\n    return { items: rows.map(projectFromRow), total, limit, offset, hasMore: offset + limit < total };\n  }\n\n  update(id: string, input: UpdateProjectInput): Project {\n    const before = this.get(id);\n    if (!before) throw new Error(`Project not found: ${id}`);\n    const next = {\n      ...before,\n      ...(input.name !== undefined ? { name: normalizeName(input.name) } : {}),\n      ...(input.description !== undefined ? { description: nullableText(input.description) ?? undefined } : {}),\n      ...(input.status !== undefined ? { status: input.status } : {}),\n      ...(input.defaultAgentId !== undefined ? { defaultAgentId: nullableText(input.defaultAgentId) ?? undefined } : {}),\n      ...(input.workspaceRoot !== undefined ? { workspaceRoot: nullableText(input.workspaceRoot) ?? undefined } : {}),\n      ...(input.brief !== undefined ? { brief: nullableText(input.brief) ?? undefined } : {}),\n      ...(input.instructions !== undefined ? { instructions: nullableText(input.instructions) ?? undefined } : {}),\n      ...(input.pinnedAt !== undefined ? { pinnedAt: input.pinnedAt ?? undefined } : {}),\n      updatedAt: Date.now(),\n    } satisfies Project;\n\n    runSqliteWriteTransaction((db) => {\n      db.prepare(\n        `UPDATE projects SET\n          name = ?, description = ?, status = ?, default_agent_id = ?, workspace_root = ?, brief = ?, instructions = ?, pinned_at = ?, updated_at = ?\n         WHERE project_id = ?`,\n      ).run(\n        next.name,\n        next.description ?? null,\n        next.status,\n        next.defaultAgentId ?? null,\n        next.workspaceRoot ?? null,\n        next.brief ?? null,\n        next.instructions ?? null,\n        next.pinnedAt ?? null,\n        next.updatedAt,\n        id,\n      );\n      syncProjectFts(db, next);\n    });\n    return this.get(id)!;\n  }\n\n  delete(id: string): void {\n    runSqliteWriteTransaction((db) => {\n      db.prepare(`UPDATE sessions SET project_id = NULL WHERE project_id = ?`).run(id);\n      db.prepare(`UPDATE goals SET project_id = NULL WHERE project_id = ?`).run(id);\n      db.prepare(`UPDATE workflow_runs SET project_id = NULL WHERE project_id = ?`).run(id);\n      db.prepare(`UPDATE automations SET project_id = NULL WHERE project_id = ?`).run(id);\n      db.prepare(`UPDATE memory_records SET project_id = NULL WHERE project_id = ?`).run(id);\n      db.prepare(`DELETE FROM projects_fts WHERE project_id = ?`).run(id);\n      db.prepare(`DELETE FROM projects WHERE project_id = ?`).run(id);\n    });\n  }\n\n  getSessionCount(id: string): number {\n    return (getSqliteDatabase()\n      .prepare(`SELECT COUNT(*) AS total FROM sessions WHERE project_id = ? AND hidden_from_session_list = 0`)\n      .get(id) as { total: number }).total;\n  }\n\n  getGoalCount(id: string): number {\n    return (getSqliteDatabase().prepare(`SELECT COUNT(*) AS total FROM goals WHERE project_id = ?`).get(id) as { total: number }).total;\n  }\n\n  getActiveGoalCount(id: string): number {\n    return (getSqliteDatabase()\n      .prepare(`SELECT COUNT(*) AS total FROM goals WHERE project_id = ? AND status IN ('active', 'paused', 'blocked', 'needs_input')`)\n      .get(id) as { total: number }).total;\n  }\n\n  getRecentSessions(id: string, limit = 5): ProjectWithDetails['recentSessions'] {\n    const rows = getSqliteDatabase()\n      .prepare(\n        `SELECT session_key, name, updated_at, agent_id FROM sessions\n         WHERE project_id = ? AND hidden_from_session_list = 0 ORDER BY updated_at DESC LIMIT ?`,\n      )\n      .all(id, clampLimit(limit, 5)) as Array<{ session_key: string; name: string | null; updated_at: number; agent_id: string }>;\n    return rows.map((row) => ({\n      key: row.session_key,\n      name: row.name ?? undefined,\n      updatedAt: new Date(row.updated_at).toISOString(),\n      agentId: row.agent_id,\n    }));\n  }\n\n  getRecentWorkflowRuns(id: string, limit = 5): ProjectWithDetails['recentWorkflowRuns'] {\n    const rows = getSqliteDatabase()\n      .prepare(\n        `SELECT run_id, definition_id, status, created_at_ms FROM workflow_runs\n         WHERE project_id = ? ORDER BY created_at_ms DESC LIMIT ?`,\n      )\n      .all(id, clampLimit(limit, 5)) as Array<{ run_id: string; definition_id: string; status: string; created_at_ms: number }>;\n    return rows.map((row) => ({ runId: row.run_id, definitionId: row.definition_id, status: row.status, createdAt: row.created_at_ms }));\n  }\n\n  getWithDetails(id: string): ProjectWithDetails | null {\n    const project = this.get(id);\n    if (!project) return null;\n    return {\n      ...project,\n      sessionCount: this.getSessionCount(id),\n      goalCount: this.getGoalCount(id),\n      activeGoalCount: this.getActiveGoalCount(id),\n      recentSessions: this.getRecentSessions(id),\n      recentWorkflowRuns: this.getRecentWorkflowRuns(id),\n    };\n  }\n\n  generateSlug(name: string): string {\n    const base = slugifyProjectName(name);\n    let candidate = base;\n    let counter = 2;\n    while (this.findBySlug(candidate)) {\n      candidate = `${base}-${counter}`;\n      counter += 1;\n    }\n    return candidate;\n  }\n}\n"],"mappings":"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"}

package/dist/src/projects/types.d.ts

@@ -8,11 +8,14 @@ export interface Project {
     status: ProjectStatus;
     defaultAgentId?: string;
     workspaceRoot?: string;
+    workspaceMode?: 'followAgent' | 'fixed';
+    effectiveWorkspaceRoot?: string;
     brief?: string;
     instructions?: string;
     createdAt: number;
     updatedAt: number;
     lastActiveAt?: number;
+    pinnedAt?: number;
 }
 export interface ProjectWithDetails extends Project {
     sessionCount: number;
@@ -39,6 +42,14 @@ export interface ProjectListQuery {
     limit?: number;
     offset?: number;
 }
+export interface SidebarProjectListQuery {
+    status?: ProjectStatus | ProjectStatus[];
+    updatedAfter?: number;
+    includePinned?: boolean;
+    includeSessionKey?: string;
+    limit?: number;
+    offset?: number;
+}
 export interface CreateProjectInput {
     name?: string;
     slug?: string;
@@ -59,5 +70,6 @@ export interface UpdateProjectInput {
     createWorkspaceRoot?: boolean;
     brief?: string | null;
     instructions?: string | null;
+    pinnedAt?: number | null;
 }
 export type ProjectListResult = PaginatedResult<Project>;

package/dist/src/projects/workspace.js

@@ -1,7 +1,7 @@
-import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { isXopcDatabaseOpen } from "../storage/sqlite/connection.js";
 import { getSessionMetadata } from "../storage/sqlite/session-repository.js";
 import "../storage/sqlite/index.js";
+import { resolveEffectiveAgentProfileForSession } from "../config/agent-profile.js";
 import { projectWorkspacePath } from "../session/session-workspace.js";
 import { ProjectStore } from "./project-store.js";
 //#region src/projects/workspace.ts

package/dist/src/routing/agent-session-key.js

@@ -1,6 +1,6 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { DEFAULT_ACCOUNT_ID, init_account_id, normalizeAccountId, normalizeOptionalAccountId } from "./account-id.js";
 import { init_string_coerce, normalizeLowercaseStringOrEmpty } from "../utils/string-coerce.js";
+import { DEFAULT_ACCOUNT_ID, init_account_id, normalizeAccountId, normalizeOptionalAccountId } from "./account-id.js";
 import { getSubagentDepth, init_session_key_utils, isAcpSessionKey, isCronSessionKey, isSubagentSessionKey, parseAgentSessionKey, parseThreadSessionSuffix } from "./session-key-utils.js";
 //#region src/routing/agent-session-key.ts
 function normalizeToken(value) {

package/dist/src/routing/resolve-route.js

@@ -1,7 +1,7 @@
 import { __esmMin } from "../../_virtual/_rolldown/runtime.js";
-import { init_agent_scope, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { init_account_id, normalizeAccountId } from "./account-id.js";
 import { buildAgentMainSessionKey, buildAgentPeerSessionKey, init_agent_session_key, normalizeSessionKey } from "./agent-session-key.js";
+import { init_agent_scope, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { buildSessionKey, init_session_key, parseSessionKey } from "./session-key.js";
 import { init_bindings, parseBindingRules, resolveRoute as resolveRoute$1 } from "./bindings.js";
 //#region src/routing/resolve-route.ts

package/dist/src/routing/resolve-tui-session-key.js

@@ -1,7 +1,7 @@
-import { init_agent_scope, listAgentEntries, resolveAgentIdByWorkspacePath, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { init_string_coerce, normalizeLowercaseStringOrEmpty } from "../utils/string-coerce.js";
 import { parseAgentSessionKey } from "./session-key-utils.js";
 import { buildAgentMainSessionKey, init_agent_session_key, normalizeAgentId, normalizeMainKey } from "./agent-session-key.js";
+import { init_agent_scope, listAgentEntries, resolveAgentIdByWorkspacePath, resolveDefaultAgentId } from "../agent/agent-scope.js";
 import { randomUUID } from "node:crypto";
 //#region src/routing/resolve-tui-session-key.ts
 init_agent_scope();

package/dist/src/session/client-history.d.ts

@@ -5,6 +5,7 @@ export interface ClientHistoryMessage {
     id?: string;
     role: 'user' | 'assistant' | 'system';
     content: string;
+    displayIndex?: number;
     rawContent?: string | unknown[];
     timestamp?: number;
     kind?: 'message' | 'compaction' | 'context' | 'bash' | 'custom' | 'branch';
@@ -50,4 +51,6 @@ export declare function messagesToClientHistory(messages: Message[], opts?: {
  */
 export declare function transcriptRowsToClientHistory(rows: TranscriptStoredRow[], opts?: {
     limit?: number;
+    startRowNumber?: number;
+    endRowNumber?: number;
 }): ClientHistoryMessage[];

package/dist/src/session/client-history.js

@@ -1,3 +1,4 @@
+import { buildTranscriptOutline } from "./transcript-outline.js";
 //#region src/session/client-history.ts
 function flattenMessageContent(content) {
 	if (typeof content === "string") return content;
@@ -224,18 +225,24 @@ function branchSummaryRowToClientHistory(row) {
 * audit rows that the TUI can render as dedicated components.
 */
 function transcriptRowsToClientHistory(rows, opts) {
-	const startIndex = opts?.limit !== void 0 && rows.length > opts.limit ? rows.length - opts.limit : 0;
-	const slice = opts?.limit !== void 0 && rows.length > opts.limit ? rows.slice(-opts.limit) : rows;
+	const displayIndexByRowNumber = new Map(buildTranscriptOutline(rows).filter((entry) => entry.displayIndex !== void 0).map((entry) => [entry.rowNumber, entry.displayIndex]));
+	const hasRowWindow = opts?.startRowNumber !== void 0 || opts?.endRowNumber !== void 0;
+	const startIndex = hasRowWindow ? Math.max(0, Math.trunc(opts?.startRowNumber ?? 1) - 1) : opts?.limit !== void 0 && rows.length > opts.limit ? rows.length - opts.limit : 0;
+	const endIndex = hasRowWindow ? Math.max(startIndex, Math.min(rows.length, Math.trunc(opts?.endRowNumber ?? rows.length))) : rows.length;
+	const slice = hasRowWindow ? rows.slice(startIndex, endIndex) : opts?.limit !== void 0 && rows.length > opts.limit ? rows.slice(-opts.limit) : rows;
 	const results = collectHistoryToolResults(slice.map(asHistoryMessageRow).filter((row) => row !== null));
 	const out = [];
 	for (const [offset, row] of slice.entries()) {
-		const id = `row-${startIndex + offset + 1}`;
+		const rowNumber = startIndex + offset + 1;
+		const id = `row-${rowNumber}`;
+		const displayIndex = displayIndexByRowNumber.get(rowNumber);
 		if (isCompactionRow(row)) {
 			out.push({
 				id,
 				role: "system",
 				kind: "compaction",
 				content: typeof row.summary === "string" ? row.summary : "",
+				...displayIndex !== void 0 ? { displayIndex } : {},
 				timestamp: parseTimestamp(row.at),
 				tokensBefore: row.tokensBefore,
 				tokensAfter: row.tokensAfter
@@ -246,7 +253,8 @@ function transcriptRowsToClientHistory(rows, opts) {
 		if (compactionSummaryRow) {
 			out.push({
 				id,
-				...compactionSummaryRow
+				...compactionSummaryRow,
+				...displayIndex !== void 0 ? { displayIndex } : {}
 			});
 			continue;
 		}
@@ -254,7 +262,8 @@ function transcriptRowsToClientHistory(rows, opts) {
 		if (contextRow) {
 			out.push({
 				id,
-				...contextRow
+				...contextRow,
+				...displayIndex !== void 0 ? { displayIndex } : {}
 			});
 			continue;
 		}
@@ -262,7 +271,8 @@ function transcriptRowsToClientHistory(rows, opts) {
 		if (bashRow) {
 			out.push({
 				id,
-				...bashRow
+				...bashRow,
+				...displayIndex !== void 0 ? { displayIndex } : {}
 			});
 			continue;
 		}
@@ -270,7 +280,8 @@ function transcriptRowsToClientHistory(rows, opts) {
 		if (customRow) {
 			out.push({
 				id,
-				...customRow
+				...customRow,
+				...displayIndex !== void 0 ? { displayIndex } : {}
 			});
 			continue;
 		}
@@ -278,7 +289,8 @@ function transcriptRowsToClientHistory(rows, opts) {
 		if (customStateRow) {
 			out.push({
 				id,
-				...customStateRow
+				...customStateRow,
+				...displayIndex !== void 0 ? { displayIndex } : {}
 			});
 			continue;
 		}
@@ -286,7 +298,8 @@ function transcriptRowsToClientHistory(rows, opts) {
 		if (branchSummaryRow) {
 			out.push({
 				id,
-				...branchSummaryRow
+				...branchSummaryRow,
+				...displayIndex !== void 0 ? { displayIndex } : {}
 			});
 			continue;
 		}
@@ -299,6 +312,7 @@ function transcriptRowsToClientHistory(rows, opts) {
 				role: messageRow.role,
 				kind: "message",
 				content: flattenMessageContent(messageRow.content ?? ""),
+				...displayIndex !== void 0 ? { displayIndex } : {},
 				timestamp: parseTimestampValue(messageRow.timestamp)
 			});
 			continue;
@@ -308,6 +322,7 @@ function transcriptRowsToClientHistory(rows, opts) {
 			role: "assistant",
 			kind: "message",
 			content: flattenMessageContent(messageRow.content ?? ""),
+			...displayIndex !== void 0 ? { displayIndex } : {},
 			timestamp: parseTimestampValue(messageRow.timestamp),
 			toolCalls: toolCallsWithResults(messageRow.tool_calls ?? messageRow.toolCalls, results)
 		});