Support Spine Time validation options

.codex/agents/documentation-reviewer.toml

@@ -0,0 +1,12 @@
+name = "documentation_reviewer"
+description = "Checks changed documentation and examples against implemented behavior."
+model = "gpt-5.6-terra"
+model_reasoning_effort = "medium"
+sandbox_mode = "read-only"
+
+developer_instructions = """
+Review only documentation affected by the milestone. Verify status, workflow,
+links, examples, limitations, and claims against implemented behavior. Flag
+concrete omissions or contradictions, not unrelated prose preferences. Do not
+edit files or spawn subagents.
+"""

.codex/agents/implementer.toml

@@ -0,0 +1,13 @@
+name = "implementer"
+description = "Owns one bounded TypeScript implementation or correction batch."
+model = "gpt-5.6-terra"
+model_reasoning_effort = "medium"
+
+developer_instructions = """
+Own one bounded milestone and only its assigned files. Use behavior-focused TDD
+for runtime changes, preserve immutable vendored Proto files, run focused
+checks, and update durable logs at resumability boundaries. Follow the approved
+plan and established architecture unless a concrete blocker is proven. Do not
+spawn subagents. Reuse the same context for an aggregated correction batch when
+possible.
+"""

.codex/agents/performance-reliability-reviewer.toml

@@ -0,0 +1,12 @@
+name = "performance_reliability_reviewer"
+description = "Reviews changed runtime and build paths for reliability and bounded-resource behavior."
+model = "gpt-5.6-terra"
+model_reasoning_effort = "high"
+sandbox_mode = "read-only"
+
+developer_instructions = """
+Review only changed execution paths and immediate invariants. Prioritize
+failure cleanup, deterministic generation, recursion and resource bounds,
+regular-expression safety, lifecycle behavior, and missing behavior tests.
+Avoid speculative optimization. Do not edit files or spawn subagents.
+"""

.codex/agents/requirements-splitter.toml

@@ -0,0 +1,13 @@
+name = "requirements_splitter"
+description = "Splits architecture-significant validation milestones into small ordered tasks."
+model = "gpt-5.6-sol"
+model_reasoning_effort = "high"
+sandbox_mode = "read-only"
+
+developer_instructions = """
+Work read-only unless the orchestrator explicitly assigns durable planning
+files. Split only public or serialized contracts, validation semantics, new
+subsystems, security boundaries, or demonstrated architectural blockers.
+Return ordered slices, acceptance criteria, risks, ownership, and exclusions.
+Do not plan ordinary fixes and do not spawn subagents.
+"""

.codex/agents/security-reviewer.toml

@@ -0,0 +1,13 @@
+name = "security_reviewer"
+description = "Performs the final release-readiness security review or an explicitly requested early review."
+model = "gpt-5.6-terra"
+model_reasoning_effort = "high"
+sandbox_mode = "read-only"
+
+developer_instructions = """
+Review the authorized scope for concrete TypeScript and Node.js trust-boundary
+defects, including unsafe validation, regular-expression denial of service,
+dependency and publishing risk, generated source integrity, and sensitive
+logging. Run at release readiness or when explicitly requested. Do not edit
+files, broaden scope, or spawn subagents.
+"""

.codex/agents/style-maintainability-reviewer.toml

@@ -0,0 +1,12 @@
+name = "style_maintainability_reviewer"
+description = "Reviews changed code and tests for concrete maintainability and correctness defects."
+model = "gpt-5.6-terra"
+model_reasoning_effort = "high"
+sandbox_mode = "read-only"
+
+developer_instructions = """
+Review only the assigned diff and affected execution paths. Prioritize
+correctness, ownership, naming, duplication, test quality, and maintainability
+over preferences. Check the task requirements ledger and repository standards.
+Do not edit files, repeat evidenced broad suites, or spawn subagents.
+"""

.codex/agents/typescript-api-reviewer.toml

@@ -0,0 +1,12 @@
+name = "typescript_api_reviewer"
+description = "Reviews TypeScript public API, package metadata, declarations, and Proto compatibility."
+model = "gpt-5.6-terra"
+model_reasoning_effort = "high"
+sandbox_mode = "read-only"
+
+developer_instructions = """
+Review changed public and package-internal contracts, declarations, exports,
+TypeDoc, package metadata, Proto compatibility, and runtime/type agreement.
+Prioritize accidental public leaks, incompatible signatures, false type
+guarantees, and missing API documentation. Do not edit files or spawn subagents.
+"""

.codex/config.toml

