spine-framework 0.3.121 → 0.3.123

package/.framework/functions/_shared/cil-state.ts

@@ -0,0 +1,131 @@
+/**
+ * @module cil-state
+ * @audience both
+ * @layer shared-core
+ * @stability experimental
+ *
+ * Shared state-machine helpers for the CIL ingestion pipeline.
+ */
+
+import { adminDb } from './db'
+
+export type FileStatus = 'discovered' | 'pass2_complete' | 'pass3_complete' | 'pass4_complete' | 'pass4b_complete' | 'pass5_complete'
+
+export interface FileTreeNode {
+  id?: string | null
+  name: string
+  path: string
+  type: 'file' | 'directory'
+  extension?: string
+  language?: string
+  status?: FileStatus
+  children?: FileTreeNode[]
+  selected?: boolean
+}
+
+/**
+ * Check whether a file path is inside any of the selected paths.
+ * A file is selected if its path equals a selected path, or starts with a selected directory path + '/'.
+ */
+export function isSelectedPath(filePath: string, selectedPaths: string[]): boolean {
+  if (selectedPaths.length === 0) return true
+  return selectedPaths.some(sp => {
+    if (filePath === sp) return true
+    if (sp === '') return true
+    return filePath.startsWith(sp + '/')
+  })
+}
+
+/**
+ * Extract the file status from a cil_file item.
+ */
+export function getFileStatus(fileItem: any): FileStatus {
+  return fileItem.data?.status || 'discovered'
+}
+
+/**
+ * Update the status of a cil_file item.
+ */
+export async function updateFileStatus(ctx: any, fileItem: any, status: FileStatus, extraData: Record<string, any> = {}): Promise<void> {
+  const { create, update } = await import('../admin-data')
+  const updateCtx = { ...ctx, query: { ...(ctx.query || {}), entity: 'items', id: fileItem.id } }
+  await update(updateCtx, {
+    data: {
+      ...fileItem.data,
+      ...extraData,
+      status,
+      last_status_at: new Date().toISOString(),
+    },
+  })
+}
+
+/**
+ * Build a nested file tree from a flat list of discovered files.
+ */
+export function buildFileTree(fileRecords: { file_path: string; id: string; language: string; status: FileStatus; extension: string }[]): FileTreeNode {
+  const root: FileTreeNode = { name: 'root', path: '', type: 'directory', children: [] }
+
+  for (const record of fileRecords) {
+    const parts = record.file_path.split('/')
+    let current = root
+
+    for (let i = 0; i < parts.length; i++) {
+      const part = parts[i]
+      const isFile = i === parts.length - 1
+      const currentPath = parts.slice(0, i + 1).join('/')
+
+      let child = current.children?.find(c => c.name === part)
+      if (!child) {
+        child = {
+          name: part,
+          path: currentPath,
+          type: isFile ? 'file' : 'directory',
+          children: isFile ? undefined : []
+        }
+        if (isFile) {
+          child.id = record.id
+          child.language = record.language
+          child.status = record.status
+          child.extension = record.extension
+        }
+        current.children!.push(child)
+      }
+      current = child
+    }
+  }
+
+  return root
+}
+
+/**
+ * Update the status of a file node in the persisted tree by its file item ID.
+ */
+export function updateTreeNodeStatus(tree: FileTreeNode, fileId: string, status: FileStatus): void {
+  if (tree.id === fileId) {
+    tree.status = status
+    return
+  }
+  if (tree.children) {
+    for (const child of tree.children) {
+      updateTreeNodeStatus(child, fileId, status)
+    }
+  }
+}
+
+/**
+ * Persist the updated tree back to the project item.
+ */
+export async function saveProjectTree(ctx: any, projectId: string, tree: FileTreeNode, extraData: Record<string, any> = {}): Promise<void> {
+  const { update } = await import('../admin-data')
+  const { data: projItem } = await adminDb.from('items').select('id, data').eq('id', projectId).maybeSingle()
+  if (!projItem) return
+  const updateCtx = { ...ctx, query: { ...(ctx.query || {}), entity: 'items', id: projItem.id } }
+  await update(updateCtx, {
+    data: {
+      ...projItem.data,
+      file_tree: tree,
+      ...extraData,
+      last_tree_update: new Date().toISOString(),
+    },
+  })
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spine-framework",
-  "version": "0.3.121",
+  "version": "0.3.123",
   "description": "Multi-tenant, modular application platform for modern SaaS systems",
   "type": "module",
   "bin": {