@gnolith/taproot 0.1.0-rc.0

package/dist/types.d.ts

@@ -0,0 +1,299 @@
+import type * as RDF from '@rdfjs/types';
+export declare const ENTITY_DATATYPES: readonly ["wikibase-item", "wikibase-property", "wikibase-lexeme", "wikibase-form", "wikibase-sense", "entity-schema", "string", "external-id", "url", "commonsMedia", "monolingualtext", "time", "quantity", "globe-coordinate", "math", "musical-notation", "geo-shape", "tabular-data"];
+export type EntityDatatype = (typeof ENTITY_DATATYPES)[number];
+export type EntityId = `Q${number}` | `P${number}`;
+export type ReferencedEntityId = EntityId | `L${number}` | `L${number}-F${number}` | `L${number}-S${number}` | `E${number}`;
+export type PropertyId = `P${number}`;
+export type EntityType = 'item' | 'property';
+export type Rank = 'preferred' | 'normal' | 'deprecated';
+export type SnakType = 'value' | 'somevalue' | 'novalue';
+export interface LanguageValue {
+    language: string;
+    value: string;
+}
+export type LanguageMap = Record<string, LanguageValue>;
+export type AliasMap = Record<string, LanguageValue[]>;
+export interface EntityIdValue {
+    'entity-type': 'item' | 'property' | 'lexeme' | 'form' | 'sense' | 'entity-schema';
+    'numeric-id'?: number;
+    id: ReferencedEntityId;
+}
+export interface MonolingualTextValue {
+    language: string;
+    text: string;
+}
+export interface TimeValue {
+    time: string;
+    timezone: number;
+    before: number;
+    after: number;
+    precision: number;
+    calendarmodel: string;
+}
+export interface QuantityValue {
+    amount: string;
+    unit: string;
+    lowerBound?: string;
+    upperBound?: string;
+}
+export interface GlobeCoordinateValue {
+    latitude: number;
+    longitude: number;
+    altitude: number | null;
+    precision: number | null;
+    globe: string;
+}
+export type DataValueValue = string | EntityIdValue | MonolingualTextValue | TimeValue | QuantityValue | GlobeCoordinateValue;
+export interface DataValue {
+    value: DataValueValue;
+    type: string;
+}
+export interface Snak {
+    snaktype: SnakType;
+    property: PropertyId;
+    hash?: string;
+    datatype: EntityDatatype;
+    datavalue?: DataValue;
+}
+export interface Reference {
+    hash: string;
+    snaks: Record<PropertyId, Snak[]>;
+    'snaks-order': PropertyId[];
+}
+export interface Statement {
+    id: string;
+    type: 'statement';
+    rank: Rank;
+    mainsnak: Snak;
+    qualifiers: Record<PropertyId, Snak[]>;
+    'qualifiers-order': PropertyId[];
+    references: Reference[];
+}
+export interface Sitelink {
+    site: string;
+    title: string;
+    badges: Array<`Q${number}`>;
+    url?: string;
+}
+interface EntityBase {
+    id: EntityId;
+    labels: LanguageMap;
+    descriptions: LanguageMap;
+    aliases: AliasMap;
+    claims: Record<PropertyId, Statement[]>;
+    lastrevid: number;
+    modified: string;
+}
+export interface Item extends EntityBase {
+    id: `Q${number}`;
+    type: 'item';
+    sitelinks: Record<string, Sitelink>;
+}
+export interface Property extends EntityBase {
+    id: `P${number}`;
+    type: 'property';
+    datatype: EntityDatatype;
+}
+export type WikibaseEntity = Item | Property;
+export interface MappingOptions {
+    baseIri: string;
+    mappingVersion?: string;
+    factory?: RDF.DataFactory;
+}
+export type ActorKind = 'human' | 'agent' | 'import' | 'system';
+export interface Attribution {
+    id: string;
+    kind: ActorKind;
+    name?: string;
+    organization?: string;
+    tool?: string;
+    url?: string;
+}
+export interface EditMetadata {
+    /** @deprecated Use attribution. Kept for source compatibility. */
+    actor?: string;
+    attribution?: Attribution;
+    editSummary?: string;
+    tags?: string[];
+    requestId?: string;
+}
+export interface ExpectedRevision extends EditMetadata {
+    expectedRevision: number;
+}
+export interface WriteResult {
+    entityId: EntityId;
+    previousRevision: number | null;
+    newRevision: number;
+    entity: WikibaseEntity;
+    quadPatch: {
+        deleted: number;
+        inserted: number;
+    };
+    eventId: string;
+    contentHash: string;
+}
+export interface StoredEntity {
+    entity: WikibaseEntity;
+    deletedAt: string | null;
+    redirectTo: EntityId | null;
+}
+export interface ResolvedEntity extends StoredEntity {
+    requestedId: EntityId;
+    resolvedId: EntityId;
+    redirects: EntityId[];
+}
+export interface RevisionEntry {
+    entityId: EntityId;
+    revision: number;
+    entity: WikibaseEntity;
+    actor: string | null;
+    attribution: Attribution | null;
+    editSummary: string | null;
+    tags: string[];
+    eventId: string;
+    contentHash: string;
+    parentHash: string | null;
+    deletedAt: string | null;
+    redirectTo: EntityId | null;
+    createdAt: string;
+}
+export type AuditEventType = 'create' | 'update' | 'revert' | 'delete' | 'restore' | 'redirect' | 'import' | 'repair';
+export interface AuditEvent {
+    sequence: number;
+    eventId: string;
+    entityId: EntityId;
+    revision: number;
+    type: AuditEventType;
+    attribution: Attribution | null;
+    editSummary: string | null;
+    tags: string[];
+    requestId: string | null;
+    contentHash: string;
+    parentHash: string | null;
+    lifecycle: {
+        deletedAt: string | null;
+        redirectTo: EntityId | null;
+    };
+    createdAt: string;
+}
+export interface Page<T> {
+    items: T[];
+    cursor: string | null;
+}
+export interface EntityListEntry extends StoredEntity {
+    entityId: EntityId;
+}
+export interface IntegrityIssue {
+    code: 'current-revision-mismatch' | 'revision-json-mismatch' | 'content-hash-mismatch' | 'audit-event-missing' | 'term-projection-mismatch' | 'rdf-projection-mismatch';
+    message: string;
+}
+export interface EntityIntegrityReport {
+    entityId: EntityId;
+    revision: number;
+    valid: boolean;
+    issues: IntegrityIssue[];
+}
+export interface BulkImportResult {
+    succeeded: WriteResult[];
+    failed: Array<{
+        index: number;
+        entityId?: EntityId;
+        error: Error;
+    }>;
+}
+export interface TaprootObservation {
+    operation: string;
+    outcome: 'success' | 'error';
+    durationMs: number;
+    entityId?: EntityId;
+    revision?: number;
+    error?: unknown;
+}
+export type EntityCommand = {
+    type: 'set-label';
+    language: string;
+    value: string;
+} | {
+    type: 'remove-label';
+    language: string;
+} | {
+    type: 'set-description';
+    language: string;
+    value: string;
+} | {
+    type: 'remove-description';
+    language: string;
+} | {
+    type: 'add-alias';
+    language: string;
+    value: string;
+} | {
+    type: 'remove-alias';
+    language: string;
+    ordinal: number;
+} | {
+    type: 'set-sitelink';
+    site: string;
+    value: Sitelink;
+} | {
+    type: 'remove-sitelink';
+    site: string;
+} | {
+    type: 'add-statement';
+    statement: Statement;
+} | {
+    type: 'replace-statement';
+    statementId: string;
+    statement: Statement;
+} | {
+    type: 'remove-statement';
+    statementId: string;
+} | {
+    type: 'set-statement-rank';
+    statementId: string;
+    rank: Rank;
+} | {
+    type: 'add-qualifier';
+    statementId: string;
+    snak: Snak;
+} | {
+    type: 'remove-qualifier';
+    statementId: string;
+    property: PropertyId;
+    ordinal: number;
+} | {
+    type: 'add-reference';
+    statementId: string;
+    reference: Reference;
+} | {
+    type: 'replace-reference';
+    statementId: string;
+    hash: string;
+    reference: Reference;
+} | {
+    type: 'remove-reference';
+    statementId: string;
+    hash: string;
+};
+export type TaprootValidator = (entity: WikibaseEntity, context: {
+    previous: WikibaseEntity | null;
+    metadata: EditMetadata;
+}) => void | Promise<void>;
+export interface SearchResult {
+    entityId: EntityId;
+    entityType: EntityType;
+    language: string;
+    termType: 'label' | 'description' | 'alias';
+    value: string;
+}
+export interface TaprootOptions extends MappingOptions {
+    maxEntityBytes?: number;
+    maxBulkEntities?: number;
+    clock?: () => Date;
+    createId?: () => string;
+    validators?: TaprootValidator[];
+    observe?: (observation: TaprootObservation) => void | Promise<void>;
+    requireAttribution?: boolean;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,21 @@
+export const ENTITY_DATATYPES = [
+    'wikibase-item',
+    'wikibase-property',
+    'wikibase-lexeme',
+    'wikibase-form',
+    'wikibase-sense',
+    'entity-schema',
+    'string',
+    'external-id',
+    'url',
+    'commonsMedia',
+    'monolingualtext',
+    'time',
+    'quantity',
+    'globe-coordinate',
+    'math',
+    'musical-notation',
+    'geo-shape',
+    'tabular-data',
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,eAAe;IACf,mBAAmB;IACnB,iBAAiB;IACjB,eAAe;IACf,gBAAgB;IAChB,eAAe;IACf,QAAQ;IACR,aAAa;IACb,KAAK;IACL,cAAc;IACd,iBAAiB;IACjB,MAAM;IACN,UAAU;IACV,kBAAkB;IAClB,MAAM;IACN,kBAAkB;IAClB,WAAW;IACX,cAAc;CACN,CAAC"}

package/docs/api.md

@@ -0,0 +1,47 @@
+# API guide
+
+`TaprootRepository` is the primary API; equivalent top-level functions are
+exported for request-scoped use.
+
+## Reads
+
+- `getEntity`, `resolveEntity`, `getEntityRevision`
+- `listEntities`, `listEntityRevisionsPage`, `searchEntitiesPage`
+- `getAuditEvent`, `listAuditEvents`, `verifyAuditChain`
+- `inspectEntityIntegrity`, `inspectTaprootIntegrity`
+
+Page APIs return `{ items, cursor }`. Pass the opaque cursor back unchanged.
+Entity and revision cursors are keyset cursors. Search cursors are bounded
+offset cursors and should be consumed promptly when the search index is being
+edited concurrently.
+
+## Writes
+
+- `createItem`, `createProperty`, `importEntity`, `replaceEntity`, `revertEntity`
+- `applyCommands` for multiple domain changes in one revision
+- individual label, description, alias, sitelink, statement, qualifier,
+  reference, and rank methods
+- `softDeleteEntity`, `restoreEntity`, `redirectEntity`
+- `repairEntityProjection`
+
+All updates require `expectedRevision`. Redirects must target a live entity of
+the same type and cannot create a cycle. `resolveEntity` follows a bounded
+chain and reports every hop.
+
+`createStatement` and `createReference` build correctly shaped values. Import
+accepts trusted explicit Q/P IDs and advances counters. `importEntities`
+supports create-only or upsert mode and reports per-entity failures.
+
+## Edit context
+
+An edit can contain structured `attribution`, `editSummary`, sorted/deduplicated
+`tags`, and a `requestId`. Attribution kinds are `human`, `agent`, `import`, or
+`system`. The legacy `actor` string remains accepted and is normalized to a
+human attribution record.
+
+Set `requireAttribution`, `validators`, `clock`, `createId`, `observe`, entity
+size, and bulk limits in `TaprootOptions`. Validators run before the D1 batch.
+Observers cannot fail or roll back committed writes.
+
+All domain failures extend `TaprootError` and expose a stable uppercase
+snake-case `code` in addition to their exported class for `instanceof` checks.

package/docs/architecture.md

@@ -0,0 +1,30 @@
+# Architecture
+
+Taproot is the knowledge-domain layer between a Codex Site and Diamond. The
+canonical source of truth is one Wikibase-shaped JSON document per Item or
+Property. Revisions are append-only snapshots. Search terms and RDF are
+rebuildable projections and never become a competing statement model.
+
+Every write performs the same transaction:
+
+1. Load the current entity and enforce its expected revision.
+2. Apply commands, validate the whole document, referenced Property
+   datatypes, host validators, size limits, attribution, and lifecycle rules.
+3. Serialize canonical JSON and compute its SHA-256 content/parent hashes.
+4. Build the complete RDF closure and search-term projection.
+5. Commit the current row, immutable revision, audit event, terms, RDF patch,
+   and RDF ownership rows in one D1 batch.
+
+RDF ownership is required because Wikibase full-value and reference nodes can
+be shared. It allows an entity edit to remove an old quad only when no other
+entity owns it. The table contains encoded quad keys only and is fully
+rebuildable from canonical JSON.
+
+The schema has no statement, qualifier, or reference tables. Those structures
+live solely inside canonical entity JSON. Diamond's `rdf_quads` is the query
+projection; `taproot_terms` is the search projection.
+
+Taproot owns Items, Properties, their values and lifecycle, revisions,
+attribution/audit history, deterministic projections, migration, integrity,
+and repair. It deliberately does not own authentication, authorization, MCP,
+agents, UI, wiki article bodies, media storage, or arbitrary SPARQL Update.

package/docs/completion-audit.md

@@ -0,0 +1,31 @@
+# Completion audit
+
+This audit covers the complete Taproot package boundary defined in
+`product-scope.md`, not merely CRUD.
+
+| Capability           | Evidence                                                                                                                     |
+| -------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
+| Canonical model      | Item/Property types, strict validator, canonical serializer, statement/reference builders, JSON fixture                      |
+| Complete edits       | Typed individual commands, `applyCommands`, optimistic revisions, all term/sitelink/statement/qualifier/reference/rank paths |
+| Lifecycle            | Soft delete, restore, same-type acyclic redirects, bounded resolution, lifecycle snapshots in every revision/event           |
+| Attribution/audit    | Structured actors, legacy normalization, summaries, tags, request IDs, immutable events/revisions, SHA-256 parent chains     |
+| D1 atomicity         | One batch for current JSON, revision, audit, terms, RDF, and ownership; rollback and competing-edit Workerd tests            |
+| RDF/SPARQL           | Wikibase paths, truthy/best rank, all snak types, full values, standard statement/provenance types, mapping v2 fixtures      |
+| Shared RDF safety    | Per-entity quad ownership and behavioral regression covering a shared full-value node during another entity's edit           |
+| Search/read scale    | Entity/revision/audit keyset cursors, bounded search cursor, configured page limits                                          |
+| Bulk/agent workflows | Multi-command single revision, bounded create/upsert import with indexed errors, NDJSON export, request correlation          |
+| Migration            | Versioned SQL, programmatic v1 hash/audit backfill, resumable v1-to-v2 RDF reprojection and ownership creation               |
+| Integrity/repair     | Schema inspection, audit-chain verification, JSON/revision/term/RDF comparison, cursor scan, audited reprojection repair     |
+| Extension points     | Required attribution, async host validators, isolated observations, injected clock and IDs                                   |
+| Operations/release   | Architecture/API/operations/scope/security/testing docs, Node 22/24 CI, packed consumer, license and release gates           |
+
+## Reproduction
+
+```sh
+npm ci
+npm run check
+```
+
+Diamond `0.3.2` or later supplies the registry-published composable patch API.
+The packed-consumer gate installs Taproot and Diamond without repository
+siblings or local paths and exercises a fresh Workerd D1 database.

package/docs/operations.md

@@ -0,0 +1,47 @@
+# Operations
+
+## Initialize and migrate
+
+Run `initializeTaproot(db)` during deployment or startup. It is idempotent and
+initializes Diamond too. SQL migration users must still run the initializer
+after applying `0002`: legacy revision hashes require Web Crypto and cannot be
+correctly produced by SQLite alone.
+
+The v1-to-v2 migration backfills SHA-256 content/parent chains and audit
+events, migrates RDF mapping v1 to v2, creates ownership records, and uses a
+durable migration marker so an interrupted reprojection resumes safely.
+`inspectTaprootSchema` checks tables, required columns, indexes, triggers, and
+format versions. Treat a failed inspection as a deployment failure.
+
+## Integrity and repair
+
+`verifyAuditChain(id)` verifies revision continuity, every content hash and
+parent link, the chain head, and corresponding audit events.
+`inspectEntityIntegrity(id)` also compares current JSON, revision JSON, terms,
+RDF, and ownership. `inspectTaprootIntegrity` scans by cursor.
+
+`repairEntityProjection` atomically rebuilds terms, RDF, and ownership without
+changing canonical content or inventing a new content revision. It appends a
+`repair` audit event. It does not rewrite damaged immutable history; restore
+such data from backup and investigate if hash verification fails.
+
+## Backup and restore
+
+Back up the whole D1 database to preserve atomic boundaries. Canonical entities
+can also be exported as newline-delimited JSON with `exportEntities`, but that
+is a knowledge export, not a backup of attribution, revisions, deletions,
+redirects, or audit history.
+
+After database restore, run schema inspection and paginated integrity checks.
+After JSON-only import, projections are generated during each import.
+
+## Limits and failure behavior
+
+Writes are atomic per entity. Bulk import is deliberately not a cross-entity
+transaction; retry failed entries using their result indexes. Default limits:
+1.8 MB canonical JSON, 100 bulk entities, 100 commands per revision, and 500
+rows per page. Diamond separately enforces its atomic RDF payload bound.
+
+Revision and audit rows have database triggers rejecting UPDATE and DELETE.
+Projection repair is safe under shared RDF values because orphan removal checks
+quad ownership inside the same D1 transaction.

package/docs/product-scope.md

@@ -0,0 +1,20 @@
+# Product scope
+
+Taproot exists so a Codex Site can own a Wikibase-style knowledge graph in D1
+and query it through Diamond without operating MediaWiki or another external
+knowledge service.
+
+Version 0.1 is complete for the package's declared entity domain: Wikibase
+core Items and Properties, canonical JSON interchange, statements and all
+their components, supported datatypes, revision/lifecycle history,
+attribution and audit, search, RDF/SPARQL projection, bulk workflows,
+migration, integrity, repair, policy hooks, and operational documentation.
+
+The following are separate products or future compatibility domains rather
+than missing Taproot implementation: MCP transport, agent orchestration,
+authentication/authorization, UI, wiki pages, media bytes, MediaWiki APIs,
+Lexeme/Form/Sense, MediaInfo, and EntitySchema entity storage.
+
+Adding an extension entity type changes IDs, JSON, commands, RDF, migration,
+and compatibility fixtures. It must be designed and versioned as an explicit
+new domain rather than accepted as unvalidated JSON.

package/docs/release-policy.md

@@ -0,0 +1,16 @@
+# Release and support policy
+
+Taproot uses Semantic Versioning. Before 1.0, minor versions may deliberately
+change APIs or RDF mappings, but every such change must be documented and
+migratable. Patch releases preserve the documented public API and stored model.
+
+Releases are created only from annotated semantic-version tags whose commits
+belong to `main`. The protected `release` environment accepts only `v*.*.*`
+tags. GitHub Actions verifies the version and tag, runs the full quality gate,
+inspects the packed artifact, publishes to npm through OIDC trusted publishing,
+and attaches the tarball, SBOM, checksums, and build attestation to a GitHub
+Release.
+
+The current minor line receives fixes. Security support follows `SECURITY.md`.
+Deprecations are announced in the changelog before removal whenever a safe
+migration path exists.

package/docs/testing.md

@@ -0,0 +1,21 @@
+# Testing strategy
+
+Taproot's unit tests cover canonical Wikibase JSON validation, deterministic
+serialization, and RDF mapping fixtures. Integration tests run against
+Miniflare's Workerd D1 implementation and initialize Diamond and Taproot in the
+same database.
+
+The Workerd suite exercises successful edits, malformed and oversized input,
+optimistic conflicts, concurrent writers, migration, immutable history,
+projection repair, shared RDF values, and injected RDF failures. The injected
+failure proves that canonical JSON, revisions, audit events, search terms,
+ownership, and Diamond quads roll back as one D1 batch.
+
+`test/example.test.ts` runs the documented Codex Site example and queries its
+Taproot-generated graph through Diamond SPARQL. `consumer:check` packs the
+package, installs the tarball into a fresh temporary project with registry
+Diamond and Miniflare dependencies, initializes a new D1 database, writes an
+entity, and verifies the RDF through SPARQL using only public package exports.
+
+`npm run check` is the complete local release-quality gate. Coverage thresholds
+are enforced in `vitest.config.ts`; lowering them requires an explained review.

package/docs/threat-model.md

@@ -0,0 +1,40 @@
+# Threat model
+
+## Protected assets
+
+Taproot protects canonical entity state, immutable revision and audit history,
+optimistic-write ordering, search projections, RDF query projections, and the
+association between an edit and its claimed attribution metadata.
+
+## Trust boundaries
+
+The host application is trusted to authenticate and authorize callers, select
+the D1 binding, supply an absolute site-owned base IRI, and protect mutation
+routes. Attribution is a stored claim, not proof of identity. Diamond executes
+the RDF patch prepared by Taproot and exposes read-only SPARQL querying; hosts
+must not give untrusted callers an independent write path to Taproot or Diamond
+tables.
+
+## Threats and controls
+
+- Lost updates are blocked by expected-revision guards inside the same D1 batch
+  as all canonical and projected writes.
+- Partial writes are blocked by D1 batch atomicity; injected Workerd failures
+  verify rollback across Taproot and Diamond.
+- History tampering is deterred and detected by immutable-table triggers,
+  SHA-256 content/parent chains, schema inspection, and integrity APIs.
+- Resource exhaustion is bounded by entity, command, page, bulk, redirect, and
+  RDF patch limits. Hosts still need request-size, authentication, and rate
+  limits at the network boundary.
+- RDF projection confusion is constrained by strict entity validation,
+  deterministic mapping, site-owned namespaces, and per-entity quad ownership.
+- Dependency and release compromise is reduced through locked installs, pinned
+  GitHub Actions, dependency review, CodeQL, secret scanning, license checks,
+  OIDC npm publishing, provenance, SBOMs, checksums, and attestations.
+
+## Out of scope
+
+Taproot does not provide authentication, authorization, agent/MCP isolation,
+network rate limiting, D1 backup custody, UI sanitization, or arbitrary SPARQL
+Update. A compromised host with direct D1 access can bypass library controls;
+restore from a trusted backup and verify audit chains after such an incident.

package/examples/codex-site/.openai/hosting.json

@@ -0,0 +1,3 @@
+{
+  "framework": "nextjs"
+}

package/examples/codex-site/README.md

@@ -0,0 +1,13 @@
+# Codex Site example
+
+Bind a Cloudflare D1 database as `DB`, apply Diamond's and Taproot's numbered
+migrations, call `initializeTaproot`, and run `runTaprootDemo(env.DB)` from a
+trusted setup route or test fixture.
+
+`demo.ts` creates Properties and an Item, adds a qualified and referenced
+statement, changes its rank, adds a `somevalue`, queries the truthy projection
+through Diamond SPARQL, exports canonical JSON, proves that a stale edit is
+rejected, and returns the attribution/audit and integrity records. A production
+site should authenticate every mutation route and can enable
+`requireAttribution`; Taproot deliberately does not own authentication or agent
+transport.