@adverant/nexus-memory-skill 2.2.0 → 2.2.1

package/hooks/upload-document.sh

@@ -1,6 +1,6 @@
 #!/bin/bash
 #
-# Nexus Memory - Upload Document Hook (v2.2.0)
+# Nexus Memory - Upload Document Hook (v2.2.1)
 # Uploads documents to FileProcessAgent for intelligent processing with
 # FULL KNOWLEDGE EXTRACTION enabled by default.
 #
@@ -244,7 +244,7 @@ build_metadata() {
   cat <<EOF
 {
   "source": "nexus-memory-skill",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "preferAccuracy": ${prefer_accuracy},
   "forceEntityExtraction": ${extract_entities},
   "storeInKnowledgeGraph": ${extract_entities},
@@ -340,29 +340,51 @@ display_results() {
   echo ""
 
   # Extract key metrics from response
-  local ENTITY_COUNT=$(echo "$STATUS_RESPONSE" | jq -r '.result.entities // .entities // [] | length' 2>/dev/null)
-  local TABLE_COUNT=$(echo "$STATUS_RESPONSE" | jq -r '.result.tables // .tables // [] | length' 2>/dev/null)
-  local OCR_TIER=$(echo "$STATUS_RESPONSE" | jq -r '.result.ocrTier // .ocrTier // "auto"' 2>/dev/null)
-  local PAGE_COUNT=$(echo "$STATUS_RESPONSE" | jq -r '.result.pageCount // .pageCount // "N/A"' 2>/dev/null)
-  local WORD_COUNT=$(echo "$STATUS_RESPONSE" | jq -r '.result.wordCount // .wordCount // "N/A"' 2>/dev/null)
-  local DOC_TYPE=$(echo "$STATUS_RESPONSE" | jq -r '.result.documentType // .documentType // "unknown"' 2>/dev/null)
-  local GRAPHRAG_STORED=$(echo "$STATUS_RESPONSE" | jq -r '.result.storedInGraphRAG // .storedInGraphRAG // false' 2>/dev/null)
-
-  echo "📄 Document Type:     $DOC_TYPE"
+  # API response structure: { success: true, job: {...}, documentDna?: {...} }
+  local JOB=$(echo "$STATUS_RESPONSE" | jq '.job // .')
+  local DOC_DNA=$(echo "$STATUS_RESPONSE" | jq '.documentDna // .job.documentDna // {}')
+
+  # Get job-level fields
+  local OCR_TIER=$(echo "$JOB" | jq -r '.ocrTierUsed // .ocrTier // "auto"' 2>/dev/null)
+  local CONFIDENCE=$(echo "$JOB" | jq -r '.confidence // "N/A"' 2>/dev/null)
+  local PROCESSING_TIME=$(echo "$JOB" | jq -r '.processingTimeMs // "N/A"' 2>/dev/null)
+  local MIME_TYPE=$(echo "$JOB" | jq -r '.mimeType // "unknown"' 2>/dev/null)
+
+  # Get metadata fields (where entities, tables, etc. are stored)
+  local METADATA=$(echo "$JOB" | jq '.metadata // {}')
+  local ENTITY_COUNT=$(echo "$METADATA" | jq -r '.entities // [] | length' 2>/dev/null)
+  local TABLE_COUNT=$(echo "$METADATA" | jq -r '.tables // [] | length' 2>/dev/null)
+  local PAGE_COUNT=$(echo "$METADATA" | jq -r '.pageCount // "N/A"' 2>/dev/null)
+  local WORD_COUNT=$(echo "$METADATA" | jq -r '.wordCount // "N/A"' 2>/dev/null)
+  local DOC_TYPE=$(echo "$METADATA" | jq -r '.documentType // .type // "unknown"' 2>/dev/null)
+
+  # Check if stored in GraphRAG (Document DNA exists)
+  local DOC_DNA_ID=$(echo "$JOB" | jq -r '.documentDnaId // "null"' 2>/dev/null)
+  local GRAPHRAG_STORED="false"
+  if [[ "$DOC_DNA_ID" != "null" ]] && [[ -n "$DOC_DNA_ID" ]]; then
+    GRAPHRAG_STORED="true"
+  fi
+
+  echo "📄 Document Type:     $DOC_TYPE ($MIME_TYPE)"
   echo "📑 Pages:             $PAGE_COUNT"
   echo "📝 Words:             $WORD_COUNT"
+  echo "⏱️  Processing Time:   ${PROCESSING_TIME}ms"
+  echo "🎯 Confidence:        $CONFIDENCE"
   echo ""
   echo "🔍 Auto-Discovery Results:"
   echo "   • OCR Tier Used:   $OCR_TIER"
   echo "   • Tables Found:    $TABLE_COUNT"
   echo "   • Entities:        $ENTITY_COUNT"
   echo "   • GraphRAG:        $GRAPHRAG_STORED"
+  if [[ "$DOC_DNA_ID" != "null" ]] && [[ -n "$DOC_DNA_ID" ]]; then
+    echo "   • Document DNA:    $DOC_DNA_ID"
+  fi
   echo ""
 
   # Show extracted entities if any
-  if [[ "$ENTITY_COUNT" != "0" ]] && [[ "$ENTITY_COUNT" != "null" ]]; then
+  if [[ "$ENTITY_COUNT" != "0" ]] && [[ "$ENTITY_COUNT" != "null" ]] && [[ -n "$ENTITY_COUNT" ]]; then
     echo "🏷️  Extracted Entities:"
-    echo "$STATUS_RESPONSE" | jq -r '.result.entities // .entities // [] | .[:10][] | "   • \(.name // .text) (\(.type // "entity"))"' 2>/dev/null
+    echo "$METADATA" | jq -r '.entities // [] | .[:10][] | "   • \(.name // .text // .value) (\(.type // "entity"))"' 2>/dev/null
     if [[ "$ENTITY_COUNT" -gt 10 ]]; then
       echo "   ... and $((ENTITY_COUNT - 10)) more"
     fi
@@ -408,31 +430,48 @@ wait_for_job() {
       continue
     fi
 
-    local JOB_STATE=$(echo "$STATUS_RESPONSE" | jq -r '.state // .status // empty')
+    # API response structure: { success: true, job: { status: "completed", ... } }
+    # Status is nested under .job.status, NOT at root level
+    local JOB_STATE=$(echo "$STATUS_RESPONSE" | jq -r '.job.status // .status // .state // empty')
 
     case "$JOB_STATE" in
       "completed"|"finished"|"success")
         display_results "$STATUS_RESPONSE" "$FILE_NAME"
         return 0
         ;;
-      "failed"|"error")
+      "failed"|"error"|"cancelled")
         log_error "Processing failed for: $FILE_NAME"
         echo ""
         echo "=== ERROR DETAILS ==="
-        echo "$STATUS_RESPONSE" | jq .
+        local ERROR_MSG=$(echo "$STATUS_RESPONSE" | jq -r '.job.errorMessage // .errorMessage // "Unknown error"')
+        local ERROR_CODE=$(echo "$STATUS_RESPONSE" | jq -r '.job.errorCode // .errorCode // "UNKNOWN"')
+        echo "Error Code: $ERROR_CODE"
+        echo "Error Message: $ERROR_MSG"
+        echo ""
+        if [[ "$VERBOSE" == "1" ]]; then
+          echo "$STATUS_RESPONSE" | jq .
+        fi
         return 1
         ;;
-      "waiting"|"active"|"processing"|"pending")
-        local PROGRESS=$(echo "$STATUS_RESPONSE" | jq -r '.progress // empty')
-        local STAGE=$(echo "$STATUS_RESPONSE" | jq -r '.stage // empty')
-        if [[ -n "$PROGRESS" ]] && [[ -n "$STAGE" ]]; then
+      "queued"|"waiting"|"pending")
+        log "[$FILE_NAME] Queued... (${WAITED}s elapsed)"
+        ;;
+      "processing"|"active")
+        # Try to get progress from job metadata
+        local PROGRESS=$(echo "$STATUS_RESPONSE" | jq -r '.job.metadata.progress // .progress // empty')
+        local STAGE=$(echo "$STATUS_RESPONSE" | jq -r '.job.metadata.stage // .stage // empty')
+        if [[ -n "$PROGRESS" ]] && [[ "$PROGRESS" != "null" ]] && [[ -n "$STAGE" ]] && [[ "$STAGE" != "null" ]]; then
           log "[$FILE_NAME] ${STAGE}: ${PROGRESS}% (${WAITED}s elapsed)"
-        elif [[ -n "$PROGRESS" ]]; then
+        elif [[ -n "$PROGRESS" ]] && [[ "$PROGRESS" != "null" ]]; then
           log "[$FILE_NAME] Processing... ${PROGRESS}% (${WAITED}s elapsed)"
         else
           log "[$FILE_NAME] Processing... (${WAITED}s elapsed)"
         fi
         ;;
+      ""|"null")
+        # Empty status might mean job not found or API issue
+        log "[$FILE_NAME] Waiting for status... (${WAITED}s elapsed)"
+        ;;
       *)
         log "[$FILE_NAME] Status: $JOB_STATE (${WAITED}s elapsed)"
         ;;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adverant/nexus-memory-skill",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "Claude Code skill for persistent memory via Nexus GraphRAG - store and recall memories across all sessions and projects",
   "main": "SKILL.md",
   "type": "module",