@opus-magnum/rubedo 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,13 @@
+# @opus-magnum/rubedo
+
+**RUBEDO v1** — детерминированный движок структурного фингерпринтинга (canonical JSON + SHA-256), выделенный из sealed-ядра Opus Magnum.
+
+## Гарантии v1
+- Независимость от порядка ключей в объектах (canonicalizeJson → stableStringify)
+- Независимость от порядка элементов synopsis (сортировка по `id`)
+- Детерминированный `fingerprint` (SHA-256) и `artifact_id` (`RUBEDO::v1::<prefix>`)
+- Контракт-инварианты через `contract-test`
+
+## Установка
+```bash
+npm i @opus-magnum/rubedo

package/dist/index.d.ts

@@ -1,3 +1 @@
-export { RubedoForge } from "./v1/RubedoForge";
-export { stableStringify, canonicalizeJson, type Json } from "./v1/canonical-json";
-export { RUBEDO_CONTRACT_V1 } from "./v1/contract";
+export * from "./v1/index.js";

package/dist/index.js

@@ -1,3 +1 @@
-export { RubedoForge } from "./v1/RubedoForge";
-export { stableStringify, canonicalizeJson } from "./v1/canonical-json";
-export { RUBEDO_CONTRACT_V1 } from "./v1/contract";
+export * from "./v1/index.js";

package/dist/v1/RubedoForge.d.ts

@@ -1,4 +1,4 @@
-import type { IRubedoForge, RubedoArtifact, RubedoInput } from "../../../interfaces/RUBEDO/v1/IRubedoForge";
+import type { IRubedoForge, RubedoArtifact, RubedoForgeInput } from "./types.js";
 export declare class RubedoForge implements IRubedoForge {
-    forge(input: RubedoInput): RubedoArtifact;
+    forge(input: RubedoForgeInput): RubedoArtifact;
 }

package/dist/v1/RubedoForge.js

@@ -1,5 +1,5 @@
 import crypto from "node:crypto";
-import { stableStringify } from "./canonical-json";
+import { stableStringify } from "./canonical-json.js";
 function sha256Hex(s) {
     return crypto.createHash("sha256").update(s, "utf-8").digest("hex");
 }

package/dist/v1/contract-test.js

@@ -2,23 +2,23 @@ import { RUBEDO_CONTRACT_V1 } from "./contract.js";
 import { RubedoForge } from "./RubedoForge.js";
 function assertEq(a, b, msg) {
     if (a !== b)
-        throw new Error(msg + `: ${String(a)} !== ${String(b)}`);
+        throw new Error(`${msg}: ${String(a)} !== ${String(b)}`);
 }
 console.log(`[RUBEDO_CONTRACT] version=${RUBEDO_CONTRACT_V1.version}`);
-const f = new RubedoForge();
-const fpOf = (synopsis) => f.forge({ synopsis }).fingerprint;
-// Key order independence (value object different key order must be same fingerprint)
+const forge = new RubedoForge();
+const fpOf = (synopsis) => forge.forge({ synopsis }).fingerprint;
+// key order independence (value object must be stable-stringified)
 const s1 = [{ id: "key:a", kind: "KEY", value: { a: 1, b: 2, c: { y: 9, z: 0 } } }];
 const s2 = [{ id: "key:a", kind: "KEY", value: { b: 2, a: 1, c: { z: 0, y: 9 } } }];
 assertEq(fpOf(s1), fpOf(s2), "KEY_ORDER_INDEPENDENCE");
-// Synopsis order independence
+// synopsis order independence (forge must sort synopsis)
 const t1 = [
     { id: "k:1", kind: "KEY", value: 1 },
-    { id: "k:2", kind: "KEY", value: 2 }
+    { id: "k:2", kind: "KEY", value: 2 },
 ];
 const t2 = [
     { id: "k:2", kind: "KEY", value: 2 },
-    { id: "k:1", kind: "KEY", value: 1 }
+    { id: "k:1", kind: "KEY", value: 1 },
 ];
 assertEq(fpOf(t1), fpOf(t2), "SYNOPSIS_ORDER_INDEPENDENCE");
 console.log("[PASS] RUBEDO package contract invariants satisfied");

package/dist/v1/index.d.ts

@@ -0,0 +1,3 @@
+export { RubedoForge } from "./RubedoForge.js";
+export { RUBEDO_CONTRACT_V1 } from "./contract.js";
+export * from "./types.js";

package/dist/v1/index.js

@@ -0,0 +1,3 @@
+export { RubedoForge } from "./RubedoForge.js";
+export { RUBEDO_CONTRACT_V1 } from "./contract.js";
+export * from "./types.js";

package/dist/v1/types.d.ts

@@ -0,0 +1,27 @@
+/**
+ * RUBEDO v1 — package public contract types (self-contained)
+ */
+export type RubedoValue = null | boolean | number | string | RubedoValue[] | {
+    [key: string]: RubedoValue;
+};
+export type RubedoSynopsisItem = {
+    id: string;
+    kind: string;
+    value: RubedoValue;
+};
+export type RubedoForgeInput = {
+    synopsis: RubedoSynopsisItem[];
+};
+export interface RubedoArtifact {
+    artifact_id: string;
+    fingerprint: string;
+    payload: {
+        synopsis: RubedoSynopsisItem[];
+    };
+    stats: {
+        count: number;
+    };
+}
+export interface IRubedoForge {
+    forge(input: RubedoForgeInput): RubedoArtifact;
+}

package/dist/v1/types.js

@@ -0,0 +1,4 @@
+/**
+ * RUBEDO v1 — package public contract types (self-contained)
+ */
+export {};

package/package.json

@@ -1,21 +1,43 @@
 {
   "name": "@opus-magnum/rubedo",
-  "version": "1.0.0",
+  "version": "1.0.2",
+  "description": "RUBEDO v1 — deterministic structural fingerprint engine (sealed core of Opus Magnum)",
+  "keywords": [
+    "rubedo",
+    "fingerprint",
+    "hash",
+    "deterministic",
+    "canonical-json",
+    "sha256"
+  ],
+  "license": "MIT",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./v1": {
+      "types": "./dist/v1/index.d.ts",
+      "default": "./dist/v1/index.js"
     }
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "npx tsc -p tsconfig.build.json",
     "test:contract": "npm run -s build >/dev/null && node dist/v1/contract-test.js"
   },
   "devDependencies": {
-    "typescript": "^5.9.3",
-    "@types/node": "^22.19.3"
+    "@types/node": "^22.19.3",
+    "typescript": "^5.9.3"
   }
 }

package/src/index.ts

@@ -1,3 +1 @@
-export { RubedoForge } from "./v1/RubedoForge";
-export { stableStringify, canonicalizeJson, type Json } from "./v1/canonical-json";
-export { RUBEDO_CONTRACT_V1 } from "./v1/contract";
+export * from "./v1/index.js";

package/src/v1/RubedoForge.ts

@@ -1,6 +1,6 @@
 import crypto from "node:crypto";
-import type { IRubedoForge, RubedoArtifact, RubedoInput } from "../../../interfaces/RUBEDO/v1/IRubedoForge";
-import { stableStringify } from "./canonical-json";
+import type { IRubedoForge, RubedoArtifact, RubedoForgeInput, RubedoSynopsisItem } from "./types.js";
+import { stableStringify } from "./canonical-json.js";
 
 function sha256Hex(s: string): string {
   return crypto.createHash("sha256").update(s, "utf-8").digest("hex");
@@ -8,7 +8,7 @@ function sha256Hex(s: string): string {
 
 export class RubedoForge implements IRubedoForge {
   
-forge(input: RubedoInput): RubedoArtifact {
+forge(input: RubedoForgeInput): RubedoArtifact {
     const synopsis = [...input.synopsis].slice().sort((a, b) => (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
     const payload = { synopsis };
 

package/src/v1/contract-test.ts

@@ -1,28 +1,29 @@
 import { RUBEDO_CONTRACT_V1 } from "./contract.js";
 import { RubedoForge } from "./RubedoForge.js";
+import type { RubedoSynopsisItem } from "./types.js";
 
-function assertEq(a: any, b: any, msg: string) {
-  if (a !== b) throw new Error(msg + `: ${String(a)} !== ${String(b)}`);
+function assertEq(a: string, b: string, msg: string) {
+  if (a !== b) throw new Error(`${msg}: ${String(a)} !== ${String(b)}`);
 }
 
 console.log(`[RUBEDO_CONTRACT] version=${RUBEDO_CONTRACT_V1.version}`);
 
-const f = new RubedoForge();
-const fpOf = (synopsis: any[]) => f.forge({ synopsis }).fingerprint;
+const forge = new RubedoForge();
+const fpOf = (synopsis: RubedoSynopsisItem[]) => forge.forge({ synopsis }).fingerprint;
 
-// Key order independence (value object different key order must be same fingerprint)
-const s1 = [{ id: "key:a", kind: "KEY", value: { a: 1, b: 2, c: { y: 9, z: 0 } } }];
-const s2 = [{ id: "key:a", kind: "KEY", value: { b: 2, a: 1, c: { z: 0, y: 9 } } }];
+// key order independence (value object must be stable-stringified)
+const s1: RubedoSynopsisItem[] = [{ id: "key:a", kind: "KEY", value: { a: 1, b: 2, c: { y: 9, z: 0 } } }];
+const s2: RubedoSynopsisItem[] = [{ id: "key:a", kind: "KEY", value: { b: 2, a: 1, c: { z: 0, y: 9 } } }];
 assertEq(fpOf(s1), fpOf(s2), "KEY_ORDER_INDEPENDENCE");
 
-// Synopsis order independence
-const t1 = [
+// synopsis order independence (forge must sort synopsis)
+const t1: RubedoSynopsisItem[] = [
   { id: "k:1", kind: "KEY", value: 1 },
-  { id: "k:2", kind: "KEY", value: 2 }
+  { id: "k:2", kind: "KEY", value: 2 },
 ];
-const t2 = [
+const t2: RubedoSynopsisItem[] = [
   { id: "k:2", kind: "KEY", value: 2 },
-  { id: "k:1", kind: "KEY", value: 1 }
+  { id: "k:1", kind: "KEY", value: 1 },
 ];
 assertEq(fpOf(t1), fpOf(t2), "SYNOPSIS_ORDER_INDEPENDENCE");
 

package/src/v1/index.ts

@@ -0,0 +1,3 @@
+export { RubedoForge } from "./RubedoForge.js";
+export { RUBEDO_CONTRACT_V1 } from "./contract.js";
+export * from "./types.js";

package/src/v1/types.ts

@@ -0,0 +1,36 @@
+/**
+ * RUBEDO v1 — package public contract types (self-contained)
+ */
+
+export type RubedoValue =
+  | null
+  | boolean
+  | number
+  | string
+  | RubedoValue[]
+  | { [key: string]: RubedoValue };
+
+export type RubedoSynopsisItem = {
+  id: string;
+  kind: string;
+  value: RubedoValue;
+};
+
+export type RubedoForgeInput = {
+  synopsis: RubedoSynopsisItem[];
+};
+
+export interface RubedoArtifact {
+  artifact_id: string;
+  fingerprint: string;
+  payload: {
+    synopsis: RubedoSynopsisItem[];
+  };
+  stats: {
+    count: number;
+  };
+}
+
+export interface IRubedoForge {
+  forge(input: RubedoForgeInput): RubedoArtifact;
+}

package/tsconfig.build.json

@@ -1,13 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "moduleResolution": "Bundler",
-    "declaration": true,
-    "outDir": "dist",
-    "rootDir": "src",
-    "strict": true,
-    "skipLibCheck": true
-  },
-  "include": ["src/**/*"]
-}