@spaceteams/weft-layer-provenance 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Spaceteams
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.mts

@@ -0,0 +1,35 @@
+import { KeyId, LayerEvaluator } from "@spaceteams/weft";
+
+//#region src/provenance.d.ts
+/**
+ * Provenance tracks the source and confidence of a value in the computation model.
+ */
+type Provenance = {
+  /** The source of this value — e.g., "user-input", "GPS", "estimate", "derived" */readonly source: string; /** Confidence score 0..1 (1 = fully trusted, 0 = no confidence). Default: 1. */
+  readonly confidence: number; /** Optional tags for additional classification (e.g., "audited", "provisional") */
+  readonly tags?: readonly string[];
+};
+/**
+ * Convenience factory for creating a `Provenance` value.
+ *
+ * @example
+ * ```ts
+ * m.annotate(sensor, "provenance", provenance("GPS", 0.9, ["field-measured"]));
+ * ```
+ */
+declare function provenance(source: string, confidence?: number, tags?: string[]): Provenance;
+/**
+ * Creates derived provenance from a set of dependency provenance values.
+ * The confidence is the minimum across all deps.
+ */
+declare function derived(deps: ReadonlyMap<KeyId, Provenance>): Provenance;
+/**
+ * A source-tracking layer with confidence scores.
+ *
+ * Annotate inputs with `m.annotate(key, "provenance", provenance("user-input", 0.95))`.
+ * Computed values automatically receive `source: "derived"` with the minimum confidence
+ * of their dependencies.
+ */
+declare const provenanceLayer: LayerEvaluator<Provenance>;
+//#endregion
+export { type Provenance, derived, provenance, provenanceLayer };

package/dist/index.mjs

@@ -0,0 +1,67 @@
+//#region src/provenance.ts
+/**
+* Convenience factory for creating a `Provenance` value.
+*
+* @example
+* ```ts
+* m.annotate(sensor, "provenance", provenance("GPS", 0.9, ["field-measured"]));
+* ```
+*/
+function provenance(source, confidence = 1, tags) {
+	return tags?.length ? {
+		source,
+		confidence,
+		tags
+	} : {
+		source,
+		confidence
+	};
+}
+/**
+* Creates derived provenance from a set of dependency provenance values.
+* The confidence is the minimum across all deps.
+*/
+function derived(deps) {
+	if (deps.size === 0) return {
+		source: "unknown",
+		confidence: 0
+	};
+	let min = 1;
+	for (const p of deps.values()) if (p.confidence < min) min = p.confidence;
+	return {
+		source: "derived",
+		confidence: min
+	};
+}
+/**
+* A source-tracking layer with confidence scores.
+*
+* Annotate inputs with `m.annotate(key, "provenance", provenance("user-input", 0.95))`.
+* Computed values automatically receive `source: "derived"` with the minimum confidence
+* of their dependencies.
+*/
+const provenanceLayer = {
+	name: "provenance",
+	version: "1",
+	eval(_op, deps) {
+		return derived(deps);
+	},
+	default(deps) {
+		return derived(deps);
+	},
+	codec: {
+		encode(value) {
+			const obj = {
+				confidence: value.confidence,
+				source: value.source
+			};
+			if (value.tags?.length) obj.tags = [...value.tags];
+			return obj;
+		},
+		decode(value) {
+			return value;
+		}
+	}
+};
+//#endregion
+export { derived, provenance, provenanceLayer };

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@spaceteams/weft-layer-provenance",
+  "version": "0.2.0",
+  "description": "Source tracking and confidence scoring layer for @spaceteams/weft",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/spaceteams/weft.git",
+    "directory": "layers/provenance"
+  },
+  "keywords": [
+    "weft",
+    "layer",
+    "provenance",
+    "confidence",
+    "source-tracking"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@spaceteams/weft": "0.5.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "format": "biome format --write ."
+  }
+}