@okfit/plugin 0.3.7 → 0.4.0

package/README.md

@@ -6,6 +6,10 @@ The one package to install for [okfit](https://github.com/spencerbeggs/okfit) in
 pnpm add -D @okfit/plugin
 ```
 
+## Versions
+
+`okfit --version` prints four numbers: `okfit 0.5.4 via @okfit/plugin 0.3.7 (engine 0.6.0, okf 0.2, config-schema 1.0)`. The engine, OKF, and config-schema versions are the ones that determine what a report says and what a config may contain; the CLI, MCP server, and this package version independently and are packaging. Every `--format json` report carries `engine_version`, `okf_version`, and `distribution`; `okfit context --format json` adds `config_schema_version`.
+
 ## Status
 
 Both bins install. `okfit` has five subcommands (`validate`, `init`, `context`, `verify`, `sync`); `okfit-mcp` serves six read-only MCP tools plus static concept resources over stdio.

package/bin/okfit-mcp.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { PLUGIN_VERSION } from "../version.js";
 import { main } from "@okfit/mcp/main";
 
 //#region src/bin/okfit-mcp.ts
@@ -7,7 +8,10 @@ import { main } from "@okfit/mcp/main";
 *
 * @packageDocumentation
 */
-await main();
+await main({ distribution: {
+	name: "@okfit/plugin",
+	version: PLUGIN_VERSION
+} });
 
 //#endregion
 export {  };

package/bin/okfit.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { PLUGIN_VERSION } from "../version.js";
 import { main } from "@okfit/cli/main";
 
 //#region src/bin/okfit.ts
@@ -7,7 +8,10 @@ import { main } from "@okfit/cli/main";
 *
 * @packageDocumentation
 */
-main();
+main({ distribution: {
+	name: "@okfit/plugin",
+	version: PLUGIN_VERSION
+} });
 
 //#endregion
 export {  };

package/index.d.ts

@@ -1,9 +1,18 @@
-//#region src/index.d.ts
+//#region src/version.d.ts
 /**
- * okfit meta-package. Installing it provides the `okfit` and `okfit-mcp` bins.
+ * This package's own version, reported as `distribution.version` (alongside
+ * `distribution.name: "@okfit/plugin"`) whenever a report is produced
+ * through one of this package's bin shims (okfit #137).
+ * `@savvy-web/bundler` replaces `process.env.__PACKAGE_VERSION__` with this
+ * package's own version at build time (K-32), so a release can never desync
+ * from the printed version. `"0.0.0"` is the unbuilt-source fallback and
+ * reads as dev mode.
  *
- * @packageDocumentation
+ * @public
  */
+export declare const PLUGIN_VERSION: string;
+//#endregion
+//#region src/index.d.ts
 /**
  * Bins made available by installing this package.
  *

package/index.js

@@ -1,10 +1,7 @@
+import { PLUGIN_VERSION } from "./version.js";
+
 //#region src/index.ts
 /**
-* okfit meta-package. Installing it provides the `okfit` and `okfit-mcp` bins.
-*
-* @packageDocumentation
-*/
-/**
 * Bins made available by installing this package.
 *
 * @public
@@ -12,4 +9,4 @@
 const OKFIT_BINS = ["okfit", "okfit-mcp"];
 
 //#endregion
-export { OKFIT_BINS };
+export { OKFIT_BINS, PLUGIN_VERSION };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@okfit/plugin",
-	"version": "0.3.7",
+	"version": "0.4.0",
 	"private": false,
 	"description": "Install this one package to get the okfit CLI and MCP server in your repository. Depends on @okfit/cli and @okfit/mcp.",
 	"keywords": [
@@ -40,8 +40,8 @@
 		"okfit-mcp": "bin/okfit-mcp.js"
 	},
 	"dependencies": {
-		"@okfit/cli": "0.5.4",
-		"@okfit/mcp": "0.3.7"
+		"@okfit/cli": "0.6.0",
+		"@okfit/mcp": "0.4.0"
 	},
 	"engines": {
 		"node": ">=24.11.0"

package/version.js

@@ -0,0 +1,16 @@
+//#region src/version.ts
+/**
+* This package's own version, reported as `distribution.version` (alongside
+* `distribution.name: "@okfit/plugin"`) whenever a report is produced
+* through one of this package's bin shims (okfit #137).
+* `@savvy-web/bundler` replaces `process.env.__PACKAGE_VERSION__` with this
+* package's own version at build time (K-32), so a release can never desync
+* from the printed version. `"0.0.0"` is the unbuilt-source fallback and
+* reads as dev mode.
+*
+* @public
+*/
+const PLUGIN_VERSION = "0.4.0";
+
+//#endregion
+export { PLUGIN_VERSION };