@xopcai/xopc 0.0.126 → 0.0.127

package/dist/src/pets/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","names":[],"sources":["../../../src/pets/validator.ts"],"sourcesContent":["import { constants } from 'node:fs';\nimport { access, readFile } from 'node:fs/promises';\nimport { extname, join, resolve } from 'node:path';\n\nimport { DESKTOP_PET_ACTIONS, type DesktopPetPackageAction } from './manifest.js';\n\nexport type DesktopPetValidationIssue = {\n  dir: string;\n  reason: string;\n  details?: string[];\n};\n\nexport type DesktopPetValidationResult =\n  | { ok: true }\n  | { ok: false; issue: DesktopPetValidationIssue };\n\ntype ManifestAnimation = {\n  src: string;\n  frameWidth: number;\n  frameHeight: number;\n  frameCount: number;\n  fps: number;\n  offsetX: number;\n  offsetY: number;\n};\n\nfunction safeResolve(root: string, child: unknown): string | null {\n  if (typeof child !== 'string' || !child.trim()) return null;\n  const normalizedRoot = resolve(root);\n  const candidate = resolve(root, child);\n  if (candidate === normalizedRoot) return candidate;\n  if (candidate.startsWith(`${normalizedRoot}\\\\`) || candidate.startsWith(`${normalizedRoot}/`)) return candidate;\n  return null;\n}\n\nfunction positiveNumber(value: unknown): number | null {\n  return typeof value === 'number' && Number.isFinite(value) && value > 0 ? value : null;\n}\n\nfunction positiveRoundedNumber(value: unknown): number | null {\n  const n = positiveNumber(value);\n  if (n === null) return null;\n  const rounded = Math.round(n);\n  return rounded > 0 ? rounded : null;\n}\n\nfunction nonNegativeNumber(value: unknown, fallback: number): number | null {\n  if (value === undefined) return fallback;\n  return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : null;\n}\n\nfunction supportedImagePath(path: string): boolean {\n  return ['.png', '.jpg', '.jpeg', '.gif', '.webp', '.svg'].includes(extname(path).toLowerCase());\n}\n\nasync function readableImage(path: string): Promise<boolean> {\n  if (!supportedImagePath(path)) return false;\n  try {\n    await access(path, constants.R_OK);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nfunction parseSvgDimension(value: string | undefined): number | null {\n  if (!value) return null;\n  const match = value.trim().match(/^(\\d+(?:\\.\\d+)?)/);\n  if (!match) return null;\n  const n = Number(match[1]);\n  return Number.isFinite(n) && n > 0 ? n : null;\n}\n\nfunction parseSvgBounds(svg: string): { width: number; height: number } | null {\n  const rootMatch = svg.match(/<svg\\b[^>]*>/i);\n  if (!rootMatch) return null;\n  const root = rootMatch[0];\n  const width = parseSvgDimension(root.match(/\\bwidth=[\"']([^\"']+)[\"']/i)?.[1]);\n  const height = parseSvgDimension(root.match(/\\bheight=[\"']([^\"']+)[\"']/i)?.[1]);\n  if (width && height) return { width, height };\n  const viewBox = root.match(/\\bviewBox=[\"']([^\"']+)[\"']/i)?.[1]?.trim();\n  if (!viewBox) return null;\n  const parts = viewBox.split(/[\\s,]+/).map(Number);\n  if (parts.length !== 4 || parts.some((part) => !Number.isFinite(part))) return null;\n  const [, , viewBoxWidth, viewBoxHeight] = parts;\n  return viewBoxWidth > 0 && viewBoxHeight > 0 ? { width: viewBoxWidth, height: viewBoxHeight } : null;\n}\n\nasync function imageBounds(path: string): Promise<{ width: number; height: number } | null> {\n  if (extname(path).toLowerCase() !== '.svg') return null;\n  try {\n    return parseSvgBounds(await readFile(path, 'utf8'));\n  } catch {\n    return null;\n  }\n}\n\nfunction parseAnimation(action: DesktopPetPackageAction, raw: unknown, details: string[]): ManifestAnimation | null {\n  if (!raw || typeof raw !== 'object') {\n    details.push(`${action}: animation must be an object`);\n    return null;\n  }\n  const obj = raw as Record<string, unknown>;\n  const src = typeof obj.src === 'string' && obj.src.trim() ? obj.src.trim() : null;\n  const frameWidth = positiveRoundedNumber(obj.frameWidth);\n  const frameHeight = positiveRoundedNumber(obj.frameHeight);\n  const frameCount = positiveRoundedNumber(obj.frameCount);\n  const fps = positiveRoundedNumber(obj.fps);\n  const offsetX = nonNegativeNumber(obj.offsetX, 0);\n  const offsetY = nonNegativeNumber(obj.offsetY, 0);\n  if (!src) details.push(`${action}: src is required`);\n  if (!frameWidth || !frameHeight || !frameCount) {\n    details.push(`${action}: frameWidth, frameHeight, and frameCount must be positive numbers`);\n  }\n  if (!fps) details.push(`${action}: fps must be a positive number`);\n  if (offsetX === null || offsetY === null) details.push(`${action}: offsetX and offsetY must be non-negative numbers`);\n  if (!src || !frameWidth || !frameHeight || !frameCount || !fps || offsetX === null || offsetY === null) {\n    return null;\n  }\n  return {\n    src,\n    frameWidth,\n    frameHeight,\n    frameCount,\n    fps,\n    offsetX: Math.round(offsetX),\n    offsetY: Math.round(offsetY),\n  };\n}\n\nfunction estimateSheetBounds(animations: ManifestAnimation[]): Map<string, { width: number; height: number }> {\n  const bounds = new Map<string, { width: number; height: number }>();\n  for (const animation of animations) {\n    const width = animation.offsetX + animation.frameWidth * animation.frameCount;\n    const height = animation.offsetY + animation.frameHeight;\n    const existing = bounds.get(animation.src);\n    bounds.set(animation.src, {\n      width: Math.max(existing?.width ?? 0, width),\n      height: Math.max(existing?.height ?? 0, height),\n    });\n  }\n  return bounds;\n}\n\nexport async function validateDesktopPetPackage(dir: string): Promise<DesktopPetValidationResult> {\n  const details: string[] = [];\n  let manifest: Record<string, unknown>;\n  try {\n    manifest = JSON.parse(await readFile(join(dir, 'manifest.json'), 'utf8')) as Record<string, unknown>;\n  } catch (e) {\n    const message = e instanceof Error ? e.message : String(e);\n    return { ok: false, issue: { dir, reason: 'manifest.json is missing or unreadable', details: [message] } };\n  }\n\n  if (typeof manifest.id !== 'string' || !manifest.id.trim()) details.push('id is required');\n  if (typeof manifest.name !== 'string' || !manifest.name.trim()) details.push('name is required');\n  if (typeof manifest.description !== 'string' || !manifest.description.trim()) {\n    details.push('description is required');\n  }\n  if (positiveNumber(manifest.canvasWidth) === null || positiveNumber(manifest.canvasHeight) === null) {\n    details.push('canvasWidth and canvasHeight must be positive numbers');\n  }\n\n  const thumbnailPath = safeResolve(dir, manifest.thumbnail);\n  if (!thumbnailPath || !(await readableImage(thumbnailPath))) {\n    details.push('thumbnail is required and must be a readable supported image');\n  }\n\n  const rawAnimations =\n    manifest.animations && typeof manifest.animations === 'object'\n      ? (manifest.animations as Record<string, unknown>)\n      : null;\n  if (!rawAnimations) {\n    details.push('animations is required');\n  }\n\n  const animations: ManifestAnimation[] = [];\n  if (rawAnimations) {\n    for (const action of DESKTOP_PET_ACTIONS) {\n      const animation = parseAnimation(action, rawAnimations[action], details);\n      if (animation) animations.push(animation);\n    }\n  }\n\n  for (const animation of animations) {\n    const sourcePath = safeResolve(dir, animation.src);\n    if (!sourcePath || !(await readableImage(sourcePath))) {\n      details.push(`${animation.src}: image is missing, outside the pet folder, or uses an unsupported format`);\n    }\n  }\n\n  const boundsBySrc = estimateSheetBounds(animations);\n  for (const [src, requiredBounds] of boundsBySrc) {\n    const sourcePath = safeResolve(dir, src);\n    if (!sourcePath) continue;\n    const actualBounds = await imageBounds(sourcePath);\n    if (!actualBounds) continue;\n    if (requiredBounds.width > actualBounds.width || requiredBounds.height > actualBounds.height) {\n      details.push(\n        `${src}: manifest needs ${requiredBounds.width}x${requiredBounds.height}, but image is ${actualBounds.width}x${actualBounds.height}`,\n      );\n    }\n  }\n\n  if (details.length > 0) return { ok: false, issue: { dir, reason: 'Invalid desktop pet package', details } };\n  return { ok: true };\n}\n"],"mappings":"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"}

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

@@ -30,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

@@ -177,6 +177,12 @@ var ProjectService = class {
 		});
 		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 { 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  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":";;;;;;;;AA0BA,IAAa,iBAAb,MAA4B;CAC1B,YAAY,QAAyB,IAAI,cAAc,EAAE;AAA5B,OAAA,QAAA;;CAE7B,kBAAqC;EACnC,MAAM,QAAmB,EAAE;EAC3B,IAAI,SAAS;EACb,MAAM,QAAQ;AACd,SAAO,MAAM;GACX,MAAM,OAAO,KAAK,KAAK;IAAE;IAAO;IAAQ,CAAC;AACzC,SAAM,KAAK,GAAG,KAAK,MAAM;AACzB,OAAI,CAAC,KAAK,WAAW,KAAK,MAAM,WAAW,EAAG;AAC9C,aAAU,KAAK,MAAM;;AAEvB,SAAO;;CAGT,OAAO,OAAoC;EACzC,MAAM,mBAAmB,MAAM,eAAe,MAAM;EACpD,MAAM,gBAAgB,mBAAmB,uBAAuB,iBAAiB,GAAG,KAAA;AACpF,MAAI,oBAAoB,CAAC,cACvB,OAAM,IAAI,MAAM,yBAAyB;AAE3C,MAAI,eAAe;GACjB,MAAM,WAAW,KAAK,oBAAoB,cAAc;AACxD,OAAI,SAAU,OAAM,IAAI,8BAA8B,SAAS;AAC/D,OAAI,CAAC,yBAAyB,cAAc,CAC1C,KAAI,MAAM,wBAAwB,KAChC,0BAAyB,cAAc;OAEvC,OAAM,IAAI,6BAA6B,cAAc;;EAI3D,MAAM,OAAO,MAAM,MAAM,MAAM,IAAI,kCAAkC,cAAc,IAAI;EACvF,MAAM,OAAO,MAAM,MAAM,MAAM,IAAI,KAAK,MAAM,aAAa,KAAK;EAChE,MAAM,UAAU,KAAK,MAAM,OAAO;GAAE,GAAG;GAAO;GAAM;GAAM;GAAe,CAAC;AAC1E,eAAa;GACX,MAAM;GACN,eAAe;IAAE,MAAM;IAAW,IAAI,QAAQ;IAAI,OAAO,QAAQ;IAAM;GACvE,OAAO,qBAAqB;GAC5B,QAAQ,sBAAsB;GAC9B,SAAS;IACP,MAAM,QAAQ;IACd,eAAe,QAAQ;IACvB,OAAO,QAAQ;IAChB;GACD,QAAQ,CAAC;IAAE,WAAW;IAAW,SAAS,QAAQ;IAAI,QAAQ;IAAgB,CAAC;GAC/E,OAAO,QAAQ;GAChB,CAAC;AACF,SAAO;;CAGT,IAAI,IAA4B;AAC9B,SAAO,KAAK,MAAM,IAAI,GAAG;;CAG3B,UAAU,MAA8B;AACtC,SAAO,KAAK,MAAM,WAAW,KAAK;;CAGpC,KAAK,OAA6C;AAChD,SAAO,KAAK,MAAM,KAAK,MAAM;;CAG/B,wBAAwB,OAAoD;AAC1E,SAAO,KAAK,MAAM,wBAAwB,MAAM;;CAGlD,oBAAoB,eAAuB,UAAyC,EAAE,EAAkB;EACtG,MAAM,SAAS,uBAAuB,cAAc;AACpD,MAAI,CAAC,OAAQ,QAAO;AACpB,OAAK,MAAM,WAAW,KAAK,iBAAiB,EAAE;AAC5C,OAAI,QAAQ,oBAAoB,QAAQ,OAAO,QAAQ,iBAAkB;GACzE,MAAM,cAAc,uBAAuB,QAAQ,cAAc;AACjE,OAAI,eAAe,4BAA4B,aAAa,OAAO,IAAI,4BAA4B,QAAQ,YAAY,CACrH,QAAO;;AAGX,SAAO;;CAGT,wBAAwB,eAAmF;EACzG,MAAM,SAAS,uBAAuB,cAAc;AACpD,MAAI,CAAC,OAAQ,QAAO;EACpB,IAAI,OAAiF;AACrF,OAAK,MAAM,WAAW,KAAK,iBAAiB,EAAE;GAC5C,MAAM,OAAO,uBAAuB,QAAQ,cAAc;AAC1D,OAAI,CAAC,QAAQ,CAAC,4BAA4B,MAAM,OAAO,CAAE;GACzD,MAAM,SAAS,4BAA4B,MAAM,OAAO,IAAI,4BAA4B,QAAQ,KAAK,GAAG,UAAU;AAClH,OAAI,CAAC,QAAQ,KAAK,SAAS,KAAK,KAAK,OACnC,QAAO;IAAE;IAAS;IAAM;IAAQ;;AAGpC,SAAO,OAAO;GAAE,SAAS,KAAK;GAAS,QAAQ,KAAK;GAAQ,GAAG;;CAGjE,gCAAgC,OAKC;EAC/B,MAAM,WAAW,KAAK,wBAAwB,MAAM,cAAc;AAClE,MAAI,SAAU,QAAO;GAAE,SAAS,SAAS;GAAS,QAAQ,SAAS;GAAQ,SAAS;GAAO;AAC3F,MAAI,CAAC,MAAM,WAAY,QAAO;EAC9B,MAAM,gBAAgB,4BAA4B,MAAM,cAAc,IAAI,uBAAuB,MAAM,cAAc;AACrH,MAAI,CAAC,iBAAiB,CAAC,8BAA8B,cAAc,CAAE,QAAO;EAC5E,MAAM,eAAe,KAAK,wBAAwB,cAAc;AAChE,MAAI,aAAc,QAAO;GAAE,SAAS,aAAa;GAAS,QAAQ,aAAa;GAAQ,SAAS;GAAO;AAMvG,SAAO;GAAE,SALO,KAAK,OAAO;IAC1B,MAAM,kCAAkC,cAAc,IAAI,KAAA;IAC1D;IACA,gBAAgB,OAAO,OAAO,OAAO,iBAAiB,GAAG,MAAM,iBAAiB,MAAM;IACvF,CACe;GAAE,QAAQ;GAAgB,SAAS;GAAM;;CAG3D,OAAO,IAAY,OAAoC;EACrD,MAAM,QAAQ,EAAE,GAAG,OAAO;AAC1B,MAAI,MAAM,kBAAkB,KAAA,KAAa,MAAM,kBAAkB,QAAQ,MAAM,cAAc,MAAM,EAAE;GACnG,MAAM,gBAAgB,uBAAuB,MAAM,cAAc;AACjE,OAAI,CAAC,cACH,OAAM,IAAI,MAAM,yBAAyB;GAE3C,MAAM,WAAW,KAAK,oBAAoB,eAAe,EAAE,kBAAkB,IAAI,CAAC;AAClF,OAAI,SAAU,OAAM,IAAI,8BAA8B,SAAS;AAC/D,OAAI,CAAC,yBAAyB,cAAc,CAC1C,KAAI,MAAM,wBAAwB,KAChC,0BAAyB,cAAc;OAEvC,OAAM,IAAI,6BAA6B,cAAc;AAGzD,SAAM,gBAAgB;;EAExB,MAAM,SAAS,KAAK,MAAM,IAAI,GAAG;EACjC,MAAM,UAAU,KAAK,MAAM,OAAO,IAAI,MAAM;EAC5C,MAAM,UAAU,uBAAuB,OAAkC,CAAC,sBAAsB,CAAC;EACjG,MAAM,OAAO,QAAQ,WAAW,QAAQ,SACpC,2BACA,QAAQ,kBAAkB,QAAQ,gBAChC,8BACA;AACN,eAAa;GACX;GACA,eAAe;IAAE,MAAM;IAAW,IAAI,QAAQ;IAAI,OAAO,QAAQ;IAAM;GACvE,OAAO,qBAAqB;GAC5B,QAAQ,sBAAsB;GAC9B,SAAS;IACP;IACA,GAAI,SAAS,2BAA2B;KAAE,MAAM,QAAQ;KAAQ,IAAI,QAAQ;KAAQ,GAAG,EAAE;IACzF,GAAI,SAAS,8BAA8B;KAAE,MAAM,QAAQ;KAAe,IAAI,QAAQ;KAAe,GAAG,EAAE;IAC3G;GACD,QAAQ,CAAC;IAAE,WAAW;IAAW,SAAS,QAAQ;IAAI,QAAQ;IAAgB,CAAC;GAC/E,OAAO,QAAQ;GAChB,CAAC;AACF,SAAO;;CAGT,OAAO,IAAkB;AACvB,OAAK,MAAM,OAAO,GAAG;;CAGvB,eAAe,IAAuC;AACpD,SAAO,KAAK,MAAM,eAAe,GAAG;;CAGtC,cAAc,YAAoB,WAAyB;AACzD,uBAAqB,YAAY,UAAU;;CAG7C,cAAc,YAA0B;AACtC,2BAAyB,WAAW;;CAGtC,gBAAgB,WAAmB,OAAgB,QAA2B;AAC5E,SAAO,uBAAuB,WAAW,OAAO,OAAO;;CAGzD,WAAW,QAAgB,WAAyB;AAClD,oBAAkB,QAAQ,UAAU;;CAGtC,WAAW,QAAsB;AAC/B,wBAAsB,OAAO;;CAG/B,YAAY,WAAmB,OAAgB,QAA2B;AACxE,SAAO,mBAAmB,WAAW,OAAO,OAAO;;CAGrD,0BAA0B,YAAyC;EACjE,MAAM,UAAU,mBAAmB,WAAW;AAC9C,MAAI,CAAC,QAAS,QAAO,EAAE;EACvB,MAAM,WAAW,KAAK,KAAK;GAAE,QAAQ;GAAU,OAAO;GAAK,CAAC,CAAC;EAC7D,MAAM,WAAW;GAAC,QAAQ;GAAK,QAAQ;GAAM,QAAQ,SAAS;GAAS,QAAQ;GAAe,GAAI,QAAQ,QAAQ,EAAE;GAAE,CACnH,OAAO,QAAQ,CACf,KAAK,IAAI,CACT,aAAa;EAChB,MAAM,cAAmC,EAAE;AAC3C,OAAK,MAAM,WAAW,UAAU;GAC9B,IAAI,QAAQ;GACZ,MAAM,UAAoB,EAAE;AAC5B,OAAI,SAAS,SAAS,QAAQ,KAAK,aAAa,CAAC,EAAE;AACjD,aAAS;AACT,YAAQ,KAAK,wCAAwC;;AAEvD,QAAK,MAAM,SAAS,QAAQ,KAAK,aAAa,CAAC,MAAM,MAAM,CAAC,QAAQ,MAAM,EAAE,UAAU,EAAE,CACtF,KAAI,SAAS,SAAS,MAAM,EAAE;AAC5B,aAAS;AACT,YAAQ,KAAK,WAAW,QAAQ;AAChC;;AAGJ,OAAI,QAAQ,EACV,aAAY,KAAK;IAAE,WAAW,QAAQ;IAAI,aAAa,QAAQ;IAAM;IAAO,QAAQ,QAAQ,KAAK,KAAK;IAAE,CAAC;;AAG7G,SAAO,YAAY,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,GAAG,EAAE"}
+{"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

@@ -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 {

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;
@@ -163,7 +165,11 @@ var ProjectStore = class {
          JOIN sessions s ON s.project_id = p.project_id
          ${where}
          GROUP BY p.project_id
-         ORDER BY latest_session_at DESC, p.updated_at DESC
+         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,
@@ -183,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  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};\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  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 latest_session_at DESC, 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      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":";;;;AA8BA,SAAS,aAAa,OAAsD;AAC1E,KAAI,SAAS,KAAM,QAAO,KAAA;AAE1B,QADgB,MAAM,MACR,IAAI,KAAA;;AAGpB,SAAS,aAAa,OAAiD;AACrE,KAAI,SAAS,KAAM,QAAO;AAE1B,QADgB,MAAM,MACR,IAAI;;AAGpB,SAAS,eAAe,KAA0B;AAChD,QAAO;EACL,IAAI,IAAI;EACR,MAAM,IAAI;EACV,MAAM,IAAI;EACV,aAAa,IAAI,eAAe,KAAA;EAChC,QAAQ,IAAI;EACZ,gBAAgB,IAAI,oBAAoB,KAAA;EACxC,eAAe,IAAI,kBAAkB,KAAA;EACrC,OAAO,IAAI,SAAS,KAAA;EACpB,cAAc,IAAI,gBAAgB,KAAA;EAClC,WAAW,IAAI;EACf,WAAW,IAAI;EACf,cAAc,IAAI,kBAAkB,KAAA;EACrC;;AAGH,SAAS,WAAW,OAA2B,WAAW,IAAY;AACpE,QAAO,KAAK,IAAI,KAAK,KAAK,IAAI,GAAG,KAAK,MAAM,SAAS,SAAS,CAAC,CAAC;;AAGlE,SAAS,cAAc,MAAsB;CAC3C,MAAM,UAAU,KAAK,MAAM;AAC3B,KAAI,CAAC,QAAS,OAAM,IAAI,MAAM,2BAA2B;AACzD,QAAO;;AAGT,SAAgB,mBAAmB,MAAsB;AASvD,QARa,KACV,MAAM,CACN,aAAa,CACb,UAAU,OAAO,CACjB,QAAQ,oBAAoB,GAAG,CAC/B,QAAQ,oBAAoB,IAAI,CAChC,QAAQ,YAAY,GAAG,CACvB,MAAM,GAAG,GACD,IAAI,WAAW,KAAK,KAAK;;AAGtC,SAAS,kBAAkB,QAA4C;AACrE,SAAQ,QAAR;EACE,KAAK,YACH,QAAO;EACT,KAAK,OACH,QAAO;EAET,QACE,QAAO;;;AAIb,SAAS,sBAAsB,QAA4C;CACzE,MAAM,SAAS,kBAAkB,OAAO;AACxC,QAAO,WAAW,gBAAgB,kBAAkB,KAAK;;AAG3D,SAAS,kBAAkB,SAA0B;AACnD,QAAO;EACL,QAAQ;EACR,QAAQ;EACR,QAAQ;EACR,QAAQ;EACR,QAAQ;EACR,QAAQ;EACR,QAAQ;EACT,CACE,QAAQ,UAA2B,QAAQ,OAAO,MAAM,CAAC,CAAC,CAC1D,KAAK,KAAK;;AAGf,SAAS,eACP,IACA,SACM;AACN,IAAG,QAAQ,gDAAgD,CAAC,IAAI,QAAQ,GAAG;AAC3E,IAAG,QAAQ,+DAA+D,CAAC,IACzE,kBAAkB,QAAQ,EAC1B,QAAQ,GACT;;AAGH,IAAa,eAAb,MAA0B;CACxB,OAAO,OAAoC;EACzC,MAAM,MAAM,KAAK,KAAK;EACtB,MAAM,OAAO,cAAc,MAAM,KAAK;EACtC,MAAM,OAAO,MAAM,MAAM,MAAM,IAAI,mBAAmB,KAAK;EAC3D,MAAM,UAAmB;GACvB,IAAI,YAAY;GAChB;GACA;GACA,aAAa,aAAa,MAAM,YAAY;GAC5C,QAAQ;GACR,gBAAgB,aAAa,MAAM,eAAe;GAClD,eAAe,aAAa,MAAM,cAAc;GAChD,OAAO,aAAa,MAAM,MAAM;GAChC,cAAc,aAAa,MAAM,aAAa;GAC9C,WAAW;GACX,WAAW;GACX,cAAc;GACf;AAED,6BAA2B,OAAO;AAChC,MAAG,QACD;;;uDAID,CAAC,IACA,QAAQ,IACR,QAAQ,MACR,QAAQ,MACR,QAAQ,eAAe,MACvB,QAAQ,QACR,QAAQ,kBAAkB,MAC1B,QAAQ,iBAAiB,MACzB,QAAQ,SAAS,MACjB,QAAQ,gBAAgB,MACxB,QAAQ,WACR,QAAQ,WACR,QAAQ,gBAAgB,KACzB;AACD,kBAAe,IAAI,QAAQ;IAC3B;AACF,SAAO;;CAGT,IAAI,IAA4B;EAC9B,MAAM,MAAM,mBAAmB,CAC5B,QAAQ,8CAA8C,CACtD,IAAI,GAAG;AACV,SAAO,MAAM,eAAe,IAAI,GAAG;;CAGrC,WAAW,MAA8B;EACvC,MAAM,MAAM,mBAAmB,CAC5B,QAAQ,wCAAwC,CAChD,IAAI,KAAK,MAAM,CAAC;AACnB,SAAO,MAAM,eAAe,IAAI,GAAG;;CAGrC,KAAK,QAA0B,EAAE,EAAqB;EACpD,MAAM,aAAuB,EAAE;EAC/B,MAAM,SAAiC,EAAE;EACzC,MAAM,SAAS,MAAM,QAAQ,MAAM;EACnC,MAAM,WAAW,SAAS,gBAAgB,OAAO,GAAG;AACpD,MAAI,MAAM,QAAQ;GAChB,MAAM,WAAW,MAAM,QAAQ,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,MAAM,OAAO;AAC5E,cAAW,KAAK,gBAAgB,SAAS,UAAU,IAAI,CAAC,KAAK,KAAK,CAAC,GAAG;AACtE,UAAO,KAAK,GAAG,SAAS;;AAE1B,MAAI,UAAU;AACZ,cAAW,KAAK,mFAAmF;AACnG,UAAO,KAAK,SAAS;;EAEvB,MAAM,QAAQ,WAAW,SAAS,SAAS,WAAW,KAAK,QAAQ,KAAK;EACxE,MAAM,QAAQ,WAAW,MAAM,OAAO,GAAG;EACzC,MAAM,SAAS,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,UAAU,EAAE,CAAC;EACzD,MAAM,YAAY,MAAM,cAAc,QAAQ,QAAQ;EACtD,MAAM,aAAa,sBAAsB,MAAM,OAAO;EACtD,MAAM,KAAK,mBAAmB;EAC9B,MAAM,QAAS,GAAG,QAAQ,4CAA4C,QAAQ,CAAC,IAAI,GAAG,OAAO,CAAuB;AAIpH,SAAO;GAAE,OAHI,GACV,QAAQ,8BAA8B,MAAM,YAAY,WAAW,GAAG,UAAU,mBAAmB,CACnG,IAAI,GAAG,QAAQ,OAAO,OACL,CAAC,IAAI,eAAe;GAAE;GAAO;GAAO;GAAQ,SAAS,SAAS,QAAQ;GAAO;;CAGnG,wBAAwB,QAAiC,EAAE,EAAqB;EAC9E,MAAM,oBAA8B,EAAE;EACtC,MAAM,oBAAoB,CACxB,kCACA,0BACD;EACD,MAAM,SAAiC,EAAE;AAEzC,MAAI,MAAM,QAAQ;GAChB,MAAM,WAAW,MAAM,QAAQ,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,MAAM,OAAO;AAC5E,qBAAkB,KAAK,gBAAgB,SAAS,UAAU,IAAI,CAAC,KAAK,KAAK,CAAC,GAAG;AAC7E,UAAO,KAAK,GAAG,SAAS;;AAG1B,MAAI,MAAM,iBAAiB,KAAA,GAAW;GACpC,MAAM,UAAU,CAAC,oBAAoB;AACrC,UAAO,KAAK,MAAM,aAAa;AAC/B,OAAI,MAAM,cACR,SAAQ,KAAK,sBAAsB;GAErC,MAAM,oBAAoB,MAAM,mBAAmB,MAAM;AACzD,OAAI,mBAAmB;AACrB,YAAQ,KAAK,oBAAoB;AACjC,WAAO,KAAK,kBAAkB;;AAEhC,qBAAkB,KAAK,IAAI,QAAQ,KAAK,OAAO,CAAC,GAAG;;EAGrD,MAAM,aAAa,CAAC,GAAG,mBAAmB,GAAG,kBAAkB;EAC/D,MAAM,QAAQ,WAAW,SAAS,SAAS,WAAW,KAAK,QAAQ,KAAK;EACxE,MAAM,QAAQ,WAAW,MAAM,OAAO,GAAG;EACzC,MAAM,SAAS,KAAK,IAAI,GAAG,KAAK,MAAM,MAAM,UAAU,EAAE,CAAC;EACzD,MAAM,KAAK,mBAAmB;EAC9B,MAAM,QAAS,GACZ,QACC;;;WAGG,QACJ,CACA,IAAI,GAAG,OAAO,CAAuB;AAYxC,SAAO;GAAE,OAXI,GACV,QACC;;;WAGG,MAAM;;;2BAIV,CACA,IAAI,GAAG,QAAQ,OAAO,OACL,CAAC,IAAI,eAAe;GAAE;GAAO;GAAO;GAAQ,SAAS,SAAS,QAAQ;GAAO;;CAGnG,OAAO,IAAY,OAAoC;EACrD,MAAM,SAAS,KAAK,IAAI,GAAG;AAC3B,MAAI,CAAC,OAAQ,OAAM,IAAI,MAAM,sBAAsB,KAAK;EACxD,MAAM,OAAO;GACX,GAAG;GACH,GAAI,MAAM,SAAS,KAAA,IAAY,EAAE,MAAM,cAAc,MAAM,KAAK,EAAE,GAAG,EAAE;GACvE,GAAI,MAAM,gBAAgB,KAAA,IAAY,EAAE,aAAa,aAAa,MAAM,YAAY,IAAI,KAAA,GAAW,GAAG,EAAE;GACxG,GAAI,MAAM,WAAW,KAAA,IAAY,EAAE,QAAQ,MAAM,QAAQ,GAAG,EAAE;GAC9D,GAAI,MAAM,mBAAmB,KAAA,IAAY,EAAE,gBAAgB,aAAa,MAAM,eAAe,IAAI,KAAA,GAAW,GAAG,EAAE;GACjH,GAAI,MAAM,kBAAkB,KAAA,IAAY,EAAE,eAAe,aAAa,MAAM,cAAc,IAAI,KAAA,GAAW,GAAG,EAAE;GAC9G,GAAI,MAAM,UAAU,KAAA,IAAY,EAAE,OAAO,aAAa,MAAM,MAAM,IAAI,KAAA,GAAW,GAAG,EAAE;GACtF,GAAI,MAAM,iBAAiB,KAAA,IAAY,EAAE,cAAc,aAAa,MAAM,aAAa,IAAI,KAAA,GAAW,GAAG,EAAE;GAC3G,WAAW,KAAK,KAAK;GACtB;AAED,6BAA2B,OAAO;AAChC,MAAG,QACD;;+BAGD,CAAC,IACA,KAAK,MACL,KAAK,eAAe,MACpB,KAAK,QACL,KAAK,kBAAkB,MACvB,KAAK,iBAAiB,MACtB,KAAK,SAAS,MACd,KAAK,gBAAgB,MACrB,KAAK,WACL,GACD;AACD,kBAAe,IAAI,KAAK;IACxB;AACF,SAAO,KAAK,IAAI,GAAG;;CAGrB,OAAO,IAAkB;AACvB,6BAA2B,OAAO;AAChC,MAAG,QAAQ,6DAA6D,CAAC,IAAI,GAAG;AAChF,MAAG,QAAQ,0DAA0D,CAAC,IAAI,GAAG;AAC7E,MAAG,QAAQ,kEAAkE,CAAC,IAAI,GAAG;AACrF,MAAG,QAAQ,gEAAgE,CAAC,IAAI,GAAG;AACnF,MAAG,QAAQ,mEAAmE,CAAC,IAAI,GAAG;AACtF,MAAG,QAAQ,gDAAgD,CAAC,IAAI,GAAG;AACnE,MAAG,QAAQ,4CAA4C,CAAC,IAAI,GAAG;IAC/D;;CAGJ,gBAAgB,IAAoB;AAClC,SAAQ,mBAAmB,CACxB,QAAQ,+FAA+F,CACvG,IAAI,GAAG,CAAuB;;CAGnC,aAAa,IAAoB;AAC/B,SAAQ,mBAAmB,CAAC,QAAQ,2DAA2D,CAAC,IAAI,GAAG,CAAuB;;CAGhI,mBAAmB,IAAoB;AACrC,SAAQ,mBAAmB,CACxB,QAAQ,wHAAwH,CAChI,IAAI,GAAG,CAAuB;;CAGnC,kBAAkB,IAAY,QAAQ,GAAyC;AAO7E,SANa,mBAAmB,CAC7B,QACC;iGAED,CACA,IAAI,IAAI,WAAW,OAAO,EAAE,CACpB,CAAC,KAAK,SAAS;GACxB,KAAK,IAAI;GACT,MAAM,IAAI,QAAQ,KAAA;GAClB,WAAW,IAAI,KAAK,IAAI,WAAW,CAAC,aAAa;GACjD,SAAS,IAAI;GACd,EAAE;;CAGL,sBAAsB,IAAY,QAAQ,GAA6C;AAOrF,SANa,mBAAmB,CAC7B,QACC;mEAED,CACA,IAAI,IAAI,WAAW,OAAO,EAAE,CACpB,CAAC,KAAK,SAAS;GAAE,OAAO,IAAI;GAAQ,cAAc,IAAI;GAAe,QAAQ,IAAI;GAAQ,WAAW,IAAI;GAAe,EAAE;;CAGtI,eAAe,IAAuC;EACpD,MAAM,UAAU,KAAK,IAAI,GAAG;AAC5B,MAAI,CAAC,QAAS,QAAO;AACrB,SAAO;GACL,GAAG;GACH,cAAc,KAAK,gBAAgB,GAAG;GACtC,WAAW,KAAK,aAAa,GAAG;GAChC,iBAAiB,KAAK,mBAAmB,GAAG;GAC5C,gBAAgB,KAAK,kBAAkB,GAAG;GAC1C,oBAAoB,KAAK,sBAAsB,GAAG;GACnD;;CAGH,aAAa,MAAsB;EACjC,MAAM,OAAO,mBAAmB,KAAK;EACrC,IAAI,YAAY;EAChB,IAAI,UAAU;AACd,SAAO,KAAK,WAAW,UAAU,EAAE;AACjC,eAAY,GAAG,KAAK,GAAG;AACvB,cAAW;;AAEb,SAAO"}
+{"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

@@ -15,6 +15,7 @@ export interface Project {
     createdAt: number;
     updatedAt: number;
     lastActiveAt?: number;
+    pinnedAt?: number;
 }
 export interface ProjectWithDetails extends Project {
     sessionCount: number;
@@ -69,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/session/session-title.js

@@ -32,12 +32,32 @@ function extractTextFromMessage(m) {
 function firstUserText(messages) {
 	const u = messages.find((m) => m.role === "user");
 	if (!u) return "";
-	return stripMediaClaimChecks(stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText(extractTextFromMessage(u))));
+	return normalizeUserTextForTitle(extractTextFromMessage(u));
 }
 function stripMediaClaimChecks(text) {
 	if (!text.includes("[media attached:") && !text.includes("xopc-media-uri:")) return text;
 	return text.replace(/\s*\[media attached:[^\]]+\]\s*\r?\nxopc-media-uri:[^\r\n]+\r?\n\s*xopc-media-path:[^\r\n]+(?:\r?\n\s*Use the read_media tool[^\r\n]*)?/g, "").replace(/\s*\[media attached:[^\]]+\]\s*/g, " ").replace(/\s*xopc-media-uri:[^\r\n]+/g, "").replace(/\s*xopc-media-path:[^\r\n]+/g, "").replace(/\s*Use the read_media tool[^\r\n]*/g, "").replace(/\n{3,}/g, "\n\n").trim();
 }
+function stripExpandedSkillBlockForTitle(text) {
+	const trimmed = text.trimStart();
+	if (!/^##\s+Skill:\s*\S+/i.test(trimmed)) return text;
+	const markerRe = /(?:^|\r?\n)\*\*Arguments\*\*:\s*/gi;
+	let argsStart = -1;
+	while (markerRe.exec(trimmed) !== null) argsStart = markerRe.lastIndex;
+	if (argsStart !== -1) {
+		const args = trimmed.slice(argsStart).trim();
+		if (args) return args;
+	}
+	return (trimmed.split(/\r?\n/)[0]?.trim() ?? "").replace(/^##\s+Skill:\s*/i, "").trim();
+}
+function stripSkillCommandForTitle(text) {
+	const match = text.trimStart().match(/^\/skill:([^\s]+)(?:\s+([\s\S]*))?$/i);
+	if (!match) return text;
+	return match[2]?.trim() || match[1]?.trim() || text;
+}
+function normalizeUserTextForTitle(raw) {
+	return stripSkillCommandForTitle(stripExpandedSkillBlockForTitle(stripMediaClaimChecks(stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText(raw))))).trim();
+}
 /** First assistant message that has visible text (skips tool-only assistant rows). */
 function firstAssistantText(messages) {
 	for (const m of messages) if (m.role === "assistant") {
@@ -73,7 +93,7 @@ function getSessionTitleSource(meta) {
 }
 /** Title from a single user message (first line), for immediate sidebar labels. */
 function provisionalTitleFromUserText(raw) {
-	const text = stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText((raw ?? "").trim()));
+	const text = normalizeUserTextForTitle((raw ?? "").trim());
 	if (!text) return null;
 	const line = text.split(/\n/)[0]?.trim();
 	if (!line) return null;

package/dist/src/session/session-title.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-title.js","names":[],"sources":["../../../src/session/session-title.ts"],"sourcesContent":["/**\n * LLM-generated session titles (webchat and any path using SessionStore).\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai/compat';\n\nimport { stripSessionStartupContextFromUserText } from '../agent/reply/startup-context.js';\nimport { stripEnvelopeTimestampPrefix } from '../channels/envelope-timestamp.js';\nimport { isCronSessionKey, parseSessionKey } from '../routing/session-key.js';\nimport { resolveModel } from '../providers/index.js';\nimport { createLogger } from '../utils/logger.js';\nimport { readAgentMessageContent } from '../agent/memory/agent-message-access.js';\nimport type { SessionStore } from './store.js';\n\nconst log = createLogger('SessionAutoTitle');\n\nconst MAX_TITLE_LEN = 80;\n\n/** Collect visible text from any content block that exposes `text` (pi-ai / OpenAI / Anthropic shapes). */\nfunction extractTextFromMessage(m: AgentMessage): string {\n  const raw = readAgentMessageContent(m);\n  if (typeof raw === 'string') return raw.trim();\n  if (Array.isArray(raw)) {\n    const parts: string[] = [];\n    for (const c of raw) {\n      if (c && typeof c === 'object') {\n        const o = c as unknown as Record<string, unknown>;\n        const type = typeof o.type === 'string' ? o.type : '';\n        if (type === 'toolCall' || type === 'tool_use' || type === 'tool_result') continue;\n        if (typeof o.text === 'string' && o.text.trim()) {\n          parts.push(o.text.trim());\n        }\n      }\n    }\n    return parts.join(' ').trim();\n  }\n  return '';\n}\n\nfunction firstUserText(messages: AgentMessage[]): string {\n  const u = messages.find((m) => m.role === 'user');\n  if (!u) return '';\n  const raw = extractTextFromMessage(u);\n  return stripMediaClaimChecks(stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText(raw)));\n}\n\nfunction stripMediaClaimChecks(text: string): string {\n  if (!text.includes('[media attached:') && !text.includes('xopc-media-uri:')) {\n    return text;\n  }\n  return text\n    .replace(\n      /\\s*\\[media attached:[^\\]]+\\]\\s*\\r?\\nxopc-media-uri:[^\\r\\n]+\\r?\\n\\s*xopc-media-path:[^\\r\\n]+(?:\\r?\\n\\s*Use the read_media tool[^\\r\\n]*)?/g,\n      '',\n    )\n    .replace(/\\s*\\[media attached:[^\\]]+\\]\\s*/g, ' ')\n    .replace(/\\s*xopc-media-uri:[^\\r\\n]+/g, '')\n    .replace(/\\s*xopc-media-path:[^\\r\\n]+/g, '')\n    .replace(/\\s*Use the read_media tool[^\\r\\n]*/g, '')\n    .replace(/\\n{3,}/g, '\\n\\n')\n    .trim();\n}\n\n/** First assistant message that has visible text (skips tool-only assistant rows). */\nfunction firstAssistantText(messages: AgentMessage[]): string {\n  for (const m of messages) {\n    if (m.role === 'assistant') {\n      const t = extractTextFromMessage(m);\n      if (t.length > 0) return t;\n    }\n  }\n  return '';\n}\n\nexport function isWebchatSessionKey(sessionKey: string): boolean {\n  const p = parseSessionKey(sessionKey);\n  if (p?.source === 'webchat') return true;\n  return sessionKey.includes(':webchat:');\n}\n\n/** Whether to run LLM/fallback session naming for this key (excludes cron, heartbeat). */\nexport function shouldAutoTitleSessionKey(sessionKey: string): boolean {\n  const raw = (sessionKey ?? '').trim();\n  if (!raw) return false;\n  if (isCronSessionKey(raw)) return false;\n  if (raw.toLowerCase().startsWith('heartbeat:')) return false;\n  return true;\n}\n\nexport function sanitizeSessionTitle(raw: string): string {\n  let s = raw.trim();\n  if ((s.startsWith('\"') && s.endsWith('\"')) || (s.startsWith(\"'\") && s.endsWith(\"'\"))) {\n    s = s.slice(1, -1).trim();\n  }\n  const lineBreak = s.indexOf('\\n');\n  if (lineBreak !== -1) s = s.slice(0, lineBreak).trim();\n  if (s.length > MAX_TITLE_LEN) s = s.slice(0, MAX_TITLE_LEN - 1).trimEnd() + '…';\n  return s;\n}\n\nexport type SessionTitleSource = 'provisional' | 'llm' | 'user';\n\nexport function getSessionTitleSource(\n  meta: { customData?: Record<string, unknown> } | null | undefined,\n): SessionTitleSource | null {\n  const raw = meta?.customData?.titleSource;\n  if (raw === 'provisional' || raw === 'llm' || raw === 'user') return raw;\n  return null;\n}\n\n/** Title from a single user message (first line), for immediate sidebar labels. */\nexport function provisionalTitleFromUserText(raw: string): string | null {\n  const text = stripEnvelopeTimestampPrefix(\n    stripSessionStartupContextFromUserText((raw ?? '').trim()),\n  );\n  if (!text) return null;\n  const line = text.split(/\\n/)[0]?.trim();\n  if (!line) return null;\n  return sanitizeSessionTitle(line);\n}\n\n/** Non-LLM title: first line of first user text, else first assistant line. */\nexport function fallbackTitleFromMessages(messages: AgentMessage[]): string | null {\n  const u = firstUserText(messages);\n  if (u) {\n    const line = u.split(/\\n/)[0]?.trim();\n    if (line) return sanitizeSessionTitle(line);\n  }\n  const a = firstAssistantText(messages);\n  if (a) {\n    const line = a.split(/\\n/)[0]?.trim();\n    if (line) return sanitizeSessionTitle(line);\n  }\n  return null;\n}\n\n/**\n * Returns a title string, or null if generation should be skipped or failed.\n */\nexport async function generateSessionTitleFromMessages(\n  modelRef: string,\n  messages: AgentMessage[],\n  signal?: AbortSignal,\n): Promise<string | null> {\n  const userText = firstUserText(messages);\n  const assistantText = firstAssistantText(messages);\n  if (!userText && !assistantText) return null;\n\n  let model: ReturnType<typeof resolveModel>;\n  try {\n    model = resolveModel(modelRef);\n  } catch (err) {\n    log.warn({ err, modelRef }, 'Cannot resolve model for session title');\n    return null;\n  }\n\n  const prompt =\n    userText && assistantText\n      ? `You label chat sessions. Given the first user message and the start of the assistant reply, output ONE short title (max 8 words). No quotes. No punctuation at the end. Use the same language as the user when possible.\n\nUser: ${userText.slice(0, 2000)}\n\nAssistant: ${assistantText.slice(0, 2000)}\n\nTitle:`\n      : userText\n        ? `The assistant reply only used tools (no visible text yet). Output ONE short title (max 8 words) based only on the user's first message. No quotes. No punctuation at the end. Use the same language as the user.\n\nUser: ${userText.slice(0, 2000)}\n\nTitle:`\n        : `Output ONE short title (max 8 words) for this assistant reply. No quotes. No punctuation at the end.\n\nAssistant: ${assistantText!.slice(0, 2000)}\n\nTitle:`;\n\n  const userMsg: UserMessage = { role: 'user', content: prompt, timestamp: Date.now() };\n\n  try {\n    const result = await complete(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: 64,\n        temperature: 0.35,\n        signal: signal as AbortSignal,\n      },\n    );\n\n    let text = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          text += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n\n    const cleaned = sanitizeSessionTitle(text);\n    return cleaned.length > 0 ? cleaned : null;\n  } catch (err) {\n    log.warn({ err }, 'Session title LLM call failed');\n    return null;\n  }\n}\n\nexport type SessionTitleUpdatedHook = (sessionKey: string, name: string) => void | Promise<void>;\n\n/** Whether post-turn LLM refine may run (provisional or still unnamed; not user-locked). */\nexport function shouldRefineSessionTitleWithLlm(\n  meta: { name?: string; customData?: Record<string, unknown> } | null | undefined,\n): boolean {\n  if (!meta) return false;\n  const source = getSessionTitleSource(meta);\n  if (source === 'user') return false;\n  if (meta.name?.trim()) return source === 'provisional';\n  return true;\n}\n\nfunction canAutoWriteTitle(meta: { name?: string; customData?: Record<string, unknown> } | null): boolean {\n  if (!meta) return false;\n  const source = getSessionTitleSource(meta);\n  if (source === 'user') return false;\n  return !meta.name?.trim();\n}\n\n/**\n * Set provisional title from first user text when session is still unnamed.\n * Skips cron/heartbeat keys and user-locked titles.\n */\nexport async function maybeSetProvisionalSessionTitle(\n  sessionStore: SessionStore,\n  sessionKey: string,\n  userText?: string,\n  onUpdated?: SessionTitleUpdatedHook,\n): Promise<void> {\n  if (!shouldAutoTitleSessionKey(sessionKey)) return;\n\n  let meta = await sessionStore.getMetadata(sessionKey);\n  if (!meta) return;\n  if (!canAutoWriteTitle(meta)) return;\n\n  let title: string | null = null;\n  if (userText?.trim()) {\n    title = provisionalTitleFromUserText(userText);\n  }\n  if (!title) {\n    const messages = await sessionStore.load(sessionKey);\n    if (!messages.length) return;\n    title = fallbackTitleFromMessages(messages);\n  }\n  if (!title) return;\n\n  try {\n    await sessionStore.updateMetadata(sessionKey, {\n      name: title,\n      customData: { ...(meta.customData ?? {}), titleSource: 'provisional' },\n    });\n    await onUpdated?.(sessionKey, title);\n  } catch (err) {\n    log.warn({ err, sessionKey }, 'Session title: provisional updateMetadata failed');\n  }\n}\n\n/**\n * LLM refine when title is empty or still provisional (not user-locked).\n */\nexport async function maybeRefineSessionTitleWithLlm(\n  sessionStore: SessionStore,\n  sessionKey: string,\n  modelRef: string | undefined,\n  onUpdated?: SessionTitleUpdatedHook,\n): Promise<void> {\n  if (!shouldAutoTitleSessionKey(sessionKey)) return;\n\n  let messages = await sessionStore.load(sessionKey);\n  if (!messages.length) return;\n\n  let meta = await sessionStore.getMetadata(sessionKey);\n  if (!meta) {\n    await sessionStore.saveMessages(sessionKey, messages);\n    meta = await sessionStore.getMetadata(sessionKey);\n  }\n  if (!meta) {\n    log.warn({ sessionKey }, 'Session title: metadata missing after save');\n    return;\n  }\n  if (!shouldRefineSessionTitleWithLlm(meta)) return;\n\n  const source = getSessionTitleSource(meta);\n  let title: string | null = null;\n  const ref = modelRef?.trim();\n  if (ref) {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), 25_000);\n    try {\n      title = await generateSessionTitleFromMessages(ref, messages, controller.signal);\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n  if (!title) {\n    title = fallbackTitleFromMessages(messages);\n  }\n  if (!title) return;\n\n  const existing = meta.name?.trim();\n  if (existing === title) {\n    if (source !== 'llm') {\n      try {\n        await sessionStore.updateMetadata(sessionKey, {\n          customData: { ...(meta.customData ?? {}), titleSource: 'llm' },\n        });\n      } catch {\n        /* ignore */\n      }\n    }\n    return;\n  }\n\n  try {\n    await sessionStore.updateMetadata(sessionKey, {\n      name: title,\n      customData: { ...(meta.customData ?? {}), titleSource: 'llm' },\n    });\n    await onUpdated?.(sessionKey, title);\n  } catch (err) {\n    log.warn({ err, sessionKey }, 'Session title: refine updateMetadata failed');\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"session-title.js","names":[],"sources":["../../../src/session/session-title.ts"],"sourcesContent":["/**\n * LLM-generated session titles (webchat and any path using SessionStore).\n */\n\nimport type { AgentMessage } from '@earendil-works/pi-agent-core';\nimport { complete, type UserMessage } from '@earendil-works/pi-ai/compat';\n\nimport { stripSessionStartupContextFromUserText } from '../agent/reply/startup-context.js';\nimport { stripEnvelopeTimestampPrefix } from '../channels/envelope-timestamp.js';\nimport { isCronSessionKey, parseSessionKey } from '../routing/session-key.js';\nimport { resolveModel } from '../providers/index.js';\nimport { createLogger } from '../utils/logger.js';\nimport { readAgentMessageContent } from '../agent/memory/agent-message-access.js';\nimport type { SessionStore } from './store.js';\n\nconst log = createLogger('SessionAutoTitle');\n\nconst MAX_TITLE_LEN = 80;\n\n/** Collect visible text from any content block that exposes `text` (pi-ai / OpenAI / Anthropic shapes). */\nfunction extractTextFromMessage(m: AgentMessage): string {\n  const raw = readAgentMessageContent(m);\n  if (typeof raw === 'string') return raw.trim();\n  if (Array.isArray(raw)) {\n    const parts: string[] = [];\n    for (const c of raw) {\n      if (c && typeof c === 'object') {\n        const o = c as unknown as Record<string, unknown>;\n        const type = typeof o.type === 'string' ? o.type : '';\n        if (type === 'toolCall' || type === 'tool_use' || type === 'tool_result') continue;\n        if (typeof o.text === 'string' && o.text.trim()) {\n          parts.push(o.text.trim());\n        }\n      }\n    }\n    return parts.join(' ').trim();\n  }\n  return '';\n}\n\nfunction firstUserText(messages: AgentMessage[]): string {\n  const u = messages.find((m) => m.role === 'user');\n  if (!u) return '';\n  const raw = extractTextFromMessage(u);\n  return normalizeUserTextForTitle(raw);\n}\n\nfunction stripMediaClaimChecks(text: string): string {\n  if (!text.includes('[media attached:') && !text.includes('xopc-media-uri:')) {\n    return text;\n  }\n  return text\n    .replace(\n      /\\s*\\[media attached:[^\\]]+\\]\\s*\\r?\\nxopc-media-uri:[^\\r\\n]+\\r?\\n\\s*xopc-media-path:[^\\r\\n]+(?:\\r?\\n\\s*Use the read_media tool[^\\r\\n]*)?/g,\n      '',\n    )\n    .replace(/\\s*\\[media attached:[^\\]]+\\]\\s*/g, ' ')\n    .replace(/\\s*xopc-media-uri:[^\\r\\n]+/g, '')\n    .replace(/\\s*xopc-media-path:[^\\r\\n]+/g, '')\n    .replace(/\\s*Use the read_media tool[^\\r\\n]*/g, '')\n    .replace(/\\n{3,}/g, '\\n\\n')\n    .trim();\n}\n\nfunction stripExpandedSkillBlockForTitle(text: string): string {\n  const trimmed = text.trimStart();\n  if (!/^##\\s+Skill:\\s*\\S+/i.test(trimmed)) {\n    return text;\n  }\n\n  const markerRe = /(?:^|\\r?\\n)\\*\\*Arguments\\*\\*:\\s*/gi;\n  let argsStart = -1;\n  while (markerRe.exec(trimmed) !== null) {\n    argsStart = markerRe.lastIndex;\n  }\n\n  if (argsStart !== -1) {\n    const args = trimmed.slice(argsStart).trim();\n    if (args) return args;\n  }\n\n  const firstLine = trimmed.split(/\\r?\\n/)[0]?.trim() ?? '';\n  return firstLine.replace(/^##\\s+Skill:\\s*/i, '').trim();\n}\n\nfunction stripSkillCommandForTitle(text: string): string {\n  const trimmed = text.trimStart();\n  const match = trimmed.match(/^\\/skill:([^\\s]+)(?:\\s+([\\s\\S]*))?$/i);\n  if (!match) {\n    return text;\n  }\n  const args = match[2]?.trim();\n  return args || match[1]?.trim() || text;\n}\n\nfunction normalizeUserTextForTitle(raw: string): string {\n  return stripSkillCommandForTitle(\n    stripExpandedSkillBlockForTitle(\n      stripMediaClaimChecks(\n        stripEnvelopeTimestampPrefix(stripSessionStartupContextFromUserText(raw)),\n      ),\n    ),\n  ).trim();\n}\n\n/** First assistant message that has visible text (skips tool-only assistant rows). */\nfunction firstAssistantText(messages: AgentMessage[]): string {\n  for (const m of messages) {\n    if (m.role === 'assistant') {\n      const t = extractTextFromMessage(m);\n      if (t.length > 0) return t;\n    }\n  }\n  return '';\n}\n\nexport function isWebchatSessionKey(sessionKey: string): boolean {\n  const p = parseSessionKey(sessionKey);\n  if (p?.source === 'webchat') return true;\n  return sessionKey.includes(':webchat:');\n}\n\n/** Whether to run LLM/fallback session naming for this key (excludes cron, heartbeat). */\nexport function shouldAutoTitleSessionKey(sessionKey: string): boolean {\n  const raw = (sessionKey ?? '').trim();\n  if (!raw) return false;\n  if (isCronSessionKey(raw)) return false;\n  if (raw.toLowerCase().startsWith('heartbeat:')) return false;\n  return true;\n}\n\nexport function sanitizeSessionTitle(raw: string): string {\n  let s = raw.trim();\n  if ((s.startsWith('\"') && s.endsWith('\"')) || (s.startsWith(\"'\") && s.endsWith(\"'\"))) {\n    s = s.slice(1, -1).trim();\n  }\n  const lineBreak = s.indexOf('\\n');\n  if (lineBreak !== -1) s = s.slice(0, lineBreak).trim();\n  if (s.length > MAX_TITLE_LEN) s = s.slice(0, MAX_TITLE_LEN - 1).trimEnd() + '…';\n  return s;\n}\n\nexport type SessionTitleSource = 'provisional' | 'llm' | 'user';\n\nexport function getSessionTitleSource(\n  meta: { customData?: Record<string, unknown> } | null | undefined,\n): SessionTitleSource | null {\n  const raw = meta?.customData?.titleSource;\n  if (raw === 'provisional' || raw === 'llm' || raw === 'user') return raw;\n  return null;\n}\n\n/** Title from a single user message (first line), for immediate sidebar labels. */\nexport function provisionalTitleFromUserText(raw: string): string | null {\n  const text = normalizeUserTextForTitle((raw ?? '').trim());\n  if (!text) return null;\n  const line = text.split(/\\n/)[0]?.trim();\n  if (!line) return null;\n  return sanitizeSessionTitle(line);\n}\n\n/** Non-LLM title: first line of first user text, else first assistant line. */\nexport function fallbackTitleFromMessages(messages: AgentMessage[]): string | null {\n  const u = firstUserText(messages);\n  if (u) {\n    const line = u.split(/\\n/)[0]?.trim();\n    if (line) return sanitizeSessionTitle(line);\n  }\n  const a = firstAssistantText(messages);\n  if (a) {\n    const line = a.split(/\\n/)[0]?.trim();\n    if (line) return sanitizeSessionTitle(line);\n  }\n  return null;\n}\n\n/**\n * Returns a title string, or null if generation should be skipped or failed.\n */\nexport async function generateSessionTitleFromMessages(\n  modelRef: string,\n  messages: AgentMessage[],\n  signal?: AbortSignal,\n): Promise<string | null> {\n  const userText = firstUserText(messages);\n  const assistantText = firstAssistantText(messages);\n  if (!userText && !assistantText) return null;\n\n  let model: ReturnType<typeof resolveModel>;\n  try {\n    model = resolveModel(modelRef);\n  } catch (err) {\n    log.warn({ err, modelRef }, 'Cannot resolve model for session title');\n    return null;\n  }\n\n  const prompt =\n    userText && assistantText\n      ? `You label chat sessions. Given the first user message and the start of the assistant reply, output ONE short title (max 8 words). No quotes. No punctuation at the end. Use the same language as the user when possible.\n\nUser: ${userText.slice(0, 2000)}\n\nAssistant: ${assistantText.slice(0, 2000)}\n\nTitle:`\n      : userText\n        ? `The assistant reply only used tools (no visible text yet). Output ONE short title (max 8 words) based only on the user's first message. No quotes. No punctuation at the end. Use the same language as the user.\n\nUser: ${userText.slice(0, 2000)}\n\nTitle:`\n        : `Output ONE short title (max 8 words) for this assistant reply. No quotes. No punctuation at the end.\n\nAssistant: ${assistantText!.slice(0, 2000)}\n\nTitle:`;\n\n  const userMsg: UserMessage = { role: 'user', content: prompt, timestamp: Date.now() };\n\n  try {\n    const result = await complete(\n      model,\n      { messages: [userMsg] },\n      {\n        maxTokens: 64,\n        temperature: 0.35,\n        signal: signal as AbortSignal,\n      },\n    );\n\n    let text = '';\n    if (Array.isArray(result.content)) {\n      for (const c of result.content) {\n        if (c && typeof c === 'object' && (c as { type?: string }).type === 'text') {\n          text += String((c as { text?: string }).text || '');\n        }\n      }\n    }\n\n    const cleaned = sanitizeSessionTitle(text);\n    return cleaned.length > 0 ? cleaned : null;\n  } catch (err) {\n    log.warn({ err }, 'Session title LLM call failed');\n    return null;\n  }\n}\n\nexport type SessionTitleUpdatedHook = (sessionKey: string, name: string) => void | Promise<void>;\n\n/** Whether post-turn LLM refine may run (provisional or still unnamed; not user-locked). */\nexport function shouldRefineSessionTitleWithLlm(\n  meta: { name?: string; customData?: Record<string, unknown> } | null | undefined,\n): boolean {\n  if (!meta) return false;\n  const source = getSessionTitleSource(meta);\n  if (source === 'user') return false;\n  if (meta.name?.trim()) return source === 'provisional';\n  return true;\n}\n\nfunction canAutoWriteTitle(meta: { name?: string; customData?: Record<string, unknown> } | null): boolean {\n  if (!meta) return false;\n  const source = getSessionTitleSource(meta);\n  if (source === 'user') return false;\n  return !meta.name?.trim();\n}\n\n/**\n * Set provisional title from first user text when session is still unnamed.\n * Skips cron/heartbeat keys and user-locked titles.\n */\nexport async function maybeSetProvisionalSessionTitle(\n  sessionStore: SessionStore,\n  sessionKey: string,\n  userText?: string,\n  onUpdated?: SessionTitleUpdatedHook,\n): Promise<void> {\n  if (!shouldAutoTitleSessionKey(sessionKey)) return;\n\n  let meta = await sessionStore.getMetadata(sessionKey);\n  if (!meta) return;\n  if (!canAutoWriteTitle(meta)) return;\n\n  let title: string | null = null;\n  if (userText?.trim()) {\n    title = provisionalTitleFromUserText(userText);\n  }\n  if (!title) {\n    const messages = await sessionStore.load(sessionKey);\n    if (!messages.length) return;\n    title = fallbackTitleFromMessages(messages);\n  }\n  if (!title) return;\n\n  try {\n    await sessionStore.updateMetadata(sessionKey, {\n      name: title,\n      customData: { ...(meta.customData ?? {}), titleSource: 'provisional' },\n    });\n    await onUpdated?.(sessionKey, title);\n  } catch (err) {\n    log.warn({ err, sessionKey }, 'Session title: provisional updateMetadata failed');\n  }\n}\n\n/**\n * LLM refine when title is empty or still provisional (not user-locked).\n */\nexport async function maybeRefineSessionTitleWithLlm(\n  sessionStore: SessionStore,\n  sessionKey: string,\n  modelRef: string | undefined,\n  onUpdated?: SessionTitleUpdatedHook,\n): Promise<void> {\n  if (!shouldAutoTitleSessionKey(sessionKey)) return;\n\n  let messages = await sessionStore.load(sessionKey);\n  if (!messages.length) return;\n\n  let meta = await sessionStore.getMetadata(sessionKey);\n  if (!meta) {\n    await sessionStore.saveMessages(sessionKey, messages);\n    meta = await sessionStore.getMetadata(sessionKey);\n  }\n  if (!meta) {\n    log.warn({ sessionKey }, 'Session title: metadata missing after save');\n    return;\n  }\n  if (!shouldRefineSessionTitleWithLlm(meta)) return;\n\n  const source = getSessionTitleSource(meta);\n  let title: string | null = null;\n  const ref = modelRef?.trim();\n  if (ref) {\n    const controller = new AbortController();\n    const timeout = setTimeout(() => controller.abort(), 25_000);\n    try {\n      title = await generateSessionTitleFromMessages(ref, messages, controller.signal);\n    } finally {\n      clearTimeout(timeout);\n    }\n  }\n  if (!title) {\n    title = fallbackTitleFromMessages(messages);\n  }\n  if (!title) return;\n\n  const existing = meta.name?.trim();\n  if (existing === title) {\n    if (source !== 'llm') {\n      try {\n        await sessionStore.updateMetadata(sessionKey, {\n          customData: { ...(meta.customData ?? {}), titleSource: 'llm' },\n        });\n      } catch {\n        /* ignore */\n      }\n    }\n    return;\n  }\n\n  try {\n    await sessionStore.updateMetadata(sessionKey, {\n      name: title,\n      customData: { ...(meta.customData ?? {}), titleSource: 'llm' },\n    });\n    await onUpdated?.(sessionKey, title);\n  } catch (err) {\n    log.warn({ err, sessionKey }, 'Session title: refine updateMetadata failed');\n  }\n}\n"],"mappings":"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"}

package/dist/src/storage/sqlite/migrations/025_project_pinned_at.sql

@@ -0,0 +1,5 @@
+ALTER TABLE projects ADD COLUMN pinned_at INTEGER;
+
+CREATE INDEX IF NOT EXISTS idx_projects_pinned
+  ON projects(pinned_at DESC)
+  WHERE pinned_at IS NOT NULL;

package/dist/src/storage/sqlite/migrations/runner.d.ts

@@ -3,7 +3,7 @@ import type { ApplyMigrationsOptions } from './types.js';
 /** Baseline schema version applied from schema.sql on first open. */
 export declare const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-export declare const XOPC_DB_SCHEMA_VERSION = 24;
+export declare const XOPC_DB_SCHEMA_VERSION = 25;
 export declare function resolveMigrationsDir(override?: string): string;
 /**
  * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.

package/dist/src/storage/sqlite/migrations/runner.js

@@ -12,7 +12,7 @@ const log = createLogger("Sqlite:Migrations");
 /** Baseline schema version applied from schema.sql on first open. */
 const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 /** Latest schema version this release supports (increment when adding migrations). */
-const XOPC_DB_SCHEMA_VERSION = 24;
+const XOPC_DB_SCHEMA_VERSION = 25;
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 function resolveMigrationsDir(override) {
 	if (override) return override;
@@ -46,7 +46,7 @@ function applySingleMigration(db, migration) {
 * Each step runs in its own transaction and updates schema_meta on success.
 */
 function applyPendingMigrations(db, options = {}) {
-	const targetVersion = options.targetVersion ?? 24;
+	const targetVersion = options.targetVersion ?? 25;
 	let currentVersion = readSchemaVersion(db);
 	if (currentVersion > targetVersion) throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);
 	if (currentVersion >= targetVersion) return currentVersion;
@@ -62,7 +62,7 @@ function applyPendingMigrations(db, options = {}) {
 }
 /** Inspect schema version without mutating the database. */
 function inspectSchemaMigrationStatus(db, options = {}) {
-	const appVersion = options.targetVersion ?? 24;
+	const appVersion = options.targetVersion ?? 25;
 	const dbVersion = readSchemaVersion(db);
 	if (dbVersion > appVersion) return {
 		dbVersion,

package/dist/src/storage/sqlite/migrations/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","names":[],"sources":["../../../../../src/storage/sqlite/migrations/runner.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { DatabaseSync } from 'node:sqlite';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { readSchemaVersion, setSchemaVersion } from '../schema-version.js';\nimport { discoverSqlMigrations } from './discover.js';\nimport {\n  DatabaseSchemaMigrationGapError,\n  DatabaseSchemaTooNewError,\n} from './errors.js';\nimport type { ApplyMigrationsOptions, SqlMigration } from './types.js';\n\nconst log = createLogger('Sqlite:Migrations');\n\n/** Baseline schema version applied from schema.sql on first open. */\nexport const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;\n\n/** Latest schema version this release supports (increment when adding migrations). */\nexport const XOPC_DB_SCHEMA_VERSION = 24;\n\nconst MODULE_DIR = dirname(fileURLToPath(import.meta.url));\n\nexport function resolveMigrationsDir(override?: string): string {\n  if (override) {\n    return override;\n  }\n  // Packaged Electron gateway bundle: `out/server/index.js` + `out/server/migrations/`.\n  const siblingDir = join(MODULE_DIR, 'migrations');\n  if (existsSync(siblingDir)) {\n    return siblingDir;\n  }\n  // Dev / dist: SQL files live next to `migrations/runner.js`.\n  return MODULE_DIR;\n}\n\nfunction migrationByTarget(\n  migrations: SqlMigration[],\n  targetVersion: number,\n): SqlMigration | undefined {\n  return migrations.find((migration) => migration.targetVersion === targetVersion);\n}\n\nfunction applySingleMigration(db: DatabaseSync, migration: SqlMigration): void {\n  log.info({ targetVersion: migration.targetVersion, file: migration.filename }, 'Applying SQLite migration');\n  db.exec('BEGIN IMMEDIATE');\n  try {\n    db.exec(migration.sql);\n    setSchemaVersion(db, migration.targetVersion);\n    db.exec('COMMIT');\n  } catch (error) {\n    try {\n      db.exec('ROLLBACK');\n    } catch {\n      /* preserve original error */\n    }\n    const em = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `SQLite migration to v${migration.targetVersion} (${migration.filename}) failed: ${em}`,\n      { cause: error },\n    );\n  }\n}\n\n/**\n * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.\n * Each step runs in its own transaction and updates schema_meta on success.\n */\nexport function applyPendingMigrations(\n  db: DatabaseSync,\n  options: ApplyMigrationsOptions = {},\n): number {\n  const targetVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  let currentVersion = readSchemaVersion(db);\n\n  if (currentVersion > targetVersion) {\n    throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);\n  }\n\n  if (currentVersion >= targetVersion) {\n    return currentVersion;\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n\n  while (currentVersion < targetVersion) {\n    const nextVersion = currentVersion + 1;\n    const migration = migrationByTarget(migrations, nextVersion);\n    if (!migration) {\n      throw new DatabaseSchemaMigrationGapError(currentVersion, targetVersion, nextVersion);\n    }\n    applySingleMigration(db, migration);\n    currentVersion = nextVersion;\n  }\n\n  return currentVersion;\n}\n\nexport type SchemaMigrationStatus = {\n  dbVersion: number;\n  appVersion: number;\n  pendingVersions: number[];\n  isTooNew: boolean;\n  hasMigrationGap: boolean;\n  missingVersion: number | null;\n};\n\n/** Inspect schema version without mutating the database. */\nexport function inspectSchemaMigrationStatus(\n  db: DatabaseSync,\n  options: Pick<ApplyMigrationsOptions, 'migrationsDir' | 'targetVersion'> = {},\n): SchemaMigrationStatus {\n  const appVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  const dbVersion = readSchemaVersion(db);\n  const isTooNew = dbVersion > appVersion;\n\n  if (isTooNew) {\n    return {\n      dbVersion,\n      appVersion,\n      pendingVersions: [],\n      isTooNew: true,\n      hasMigrationGap: false,\n      missingVersion: null,\n    };\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n  const pendingVersions: number[] = [];\n  let hasMigrationGap = false;\n  let missingVersion: number | null = null;\n\n  for (let version = dbVersion + 1; version <= appVersion; version++) {\n    if (migrationByTarget(migrations, version)) {\n      pendingVersions.push(version);\n    } else {\n      hasMigrationGap = true;\n      missingVersion = version;\n      break;\n    }\n  }\n\n  return {\n    dbVersion,\n    appVersion,\n    pendingVersions,\n    isTooNew: false,\n    hasMigrationGap,\n    missingVersion,\n  };\n}\n"],"mappings":";;;;;;;;;aAMwD;AASxD,MAAM,MAAM,aAAa,oBAAoB;;AAG7C,MAAa,kCAAkC;;AAG/C,MAAa,yBAAyB;AAEtC,MAAM,aAAa,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAE1D,SAAgB,qBAAqB,UAA2B;AAC9D,KAAI,SACF,QAAO;CAGT,MAAM,aAAa,KAAK,YAAY,aAAa;AACjD,KAAI,WAAW,WAAW,CACxB,QAAO;AAGT,QAAO;;AAGT,SAAS,kBACP,YACA,eAC0B;AAC1B,QAAO,WAAW,MAAM,cAAc,UAAU,kBAAkB,cAAc;;AAGlF,SAAS,qBAAqB,IAAkB,WAA+B;AAC7E,KAAI,KAAK;EAAE,eAAe,UAAU;EAAe,MAAM,UAAU;EAAU,EAAE,4BAA4B;AAC3G,IAAG,KAAK,kBAAkB;AAC1B,KAAI;AACF,KAAG,KAAK,UAAU,IAAI;AACtB,mBAAiB,IAAI,UAAU,cAAc;AAC7C,KAAG,KAAK,SAAS;UACV,OAAO;AACd,MAAI;AACF,MAAG,KAAK,WAAW;UACb;EAGR,MAAM,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACjE,QAAM,IAAI,MACR,wBAAwB,UAAU,cAAc,IAAI,UAAU,SAAS,YAAY,MACnF,EAAE,OAAO,OAAO,CACjB;;;;;;;AAQL,SAAgB,uBACd,IACA,UAAkC,EAAE,EAC5B;CACR,MAAM,gBAAgB,QAAQ,iBAAA;CAC9B,IAAI,iBAAiB,kBAAkB,GAAG;AAE1C,KAAI,iBAAiB,cACnB,OAAM,IAAI,0BAA0B,gBAAgB,cAAc;AAGpE,KAAI,kBAAkB,cACpB,QAAO;CAGT,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;AAErF,QAAO,iBAAiB,eAAe;EACrC,MAAM,cAAc,iBAAiB;EACrC,MAAM,YAAY,kBAAkB,YAAY,YAAY;AAC5D,MAAI,CAAC,UACH,OAAM,IAAI,gCAAgC,gBAAgB,eAAe,YAAY;AAEvF,uBAAqB,IAAI,UAAU;AACnC,mBAAiB;;AAGnB,QAAO;;;AAaT,SAAgB,6BACd,IACA,UAA2E,EAAE,EACtD;CACvB,MAAM,aAAa,QAAQ,iBAAA;CAC3B,MAAM,YAAY,kBAAkB,GAAG;AAGvC,KAFiB,YAAY,WAG3B,QAAO;EACL;EACA;EACA,iBAAiB,EAAE;EACnB,UAAU;EACV,iBAAiB;EACjB,gBAAgB;EACjB;CAGH,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;CACrF,MAAM,kBAA4B,EAAE;CACpC,IAAI,kBAAkB;CACtB,IAAI,iBAAgC;AAEpC,MAAK,IAAI,UAAU,YAAY,GAAG,WAAW,YAAY,UACvD,KAAI,kBAAkB,YAAY,QAAQ,CACxC,iBAAgB,KAAK,QAAQ;MACxB;AACL,oBAAkB;AAClB,mBAAiB;AACjB;;AAIJ,QAAO;EACL;EACA;EACA;EACA,UAAU;EACV;EACA;EACD"}
+{"version":3,"file":"runner.js","names":[],"sources":["../../../../../src/storage/sqlite/migrations/runner.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { DatabaseSync } from 'node:sqlite';\n\nimport { createLogger } from '../../../utils/logger.js';\nimport { readSchemaVersion, setSchemaVersion } from '../schema-version.js';\nimport { discoverSqlMigrations } from './discover.js';\nimport {\n  DatabaseSchemaMigrationGapError,\n  DatabaseSchemaTooNewError,\n} from './errors.js';\nimport type { ApplyMigrationsOptions, SqlMigration } from './types.js';\n\nconst log = createLogger('Sqlite:Migrations');\n\n/** Baseline schema version applied from schema.sql on first open. */\nexport const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;\n\n/** Latest schema version this release supports (increment when adding migrations). */\nexport const XOPC_DB_SCHEMA_VERSION = 25;\n\nconst MODULE_DIR = dirname(fileURLToPath(import.meta.url));\n\nexport function resolveMigrationsDir(override?: string): string {\n  if (override) {\n    return override;\n  }\n  // Packaged Electron gateway bundle: `out/server/index.js` + `out/server/migrations/`.\n  const siblingDir = join(MODULE_DIR, 'migrations');\n  if (existsSync(siblingDir)) {\n    return siblingDir;\n  }\n  // Dev / dist: SQL files live next to `migrations/runner.js`.\n  return MODULE_DIR;\n}\n\nfunction migrationByTarget(\n  migrations: SqlMigration[],\n  targetVersion: number,\n): SqlMigration | undefined {\n  return migrations.find((migration) => migration.targetVersion === targetVersion);\n}\n\nfunction applySingleMigration(db: DatabaseSync, migration: SqlMigration): void {\n  log.info({ targetVersion: migration.targetVersion, file: migration.filename }, 'Applying SQLite migration');\n  db.exec('BEGIN IMMEDIATE');\n  try {\n    db.exec(migration.sql);\n    setSchemaVersion(db, migration.targetVersion);\n    db.exec('COMMIT');\n  } catch (error) {\n    try {\n      db.exec('ROLLBACK');\n    } catch {\n      /* preserve original error */\n    }\n    const em = error instanceof Error ? error.message : String(error);\n    throw new Error(\n      `SQLite migration to v${migration.targetVersion} (${migration.filename}) failed: ${em}`,\n      { cause: error },\n    );\n  }\n}\n\n/**\n * Apply sequential SQL migrations from (currentVersion + 1) through targetVersion.\n * Each step runs in its own transaction and updates schema_meta on success.\n */\nexport function applyPendingMigrations(\n  db: DatabaseSync,\n  options: ApplyMigrationsOptions = {},\n): number {\n  const targetVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  let currentVersion = readSchemaVersion(db);\n\n  if (currentVersion > targetVersion) {\n    throw new DatabaseSchemaTooNewError(currentVersion, targetVersion);\n  }\n\n  if (currentVersion >= targetVersion) {\n    return currentVersion;\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n\n  while (currentVersion < targetVersion) {\n    const nextVersion = currentVersion + 1;\n    const migration = migrationByTarget(migrations, nextVersion);\n    if (!migration) {\n      throw new DatabaseSchemaMigrationGapError(currentVersion, targetVersion, nextVersion);\n    }\n    applySingleMigration(db, migration);\n    currentVersion = nextVersion;\n  }\n\n  return currentVersion;\n}\n\nexport type SchemaMigrationStatus = {\n  dbVersion: number;\n  appVersion: number;\n  pendingVersions: number[];\n  isTooNew: boolean;\n  hasMigrationGap: boolean;\n  missingVersion: number | null;\n};\n\n/** Inspect schema version without mutating the database. */\nexport function inspectSchemaMigrationStatus(\n  db: DatabaseSync,\n  options: Pick<ApplyMigrationsOptions, 'migrationsDir' | 'targetVersion'> = {},\n): SchemaMigrationStatus {\n  const appVersion = options.targetVersion ?? XOPC_DB_SCHEMA_VERSION;\n  const dbVersion = readSchemaVersion(db);\n  const isTooNew = dbVersion > appVersion;\n\n  if (isTooNew) {\n    return {\n      dbVersion,\n      appVersion,\n      pendingVersions: [],\n      isTooNew: true,\n      hasMigrationGap: false,\n      missingVersion: null,\n    };\n  }\n\n  const migrations = discoverSqlMigrations(resolveMigrationsDir(options.migrationsDir));\n  const pendingVersions: number[] = [];\n  let hasMigrationGap = false;\n  let missingVersion: number | null = null;\n\n  for (let version = dbVersion + 1; version <= appVersion; version++) {\n    if (migrationByTarget(migrations, version)) {\n      pendingVersions.push(version);\n    } else {\n      hasMigrationGap = true;\n      missingVersion = version;\n      break;\n    }\n  }\n\n  return {\n    dbVersion,\n    appVersion,\n    pendingVersions,\n    isTooNew: false,\n    hasMigrationGap,\n    missingVersion,\n  };\n}\n"],"mappings":";;;;;;;;;aAMwD;AASxD,MAAM,MAAM,aAAa,oBAAoB;;AAG7C,MAAa,kCAAkC;;AAG/C,MAAa,yBAAyB;AAEtC,MAAM,aAAa,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC;AAE1D,SAAgB,qBAAqB,UAA2B;AAC9D,KAAI,SACF,QAAO;CAGT,MAAM,aAAa,KAAK,YAAY,aAAa;AACjD,KAAI,WAAW,WAAW,CACxB,QAAO;AAGT,QAAO;;AAGT,SAAS,kBACP,YACA,eAC0B;AAC1B,QAAO,WAAW,MAAM,cAAc,UAAU,kBAAkB,cAAc;;AAGlF,SAAS,qBAAqB,IAAkB,WAA+B;AAC7E,KAAI,KAAK;EAAE,eAAe,UAAU;EAAe,MAAM,UAAU;EAAU,EAAE,4BAA4B;AAC3G,IAAG,KAAK,kBAAkB;AAC1B,KAAI;AACF,KAAG,KAAK,UAAU,IAAI;AACtB,mBAAiB,IAAI,UAAU,cAAc;AAC7C,KAAG,KAAK,SAAS;UACV,OAAO;AACd,MAAI;AACF,MAAG,KAAK,WAAW;UACb;EAGR,MAAM,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;AACjE,QAAM,IAAI,MACR,wBAAwB,UAAU,cAAc,IAAI,UAAU,SAAS,YAAY,MACnF,EAAE,OAAO,OAAO,CACjB;;;;;;;AAQL,SAAgB,uBACd,IACA,UAAkC,EAAE,EAC5B;CACR,MAAM,gBAAgB,QAAQ,iBAAA;CAC9B,IAAI,iBAAiB,kBAAkB,GAAG;AAE1C,KAAI,iBAAiB,cACnB,OAAM,IAAI,0BAA0B,gBAAgB,cAAc;AAGpE,KAAI,kBAAkB,cACpB,QAAO;CAGT,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;AAErF,QAAO,iBAAiB,eAAe;EACrC,MAAM,cAAc,iBAAiB;EACrC,MAAM,YAAY,kBAAkB,YAAY,YAAY;AAC5D,MAAI,CAAC,UACH,OAAM,IAAI,gCAAgC,gBAAgB,eAAe,YAAY;AAEvF,uBAAqB,IAAI,UAAU;AACnC,mBAAiB;;AAGnB,QAAO;;;AAaT,SAAgB,6BACd,IACA,UAA2E,EAAE,EACtD;CACvB,MAAM,aAAa,QAAQ,iBAAA;CAC3B,MAAM,YAAY,kBAAkB,GAAG;AAGvC,KAFiB,YAAY,WAG3B,QAAO;EACL;EACA;EACA,iBAAiB,EAAE;EACnB,UAAU;EACV,iBAAiB;EACjB,gBAAgB;EACjB;CAGH,MAAM,aAAa,sBAAsB,qBAAqB,QAAQ,cAAc,CAAC;CACrF,MAAM,kBAA4B,EAAE;CACpC,IAAI,kBAAkB;CACtB,IAAI,iBAAgC;AAEpC,MAAK,IAAI,UAAU,YAAY,GAAG,WAAW,YAAY,UACvD,KAAI,kBAAkB,YAAY,QAAQ,CACxC,iBAAgB,KAAK,QAAQ;MACxB;AACL,oBAAkB;AAClB,mBAAiB;AACjB;;AAIJ,QAAO;EACL;EACA;EACA;EACA,UAAU;EACV;EACA;EACD"}

package/dist/src/storage/sqlite/migrations/runner.ts

@@ -19,7 +19,7 @@ const log = createLogger('Sqlite:Migrations');
 export const XOPC_DB_BASELINE_SCHEMA_VERSION = 11;
 
 /** Latest schema version this release supports (increment when adding migrations). */
-export const XOPC_DB_SCHEMA_VERSION = 24;
+export const XOPC_DB_SCHEMA_VERSION = 25;
 
 const MODULE_DIR = dirname(fileURLToPath(import.meta.url));
 

package/dist/src/storage/sqlite/schema.js

@@ -31,7 +31,7 @@ function ensureXopcDatabaseSchema(db) {
 		bootstrapFreshDatabase(db);
 		currentVersion = 11;
 	}
-	applyPendingMigrations(db, { targetVersion: 24 });
+	applyPendingMigrations(db, { targetVersion: 25 });
 }
 //#endregion
 export { SCHEMA_META_SCHEMA_VERSION_KEY, XOPC_DB_BASELINE_SCHEMA_VERSION, XOPC_DB_SCHEMA_VERSION, ensureSchemaMetaTable, ensureXopcDatabaseSchema, readSchemaVersion, readSchemaVersionForTest, setSchemaVersion };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xopcai/xopc",
-  "version": "0.0.126",
+  "version": "0.0.127",
   "description": "Local-first AI system that remembers context, coordinates AI, and sustains long-term progress.",
   "type": "module",
   "main": "dist/src/index.js",