Skip to content

Commit 937f982

Browse files
committed
docs(metadata-protocol): narrow the scope lead-in sentence, per PM review
The lead-in sentence added in the previous commit said the section documents the function's "full internal surface" -- overclaiming: the JSDoc is also missing cli.mdx's flow-conflict-refused row, which IS internal to the function (not CLI-caller-dependent), so "full" did not hold. Narrowed the claim to what is actually demonstrated (the flow-no-engine bullet specifically), and pointed the residual scope-split question at the follow-up decision card (#9271) the PM filed for it, rather than implying this sentence explains every gap between the two lists. Fixes #9196
1 parent 6d95288 commit 937f982

1 file changed

Lines changed: 7 additions & 4 deletions

File tree

packages/metadata-protocol/src/protocol.ts

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13090,10 +13090,13 @@ export class ObjectStackProtocolImplementation implements
1309013090
*
1309113091
* ## What it declines to touch, and says so
1309213092
*
13093-
* This section documents the function's full internal surface, including
13094-
* paths no CLI caller can reach: `os migrate meta --stored` always passes
13095-
* its own automation engine (see `canonicalizeFlow` above), so the first
13096-
* bullet below is never observed from that door.
13093+
* This section documents the function's internal surface, which is not
13094+
* always identical to what an operator running the CLI can observe:
13095+
* `os migrate meta --stored` always passes its own automation engine
13096+
* (see `canonicalizeFlow` above), so the first bullet below is never
13097+
* observed from that door. That does not by itself account for every
13098+
* difference between this list and `content/docs/deployment/cli.mdx`'s
13099+
* decline table — see #9271.
1309713100
*
1309813101
* - **`flow` rows with no reachable automation engine.** Flow-node
1309913102
* conversions carry ADR-0078's open-namespace conflict guard, which

0 commit comments

Comments
 (0)