@compforge/harness-common 0.3.2 → 0.3.5

package/README.md

@@ -28,7 +28,9 @@ Dependency graphs must be acyclic. A failed initialization permits retry only af
 failed cleanup poisons that key and is reported again when the root manager is disposed.
 
 Service identifies a Component's runtime presence in an Environment. A Component belongs to a Repository
-on a Forge; a Service explicitly declares zero or more Workloads. Consumers extend Service with business
+on a Forge. Product is a separate business identity; consumers own its many-to-many associations
+with Components. Repository discovery and directory ownership remain consumer responsibilities.
+A Service explicitly declares zero or more Workloads. Consumers extend Service with business
 capabilities, without duplicating these identities. For example:
 
 ```typescript

package/dist/component.d.ts

@@ -3,4 +3,12 @@ import type { Repository } from "./repository.js";
 export interface Component {
     readonly repository: Repository;
     readonly name: string;
+    /** Human-readable discovery metadata; not part of Component identity. */
+    readonly description?: string;
+    /** Optional implementation language, supplied by consumers; not part of identity. */
+    readonly language?: string;
 }
+/** Derive the tool ecosystem from language; unknown mappings return undefined.
+ * Package manager discovery and execution remain consumer responsibilities.
+ */
+export declare function componentEcosystem(component: Component): string | undefined;

package/dist/component.js

@@ -1 +1,15 @@
-export {};
+/** Derive the tool ecosystem from language; unknown mappings return undefined.
+ * Package manager discovery and execution remain consumer responsibilities.
+ */
+export function componentEcosystem(component) {
+    switch (component.language) {
+        case "python":
+        case "go":
+            return component.language;
+        case "javascript":
+        case "typescript":
+            return "node";
+        default:
+            return undefined;
+    }
+}

package/dist/index.d.ts

@@ -11,3 +11,4 @@ export * from "./host.js";
 export * from "./environment.js";
 export * from "./service.js";
 export * from "./execution.js";
+export type { Product } from "./product.js";

package/dist/product.d.ts

@@ -0,0 +1,6 @@
+/** A business identity independent of repository layout.
+ * Consumers own its many-to-many associations with Components.
+ */
+export interface Product {
+    readonly name: string;
+}

package/dist/product.js

@@ -0,0 +1 @@
+export {};

package/dist/service.d.ts

@@ -9,6 +9,8 @@ import type { Workload } from "./workload.js";
  */
 export interface Service<E extends Environment = Environment> {
     readonly name: string;
+    /** Human-readable discovery metadata; not part of Service identity. */
+    readonly description?: string;
     readonly component: Component;
     readonly environment: E;
     /** Zero or more runtime carriers; an empty array declares no workloads. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compforge/harness-common",
-  "version": "0.3.2",
+  "version": "0.3.5",
   "description": "Execution-neutral client lifecycle and datasource contracts for harnesses",
   "type": "module",
   "scripts": {