feat: reorganize schemas into schemas/ directory with shared refs and registry loading

- Create schemas/_shared.json with common $defs (status, priority, assessment,
  wikilink, title, content, summary, baseNodeProps, ostEntityProps)
- Create schemas/general.json referencing shared defs via ost-tools:// URIs
- Remove top-level schema.json (superseded by schemas/general.json)
- Add space-level schema field to SpaceConfig and config schema validation
- resolveSchema now checks CLI arg > space schema > global schema > default
- Default schema path updated from schema.json to schemas/general.json
- createValidator uses AJV registry: all peer schemas in schemas/ are registered
  so cross-file $refs resolve transitively without custom bundling
- loadSchema bundles for template-sync (one-level merge + ref rewrite); full
  registry-aware traversal deferred to #15 alongside strict_ost schema work

Author: mindsocket

CLAUDE.md

@@ -24,7 +24,7 @@ Before starting new work, review [docs/concepts.md](docs/concepts.md) for canoni
 ## Key Files
 
 - `config.json` — Space registry (alias → absolute path)
-- `schema.json` — Entity type definitions and validation rules
+- `schemas/` — Schema files; composable
 
 ## Testing
 

README.md

@@ -39,33 +39,32 @@ bun run src/index.ts validate personal
       "miroFrameId": "3458764123456789"
     }
   ],
-  "schema": "/path/to/custom/schema.json",
+  "schema": "/path/to/custom/schemas/my-schema.json",
   "templateDir": "/path/to/Templates"
 }
 ```
 
 - `miroBoardId` / `miroFrameId` — required for `miro-sync` (frame ID is auto-saved after `--new-frame`)
-- `schema` — overrides default schema path (`schema.json`). CLI `--schema` takes precedence
+- `schema` — overrides schema path
 - `templateDir` — default template directory for `template-sync` (can omit the CLI argument)
 
 ## Usage
 
 ### Validate OST nodes
 
 ```bash
-bun run src/index.ts validate <space-or-dir> [--schema path/to/schema.json]
+bun run src/index.ts validate <space-or-dir> [--schema path/to/my-schema.json]
 ```
 
 Validates markdown files against the OST JSON schema:
 - Extracts YAML frontmatter from each `.md` file
 - Skips files without frontmatter or without a `type` field
-- Validates against the resolved schema (CLI `--schema` > `config.schema` > `schema.json`)
 - Reports validation results with counts and per-file errors
 
 ### Generate Mermaid diagram
 
 ```bash
-bun run src/index.ts diagram <space-or-dir> [--output path/to/output.mmd] [--schema path/to/schema.json]
+bun run src/index.ts diagram <space-or-dir> [--output path/to/output.mmd] [--schema path/to/my-schema.json]
 ```
 
 Generates Mermaid `graph TD` diagram from validated OST nodes:
@@ -93,7 +92,7 @@ Sync is one-way (OST → Miro) and scoped to a single frame. Only cards and conn
 ### Sync templates with schema
 
 ```bash
-bun run src/index.ts template-sync [template-dir] [--schema path/to/schema.json] [--dry-run]
+bun run src/index.ts template-sync [template-dir] [--schema path/to/my-schema.json] [--dry-run]
 ```
 
 Keeps Obsidian template files in sync with schema examples:
@@ -124,7 +123,9 @@ bun run test:all
 
 ## Schema
 
-The `schema.json` file contains the OST JSON Schema definition for validating node frontmatter.
+Schema files and composable parts of schemas live in `schemas/`. Additional schemas can be added and selected per-space or globally via `config.json`.
+
+Schema resolution order: (CLI `--schema` argument > space config `schema` > global config `schema` > `schemas/general.json` default)
 
 ## License
 

package.json

@@ -1,6 +1,6 @@
 {
   "name": "ost-tools",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "module": "src/index.ts",
   "type": "module",
   "private": true,

schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "ost-tools://_shared",
+  "description": "Shared definitions referenced by OST schema files",
+  "$defs": {
+    "title": {
+      "type": "string",
+      "description": "Title of the node (derived from filename at validation time)"
+    },
+    "content": {
+      "type": "string",
+      "description": "Body content of the document (excluding frontmatter)"
+    },
+    "summary": {
+      "type": "string",
+      "description": "Short summary of the node"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["identified", "wondering", "exploring", "active", "paused", "completed", "archived"]
+    },
+    "priority": {
+      "type": "string",
+      "enum": ["p1", "p2", "p3", "p4"]
+    },
+    "assessment": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 5,
+      "description": "Assessment score from 1-5"
+    },
+    "wikilink": {
+      "type": "string",
+      "pattern": "^\\[\\[.+\\]\\]$",
+      "description": "An Obsidian wikilink, e.g. [[Parent Node]]"
+    },
+    "baseNodeProps": {
+      "type": "object",
+      "properties": {
+        "title": { "$ref": "#/$defs/title" },
+        "content": { "$ref": "#/$defs/content" },
+        "tags": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Categorization tags"
+        }
+      },
+      "required": ["title"]
+    },
+    "ostEntityProps": {
+      "type": "object",
+      "properties": {
+        "status": { "$ref": "#/$defs/status" },
+        "summary": { "$ref": "#/$defs/summary" },
+        "status_tweet": {
+          "type": "string",
+          "description": "Succinct free-text status summary"
+        }
+      },
+      "required": ["status"]
+    }
+  }
+}