@hasna/hook-knowledge-context 0.1.0 → 0.1.2

package/README.md

@@ -29,7 +29,10 @@ The hook intentionally does not pass `--semantic`, does not call web search,
 does not call ask/build/generate flows, and does not crawl raw stores directly.
 When Knowledge returns a nonempty context pack, the hook redacts credential-like
 text from that pack and emits Codewith-native
-`hookSpecificOutput.additionalContext` with the same event name.
+`hookSpecificOutput.additionalContext` with the same event name. Citation-only
+packs are expanded into progressive context lines with a bounded preview and a
+`knowledge get --id ... --json` read hint so agents can decide which full items
+are worth opening.
 
 All failures are fail-open: missing CLI, timeout, nonzero exit, malformed JSON,
 bad stdin, or empty packs return `{"continue":true}` without context.
@@ -39,7 +42,7 @@ bad stdin, or empty packs return `{"continue":true}` without context.
 ```bash
 export HOOKS_KNOWLEDGE_CONTEXT_DISABLE=1    # Kill switch
 export HOOKS_KNOWLEDGE_COMMAND=knowledge    # CLI command/path
-export HOOKS_KNOWLEDGE_TIMEOUT_MS=1500      # Per-call timeout
+export HOOKS_KNOWLEDGE_TIMEOUT_MS=5000      # Per-call timeout
 export HOOKS_KNOWLEDGE_MAX_ITEMS=6          # Context pack item budget
 export HOOKS_KNOWLEDGE_MAX_TOKENS=1200      # Context pack token budget
 export HOOKS_KNOWLEDGE_MAX_QUERY_CHARS=1200 # Redacted query bound

package/dist/hook.js

@@ -4,7 +4,7 @@
 // src/hook.ts
 import { readFileSync } from "fs";
 import { spawn } from "child_process";
-var DEFAULT_TIMEOUT_MS = 1500;
+var DEFAULT_TIMEOUT_MS = 5000;
 var DEFAULT_MAX_ITEMS = 6;
 var DEFAULT_MAX_TOKENS = 1200;
 var DEFAULT_MAX_QUERY_CHARS = 1200;
@@ -148,6 +148,16 @@ function firstString(obj, keys) {
   }
   return null;
 }
+function firstSourceString(obj) {
+  const direct = firstString(obj, ["source_ref", "source_uri", "source", "uri", "ref", "url", "citation"]);
+  if (direct)
+    return direct;
+  const source = obj.source;
+  if (source && typeof source === "object") {
+    return firstString(source, ["uri", "ref", "url", "id"]);
+  }
+  return null;
+}
 function firstArray(obj, keys) {
   for (const key of keys) {
     const value = obj[key];
@@ -163,6 +173,13 @@ function truncate(text, max) {
     return text.slice(0, max);
   return `${text.slice(0, max - 3)}...`;
 }
+function compactText(text) {
+  return text.replace(/\s+/g, " ").trim();
+}
+function knowledgeItemId(source) {
+  const match = source?.match(/^knowledge:\/\/item\/([^/?#\s]+)$/);
+  return match?.[1] ?? null;
+}
 function formatPackItems(items) {
   const lines = [];
   for (const [index, item] of items.entries()) {
@@ -173,13 +190,33 @@ function formatPackItems(items) {
     if (!item || typeof item !== "object")
       continue;
     const obj = item;
-    const title = firstString(obj, ["title", "name", "id", "ref", "uri"]) || `item ${index + 1}`;
-    const body = firstString(obj, ["summary", "text", "content", "snippet", "preview", "body"]);
-    const source = firstString(obj, ["source", "uri", "ref", "url", "citation"]);
+    const citationId = firstString(obj, ["id", "citation_id", "citationId"]);
+    const source = firstSourceString(obj);
+    const itemId = knowledgeItemId(source);
+    const title = firstString(obj, ["title", "name"]) || (itemId ? `Knowledge item ${itemId}` : citationId || `item ${index + 1}`);
+    const body = firstString(obj, [
+      "summary",
+      "text",
+      "content",
+      "snippet",
+      "preview",
+      "quote_preview",
+      "quotePreview",
+      "excerpt",
+      "body",
+      "description"
+    ]);
     if (!body && !source)
       continue;
-    const suffix = source ? ` (source: ${truncate(source, 180)})` : "";
-    lines.push(`- ${truncate(title, 160)}${suffix}${body ? `: ${truncate(body, 900)}` : ""}`);
+    const suffixParts = [
+      citationId && citationId !== title ? citationId : null,
+      source ? `source: ${truncate(source, 180)}` : null
+    ].filter(Boolean);
+    const suffix = suffixParts.length > 0 ? ` (${suffixParts.join("; ")})` : "";
+    lines.push(`- ${truncate(title, 160)}${suffix}${body ? `: ${truncate(compactText(body), 520)}` : ""}`);
+    if (itemId) {
+      lines.push(`  read: knowledge get --id ${itemId} --json`);
+    }
   }
   return lines.length > 0 ? lines.join(`
 `) : null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/hook-knowledge-context",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Codewith hook that injects deterministic Knowledge context packs into lifecycle events",
   "type": "module",
   "main": "./dist/hook.js",