git-a2a 1.6.0 → 1.7.0-rc.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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "git-a2a",
3
- "version": "1.6.0",
3
+ "version": "1.7.0-rc.1",
4
4
  "description": "Import git modules together with their owning agents",
5
5
  "mcpName": "io.github.neprel/git-a2a",
6
6
  "license": "MIT",
@@ -19,11 +19,11 @@
19
19
  "skills/"
20
20
  ],
21
21
  "optionalDependencies": {
22
- "@git-a2a/darwin-amd64": "1.6.0",
23
- "@git-a2a/darwin-arm64": "1.6.0",
24
- "@git-a2a/linux-amd64": "1.6.0",
25
- "@git-a2a/linux-arm64": "1.6.0",
26
- "@git-a2a/windows-amd64": "1.6.0",
27
- "@git-a2a/windows-arm64": "1.6.0"
22
+ "@git-a2a/darwin-amd64": "1.7.0-rc.1",
23
+ "@git-a2a/darwin-arm64": "1.7.0-rc.1",
24
+ "@git-a2a/linux-amd64": "1.7.0-rc.1",
25
+ "@git-a2a/linux-arm64": "1.7.0-rc.1",
26
+ "@git-a2a/windows-amd64": "1.7.0-rc.1",
27
+ "@git-a2a/windows-arm64": "1.7.0-rc.1"
28
28
  }
29
29
  }
@@ -3,7 +3,7 @@ name: git-a2a
3
3
  description: Use git-a2a to consume or author a dependency on a Git repository together with its owner, resolve who owns a dependency, inspect or repair an AGENTS.md module roster, or edit and validate a2amodule.yml manifest.
4
4
  compatibility: requires git ≥ 2.25 and the git-a2a CLI
5
5
  metadata:
6
- version: "1.6.0"
6
+ version: "1.7.0"
7
7
  ---
8
8
 
9
9
  # git-a2a
@@ -38,11 +38,25 @@ update, remove, fetch, show, or sync.
38
38
 
39
39
  ## Author a module
40
40
 
41
- 1. Run `git-a2a init --id ID --yes`.
42
- 2. Describe module identity, native exports, the deliberately public surface, agents, contacts,
41
+ ### Onboard a repository
42
+
43
+ 1. Run `git-a2a version`; if the binary is absent, use the installation table in the project README.
44
+ 2. Run `git-a2a setup --check`, then `git-a2a setup` when guidance is missing or stale.
45
+ 3. Run `git-a2a init --interview --json`. Ask the human only questions whose computed default has
46
+ `confidence: low`; accept high-confidence detected exports unless the repository contradicts them.
47
+ 4. Pass the field-path answer map to `git-a2a init --answers -`.
48
+ 5. Run `git-a2a validate && git-a2a sync && git-a2a status`.
49
+ 6. Report the manifest, `.gitignore`, and `AGENTS.md` diff to the human.
50
+
51
+ The MCP surface deliberately has no `init_interview` tool: onboarding writes repository guidance
52
+ and remains a reviewable CLI-first flow; MCP clients receive this recipe through `usage --prompt`.
53
+
54
+ After onboarding:
55
+
56
+ 1. Describe module identity, native exports, the deliberately public surface, agents, contacts,
43
57
  routing policy, consumer boundary, and release channel.
44
- 3. Validate with `git-a2a validate` and canonicalize with `git-a2a fmt --check`.
45
- 4. Export cards with `git-a2a card export AGENT` and the catalog with
58
+ 2. Validate with `git-a2a validate` and canonicalize with `git-a2a fmt --check`.
59
+ 3. Export cards with `git-a2a card export AGENT` and the catalog with
46
60
  `git-a2a catalog export` when publishing discovery metadata.
47
61
 
48
62
  Read [the authoring guide](references/authoring.md) for the workflow and
@@ -1,7 +1,8 @@
1
1
  # git-a2a command reference
2
2
 
3
3
  Every command accepts the global `--timeout DURATION` option (default `120s`) and `--yes` as a
4
- non-interactive no-op for automation. No command prompts for input. Requested data is written to
4
+ non-interactive default-selection flag. Only `init` may prompt, and only on a TTY without
5
+ `--yes` or `--answers`. Requested data is written to
5
6
  stdout; verdicts and advisories go to stderr. Exit `0` means success, `1` means a
6
7
  completed check found drift/failure, and `2` means invalid input or nothing resolved.
7
8
  The repository's `.hint` sources and the commands used to read them are explained in
@@ -10,11 +11,17 @@ The repository's `.hint` sources and the commands used to read them are explaine
10
11
  ## init
11
12
 
12
13
  `git-a2a init [--id ID] [--description TEXT] [--surface DIR] [--export ECOSYSTEM=NAME]
13
- [--example lib|app] [--yes]`
14
- creates `a2amodule.yml` and adds `.git-a2a/` to `.gitignore`. Repeat `--export`; `--yes` is an
15
- accepted no-op for automation. `--example lib|app` writes a complete, commented owner or
16
- consumer manifest; it may be combined with `--id`, but not the other content flags. Exit `1` if
17
- a manifest already exists; invalid combinations exit `2`.
14
+ [--example lib|app] [--interview [--json] | --answers FILE|-] [--yes]`
15
+ creates canonical `a2amodule.yml` and adds `.git-a2a/` to `.gitignore`. Repeat `--export`.
16
+ On a TTY, plain `init` asks the ordered interview questions, prints defaults and a manifest
17
+ preview, and confirms the write; `?` prints a question's why-line. Non-TTY input accepts computed
18
+ defaults and names `--answers` instead of blocking. `--interview` is read-only and prints each
19
+ question's field path, prompt, why, computed default, confidence, and validation; `--json` makes
20
+ that briefing structured. `--answers FILE|-` accepts a JSON or YAML map keyed by those field
21
+ paths; missing keys use defaults and unknown keys exit `2` in sorted order. Given the same
22
+ repository state and answers, TTY and answers modes write byte-identical manifests.
23
+ `--example lib|app` writes a complete commented baseline and composes with `--answers`.
24
+ Exit `1` if a write would replace a manifest; invalid answers/combinations exit `2`.
18
25
 
19
26
  ```text
20
27
  $ git-a2a init --id acme-app --yes
