@axiastudio/aioc 0.1.0-alpha.5 → 0.1.0-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +21 -0
  2. package/package.json +6 -4
package/README.md CHANGED
@@ -11,6 +11,8 @@ Project home: [https://github.com/axiastudio/aioc](https://github.com/axiastudio
11
11
  This package is currently in alpha and is not production-ready.
12
12
  Breaking changes may occur before a stable release.
13
13
  Alpha contract reference: `docs/ALPHA-CONTRACT.md`.
14
+ Pre-beta contract freeze reference: `docs/BETA-CONTRACT.md`.
15
+ Privacy baseline reference: `docs/PRIVACY-BASELINE.md`.
14
16
 
15
17
  ## Contact
16
18
 
@@ -33,6 +35,12 @@ Governance implementation reference:
33
35
  - `docs/RFC-0002-policy-gates-for-tools-and-handoffs.md`
34
36
  - `docs/RFC-0003-run-record-audit-trail-and-persistence.md`
35
37
  - `docs/ALPHA-CONTRACT.md`
38
+ - `docs/BETA-CONTRACT.md`
39
+ - `docs/PRIVACY-BASELINE.md`
40
+
41
+ Canonical examples reference:
42
+
43
+ - `docs/CANONICAL-EXAMPLES.md`
36
44
 
37
45
  ## Goals of this first scaffold
38
46
 
@@ -78,6 +86,12 @@ Run record metadata convention:
78
86
 
79
87
  - `record.metadata.appBuildVersion` is a recommended field to correlate run drift with application-layer source/build changes.
80
88
 
89
+ Privacy baseline highlights:
90
+
91
+ - `record.includePromptText` defaults to `false` and should remain disabled unless explicitly required.
92
+ - `record.contextRedactor` should be considered mandatory for production run-record persistence.
93
+ - sink adapters should implement encryption, access controls, retention, and deletion policies.
94
+
81
95
  ## Test Commands
82
96
 
83
97
  - `npm run test:unit`
@@ -85,6 +99,13 @@ Run record metadata convention:
85
99
  - `npm run test:regression`
86
100
  - `npm run test:ci`
87
101
 
102
+ ## Canonical Examples
103
+
104
+ - `npm run example:hello` (minimal single-agent run)
105
+ - `npm run example:tool-policy` (tool calls with deterministic policy gate)
106
+ - `npm run example:run-record` (run record persistence with redaction + audit)
107
+ - `npm run example:non-regression` (advanced v1/v2 run-record diff)
108
+
88
109
  ## Python Alpha Port
89
110
 
90
111
  Python runtime is available under `py/` (Python 3.11+), with governance-first parity against core TS semantics:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@axiastudio/aioc",
3
- "version": "0.1.0-alpha.5",
3
+ "version": "0.1.0-beta.1",
4
4
  "main": "dist/index.js",
5
5
  "types": "dist/index.d.ts",
6
6
  "files": [
@@ -16,9 +16,11 @@
16
16
  "test:integration": "npm run build && node dist/tests/integration/index.js",
17
17
  "test:regression": "npm run build && node dist/tests/regression/index.js",
18
18
  "test:ci": "npm run lint && npm run build && node dist/tests/unit/index.js && node dist/tests/integration/index.js && node dist/tests/regression/index.js",
19
- "example:hello-world": "tsx src/examples/basic/hello-world.ts",
20
- "example:tools": "tsx src/examples/basic/tools.ts",
21
- "example:run-record-sink": "tsx src/examples/basic/run-record-sink.ts",
19
+ "test:ci:stability": "npm run test:ci && npm run test:ci",
20
+ "example:hello": "tsx src/examples/basic/hello-world.ts",
21
+ "example:tool-policy": "tsx src/examples/basic/tools.ts",
22
+ "example:run-record": "tsx src/examples/basic/run-record-sink.ts",
23
+ "example:non-regression": "tsx src/examples/non-regression/v1-v2-runrecord-diff.ts",
22
24
  "test:mistral": "tsx src/examples/mistral-smoke.ts",
23
25
  "test:guardrail": "tsx src/examples/guardrail-smoke.ts",
24
26
  "test:policy": "tsx src/examples/policy-smoke.ts",