@42ch/spoke-schemas 0.1.0-alpha.1 → 0.1.0-alpha.2

package/src/generated/data/source-anchor.ts

@@ -1,52 +0,0 @@
-/**
- * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
- * Source: schemas/
- * Generated by: pnpm run codegen
- */
-
-/**
- * Pointer to a source artifact span (manuscript, scene, external URI).
- */
-export interface SourceAnchor {
-  /**
-   * Wire schema version (integer >= 1).
-   */
-  schema_version: number;
-  /**
-   * Opaque source locator; products define grammar.
-   */
-  source_id: string;
-  span?: SourceSpan;
-  /**
-   * Optional human label for the anchor.
-   */
-  label?: string;
-  /**
-   * Optional MIME type of the referenced source.
-   */
-  mime_type?: string;
-  extensions: ExtensionMap;
-}
-/**
- * Optional byte or character span within the source.
- */
-export interface SourceSpan {
-  /**
-   * Start offset (inclusive).
-   */
-  start: number;
-  /**
-   * End offset (exclusive).
-   */
-  end: number;
-}
-/**
- * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
- */
-export interface ExtensionMap {
-  [k: string]:
-    | {
-        [k: string]: unknown | undefined;
-      }
-    | undefined;
-}

package/src/generated/data/timeline-event.ts

@@ -1,151 +0,0 @@
-/**
- * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
- * Source: schemas/
- * Generated by: pnpm run codegen
- */
-
-/**
- * First-class when-axis temporal object (L5). Distinct from KnowledgeEntry ontology labels such as entry_type: "event" (KB fact node, not this wire type).
- */
-export interface TimelineEvent {
-  /**
-   * Wire schema version (integer >= 1).
-   */
-  schema_version: number;
-  /**
-   * Stable TimelineEvent id (opaque to protocol).
-   */
-  timeline_event_id: string;
-  /**
-   * Human-stable label.
-   */
-  canonical_name: string;
-  /**
-   * Optional L5 projection tier (brief, narrative, moment).
-   */
-  timeline_scale?: string;
-  /**
-   * When the event happened — RFC 3339 or opaque fuzzy label (e.g. Third Age).
-   */
-  occurred_at?: string;
-  /**
-   * Longer narrative summary.
-   */
-  description?: string;
-  /**
-   * Related KnowledgeEntry ids (characters, locations, etc.).
-   */
-  participant_entry_ids?: string[];
-  source_anchor?: SourceAnchor;
-  /**
-   * Opaque ordering hint within a timeline (products define grammar).
-   */
-  sort_key?: string;
-  /**
-   * Optional world-history branch identity (l5-fork).
-   */
-  fork_id?: string;
-  /**
-   * Optional parent/base branch reference when product records fork lineage on the event.
-   */
-  parent_fork_id?: string;
-  /**
-   * Optional Moment-scale presentation of computable field change history (l2-computable only). Not Finding-shaped.
-   */
-  computable_logs?: ComputableLogEntry[];
-  /**
-   * RFC 3339 UTC datetime string.
-   */
-  created_at?: string;
-  /**
-   * RFC 3339 UTC datetime string.
-   */
-  updated_at?: string;
-  extensions: ExtensionMap;
-}
-/**
- * Optional manuscript or scene anchor.
- */
-export interface SourceAnchor {
-  /**
-   * Wire schema version (integer >= 1).
-   */
-  schema_version: number;
-  /**
-   * Opaque source locator; products define grammar.
-   */
-  source_id: string;
-  span?: SourceSpan;
-  /**
-   * Optional human label for the anchor.
-   */
-  label?: string;
-  /**
-   * Optional MIME type of the referenced source.
-   */
-  mime_type?: string;
-  extensions: ExtensionMap;
-}
-/**
- * Optional byte or character span within the source.
- */
-export interface SourceSpan {
-  /**
-   * Start offset (inclusive).
-   */
-  start: number;
-  /**
-   * End offset (exclusive).
-   */
-  end: number;
-}
-/**
- * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
- */
-export interface ExtensionMap {
-  [k: string]:
-    | {
-        [k: string]: unknown | undefined;
-      }
-    | undefined;
-}
-export interface ComputableLogEntry {
-  /**
-   * When the computable field change was recorded (RFC 3339).
-   */
-  logged_at: string;
-  /**
-   * KnowledgeEntry id whose computable fields changed.
-   */
-  entry_id: string;
-  /**
-   * Field-level change records within body.computable.
-   */
-  changes: ComputableLogChange[];
-  /**
-   * Opaque Session correlation (matches op session_id when omitted on parent context).
-   */
-  session_id?: string;
-  /**
-   * Human-readable presentation note (presentation only).
-   */
-  message?: string;
-}
-export interface ComputableLogChange {
-  /**
-   * Dot-path or JSON Pointer to changed field within body.computable.
-   */
-  path: string;
-  /**
-   * Opaque JSON — value before change.
-   */
-  previous?: {
-    [k: string]: unknown | undefined;
-  };
-  /**
-   * Opaque JSON — value after change.
-   */
-  next?: {
-    [k: string]: unknown | undefined;
-  };
-}

