composable-delivery
diff --git a/‎.github/workflows/ci.yml‎
Lines changed: 8 additions & 4 deletions b/‎.github/workflows/ci.yml‎
Lines changed: 8 additions & 4 deletions
diff --git a/‎.github/workflows/release.yml‎
Lines changed: 25 additions & 18 deletions b/‎.github/workflows/release.yml‎
Lines changed: 25 additions & 18 deletions
diff --git a/‎.gitignore‎
Lines changed: 3 additions & 0 deletions b/‎.gitignore‎
Lines changed: 3 additions & 0 deletions
diff --git a/‎CHANGELOG.md‎
Lines changed: 71 additions & 0 deletions b/‎CHANGELOG.md‎
Lines changed: 71 additions & 0 deletions
diff --git a/‎Cargo.lock‎
Lines changed: 25 additions & 24 deletions b/‎Cargo.lock‎
Lines changed: 25 additions & 24 deletions
@@ -153,24 +153,28 @@ jobs:
           cargo install wasm-bindgen-cli --version "$VERSION" --locked
       - name: Build WASM package
         run: |
+          WASM_VERSION=$(grep '^version' Cargo.toml | head -1 | sed 's/version = "\(.*\)"/\1/')
           cargo build --lib --release --target wasm32-unknown-unknown --features wasm,graph
           mkdir -p pkg
           wasm-bindgen --target web --out-dir pkg \
             target/wasm32-unknown-unknown/release/busbar_sf_agentscript.wasm
           node -e "
             const fs = require('fs');
             fs.writeFileSync('pkg/package.json', JSON.stringify({
-              name: 'busbar-sf-agentscript',
-              version: '0.0.1',
+              name: '@muselab/busbar-sf-agentscript',
+              version: '$WASM_VERSION',
               files: ['busbar_sf_agentscript_bg.wasm','busbar_sf_agentscript.js','busbar_sf_agentscript.d.ts','busbar_sf_agentscript_bg.wasm.d.ts'],
               main: 'busbar_sf_agentscript.js',
               types: 'busbar_sf_agentscript.d.ts',
               sideEffects: false
             }, null, 2));
           "
       - name: Install plugin dependencies
-        working-directory: plugin-agency/
-        run: npm install
+        run: |
+          # Link the locally built WASM into npm's global registry so
+          # plugin-agency can install it by name+version without modifying package.json
+          (cd pkg && npm link)
+          (cd plugin-agency && npm link @muselab/busbar-sf-agentscript && npm install)
       - name: Build SF plugin
         working-directory: plugin-agency/
         run: npm run build
 
@@ -3,11 +3,12 @@ name: Release
 on:
   push:
     tags:
-      - "v[0-9]+.[0-9]+.[0-9]+"
+      - "v[0-9]+.[0-9]+.[0-9]+"        # stable:     v0.1.0
+      - "v[0-9]+.[0-9]+.[0-9]+-*"      # pre-release: v0.1.0-beta.3
   workflow_dispatch:
     inputs:
       tag:
-        description: "Tag to release (e.g. v0.0.1)"
+        description: "Tag to release (e.g. v0.0.1 or v0.0.1-beta.3)"
         required: false
 
 concurrency:
@@ -28,6 +29,8 @@ jobs:
     runs-on: ubuntu-latest
     outputs:
       version: ${{ steps.version.outputs.version }}
+      is_prerelease: ${{ steps.version.outputs.is_prerelease }}
+      npm_tag: ${{ steps.version.outputs.npm_tag }}
     steps:
       - uses: actions/checkout@v4
       - name: Extract version
@@ -39,12 +42,22 @@ jobs:
           fi
           VERSION="${TAG#v}"
           echo "version=$VERSION" >> "$GITHUB_OUTPUT"
