@gotcos/glasses-server 6.44.9 → 6.44.10

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## 6.44.10
+
+Ingest progress for COS Control.
+
+- `GET /api/context/graph/ingest/progress` (the bridge's `graph-ingest-progress`,
+  read-only): where the current or last Control-started run stands. The run's
+  total, how many are indexed and failed, the document in flight with its
+  estimated calls, the last eight outcomes with their seconds, the budget line,
+  the queue's pending count, and the log's last lines. A run started somewhere
+  else (a Claude session) holds the lock but writes no log here, so it reports
+  as `external` with the counts only. COS Control 0.5.195's Sync card polls it
+  every five seconds while the ingest lock is held.
+
 ## 6.44.9
 
 Knowledge from zero: the setup path behind COS Control's Knowledge tab.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gotcos/glasses-server",
-  "version": "6.44.9",
+  "version": "6.44.10",
   "description": "COS Glasses \u2014 self-hosted AI heads-up-display server for Even G2 smart glasses, powered by Claude Code, Codex, Cursor Agent CLI, or local Ollama",
   "type": "module",
   "bin": {

package/server/lib/cos-context-browser.ts

@@ -923,6 +923,38 @@ export function normalizeGraphAnswer(value: unknown): { question: string; mode:
   return { question: stringOrAbsent(s.question, KNOWLEDGE_ASK_MAX_CHARS) ?? '', mode: stringOrAbsent(s.mode, 16) ?? 'hybrid', answer, elapsed_s: typeof s.elapsed_s === 'number' && Number.isFinite(s.elapsed_s) ? s.elapsed_s : null }
 }
 
+export interface IngestProgressItem { id: string; outcome: 'indexed' | 'failed' | 'unknown'; seconds: number | null; reason: string | null }
+
+/** `graph-ingest-progress`: where the current or last Control-started run stands. */
+export function normalizeIngestProgress(value: unknown): Record<string, unknown> {
+  const s = asRecord(value) ?? {}
+  const current = asRecord(s.current)
+  const budget = asRecord(s.budget)
+  const items: IngestProgressItem[] = (Array.isArray(s.items) ? s.items : []).flatMap((row) => {
+    const r = asRecord(row); const id = r ? stringOrAbsent(r.id, 200) : undefined
+    if (!id) return []
+    const outcome: IngestProgressItem['outcome'] = r!.outcome === 'indexed' ? 'indexed' : r!.outcome === 'failed' ? 'failed' : 'unknown'
+    return [{ id, outcome, seconds: typeof r!.seconds === 'number' && Number.isFinite(r!.seconds) ? r!.seconds : null, reason: stringOrAbsent(r!.reason, 200) ?? null }]
+  }).slice(-8)
+  return {
+    running: s.running === true,
+    pid: integerOrAbsent(s.pid) ?? null,
+    external: s.external === true,
+    pending: integerOrAbsent(s.pending) ?? null,
+    total: integerOrAbsent(s.total) ?? null,
+    done: integerOrAbsent(s.done) ?? 0,
+    failed: integerOrAbsent(s.failed) ?? 0,
+    current: current && stringOrAbsent(current.id, 200) ? { id: stringOrAbsent(current.id, 200)!, est_calls: integerOrAbsent(current.est_calls) ?? null } : null,
+    items,
+    remaining_calls: integerOrAbsent(s.remaining_calls) ?? null,
+    budget: budget && integerOrAbsent(budget.used) !== undefined && integerOrAbsent(budget.cap) !== undefined ? { used: integerOrAbsent(budget.used)!, cap: integerOrAbsent(budget.cap)! } : null,
+    ended: s.ended === true,
+    log_tail: (Array.isArray(s.log_tail) ? s.log_tail : []).filter((l): l is string => typeof l === 'string').map(l => l.slice(0, 300)).slice(-24),
+    log_age_s: typeof s.log_age_s === 'number' && Number.isFinite(s.log_age_s) ? s.log_age_s : null,
+    lock: normalizeIngestKickoff({ lock: s.lock }).lock,
+  }
+}
+
 export function normalizeContextBrowserStatus(value: unknown): ContextBrowserStatus {
   const source = value && typeof value === 'object' && !Array.isArray(value)
     ? value as Record<string, unknown> : {}

package/server/lib/python-bridge.ts

@@ -64,6 +64,7 @@ export const LEARNING_COMMANDS = [
   'graph-ingest-sample',
   'graph-ask',
   'graph-schedule',
+  'graph-ingest-progress',
 ] as const
 
 // The optional Python bridge is available only when the user points us at a real
@@ -244,6 +245,7 @@ function standaloneNoop(args: string[]): unknown {
     case 'graph-ingest-sample':
     case 'graph-ask':
     case 'graph-schedule':
+    case 'graph-ingest-progress':
       return { error: 'cos_pipeline_not_configured' }
     case 'task-rows':
     case 'task-capture':

package/server/routes/memory.ts

@@ -29,6 +29,7 @@ import { normalizeReviewDecision, LEARNING_REVIEW_LIMIT,
   normalizeKnowledgeSources,
   normalizeSampleKickoff,
   normalizeGraphAnswer,
+  normalizeIngestProgress,
   KNOWLEDGE_SETUP_SAMPLE_MAX,
   KNOWLEDGE_ASK_MAX_CHARS,
   normalizeLearningEventDetail,
@@ -345,6 +346,21 @@ memoryRouter.post('/context/graph/ingest', async (req, res) => {
   }
 })
 
+/** Where the current or last Control-started ingest stands (6.44.10). Read-only. */
+memoryRouter.get('/context/graph/ingest/progress', async (_req, res) => {
+  noStore(res)
+  if (!contextConfigured()) { res.status(503).json({ error: pythonBridgeState() }); return }
+  try {
+    const data = await callPython(['graph-ingest-progress'], 10_000)
+    const code = bridgeErrorCode(data)
+    if (code) { res.status(503).json({ error: code }); return }
+    res.json(normalizeIngestProgress(data))
+  } catch (error) {
+    console.warn('[context] progress bridge failure:', (error as Error).message)
+    res.status(503).json({ error: 'graph_unavailable' })
+  }
+})
+
 // ── Knowledge setup (6.44.9): from zero to a first index, in COS Control ──
 //
 // Six bridge commands behind one guided path: the readiness checklist, the