@michaelfromyeg/weft-adapter-kit 1.3.0 → 1.4.1

package/dist/index.d.ts

@@ -131,6 +131,24 @@ interface PluginCtx {
     list(relDir: string): string[];
     aliasFor(componentId: string): string;
 }
+/**
+ * Declares the upstream harness CLI this adapter targets and the version RANGE
+ * its emitted format is verified against (versioning axis 4, spec §5). Where
+ * `targetSchema` is Weft's INTERNAL tag for the format it emits, this is the
+ * EXTERNAL tool the format must satisfy. `weft build` detects the installed
+ * harness version (or uses one the caller declares) and warns when it falls
+ * outside `range` -- the early signal that an upstream release may have moved
+ * the format past what this adapter emits. Optional: omit when the harness has
+ * no version-printing CLI to compare against.
+ */
+interface HarnessCompat {
+    /** Human-facing harness name for messages (e.g. "Codex CLI"). */
+    readonly name: string;
+    /** Shell command that prints the installed version (e.g. "codex --version"). */
+    readonly versionCommand?: string;
+    /** Semver range the emitted format is known-good for (e.g. ">=0.121.0 <0.130.0"). */
+    readonly range: string;
+}
 /**
  * The seam between Weft's canonical model and one harness's native format
  * (spec §7). Every harness-specific fact lives behind `targetSchema`, so an
@@ -145,6 +163,8 @@ interface HarnessAdapter {
     readonly version: string;
     /** The harness manifest schema version this adapter emits against. */
     readonly targetSchema: string;
+    /** The upstream harness CLI + supported version range (versioning axis 4). */
+    readonly harness?: HarnessCompat;
     /**
      * Place artifacts directly under the scope's category dirs without the
      * `plugins/<name>/` grouping. For directory-convention harnesses that load
@@ -207,4 +227,4 @@ interface GenericSkillsConfig {
  */
 declare function genericSkillsAdapter(cfg: GenericSkillsConfig): HarnessAdapter;
 
-export { type ArtifactKind, type CatalogEntry, type CompiledArtifact, type Frontmatter, type GenericSkillsConfig, type HarnessAdapter, type HarnessDriver, type ImportOptions, type ImportResult, type ImportedMarketplace, type ImportedPlugin, type InstallPaths, type PluginCtx, type ResolvedMarketplace, type RunOptions, type ToolCall, type Transcript, artifact, expandTilde, genericSkillsAdapter, parseFrontmatter, resolveUnder, withFrontmatter };
+export { type ArtifactKind, type CatalogEntry, type CompiledArtifact, type Frontmatter, type GenericSkillsConfig, type HarnessAdapter, type HarnessCompat, type HarnessDriver, type ImportOptions, type ImportResult, type ImportedMarketplace, type ImportedPlugin, type InstallPaths, type PluginCtx, type ResolvedMarketplace, type RunOptions, type ToolCall, type Transcript, artifact, expandTilde, genericSkillsAdapter, parseFrontmatter, resolveUnder, withFrontmatter };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michaelfromyeg/weft-adapter-kit",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "description": "Public HarnessAdapter / HarnessDriver interfaces and helpers. The contract a community adapter implements.",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,7 +17,7 @@
   ],
   "dependencies": {
     "yaml": "^2.6.1",
-    "@michaelfromyeg/weft-schema": "1.3.0"
+    "@michaelfromyeg/weft-schema": "1.4.1"
   },
   "license": "MIT",
   "author": "Michael DeMarco",