@gobing-ai/knowledge-kit 0.0.12 → 0.0.13

package/dist/index.js

@@ -26081,7 +26081,7 @@ function kindForCollection(name) {
 var CONTRACTS = {
   ingestion: { kind: "ingestion", input: null, output: DocListSchema },
   generator: { kind: "generator", input: DocListSchema, output: ContentSchema },
-  publish: { kind: "publish", input: exports_external.union([ContentSchema, DocListSchema]), output: ResultSchema }
+  publish: { kind: "publish", input: ContentSchema, output: ResultSchema }
 };
 function kindContract(kind) {
   if (!isPluginKind(kind)) {
@@ -26094,12 +26094,14 @@ function isPluginKind(value) {
 }
 // ../../packages/kk-core/src/manifest.ts
 init_zod();
+var OperationIOSchema = exports_external.enum(["doc-list", "markdown"]);
 var PluginManifestSchema = exports_external.object({
   name: exports_external.string().min(1),
   kind: PluginKindSchema,
   entry: exports_external.string().min(1),
   version: exports_external.string().optional(),
-  description: exports_external.string().optional()
+  description: exports_external.string().optional(),
+  operations: exports_external.record(exports_external.string(), exports_external.object({ input: OperationIOSchema, output: OperationIOSchema })).optional()
 }).passthrough();
 // ../../packages/kk-core/src/registry.ts
 import { existsSync, readdirSync, readFileSync, realpathSync, statSync } from "fs";
@@ -26153,7 +26155,7 @@ function resolvePluginRoots(opts = {}) {
   if (builtinRoot !== undefined) {
     roots.push({ origin: "builtin", root: builtinRoot });
   }
-  const userRoot = join(opts.homeDir ?? homedir(), ".kk", "plugins");
+  const userRoot = join(opts.homeDir ?? homedir(), ".config", "kk", "plugins");
   if (isDirectory(userRoot)) {
     roots.push({ origin: "user", root: userRoot });
   }
@@ -26331,7 +26333,8 @@ function consumeManifest(dirPath, expectedKind, origin, plugins, diagnostics, se
     manifestPath,
     origin,
     version: manifest.version,
-    description: manifest.description
+    description: manifest.description,
+    ...manifest.operations !== undefined ? { operations: manifest.operations } : {}
   });
 }
 function listSortedDir(absDir) {
@@ -26368,7 +26371,7 @@ if (false) {}
 init_dist();
 
 // src/invoke.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3, statSync as statSync3 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync3, statSync as statSync3, unlinkSync } from "fs";
 import { homedir as homedir2 } from "os";
 import { isAbsolute, join as join2, resolve as resolve2 } from "path";
 init_dist();
@@ -26448,21 +26451,44 @@ function spawnPluginEntry(opts) {
     stderr: proc.stderr.toString().trim()
   };
 }
+function killProcessTree(pid) {
+  let stdout;
+  try {
+    stdout = Bun.spawnSync(["pgrep", "-P", String(pid)]).stdout.toString();
+  } catch {
+    stdout = "";
+  }
+  for (const line of stdout.trim().split(`
+`)) {
+    const child = Number(line);
+    if (Number.isInteger(child) && child > 0) {
+      killProcessTree(child);
+    }
+  }
+  try {
+    process.kill(pid, "SIGKILL");
+  } catch {}
+}
 async function spawnPluginEntryAsync(opts) {
-  const signal = opts.timeoutMs === undefined ? undefined : AbortSignal.timeout(opts.timeoutMs);
   let timedOut = false;
-  signal?.addEventListener("abort", () => {
-    timedOut = true;
-  });
+  let timer;
   const proc = Bun.spawn(pluginEntryCmd(opts), {
     cwd: opts.cwd,
     env: pluginEntryEnv(opts),
     stdout: "pipe",
-    stderr: "pipe",
-    signal
+    stderr: "pipe"
   });
+  if (opts.timeoutMs !== undefined) {
+    timer = setTimeout(() => {
+      timedOut = true;
+      killProcessTree(proc.pid);
+    }, opts.timeoutMs);
+  }
   const [stdout, stderr] = await Promise.all([new Response(proc.stdout).text(), new Response(proc.stderr).text()]);
   await proc.exited;
+  if (timer !== undefined) {
+    clearTimeout(timer);
+  }
   return {
     exitCode: proc.exitCode === null ? 1 : proc.exitCode,
     stdout: stdout.trim(),
@@ -26485,7 +26511,11 @@ async function runInvoke(opts) {
   const contract = kindContract(record2.kind);
   const absInPath = resolve2(opts.inPath);
   const absOutPath = resolve2(opts.outPath);
-  let showNotesArrayInput = false;
+  if (existsSync3(absInPath) && absInPath === absOutPath) {
+    echoError(`--in and --out alias the same path (${absInPath}); refusing to overwrite the input`);
+    return 1;
+  }
+  let artifactOutput = false;
   if (contract.input !== null) {
     if (!existsSync3(absInPath)) {
       echoError(`Input file does not exist: ${absInPath}`);
@@ -26505,13 +26535,27 @@ async function runInvoke(opts) {
       echoError(`Input file ${absInPath} is invalid JSON: ${err instanceof Error ? err.message : String(err)}`);
       return 1;
     }
-    const parseResult = contract.input.safeParse(json2);
-    if (!parseResult.success) {
-      const issues = parseResult.error.issues.map((i) => `${i.path.join(".") || "root"}: ${i.message}`).join("; ");
-      echoError(`Input schema violation for kind '${record2.kind}': ${issues}`);
-      return 1;
+    if (record2.kind === "publish" && Array.isArray(json2)) {
+      const op = Object.values(record2.operations ?? {}).find((o) => o.input === "doc-list");
+      if (!op) {
+        echoError(`Publish plugin '${record2.name}' received a Doc[] array but declares no doc-list operation; a Content object is required`);
+        return 1;
+      }
+      const docs = DocListSchema.safeParse(json2);
+      if (!docs.success) {
+        const issues = docs.error.issues.map((i) => `${i.path.join(".") || "root"}: ${i.message}`).join("; ");
+        echoError(`Input schema violation for the declared doc-list operation of '${record2.name}': ${issues}`);
+        return 1;
+      }
+      artifactOutput = op.output === "markdown";
+    } else {
+      const parseResult = contract.input.safeParse(json2);
+      if (!parseResult.success) {
+        const issues = parseResult.error.issues.map((i) => `${i.path.join(".") || "root"}: ${i.message}`).join("; ");
+        echoError(`Input schema violation for kind '${record2.kind}': ${issues}`);
+        return 1;
+      }
     }
-    showNotesArrayInput = record2.kind === "publish" && Array.isArray(json2);
   } else {
     if (!existsSync3(absInPath)) {
       echoError(`Source path does not exist: ${absInPath}`);
@@ -26523,6 +26567,14 @@ async function runInvoke(opts) {
     echoError(`Plugin entry script does not exist: ${entryPath}`);
     return 1;
   }
+  if (existsSync3(absOutPath)) {
+    try {
+      unlinkSync(absOutPath);
+    } catch (err) {
+      echoError(`Failed to clear stale output ${absOutPath}: ${err instanceof Error ? err.message : String(err)}`);
+      return 1;
+    }
+  }
   const proc = spawnPluginEntry({
     entryPath,
     cwd: record2.dir,
@@ -26541,7 +26593,7 @@ async function runInvoke(opts) {
     echoError(`Plugin entry succeeded but did not write output file: ${absOutPath}`);
     return 1;
   }
-  if (showNotesArrayInput) {
+  if (artifactOutput) {
     if (statSync3(absOutPath).size === 0) {
       echoError(`Plugin entry succeeded but wrote an empty output file: ${absOutPath}`);
       return 1;
@@ -26568,6 +26620,12 @@ async function runInvoke(opts) {
     echoError(`Output schema violation for kind '${record2.kind}': ${issues}`);
     return 1;
   }
+  const parsed = outResult.data;
+  if (record2.kind === "publish" && parsed.ok === false) {
+    const reason = parsed.error ?? parsed.message ?? "publish failed";
+    echoError(`Plugin '${record2.name}' reported failure: ${reason}`);
+    return 1;
+  }
   return 0;
 }
 
@@ -26912,9 +26970,6 @@ async function fanout(content, targets, dispatch) {
   }
   return aggregate(entries);
 }
-function selectRetryTargets(prior) {
-  return prior.targets.filter((t) => t.status === "failed").map((t) => t.target);
-}
 async function readContent(fs2, path3) {
   if (!await fs2.exists(path3)) {
     echoError(`Content file does not exist: ${path3}`);
@@ -26989,6 +27044,14 @@ async function readAggregateResult(fs2, path3) {
       echoError(`Result file ${path3} violates the aggregate result schema (target ${String(t.target)})`);
       return null;
     }
+    let metadata;
+    if (t.metadata !== undefined) {
+      if (typeof t.metadata !== "object" || t.metadata === null || Array.isArray(t.metadata)) {
+        echoError(`Result file ${path3} violates the aggregate result schema: target '${String(t.target)}' metadata must be an object`);
+        return null;
+      }
+      metadata = t.metadata;
+    }
     targets.push({
       target: t.target,
       ok: t.ok,
@@ -26996,7 +27059,8 @@ async function readAggregateResult(fs2, path3) {
       ...typeof t.url === "string" ? { url: t.url } : {},
       ...typeof t.id === "string" ? { id: t.id } : {},
       ...typeof t.error === "string" ? { error: t.error } : {},
-      ...typeof t.durationMs === "number" ? { durationMs: t.durationMs } : {}
+      ...typeof t.durationMs === "number" ? { durationMs: t.durationMs } : {},
+      ...metadata !== undefined ? { metadata } : {}
     });
   }
   return {
@@ -27164,6 +27228,7 @@ async function runFanout(argv, deps = {}) {
   let prior;
   let skipped = [];
   let targets = opts.targets;
+  let retainedFailed = [];
   if (opts.retryFromPath !== undefined) {
     const parsed = await readAggregateResult(fs2, opts.retryFromPath);
     if (parsed === null) {
@@ -27175,17 +27240,26 @@ async function runFanout(argv, deps = {}) {
       ok: true,
       status: "skipped",
       ...t.url !== undefined ? { url: t.url } : {},
-      ...t.id !== undefined ? { id: t.id } : {}
+      ...t.id !== undefined ? { id: t.id } : {},
+      ...t.metadata !== undefined ? { metadata: t.metadata } : {}
     }));
     const carried = new Set(skipped.map((t) => t.target));
-    targets = opts.targets.length > 0 ? opts.targets.filter((t) => !carried.has(t)) : selectRetryTargets(prior);
+    const priorFailed = prior.targets.filter((t) => t.status === "failed");
+    if (opts.targets.length > 0) {
+      const attempt = [...new Set(opts.targets.filter((t) => !carried.has(t)))];
+      const attemptSet = new Set(attempt);
+      targets = attempt;
+      retainedFailed = priorFailed.filter((t) => !attemptSet.has(t.target));
+    } else {
+      targets = priorFailed.map((t) => t.target);
+    }
   }
   const dispatch = deps.dispatch ?? ((t) => pluginDispatch(t, opts.contentPath, discovery));
   if (deps.dispatch === undefined && !validateTargets(targets, discovery)) {
     return EXIT_INPUT2;
   }
   const fresh = await fanout(content, targets, dispatch);
-  const result = prior !== undefined ? aggregate([...skipped, ...fresh.targets]) : fresh;
+  const result = prior !== undefined ? aggregate([...skipped, ...retainedFailed, ...fresh.targets]) : fresh;
   try {
     await fs2.writeFile(resolve4(opts.outPath), `${JSON.stringify(result, null, 2)}
 `);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/knowledge-kit",
-    "version": "0.0.12",
+    "version": "0.0.13",
     "description": "An ingest → create → publish content pipeline CLI (Bun).",
     "repository": {
         "type": "git",