@chronicle.app/schema 0.1.0 → 0.2.0

package/README.md

@@ -2,16 +2,16 @@
 
 A deliberately small extraction vocabulary with generated TypeScript interfaces
 and Zod validators. The canonical file is [chronicle.ttl](chronicle.ttl); edit it and run
-`npm run schema:generate` from the repository root. This generates both the
-TypeScript/Zod schemas and [the HTML reference](docs/schema.html).
-`npm run schema:check` verifies that both committed outputs match the ontology
-without rewriting them.
+`npm run schema:generate` from the repository root to regenerate the TypeScript/Zod
+schemas. `npm run schema:check` verifies that the committed output matches the
+ontology without rewriting it.
 
-Open `docs/schema.html` directly in a browser; its styles are embedded and it
-requires no server or network access. It includes hierarchy navigation, linked
-`:term` references, inherited properties, ranges, cardinality, and term URIs.
-Use `npm run generate:docs -w @chronicle.app/schema` to regenerate just the HTML.
-The package also exports the page as `@chronicle.app/schema/schema.html`.
+## Documentation site
+
+The schema is documented at https://schema.chronicle.app, built from
+`chronicle.ttl` and the example records in [examples.ttl](examples.ttl). The
+site lives in [apps/schema-site](../../apps/schema-site), which also describes
+the examples format.
 
 ## Vocabulary
 
@@ -25,8 +25,9 @@ realms; iMessage adds messages and attachment media; Claude Code adds threads,
 software agents, and model instruments. Shared properties cover source identity,
 event time, agents, membership, authors, and recipients.
 
-`Text`, `URL`, and `DateTime` are literal datatypes. Properties remain optional;
-`chronicle.ttl` defines whether each is single-valued or a list. Records carry `@type` and at least one of `@key` (a nonempty list of
+`Text`, `URL`, and `DateTime` are literal datatypes. Cardinality in
+`chronicle.ttl` defines each property's constraints: `owl:minCardinality 1` makes
+it required, and `owl:maxCardinality 1` makes it single-valued; otherwise it is a list. Records carry `@type` and at least one of `@key` (a nonempty list of
 identity fields or computed key entries) or `@id` (an existing identity).
 Identity validation checks that declaration, not the existence or hash of the
 referenced fields. Source-specific extraction owns the values; never invent IDs
@@ -91,9 +92,11 @@ The publication convention is
 `https://schema.chronicle.app/releases/<version>/chronicle.ttl`, with matching
 documentation under the same release path. Published snapshots must never be
 overwritten or removed by later deployments. The unversioned `/chronicle.ttl`
-and term pages should serve the latest released version, rather than unreleased
-changes on `main`. Website hosting is not configured yet; see
-[Preparing a release](../../RELEASING.md) for the release procedure.
+and term pages serve `main`, so `main` holds only vocabulary that is ready to
+publish: work on new terms in a branch until it is ready. Any change to
+`chronicle.ttl` after a release must raise `owl:versionInfo`;
+`npm run schema:check` enforces this against the latest release tag. See [Preparing a release](../../RELEASING.md) for the
+release procedure.
 
 The vocabulary is intentionally small. Add terms only when a plugin needs them,
 keeping existing term identifiers and meanings stable; regenerate and add

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chronicle.app/schema",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Minimal Chronicle extraction vocabulary and generated TypeScript/Zod schemas",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,19 +11,17 @@
       "import": "./dist/index.js"
     },
     "./chronicle.ttl": "./chronicle.ttl",
-    "./schema.html": "./docs/schema.html",
     "./schema.ttl": "./chronicle.ttl"
   },
   "files": [
     "dist/*.js",
     "dist/*.d.ts",
-    "chronicle.ttl",
-    "docs/schema.html"
+    "chronicle.ttl"
   ],
   "scripts": {
-    "generate": "node scripts/generate-schemas.js && npm run generate:docs",
-    "generate:docs": "node scripts/generate-docs.js",
+    "generate": "node scripts/generate-schemas.js",
     "generate:check": "node scripts/check-generated.js",
+    "version:check": "node scripts/check-version.js",
     "build": "tsc -b tsconfig.lib.json",
     "typecheck": "tsc -p tsconfig.json",
     "test": "node --test src/*.test.js scripts/*.test.js",
@@ -36,8 +34,8 @@
     "zod": "^3.24.1"
   },
   "devDependencies": {
-    "@chronicle.app/tsconfig": "0.1.0",
-    "@chronicle.app/prettier-config": "0.1.0",
+    "@chronicle.app/prettier-config": "0.2.0",
+    "@chronicle.app/tsconfig": "0.2.0",
     "@types/node": "^22.10.1",
     "n3": "^1.23.1",
     "prettier": "^3.6.2",