sdtk-wiki-kit 0.1.0 → 0.1.1

package/src/commands/wiki.js

@@ -3,11 +3,12 @@
 const fs = require("fs");
 const path = require("path");
 const { CliError, ValidationError } = require("../lib/errors");
-const { runWikiCompileDryRun } = require("../lib/wiki-compile");
+const { runWikiCompileApply, runWikiCompileDryRun } = require("../lib/wiki-compile");
 const { runWikiDiscoverPlan } = require("../lib/wiki-discover");
+const { runWikiExtractDryRun } = require("../lib/wiki-extract");
 const { ingestLocalSource } = require("../lib/wiki-ingest");
 const { runWikiPruneDryRun } = require("../lib/wiki-prune");
-const { COMPILE_FLAG_DEFS, DISCOVER_FLAG_DEFS, PRUNE_FLAG_DEFS, parseWikiFlags } = require("../lib/wiki-flags");
+const { COMPILE_FLAG_DEFS, DISCOVER_FLAG_DEFS, EXTRACT_FLAG_DEFS, PRUNE_FLAG_DEFS, parseWikiFlags } = require("../lib/wiki-flags");
 
 function hasHelp(args) {
   return args.includes("-h") || args.includes("--help");
@@ -20,30 +21,53 @@ function cmdWikiHelp() {
   sdtk-wiki wiki prune --help
   sdtk-wiki wiki discover --help
   sdtk-wiki wiki compile --help
+  sdtk-wiki wiki extract --help
 
 Purpose:
   Native SDTK-WIKI command namespace.
 
 Deferred:
-  web discover/fetch, compile/apply, destructive cleanup/archive, and payload snapshots remain deferred.
+  web discover/fetch, destructive cleanup/archive, and payload snapshots remain deferred.
   Web discover/improve must not be enabled by default in R1.`);
   return 0;
 }
 
+function cmdWikiExtractHelp() {
+  console.log(`Usage:
+  sdtk-wiki wiki extract --project-path <path> --source-root <path> --dry-run
+
+Purpose:
+  Write a local semantic extraction dry-run report for SDTK-WIKI personal-brain generation.
+
+Writes:
+  .sdtk/wiki/reports/semantic-extraction-dry-run-YYYYMMDD-HHMMSSZ.json
+
+Safety:
+  Dry-run report only.
+  Local Markdown source roots only; remote URLs are rejected.
+  No personal-brain pages, managed pages, raw sources, provenance state, atlas compatibility files, web fetch, Ask, compile/apply, prune, delete, archive, or source files are modified.`);
+  return 0;
+}
+
 function cmdWikiCompileHelp() {
   console.log(`Usage:
   sdtk-wiki wiki compile --plan <path> --project-path <path> --dry-run
+  sdtk-wiki wiki compile --plan <compile-apply-plan.json> --project-path <path> --apply --yes
 
 Purpose:
-  Write a compile dry-run preview from a local markdown or JSON plan.
+  Write a compile dry-run preview and machine-readable apply plan, or explicitly apply an approved apply plan.
 
 Writes:
   .sdtk/wiki/reports/compile-dry-run-preview-YYYY-MM-DD.md
+  .sdtk/wiki/reports/compile-apply-plan-YYYY-MM-DD.json
+  .sdtk/wiki/personal-brain/... only when --apply --yes is used with an apply JSON sidecar
 
 Safety:
-  Preview-only.
-  No --apply behavior is implemented in BK-126.
-  No wiki page, raw source, provenance, atlas compatibility, discover, prune, query-history, or release mutation.
+  Dry-run remains preview-only.
+  Apply consumes only record_type sdtk_wiki_compile_apply_plan JSON sidecars.
+  Markdown plans and semantic extraction JSON are rejected for apply.
+  Apply is create-only or same-content no-op under .sdtk/wiki/personal-brain.
+  No delete, archive, rewrite, reorder, raw source, provenance, atlas compatibility, discover, prune, query-history, or release mutation.
   Unknown operation types are reported as unsupported_operation and cause a non-zero exit after the report is written.`);
   return 0;
 }
@@ -117,6 +141,10 @@ function parseDiscoverFlags(args) {
   return parseWikiFlags(args, DISCOVER_FLAG_DEFS);
 }
 
+function parseExtractFlags(args) {
+  return parseWikiFlags(args, EXTRACT_FLAG_DEFS);
+}
+
 function parseCompileFlags(args) {
   return parseWikiFlags(args, COMPILE_FLAG_DEFS);
 }
@@ -185,10 +213,27 @@ function cmdWikiCompile(args) {
   if (hasHelp(args)) return cmdWikiCompileHelp();
   const { flags } = parseCompileFlags(args);
   if (flags.apply) {
-    throw new ValidationError("--apply is deferred to BK-127. BK-126 supports compile dry-run preview only. No project files were changed.");
+    if (!flags.yes) {
+      throw new ValidationError("sdtk-wiki wiki compile --apply requires --yes. No project files were changed.");
+    }
+    if (!flags.plan) {
+      throw new ValidationError("sdtk-wiki wiki compile --apply requires --plan <compile-apply-plan.json>. No project files were changed.");
+    }
+    const projectPath = ensureProjectPath(flags["project-path"]);
+    const result = runWikiCompileApply({ projectPath, planArg: flags.plan });
+
+    console.log(`[wiki] Compile apply plan: ${result.planPath}`);
+    console.log(`[wiki] Created files: ${result.created.length}`);
+    console.log(`[wiki] Unchanged files: ${result.unchanged.length}`);
+    console.log(`[wiki] Source-quality warnings: ${result.sourceQualityWarningCount}`);
+    if (result.sourceQualityWarningCount > 0) {
+      console.log("[wiki] Source-quality findings were present in the apply plan; pages were still applied because --yes was explicit.");
+    }
+    console.log("[wiki] No source files, raw sources, provenance descriptors, or atlas compatibility files were modified.");
+    return 0;
   }
   if (!flags["dry-run"]) {
-    throw new ValidationError("sdtk-wiki wiki compile requires --dry-run in BK-126. No project files were changed.");
+    throw new ValidationError("sdtk-wiki wiki compile requires --dry-run or --apply --yes. No project files were changed.");
   }
   if (!flags.plan) {
     throw new ValidationError("sdtk-wiki wiki compile requires --plan <path>. No project files were changed.");
@@ -197,6 +242,7 @@ function cmdWikiCompile(args) {
   const result = runWikiCompileDryRun({ projectPath, planArg: flags.plan });
 
   console.log(`[wiki] Compile dry-run preview: ${result.reportPath}`);
+  console.log(`[wiki] Compile apply JSON sidecar: ${result.applyPlanPath}`);
   console.log(`[wiki] Operations: ${result.operations.length}`);
   console.log(`[wiki] Unsupported operations: ${result.unsupportedCount}`);
   console.log("[wiki] No wiki pages, raw sources, provenance, or atlas compatibility files were modified.");
@@ -209,6 +255,29 @@ function cmdWikiCompile(args) {
   return 0;
 }
 
+function cmdWikiExtract(args) {
+  if (hasHelp(args)) return cmdWikiExtractHelp();
+  const { flags } = parseExtractFlags(args);
+  if (!flags["dry-run"]) {
+    throw new ValidationError("sdtk-wiki wiki extract requires --dry-run. Runtime extraction writes a report only; no project files were changed.");
+  }
+  if (!flags["source-root"]) {
+    throw new ValidationError("sdtk-wiki wiki extract requires --source-root <path>. No project files were changed.");
+  }
+  const projectPath = ensureProjectPath(flags["project-path"]);
+  const result = runWikiExtractDryRun({ projectPath, sourceRootArg: flags["source-root"] });
+  const extraction = result.extraction;
+
+  console.log(`[wiki] Semantic extraction dry-run report: ${result.reportPath}`);
+  console.log(`[wiki] Sources scanned: ${extraction.source_counts.scanned}`);
+  console.log(`[wiki] Sources indexed: ${extraction.source_counts.indexed}`);
+  console.log(`[wiki] Tool candidates: ${extraction.tool_entities.length}`);
+  console.log(`[wiki] Concept candidates: ${extraction.concepts.length}`);
+  console.log(`[wiki] Quality findings: ${extraction.source_quality_findings.length}`);
+  console.log("[wiki] No personal-brain pages, raw sources, provenance state, or atlas compatibility files were modified.");
+  return 0;
+}
+
 function cmdWiki(args) {
   if (!args || args.length === 0) {
     return cmdWikiHelp();
@@ -230,6 +299,9 @@ function cmdWiki(args) {
   if (subcommand === "compile") {
     return cmdWikiCompile(rest);
   }
+  if (subcommand === "extract") {
+    return cmdWikiExtract(rest);
+  }
 
   throw new CliError(
     `Unknown wiki command: "${subcommand}". Run "sdtk-wiki wiki --help". No project files were changed.`,
@@ -243,6 +315,8 @@ module.exports = {
   cmdWikiCompileHelp,
   cmdWikiDiscover,
   cmdWikiDiscoverHelp,
+  cmdWikiExtract,
+  cmdWikiExtractHelp,
   cmdWikiHelp,
   cmdWikiIngest,
   cmdWikiIngestHelp,

package/src/index.js

@@ -5,6 +5,7 @@ const { cmdAsk } = require("./commands/ask");
 const { cmdHelp } = require("./commands/help");
 const { cmdInit } = require("./commands/init");
 const { cmdLint } = require("./commands/lint");
+const { cmdSearch } = require("./commands/search");
 const { cmdWiki } = require("./commands/wiki");
 const { ValidationError } = require("./lib/errors");
 
@@ -29,7 +30,7 @@ function parseCommand(argv) {
   return { command: first, args: rest };
 }
 
-const COMMANDS = new Set(["help", "version", "init", "atlas", "wiki", "ask", "lint"]);
+const COMMANDS = new Set(["help", "version", "init", "atlas", "wiki", "ask", "lint", "search"]);
 
 async function run(argv) {
   const { command, args } = parseCommand(argv);
@@ -56,6 +57,8 @@ async function run(argv) {
       return cmdAsk(args);
     case "lint":
       return cmdLint(args);
+    case "search":
+      return cmdSearch(args);
   }
 }