@audiofool/moondog 0.1.0

package/contracts/v1/track-ref.schema.json

@@ -0,0 +1,275 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:moondog:contract:track-ref:1",
+  "title": "Moondog TrackRef v1",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/schema_version"
+    },
+    "track_ref_id": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/uuid"
+    },
+    "revision": {
+      "type": "integer",
+      "minimum": 1
+    },
+    "identity_status": {
+      "enum": [
+        "provisional",
+        "resolved",
+        "ambiguous",
+        "merged"
+      ]
+    },
+    "display_label": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/non_empty_string"
+    },
+    "title": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/non_empty_string"
+    },
+    "artist_credits": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "$ref": "urn:moondog:contract:definitions:1#/$defs/non_empty_string"
+          },
+          "artist_ref_id": {
+            "$ref": "urn:moondog:contract:definitions:1#/$defs/uuid"
+          },
+          "role": {
+            "enum": [
+              "primary",
+              "featured",
+              "remixer",
+              "composer",
+              "performer",
+              "unknown"
+            ]
+          },
+          "external_refs": {
+            "type": "array",
+            "items": {
+              "$ref": "urn:moondog:contract:definitions:1#/$defs/external_ref"
+            },
+            "uniqueItems": true
+          }
+        },
+        "required": [
+          "name",
+          "role"
+        ],
+        "additionalProperties": false
+      }
+    },
+    "release": {
+      "type": "object",
+      "properties": {
+        "title": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/non_empty_string"
+        },
+        "release_ref_id": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/uuid"
+        },
+        "release_date": {
+          "oneOf": [
+            {
+              "type": "string",
+              "format": "date"
+            },
+            {
+              "type": "string",
+              "pattern": "^[0-9]{4}-(?:0[1-9]|1[0-2])$"
+            },
+            {
+              "type": "string",
+              "pattern": "^[0-9]{4}$"
+            }
+          ]
+        }
+      },
+      "required": [
+        "title"
+      ],
+      "additionalProperties": false
+    },
+    "duration_ms": {
+      "type": "integer",
+      "minimum": 0
+    },
+    "isrc": {
+      "type": "string",
+      "pattern": "^[A-Z]{2}[A-Z0-9]{3}[0-9]{7}$"
+    },
+    "external_refs": {
+      "type": "array",
+      "items": {
+        "$ref": "urn:moondog:contract:definitions:1#/$defs/external_ref"
+      },
+      "uniqueItems": true
+    },
+    "candidate_track_ref_ids": {
+      "type": "array",
+      "minItems": 2,
+      "items": {
+        "$ref": "urn:moondog:contract:definitions:1#/$defs/uuid"
+      },
+      "uniqueItems": true
+    },
+    "supersedes": {
+      "type": "object",
+      "properties": {
+        "track_ref_id": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/uuid"
+        },
+        "revision": {
+          "type": "integer",
+          "minimum": 1
+        }
+      },
+      "required": [
+        "track_ref_id",
+        "revision"
+      ],
+      "additionalProperties": false
+    },
+    "merged_into": {
+      "type": "object",
+      "properties": {
+        "track_ref_id": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/uuid"
+        },
+        "revision": {
+          "type": "integer",
+          "minimum": 1
+        }
+      },
+      "required": [
+        "track_ref_id",
+        "revision"
+      ],
+      "additionalProperties": false
+    },
+    "created_at": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/utc_timestamp"
+    },
+    "resolved_at": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/utc_timestamp"
+    },
+    "extensions": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/extensions"
+    }
+  },
+  "required": [
+    "schema_version",
+    "track_ref_id",
+    "revision",
+    "identity_status",
+    "display_label",
+    "external_refs",
+    "created_at"
+  ],
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "identity_status": {
+            "const": "resolved"
+          }
+        },
+        "required": [
+          "identity_status"
+        ]
+      },
+      "then": {
+        "required": [
+          "title",
+          "artist_credits",
+          "resolved_at"
+        ],
+        "properties": {
+          "artist_credits": {
+            "type": "array",
+            "minItems": 1
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "identity_status": {
+            "const": "ambiguous"
+          }
+        },
+        "required": [
+          "identity_status"
+        ]
+      },
+      "then": {
+        "required": [
+          "candidate_track_ref_ids"
+        ]
+      },
+      "else": {
+        "not": {
+          "required": [
+            "candidate_track_ref_ids"
+          ]
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "identity_status": {
+            "const": "merged"
+          }
+        },
+        "required": [
+          "identity_status"
+        ]
+      },
+      "then": {
+        "required": [
+          "merged_into"
+        ]
+      },
+      "else": {
+        "not": {
+          "required": [
+            "merged_into"
+          ]
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "revision": {
+            "type": "integer",
+            "minimum": 2
+          }
+        },
+        "required": [
+          "revision"
+        ]
+      },
+      "then": {
+        "required": [
+          "supersedes"
+        ]
+      },
+      "else": {
+        "not": {
+          "required": [
+            "supersedes"
+          ]
+        }
+      }
+    }
+  ],
+  "additionalProperties": false
+}