package/src/generated/index.ts

@@ -1,9 +0,0 @@
-/**
- * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
- * Source: schemas/
- * Generated by: pnpm run codegen
- */
-
-export * from './common';
-export * from './data';
-export * from './ops';

package/src/generated/ops/assemble-request.ts

@@ -1,60 +0,0 @@
-/**
- * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
- * Source: schemas/
- * Generated by: pnpm run codegen
- */
-
-/**
- * Selector hints for context assembly. Wire-only — no compute semantics.
- */
-export interface AssembleRequest {
-  scope: Scope;
-  /**
-   * Optional entry limit hint (not enforced by protocol).
-   */
-  max_entries?: number;
-  extensions?: ExtensionMap;
-}
-/**
- * Assembly scope selector.
- */
-export interface Scope {
-  /**
-   * Protocol-neutral opaque selector. Products map World/Book/chapter/manuscript ids via adapters or op extensions.
-   */
-  scope_id: string;
-  /**
-   * Optional narrow scope to explicit KnowledgeEntries.
-   */
-  entry_ids?: string[];
-  /**
-   * Optional filter by open entry_type vocabulary.
-   */
-  entry_types?: string[];
-  /**
-   * Optional narrow scope to explicit L5 TimelineEvent ids.
-   */
-  timeline_event_ids?: string[];
-  /**
-   * Optional provenance or manuscript locator scope.
-   */
-  source_id?: string;
-  /**
-   * Optional L5 tier filter (brief, narrative, moment).
-   */
-  timeline_scale?: string;
-  /**
-   * Optional L5 branch filter — strict equality on TimelineEvent.fork_id (l5-fork).
-   */
-  fork_id?: string;
-}
-/**
- * Optional transport metadata.
- */
-export interface ExtensionMap {
-  [k: string]:
-    | {
-        [k: string]: unknown | undefined;
-      }
-    | undefined;
-}

package/src/generated/ops/assemble-response.ts

@@ -1,109 +0,0 @@
-/**
- * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
- * Source: schemas/
- * Generated by: pnpm run codegen
- */
-
-/**
- * Assemble success packet or wire error. Use packet OR error — not both.
- */
-export type AssembleResponse =
-  | {
-      packet: AssemblePacket;
-      extensions?: ExtensionMap1;
-    }
-  | {
-      error: ErrorEnvelope;
-      extensions?: ExtensionMap2;
-    };
-
-/**
- * Success: assembled context packet.
- */
-export interface AssemblePacket {
-  /**
-   * Wire schema version (integer >= 1).
-   */
-  schema_version: number;
-  /**
-   * Stable packet id.
-   */
-  packet_id: string;
-  /**
-   * Slim context entries (default). Full KnowledgeEntry embedding is op-specific.
-   */
-  entries: AssembleEntry[];
-  extensions: ExtensionMap;
-}
-/**
- * This interface was referenced by `AssemblePacket`'s JSON-Schema
- * via the `definition` "AssembleEntry".
- */
-export interface AssembleEntry {
-  /**
-   * Referenced KnowledgeEntry id.
-   */
-  entry_id: string;
-  /**
-   * Open string. Same core vocabulary as KnowledgeEntry.entry_type.
-   */
-  entry_type: string;
-  /**
-   * Display name for context window.
-   */
-  canonical_name: string;
-  /**
-   * Optional trimmed text for context window.
-   */
-  snippet?: string;
-}
-/**
- * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
- */
-export interface ExtensionMap {
-  [k: string]:
-    | {
-        [k: string]: unknown | undefined;
-      }
-    | undefined;
-}
-/**
- * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
- */
-export interface ExtensionMap1 {
-  [k: string]:
-    | {
-        [k: string]: unknown | undefined;
-      }
-    | undefined;
-}
-/**
- * Failure: shared error envelope.
- */
-export interface ErrorEnvelope {
-  /**
-   * Machine-readable error code.
-   */
-  code: string;
-  /**
-   * Human-readable error message.
-   */
-  message: string;
-  /**
-   * Optional structured error context.
-   */
-  details?: {
-    [k: string]: unknown | undefined;
-  };
-  extensions: ExtensionMap;
-}
-/**
- * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
- */
-export interface ExtensionMap2 {
-  [k: string]:
-    | {
-        [k: string]: unknown | undefined;
-      }
-    | undefined;
-}

