@axiastudio/aioc 0.1.0-beta.4 → 0.1.0-beta.6

package/README.md

@@ -2,9 +2,9 @@
 
 AIOC is a governance-first SDK for LLM agents: models can propose actions, while deterministic policies and runtime controls enforce decisions.
 It provides default-deny gates for tools and handoffs, end-to-end auditability (run records, prompt snapshots, request fingerprints), and a foundation for verifiable iteration on prompts and policies.
-AIOC is designed for enterprise and public-sector contexts with privacy-by-design and AI Act-aligned governance requirements.
+AIOC is designed for enterprise and public-sector contexts with privacy-by-design and high-accountability (AI Act-style) governance requirements.
 
-Project home: [https://github.com/axiastudio/aioc](https://github.com/axiastudio/aioc)
+Project home and documentation: [https://github.com/axiastudio/aioc](https://github.com/axiastudio/aioc)
 
 ## Release Status
 
@@ -15,6 +15,18 @@ Breaking changes may occur before a stable release.
 - Alpha contract (historical): `docs/ALPHA-CONTRACT.md`
 - Privacy baseline: `docs/PRIVACY-BASELINE.md`
 
+## Documentation Site
+
+This repository also contains `aioc-docs`, a Starlight documentation app:
+
+- app path: `apps/aioc-docs`
+- source of truth for normative documents: `docs/`
+- GitHub Pages target: `https://axiastudio.github.io/aioc/`
+- start locally: `npm run docs:dev`
+- build statically: `npm run docs:build`
+
+The root `docs:*` commands intentionally invoke the app from inside `apps/aioc-docs` so it can use its own Node toolchain.
+
 ## Contact
 
 If you want to collaborate or provide feedback, write to `tiziano.lattisi@axia.studio`.
@@ -156,6 +168,21 @@ console.log(replay.replayStats);
 
 `replayFromRunRecord(...)` does not bypass policy enforcement: in `strict` and `hybrid`, provide `runOptions.policies` when tool/handoff execution must be authorized.
 
+## Reference UI Example
+
+This repository also contains `aioc-inspect`, a private reference example UI for visual `RunRecord` analysis:
+
+- path: `apps/aioc-inspect`
+- public sample files: `apps/aioc-inspect/public/samples`
+- regenerate samples: `npm run inspect:samples`
+- purpose: show one possible way to inspect, navigate, and compare `RunRecord` artifacts visually
+- scope: experimental, stateless, session-only
+- positioning: example application for implementors, not a hosted service or production console
+
+`aioc-inspect` exists to demonstrate the value of the `RunRecord` contract. It should be read as one possible interpretation of the data model, not as the only intended UI for `aioc`.
+
+![aioc-inspect: reference UI for visual RunRecord analysis](apps/aioc-inspect/docs/aioc-inspect-overview.png)
+
 ## Examples
 
 | Command | Purpose | Needs API key |
@@ -192,14 +219,22 @@ AIOC adopts the following non-negotiable principles:
 - **Bias and misalignment control**: continuous monitoring, dedicated tests, and clear mitigation/escalation mechanisms.
 - **Privacy by design and data minimization**: collect and process only what is strictly necessary, protect sensitive data by default (redaction, encryption, retention limits), and provide auditable controls for access and deletion.
 
-## Governance References
+## Current Governance Documents
+
+- `docs/RFC-0001-governance-first-runtime.md` (`Accepted`)
+- `docs/RFC-0002-policy-gates-for-tools-and-handoffs.md` (`Accepted`)
+- `docs/RFC-0003-run-record-audit-trail-and-persistence.md` (`Accepted`)
+- `docs/RFC-0004-policy-outcomes-and-approval-model.md` (`Draft`)
+- `docs/RFC-0005-suspended-proposals-and-approval-lifecycle.md` (`Draft`)
+- `docs/PRIVACY-BASELINE.md`
+
+## Historical Snapshots
 
-- `docs/RFC-0001-governance-first-runtime.md`
-- `docs/RFC-0002-policy-gates-for-tools-and-handoffs.md`
-- `docs/RFC-0003-run-record-audit-trail-and-persistence.md`
 - `docs/ALPHA-CONTRACT.md`
 - `docs/BETA-CONTRACT.md`
-- `docs/PRIVACY-BASELINE.md`
+- `docs/BETA-CONTRACT-AUDIT.md`
+- `docs/P0-TRIAGE.md`
+- `docs/PRIVACY-ADOPTION.md`
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@axiastudio/aioc",
-  "version": "0.1.0-beta.4",
+  "version": "0.1.0-beta.6",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
@@ -25,6 +25,11 @@
     "example:rru:03-replay-strict": "tsx src/examples/run-record-utils-minimal/03-replay-strict.ts",
     "example:rru:04-replay-hybrid": "tsx src/examples/run-record-utils-minimal/04-replay-hybrid.ts",
     "example:non-regression": "tsx src/examples/non-regression/v1-v2-runrecord-diff.ts",
+    "inspect:samples": "tsx scripts/generate-aioc-inspect-samples.ts",
+    "docs:sync": "node scripts/sync-aioc-docs.mjs",
+    "docs:dev": "npm run docs:sync && cd apps/aioc-docs && zsh -lc 'npm run dev'",
+    "docs:build": "npm run docs:sync && cd apps/aioc-docs && zsh -lc 'npm run build'",
+    "docs:preview": "cd apps/aioc-docs && zsh -lc 'npm run preview'",
     "test:mistral": "tsx src/examples/mistral-smoke.ts",
     "prepack": "npm run build:package"
   },
@@ -54,7 +59,7 @@
   "bugs": {
     "url": "https://github.com/axiastudio/aioc/issues"
   },
-  "homepage": "https://github.com/axiastudio/aioc",
+  "homepage": "https://axiastudio.github.io/aioc",
   "publishConfig": {
     "access": "public",
     "tag": "latest"