package/contracts/v2/profile-evidence.schema.json

@@ -0,0 +1,284 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:moondog:contract:profile-evidence:2",
+  "title": "Moondog ProfileEvidence v2",
+  "type": "object",
+  "properties": {
+    "schema_version": {
+      "type": "integer",
+      "const": 2
+    },
+    "profile_evidence_id": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/uuid"
+    },
+    "subject_id": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/uuid"
+    },
+    "claim": {
+      "type": "object",
+      "properties": {
+        "dimension": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/namespaced_key"
+        },
+        "value": {
+          "oneOf": [
+            {
+              "type": "object",
+              "properties": {
+                "value_type": {
+                  "const": "entity"
+                },
+                "entity_ref": {
+                  "$ref": "urn:moondog:contract:definitions:1#/$defs/entity_ref"
+                }
+              },
+              "required": [
+                "value_type",
+                "entity_ref"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "value_type": {
+                  "const": "string"
+                },
+                "string_value": {
+                  "$ref": "urn:moondog:contract:definitions:1#/$defs/non_empty_string"
+                }
+              },
+              "required": [
+                "value_type",
+                "string_value"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "value_type": {
+                  "const": "number"
+                },
+                "number_value": {
+                  "type": "number"
+                }
+              },
+              "required": [
+                "value_type",
+                "number_value"
+              ],
+              "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "value_type": {
+                  "const": "boolean"
+                },
+                "boolean_value": {
+                  "type": "boolean"
+                }
+              },
+              "required": [
+                "value_type",
+                "boolean_value"
+              ],
+              "additionalProperties": false
+            }
+          ]
+        }
+      },
+      "required": [
+        "dimension",
+        "value"
+      ],
+      "additionalProperties": false
+    },
+    "direction": {
+      "enum": [
+        "supports",
+        "contradicts"
+      ]
+    },
+    "strength": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1
+    },
+    "confidence": {
+      "type": "number",
+      "minimum": 0,
+      "maximum": 1
+    },
+    "basis_refs": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "properties": {
+          "record_type": {
+            "enum": [
+              "library_track_observation",
+              "listening_event",
+              "taste_event"
+            ]
+          },
+          "record_id": {
+            "$ref": "urn:moondog:contract:definitions:1#/$defs/uuid"
+          }
+        },
+        "required": [
+          "record_type",
+          "record_id"
+        ],
+        "additionalProperties": false
+      },
+      "uniqueItems": true
+    },
+    "derivation": {
+      "type": "object",
+      "properties": {
+        "kind": {
+          "enum": [
+            "direct",
+            "rule",
+            "aggregate",
+            "model"
+          ]
+        },
+        "name": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/non_empty_string"
+        },
+        "version": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/non_empty_string"
+        },
+        "parameters_digest": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/sha256"
+        }
+      },
+      "required": [
+        "kind",
+        "name",
+        "version"
+      ],
+      "additionalProperties": false
+    },
+    "evidence_window": {
+      "type": "object",
+      "properties": {
+        "start_at": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/utc_timestamp"
+        },
+        "end_at": {
+          "$ref": "urn:moondog:contract:definitions:1#/$defs/utc_timestamp"
+        }
+      },
+      "required": [
+        "start_at",
+        "end_at"
+      ],
+      "additionalProperties": false
+    },
+    "created_at": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/utc_timestamp"
+    },
+    "expires_at": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/utc_timestamp"
+    },
+    "supersedes_profile_evidence_id": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/uuid"
+    },
+    "extensions": {
+      "$ref": "urn:moondog:contract:definitions:1#/$defs/extensions"
+    }
+  },
+  "required": [
+    "schema_version",
+    "profile_evidence_id",
+    "subject_id",
+    "claim",
+    "direction",
+    "strength",
+    "confidence",
+    "basis_refs",
+    "derivation",
+    "created_at"
+  ],
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "derivation": {
+            "type": "object",
+            "properties": {
+              "kind": {
+                "enum": [
+                  "aggregate",
+                  "model"
+                ]
+              }
+            },
+            "required": [
+              "kind"
+            ]
+          }
+        },
+        "required": [
+          "derivation"
+        ]
+      },
+      "then": {
+        "required": [
+          "evidence_window"
+        ]
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "basis_refs": {
+            "type": "array",
+            "contains": {
+              "type": "object",
+              "properties": {
+                "record_type": {
+                  "const": "library_track_observation"
+                }
+              },
+              "required": [
+                "record_type"
+              ]
+            }
+          }
+        },
+        "required": [
+          "basis_refs"
+        ]
+      },
+      "then": {
+        "properties": {
+          "derivation": {
+            "type": "object",
+            "properties": {
+              "kind": {
+                "enum": [
+                  "rule",
+                  "aggregate"
+                ]
+              },
+              "parameters_digest": {
+                "$ref": "urn:moondog:contract:definitions:1#/$defs/sha256"
+              }
+            },
+            "required": [
+              "kind",
+              "parameters_digest"
+            ]
+          }
+        }
+      }
+    }
+  ],
+  "additionalProperties": false
+}

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "@audiofool/moondog",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Local-first personal AI music agent.",
+  "keywords": [
+    "ai-agent",
+    "listenbrainz",
+    "local-first",
+    "music",
+    "music-discovery",
+    "personal-ai",
+    "spotify",
+    "taste-profile"
+  ],
+  "bin": {
+    "moondog": "scripts/moondog"
+  },
+  "files": [
+    "assets/brand/moondog-lunar-record/moondog-logo-1x1.png",
+    "contracts/v1",
+    "contracts/v2",
+    "scripts/contract-lib.mjs",
+    "scripts/contract-semantics.mjs",
+    "scripts/moondog",
+    "scripts/moondog.mjs",
+    "scripts/demo-studio.mjs",
+    "src/core",
+    "src/demo/moondog-interactive-tasteprint-demo.mjs",
+    "src/demo/moondog-demo.mjs",
+    "src/demo/fictional-spotify-history.mjs",
+    "src/demo/moondog-tasteprint-demo.mjs",
+    "src/importers",
+    "src/integrations",
+    "src/memory",
+    "src/profile",
+    "src/runtime",
+    "src/surfaces"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "packageManager": "npm@11.16.0",
+  "scripts": {
+    "start": "node --disable-warning=ExperimentalWarning scripts/moondog.mjs",
+    "moondog": "node --disable-warning=ExperimentalWarning scripts/moondog.mjs",
+    "studio": "node --disable-warning=ExperimentalWarning scripts/moondog.mjs studio",
+    "demo:studio": "node --disable-warning=ExperimentalWarning scripts/demo-studio.mjs",
+    "generate:demo-history": "node --disable-warning=ExperimentalWarning scripts/moondog.mjs demo-history",
+    "showcase": "node --disable-warning=ExperimentalWarning scripts/showcase.mjs",
+    "export:showcase": "node --disable-warning=ExperimentalWarning scripts/export-showcase.mjs",
+    "demo": "node --disable-warning=ExperimentalWarning scripts/moondog.mjs demo --offline",
+    "generate:tasteprint-demo": "node --disable-warning=ExperimentalWarning scripts/generate-tasteprint-demo.mjs",
+    "generate:studio-tour": "node --disable-warning=ExperimentalWarning scripts/capture-studio-tour.mjs",
+    "generate:demo-screens": "node --disable-warning=ExperimentalWarning scripts/capture-demo-screens.mjs",
+    "verify:showcase": "node --disable-warning=ExperimentalWarning scripts/verify-showcase.mjs",
+    "verify:showcase-export": "node --test tests/core/showcase-export.test.mjs",
+    "verify:demo-history": "node --test tests/runtime/moondog-demo-history.test.mjs",
+    "verify:demo": "node --disable-warning=ExperimentalWarning scripts/verify-public-demo.mjs",
+    "verify:demo-media": "node --disable-warning=ExperimentalWarning scripts/verify-demo-media.mjs",
+    "verify:community": "node --disable-warning=ExperimentalWarning scripts/verify-community.mjs",
+    "verify:package": "node --disable-warning=ExperimentalWarning scripts/verify-package.mjs",
+    "verify:release-tree": "node --disable-warning=ExperimentalWarning scripts/verify-release-tree.mjs",
+    "verify:clean-source": "node --disable-warning=ExperimentalWarning scripts/verify-clean-source.mjs",
+    "verify:clean-linux": "node --disable-warning=ExperimentalWarning scripts/verify-clean-source.mjs --linux-container",
+    "export:public-source": "node --disable-warning=ExperimentalWarning scripts/export-public-source.mjs",
+    "verify": "npm run verify:release-tree && npm run verify:showcase && npm run verify:showcase-export && npm run verify:demo-history && npm run verify:demo && npm run verify:demo-media && npm run verify:community && npm run verify:package && npm run validate:contracts && npm test",
+    "doctor": "node --disable-warning=ExperimentalWarning scripts/moondog.mjs doctor",
+    "inspect:apple-library": "node scripts/import-apple-music-library.mjs inspect",
+    "import:apple-library": "node scripts/import-apple-music-library.mjs import",
+    "rebuild:apple-projection": "node --disable-warning=ExperimentalWarning scripts/rebuild-apple-music-projection.mjs",
+    "eval:discovery": "node --disable-warning=ExperimentalWarning scripts/evaluate-discovery.mjs",
+    "eval:review": "node --disable-warning=ExperimentalWarning scripts/review-discovery.mjs",
+    "eval:usability": "node --disable-warning=ExperimentalWarning scripts/evaluate-usability.mjs",
+    "validate:contracts": "node scripts/validate-contracts.mjs",
+    "test": "node --test tests/contracts/*.test.mjs tests/core/*.test.mjs tests/importers/*.test.mjs tests/runtime/*.test.mjs"
+  },
+  "dependencies": {
+    "@earendil-works/pi-agent-core": "0.84.3",
+    "@earendil-works/pi-ai": "0.84.3",
+    "@earendil-works/pi-tui": "0.84.3",
+    "ajv": "8.20.0",
+    "ajv-formats": "3.0.1",
+    "plist": "5.0.0"
+  },
+  "devDependencies": {
+    "yaml": "2.9.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Audiofool934/moondog.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Audiofool934/moondog/issues"
+  },
+  "homepage": "https://github.com/Audiofool934/moondog#readme",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}