bluera-knowledge 0.11.8 → 0.11.10

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "bluera-knowledge",
-  "version": "0.11.8",
+  "version": "0.11.10",
   "description": "Clone repos, crawl docs, search locally. Fast, authoritative answers for AI coding agents.",
   "mcpServers": {
     "bluera-knowledge": {

package/.github/workflows/auto-release.yml

@@ -40,6 +40,11 @@ jobs:
             echo "exists=false" >> $GITHUB_OUTPUT
           fi
 
+      # CRITICAL: This is the quality gate for releases.
+      # CI workflow does NOT run on tags (to avoid redundant ~3 min test runs).
+      # This step ensures all CI checks pass on main BEFORE creating a tag.
+      # The Release workflow trusts this guarantee and publishes immediately.
+      # See ci.yml header comment for the full quality guarantee chain.
       - name: Wait for CI to complete
         if: steps.check_tag.outputs.exists == 'false'
         uses: lewagon/wait-on-check-action@v1.3.4

package/.github/workflows/ci.yml

@@ -1,9 +1,22 @@
 name: CI
 
+# CI runs on branch pushes and PRs, but NOT on tags.
+#
+# Why no tag trigger?
+# - Auto Release workflow (auto-release.yml) waits for CI to pass on main
+#   before creating a tag (uses wait-on-check-action with lint-and-typecheck,
+#   test, build checks)
+# - The tag contains the exact same code that just passed CI on main
+# - Running CI again on the tag is redundant and wastes ~3 minutes per release
+# - Release workflow (release.yml) trusts this guarantee and publishes immediately
+#
+# Quality guarantee chain:
+#   push to main → CI passes → Auto Release creates tag → Release publishes
+#
 on:
   push:
     branches: ['**']
-    tags: ['v*']
+    # Note: tags intentionally excluded - see comment above
   pull_request:
     branches: [main]
 

package/.github/workflows/release.yml

@@ -1,5 +1,11 @@
 name: Release
 
+# Publishes to npm when a tag is pushed.
+#
+# Quality assumption: Tags are only created by Auto Release workflow AFTER
+# CI passes on main. This workflow trusts that guarantee and does not re-run
+# tests. See ci.yml and auto-release.yml for the full quality chain.
+#
 on:
   push:
     tags:

package/CHANGELOG.md

@@ -2,6 +2,35 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+## [0.11.10](https://github.com/blueraai/bluera-knowledge/compare/v0.11.6...v0.11.10) (2026-01-10)
+
+
+### Features
+
+* **scripts:** add post-release npm validation script ([e4c29a0](https://github.com/blueraai/bluera-knowledge/commit/e4c29a0c83907de4bc293a69a58412629457fb22))
+
+
+### Bug Fixes
+
+* **cli:** plugin-api commands now respect global options ([d3cca02](https://github.com/blueraai/bluera-knowledge/commit/d3cca02ffc679ffc187b76c7682f3cc177eabdea))
+* **plugin:** properly close services after command execution ([eeaf743](https://github.com/blueraai/bluera-knowledge/commit/eeaf743750be73fd9c7a9e72440b2fd0fb5a53fa))
+* **scripts:** show real-time output in validation script ([8a4bdec](https://github.com/blueraai/bluera-knowledge/commit/8a4bdec8b63c504d34ba35bfe19da795f7f7fd07))
+* **scripts:** use mktemp for temp directories in validation script ([3107861](https://github.com/blueraai/bluera-knowledge/commit/3107861bd7a966016fde2a121469dd84756f39be))
+
+## [0.11.9](https://github.com/blueraai/bluera-knowledge/compare/v0.11.6...v0.11.9) (2026-01-10)
+
+
+### Features
+
+* **scripts:** add post-release npm validation script ([e4c29a0](https://github.com/blueraai/bluera-knowledge/commit/e4c29a0c83907de4bc293a69a58412629457fb22))
+
+
+### Bug Fixes
+
+* **cli:** plugin-api commands now respect global options ([d3cca02](https://github.com/blueraai/bluera-knowledge/commit/d3cca02ffc679ffc187b76c7682f3cc177eabdea))
+* **scripts:** show real-time output in validation script ([8a4bdec](https://github.com/blueraai/bluera-knowledge/commit/8a4bdec8b63c504d34ba35bfe19da795f7f7fd07))
+* **scripts:** use mktemp for temp directories in validation script ([3107861](https://github.com/blueraai/bluera-knowledge/commit/3107861bd7a966016fde2a121469dd84756f39be))
+
 ## [0.11.8](https://github.com/blueraai/bluera-knowledge/compare/v0.11.6...v0.11.8) (2026-01-10)
 
 

package/dist/index.js

@@ -779,28 +779,32 @@ async function handleAddRepo(args, options = {}) {
     options.dataDir,
     options.projectRoot ?? process.env["PWD"]
   );
-  const storeName = args.name ?? extractRepoName(args.url);
-  console.log(`Cloning ${args.url}...`);
-  const result = await services.store.create({
-    name: storeName,
-    type: "repo",
-    url: args.url,
-    ...args.branch !== void 0 ? { branch: args.branch } : {}
-  });
-  if (!result.success) {
-    console.error(`Error: ${result.error.message}`);
-    process.exit(1);
-  }
-  console.log(`Created store: ${storeName} (${result.data.id})`);
-  if ("path" in result.data) {
-    console.log(`Location: ${result.data.path}`);
-  }
-  console.log("\nIndexing...");
-  const indexResult = await services.index.indexStore(result.data);
-  if (indexResult.success) {
-    console.log(`Indexed ${String(indexResult.data.documentsIndexed)} files`);
-  } else {
-    console.error(`Indexing failed: ${indexResult.error.message}`);
+  try {
+    const storeName = args.name ?? extractRepoName(args.url);
+    console.log(`Cloning ${args.url}...`);
+    const result = await services.store.create({
+      name: storeName,
+      type: "repo",
+      url: args.url,
+      ...args.branch !== void 0 ? { branch: args.branch } : {}
+    });
+    if (!result.success) {
+      console.error(`Error: ${result.error.message}`);
+      process.exit(1);
+    }
+    console.log(`Created store: ${storeName} (${result.data.id})`);
+    if ("path" in result.data) {
+      console.log(`Location: ${result.data.path}`);
+    }
+    console.log("\nIndexing...");
+    const indexResult = await services.index.indexStore(result.data);
+    if (indexResult.success) {
+      console.log(`Indexed ${String(indexResult.data.documentsIndexed)} files`);
+    } else {
+      console.error(`Indexing failed: ${indexResult.error.message}`);
+    }
+  } finally {
+    await destroyServices(services);
   }
 }
 async function handleAddFolder(args, options = {}) {
@@ -809,28 +813,32 @@ async function handleAddFolder(args, options = {}) {
     options.dataDir,
     options.projectRoot ?? process.env["PWD"]
   );
-  const { basename } = await import("path");
-  const storeName = args.name ?? basename(args.path);
-  console.log(`Adding folder: ${args.path}...`);
-  const result = await services.store.create({
-    name: storeName,
-    type: "file",
-    path: args.path
-  });
-  if (!result.success) {
-    console.error(`Error: ${result.error.message}`);
-    process.exit(1);
-  }
-  console.log(`Created store: ${storeName} (${result.data.id})`);
-  if ("path" in result.data) {
-    console.log(`Location: ${result.data.path}`);
-  }
-  console.log("\nIndexing...");
-  const indexResult = await services.index.indexStore(result.data);
-  if (indexResult.success) {
-    console.log(`Indexed ${String(indexResult.data.documentsIndexed)} files`);
-  } else {
-    console.error(`Indexing failed: ${indexResult.error.message}`);
+  try {
+    const { basename } = await import("path");
+    const storeName = args.name ?? basename(args.path);
+    console.log(`Adding folder: ${args.path}...`);
+    const result = await services.store.create({
+      name: storeName,
+      type: "file",
+      path: args.path
+    });
+    if (!result.success) {
+      console.error(`Error: ${result.error.message}`);
+      process.exit(1);
+    }
+    console.log(`Created store: ${storeName} (${result.data.id})`);
+    if ("path" in result.data) {
+      console.log(`Location: ${result.data.path}`);
+    }
+    console.log("\nIndexing...");
+    const indexResult = await services.index.indexStore(result.data);
+    if (indexResult.success) {
+      console.log(`Indexed ${String(indexResult.data.documentsIndexed)} files`);
+    } else {
+      console.error(`Indexing failed: ${indexResult.error.message}`);
+    }
+  } finally {
+    await destroyServices(services);
   }
 }
 async function handleStores(options = {}) {
@@ -839,86 +847,94 @@ async function handleStores(options = {}) {
     options.dataDir,
     options.projectRoot ?? process.env["PWD"]
   );
-  const stores = await services.store.list();
-  if (stores.length === 0) {
-    console.log("No stores found.");
-    console.log("\nCreate a store with:");
-    console.log("  /bluera-knowledge:add-repo <url> --name=<name>");
-    console.log("  /bluera-knowledge:add-folder <path> --name=<name>");
-    return;
-  }
-  console.log("| Name | Type | ID | Source |");
-  console.log("|------|------|----|--------------------|");
-  for (const store of stores) {
-    const name = store.name;
-    const type = store.type;
-    const id = store.id;
-    let source = "";
-    if ("url" in store && store.url !== void 0) {
-      source = store.url;
-    } else if ("path" in store) {
-      source = store.path;
-    }
-    console.log(`| ${name} | ${type} | ${id.substring(0, 8)}... | ${source} |`);
+  try {
+    const stores = await services.store.list();
+    if (stores.length === 0) {
+      console.log("No stores found.");
+      console.log("\nCreate a store with:");
+      console.log("  /bluera-knowledge:add-repo <url> --name=<name>");
+      console.log("  /bluera-knowledge:add-folder <path> --name=<name>");
+      return;
+    }
+    console.log("| Name | Type | ID | Source |");
+    console.log("|------|------|----|--------------------|");
+    for (const store of stores) {
+      const name = store.name;
+      const type = store.type;
+      const id = store.id;
+      let source = "";
+      if ("url" in store && store.url !== void 0) {
+        source = store.url;
+      } else if ("path" in store) {
+        source = store.path;
+      }
+      console.log(`| ${name} | ${type} | ${id.substring(0, 8)}... | ${source} |`);
+    }
+  } finally {
+    await destroyServices(services);
   }
 }
 async function handleSuggest(options = {}) {
   const projectRoot = options.projectRoot ?? process.env["PWD"] ?? process.cwd();
   console.log("Analyzing project dependencies...\n");
   const services = await createServices(options.config, options.dataDir, projectRoot);
-  const analyzer = new DependencyUsageAnalyzer();
-  const resolver = new RepoUrlResolver();
-  const spinner = ora3("Scanning source files...").start();
-  const result = await analyzer.analyze(projectRoot, (current, total, message) => {
-    spinner.text = `${message} (${String(current)}/${String(total)})`;
-  });
-  spinner.stop();
-  if (!result.success) {
-    console.error(`Error: ${result.error.message}`);
-    process.exit(1);
-  }
-  const { usages, totalFilesScanned, skippedFiles } = result.data;
-  console.log(
-    `\u2714 Scanned ${String(totalFilesScanned)} files${skippedFiles > 0 ? ` (skipped ${String(skippedFiles)})` : ""}
-`
-  );
-  if (usages.length === 0) {
-    console.log("No external dependencies found in this project.");
-    console.log("\nMake sure you have a package.json or requirements.txt file.");
-    return;
-  }
-  const existingStores = await services.store.list();
-  const existingRepoNames = new Set(existingStores.map((s) => s.name));
-  const newUsages = usages.filter((u) => !existingRepoNames.has(u.packageName));
-  if (newUsages.length === 0) {
-    console.log("\u2714 All dependencies are already in knowledge stores!");
-    return;
-  }
-  const topSuggestions = newUsages.slice(0, 5);
-  console.log("Top dependencies by usage in this project:\n");
-  topSuggestions.forEach((usage, i) => {
-    console.log(`${String(i + 1)}. ${usage.packageName}`);
+  try {
+    const analyzer = new DependencyUsageAnalyzer();
+    const resolver = new RepoUrlResolver();
+    const spinner = ora3("Scanning source files...").start();
+    const result = await analyzer.analyze(projectRoot, (current, total, message) => {
+      spinner.text = `${message} (${String(current)}/${String(total)})`;
+    });
+    spinner.stop();
+    if (!result.success) {
+      console.error(`Error: ${result.error.message}`);
+      process.exit(1);
+    }
+    const { usages, totalFilesScanned, skippedFiles } = result.data;
     console.log(
-      `   ${String(usage.importCount)} imports across ${String(usage.fileCount)} files
+      `\u2714 Scanned ${String(totalFilesScanned)} files${skippedFiles > 0 ? ` (skipped ${String(skippedFiles)})` : ""}
 `
     );
-  });
-  console.log("Searching for repository URLs...\n");
-  for (const usage of topSuggestions) {
-    const repoResult = await resolver.findRepoUrl(usage.packageName, usage.language);
-    if (repoResult.url !== null) {
-      console.log(`\u2714 ${usage.packageName}: ${repoResult.url}`);
-      console.log(`  /bluera-knowledge:add-repo ${repoResult.url} --name=${usage.packageName}
-`);
-    } else {
-      console.log(`\u2717 ${usage.packageName}: Could not find repository URL`);
+    if (usages.length === 0) {
+      console.log("No external dependencies found in this project.");
+      console.log("\nMake sure you have a package.json or requirements.txt file.");
+      return;
+    }
+    const existingStores = await services.store.list();
+    const existingRepoNames = new Set(existingStores.map((s) => s.name));
+    const newUsages = usages.filter((u) => !existingRepoNames.has(u.packageName));
+    if (newUsages.length === 0) {
+      console.log("\u2714 All dependencies are already in knowledge stores!");
+      return;
+    }
+    const topSuggestions = newUsages.slice(0, 5);
+    console.log("Top dependencies by usage in this project:\n");
+    topSuggestions.forEach((usage, i) => {
+      console.log(`${String(i + 1)}. ${usage.packageName}`);
       console.log(
-        `  You can manually add it: /bluera-knowledge:add-repo <url> --name=${usage.packageName}
+        `   ${String(usage.importCount)} imports across ${String(usage.fileCount)} files
 `
       );
+    });
+    console.log("Searching for repository URLs...\n");
+    for (const usage of topSuggestions) {
+      const repoResult = await resolver.findRepoUrl(usage.packageName, usage.language);
+      if (repoResult.url !== null) {
+        console.log(`\u2714 ${usage.packageName}: ${repoResult.url}`);
+        console.log(`  /bluera-knowledge:add-repo ${repoResult.url} --name=${usage.packageName}
+`);
+      } else {
+        console.log(`\u2717 ${usage.packageName}: Could not find repository URL`);
+        console.log(
+          `  You can manually add it: /bluera-knowledge:add-repo <url> --name=${usage.packageName}
+`
+        );
+      }
     }
+    console.log("Use the commands above to add repositories to your knowledge stores.");
+  } finally {
+    await destroyServices(services);
   }
-  console.log("Use the commands above to add repositories to your knowledge stores.");
 }
 
 // src/cli/commands/plugin-api.ts