refactor: extract OPENCODE_VERSION to shared paths.mjs module

Signed-off-by: leocavalcante <leo@cavalcante.dev>

Author: leocavalcante

postinstall.mjs

@@ -17,18 +17,13 @@ import {
 	getAgentsSourceDir,
 	getErrorMessage,
 	getPackageRoot,
+	OPENCODE_VERSION,
 	parseCliFlags,
 	parseFrontmatter,
 	retryOnTransientError,
 	validateAgentContent,
 } from "./src/paths.mjs"
 
-/**
- * Mock OpenCode version for compatibility checking.
- * In production, this would be obtained from the OpenCode CLI or environment.
- */
-const OPENCODE_VERSION = "0.1.0"
-
 const packageRoot = getPackageRoot(import.meta.url)
 const AGENTS_SOURCE_DIR = getAgentsSourceDir(packageRoot)
 

src/paths.d.mts

@@ -10,6 +10,24 @@ export {
 	parseVersion,
 } from "./semver.mjs"
 
+/**
+ * Mock OpenCode version for compatibility checking.
+ *
+ * This version string is used to check agent compatibility requirements
+ * during installation. In production, this would ideally be obtained
+ * from the OpenCode CLI or environment, but for now it serves as a
+ * fallback/default version.
+ *
+ * Format: Semantic versioning (MAJOR.MINOR.PATCH)
+ *
+ * @example
+ * import { OPENCODE_VERSION, checkVersionCompatibility } from "./paths.mjs"
+ *
+ * // Check if an agent requiring ">=0.1.0" is compatible
+ * const isCompatible = checkVersionCompatibility(">=0.1.0", OPENCODE_VERSION)
+ */
+export declare const OPENCODE_VERSION: string
+
 /**
  * List of expected agent names (without .md extension).
  * This is the single source of truth for agent filenames.

src/paths.mjs

@@ -16,6 +16,24 @@ export {
 	parseVersion,
 } from "./semver.mjs"
 
+/**
+ * Mock OpenCode version for compatibility checking.
+ *
+ * This version string is used to check agent compatibility requirements
+ * during installation. In production, this would ideally be obtained
+ * from the OpenCode CLI or environment, but for now it serves as a
+ * fallback/default version.
+ *
+ * Format: Semantic versioning (MAJOR.MINOR.PATCH)
+ *
+ * @example
+ * import { OPENCODE_VERSION, checkVersionCompatibility } from "./paths.mjs"
+ *
+ * // Check if an agent requiring ">=0.1.0" is compatible
+ * const isCompatible = checkVersionCompatibility(">=0.1.0", OPENCODE_VERSION)
+ */
+export const OPENCODE_VERSION = "0.1.0"
+
 /**
  * List of expected agent names (without .md extension).
  * This is the single source of truth for agent filenames.

tests/paths.test.ts

@@ -11,6 +11,7 @@ import {
 	getPackageRoot,
 	isTransientError,
 	MIN_CONTENT_LENGTH,
+	OPENCODE_VERSION,
 	parseCliFlags,
 	parseFrontmatter,
 	REQUIRED_FRONTMATTER_FIELDS,
@@ -417,6 +418,36 @@ describe("paths.mjs exports", () => {
 			expect(AGENT_NAMES.length).toBe(originalLength)
 		})
 
+		describe("OPENCODE_VERSION", () => {
+			it("should be a string in semantic version format (MAJOR.MINOR.PATCH)", () => {
+				expect(typeof OPENCODE_VERSION).toBe("string")
+				// Semantic version format: X.Y.Z where X, Y, Z are non-negative integers
+				const semverRegex = /^\d+\.\d+\.\d+$/
+				expect(OPENCODE_VERSION).toMatch(semverRegex)
+			})
+
+			it("should have the expected default value", () => {
+				expect(OPENCODE_VERSION).toBe("0.1.0")
+			})
+
+			it("should be usable with checkVersionCompatibility", () => {
+				// Verify it works with the version compatibility checker
+				expect(checkVersionCompatibility(">=0.1.0", OPENCODE_VERSION)).toBe(true)
+				expect(checkVersionCompatibility("0.1.0", OPENCODE_VERSION)).toBe(true)
+				expect(checkVersionCompatibility(">=0.2.0", OPENCODE_VERSION)).toBe(false)
+			})
+
+			it("should consist of three numeric parts separated by dots", () => {
+				const parts = OPENCODE_VERSION.split(".")
+				expect(parts).toHaveLength(3)
+				for (const part of parts) {
+					const num = Number.parseInt(part, 10)
+					expect(Number.isNaN(num)).toBe(false)
+					expect(num).toBeGreaterThanOrEqual(0)
+				}
+			})
+		})
+
 		it("should export MIN_CONTENT_LENGTH as a number", () => {
 			expect(typeof MIN_CONTENT_LENGTH).toBe("number")
 			expect(MIN_CONTENT_LENGTH).toBe(100)