@manifesto-ai/core 2.7.1 → 2.9.0

package/dist/utils/canonical.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Canonical form utilities for deterministic hashing
+ *
+ * Algorithm:
+ * 1. Sort all object keys alphabetically (recursive)
+ * 2. Remove all keys with undefined value
+ * 3. Preserve keys with null value
+ * 4. Serialize using JSON with no whitespace
+ */
+/**
+ * Recursively sort object keys alphabetically
+ */
+export declare function sortKeys(obj: unknown): unknown;
+/**
+ * Convert object to canonical JSON string
+ * - Keys are sorted alphabetically
+ * - Undefined values are removed
+ * - No whitespace
+ */
+export declare function toCanonical(obj: unknown): string;
+/**
+ * Canonicalize JSON per RFC 8785 (JCS)
+ * - Objects: keys sorted by Unicode code points
+ * - Arrays: preserve order
+ * - Undefined/function/symbol: omitted in objects, null in arrays
+ * - Non-finite numbers: null
+ */
+export declare function toJcs(value: unknown): string;
+export declare function compareUnicodeCodePoints(a: string, b: string): number;
+/**
+ * Parse canonical JSON string
+ */
+export declare function fromCanonical<T>(canonical: string): T;
+/**
+ * Check if two objects are equal in canonical form
+ */
+export declare function canonicalEqual(a: unknown, b: unknown): boolean;

package/dist/utils/hash.d.ts

@@ -0,0 +1,54 @@
+export type SchemaHashMode = "semantic" | "effective";
+export type SchemaHashInput = {
+    id: string;
+    version: string;
+    types: Record<string, unknown>;
+    state: {
+        fields: Record<string, unknown>;
+    };
+    computed: {
+        fields: Record<string, {
+            deps: string[];
+            expr: unknown;
+            description?: string;
+        }>;
+    };
+    actions: Record<string, unknown>;
+    meta?: {
+        name?: string;
+        description?: string;
+        authors?: string[];
+    };
+};
+/**
+ * SHA-256 hash using Web Crypto API
+ * Works in both browser and Node.js
+ */
+export declare function sha256(message: string): Promise<string>;
+/**
+ * SHA-256 hash using a synchronous pure JS implementation
+ */
+export declare function sha256Sync(message: string): string;
+/**
+ * Hash a schema in canonical form
+ */
+export declare function hashSchema(schema: SchemaHashInput, mode?: SchemaHashMode): Promise<string>;
+/**
+ * Hash a schema in canonical form (sync)
+ */
+export declare function hashSchemaSync(schema: SchemaHashInput, mode?: SchemaHashMode): string;
+export declare function hashSchemaEffective(schema: SchemaHashInput): Promise<string>;
+export declare function hashSchemaEffectiveSync(schema: SchemaHashInput): string;
+/**
+ * Generate deterministic requirement ID
+ * Based on: schemaHash, intentId, actionId, flowNodePath
+ */
+export declare function generateRequirementId(schemaHash: string, intentId: string, actionId: string, flowNodePath: string): Promise<string>;
+/**
+ * Generate deterministic requirement ID (sync)
+ */
+export declare function generateRequirementIdSync(schemaHash: string, intentId: string, actionId: string, flowNodePath: string): string;
+/**
+ * Generate a trace node ID
+ */
+export declare function generateTraceId(index?: number): string;

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./path.js";
+export * from "./canonical.js";
+export * from "./hash.js";
+export * from "./patch-path.js";

package/dist/utils/patch-path.d.ts

@@ -0,0 +1,15 @@
+import type { PatchPath } from "../schema/patch.js";
+/**
+ * Render PatchPath for logs and error messages only.
+ */
+export declare function patchPathToDisplayString(path: PatchPath): string;
+/**
+ * Convert a legacy semantic string path into PatchPath segments.
+ * This helper exists for internal bridging only.
+ */
+export declare function semanticPathToPatchPath(path: string): PatchPath;
+export declare function isSafePatchPath(path: PatchPath): boolean;
+export declare function getByPatchPath(obj: unknown, path: PatchPath): unknown;
+export declare function setByPatchPath(obj: unknown, path: PatchPath, value: unknown): unknown;
+export declare function unsetByPatchPath(obj: unknown, path: PatchPath): unknown;
+export declare function mergeAtPatchPath(obj: unknown, path: PatchPath, value: Record<string, unknown>): unknown;

package/dist/utils/path.d.ts

@@ -0,0 +1,41 @@
+import type { SemanticPath } from "../schema/common.js";
+/**
+ * Parse a dot-separated path into segments.
+ *
+ * Supports escaping literal dots inside segments via backslash (for example `a\\.b` -> `a.b`).
+ */
+export declare function parsePath(path: SemanticPath): string[];
+/**
+ * Join path segments into a semantic path
+ */
+export declare function joinPath(...segments: string[]): SemanticPath;
+/**
+ * Get value at path from object
+ * Returns undefined for non-existent paths (never throws)
+ */
+export declare function getByPath(obj: unknown, path: SemanticPath): unknown;
+/**
+ * Immutably set value at path
+ * Creates intermediate objects as needed
+ */
+export declare function setByPath(obj: unknown, path: SemanticPath, value: unknown): unknown;
+/**
+ * Immutably remove value at path
+ */
+export declare function unsetByPath(obj: unknown, path: SemanticPath): unknown;
+/**
+ * Immutably shallow merge at path
+ */
+export declare function mergeAtPath(obj: unknown, path: SemanticPath, value: Record<string, unknown>): unknown;
+/**
+ * Check if a path exists in an object
+ */
+export declare function hasPath(obj: unknown, path: SemanticPath): boolean;
+/**
+ * Get parent path
+ */
+export declare function parentPath(path: SemanticPath): SemanticPath;
+/**
+ * Get last segment of path
+ */
+export declare function lastSegment(path: SemanticPath): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manifesto-ai/core",
-  "version": "2.7.1",
+  "version": "2.9.0",
   "description": "Manifesto Core - Pure semantic calculator for deterministic state computation",
   "author": "eggplantiny <eggplantiny@gmail.com>",
   "license": "MIT",
@@ -36,11 +36,11 @@
   ],
   "devDependencies": {
     "typescript": "^5.9.3",
-    "vite": "^7.3.1",
-    "vitest": "^4.1.0"
+    "vite": "^8.0.3",
+    "vitest": "^4.1.2"
   },
   "scripts": {
-    "build": "tsup",
+    "build": "rm -rf dist && tsup && tsc -p tsconfig.build.json --emitDeclarationOnly --declarationMap false --outDir dist",
     "dev": "tsc --watch",
     "clean": "rm -rf dist",
     "lint": "echo 'lint not configured'",