@compforge/harness-common 0.3.0 → 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/datasource.d.ts

@@ -3,6 +3,8 @@ import type { ClientProvider } from "./client-provider.js";
 import type { Service } from "./service.js";
 /** A source of data; accessible environments implement ClientProvider directly. */
 export interface DataSource<C extends Client> extends ClientProvider<C> {
+    /** Safe descriptive metadata for discovery; never credentials or part of clientKey. */
+    readonly description?: string;
 }
 /**
  * @spec A Service association does not own a client or change the source identity.

package/dist/execution.d.ts

@@ -0,0 +1,35 @@
+import type { Service } from "./service.js";
+/** Stable capability identity, independent of access configuration. */
+export interface Operation {
+    readonly name: string;
+}
+export interface HttpOperation extends Operation {
+    readonly method: string;
+    readonly path: string;
+}
+/** A real call owns its raw domain evidence. Case identity and scheduling belong to the domain. */
+export interface OperationRun<O> {
+    readonly id: string;
+    readonly service: Service;
+    readonly operation: Operation;
+    readonly outcome: O;
+}
+/** Domain-owned grouping and lifecycle; common does not prescribe a scheduler. */
+export interface Execution<O> {
+    readonly id: string;
+    operation_runs: OperationRun<O>[];
+}
+export interface Artifact {
+    readonly name: string;
+    readonly path: string;
+}
+export interface Experiment {
+    readonly name: string;
+}
+export interface ExperimentRun<E extends Execution<unknown>> {
+    readonly run_id: string;
+    readonly experiment: string;
+    readonly created_at: string;
+    executions: E[];
+    artifacts: Artifact[];
+}

package/dist/execution.js

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

package/dist/index.d.ts

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

package/dist/index.js

@@ -10,3 +10,4 @@ export * from "./component.js";
 export * from "./host.js";
 export * from "./environment.js";
 export * from "./service.js";
+export * from "./execution.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/dist/workload.d.ts

@@ -1,6 +1,8 @@
 /** Logical carrier, not proof of existence. Location is data, not a discovery executor. */
 export interface Workload {
     readonly name: string;
+    /** Safe role/context for discovery; not identity, location or proof of availability. */
+    readonly description?: string;
     readonly platform: "kubernetes";
     /** Omission requires a resolver default; never means all namespaces. */
     readonly namespace?: string;

package/package.json

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