@kungfu-tech/kfd 1.0.0-alpha.4 → 1.0.0-alpha.7
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/.buildchain/kfd-1/contract-world.witness.json +8 -8
- package/.buildchain/kfd-3/collaboration-interface.artifact.json +443 -0
- package/.buildchain/kfd-3/collaboration-interface.json +260 -0
- package/.buildchain/kfd-3/collaboration-interface.prebuild.json +717 -0
- package/buildchain.release-propagation.json +9 -2
- package/kfd.release.json +13 -0
- package/package.json +11 -2
- package/release-impact.json +59 -0
|
@@ -0,0 +1,260 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 1,
|
|
3
|
+
"contract": "kfd-3-collaboration-interface",
|
|
4
|
+
"standard": "kfd-3",
|
|
5
|
+
"product": {
|
|
6
|
+
"name": "KFD",
|
|
7
|
+
"version": "v1.0",
|
|
8
|
+
"repository": "kungfu-systems/kfd"
|
|
9
|
+
},
|
|
10
|
+
"sourceRegistry": {
|
|
11
|
+
"path": "registry.json"
|
|
12
|
+
},
|
|
13
|
+
"participants": [
|
|
14
|
+
{
|
|
15
|
+
"id": "human-reader",
|
|
16
|
+
"kind": "human",
|
|
17
|
+
"description": "A person reading KFD decisions, philosophy, and release evidence."
|
|
18
|
+
},
|
|
19
|
+
{
|
|
20
|
+
"id": "agent-reader",
|
|
21
|
+
"kind": "agent",
|
|
22
|
+
"description": "An agent consuming KFD registry, standards metadata, schemas, and package exports."
|
|
23
|
+
},
|
|
24
|
+
{
|
|
25
|
+
"id": "maintainer",
|
|
26
|
+
"kind": "maintainer",
|
|
27
|
+
"description": "A human or agent maintaining KFD decisions, metadata, package surfaces, and release evidence."
|
|
28
|
+
},
|
|
29
|
+
{
|
|
30
|
+
"id": "package-consumer",
|
|
31
|
+
"kind": "api-consumer",
|
|
32
|
+
"description": "A downstream repository consuming the @kungfu-tech/kfd package."
|
|
33
|
+
},
|
|
34
|
+
{
|
|
35
|
+
"id": "site-consumer",
|
|
36
|
+
"kind": "service-integrator",
|
|
37
|
+
"description": "A site repository consuming KFD's site bundle, registry, standards metadata, and decision text."
|
|
38
|
+
},
|
|
39
|
+
{
|
|
40
|
+
"id": "release-system",
|
|
41
|
+
"kind": "service-integrator",
|
|
42
|
+
"description": "A release system consuming KFD witnesses, impact ledgers, and release propagation contracts."
|
|
43
|
+
}
|
|
44
|
+
],
|
|
45
|
+
"minimalEntrypoints": [
|
|
46
|
+
{
|
|
47
|
+
"id": "readme",
|
|
48
|
+
"surface": "README.md",
|
|
49
|
+
"participants": ["human-reader", "agent-reader"],
|
|
50
|
+
"purpose": "Start from the KFD worldview and current decision set."
|
|
51
|
+
},
|
|
52
|
+
{
|
|
53
|
+
"id": "docs-map",
|
|
54
|
+
"surface": "docs/MAP.md",
|
|
55
|
+
"participants": ["human-reader", "agent-reader", "maintainer"],
|
|
56
|
+
"purpose": "Route readers and agents to the right KFD document or machine surface."
|
|
57
|
+
},
|
|
58
|
+
{
|
|
59
|
+
"id": "registry",
|
|
60
|
+
"surface": "registry.json",
|
|
61
|
+
"participants": ["agent-reader", "package-consumer", "site-consumer"],
|
|
62
|
+
"purpose": "Consume the authoritative decision index."
|
|
63
|
+
},
|
|
64
|
+
{
|
|
65
|
+
"id": "standards",
|
|
66
|
+
"surface": "standards.json",
|
|
67
|
+
"participants": ["agent-reader", "package-consumer", "release-system"],
|
|
68
|
+
"purpose": "Discover KFD schema IDs, schema paths, concepts, and interface contracts."
|
|
69
|
+
},
|
|
70
|
+
{
|
|
71
|
+
"id": "package-exports",
|
|
72
|
+
"surface": "package.json#exports",
|
|
73
|
+
"participants": ["package-consumer", "agent-reader"],
|
|
74
|
+
"purpose": "Consume the shipped npm package surfaces."
|
|
75
|
+
},
|
|
76
|
+
{
|
|
77
|
+
"id": "release-anchor",
|
|
78
|
+
"surface": "kfd.release.json",
|
|
79
|
+
"participants": ["release-system", "agent-reader"],
|
|
80
|
+
"purpose": "Inspect the explicit KFD package version anchor for the current Buildchain release line."
|
|
81
|
+
},
|
|
82
|
+
{
|
|
83
|
+
"id": "site-bundle",
|
|
84
|
+
"surface": "site/kfd-site.json",
|
|
85
|
+
"participants": ["site-consumer", "agent-reader"],
|
|
86
|
+
"purpose": "Render KFD-owned site text and decision pages without duplicating extraction logic."
|
|
87
|
+
}
|
|
88
|
+
],
|
|
89
|
+
"surfaces": [
|
|
90
|
+
{
|
|
91
|
+
"id": "readme",
|
|
92
|
+
"kind": "markdown-doc",
|
|
93
|
+
"participants": ["human-reader", "agent-reader"],
|
|
94
|
+
"value": "KFD's public worldview entrypoint and site homepage text source.",
|
|
95
|
+
"discoverability": { "fromMinimalEntrypoint": true, "path": "README.md" },
|
|
96
|
+
"maturity": "stable"
|
|
97
|
+
},
|
|
98
|
+
{
|
|
99
|
+
"id": "docs-map",
|
|
100
|
+
"kind": "markdown-doc",
|
|
101
|
+
"participants": ["human-reader", "agent-reader", "maintainer"],
|
|
102
|
+
"value": "Document map for routing questions to KFD decisions and machine surfaces.",
|
|
103
|
+
"discoverability": { "fromMinimalEntrypoint": true, "path": "docs/MAP.md" },
|
|
104
|
+
"maturity": "stable"
|
|
105
|
+
},
|
|
106
|
+
{
|
|
107
|
+
"id": "decision-texts",
|
|
108
|
+
"kind": "markdown-doc",
|
|
109
|
+
"participants": ["human-reader", "agent-reader", "maintainer"],
|
|
110
|
+
"value": "Append-only authoritative KFD decision texts.",
|
|
111
|
+
"discoverability": { "fromMinimalEntrypoint": true, "path": "decisions/*.md" },
|
|
112
|
+
"maturity": "stable"
|
|
113
|
+
},
|
|
114
|
+
{
|
|
115
|
+
"id": "registry-json",
|
|
116
|
+
"kind": "json-api",
|
|
117
|
+
"participants": ["agent-reader", "package-consumer", "site-consumer"],
|
|
118
|
+
"value": "Authoritative machine-readable KFD decision index.",
|
|
119
|
+
"discoverability": { "fromMinimalEntrypoint": true, "path": "registry.json" },
|
|
120
|
+
"maturity": "stable"
|
|
121
|
+
},
|
|
122
|
+
{
|
|
123
|
+
"id": "standards-json",
|
|
124
|
+
"kind": "json-api",
|
|
125
|
+
"participants": ["agent-reader", "package-consumer", "release-system"],
|
|
126
|
+
"value": "Machine-readable KFD standards metadata and schema/interface registry.",
|
|
127
|
+
"discoverability": { "fromMinimalEntrypoint": true, "path": "standards.json" },
|
|
128
|
+
"maturity": "stable"
|
|
129
|
+
},
|
|
130
|
+
{
|
|
131
|
+
"id": "schemas",
|
|
132
|
+
"kind": "json-api",
|
|
133
|
+
"participants": ["agent-reader", "package-consumer", "release-system"],
|
|
134
|
+
"value": "KFD-owned JSON schemas for standards metadata and KFD-1/2/3 interfaces.",
|
|
135
|
+
"discoverability": { "fromMinimalEntrypoint": true, "path": "schemas/**/*.json" },
|
|
136
|
+
"maturity": "stable"
|
|
137
|
+
},
|
|
138
|
+
{
|
|
139
|
+
"id": "package-exports",
|
|
140
|
+
"kind": "package",
|
|
141
|
+
"participants": ["package-consumer", "agent-reader"],
|
|
142
|
+
"value": "The npm package export map for KFD registry, standards, decisions, docs, schemas, and witnesses.",
|
|
143
|
+
"discoverability": { "fromMinimalEntrypoint": true, "path": "package.json#exports" },
|
|
144
|
+
"maturity": "stable"
|
|
145
|
+
},
|
|
146
|
+
{
|
|
147
|
+
"id": "site-bundle-json",
|
|
148
|
+
"kind": "json-api",
|
|
149
|
+
"participants": ["site-consumer", "agent-reader"],
|
|
150
|
+
"value": "KFD-owned content projection consumed by the public site renderer.",
|
|
151
|
+
"discoverability": { "fromMinimalEntrypoint": true, "path": "site/kfd-site.json" },
|
|
152
|
+
"maturity": "stable"
|
|
153
|
+
},
|
|
154
|
+
{
|
|
155
|
+
"id": "release-impact-json",
|
|
156
|
+
"kind": "json-api",
|
|
157
|
+
"participants": ["release-system", "maintainer", "agent-reader"],
|
|
158
|
+
"value": "Release impact declaration consumed by Buildchain release passports.",
|
|
159
|
+
"discoverability": { "fromMinimalEntrypoint": true, "path": "release-impact.json" },
|
|
160
|
+
"maturity": "stable"
|
|
161
|
+
},
|
|
162
|
+
{
|
|
163
|
+
"id": "release-anchor-json",
|
|
164
|
+
"kind": "json-api",
|
|
165
|
+
"participants": ["release-system", "agent-reader", "maintainer"],
|
|
166
|
+
"value": "Anchored/manual release manifest that declares the exact npm version as a release fact.",
|
|
167
|
+
"discoverability": { "fromMinimalEntrypoint": true, "path": "kfd.release.json" },
|
|
168
|
+
"maturity": "stable"
|
|
169
|
+
},
|
|
170
|
+
{
|
|
171
|
+
"id": "release-propagation-json",
|
|
172
|
+
"kind": "json-api",
|
|
173
|
+
"participants": ["release-system", "site-consumer"],
|
|
174
|
+
"value": "Release propagation graph from KFD to downstream site surfaces.",
|
|
175
|
+
"discoverability": { "fromMinimalEntrypoint": true, "path": "buildchain.release-propagation.json" },
|
|
176
|
+
"maturity": "stable"
|
|
177
|
+
},
|
|
178
|
+
{
|
|
179
|
+
"id": "kfd-1-witness",
|
|
180
|
+
"kind": "json-api",
|
|
181
|
+
"participants": ["release-system", "maintainer", "agent-reader"],
|
|
182
|
+
"value": "KFD-1 contract-world witness for source-to-artifact drift checks.",
|
|
183
|
+
"discoverability": { "fromMinimalEntrypoint": true, "path": ".buildchain/kfd-1/contract-world.witness.json" },
|
|
184
|
+
"maturity": "stable"
|
|
185
|
+
},
|
|
186
|
+
{
|
|
187
|
+
"id": "kfd-3-self-witnesses",
|
|
188
|
+
"kind": "json-api",
|
|
189
|
+
"participants": ["release-system", "maintainer", "agent-reader"],
|
|
190
|
+
"value": "KFD-3 self collaboration-interface witnesses for pre-build and artifact-side closure checks.",
|
|
191
|
+
"discoverability": { "fromMinimalEntrypoint": true, "path": ".buildchain/kfd-3/*.json" },
|
|
192
|
+
"maturity": "stable"
|
|
193
|
+
},
|
|
194
|
+
{
|
|
195
|
+
"id": "release-workflows",
|
|
196
|
+
"kind": "config",
|
|
197
|
+
"participants": ["release-system", "maintainer"],
|
|
198
|
+
"value": "GitHub Actions workflows that invoke Buildchain verification, promotion, and propagation.",
|
|
199
|
+
"discoverability": { "fromMinimalEntrypoint": true, "path": ".github/workflows/*.yml" },
|
|
200
|
+
"maturity": "stable"
|
|
201
|
+
}
|
|
202
|
+
],
|
|
203
|
+
"transparentConstraints": [
|
|
204
|
+
{
|
|
205
|
+
"id": "append-only-decisions",
|
|
206
|
+
"surface": "decisions/*.md",
|
|
207
|
+
"constraint": "Substantive semantic changes supersede older KFD numbers instead of rewriting them.",
|
|
208
|
+
"reason": "Decision history must remain inspectable by humans and agents.",
|
|
209
|
+
"review": "CONTRIBUTING.md and node scripts/check.mjs"
|
|
210
|
+
},
|
|
211
|
+
{
|
|
212
|
+
"id": "kfd-site-boundary",
|
|
213
|
+
"surface": "site/kfd-site.json",
|
|
214
|
+
"constraint": "KFD owns homepage text, decision text, registry, and standards metadata; the site owns rendering style and layout.",
|
|
215
|
+
"reason": "Text remains a single fact source while the site stays free to render it.",
|
|
216
|
+
"review": "site/kfd-site.json renderingBoundary"
|
|
217
|
+
},
|
|
218
|
+
{
|
|
219
|
+
"id": "package-export-boundary",
|
|
220
|
+
"surface": "package.json#exports",
|
|
221
|
+
"constraint": "Public package surfaces must be explicitly exported and verified.",
|
|
222
|
+
"reason": "Agents and downstream repositories should not rely on hidden package internals.",
|
|
223
|
+
"review": "node scripts/check.mjs"
|
|
224
|
+
},
|
|
225
|
+
{
|
|
226
|
+
"id": "standard-not-runtime",
|
|
227
|
+
"surface": "README.md",
|
|
228
|
+
"constraint": "KFD provides decisions, standards metadata, schemas, and witnesses; it does not provide the Kungfu runtime, GUI, or CLI.",
|
|
229
|
+
"reason": "KFD should remain a standard/decision package, not a product runtime.",
|
|
230
|
+
"review": "docs/MAP.md"
|
|
231
|
+
}
|
|
232
|
+
],
|
|
233
|
+
"choicePaths": [
|
|
234
|
+
{
|
|
235
|
+
"id": "read-human-docs",
|
|
236
|
+
"participants": ["human-reader"],
|
|
237
|
+
"choice": "Read README.md, docs/MAP.md, and decisions/*.md directly."
|
|
238
|
+
},
|
|
239
|
+
{
|
|
240
|
+
"id": "consume-machine-metadata",
|
|
241
|
+
"participants": ["agent-reader", "package-consumer", "release-system"],
|
|
242
|
+
"choice": "Consume registry.json, standards.json, schemas, and package exports."
|
|
243
|
+
},
|
|
244
|
+
{
|
|
245
|
+
"id": "render-site",
|
|
246
|
+
"participants": ["site-consumer"],
|
|
247
|
+
"choice": "Consume site/kfd-site.json and own rendering/style decisions downstream."
|
|
248
|
+
},
|
|
249
|
+
{
|
|
250
|
+
"id": "maintain-through-pr",
|
|
251
|
+
"participants": ["maintainer"],
|
|
252
|
+
"choice": "Change KFD through PR review, node scripts/check.mjs, and Buildchain release gates."
|
|
253
|
+
}
|
|
254
|
+
],
|
|
255
|
+
"closure": {
|
|
256
|
+
"classificationMode": "closed-world",
|
|
257
|
+
"unclassifiedEntrypointsPolicy": "fail",
|
|
258
|
+
"reachableSurfaceSource": "This file plus package.json#exports, docs/MAP.md, registry.json, standards.json, and Buildchain witness files."
|
|
259
|
+
}
|
|
260
|
+
}
|