agent-skillboard 0.1.1 → 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+## 0.1.2 — 2026-06-29
+
+### Added
+
+- CLI `--version` and `-v` flags for quick version verification across npm, global, source-tree, and tarball installs.
+- Test coverage for the new version flags.
+
+### Changed
+
+- README 5-Minute Quick Start now verifies the installed version as a first step.
+
+## 0.1.1 — 2026-06-26
+
+### Added
+
+- npm publication for `agent-skillboard`.
+- Consolidation of duplicate installed skill IDs into canonical entries.
+- Hermes system prompt bridge guide in README and install docs.

package/README.md

@@ -121,6 +121,7 @@ Run SkillBoard in the project you want to manage:
 
 ```bash
 npx agent-skillboard init
+npx agent-skillboard --version
 npx agent-skillboard brief
 npx agent-skillboard doctor --summary
 ```

package/docs/versioning.md

@@ -8,7 +8,7 @@ source profiles, and the generated lockfile.
 
 ## Status
 
-Current package version: `0.1.1`
+Current package version: `0.1.2`
 
 Current config schema version:
 
@@ -194,8 +194,8 @@ Before tagging a public release:
     publish.yml --allow-publish` cannot configure it from the CLI, use the npm
     package settings page and add a GitHub Actions trusted publisher with the
     same repository, workflow filename, and allowed action.
-- Push a version tag that exactly matches `package.json`, for example `v0.1.1`
-  for package version `0.1.1`.
+- Push a version tag that exactly matches `package.json`, for example `v0.1.2`
+  for package version `0.1.2`.
 - Let `.github/workflows/publish.yml` publish from the tag. The workflow runs
   the full check suite, validates that the tag matches the package version, and
   skips `npm publish` only when that exact version already exists on npm.
@@ -220,3 +220,11 @@ completion notes:
   without generating user-visible `-2` suffixes;
 - README and install docs include a Hermes system prompt bridge for profiles
   that do not automatically read `AGENTS.md` or `CLAUDE.md`.
+
+## 0.1.2 Completion Notes
+
+- add `--version` and `-v` flags to the CLI for fast version verification in
+  npm, global, source-tree, and tarball installs;
+- add a dedicated test for the version flags;
+- update README quick-start to verify the installed version before running
+  policy commands.

package/package.json

@@ -1,6 +1,6 @@
-{
+{
   "name": "agent-skillboard",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Policy and visibility layer for AI agent skills.",
   "keywords": [
     "ai-agent",
@@ -26,6 +26,7 @@
     "profiles",
     "README.md",
     "CONTRIBUTING.md",
+    "CHANGELOG.md",
     "LICENSE",
     "tsconfig.lsp.json"
   ],
@@ -33,9 +34,9 @@
     "skillboard": "bin/skillboard.mjs",
     "agent-skillboard": "bin/skillboard.mjs"
   },
-  "publishConfig": {
-    "access": "public"
-  },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "test": "node --test",
     "test:unit": "node --test test/advisor-brief-actions.test.mjs test/advisor-brief.test.mjs test/ecosystem-docs.test.mjs test/install-units.test.mjs test/package.test.mjs test/policy.test.mjs test/skillboard.test.mjs",
@@ -43,16 +44,16 @@
     "diagnostics": "tsc -p tsconfig.lsp.json",
     "check": "node --check bin/skillboard.mjs && npm run diagnostics && node --test"
   },
-  "dependencies": {
-    "yaml": "^2.8.1"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "license": "MIT",
-  "devDependencies": {
-    "@types/node": "^26.0.0",
-    "typescript": "^6.0.3",
-    "typescript-language-server": "^5.3.0"
-  }
-}
+  "dependencies": {
+    "yaml": "^2.8.1"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^26.0.0",
+    "typescript": "^6.0.3",
+    "typescript-language-server": "^5.3.0"
+  }
+}

package/src/cli.mjs

@@ -1,4 +1,5 @@
 import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { readFileSync } from "node:fs";
 import { dirname, isAbsolute } from "node:path";
 import YAML from "yaml";
 import {
@@ -49,6 +50,8 @@ import { planGuardHookInstall } from "./control.mjs";
 import { writeCheckedConfig } from "./control/config-write.mjs";
 import { runInitCommand, runUninstallCommand } from "./lifecycle-cli.mjs";
 
+const VERSION = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
+
 const APPLY_ACTION_VALUE_OPTIONS = new Set(["workflow", "dir", "config", "skills", "out", "skillboard-bin"]);
 
 export async function main(argv, stdout, stderr) {
@@ -124,15 +127,19 @@ async function run(argv, stdout, stderr) {
       return await reconcile(options, stdout);
     case "impact":
       return await impact(argv.slice(1), options, stdout);
-    case "help":
-    case "--help":
-    case "-h":
-      stdout.write(helpText());
-      return 0;
-    default:
-      stderr.write(`Unknown command: ${command}\n`);
-      stdout.write(helpText());
-      return 1;
+    case "help":
+    case "--help":
+    case "-h":
+      stdout.write(helpText());
+      return 0;
+    case "--version":
+    case "-v":
+      stdout.write(`${VERSION}\n`);
+      return 0;
+    default:
+      stderr.write(`Unknown command: ${command}\n`);
+      stdout.write(helpText());
+      return 1;
   }
 }
 
@@ -1124,6 +1131,7 @@ function renderCounts(counts) {
 function helpText() {
   return [
     "SkillBoard - workflow-scoped agent skill policy",
+    "Version: see skillboard --version",
     "",
     "Commands:",
     "  init [--dir <path>] [--scan-root <dir>[,<dir>]] [--no-scan-installed]",