package/src/generated/ops/check-request.ts

@@ -1,165 +0,0 @@
-/**
- * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
- * Source: schemas/
- * Generated by: pnpm run codegen
- */
-
-/**
- * Run checker(s) over a scope; returns Finding(s).
- */
-export interface CheckRequest {
-  scope: Scope;
-  /**
-   * Opaque rule ids or URIs. Resolved by receiver when not overridden by rules[].
-   */
-  rule_refs?: string[];
-  /**
-   * Optional embedded Rule objects for portable interchange.
-   */
-  rules?: Rule[];
-  /**
-   * Optional checker kind filters.
-   */
-  checker_kinds?: string[];
-  extensions?: ExtensionMap1;
-}
-/**
- * Checker scope selector.
- */
-export interface Scope {
-  /**
-   * Protocol-neutral opaque selector. Products map World/Book/chapter/manuscript ids via adapters or op extensions.
-   */
-  scope_id: string;
-  /**
-   * Optional narrow scope to explicit KnowledgeEntries.
-   */
-  entry_ids?: string[];
-  /**
-   * Optional filter by open entry_type vocabulary.
-   */
-  entry_types?: string[];
-  /**
-   * Optional narrow scope to explicit L5 TimelineEvent ids.
-   */
-  timeline_event_ids?: string[];
-  /**
-   * Optional provenance or manuscript locator scope.
-   */
-  source_id?: string;
-  /**
-   * Optional L5 tier filter (brief, narrative, moment).
-   */
-  timeline_scale?: string;
-  /**
-   * Optional L5 branch filter — strict equality on TimelineEvent.fork_id (l5-fork).
-   */
-  fork_id?: string;
-}
-/**
- * Declarative constraint input to check — never checker output.
- */
-export interface Rule {
-  /**
-   * Wire schema version (integer >= 1).
-   */
-  schema_version: number;
-  /**
-   * Stable rule id (opaque to protocol).
-   */
-  rule_id: string;
-  /**
-   * Human-stable name.
-   */
-  canonical_name: string;
-  /**
-   * Open string. Core vocabulary (documented, not enforced): rule, prohibition, style.
-   */
-  kind: string;
-  /**
-   * Declarative constraint text (human- or machine-readable; products choose grammar).
-   */
-  statement?: string;
-  /**
-   * Longer explanation for integrators or authors.
-   */
-  description?: string;
-  /**
-   * Optional ontology filter — open strings matching KnowledgeEntry entry_type vocabulary.
-   */
-  target_entry_types?: string[];
-  /**
-   * Optional checker hint. Core vocabulary (documented, not enforced): info, warning, error.
-   */
-  severity_hint?: string;
-  source_anchor?: SourceAnchor;
-  /**
-   * Open string. Core vocabulary (documented, not enforced): draft, active, deprecated.
-   */
-  status?: string;
-  /**
-   * RFC 3339 UTC datetime string.
-   */
-  created_at?: string;
-  /**
-   * RFC 3339 UTC datetime string.
-   */
-  updated_at?: string;
-  extensions: ExtensionMap;
-}
-/**
- * Optional provenance pointer when rule is anchored to manuscript.
- */
-export interface SourceAnchor {
-  /**
-   * Wire schema version (integer >= 1).
-   */
-  schema_version: number;
-  /**
-   * Opaque source locator; products define grammar.
-   */
-  source_id: string;
-  span?: SourceSpan;
-  /**
-   * Optional human label for the anchor.
-   */
-  label?: string;
-  /**
-   * Optional MIME type of the referenced source.
-   */
-  mime_type?: string;
-  extensions: ExtensionMap;
-}
-/**
- * Optional byte or character span within the source.
- */
-export interface SourceSpan {
-  /**
-   * Start offset (inclusive).
-   */
-  start: number;
-  /**
-   * End offset (exclusive).
-   */
-  end: number;
-}
-/**
- * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
- */
-export interface ExtensionMap {
-  [k: string]:
-    | {
-        [k: string]: unknown | undefined;
-      }
-    | undefined;
-}
-/**
- * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
- */
-export interface ExtensionMap1 {
-  [k: string]:
-    | {
-        [k: string]: unknown | undefined;
-      }
-    | undefined;
-}

