Skip to content

Commit c60d418

Browse files
dmealingclaude
andcommitted
docs(fr-032): fix agent-docs example showing a relative ref in JSON
The `meta docs` agent-docs body had a `json` worked example with `"extends": "..::common::id"` — now invalid canonical JSON (FR-032 rejects relative refs in JSON). Changed it to the FQN it lowers to (`common::id`) and clarified the prose that relative forms (`..::`, leading `::`) are a YAML-authoring affordance only — canonical JSON must be fully-qualified or it's rejected with ERR_RELATIVE_REF_IN_CANONICAL. sdk 145/0, typecheck clean. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent af46e65 commit c60d418

1 file changed

Lines changed: 2 additions & 2 deletions

File tree

  • server/typescript/packages/sdk/src/agent-docs

server/typescript/packages/sdk/src/agent-docs/body.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -152,7 +152,7 @@ The v0.2 keys (\`super\`, \`overlay\`, \`override\`, \`isInterface\`, \`implemen
152152
### Package paths and inheritance
153153
154154
- Package segments separated by \`::\` — \`acme::common::id\`
155-
- Relative references in \`extends:\` — \`..::common::id\` means "go up to parent package, descend into \`common::id\`"
155+
- Relative references in \`extends:\` — \`..::common::id\` means "go up to parent package, descend into \`common::id\`". Relative forms (\`..::\` parent-relative, leading \`::\` root-absolute) are a **YAML-authoring affordance only**; canonical JSON must be fully-qualified (a relative ref in JSON is rejected with \`ERR_RELATIVE_REF_IN_CANONICAL\`).
156156
- Cross-file resolution works as long as all files are passed to Loader (or live in the same \`metaobjects/\` directory)
157157
158158
### Two special intercepted attrs (parser-routed)
@@ -521,7 +521,7 @@ metaobjects.config.ts generator wiring (committed)
521521
"@forgeSource": "human",
522522
"@forgePrimaryLocation": "src/db/users.schema.ts",
523523
"children": [
524-
{"field": {"name": "id", "extends": "..::common::id"}},
524+
{"field": {"name": "id", "extends": "common::id"}},
525525
{"field": {"name": "email", "subType": "string",
526526
"@column": "email_address",
527527
"children": [{"validator": {"subType": "required"}}]

0 commit comments

Comments
 (0)