Skip to content

Commit 7489edb

Browse files
committed
chore(spec): 按 §10 四步 resync 重生成本 sweep 的两张参考页
PR #6224(#5553 / #6136)改了 build-docs 的模块描述行布局与裸路径链接改写, 并重写了全部参考页。本分支是后落地方,故按四步走:merge main → 重建 → check:generated 判定 → --fix 只重生成被证实陈旧的一项。 落点仍是本 sweep 的两张页(os-regen 合并驱动把它们记进 os-regen-pending): shared/expression.mdx 与 api/endpoint.mdx。新渲染器收掉了行间空行,方言表 因此首次渲染成一张真正的 markdown 表,而不是被空行拆散的六行。 内容核对:方言表 = cel / cron / template(无 js);endpoint 的 type / target / ApiMapping.transform 三行描述完整存活。 Co-authored-by: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_011M7UwH25Unfi73UHim7ajY
1 parent 7d37f24 commit 7489edb

2 files changed

Lines changed: 4 additions & 21 deletions

File tree

content/docs/references/api/endpoint.mdx

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,6 @@ description: Endpoint protocol schemas
66
{/* ⚠️ AUTO-GENERATED — DO NOT EDIT. Run build-docs.ts to regenerate. Hand-written docs live in the module folders under content/docs/. */}
77

88
API Mapping Schema
9-
109
Transform input/output data.
1110

1211
<Callout type="info">

content/docs/references/shared/expression.mdx

Lines changed: 4 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -8,47 +8,31 @@ description: Expression protocol schemas
88
# Expression Protocol
99

1010
Canonical wire format for all "expression"-shaped metadata across ObjectStack
11-
1211
(formula fields, predicates, conditions, criteria, visibility rules, seed
13-
1412
dynamic values, …).
1513

16-
The persisted form is `\{ dialect, source \}` (and, after `objectstack
17-
18-
compile` normalization, `\{ dialect, ast \}`). String-only shorthand is
19-
14+
The persisted form is `{ dialect, source }` (and, after `objectstack
15+
compile` normalization, `{ dialect, ast }`). String-only shorthand is
2016
accepted at *input* time for developer ergonomics; build emits the canonical
21-
2217
envelope.
2318

2419
## Dialects
2520

2621
| dialect | engine | use |
27-
2822
|:---|:---|:---|
29-
3023
| `cel` | `@objectstack/formula` (cel-js + ObjectStack stdlib) | formulas, predicates, seed dynamic values |
31-
3224
| `cron` | `cron-parser` | job schedules |
33-
34-
| `template` | `\{\{var\}\}` interpolation at evaluate time (same variable scope as CEL) | notification subjects/bodies, `titleFormat`, prompt templates |
25+
| `template` | `{{var}}` interpolation at evaluate time (same variable scope as CEL) | notification subjects/bodies, `titleFormat`, prompt templates |
3526

3627
Those three are the whole list — it is exactly the `ExpressionDialect` enum
37-
3828
below. Procedural JavaScript is **not** a dialect: it is the L2 authoring
39-
40-
surface, the sandboxed, capability-gated `ScriptBody \{ language: 'js' \}` in
41-
29+
surface, the sandboxed, capability-gated `ScriptBody { language: 'js' }` in
4230
hook/action bodies. A `js` row stood in this table long after the dialect was
43-
4431
retired in #3278 (ADR-0058 addendum); `ExpressionSchema` rejects
45-
4632
`dialect: 'js'`.
4733

4834
SQL fragments (analytics joins, partial indexes) are intentionally **not**
49-
5035
routed through this schema — they stay driver-native because their security
51-
5236
posture and portability story differ.
5337

5438
See also: content/docs/concepts/north-star.mdx §8 "No private expression DSL"

0 commit comments

Comments
 (0)