@shrkcrft/knowledge 0.1.0-alpha.14 → 0.1.0-alpha.15

package/dist/format/action-hints-formatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-hints-formatter.d.ts","sourceRoot":"","sources":["../../src/format/action-hints-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAEnB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAkBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,eAAe,EAAE,GAClC,sBAAsB,CAyCxB;AAED,MAAM,WAAW,wBAAwB;IACvC,sEAAsE;IACtE,KAAK,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;IACrB,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAgBD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,sBAAsB,EAC7B,OAAO,GAAE,wBAA6B,GACrC,MAAM,CA2DR;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,eAAe,EACtB,OAAO,GAAE,wBAA6B,GACrC,MAAM,CAGR;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAE3E"}
+{"version":3,"file":"action-hints-formatter.d.ts","sourceRoot":"","sources":["../../src/format/action-hints-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAEnB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,sBAAsB,EAAE,MAAM,EAAE,CAAC;IACjC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAoCD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,eAAe,EAAE,GAClC,sBAAsB,CA0CxB;AAED,MAAM,WAAW,wBAAwB;IACvC,sEAAsE;IACtE,KAAK,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;IACrB,wEAAwE;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAgBD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,sBAAsB,EAC7B,OAAO,GAAE,wBAA6B,GACrC,MAAM,CA2DR;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,eAAe,EACtB,OAAO,GAAE,wBAA6B,GACrC,MAAM,CAGR;AAED,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAE3E"}

package/dist/format/action-hints-formatter.js

@@ -1,6 +1,9 @@
 import { priorityWeight } from "../model/knowledge-priority.js";
 function dedupePush(out, items, key) {
-    if (!items)
+    // Defensive: an entry may author an object-array hint (commands / mcpTools)
+    // as a scalar by mistake. Iterating a non-array here would walk string chars
+    // and produce garbage keys, so anything that isn't an array is ignored.
+    if (!Array.isArray(items))
         return;
     const seen = new Set(out.map(key));
     for (const item of items) {
@@ -11,8 +14,24 @@ function dedupePush(out, items, key) {
         }
     }
 }
+/**
+ * Coerce an authored hint value into a string array. A common authoring typo
+ * is to write a single-value field as a scalar (`preferredFlow: 'x'`) instead
+ * of an array (`preferredFlow: ['x']`). A scalar string has `.length` but no
+ * `.map`, which previously crashed the formatter (`preferredFlow.map is not a
+ * function`) and took down the whole `shrk context` entrypoint. Normalizing
+ * here preserves the authored content while guaranteeing the all-array contract
+ * of `IAggregatedActionHints`.
+ */
+function toHintStrings(value) {
+    if (Array.isArray(value))
+        return value.filter((v) => typeof v === 'string');
+    if (typeof value === 'string' && value.trim().length > 0)
+        return [value];
+    return [];
+}
 function dedupeStrings(out, items) {
-    dedupePush(out, items, (s) => s);
+    dedupePush(out, toHintStrings(items), (s) => s);
 }
 /**
  * Combine actionHints from a list of relevant entries into a single bundle.
@@ -41,8 +60,9 @@ export function aggregateActionHints(entries) {
             continue;
         dedupePush(out.commands, h.commands, (c) => c.command);
         dedupePush(out.mcpTools, h.mcpTools, (m) => m.tool);
-        if (!out.preferredFlow.length && h.preferredFlow?.length) {
-            out.preferredFlow = h.preferredFlow;
+        const flow = toHintStrings(h.preferredFlow);
+        if (!out.preferredFlow.length && flow.length) {
+            out.preferredFlow = flow;
             out.preferredFlowSourceId = entry.id;
         }
         dedupeStrings(out.forbiddenActions, h.forbiddenActions);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shrkcrft/knowledge",
-  "version": "0.1.0-alpha.14",
+  "version": "0.1.0-alpha.15",
   "description": "SharkCraft structured knowledge model: typed entries, index, search, loaders (TS + markdown), validation.",
   "license": "MIT",
   "author": "SharkCraft contributors",
@@ -44,7 +44,7 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
-    "@shrkcrft/core": "^0.1.0-alpha.14"
+    "@shrkcrft/core": "^0.1.0-alpha.15"
   },
   "publishConfig": {
     "access": "public"