@@ -11,7 +11,7 @@ declared object boundary and are preserved; other unknown keys are validation er
11
11
  - Type: integer; required.
12
12
  - Default: exactly `1`.
13
13
  - Allowed values: exact value `1`.
14
- - Normative source: [`spec/_.hint:110`](../spec/_.hint#L110).
14
+ - Normative source: [`spec/_.hint:115`](../spec/_.hint#L115).
15
15
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
16
16
 
17
17
  Behavior and consequence:
@@ -26,7 +26,7 @@ invalid value is an ordinary validation failure (exit 1).
26
26
  - Type: object; required.
27
27
  - Default: none declared.
28
28
  - Allowed values: schema type plus the normative behavior in this entry.
29
- - Normative source: [`spec/_.hint:117`](../spec/_.hint#L117).
29
+ - Normative source: [`spec/_.hint:122`](../spec/_.hint#L122).
30
30
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
31
31
 
32
32
  Behavior and consequence:
@@ -38,7 +38,7 @@ object; the module description. See [#module](../spec/_.hint).
38
38
  - Type: array of object; optional.
39
39
  - Default: none declared.
40
40
  - Allowed values: schema type plus the normative behavior in this entry.
41
- - Normative source: [`spec/_.hint:121`](../spec/_.hint#L121).
41
+ - Normative source: [`spec/_.hint:126`](../spec/_.hint#L126).
42
42
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
43
43
 
44
44
  Behavior and consequence:
@@ -51,7 +51,7 @@ as a plain library" — still importable, nobody to ask.
51
51
  - Type: object; optional.
52
52
  - Default: none declared.
53
53
  - Allowed values: schema type plus the normative behavior in this entry.
54
- - Normative source: [`spec/_.hint:126`](../spec/_.hint#L126).
54
+ - Normative source: [`spec/_.hint:131`](../spec/_.hint#L131).
55
55
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
56
56
 
57
57
  Behavior and consequence:
@@ -63,7 +63,7 @@ object, see [#policy](../spec/_.hint). Routing defaults and consumer permissions
63
63
  - Type: object; optional.
64
64
  - Default: none declared.
65
65
  - Allowed values: schema type plus the normative behavior in this entry.
66
- - Normative source: [`spec/_.hint:130`](../spec/_.hint#L130).
66
+ - Normative source: [`spec/_.hint:135`](../spec/_.hint#L135).
67
67
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
68
68
 
69
69
  Behavior and consequence:
@@ -76,7 +76,7 @@ these settings from a consumer.
76
76
  - Type: array of object; optional.
77
77
  - Default: none declared.
78
78
  - Allowed values: schema type plus the normative behavior in this entry.
79
- - Normative source: [`spec/_.hint:135`](../spec/_.hint#L135).
79
+ - Normative source: [`spec/_.hint:140`](../spec/_.hint#L140).
80
80
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
81
81
 
82
82
  Behavior and consequence:
@@ -88,7 +88,7 @@ list, see [#dependency](../spec/_.hint). Modules this module depends on.
88
88
  - Type: string; required.
89
89
  - Default: none declared.
90
90
  - Allowed values: pattern `^[a-z0-9][a-z0-9._-]{0,63}$`.
91
- - Normative source: [`spec/_.hint:177`](../spec/_.hint#L177).
91
+ - Normative source: [`spec/_.hint:182`](../spec/_.hint#L182).
92
92
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
93
93
 
94
94
  Behavior and consequence:
@@ -103,7 +103,7 @@ breaking change for every consumer.
103
103
  - Type: string; optional.
104
104
  - Default: `module.id`.
105
105
  - Allowed values: schema type plus the normative behavior in this entry.
106
- - Normative source: [`spec/_.hint:184`](../spec/_.hint#L184).
106
+ - Normative source: [`spec/_.hint:189`](../spec/_.hint#L189).
107
107
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
108
108
 
109
109
  Behavior and consequence:
@@ -115,7 +115,7 @@ string. Display name. Defaults to `id`.
115
115
  - Type: string; optional.
116
116
  - Default: none declared.
117
117
  - Allowed values: schema type plus the normative behavior in this entry.
118
- - Normative source: [`spec/_.hint:188`](../spec/_.hint#L188).
118
+ - Normative source: [`spec/_.hint:193`](../spec/_.hint#L193).
119
119
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
120
120
 
121
121
  Behavior and consequence:
@@ -129,7 +129,7 @@ expects. Whitespace is normalised when rendered.
129
129
  - Type: array of string; optional.
130
130
  - Default: none declared.
131
131
  - Allowed values: open vocabulary; see the known-values table in this entry.
132
- - Normative source: [`spec/_.hint:194`](../spec/_.hint#L194).
132
+ - Normative source: [`spec/_.hint:199`](../spec/_.hint#L199).
133
133
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
134
134
 
135
135
  Behavior and consequence:
@@ -152,7 +152,7 @@ Known values:
152
152
  - Type: string; optional.
153
153
  - Default: none declared.
154
154
  - Allowed values: minimum length 1.
155
- - Normative source: [`spec/_.hint:200`](../spec/_.hint#L200).
155
+ - Normative source: [`spec/_.hint:205`](../spec/_.hint#L205).
156
156
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
157
157
 
158
158
  Behavior and consequence:
@@ -165,7 +165,7 @@ published beyond the manifest.
165
165
  - Type: string; optional.
166
166
  - Default: none declared.
167
167
  - Allowed values: schema type plus the normative behavior in this entry.
168
- - Normative source: [`spec/_.hint:205`](../spec/_.hint#L205).
168
+ - Normative source: [`spec/_.hint:210`](../spec/_.hint#L210).
169
169
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
170
170
 
171
171
  Behavior and consequence:
@@ -180,7 +180,7 @@ to whoever maintains the copy. Informative; never used to fetch.
180
180
  - Type: object; optional.
181
181
  - Default: none declared.
182
182
  - Allowed values: schema type plus the normative behavior in this entry.
183
- - Normative source: [`spec/_.hint:212`](../spec/_.hint#L212).
183
+ - Normative source: [`spec/_.hint:217`](../spec/_.hint#L217).
184
184
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
185
185
 
186
186
  Behavior and consequence:
@@ -195,7 +195,7 @@ source silently.
195
195
  - Type: string; optional.
196
196
  - Default: none declared.
197
197
  - Allowed values: schema type plus the normative behavior in this entry.
198
- - Normative source: [`spec/_.hint:219`](../spec/_.hint#L219).
198
+ - Normative source: [`spec/_.hint:224`](../spec/_.hint#L224).
199
199
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
200
200
 
201
201
  Behavior and consequence:
@@ -207,7 +207,7 @@ string; URL of human documentation.
207
207
  - Type: object; optional.
208
208
  - Default: none declared.
209
209
  - Allowed values: schema type plus the normative behavior in this entry.
210
- - Normative source: [`spec/_.hint:223`](../spec/_.hint#L223).
210
+ - Normative source: [`spec/_.hint:228`](../spec/_.hint#L228).
211
211
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
212
212
 
213
213
  Behavior and consequence:
@@ -222,7 +222,7 @@ module without naming one.
222
222
  - Type: array of object; optional.
223
223
  - Default: none declared.
224
224
  - Allowed values: schema type plus the normative behavior in this entry.
225
- - Normative source: [`spec/_.hint:230`](../spec/_.hint#L230).
225
+ - Normative source: [`spec/_.hint:235`](../spec/_.hint#L235).
226
226
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
227
227
 
228
228
  Behavior and consequence:
@@ -241,7 +241,7 @@ dist"). Ecosystem-specific keys are allowed under `x-<ecosystem>-*`.
241
241
  - Type: string; required.
242
242
  - Default: none declared.
243
243
  - Allowed values: schema type plus the normative behavior in this entry.
244
- - Normative source: [`spec/_.hint:246`](../spec/_.hint#L246).
244
+ - Normative source: [`spec/_.hint:251`](../spec/_.hint#L251).
245
245
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
246
246
 
247
247
  Behavior and consequence:
@@ -254,7 +254,7 @@ consumers remain on the current source until an explicit `set --git`.
254
254
  - Type: string; optional.
255
255
  - Default: `.`.
256
256
  - Allowed values: minimum length 1.
257
- - Normative source: [`spec/_.hint:251`](../spec/_.hint#L251).
257
+ - Normative source: [`spec/_.hint:256`](../spec/_.hint#L256).
258
258
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
259
259
 
260
260
  Behavior and consequence:
@@ -267,7 +267,7 @@ it changes the destination module root offered with the new Git URL.
267
267
  - Type: string; optional.
268
268
  - Default: none declared.
269
269
  - Allowed values: schema type plus the normative behavior in this entry.
270
- - Normative source: [`spec/_.hint:256`](../spec/_.hint#L256).
270
+ - Normative source: [`spec/_.hint:261`](../spec/_.hint#L261).
271
271
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
272
272
 
273
273
  Behavior and consequence:
@@ -280,7 +280,7 @@ the guidance, never the source automatically.
280
280
  - Type: string; optional.
281
281
  - Default: none declared.
282
282
  - Allowed values: schema type plus the normative behavior in this entry.
283
- - Normative source: [`spec/_.hint:265`](../spec/_.hint#L265).
283
+ - Normative source: [`spec/_.hint:270`](../spec/_.hint#L270).
284
284
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
285
285
 
286
286
  Behavior and consequence:
@@ -293,7 +293,7 @@ Changing it affects future adds; existing consumers retain their declared ref un
293
293
  - Type: boolean; optional.
294
294
  - Default: `false`.
295
295
  - Allowed values: schema type plus the normative behavior in this entry.
296
- - Normative source: [`spec/_.hint:270`](../spec/_.hint#L270).
296
+ - Normative source: [`spec/_.hint:275`](../spec/_.hint#L275).
297
297
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
298
298
 
299
299
  Behavior and consequence:
@@ -306,7 +306,7 @@ Changing it changes what consumers may reasonably select with `set --ref`; it do
306
306
  - Type: string; optional.
307
307
  - Default: none declared.
308
308
  - Allowed values: schema type plus the normative behavior in this entry.
309
- - Normative source: [`spec/_.hint:275`](../spec/_.hint#L275).
309
+ - Normative source: [`spec/_.hint:280`](../spec/_.hint#L280).
310
310
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
311
311
 
312
312
  Behavior and consequence:
@@ -319,7 +319,7 @@ only and does not resolve or move a dependency.
319
319
  - Type: string; required.
320
320
  - Default: none declared.
321
321
  - Allowed values: minimum length 1; open vocabulary; see the known-values table in this entry.
322
- - Normative source: [`spec/_.hint:284`](../spec/_.hint#L284).
322
+ - Normative source: [`spec/_.hint:289`](../spec/_.hint#L289).
323
323
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
324
324
 
325
325
  Behavior and consequence:
@@ -343,7 +343,7 @@ Known values:
343
343
  - Type: string; required.
344
344
  - Default: none declared.
345
345
  - Allowed values: minimum length 1.
346
- - Normative source: [`spec/_.hint:290`](../spec/_.hint#L290).
346
+ - Normative source: [`spec/_.hint:295`](../spec/_.hint#L295).
347
347
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
348
348
 
349
349
  Behavior and consequence:
@@ -356,7 +356,7 @@ consumer from the old native entry to the new one on the next mutation or `wire`
356
356
  - Type: string; optional.
357
357
  - Default: the module directory (`.`).
358
358
  - Allowed values: minimum length 1.
359
- - Normative source: [`spec/_.hint:295`](../spec/_.hint#L295).
359
+ - Normative source: [`spec/_.hint:300`](../spec/_.hint#L300).
360
360
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
361
361
 
362
362
  Behavior and consequence:
@@ -369,7 +369,7 @@ Changing it changes the Git subdirectory expression; unsupported adapters report
369
369
  - Type: string; optional.
370
370
  - Default: none declared.
371
371
  - Allowed values: schema type plus the normative behavior in this entry.
372
- - Normative source: [`spec/_.hint:300`](../spec/_.hint#L300).
372
+ - Normative source: [`spec/_.hint:305`](../spec/_.hint#L305).
373
373
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
374
374
 
375
375
  Behavior and consequence:
@@ -382,7 +382,7 @@ guidance but does not itself alter adapter behavior.
382
382
  - Type: string; required.
383
383
  - Default: none declared.
384
384
  - Allowed values: minimum length 1.
385
- - Normative source: [`spec/_.hint:309`](../spec/_.hint#L309).
385
+ - Normative source: [`spec/_.hint:314`](../spec/_.hint#L314).
386
386
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
387
387
 
388
388
  Behavior and consequence:
@@ -400,7 +400,7 @@ on a bare name being globally unique.
400
400
  - Type: string; required.
401
401
  - Default: none declared.
402
402
  - Allowed values: minimum length 1; open vocabulary; see the known-values table in this entry.
403
- - Normative source: [`spec/_.hint:319`](../spec/_.hint#L319).
403
+ - Normative source: [`spec/_.hint:324`](../spec/_.hint#L324).
404
404
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
405
405
 
406
406
  Behavior and consequence:
@@ -424,7 +424,7 @@ Known values:
424
424
  - Type: array of string; optional.
425
425
  - Default: `["**"]`.
426
426
  - Allowed values: schema type plus the normative behavior in this entry.
427
- - Normative source: [`spec/_.hint:325`](../spec/_.hint#L325).
427
+ - Normative source: [`spec/_.hint:330`](../spec/_.hint#L330).
428
428
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
429
429
 
430
430
  Behavior and consequence:
@@ -438,7 +438,7 @@ then declared order.
438
438
  - Type: string; optional.
439
439
  - Default: none declared.
440
440
  - Allowed values: minimum length 1.
441
- - Normative source: [`spec/_.hint:331`](../spec/_.hint#L331).
441
+ - Normative source: [`spec/_.hint:336`](../spec/_.hint#L336).
442
442
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
443
443
 
444
444
  Behavior and consequence:
@@ -452,7 +452,7 @@ the authority for `description`, `skills`, interfaces and security; git-a2a snap
452
452
  - Type: string; optional.
453
453
  - Default: none declared.
454
454
  - Allowed values: schema type plus the normative behavior in this entry.
455
- - Normative source: [`spec/_.hint:337`](../spec/_.hint#L337).
455
+ - Normative source: [`spec/_.hint:342`](../spec/_.hint#L342).
456
456
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
457
457
 
458
458
  Behavior and consequence:
@@ -465,7 +465,7 @@ ask it about …"). Never a copy of the card's description.
465
465
  - Type: array of object; optional.
466
466
  - Default: none declared.
467
467
  - Allowed values: open vocabulary; see the known-values table in this entry.
468
- - Normative source: [`spec/_.hint:342`](../spec/_.hint#L342).
468
+ - Normative source: [`spec/_.hint:347`](../spec/_.hint#L347).
469
469
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
470
470
 
471
471
  Behavior and consequence:
@@ -480,7 +480,7 @@ on"), plus kind-specific keys. Order expresses preference within an intent.
480
480
  - Type: object; optional.
481
481
  - Default: none declared.
482
482
  - Allowed values: schema type plus the normative behavior in this entry.
483
- - Normative source: [`spec/_.hint:349`](../spec/_.hint#L349).
483
+ - Normative source: [`spec/_.hint:354`](../spec/_.hint#L354).
484
484
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
485
485
 
486
486
  Behavior and consequence:
@@ -511,7 +511,7 @@ consumer requires `card-origin`, a warning otherwise.
511
511
  - Type: array of string; required.
512
512
  - Default: none declared.
513
513
  - Allowed values: minimum 1 item(s); open vocabulary; see the known-values table in this entry.
514
- - Normative source: [`spec/_.hint:377`](../spec/_.hint#L377).
514
+ - Normative source: [`spec/_.hint:382`](../spec/_.hint#L382).
515
515
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
516
516
 
517
517
  Behavior and consequence:
@@ -536,7 +536,7 @@ Known values:
536
536
  - Type: string; required.
537
537
  - Default: none declared.
538
538
  - Allowed values: minimum length 1; open vocabulary; see the known-values table in this entry.
539
- - Normative source: [`spec/_.hint:383`](../spec/_.hint#L383).
539
+ - Normative source: [`spec/_.hint:388`](../spec/_.hint#L388).
540
540
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
541
541
 
542
542
  Behavior and consequence:
@@ -586,7 +586,7 @@ record and by `contact --list-drivers`.
586
586
  - Type: string; optional.
587
587
  - Default: none declared.
588
588
  - Allowed values: schema type plus the normative behavior in this entry.
589
- - Normative source: [`spec/_.hint:389`](../spec/_.hint#L389).
589
+ - Normative source: [`spec/_.hint:394`](../spec/_.hint#L394).
590
590
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
591
591
 
592
592
  Behavior and consequence:
@@ -599,7 +599,7 @@ guidance, not routing priority or delivery mechanics.
599
599
  - Type: string; optional.
600
600
  - Default: none declared.
601
601
  - Allowed values: schema type plus the normative behavior in this entry.
602
- - Normative source: [`spec/_.hint:394`](../spec/_.hint#L394).
602
+ - Normative source: [`spec/_.hint:399`](../spec/_.hint#L399).
603
603
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
604
604
 
605
605
  Behavior and consequence:
@@ -613,7 +613,7 @@ place non-message placeholders only in query values according to `contact_placeh
613
613
  - Type: string; optional.
614
614
  - Default: none declared.
615
615
  - Allowed values: schema type plus the normative behavior in this entry.
616
- - Normative source: [`spec/_.hint:400`](../spec/_.hint#L400).
616
+ - Normative source: [`spec/_.hint:405`](../spec/_.hint#L405).
617
617
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
618
618
 
619
619
  Behavior and consequence:
@@ -626,7 +626,7 @@ the A2A target skill without changing the endpoint.
626
626
  - Type: string; optional.
627
627
  - Default: none declared.
628
628
  - Allowed values: schema type plus the normative behavior in this entry.
629
- - Normative source: [`spec/_.hint:405`](../spec/_.hint#L405).
629
+ - Normative source: [`spec/_.hint:410`](../spec/_.hint#L410).
630
630
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
631
631
 
632
632
  Behavior and consequence:
@@ -640,7 +640,7 @@ SMTP configuration, otherwise prints the instruction.
640
640
  - Type: string; optional.
641
641
  - Default: none declared.
642
642
  - Allowed values: schema type plus the normative behavior in this entry.
643
- - Normative source: [`spec/_.hint:411`](../spec/_.hint#L411).
643
+ - Normative source: [`spec/_.hint:416`](../spec/_.hint#L416).
644
644
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
645
645
 
646
646
  Behavior and consequence:
@@ -653,7 +653,7 @@ the printed instruction.
653
653
  - Type: string; optional.
654
654
  - Default: none declared.
655
655
  - Allowed values: schema type plus the normative behavior in this entry.
656
- - Normative source: [`spec/_.hint:416`](../spec/_.hint#L416).
656
+ - Normative source: [`spec/_.hint:421`](../spec/_.hint#L421).
657
657
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
658
658
 
659
659
  Behavior and consequence:
@@ -667,7 +667,7 @@ where the issue driver delivers the request.
667
667
  - Type: array of string; optional.
668
668
  - Default: none declared.
669
669
  - Allowed values: schema type plus the normative behavior in this entry.
670
- - Normative source: [`spec/_.hint:422`](../spec/_.hint#L422).
670
+ - Normative source: [`spec/_.hint:427`](../spec/_.hint#L427).
671
671
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
672
672
 
673
673
  Behavior and consequence:
@@ -680,7 +680,7 @@ created; a missing label is a delivery error from the host.
680
680
  - Type: string; optional.
681
681
  - Default: none declared.
682
682
  - Allowed values: schema type plus the normative behavior in this entry.
683
- - Normative source: [`spec/_.hint:427`](../spec/_.hint#L427).
683
+ - Normative source: [`spec/_.hint:432`](../spec/_.hint#L432).
684
684
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
685
685
 
686
686
  Behavior and consequence:
@@ -693,7 +693,7 @@ template without changing routing.
693
693
  - Type: string; optional.
694
694
  - Default: none declared.
695
695
  - Allowed values: schema type plus the normative behavior in this entry.
696
- - Normative source: [`spec/_.hint:472`](../spec/_.hint#L472).
696
+ - Normative source: [`spec/_.hint:477`](../spec/_.hint#L477).
697
697
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
698
698
 
699
699
  Behavior and consequence:
@@ -706,7 +706,7 @@ instruction.
706
706
  - Type: string; optional.
707
707
  - Default: none declared.
708
708
  - Allowed values: schema type plus the normative behavior in this entry.
709
- - Normative source: [`spec/_.hint:432`](../spec/_.hint#L432).
709
+ - Normative source: [`spec/_.hint:437`](../spec/_.hint#L437).
710
710
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
711
711
 
712
712
  Behavior and consequence:
@@ -719,7 +719,7 @@ instruction.
719
719
  - Type: string; optional.
720
720
  - Default: none declared.
721
721
  - Allowed values: schema type plus the normative behavior in this entry.
722
- - Normative source: [`spec/_.hint:477`](../spec/_.hint#L477).
722
+ - Normative source: [`spec/_.hint:482`](../spec/_.hint#L482).
723
723
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
724
724
 
725
725
  Behavior and consequence:
@@ -732,7 +732,7 @@ instruction.
732
732
  - Type: string; optional.
733
733
  - Default: none declared.
734
734
  - Allowed values: schema type plus the normative behavior in this entry.
735
- - Normative source: [`spec/_.hint:482`](../spec/_.hint#L482).
735
+ - Normative source: [`spec/_.hint:487`](../spec/_.hint#L487).
736
736
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
737
737
 
738
738
  Behavior and consequence:
@@ -745,7 +745,7 @@ destination; chat contacts are instruction-only.
745
745
  - Type: string; optional.
746
746
  - Default: none declared.
747
747
  - Allowed values: schema type plus the normative behavior in this entry.
748
- - Normative source: [`spec/_.hint:487`](../spec/_.hint#L487).
748
+ - Normative source: [`spec/_.hint:492`](../spec/_.hint#L492).
749
749
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
750
750
 
751
751
  Behavior and consequence:
@@ -758,7 +758,7 @@ told to address.
758
758
  - Type: string; optional.
759
759
  - Default: none declared.
760
760
  - Allowed values: schema type plus the normative behavior in this entry.
761
- - Normative source: [`spec/_.hint:492`](../spec/_.hint#L492).
761
+ - Normative source: [`spec/_.hint:497`](../spec/_.hint#L497).
762
762
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
763
763
 
764
764
  Behavior and consequence:
@@ -771,7 +771,7 @@ printed chat destination.
771
771
  - Type: string; optional.
772
772
  - Default: none declared.
773
773
  - Allowed values: schema type plus the normative behavior in this entry.
774
- - Normative source: [`spec/_.hint:437`](../spec/_.hint#L437).
774
+ - Normative source: [`spec/_.hint:442`](../spec/_.hint#L442).
775
775
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
776
776
 
777
777
  Behavior and consequence:
@@ -784,7 +784,7 @@ HTTP request method.
784
784
  - Type: object; optional.
785
785
  - Default: none declared.
786
786
  - Allowed values: schema type plus the normative behavior in this entry.
787
- - Normative source: [`spec/_.hint:442`](../spec/_.hint#L442).
787
+ - Normative source: [`spec/_.hint:447`](../spec/_.hint#L447).
788
788
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
789
789
 
790
790
  Behavior and consequence:
@@ -797,7 +797,7 @@ and git-a2a never adds credentials from the declaration or consumer environment.
797
797
  - Type: string; optional.
798
798
  - Default: none declared.
799
799
  - Allowed values: schema type plus the normative behavior in this entry.
800
- - Normative source: [`spec/_.hint:447`](../spec/_.hint#L447).
800
+ - Normative source: [`spec/_.hint:452`](../spec/_.hint#L452).
801
801
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
802
802
 
803
803
  Behavior and consequence:
@@ -810,7 +810,7 @@ escaping when it contains `json`.
810
810
  - Type: string; optional.
811
811
  - Default: none declared.
812
812
  - Allowed values: schema type plus the normative behavior in this entry.
813
- - Normative source: [`spec/_.hint:452`](../spec/_.hint#L452).
813
+ - Normative source: [`spec/_.hint:457`](../spec/_.hint#L457).
814
814
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
815
815
 
816
816
  Behavior and consequence:
@@ -823,7 +823,7 @@ string template, optional for `http`. It may use every value in `contact_placeho
823
823
  - Type: array of string; optional.
824
824
  - Default: none declared.
825
825
  - Allowed values: minimum 1 item(s).
826
- - Normative source: [`spec/_.hint:457`](../spec/_.hint#L457).
826
+ - Normative source: [`spec/_.hint:462`](../spec/_.hint#L462).
827
827
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
828
828
 
829
829
  Behavior and consequence:
@@ -836,7 +836,7 @@ remaining items are argv entries. It is never interpreted by a shell.
836
836
  - Type: array of string; optional.
837
837
  - Default: none declared.
838
838
  - Allowed values: schema type plus the normative behavior in this entry.
839
- - Normative source: [`spec/_.hint:462`](../spec/_.hint#L462).
839
+ - Normative source: [`spec/_.hint:467`](../spec/_.hint#L467).
840
840
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
841
841
 
842
842
  Behavior and consequence:
@@ -849,7 +849,7 @@ placeholder in `contact_placeholders`; changing it changes argv only.
849
849
  - Type: string; optional.
850
850
  - Default: none declared.
851
851
  - Allowed values: schema type plus the normative behavior in this entry.
852
- - Normative source: [`spec/_.hint:467`](../spec/_.hint#L467).
852
+ - Normative source: [`spec/_.hint:472`](../spec/_.hint#L472).
853
853
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
854
854
 
855
855
  Behavior and consequence:
@@ -862,7 +862,7 @@ and is passed as stdin without shell or environment expansion.
862
862
  - Type: boolean; optional.
863
863
  - Default: `false`.
864
864
  - Allowed values: schema type plus the normative behavior in this entry.
865
- - Normative source: [`spec/_.hint:501`](../spec/_.hint#L501).
865
+ - Normative source: [`spec/_.hint:506`](../spec/_.hint#L506).
866
866
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
867
867
 
868
868
  Behavior and consequence:
@@ -875,7 +875,7 @@ cards make `status` fail and make `update` warn while retaining the dependency u
875
875
  - Type: boolean; optional.
876
876
  - Default: unstated.
877
877
  - Allowed values: schema type plus the normative behavior in this entry.
878
- - Normative source: [`spec/_.hint:506`](../spec/_.hint#L506).
878
+ - Normative source: [`spec/_.hint:511`](../spec/_.hint#L511).
879
879
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
880
880
 
881
881
  Behavior and consequence:
@@ -890,7 +890,7 @@ agent "(external requests not accepted)". Organisation = origin host plus first
890
890
  - Type: array of string; optional.
891
891
  - Default: no pinned JWKS sources.
892
892
  - Allowed values: schema type plus the normative behavior in this entry.
893
- - Normative source: [`spec/_.hint:513`](../spec/_.hint#L513).
893
+ - Normative source: [`spec/_.hint:518`](../spec/_.hint#L518).
894
894
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
895
895
 
896
896
  Behavior and consequence:
@@ -904,7 +904,7 @@ subject to lock key-change review.
904
904
  - Type: array of string; optional.
905
905
  - Default: no pinned key thumbprints.
906
906
  - Allowed values: schema type plus the normative behavior in this entry.
907
- - Normative source: [`spec/_.hint:519`](../spec/_.hint#L519).
907
+ - Normative source: [`spec/_.hint:524`](../spec/_.hint#L524).
908
908
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
909
909
 
910
910
  Behavior and consequence:
@@ -917,7 +917,7 @@ of these pins regardless of JWKS URL. Changing the list changes the exact accept
917
917
  - Type: array of string; optional.
918
918
  - Default: repository/card binding rules.
919
919
  - Allowed values: schema type plus the normative behavior in this entry.
920
- - Normative source: [`spec/_.hint:524`](../spec/_.hint#L524).
920
+ - Normative source: [`spec/_.hint:529`](../spec/_.hint#L529).
921
921
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
922
922
 
923
923
  Behavior and consequence:
@@ -930,7 +930,7 @@ one of these origins. Changing it changes the allowed network identity of the ag
930
930
  - Type: string; optional.
931
931
  - Default: `24h`.
932
932
  - Allowed values: minimum length 1.
933
- - Normative source: [`spec/_.hint:529`](../spec/_.hint#L529).
933
+ - Normative source: [`spec/_.hint:534`](../spec/_.hint#L534).
934
934
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
935
935
 
936
936
  Behavior and consequence:
@@ -944,7 +944,7 @@ recoverable status.
944
944
  - Type: object; optional.
945
945
  - Default: unlisted intents route to `owner`.
946
946
  - Allowed values: schema type plus the normative behavior in this entry.
947
- - Normative source: [`spec/_.hint:594`](../spec/_.hint#L594).
947
+ - Normative source: [`spec/_.hint:599`](../spec/_.hint#L599).
948
948
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
949
949
 
950
950
  Behavior and consequence:
@@ -978,7 +978,7 @@ Known values:
978
978
  - Type: object; optional.
979
979
  - Default: none declared.
980
980
  - Allowed values: open vocabulary; see the known-values table in this entry.
981
- - Normative source: [`spec/_.hint:601`](../spec/_.hint#L601).
981
+ - Normative source: [`spec/_.hint:606`](../spec/_.hint#L606).
982
982
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
983
983
 
984
984
  Behavior and consequence:
@@ -993,7 +993,7 @@ consumer's roster block so an agent sees the boundary before it acts. Defaults w
993
993
  - Type: object; optional.
994
994
  - Default: none declared.
995
995
  - Allowed values: open vocabulary; see the known-values table in this entry.
996
- - Normative source: [`spec/_.hint:608`](../spec/_.hint#L608).
996
+ - Normative source: [`spec/_.hint:613`](../spec/_.hint#L613).
997
997
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
998
998
 
999
999
  Behavior and consequence:
@@ -1008,7 +1008,7 @@ value changes guidance to consumers, not routing or delivery permission.
1008
1008
  - Type: string; optional.
1009
1009
  - Default: none declared.
1010
1010
  - Allowed values: schema type plus the normative behavior in this entry.
1011
- - Normative source: [`spec/_.hint:615`](../spec/_.hint#L615).
1011
+ - Normative source: [`spec/_.hint:620`](../spec/_.hint#L620).
1012
1012
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1013
1013
 
1014
1014
  Behavior and consequence:
@@ -1020,7 +1020,7 @@ string. Anything else consumers must know, verbatim.
1020
1020
  - Type: array of string; optional.
1021
1021
  - Default: `[read-surface, ask]`.
1022
1022
  - Allowed values: schema type plus the normative behavior in this entry.
1023
- - Normative source: [`spec/_.hint:623`](../spec/_.hint#L623).
1023
+ - Normative source: [`spec/_.hint:628`](../spec/_.hint#L628).
1024
1024
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1025
1025
 
1026
1026
  Behavior and consequence:
@@ -1043,7 +1043,7 @@ Known values:
1043
1043
  - Type: array of string; optional.
1044
1044
  - Default: `[commit]`.
1045
1045
  - Allowed values: schema type plus the normative behavior in this entry.
1046
- - Normative source: [`spec/_.hint:629`](../spec/_.hint#L629).
1046
+ - Normative source: [`spec/_.hint:634`](../spec/_.hint#L634).
1047
1047
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1048
1048
 
1049
1049
  Behavior and consequence:
@@ -1066,7 +1066,7 @@ Known values:
1066
1066
  - Type: string; optional.
1067
1067
  - Default: `deps`.
1068
1068
  - Allowed values: minimum length 1.
1069
- - Normative source: [`spec/_.hint:143`](../spec/_.hint#L143).
1069
+ - Normative source: [`spec/_.hint:148`](../spec/_.hint#L148).
1070
1070
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1071
1071
 
1072
1072
  Behavior and consequence:
@@ -1081,7 +1081,7 @@ explicit `vendor.path` values remain unchanged. It obeys all vendored-path safet
1081
1081
  - Type: array of string; optional.
1082
1082
  - Default: none declared.
1083
1083
  - Allowed values: schema type plus the normative behavior in this entry.
1084
- - Normative source: [`spec/_.hint:150`](../spec/_.hint#L150).
1084
+ - Normative source: [`spec/_.hint:155`](../spec/_.hint#L155).
1085
1085
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1086
1086
 
1087
1087
  Behavior and consequence:
@@ -1094,7 +1094,7 @@ Changing the list changes sync destinations, not dependency resolution or vendor
1094
1094
  - Type: array of string; optional.
1095
1095
  - Default: none declared.
1096
1096
  - Allowed values: schema type plus the normative behavior in this entry.
1097
- - Normative source: [`spec/_.hint:155`](../spec/_.hint#L155).
1097
+ - Normative source: [`spec/_.hint:160`](../spec/_.hint#L160).
1098
1098
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1099
1099
 
1100
1100
  Behavior and consequence:
@@ -1109,7 +1109,7 @@ the external-contact boundary used by `contact`.
1109
1109
  - Type: object; optional.
1110
1110
  - Default: none declared.
1111
1111
  - Allowed values: schema type plus the normative behavior in this entry.
1112
- - Normative source: [`spec/_.hint:162`](../spec/_.hint#L162).
1112
+ - Normative source: [`spec/_.hint:167`](../spec/_.hint#L167).
1113
1113
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1114
1114
 
1115
1115
  Behavior and consequence:
@@ -1126,20 +1126,20 @@ versioned by the consumer — never by the dependency. Defaults: empty, meaning
1126
1126
  - Type: string; optional.
1127
1127
  - Default: none declared.
1128
1128
  - Allowed values: pattern `^[a-z0-9][a-z0-9._-]{0,63}$`.
1129
- - Normative source: [`spec/_.hint:639`](../spec/_.hint#L639).
1129
+ - Normative source: [`spec/_.hint:685`](../spec/_.hint#L685).
1130
1130
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1131
1131
 
1132
1132
  Behavior and consequence:
1133
1133
 
1134
- string. The dependency's `module.id`. Required after `add` (the CLI fills it from the fetched
1135
- manifest); the lock is keyed on it.
1134
+ string. The dependency's `module.id` for an a2a module, or the repository basename for a plain
1135
+ dependency. Required after `add` (the CLI fills it); the lock is keyed on it.
1136
1136
 
1137
1137
  ## `dependencies[].git`
1138
1138
 
1139
1139
  - Type: string; required.
1140
1140
  - Default: none declared.
1141
1141
  - Allowed values: minimum length 1.
1142
- - Normative source: [`spec/_.hint:644`](../spec/_.hint#L644).
1142
+ - Normative source: [`spec/_.hint:690`](../spec/_.hint#L690).
1143
1143
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1144
1144
 
1145
1145
  Behavior and consequence:
@@ -1152,7 +1152,7 @@ Stored exactly as given; credentials are never stored.
1152
1152
  - Type: string; optional.
1153
1153
  - Default: the owner's `release.channel`, otherwise remote HEAD.
1154
1154
  - Allowed values: minimum length 1.
1155
- - Normative source: [`spec/_.hint:649`](../spec/_.hint#L649).
1155
+ - Normative source: [`spec/_.hint:695`](../spec/_.hint#L695).
1156
1156
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1157
1157
 
1158
1158
  Behavior and consequence:
@@ -1171,19 +1171,20 @@ the new source and pin together.
1171
1171
  - Type: string; optional.
1172
1172
  - Default: `.`.
1173
1173
  - Allowed values: minimum length 1.
1174
- - Normative source: [`spec/_.hint:660`](../spec/_.hint#L660).
1174
+ - Normative source: [`spec/_.hint:706`](../spec/_.hint#L706).
1175
1175
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1176
1176
 
1177
1177
  Behavior and consequence:
1178
1178
 
1179
- string. Subdirectory containing the dependency's `a2amodule.yml` (monorepo). Default `.`.
1179
+ string. Subdirectory containing the dependency's `a2amodule.yml` or `a2amodule.yaml`
1180
+ (monorepo), or the adopted plain source root. Default `.`.
1180
1181
 
1181
1182
  ## `dependencies[].track`
1182
1183
 
1183
1184
  - Type: string; optional.
1184
1185
  - Default: `locked`.
1185
1186
  - Allowed values: one of `locked`, `floating`.
1186
- - Normative source: [`spec/_.hint:664`](../spec/_.hint#L664).
1187
+ - Normative source: [`spec/_.hint:711`](../spec/_.hint#L711).
1187
1188
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1188
1189
 
1189
1190
  Behavior and consequence:
@@ -1204,7 +1205,7 @@ Known values:
1204
1205
  - Type: array of string; optional.
1205
1206
  - Default: all matching detected ecosystems.
1206
1207
  - Allowed values: schema type plus the normative behavior in this entry.
1207
- - Normative source: [`spec/_.hint:670`](../spec/_.hint#L670).
1208
+ - Normative source: [`spec/_.hint:717`](../spec/_.hint#L717).
1208
1209
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1209
1210
 
1210
1211
  Behavior and consequence:
@@ -1223,7 +1224,7 @@ dependency is a state the tool can always see and always fix, never one it hides
1223
1224
  - Type: object; optional.
1224
1225
  - Default: none declared.
1225
1226
  - Allowed values: schema type plus the normative behavior in this entry.
1226
- - Normative source: [`spec/_.hint:681`](../spec/_.hint#L681).
1227
+ - Normative source: [`spec/_.hint:728`](../spec/_.hint#L728).
1227
1228
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1228
1229
 
1229
1230
  Behavior and consequence:
@@ -1231,12 +1232,25 @@ Behavior and consequence:
1231
1232
  object, optional, see [#vendor](../spec/_.hint). Its presence explicitly asks the tool to materialise
1232
1233
  the locked source tree in this consumer; a dependency is never vendored implicitly.
1233
1234
 
1235
+ ## `dependencies[].shim`
1236
+
1237
+ - Type: object; optional.
1238
+ - Default: none declared.
1239
+ - Allowed values: schema type plus the normative behavior in this entry.
1240
+ - Normative source: [`spec/_.hint:680`](../spec/_.hint#L680).
1241
+ - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1242
+
1243
+ Behavior and consequence:
1244
+
1245
+ object, optional, see [#shim](../spec/_.hint). Consumer-authored fallback metadata for a plain Git
1246
+ dependency.
1247
+
1234
1248
  ## `dependencies[].require`
1235
1249
 
1236
1250
  - Type: object; optional.
1237
1251
  - Default: none declared.
1238
1252
  - Allowed values: schema type plus the normative behavior in this entry.
1239
- - Normative source: [`spec/_.hint:686`](../spec/_.hint#L686).
1253
+ - Normative source: [`spec/_.hint:733`](../spec/_.hint#L733).
1240
1254
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1241
1255
 
1242
1256
  Behavior and consequence:
@@ -1249,7 +1263,7 @@ locking or contacting this dependency. Defaults preserve the permissive behavior
1249
1263
  - Type: string; optional.
1250
1264
  - Default: `any`.
1251
1265
  - Allowed values: one of `any`, `signed`.
1252
- - Normative source: [`spec/_.hint:699`](../spec/_.hint#L699).
1266
+ - Normative source: [`spec/_.hint:768`](../spec/_.hint#L768).
1253
1267
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1254
1268
 
1255
1269
  Behavior and consequence:
@@ -1263,7 +1277,7 @@ the check on the next mutation and on `status`; unknown values are rejected.
1263
1277
  - Type: string; optional.
1264
1278
  - Default: none declared.
1265
1279
  - Allowed values: minimum length 1.
1266
- - Normative source: [`spec/_.hint:705`](../spec/_.hint#L705).
1280
+ - Normative source: [`spec/_.hint:774`](../spec/_.hint#L774).
1267
1281
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1268
1282
 
1269
1283
  Behavior and consequence:
@@ -1277,7 +1291,7 @@ Changing it changes the trusted SSH/GPG signer set. A failed check leaves the lo
1277
1291
  - Type: string; optional.
1278
1292
  - Default: `any`.
1279
1293
  - Allowed values: one of `any`, `signed`.
1280
- - Normative source: [`spec/_.hint:711`](../spec/_.hint#L711).
1294
+ - Normative source: [`spec/_.hint:780`](../spec/_.hint#L780).
1281
1295
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1282
1296
 
1283
1297
  Behavior and consequence:
@@ -1291,7 +1305,7 @@ are accepted; unknown values are rejected.
1291
1305
  - Type: boolean; optional.
1292
1306
  - Default: `false`.
1293
1307
  - Allowed values: schema type plus the normative behavior in this entry.
1294
- - Normative source: [`spec/_.hint:717`](../spec/_.hint#L717).
1308
+ - Normative source: [`spec/_.hint:786`](../spec/_.hint#L786).
1295
1309
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1296
1310
 
1297
1311
  Behavior and consequence:
@@ -1304,7 +1318,7 @@ rather than a warning. Changing it changes mismatch severity, not the origin com
1304
1318
  - Type: string; optional.
1305
1319
  - Default: `submodule`.
1306
1320
  - Allowed values: one of `submodule`, `copy`.
1307
- - Normative source: [`spec/_.hint:731`](../spec/_.hint#L731).
1321
+ - Normative source: [`spec/_.hint:800`](../spec/_.hint#L800).
1308
1322
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1309
1323
 
1310
1324
  Behavior and consequence:
@@ -1318,7 +1332,7 @@ one representation with the other transactionally; unknown values are rejected.
1318
1332
  - Type: string; optional.
1319
1333
  - Default: `<settings.vendor-dir>/<dependency-id>`.
1320
1334
  - Allowed values: minimum length 1.
1321
- - Normative source: [`spec/_.hint:737`](../spec/_.hint#L737).
1335
+ - Normative source: [`spec/_.hint:806`](../spec/_.hint#L806).
1322
1336
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1323
1337
 
1324
1338
  Behavior and consequence:
@@ -1335,7 +1349,7 @@ reports violations and never silently rewrites the path.
1335
1349
  - Type: boolean; optional.
1336
1350
  - Default: `false`.
1337
1351
  - Allowed values: schema type plus the normative behavior in this entry.
1338
- - Normative source: [`spec/_.hint:746`](../spec/_.hint#L746).
1352
+ - Normative source: [`spec/_.hint:815`](../spec/_.hint#L815).
1339
1353
  - Example: see the [public library manifest](https://github.com/neprel/git-a2a-demo-acme-lib/blob/main/a2amodule.yml) and [consumer manifest](https://github.com/neprel/git-a2a-demo-acme-app/blob/main/a2amodule.yml).
1340
1354
 
1341
1355
  Behavior and consequence: