sdtk-wiki-kit 0.2.0 → 0.2.2

package/package.json

@@ -1,45 +1,45 @@
-{
-  "name": "sdtk-wiki-kit",
-  "version": "0.2.0",
-  "description": "Project-local wiki and knowledge graph toolkit for SDTK workspaces.",
-  "bin": {
-    "sdtk-wiki": "bin/sdtk-wiki.js"
-  },
-  "main": "src/index.js",
-  "type": "commonjs",
-  "files": [
-    "bin/",
-    "src/",
-    "assets/keys/sdtk-entitlement-public.pem",
-    "assets/atlas/build_atlas.py",
-    "assets/atlas/doc_atlas_viewer_template.html",
-    "assets/atlas/vendor/mermaid.min.js"
-  ],
-  "scripts": {
-    "test": "powershell -ExecutionPolicy Bypass -Command \"$ErrorActionPreference = 'Stop'; Set-Location '..\\..\\..\\..'; python -m unittest tests.test_sdtk_wiki_cli tests.test_sdtk_wiki_context\"",
-    "pack:smoke": "npm pack --dry-run"
-  },
-  "engines": {
-    "node": ">=18.13.0"
-  },
-  "keywords": [
-    "sdtk-wiki",
-    "wiki",
-    "knowledge-graph",
-    "cli",
-    "toolkit"
-  ],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/codexsdtk/sdtk-toolkit.git",
-    "directory": "products/sdtk-wiki/distribution/sdtk-wiki-kit"
-  },
-  "homepage": "https://github.com/codexsdtk/sdtk-toolkit/tree/main/products/sdtk-wiki/distribution/sdtk-wiki-kit",
-  "bugs": {
-    "url": "https://github.com/codexsdtk/sdtk-toolkit/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "sdtk-wiki-kit",
+  "version": "0.2.2",
+  "description": "Project-local wiki and knowledge graph toolkit for SDTK workspaces.",
+  "bin": {
+    "sdtk-wiki": "bin/sdtk-wiki.js"
+  },
+  "main": "src/index.js",
+  "type": "commonjs",
+  "files": [
+    "bin/",
+    "src/",
+    "assets/keys/sdtk-entitlement-public.pem",
+    "assets/atlas/build_atlas.py",
+    "assets/atlas/doc_atlas_viewer_template.html",
+    "assets/atlas/vendor/mermaid.min.js"
+  ],
+  "scripts": {
+    "test": "powershell -ExecutionPolicy Bypass -Command \"$ErrorActionPreference = 'Stop'; Set-Location '..\\..\\..\\..'; python -m unittest tests.test_sdtk_wiki_cli tests.test_sdtk_wiki_context\"",
+    "pack:smoke": "npm pack --dry-run"
+  },
+  "engines": {
+    "node": ">=18.13.0"
+  },
+  "keywords": [
+    "sdtk-wiki",
+    "wiki",
+    "knowledge-graph",
+    "cli",
+    "toolkit"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/codexsdtk/sdtk-toolkit.git",
+    "directory": "products/sdtk-wiki/distribution/sdtk-wiki-kit"
+  },
+  "homepage": "https://github.com/codexsdtk/sdtk-toolkit/tree/main/products/sdtk-wiki/distribution/sdtk-wiki-kit",
+  "bugs": {
+    "url": "https://github.com/codexsdtk/sdtk-toolkit/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/commands/ask.js

@@ -57,6 +57,8 @@ Inputs:
 Behavior:
   Executes a local premium wiki.ask runtime pack when entitlement and graph preconditions pass.
   Fails closed when the graph, entitlement, or runtime pack is missing.
+  --source grounds on the chosen doc plus its directly-related siblings (docs sharing
+  the same BK issue, knowledge id, skill, or family), bounded and labelled as related.
   Query history is off by default.
   --save-query writes one redacted JSON record under .sdtk/wiki/queries after a successful answer.
   Full question and full answer are not stored by default.`);

package/src/commands/context.js

@@ -1,67 +1,67 @@
-"use strict";
-
-const { parseFlags } = require("../lib/args");
-const { ValidationError } = require("../lib/errors");
-const { writeContextPack } = require("../lib/wiki-context-pack");
-
-const CONTEXT_FLAG_DEFS = {
-  help: { type: "boolean", alias: "h" },
-  topic: { type: "string" },
-  budget: { type: "string" },
-  "project-path": { type: "string" },
-  out: { type: "string" },
-};
-
-function parseContextFlags(args) {
-  return parseFlags(args || [], CONTEXT_FLAG_DEFS);
-}
-
-function printContextHelp() {
-  console.log(`SDTK-WIKI Context Pack
-
-Usage:
-  sdtk-wiki context --topic launch --budget 4000 --project-path .
-
-Purpose:
-  Write a budgeted, source-linked context pack for compact/resume handoff.
-
-Behavior:
-  Local-only. No network, no iii-sdk, no raw prompt dump.`);
-  return 0;
-}
-
-function parseBudget(value) {
-  if (value === undefined) {
-    return 4000;
-  }
-  const budget = Number(value);
-  if (!Number.isInteger(budget) || budget <= 0) {
-    throw new ValidationError("--budget must be a positive integer.");
-  }
-  return budget;
-}
-
-function cmdContext(args) {
-  const { flags } = parseContextFlags(args || []);
-  if (flags.help) {
-    return printContextHelp();
-  }
-  if (!flags.topic || !String(flags.topic).trim()) {
-    throw new ValidationError("--topic is required.");
-  }
-  const result = writeContextPack(flags["project-path"], {
-    topic: flags.topic,
-    budget: parseBudget(flags.budget),
-    out: flags.out,
-  });
-  console.log(
-    `Context pack: ${result.selected} items, ${result.pinned} pinned, ${result.tokens}/${result.budget} tokens, ${result.pagedOut} paged out -> ${result.path}`
-  );
-  return 0;
-}
-
-module.exports = {
-  cmdContext,
-  parseContextFlags,
-  printContextHelp,
-};
+"use strict";
+
+const { parseFlags } = require("../lib/args");
+const { ValidationError } = require("../lib/errors");
+const { writeContextPack } = require("../lib/wiki-context-pack");
+
+const CONTEXT_FLAG_DEFS = {
+  help: { type: "boolean", alias: "h" },
+  topic: { type: "string" },
+  budget: { type: "string" },
+  "project-path": { type: "string" },
+  out: { type: "string" },
+};
+
+function parseContextFlags(args) {
+  return parseFlags(args || [], CONTEXT_FLAG_DEFS);
+}
+
+function printContextHelp() {
+  console.log(`SDTK-WIKI Context Pack
+
+Usage:
+  sdtk-wiki context --topic launch --budget 4000 --project-path .
+
+Purpose:
+  Write a budgeted, source-linked context pack for compact/resume handoff.
+
+Behavior:
+  Local-only. No network, no iii-sdk, no raw prompt dump.`);
+  return 0;
+}
+
+function parseBudget(value) {
+  if (value === undefined) {
+    return 4000;
+  }
+  const budget = Number(value);
+  if (!Number.isInteger(budget) || budget <= 0) {
+    throw new ValidationError("--budget must be a positive integer.");
+  }
+  return budget;
+}
+
+function cmdContext(args) {
+  const { flags } = parseContextFlags(args || []);
+  if (flags.help) {
+    return printContextHelp();
+  }
+  if (!flags.topic || !String(flags.topic).trim()) {
+    throw new ValidationError("--topic is required.");
+  }
+  const result = writeContextPack(flags["project-path"], {
+    topic: flags.topic,
+    budget: parseBudget(flags.budget),
+    out: flags.out,
+  });
+  console.log(
+    `Context pack: ${result.selected} items, ${result.pinned} pinned, ${result.tokens}/${result.budget} tokens, ${result.pagedOut} paged out -> ${result.path}`
+  );
+  return 0;
+}
+
+module.exports = {
+  cmdContext,
+  parseContextFlags,
+  printContextHelp,
+};

package/src/commands/help.js

@@ -24,6 +24,7 @@ Usage:
   sdtk-wiki ask --help
   sdtk-wiki search --help
   sdtk-wiki lint --help
+  sdtk-wiki update --check-only
 
 Simple local wiki workflow:
   sdtk-wiki init --no-open
@@ -31,6 +32,7 @@ Simple local wiki workflow:
   sdtk-wiki compile --mode safe [--apply]
   sdtk-wiki query "<query>"
   sdtk-wiki lint
+  sdtk-wiki update --check-only
   sdtk-wiki discover --plan
   sdtk-wiki maintain --mode safe
 
@@ -53,6 +55,11 @@ R1 command model:
   ask                  Ask grounded questions over the built SDTK-WIKI graph.
   search               Search generated local wiki pages without premium Ask.
   lint                 Write a report-first, non-destructive wiki lint report.
+  update               Package-only updater; no wiki/.sdtk/wiki/.sdtk/atlas files are mutated in R1.
+
+Update workflow:
+  sdtk-wiki update --check-only
+  npm install -g sdtk-wiki-kit@<version>
 
 Advanced/audit workflow:
   sdtk-wiki wiki extract --source-root <source-root> --dry-run

package/src/commands/init.js

@@ -32,7 +32,7 @@ BK-102 behavior:
 Options:
   --project-path <path>   Project root. Defaults to current working directory.
   --output-dir <path>     Graph output dir under .sdtk/wiki. Defaults to .sdtk/wiki/graph.
-  --scan-root <path>      Repeatable markdown scan root.
+  --scan-root <path>      Repeatable markdown scan root. Defaults to ./docs if it exists, otherwise the project root.
   --force                 Overwrite existing config.
   --no-build              Write config only.
   --no-open               Build graph but do not launch viewer.

package/src/commands/update.js

@@ -0,0 +1,11 @@
+"use strict";
+
+const { executeUpdate } = require("../lib/update");
+
+async function cmdUpdate(args) {
+  return executeUpdate(args);
+}
+
+module.exports = {
+  cmdUpdate,
+};

package/src/index.js

@@ -1,107 +1,111 @@
-"use strict";
-
-const { cmdAtlas } = require("./commands/atlas");
-const { cmdAsk } = require("./commands/ask");
-const { cmdHelp } = require("./commands/help");
-const { cmdInit } = require("./commands/init");
-const { cmdLint } = require("./commands/lint");
-const {
-  cmdCompile,
-  cmdDiscover,
-  cmdIngest,
-  cmdMaintain,
-  cmdQuery,
-} = require("./commands/operations");
-const { cmdEnrich } = require("./commands/enrich");
-const { cmdContext } = require("./commands/context");
-const { cmdSearch } = require("./commands/search");
-const { cmdWiki } = require("./commands/wiki");
-const { ValidationError } = require("./lib/errors");
-
-function getVersion() {
-  const pkg = require("../package.json");
-  return pkg.version;
-}
-
-function parseCommand(argv) {
-  if (!argv || argv.length === 0) {
-    return { command: "help", args: [] };
-  }
-
-  const [first, ...rest] = argv;
-  if (first === "-h" || first === "--help") {
-    return { command: "help", args: [] };
-  }
-  if (first === "-v" || first === "--version") {
-    return { command: "version", args: [] };
-  }
-
-  return { command: first, args: rest };
-}
-
-const COMMANDS = new Set([
-  "help",
-  "version",
-  "init",
-  "atlas",
-  "wiki",
-  "ask",
-  "lint",
-  "search",
-  "ingest",
-  "compile",
-  "query",
-  "discover",
-  "maintain",
-  "enrich",
-  "context",
-]);
-
-async function run(argv) {
-  const { command, args } = parseCommand(argv);
-
-  if (!COMMANDS.has(command)) {
-    throw new ValidationError(
-      `Unknown command: "${command}". Run "sdtk-wiki --help" for available commands.`
-    );
-  }
-
-  switch (command) {
-    case "help":
-      return cmdHelp();
-    case "version":
-      console.log(`sdtk-wiki-kit ${getVersion()}`);
-      return 0;
-    case "init":
-      return cmdInit(args);
-    case "atlas":
-      return cmdAtlas(args);
-    case "wiki":
-      return cmdWiki(args);
-    case "ask":
-      return cmdAsk(args);
-    case "lint":
-      return cmdLint(args);
-    case "search":
-      return cmdSearch(args);
-    case "ingest":
-      return cmdIngest(args);
-    case "compile":
-      return cmdCompile(args);
-    case "query":
-      return cmdQuery(args);
-    case "discover":
-      return cmdDiscover(args);
-    case "maintain":
-      return cmdMaintain(args);
-    case "enrich":
-      return cmdEnrich(args);
-    case "context":
-      return cmdContext(args);
-  }
-}
-
-module.exports = {
-  parseCommand,
-  run,
-};
+"use strict";
+
+const { cmdAtlas } = require("./commands/atlas");
+const { cmdAsk } = require("./commands/ask");
+const { cmdHelp } = require("./commands/help");
+const { cmdInit } = require("./commands/init");
+const { cmdLint } = require("./commands/lint");
+const {
+  cmdCompile,
+  cmdDiscover,
+  cmdIngest,
+  cmdMaintain,
+  cmdQuery,
+} = require("./commands/operations");
+const { cmdEnrich } = require("./commands/enrich");
+const { cmdContext } = require("./commands/context");
+const { cmdSearch } = require("./commands/search");
+const { cmdUpdate } = require("./commands/update");
+const { cmdWiki } = require("./commands/wiki");
+const { ValidationError } = require("./lib/errors");
+
+function getVersion() {
+  const pkg = require("../package.json");
+  return pkg.version;
+}
+
+function parseCommand(argv) {
+  if (!argv || argv.length === 0) {
+    return { command: "help", args: [] };
+  }
+
+  const [first, ...rest] = argv;
+  if (first === "-h" || first === "--help") {
+    return { command: "help", args: [] };
+  }
+  if (first === "-v" || first === "--version") {
+    return { command: "version", args: [] };
+  }
+
+  return { command: first, args: rest };
+}
+
+const COMMANDS = new Set([
+  "help",
+  "version",
+  "init",
+  "atlas",
+  "wiki",
+  "ask",
+  "lint",
+  "search",
+  "ingest",
+  "compile",
+  "query",
+  "discover",
+  "maintain",
+  "enrich",
+  "context",
+  "update",
+]);
+
+async function run(argv) {
+  const { command, args } = parseCommand(argv);
+
+  if (!COMMANDS.has(command)) {
+    throw new ValidationError(
+      `Unknown command: "${command}". Run "sdtk-wiki --help" for available commands.`
+    );
+  }
+
+  switch (command) {
+    case "help":
+      return cmdHelp();
+    case "version":
+      console.log(`sdtk-wiki-kit ${getVersion()}`);
+      return 0;
+    case "init":
+      return cmdInit(args);
+    case "atlas":
+      return cmdAtlas(args);
+    case "wiki":
+      return cmdWiki(args);
+    case "ask":
+      return cmdAsk(args);
+    case "lint":
+      return cmdLint(args);
+    case "search":
+      return cmdSearch(args);
+    case "ingest":
+      return cmdIngest(args);
+    case "compile":
+      return cmdCompile(args);
+    case "query":
+      return cmdQuery(args);
+    case "discover":
+      return cmdDiscover(args);
+    case "maintain":
+      return cmdMaintain(args);
+    case "enrich":
+      return cmdEnrich(args);
+    case "context":
+      return cmdContext(args);
+    case "update":
+      return cmdUpdate(args);
+  }
+}
+
+module.exports = {
+  parseCommand,
+  run,
+};