-          echo "Releasing version $VERSION"
+          if [[ "$VERSION" == *-* ]]; then
+            echo "is_prerelease=true" >> "$GITHUB_OUTPUT"
+            NPM_TAG="${VERSION#*-}"   # e.g. beta.3
+            NPM_TAG="${NPM_TAG%%.*}"  # e.g. beta
+            echo "npm_tag=$NPM_TAG" >> "$GITHUB_OUTPUT"
+          else
+            echo "is_prerelease=false" >> "$GITHUB_OUTPUT"
+            echo "npm_tag=latest" >> "$GITHUB_OUTPUT"
+          fi
+          echo "Releasing version $VERSION (npm tag: ${NPM_TAG:-latest})"
 
   publish-crates:
     name: Publish crates to crates.io
     runs-on: ubuntu-latest
     needs: [validate]
+    if: needs.validate.outputs.is_prerelease == 'false'
     steps:
       - uses: actions/checkout@v4
         with:
@@ -166,7 +179,7 @@ jobs:
           node -e "
             const fs = require('fs');
             fs.writeFileSync('dist/wasm/package.json', JSON.stringify({
-              name: 'busbar-sf-agentscript',
+              name: '@muselab/busbar-sf-agentscript',
               version: '${{ needs.validate.outputs.version }}',
               files: ['busbar_sf_agentscript_bg.wasm','busbar_sf_agentscript.js','busbar_sf_agentscript.d.ts','busbar_sf_agentscript_bg.wasm.d.ts'],
               main: 'busbar_sf_agentscript.js',
@@ -261,9 +274,7 @@ jobs:
           cache-dependency-path: tree-sitter-agentscript/package-lock.json
       - run: npm ci
       - run: npm run build
-      - run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+      - run: npm publish --access public --tag ${{ needs.validate.outputs.npm_tag }}
 
   publish-wasm-npm:
     name: Publish WASM to npm
@@ -281,9 +292,7 @@ jobs:
           path: dist/wasm/
       - name: Publish to npm
         working-directory: dist/wasm/
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm publish --access public --tag ${{ needs.validate.outputs.npm_tag }}
 
   publish-sf-plugin-npm:
     name: Publish SF plugin to npm
@@ -304,32 +313,30 @@ jobs:
           timeout=120
           interval=5
           elapsed=0
-          until npm view busbar-sf-agentscript@$VERSION version 2>/dev/null; do
+          until npm view @muselab/busbar-sf-agentscript@$VERSION version 2>/dev/null; do
             if [ $elapsed -ge $timeout ]; then
-              echo "Timed out waiting for busbar-sf-agentscript@$VERSION on npm"
+              echo "Timed out waiting for @muselab/busbar-sf-agentscript@$VERSION on npm"
               exit 1
             fi
-            echo "Waiting for busbar-sf-agentscript@$VERSION... (${elapsed}s / ${timeout}s)"
+            echo "Waiting for @muselab/busbar-sf-agentscript@$VERSION... (${elapsed}s / ${timeout}s)"
             sleep $interval
             elapsed=$((elapsed + interval))
           done
-          echo "busbar-sf-agentscript@$VERSION is available"
+          echo "@muselab/busbar-sf-agentscript@$VERSION is available"
       - name: Update WASM dependency to published npm version
         run: |
           node -e "
             const fs = require('fs');
             const pkg = JSON.parse(fs.readFileSync('package.json', 'utf8'));
-            pkg.dependencies['busbar-sf-agentscript'] = '${{ needs.validate.outputs.version }}';
+            pkg.dependencies['@muselab/busbar-sf-agentscript'] = '${{ needs.validate.outputs.version }}';
             fs.writeFileSync('package.json', JSON.stringify(pkg, null, 2) + '\n');
           "
       - name: Install dependencies
         run: npm install
       - name: Build
         run: npm run build
       - name: Publish to npm
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm publish --access public --tag ${{ needs.validate.outputs.npm_tag }}
 
   github-release:
     name: Create GitHub Release
 
@@ -13,6 +13,9 @@ node_modules/
 build/
 *.wasm
 
+# Reports
+agents-report.html
+
 # macOS
 .DS_Store
 
 
@@ -0,0 +1,71 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). This project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [0.0.2] — 2026-03-02
+
+### SF CLI Plugin (`@muselab/sf-plugin-busbar-agency`)
+
+#### Added
+- **`sf agency agents list`** — List all `.agent` files in a directory with their parsed agent names and current selection state.
+- **`sf agency agents select`** — Interactively select (or `--all` / `--none`) which agent files subsequent commands should target. Selection is persisted and used automatically by all commands.
+- **Multi-file support for all commands** — Every command now accepts `--path <dir>` (recursive `.agent` scan) in addition to `--file`. A saved agent selection (from `sf agency agents select`) is used automatically when neither flag is provided.
+- **`file` field in JSON output** — When running against multiple files, every result object now includes a `file` field so consumers can identify which agent file each result came from.
+- **`sf agency deps --group dependency`** — New `--group` flag (`file` | `dependency`). `--group dependency` inverts the view: instead of deps per agent, shows each unique dependency with the list of agent files that use it.
+- **`sf agency query <path>` unified command** — Replaces the three separate `sf agency query topic`, `sf agency query variable`, and `sf agency query action` subcommands with a single path-based interface:
+  - `/topics/<name>` — incoming references and outgoing transitions for a topic
+  - `/variables/<name>` — readers and writers for a variable
+  - `/actions/<name>` — action definition and the reasoning steps that invoke it
+  - `dot.notation.path` — raw AST traversal (unchanged)
+
+#### Changed
+- `sf agency parse` JSON output is now `{ file, ast }` instead of the raw AST object, so the source file is always identifiable.
+- `sf agency impact` flag renamed: `--dir` → `--path` for consistency with other commands.
+- `sf agency query` now uses a positional argument for the query path instead of `--path`, and `--path` is now the directory scan flag (consistent with all other commands).
+
+#### Removed
+- `sf agency query topic <name>` subcommand (use `sf agency query /topics/<name>`)
+- `sf agency query variable <name>` subcommand (use `sf agency query /variables/<name>`)
+- `sf agency query action <name>` subcommand (use `sf agency query /actions/<name>`)
+
+#### Docs
+- Rewrote `plugin-agency/README.md` to focus entirely on the SF CLI plugin with a full command reference.
+- Added `plugin-agency/CONTRIBUTING.md` covering local build setup, linking to `sf` CLI, and conventions for adding new commands.
+
+---
+
+## [0.0.1-beta.3] — 2025-12-01
+
+### SF CLI Plugin
+
+#### Added
+- `sf agency graph` — ASCII, GraphML, Mermaid, and HTML topic flow graph export with optional `--stats`.
+- `sf agency paths` — DFS enumeration of all execution paths through the topic graph, with cycle detection.
+- `sf agency impact` — Scan a directory for agents that depend on a specific Salesforce resource.
+- `sf agency deps --retrieve` — Retrieve dependent metadata from a target org after extracting dependencies.
+- `sf agency query topic`, `sf agency query variable`, `sf agency query action` — Semantic queries for specific AST constructs.
+
+### Core Parser (`busbar-sf-agentscript`)
+
+#### Added
+- WASM build published to npm as `@muselab/busbar-sf-agentscript`.
+- Graph analysis functions: `export_graph_json`, `export_graphml`, `render_graph`, `get_graph_stats`.
+- Semantic query functions: `find_topic_usages`, `find_topic_transitions`, `find_variable_usages`.
+- Dependency extraction: `extract_dependencies`.
+
+---
+
+## [0.0.1] — 2025-11-01
+
+Initial public release.
+
+### Added
+- AgentScript parser (Rust + WASM).
+- `sf agency parse`, `sf agency validate`, `sf agency list`, `sf agency query`, `sf agency actions`, `sf agency deps`.
+- VS Code extension with syntax highlighting and real-time diagnostics.
+- LSP server for Neovim, Helix, and other editors.
+- Tree-sitter grammar (`@muselab/tree-sitter-agentscript`).