bluera-knowledge 0.11.7 → 0.11.9

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "bluera-knowledge",
-  "version": "0.11.7",
+  "version": "0.11.9",
   "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,34 @@
 
 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.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)
+
+
+### 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.7](https://github.com/blueraai/bluera-knowledge/compare/v0.11.6...v0.11.7) (2026-01-10)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bluera-knowledge",
-  "version": "0.11.7",
+  "version": "0.11.9",
   "description": "CLI tool for managing knowledge stores with semantic search",
   "type": "module",
   "bin": {

package/scripts/validate-npm-release.sh

@@ -68,11 +68,11 @@ run_test() {
     local cmd="$*"
 
     log "Running: $cmd"
-    if eval "$cmd" >> "$LOG_FILE" 2>&1; then
+    if eval "$cmd" 2>&1 | tee -a "$LOG_FILE"; then
         pass "$name"
         return 0
     else
-        fail "$name (exit code: $?)"
+        fail "$name (exit code: ${PIPESTATUS[0]})"
         return 1
     fi
 }
@@ -86,19 +86,17 @@ run_test_contains() {
 
     log "Running: $cmd"
     local output
-    if output=$(eval "$cmd" 2>&1); then
+    # Capture output while also showing it on terminal via tee
+    if output=$(eval "$cmd" 2>&1 | tee -a "$LOG_FILE"); then
         if echo "$output" | grep -q "$expected"; then
             pass "$name"
-            echo "$output" >> "$LOG_FILE"
             return 0
         else
             fail "$name (output missing: $expected)"
-            echo "$output" >> "$LOG_FILE"
             return 1
         fi
     else
         fail "$name (command failed)"
-        echo "$output" >> "$LOG_FILE"
         return 1
     fi
 }

package/src/scripts/validate-npm-release.test.ts

@@ -31,4 +31,25 @@ describe('validate-npm-release.sh', () => {
     expect(scriptContent).toContain('trap');
     expect(scriptContent).toMatch(/rm -rf/);
   });
+
+  it('shows real-time output during command execution', () => {
+    // Script should use tee to show output on both terminal and log file
+    // This prevents the script from appearing "hung" during long-running commands
+    expect(scriptContent).toContain('tee -a');
+  });
+
+  it('does not redirect output only to log file in run_test functions', () => {
+    // The run_test and run_test_contains functions should not silently redirect
+    // all output to log file - they should show progress on terminal
+    const lines = scriptContent.split('\n');
+
+    // Find run_test function and check it doesn't use silent redirection
+    // Pattern: >> "$LOG_FILE" 2>&1 without tee means silent execution
+    const hasSilentRedirect = lines.some(
+      (line) =>
+        line.includes('eval "$cmd"') && line.includes('>> "$LOG_FILE"') && !line.includes('tee')
+    );
+
+    expect(hasSilentRedirect).toBe(false);
+  });
 });