package/src/generated/ops/check-response.ts

@@ -1,165 +0,0 @@
-/**
- * AUTO-GENERATED FROM JSON SCHEMA - DO NOT MODIFY
- * Source: schemas/
- * Generated by: pnpm run codegen
- */
-
-/**
- * Checker findings or wire error. Use findings OR error — not both.
- */
-export type CheckResponse =
-  | {
-      /**
-       * Success: checker output findings.
-       */
-      findings: Finding[];
-      extensions?: ExtensionMap1;
-    }
-  | {
-      error: ErrorEnvelope;
-      extensions?: ExtensionMap2;
-    };
-
-/**
- * Checker output — not a KnowledgeEntry body.
- */
-export interface Finding {
-  /**
-   * Wire schema version (integer >= 1).
-   */
-  schema_version: number;
-  /**
-   * Stable finding id.
-   */
-  finding_id: string;
-  /**
-   * Open string. Core vocabulary (documented, not enforced): info, warning, error.
-   */
-  severity: string;
-  /**
-   * Open string. Core vocabulary (documented, not enforced): open, resolved, dismissed.
-   */
-  status: string;
-  /**
-   * Short finding title.
-   */
-  title: string;
-  /**
-   * Finding detail text.
-   */
-  description: string;
-  /**
-   * Optional checker kind or category.
-   */
-  kind?: string;
-  /**
-   * Optional KnowledgeEntry the finding targets.
-   */
-  target_entry_id?: string;
-  source_anchor?: SourceAnchor;
-  /**
-   * Optional suggested remediation text.
-   */
-  suggested_fix?: string;
-  /**
-   * Optional position hint within source text.
-   */
-  text_position?: {
-    [k: string]: unknown | undefined;
-  };
-  /**
-   * RFC 3339 UTC datetime string.
-   */
-  created_at?: string;
-  /**
-   * RFC 3339 UTC datetime string.
-   */
-  updated_at?: string;
-  extensions: ExtensionMap;
-}
-/**
- * Optional provenance pointer.
- */
-export interface SourceAnchor {
-  /**
-   * Wire schema version (integer >= 1).
-   */
-  schema_version: number;
-  /**
-   * Opaque source locator; products define grammar.
-   */
-  source_id: string;
-  span?: SourceSpan;
-  /**
-   * Optional human label for the anchor.
-   */
-  label?: string;
-  /**
-   * Optional MIME type of the referenced source.
-   */
-  mime_type?: string;
-  extensions: ExtensionMap;
-}
-/**
- * Optional byte or character span within the source.
- */
-export interface SourceSpan {
-  /**
-   * Start offset (inclusive).
-   */
-  start: number;
-  /**
-   * End offset (exclusive).
-   */
-  end: number;
-}
-/**
- * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
- */
-export interface ExtensionMap {
-  [k: string]:
-    | {
-        [k: string]: unknown | undefined;
-      }
-    | undefined;
-}
-/**
- * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
- */
-export interface ExtensionMap1 {
-  [k: string]:
-    | {
-        [k: string]: unknown | undefined;
-      }
-    | undefined;
-}
-/**
- * Failure: shared error envelope.
- */
-export interface ErrorEnvelope {
-  /**
-   * Machine-readable error code.
-   */
-  code: string;
-  /**
-   * Human-readable error message.
-   */
-  message: string;
-  /**
-   * Optional structured error context.
-   */
-  details?: {
-    [k: string]: unknown | undefined;
-  };
-  extensions: ExtensionMap;
-}
-/**
- * Product namespace bag keyed by product-chosen ids matching ^[a-z][a-z0-9_-]*$. Values are opaque JSON objects. Adapters MUST preserve unknown namespaces and keys on round-trip.
- */
-export interface ExtensionMap2 {
-  [k: string]:
-    | {
-        [k: string]: unknown | undefined;
-      }
-    | undefined;
-}