@@ -0,0 +1,12 @@
+model = "gpt-5.6-sol"
+model_reasoning_effort = "medium"
+
+[features]
+fast_mode = false
+
+[agents]
+enabled = true
+max_concurrent_threads_per_session = 3
+default_subagent_model = "gpt-5.6-terra"
+default_subagent_reasoning_effort = "medium"
+interrupt_message = true

.github/workflows/build.yml

@@ -1,33 +1,71 @@
-name: Build and Test
+name: Verify
 
-on: push
+on:
+  push:
+    branches:
+      - dev
+      - master
+  pull_request:
 
 jobs:
-  build-and-test:
-    name: Build and Test
+  verify:
+    name: Full verification
     runs-on: ubuntu-latest
 
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Activate pnpm
+        uses: pnpm/action-setup@v6
+        with:
+          version: 11.9.0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version-file: .node-version
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Verify validation package and example
+        run: pnpm verify
+
+  compatibility:
+    name: Node.js ${{ matrix.node-version }} compatibility
+    runs-on: ubuntu-latest
     strategy:
       matrix:
-        node-version: [18.x, 20.x, 24.x]
+        node-version: [24.x]
 
     steps:
       - name: Checkout code
         uses: actions/checkout@v6
 
+      - name: Activate pnpm
+        uses: pnpm/action-setup@v6
+        with:
+          version: 11.9.0
+
       - name: Setup Node.js ${{ matrix.node-version }}
         uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node-version }}
+          cache: pnpm
 
       - name: Install dependencies
-        run: npm install
+        run: pnpm install --frozen-lockfile
+
+      - name: Build packages
+        run: pnpm build
 
-      - name: Build validation package
-        run: npm run build
+      - name: Run validation tests
+        run: pnpm test:validation
 
-      - name: Run tests
-        run: npm test
+      - name: Run example tests
+        run: pnpm test:example
 
-      - name: Build example
-        run: npm run example
+      - name: Run compiled example console adapter
+        run: pnpm example:run

.github/workflows/publish.yml

@@ -12,25 +12,31 @@ jobs:
     runs-on: ubuntu-latest
 
     permissions:
-      contents: read      # Read repository code
-      id-token: write     # Generate OIDC token for npm authentication
+      contents: read # Read repository code
+      id-token: write # Generate OIDC token for npm authentication
 
     steps:
       - name: Checkout code
         uses: actions/checkout@v6
 
+      - name: Activate pnpm
+        uses: pnpm/action-setup@v6
+        with:
+          version: 11.9.0
+
       - name: Setup Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: '24'
-          registry-url: 'https://registry.npmjs.org'
+          node-version-file: .node-version
+          cache: pnpm
+          registry-url: "https://registry.npmjs.org"
 
       - name: Install dependencies
-        run: npm install
+        run: pnpm install --frozen-lockfile
 
-      - name: Build validation package
-        run: npm run build --workspace=@spine-event-engine/validation-ts
+      - name: Verify release candidate
+        run: pnpm verify
 
       - name: Perform publishing to NPM registry
         # The version is still a `snapshot`, so NPM requires it to be tagged accordingly.
-        run: npm publish --workspace=@spine-event-engine/validation-ts --tag snapshot
+        run: pnpm --filter @spine-event-engine/validation publish --tag snapshot --no-git-checks

.gitignore

@@ -4,6 +4,8 @@ node_modules/
 # Build output
 dist/
 *.tsbuildinfo
+packages/validation/docs/api/reference/
+*.tgz
 
 # Generated code (Protobuf)
 src/generated/
@@ -39,14 +41,14 @@ pnpm-debug.log*
 *.tmp
 .cache/
 .temp/
+.superpowers/
+.worktrees/
 
 # Environment and local config
 .env
 .env.local
 .env.*.local
 .claude/settings.local.json
 
-# Package manager lock files (libraries should not commit lock files)
-package-lock.json
+# Lock state is committed at the workspace root for reproducible builds.
 yarn.lock
-pnpm-lock.yaml

.node-version

@@ -0,0 +1 @@
+24.18.0

.npmrc

@@ -0,0 +1 @@
+engine-strict=true

.prettierignore

@@ -0,0 +1,11 @@
+node_modules
+.worktrees
+*.code-workspace
+dist
+coverage
+packages/validation/docs/api/reference
+packages/*/src/generated
+packages/*/tests/generated
+packages/*/proto/spine
+packages/*/tests/proto/spine
+package-lock.json

.prettierrc.json

@@ -0,0 +1,6 @@
+{
+  "printWidth": 100,
+  "semi": true,
+  "singleQuote": false,
+  "trailingComma": "all"
+}