@synapsor/runner 0.1.15 → 1.0.0
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.
- package/CHANGELOG.md +48 -0
- package/README.md +25 -2
- package/dist/cli.d.ts.map +1 -1
- package/dist/runner.mjs +3796 -1063
- package/docs/README.md +4 -0
- package/docs/capability-authoring.md +5 -0
- package/docs/conformance.md +8 -0
- package/docs/current-scope.md +2 -2
- package/docs/doctor.md +3 -3
- package/docs/dsl-reference.md +215 -0
- package/docs/http-mcp.md +41 -0
- package/docs/limitations.md +2 -1
- package/docs/oss-vs-cloud.md +3 -2
- package/docs/production.md +178 -9
- package/docs/release-notes.md +52 -9
- package/docs/release-policy.md +37 -6
- package/docs/runner-config-reference.md +299 -0
- package/docs/security-boundary.md +5 -5
- package/docs/store-lifecycle.md +38 -0
- package/docs/writeback-executors.md +3 -3
- package/examples/mcp-postgres-billing-app-handler/schema.sql +11 -1
- package/examples/reference-support-billing-app/schema.sql +11 -1
- package/examples/support-billing-agent/db/schema.sql +11 -1
- package/examples/support-plan-credit/README.md +16 -1
- package/examples/support-plan-credit/contract.synapsor.sql +2 -0
- package/examples/support-plan-credit/seed/001_seed.sql +11 -1
- package/examples/support-plan-credit/synapsor.contract.json +15 -0
- package/package.json +1 -1
- package/schemas/synapsor.runner.schema.json +216 -3
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,52 @@
|
|
|
2
2
|
|
|
3
3
|
## Unreleased
|
|
4
4
|
|
|
5
|
+
## 1.0.0
|
|
6
|
+
|
|
7
|
+
### Production Approval Loop
|
|
8
|
+
|
|
9
|
+
- Adds `apply --all-approved --yes` with per-proposal results, conflict
|
|
10
|
+
isolation, idempotent reruns, and `--capability`, `--tenant`, and `--max`
|
|
11
|
+
filters.
|
|
12
|
+
- Adds canonical aggregate auto-approval limits in `@synapsor/spec`, DSL
|
|
13
|
+
`LIMIT` clauses, reviewer-visible limit trip events, and doctor/tool preview
|
|
14
|
+
surfacing.
|
|
15
|
+
- Adds signed operator identity checks for approve/reject/apply while keeping
|
|
16
|
+
dev env identity available for local experiments.
|
|
17
|
+
- Adds structured operational logs, per-tenant/capability counters, supervised
|
|
18
|
+
writeback worker retries/dead letters, and continued owner-only local store
|
|
19
|
+
permission tests.
|
|
20
|
+
- Adds Postgres shared ledger support, runtime-store mode, per-session
|
|
21
|
+
HTTP-claims trusted context, managed secret hydration, token rotation hooks,
|
|
22
|
+
and Streamable HTTP mTLS.
|
|
23
|
+
- Declares the first semver contract for the documented CLI, schema, contract,
|
|
24
|
+
MCP result, writeback, approval, metrics, and replay surfaces.
|
|
25
|
+
- Stages `@synapsor/spec@1.0.0`, `@synapsor/dsl@1.0.0`, and
|
|
26
|
+
`@synapsor/runner@1.0.0`.
|
|
27
|
+
|
|
28
|
+
## 0.1.16
|
|
29
|
+
|
|
30
|
+
### Fleet-Lab Runner Hardening
|
|
31
|
+
|
|
32
|
+
- Preserves native Postgres timestamp precision from scoped reads through
|
|
33
|
+
evidence, proposals, conflict guards, and guarded writeback.
|
|
34
|
+
- Keeps conflicts immutable and inspectable while allowing a freshly based
|
|
35
|
+
successor proposal for the same object.
|
|
36
|
+
- Returns `PROPOSAL_ALREADY_EXISTS` with the active proposal id/state instead
|
|
37
|
+
of a generic `INTERNAL` error, and emits a matching structured log event.
|
|
38
|
+
- Rejects DSL `LOOKUP ... BY` columns that differ from the declared primary key
|
|
39
|
+
instead of silently changing contract meaning.
|
|
40
|
+
- Uses administrator-created receipt tables with least-privilege steady-state
|
|
41
|
+
writer grants; doctor/apply no longer require schema `CREATE`.
|
|
42
|
+
- Aligns audit contract-path resolution, Runner JSON Schema, owner-only local
|
|
43
|
+
store permissions, CLI help, and reference documentation with runtime
|
|
44
|
+
behavior.
|
|
45
|
+
- Stages `@synapsor/dsl@0.1.6` and `@synapsor/runner@0.1.16`;
|
|
46
|
+
`@synapsor/spec` remains `0.1.4` because canonical contract semantics did not
|
|
47
|
+
change.
|
|
48
|
+
|
|
49
|
+
## 0.1.15
|
|
50
|
+
|
|
5
51
|
### Editor-Friendly DSL Source Files
|
|
6
52
|
|
|
7
53
|
- Prefers `.synapsor.sql` for DSL source files so editors can provide generic
|
|
@@ -9,6 +55,8 @@
|
|
|
9
55
|
- Keeps DSL semantics, Runner behavior, and generated canonical JSON unchanged.
|
|
10
56
|
- Stages `@synapsor/dsl@0.1.5` and `@synapsor/runner@0.1.15`.
|
|
11
57
|
|
|
58
|
+
## 0.1.14
|
|
59
|
+
|
|
12
60
|
### README Path Polish
|
|
13
61
|
|
|
14
62
|
- Makes the audit, demo, and staging-database adoption sequence explicit for
|
package/README.md
CHANGED
|
@@ -146,6 +146,22 @@ least-privilege database access, host security, or application authorization.
|
|
|
146
146
|
See [Security Boundary](docs/security-boundary.md) and
|
|
147
147
|
[Current Limitations](docs/limitations.md).
|
|
148
148
|
|
|
149
|
+
## Operate The Approval Loop
|
|
150
|
+
|
|
151
|
+
Reviewed policies can combine a per-proposal threshold with daily count and
|
|
152
|
+
total ceilings. Exceeding a ceiling routes that proposal to human review; it
|
|
153
|
+
never auto-applies. Operators can apply the bounded approved queue independently
|
|
154
|
+
with `apply --all-approved --yes`, inspect Prometheus counters with `metrics
|
|
155
|
+
show`, and consume safe newline-delimited JSON outcome logs from stderr. Signed
|
|
156
|
+
operator keys can enforce contract reviewer roles and separate apply roles.
|
|
157
|
+
Shared Postgres ledger mirror mode is available for bounded operator handoffs,
|
|
158
|
+
and `storage.shared_postgres.mode = "runtime_store"` lets MCP serving use
|
|
159
|
+
Postgres as the primary proposal/evidence/replay store with bounded CLI
|
|
160
|
+
approval/apply/worker commands bridged through the same ledger. Local SQLite
|
|
161
|
+
remains the default. See
|
|
162
|
+
[Production](docs/production.md) and the
|
|
163
|
+
[Runner Config Reference](docs/runner-config-reference.md).
|
|
164
|
+
|
|
149
165
|
## Packages
|
|
150
166
|
|
|
151
167
|
| Package | Purpose |
|
|
@@ -160,11 +176,18 @@ with [Capability Authoring](docs/capability-authoring.md). Use `.synapsor.sql`
|
|
|
160
176
|
for DSL source files when you want editors to provide generic SQL highlighting;
|
|
161
177
|
legacy `.synapsor` files remain supported and produce the same contract JSON.
|
|
162
178
|
|
|
179
|
+
Use the [DSL Reference](docs/dsl-reference.md) for exact authoring grammar and
|
|
180
|
+
the [Runner Config Reference](docs/runner-config-reference.md) for every wiring
|
|
181
|
+
key, default, and path-resolution rule. The
|
|
182
|
+
[Store Lifecycle guide](docs/store-lifecycle.md) explains ledger sensitivity,
|
|
183
|
+
owner-only permissions, inspection commands, and retention.
|
|
184
|
+
|
|
163
185
|
## OSS And Cloud
|
|
164
186
|
|
|
165
187
|
Synapsor Runner works by itself for local and single-node deployments: your
|
|
166
|
-
database remains the source of truth and
|
|
167
|
-
|
|
188
|
+
database remains the source of truth and Runner stores review artifacts in the
|
|
189
|
+
default local SQLite ledger or an opt-in shared Postgres runtime store.
|
|
190
|
+
Synapsor Cloud adds a shared contract registry, immutable versions,
|
|
168
191
|
downloadable Runner bundles, and team activity, evidence, and approval
|
|
169
192
|
surfaces. See [OSS Runner vs Synapsor Cloud](docs/oss-vs-cloud.md) for the
|
|
170
193
|
detailed boundary.
|
package/dist/cli.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAYA,OAAO,EAAoP,KAAK,WAAW,
|
|
1
|
+
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAYA,OAAO,EAAoP,KAAK,WAAW,EAA0H,MAAM,6BAA6B,CAAC;AAuBza,OAAO,EAA6G,KAAK,YAAY,EAAwB,MAAM,2BAA2B,CAAC;AAE/L,OAAO,EAOL,KAAK,gBAAgB,EAEtB,MAAM,mCAAmC,CAAC;AAmV3C,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA4D1D;AA0FD,KAAK,SAAS,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE9E,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE;IACP,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;CACvC,GACL,OAAO,CAAC,MAAM,CAAC,CA2TjB;AA+gFD,wBAAsB,0BAA0B,CAAC,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAS/H"}
|