Skip to content

Reference: Release and Governance

This page is the governance index for release pipelines, docs delivery, and learning-platform quality controls.

1) Release Baseline and Scope

  • Historical release comparison reference:
  • v1.3.0..v1.6.0
  • 107 commits, 301 files changed
  • Current delivery context:
  • post-v1.7.0 evolution baseline with learning-platform contracts and runtime runbook endpoints

2) Canonical Release and Planning Documents

3) CI/CD Governance Workflows

  • Docs validation:
  • .github/workflows/docs-diataxis-site.yml
  • Docs publish:
  • .github/workflows/docs-github-pages-publish.yml
  • Desktop/mobile release build:
  • .github/workflows/release-desktop-multi-os.yml
  • Migration safety gates:
  • .github/workflows/migration-gates.yml
  • Operational readiness:
  • .github/workflows/fixrisk-operational-readiness.yml
  • npm publish policy gates:
  • .github/workflows/npm-publish.yml
  • Mobile contract checks:
  • .github/workflows/mobile-e2e-detox-contracts.yml

4) Learning Platform Governance Chain

Contract governance

  • Interface layer:
  • src/learning/api.ts
  • src/learning/types.ts
  • Route and normalization layer:
  • src/server.ts
  • Contract regression safety net:
  • src/knowledge.api.contract.test.ts

Runtime governance

  • Runtime capability matrix endpoint:
  • GET /api/knowledge/runtime-capability-matrix
  • Runtime runbook endpoints:
  • GET /api/knowledge/runtime-capability-runbook*
  • POST /api/knowledge/runtime-capability-runbook/remediation-event
  • Request diagnostics:
  • GET /api/runtime-request-trace

Quality governance

  • Learning quality endpoints:
  • POST /api/knowledge/quality/snapshot
  • GET /api/knowledge/quality/baseline?userId=<id>
  • POST /api/knowledge/quality/baseline
  • POST /api/knowledge/quality/baseline/clear
  • POST /api/knowledge/quality/baseline/evaluate
  • GET /api/knowledge/quality/history
  • GET /api/knowledge/quality/trend
  • GET /api/knowledge/quality/thresholds
  • Session strategy quality endpoints:
  • POST /api/knowledge/session/plan/evaluate
  • GET /api/knowledge/session/plan/quality/history
  • GET /api/knowledge/session/plan/quality/trend
  • GET /api/knowledge/session/plan/quality/thresholds/runtime

5) Docs Governance Controls

  • Mapping source of truth:
  • docs/diataxis-map.json
  • Mapping gate:
  • npm run docs:diataxis:check
  • Site build gate:
  • npm run docs:site:build
  • Local iterative docs maintenance:
  • npm run docs:site:serve
  • Deploy gate:
  • GitHub Actions workflow Docs GitHub Pages Publish

6) Local Release/Docs Verification Commands

# docs governance
npm run docs:diataxis:check
npm run docs:site:build

# API contract governance
npm test -- src/knowledge.api.contract.test.ts --runInBand

# broader migration and policy gates
npm run test:migration

7) Risk Posture (Current)

  • Stable:
  • docs build and mapping governance
  • API contract surface coverage
  • runtime runbook and diagnostics endpoints
  • Needs continued hardening:
  • graphdb backend depth (current graphdb mode still file-adapter backed)
  • independent vector retrieval backend integration
  • stricter promotion from trend observations to hard release quality gates