perttool 0.1.0-alpha.2 → 0.2.0

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.
Files changed (99) hide show
  1. package/CHANGELOG.md +78 -28
  2. package/README.md +173 -95
  3. package/dist/application/agent-help.d.ts +3 -0
  4. package/dist/application/agent-help.d.ts.map +1 -0
  5. package/dist/application/agent-help.js +5 -0
  6. package/dist/application/agent-help.js.map +1 -0
  7. package/dist/application/analyze.js +5 -5
  8. package/dist/application/analyze.js.map +1 -1
  9. package/dist/application/init.d.ts +42 -0
  10. package/dist/application/init.d.ts.map +1 -0
  11. package/dist/application/init.js +217 -0
  12. package/dist/application/init.js.map +1 -0
  13. package/dist/application/mutate.d.ts.map +1 -1
  14. package/dist/application/mutate.js +28 -15
  15. package/dist/application/mutate.js.map +1 -1
  16. package/dist/application/project.d.ts +25 -0
  17. package/dist/application/project.d.ts.map +1 -0
  18. package/dist/application/project.js +54 -0
  19. package/dist/application/project.js.map +1 -0
  20. package/dist/cli.js +419 -331
  21. package/dist/cli.js.map +1 -1
  22. package/dist/command/discovery.d.ts +30 -0
  23. package/dist/command/discovery.d.ts.map +1 -0
  24. package/dist/command/discovery.js +625 -0
  25. package/dist/command/discovery.js.map +1 -0
  26. package/dist/command/registry.d.ts +84 -0
  27. package/dist/command/registry.d.ts.map +1 -0
  28. package/dist/command/registry.js +951 -0
  29. package/dist/command/registry.js.map +1 -0
  30. package/dist/command/usage.d.ts +42 -0
  31. package/dist/command/usage.d.ts.map +1 -0
  32. package/dist/command/usage.js +337 -0
  33. package/dist/command/usage.js.map +1 -0
  34. package/dist/conversion/mermaid-import.js +56 -56
  35. package/dist/conversion/mermaid-import.js.map +1 -1
  36. package/dist/conversion/mermaid.js +1 -1
  37. package/dist/conversion/mermaid.js.map +1 -1
  38. package/dist/guidance/profile.d.ts +6 -0
  39. package/dist/guidance/profile.d.ts.map +1 -0
  40. package/dist/guidance/profile.js +1158 -0
  41. package/dist/guidance/profile.js.map +1 -0
  42. package/dist/guidance/projection.d.ts +16 -0
  43. package/dist/guidance/projection.d.ts.map +1 -0
  44. package/dist/guidance/projection.js +276 -0
  45. package/dist/guidance/projection.js.map +1 -0
  46. package/dist/guidance/query.d.ts +4 -0
  47. package/dist/guidance/query.d.ts.map +1 -0
  48. package/dist/guidance/query.js +178 -0
  49. package/dist/guidance/query.js.map +1 -0
  50. package/dist/guidance/text.d.ts +4 -0
  51. package/dist/guidance/text.d.ts.map +1 -0
  52. package/dist/guidance/text.js +118 -0
  53. package/dist/guidance/text.js.map +1 -0
  54. package/dist/guidance/types.d.ts +227 -0
  55. package/dist/guidance/types.d.ts.map +1 -0
  56. package/dist/guidance/types.js +54 -0
  57. package/dist/guidance/types.js.map +1 -0
  58. package/dist/guidance/validator.d.ts +8 -0
  59. package/dist/guidance/validator.d.ts.map +1 -0
  60. package/dist/guidance/validator.js +383 -0
  61. package/dist/guidance/validator.js.map +1 -0
  62. package/dist/help/guide.d.ts +12 -0
  63. package/dist/help/guide.d.ts.map +1 -0
  64. package/dist/help/guide.js +103 -0
  65. package/dist/help/guide.js.map +1 -0
  66. package/dist/help/registry.d.ts.map +1 -1
  67. package/dist/help/registry.js +76 -67
  68. package/dist/help/registry.js.map +1 -1
  69. package/dist/index.d.ts +21 -1
  70. package/dist/index.d.ts.map +1 -1
  71. package/dist/index.js +13 -0
  72. package/dist/index.js.map +1 -1
  73. package/dist/io/safe-write.js +17 -17
  74. package/dist/io/safe-write.js.map +1 -1
  75. package/dist/mutation/gate.d.ts +5 -0
  76. package/dist/mutation/gate.d.ts.map +1 -0
  77. package/dist/mutation/gate.js +156 -0
  78. package/dist/mutation/gate.js.map +1 -0
  79. package/dist/mutation/milestone.js +26 -26
  80. package/dist/mutation/milestone.js.map +1 -1
  81. package/dist/mutation/project.d.ts +5 -0
  82. package/dist/mutation/project.d.ts.map +1 -0
  83. package/dist/mutation/project.js +148 -0
  84. package/dist/mutation/project.js.map +1 -0
  85. package/dist/mutation/resource.js +22 -22
  86. package/dist/mutation/resource.js.map +1 -1
  87. package/dist/mutation/task.js +40 -40
  88. package/dist/mutation/task.js.map +1 -1
  89. package/dist/mutation/types.d.ts +46 -1
  90. package/dist/mutation/types.d.ts.map +1 -1
  91. package/dist/parser/document-parser.js +17 -17
  92. package/dist/parser/document-parser.js.map +1 -1
  93. package/dist/semantic/validator.js +41 -41
  94. package/dist/semantic/validator.js.map +1 -1
  95. package/dist/version.d.ts +1 -1
  96. package/dist/version.d.ts.map +1 -1
  97. package/dist/version.js +1 -1
  98. package/dist/version.js.map +1 -1
  99. package/package.json +4 -4
@@ -0,0 +1,383 @@
1
+ import { createHash } from "node:crypto";
2
+ import { compareStableStrings } from "../model/diagnostics.js";
3
+ import { AGENT_GUIDANCE_DIRECTIVES, AGENT_GUIDANCE_ORIGINS, AGENT_GUIDANCE_PROVIDER_IDS, AGENT_GUIDANCE_RISK_KINDS, AGENT_GUIDANCE_SCOPE_IDS, AGENT_GUIDANCE_SUPPORT_STATUSES, AGENT_GUIDANCE_SURFACE_IDS, } from "./types.js";
4
+ const evidenceKinds = {
5
+ native: "official_native_documentation",
6
+ compatible: "official_compatibility_documentation",
7
+ preview: "official_preview_notice",
8
+ deprecated: "official_deprecation_notice",
9
+ unsupported: "official_unsupported_notice",
10
+ unknown: "insufficient_official_evidence",
11
+ };
12
+ export function compareAgentGuidanceUtf8(left, right) {
13
+ return Buffer.compare(Buffer.from(left, "utf8"), Buffer.from(right, "utf8"));
14
+ }
15
+ function descriptionJson(description) {
16
+ return {
17
+ key: description.key,
18
+ parameters: description.parameters.map(({ name, value }) => ({
19
+ name,
20
+ value,
21
+ })),
22
+ text: description.text,
23
+ };
24
+ }
25
+ function evidenceJson(evidence) {
26
+ return {
27
+ evidence_kind: evidence.evidenceKind,
28
+ source_ids: evidence.sourceIds,
29
+ facts: evidence.facts,
30
+ description: descriptionJson(evidence.description),
31
+ };
32
+ }
33
+ function artifactJson(artifact) {
34
+ return {
35
+ artifact_id: artifact.artifactId,
36
+ path: artifact.path,
37
+ scope_ids: artifact.scopeIds,
38
+ primary: artifact.primary,
39
+ support_status: artifact.supportStatus,
40
+ status_evidence: evidenceJson(artifact.statusEvidence),
41
+ };
42
+ }
43
+ export function agentGuidanceProfileToJson(profile) {
44
+ return {
45
+ schema_version: profile.schemaVersion,
46
+ profile_data_version: profile.profileDataVersion,
47
+ guidance_taxonomy_version: profile.guidanceTaxonomyVersion,
48
+ risk_taxonomy_version: profile.riskTaxonomyVersion,
49
+ description_registry_version: profile.descriptionRegistryVersion,
50
+ description_locale: profile.descriptionLocale,
51
+ staleness_policy_version: profile.stalenessPolicyVersion,
52
+ snapshot_as_of: profile.snapshotAsOf,
53
+ provider_order: profile.providerOrder,
54
+ surface_order: profile.surfaceOrder,
55
+ aliases: profile.aliases.map(({ alias, providerId }) => ({
56
+ alias,
57
+ provider_id: providerId,
58
+ })),
59
+ providers: profile.providers.map((provider) => ({
60
+ provider_id: provider.providerId,
61
+ display_name: provider.displayName,
62
+ aliases: provider.aliases,
63
+ surfaces: provider.surfaces.map((surface) => ({
64
+ surface_id: surface.surfaceId,
65
+ support_status: surface.supportStatus,
66
+ primary_artifact_id: surface.primaryArtifactId,
67
+ artifact_resolution: surface.artifactResolution,
68
+ provider_terms: surface.providerTerms,
69
+ scopes: surface.scopes,
70
+ artifacts: surface.artifacts.map(artifactJson),
71
+ guidance_ids: surface.guidanceIds,
72
+ risk_ids: surface.riskIds,
73
+ status_evidence: evidenceJson(surface.statusEvidence),
74
+ verified_at: surface.verifiedAt,
75
+ review_after: surface.reviewAfter,
76
+ })),
77
+ })),
78
+ guidance_registry: profile.guidanceRegistry.map((record) => ({
79
+ guidance_id: record.guidanceId,
80
+ origin: record.origin,
81
+ directive: record.directive,
82
+ surface_ids: record.surfaceIds,
83
+ description: descriptionJson(record.description),
84
+ })),
85
+ risk_registry: profile.riskRegistry.map((record) => ({
86
+ risk_id: record.riskId,
87
+ kind: record.kind,
88
+ surface_ids: record.surfaceIds,
89
+ mitigation_guidance_ids: record.mitigationGuidanceIds,
90
+ description: descriptionJson(record.description),
91
+ })),
92
+ sources: profile.sources.map((source) => ({
93
+ source_id: source.sourceId,
94
+ provider_id: source.providerId,
95
+ title: source.title,
96
+ url: source.url,
97
+ verified_at: source.verifiedAt,
98
+ })),
99
+ };
100
+ }
101
+ export function serializeAgentGuidanceProfile(profile) {
102
+ return `${JSON.stringify(agentGuidanceProfileToJson(profile), null, 2)}\n`;
103
+ }
104
+ export function digestAgentGuidanceProfile(canonicalJson) {
105
+ return `sha256:${createHash("sha256").update(canonicalJson, "utf8").digest("hex")}`;
106
+ }
107
+ export function createAgentGuidanceProfileSnapshot(profile) {
108
+ const canonicalJson = serializeAgentGuidanceProfile(profile);
109
+ return {
110
+ profile,
111
+ canonicalJson,
112
+ profileDigest: digestAgentGuidanceProfile(canonicalJson),
113
+ };
114
+ }
115
+ function diagnostic(code, message, providerId = null, surfaceId = null) {
116
+ return {
117
+ code,
118
+ severity: "error",
119
+ message,
120
+ providerId,
121
+ surfaceId,
122
+ };
123
+ }
124
+ function sameStrings(actual, expected) {
125
+ return (actual.length === expected.length &&
126
+ actual.every((value, index) => value === expected[index]));
127
+ }
128
+ function isCanonicalDate(value) {
129
+ if (!/^\d{4}-\d{2}-\d{2}$/.test(value))
130
+ return false;
131
+ const [year, month, day] = value.split("-").map(Number);
132
+ if (year === undefined || month === undefined || day === undefined) {
133
+ return false;
134
+ }
135
+ const date = new Date(Date.UTC(year, month - 1, day));
136
+ return (date.getUTCFullYear() === year &&
137
+ date.getUTCMonth() === month - 1 &&
138
+ date.getUTCDate() === day);
139
+ }
140
+ function isCanonicalOptionalDate(value) {
141
+ return value === null || isCanonicalDate(value);
142
+ }
143
+ function isCanonicalSubset(actual, canonical, allowEmpty) {
144
+ if ((!allowEmpty && actual.length === 0) || new Set(actual).size !== actual.length) {
145
+ return false;
146
+ }
147
+ let previous = -1;
148
+ for (const value of actual) {
149
+ const index = canonical.indexOf(value);
150
+ if (index <= previous)
151
+ return false;
152
+ previous = index;
153
+ }
154
+ return true;
155
+ }
156
+ const scopeRank = new Map(AGENT_GUIDANCE_SCOPE_IDS.map((scopeId, index) => [scopeId, index]));
157
+ function compareArtifacts(left, right) {
158
+ return (Number(right.primary) - Number(left.primary) ||
159
+ (scopeRank.get(left.scopeIds[0]) ?? Number.MAX_SAFE_INTEGER) -
160
+ (scopeRank.get(right.scopeIds[0]) ?? Number.MAX_SAFE_INTEGER) ||
161
+ compareAgentGuidanceUtf8(left.path, right.path) ||
162
+ compareAgentGuidanceUtf8(left.artifactId, right.artifactId));
163
+ }
164
+ function checkDescription(value, expectedKey, registry, diagnostics, providerId, surfaceId) {
165
+ if (value.key !== expectedKey ||
166
+ value.parameters.some(({ name, value: parameterValue }) => name.length === 0 || parameterValue.length === 0) ||
167
+ value.text.length === 0) {
168
+ diagnostics.push(diagnostic("PTAGT-303", `Description ${expectedKey} does not match the canonical registry shape.`, providerId, surfaceId));
169
+ return;
170
+ }
171
+ const signature = `${value.key}\u0000${JSON.stringify(value.parameters)}`;
172
+ const registered = registry.get(signature);
173
+ if (registered !== undefined && registered !== value.text) {
174
+ diagnostics.push(diagnostic("PTAGT-303", `Description ${expectedKey} has conflicting canonical text.`, providerId, surfaceId));
175
+ return;
176
+ }
177
+ registry.set(signature, value.text);
178
+ }
179
+ function checkEvidence(value, status, sourceProvider, providerId, surfaceId, descriptionRegistry, diagnostics) {
180
+ if (value.evidenceKind !== evidenceKinds[status] ||
181
+ value.sourceIds.length === 0 ||
182
+ new Set(value.sourceIds).size !== value.sourceIds.length ||
183
+ value.facts.length === 0 ||
184
+ value.facts.some((fact) => fact.length === 0)) {
185
+ diagnostics.push(diagnostic("PTAGT-302", `Support evidence does not match status ${status}.`, providerId, surfaceId));
186
+ }
187
+ for (const sourceId of value.sourceIds) {
188
+ if (sourceProvider.get(sourceId) !== providerId) {
189
+ diagnostics.push(diagnostic("PTAGT-302", `Source ${sourceId} is missing or belongs to another provider.`, providerId, surfaceId));
190
+ }
191
+ }
192
+ checkDescription(value.description, `status.${status}`, descriptionRegistry, diagnostics, providerId, surfaceId);
193
+ }
194
+ function sortValidationDiagnostics(diagnostics) {
195
+ return [...diagnostics].sort((left, right) => compareStableStrings(left.code, right.code) ||
196
+ compareStableStrings(left.providerId ?? "", right.providerId ?? "") ||
197
+ compareStableStrings(left.surfaceId ?? "", right.surfaceId ?? "") ||
198
+ compareStableStrings(left.message, right.message));
199
+ }
200
+ function isAbsoluteHttpsUrl(value) {
201
+ try {
202
+ const parsed = new URL(value);
203
+ return parsed.protocol === "https:" && parsed.hostname.length > 0;
204
+ }
205
+ catch {
206
+ return false;
207
+ }
208
+ }
209
+ export function validateAgentGuidanceProfile(profileOrSnapshot) {
210
+ const snapshot = "profile" in profileOrSnapshot
211
+ ? profileOrSnapshot
212
+ : createAgentGuidanceProfileSnapshot(profileOrSnapshot);
213
+ const { profile } = snapshot;
214
+ const diagnostics = [];
215
+ const canonicalJson = serializeAgentGuidanceProfile(profile);
216
+ const profileDigest = digestAgentGuidanceProfile(canonicalJson);
217
+ if (snapshot.canonicalJson !== canonicalJson ||
218
+ snapshot.profileDigest !== profileDigest) {
219
+ diagnostics.push(diagnostic("PTAGT-303", "Profile canonical bytes or digest do not match the supplied snapshot."));
220
+ }
221
+ if (profile.schemaVersion !== "Perttool.AgentGuidanceProfile.v1" ||
222
+ profile.profileDataVersion !== 1 ||
223
+ profile.guidanceTaxonomyVersion !== 1 ||
224
+ profile.riskTaxonomyVersion !== 1 ||
225
+ profile.descriptionRegistryVersion !== 1 ||
226
+ profile.descriptionLocale !== "en" ||
227
+ profile.stalenessPolicyVersion !== 1) {
228
+ diagnostics.push(diagnostic("PTAGT-301", "The profile uses an unsupported version identity combination."));
229
+ }
230
+ if (!isCanonicalDate(profile.snapshotAsOf) ||
231
+ !sameStrings(profile.providerOrder, AGENT_GUIDANCE_PROVIDER_IDS) ||
232
+ !sameStrings(profile.surfaceOrder, AGENT_GUIDANCE_SURFACE_IDS)) {
233
+ diagnostics.push(diagnostic("PTAGT-302", "Profile date, provider order, or surface order is invalid."));
234
+ }
235
+ const providerIds = new Set(profile.providers.map(({ providerId }) => providerId));
236
+ if (profile.providers.length !== AGENT_GUIDANCE_PROVIDER_IDS.length ||
237
+ providerIds.size !== profile.providers.length ||
238
+ !sameStrings(profile.providers.map(({ providerId }) => providerId), AGENT_GUIDANCE_PROVIDER_IDS)) {
239
+ diagnostics.push(diagnostic("PTAGT-302", "Providers must be complete, unique, and canonically ordered."));
240
+ }
241
+ const aliases = new Set();
242
+ const canonicalProviderIds = new Set(AGENT_GUIDANCE_PROVIDER_IDS);
243
+ for (const { alias, providerId } of profile.aliases) {
244
+ if (alias.length === 0 ||
245
+ aliases.has(alias) ||
246
+ canonicalProviderIds.has(alias) ||
247
+ !providerIds.has(providerId)) {
248
+ diagnostics.push(diagnostic("PTAGT-302", `Alias ${alias} is duplicated, colliding, or has an unknown target.`, providerId));
249
+ }
250
+ aliases.add(alias);
251
+ }
252
+ if (!sameStrings(profile.aliases.map(({ alias }) => alias), ["grok"]) ||
253
+ profile.aliases[0]?.providerId !== "grok-build") {
254
+ diagnostics.push(diagnostic("PTAGT-302", "Version 1 aliases do not match the contract."));
255
+ }
256
+ const sourceProvider = new Map();
257
+ const expectedSources = [...profile.sources].sort((left, right) => AGENT_GUIDANCE_PROVIDER_IDS.indexOf(left.providerId) -
258
+ AGENT_GUIDANCE_PROVIDER_IDS.indexOf(right.providerId) ||
259
+ compareAgentGuidanceUtf8(left.sourceId, right.sourceId));
260
+ if (!sameStrings(profile.sources.map(({ sourceId }) => sourceId), expectedSources.map(({ sourceId }) => sourceId))) {
261
+ diagnostics.push(diagnostic("PTAGT-302", "Sources are not canonically ordered."));
262
+ }
263
+ for (const source of profile.sources) {
264
+ if (sourceProvider.has(source.sourceId) ||
265
+ !providerIds.has(source.providerId) ||
266
+ source.title.length === 0 ||
267
+ !isAbsoluteHttpsUrl(source.url) ||
268
+ !isCanonicalDate(source.verifiedAt) ||
269
+ source.verifiedAt > profile.snapshotAsOf) {
270
+ diagnostics.push(diagnostic("PTAGT-302", `Source ${source.sourceId} is invalid.`, source.providerId));
271
+ }
272
+ sourceProvider.set(source.sourceId, source.providerId);
273
+ }
274
+ const descriptionRegistry = new Map();
275
+ const guidanceIds = new Set();
276
+ let previousOrigin = -1;
277
+ for (const guidance of profile.guidanceRegistry) {
278
+ const originIndex = AGENT_GUIDANCE_ORIGINS.indexOf(guidance.origin);
279
+ if (guidanceIds.has(guidance.guidanceId) ||
280
+ originIndex < previousOrigin ||
281
+ !AGENT_GUIDANCE_DIRECTIVES.includes(guidance.directive) ||
282
+ !isCanonicalSubset(guidance.surfaceIds, AGENT_GUIDANCE_SURFACE_IDS, true) ||
283
+ (guidance.origin === "project_control" &&
284
+ (guidance.directive !== "must" || guidance.surfaceIds.length !== 0))) {
285
+ diagnostics.push(diagnostic("PTAGT-302", `Guidance ${guidance.guidanceId} violates taxonomy or composition order.`));
286
+ }
287
+ previousOrigin = originIndex;
288
+ guidanceIds.add(guidance.guidanceId);
289
+ checkDescription(guidance.description, `guidance.${guidance.guidanceId}`, descriptionRegistry, diagnostics, null, null);
290
+ }
291
+ const riskIds = new Set();
292
+ for (const risk of profile.riskRegistry) {
293
+ if (riskIds.has(risk.riskId) ||
294
+ !AGENT_GUIDANCE_RISK_KINDS.includes(risk.kind) ||
295
+ !isCanonicalSubset(risk.surfaceIds, AGENT_GUIDANCE_SURFACE_IDS, false) ||
296
+ risk.mitigationGuidanceIds.length === 0 ||
297
+ new Set(risk.mitigationGuidanceIds).size !==
298
+ risk.mitigationGuidanceIds.length ||
299
+ risk.mitigationGuidanceIds.some((guidanceId) => !guidanceIds.has(guidanceId))) {
300
+ diagnostics.push(diagnostic("PTAGT-302", `Risk ${risk.riskId} violates taxonomy or reference closure.`));
301
+ }
302
+ riskIds.add(risk.riskId);
303
+ checkDescription(risk.description, `risk.${risk.riskId}`, descriptionRegistry, diagnostics, null, null);
304
+ }
305
+ for (const provider of profile.providers) {
306
+ const expectedAliases = profile.aliases
307
+ .filter(({ providerId }) => providerId === provider.providerId)
308
+ .map(({ alias }) => alias);
309
+ if (provider.displayName.length === 0 ||
310
+ !sameStrings(provider.aliases, expectedAliases) ||
311
+ !sameStrings(provider.surfaces.map(({ surfaceId }) => surfaceId), AGENT_GUIDANCE_SURFACE_IDS)) {
312
+ diagnostics.push(diagnostic("PTAGT-302", "Provider metadata or surface order is invalid.", provider.providerId));
313
+ }
314
+ for (const surface of provider.surfaces) {
315
+ if (!AGENT_GUIDANCE_SUPPORT_STATUSES.includes(surface.supportStatus) ||
316
+ !isCanonicalSubset(surface.scopes, AGENT_GUIDANCE_SCOPE_IDS, false) ||
317
+ surface.providerTerms.length === 0 ||
318
+ new Set(surface.providerTerms).size !== surface.providerTerms.length) {
319
+ diagnostics.push(diagnostic("PTAGT-302", "Surface status, terms, or scopes are invalid.", provider.providerId, surface.surfaceId));
320
+ }
321
+ const primaryArtifacts = surface.artifacts.filter(({ primary }) => primary);
322
+ const sortedArtifacts = [...surface.artifacts].sort(compareArtifacts);
323
+ if (!sameStrings(surface.artifacts.map(({ artifactId }) => artifactId), sortedArtifacts.map(({ artifactId }) => artifactId)) ||
324
+ (surface.artifactResolution === "known" &&
325
+ (surface.artifacts.length === 0 ||
326
+ primaryArtifacts.length !== 1 ||
327
+ surface.primaryArtifactId !== primaryArtifacts[0]?.artifactId)) ||
328
+ (surface.artifactResolution !== "known" &&
329
+ (surface.artifacts.length !== 0 ||
330
+ primaryArtifacts.length !== 0 ||
331
+ surface.primaryArtifactId !== null))) {
332
+ diagnostics.push(diagnostic("PTAGT-302", "Artifact resolution, primary artifact, or ordering is invalid.", provider.providerId, surface.surfaceId));
333
+ }
334
+ if (primaryArtifacts[0] !== undefined &&
335
+ primaryArtifacts[0].supportStatus !== surface.supportStatus) {
336
+ diagnostics.push(diagnostic("PTAGT-302", "Surface status does not match the primary artifact.", provider.providerId, surface.surfaceId));
337
+ }
338
+ const artifactIds = new Set();
339
+ for (const artifact of surface.artifacts) {
340
+ if (artifactIds.has(artifact.artifactId) ||
341
+ artifact.path.length === 0 ||
342
+ !AGENT_GUIDANCE_SUPPORT_STATUSES.includes(artifact.supportStatus) ||
343
+ !isCanonicalSubset(artifact.scopeIds, AGENT_GUIDANCE_SCOPE_IDS, false)) {
344
+ diagnostics.push(diagnostic("PTAGT-302", `Artifact ${artifact.artifactId} is invalid.`, provider.providerId, surface.surfaceId));
345
+ }
346
+ artifactIds.add(artifact.artifactId);
347
+ checkEvidence(artifact.statusEvidence, artifact.supportStatus, sourceProvider, provider.providerId, surface.surfaceId, descriptionRegistry, diagnostics);
348
+ }
349
+ if (surface.guidanceIds.some((guidanceId) => !guidanceIds.has(guidanceId)) ||
350
+ surface.riskIds.some((riskId) => !riskIds.has(riskId)) ||
351
+ !sameStrings(surface.guidanceIds, profile.guidanceRegistry
352
+ .filter(({ surfaceIds }) => surfaceIds.length === 0 ||
353
+ surfaceIds.includes(surface.surfaceId))
354
+ .map(({ guidanceId }) => guidanceId)) ||
355
+ !sameStrings(surface.riskIds, profile.riskRegistry
356
+ .filter(({ riskId, surfaceIds }) => surfaceIds.includes(surface.surfaceId) &&
357
+ (riskId !== "artifact_path_unknown" ||
358
+ surface.artifactResolution === "unknown") &&
359
+ (riskId !== "compatibility_not_native" ||
360
+ surface.artifacts.some(({ supportStatus }) => supportStatus === "compatible")))
361
+ .map(({ riskId }) => riskId))) {
362
+ diagnostics.push(diagnostic("PTAGT-302", "Surface guidance or risk references are not closed and ordered.", provider.providerId, surface.surfaceId));
363
+ }
364
+ if (!isCanonicalOptionalDate(surface.verifiedAt) ||
365
+ !isCanonicalOptionalDate(surface.reviewAfter) ||
366
+ (surface.verifiedAt !== null &&
367
+ surface.reviewAfter !== null &&
368
+ surface.verifiedAt > surface.reviewAfter) ||
369
+ (surface.verifiedAt !== null &&
370
+ surface.verifiedAt > profile.snapshotAsOf)) {
371
+ diagnostics.push(diagnostic("PTAGT-302", "Surface staleness dates are invalid.", provider.providerId, surface.surfaceId));
372
+ }
373
+ checkEvidence(surface.statusEvidence, surface.supportStatus, sourceProvider, provider.providerId, surface.surfaceId, descriptionRegistry, diagnostics);
374
+ }
375
+ }
376
+ const sorted = sortValidationDiagnostics(diagnostics);
377
+ return {
378
+ ok: sorted.length === 0,
379
+ profileDigest,
380
+ diagnostics: sorted,
381
+ };
382
+ }
383
+ //# sourceMappingURL=validator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/guidance/validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EACL,yBAAyB,EACzB,sBAAsB,EACtB,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,+BAA+B,EAC/B,0BAA0B,GAY3B,MAAM,YAAY,CAAC;AAEpB,MAAM,aAAa,GAEf;IACF,MAAM,EAAE,+BAA+B;IACvC,UAAU,EAAE,sCAAsC;IAClD,OAAO,EAAE,yBAAyB;IAClC,UAAU,EAAE,6BAA6B;IACzC,WAAW,EAAE,6BAA6B;IAC1C,OAAO,EAAE,gCAAgC;CAC1C,CAAC;AAEF,MAAM,UAAU,wBAAwB,CACtC,IAAY,EACZ,KAAa;IAEb,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,eAAe,CAAC,WAAgC;IACvD,OAAO;QACL,GAAG,EAAE,WAAW,CAAC,GAAG;QACpB,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YAC3D,IAAI;YACJ,KAAK;SACN,CAAC,CAAC;QACH,IAAI,EAAE,WAAW,CAAC,IAAI;KACvB,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,QAAqC;IACzD,OAAO;QACL,aAAa,EAAE,QAAQ,CAAC,YAAY;QACpC,UAAU,EAAE,QAAQ,CAAC,SAAS;QAC9B,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,WAAW,EAAE,eAAe,CAAC,QAAQ,CAAC,WAAW,CAAC;KACnD,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,QAAsC;IAC1D,OAAO;QACL,WAAW,EAAE,QAAQ,CAAC,UAAU;QAChC,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,SAAS,EAAE,QAAQ,CAAC,QAAQ;QAC5B,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,cAAc,EAAE,QAAQ,CAAC,aAAa;QACtC,eAAe,EAAE,YAAY,CAAC,QAAQ,CAAC,cAAc,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,OAA6B;IAE7B,OAAO;QACL,cAAc,EAAE,OAAO,CAAC,aAAa;QACrC,oBAAoB,EAAE,OAAO,CAAC,kBAAkB;QAChD,yBAAyB,EAAE,OAAO,CAAC,uBAAuB;QAC1D,qBAAqB,EAAE,OAAO,CAAC,mBAAmB;QAClD,4BAA4B,EAAE,OAAO,CAAC,0BAA0B;QAChE,kBAAkB,EAAE,OAAO,CAAC,iBAAiB;QAC7C,wBAAwB,EAAE,OAAO,CAAC,sBAAsB;QACxD,cAAc,EAAE,OAAO,CAAC,YAAY;QACpC,cAAc,EAAE,OAAO,CAAC,aAAa;QACrC,aAAa,EAAE,OAAO,CAAC,YAAY;QACnC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;YACvD,KAAK;YACL,WAAW,EAAE,UAAU;SACxB,CAAC,CAAC;QACH,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAC9C,WAAW,EAAE,QAAQ,CAAC,UAAU;YAChC,YAAY,EAAE,QAAQ,CAAC,WAAW;YAClC,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAC5C,UAAU,EAAE,OAAO,CAAC,SAAS;gBAC7B,cAAc,EAAE,OAAO,CAAC,aAAa;gBACrC,mBAAmB,EAAE,OAAO,CAAC,iBAAiB;gBAC9C,mBAAmB,EAAE,OAAO,CAAC,kBAAkB;gBAC/C,cAAc,EAAE,OAAO,CAAC,aAAa;gBACrC,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,YAAY,CAAC;gBAC9C,YAAY,EAAE,OAAO,CAAC,WAAW;gBACjC,QAAQ,EAAE,OAAO,CAAC,OAAO;gBACzB,eAAe,EAAE,YAAY,CAAC,OAAO,CAAC,cAAc,CAAC;gBACrD,WAAW,EAAE,OAAO,CAAC,UAAU;gBAC/B,YAAY,EAAE,OAAO,CAAC,WAAW;aAClC,CAAC,CAAC;SACJ,CAAC,CAAC;QACH,iBAAiB,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC3D,WAAW,EAAE,MAAM,CAAC,UAAU;YAC9B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,WAAW,EAAE,MAAM,CAAC,UAAU;YAC9B,WAAW,EAAE,eAAe,CAAC,MAAM,CAAC,WAAW,CAAC;SACjD,CAAC,CAAC;QACH,aAAa,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACnD,OAAO,EAAE,MAAM,CAAC,MAAM;YACtB,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,WAAW,EAAE,MAAM,CAAC,UAAU;YAC9B,uBAAuB,EAAE,MAAM,CAAC,qBAAqB;YACrD,WAAW,EAAE,eAAe,CAAC,MAAM,CAAC,WAAW,CAAC;SACjD,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACxC,SAAS,EAAE,MAAM,CAAC,QAAQ;YAC1B,WAAW,EAAE,MAAM,CAAC,UAAU;YAC9B,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,WAAW,EAAE,MAAM,CAAC,UAAU;SAC/B,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,OAA6B;IAE7B,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,0BAA0B,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,aAAqB;IAC9D,OAAO,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,OAA6B;IAE7B,MAAM,aAAa,GAAG,6BAA6B,CAAC,OAAO,CAAC,CAAC;IAC7D,OAAO;QACL,OAAO;QACP,aAAa;QACb,aAAa,EAAE,0BAA0B,CAAC,aAAa,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CACjB,IAAY,EACZ,OAAe,EACf,UAAU,GAAkB,IAAI,EAChC,SAAS,GAAkB,IAAI;IAE/B,OAAO;QACL,IAAI;QACJ,QAAQ,EAAE,OAAO;QACjB,OAAO;QACP,UAAU;QACV,SAAS;KACV,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,MAAyB,EACzB,QAA2B;IAE3B,OAAO,CACL,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;QACjC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK,CAAC,CAAC,CAC1D,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,IAAI,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACnE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACtD,OAAO,CACL,IAAI,CAAC,cAAc,EAAE,KAAK,IAAI;QAC9B,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,GAAG,CAAC;QAChC,IAAI,CAAC,UAAU,EAAE,KAAK,GAAG,CAC1B,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAoB;IACnD,OAAO,KAAK,KAAK,IAAI,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,iBAAiB,CACxB,MAAoB,EACpB,SAAuB,EACvB,UAAmB;IAEnB,IAAI,CAAC,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC;QACnF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC;IAClB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACvC,IAAI,KAAK,IAAI,QAAQ;YAAE,OAAO,KAAK,CAAC;QACpC,QAAQ,GAAG,KAAK,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,SAAS,GAAG,IAAI,GAAG,CACvB,wBAAwB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CACnE,CAAC;AAEF,SAAS,gBAAgB,CACvB,IAAkC,EAClC,KAAmC;IAEnC,OAAO,CACL,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;QAC5C,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,IAAI,MAAM,CAAC,gBAAgB,CAAC;YAC3D,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,IAAI,MAAM,CAAC,gBAAgB,CAAC;QAChE,wBAAwB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC;QAC/C,wBAAwB,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAC5D,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,KAA0B,EAC1B,WAAmB,EACnB,QAA6B,EAC7B,WAAsC,EACtC,UAAyB,EACzB,SAAwB;IAExB,IACE,KAAK,CAAC,GAAG,KAAK,WAAW;QACzB,KAAK,CAAC,UAAU,CAAC,IAAI,CACnB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,CAClC,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,CACnD;QACD,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EACvB,CAAC;QACD,WAAW,CAAC,IAAI,CACd,UAAU,CACR,WAAW,EACX,eAAe,WAAW,+CAA+C,EACzE,UAAU,EACV,SAAS,CACV,CACF,CAAC;QACF,OAAO;IACT,CAAC;IACD,MAAM,SAAS,GAAG,GAAG,KAAK,CAAC,GAAG,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;IAC1E,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;QAC1D,WAAW,CAAC,IAAI,CACd,UAAU,CACR,WAAW,EACX,eAAe,WAAW,kCAAkC,EAC5D,UAAU,EACV,SAAS,CACV,CACF,CAAC;QACF,OAAO;IACT,CAAC;IACD,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,aAAa,CACpB,KAAkC,EAClC,MAAkC,EAClC,cAA4D,EAC5D,UAAmC,EACnC,SAAiB,EACjB,mBAAwC,EACxC,WAAsC;IAEtC,IACE,KAAK,CAAC,YAAY,KAAK,aAAa,CAAC,MAAM,CAAC;QAC5C,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAC5B,IAAI,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,SAAS,CAAC,MAAM;QACxD,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QACxB,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,EAC7C,CAAC;QACD,WAAW,CAAC,IAAI,CACd,UAAU,CACR,WAAW,EACX,0CAA0C,MAAM,GAAG,EACnD,UAAU,EACV,SAAS,CACV,CACF,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACvC,IAAI,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,UAAU,EAAE,CAAC;YAChD,WAAW,CAAC,IAAI,CACd,UAAU,CACR,WAAW,EACX,UAAU,QAAQ,6CAA6C,EAC/D,UAAU,EACV,SAAS,CACV,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,gBAAgB,CACd,KAAK,CAAC,WAAW,EACjB,UAAU,MAAM,EAAE,EAClB,mBAAmB,EACnB,WAAW,EACX,UAAU,EACV,SAAS,CACV,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAChC,WAA+C;IAE/C,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,CAC1B,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC;QAC3C,oBAAoB,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;QACnE,oBAAoB,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC;QACjE,oBAAoB,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CACpD,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,iBAAsE;IAEtE,MAAM,QAAQ,GACZ,SAAS,IAAI,iBAAiB;QAC5B,CAAC,CAAC,iBAAiB;QACnB,CAAC,CAAC,kCAAkC,CAAC,iBAAiB,CAAC,CAAC;IAC5D,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC;IAC7B,MAAM,WAAW,GAA8B,EAAE,CAAC;IAClD,MAAM,aAAa,GAAG,6BAA6B,CAAC,OAAO,CAAC,CAAC;IAC7D,MAAM,aAAa,GAAG,0BAA0B,CAAC,aAAa,CAAC,CAAC;IAEhE,IACE,QAAQ,CAAC,aAAa,KAAK,aAAa;QACxC,QAAQ,CAAC,aAAa,KAAK,aAAa,EACxC,CAAC;QACD,WAAW,CAAC,IAAI,CACd,UAAU,CACR,WAAW,EACX,uEAAuE,CACxE,CACF,CAAC;IACJ,CAAC;IAED,IACE,OAAO,CAAC,aAAa,KAAK,kCAAkC;QAC5D,OAAO,CAAC,kBAAkB,KAAK,CAAC;QAChC,OAAO,CAAC,uBAAuB,KAAK,CAAC;QACrC,OAAO,CAAC,mBAAmB,KAAK,CAAC;QACjC,OAAO,CAAC,0BAA0B,KAAK,CAAC;QACxC,OAAO,CAAC,iBAAiB,KAAK,IAAI;QAClC,OAAO,CAAC,sBAAsB,KAAK,CAAC,EACpC,CAAC;QACD,WAAW,CAAC,IAAI,CACd,UAAU,CACR,WAAW,EACX,+DAA+D,CAChE,CACF,CAAC;IACJ,CAAC;IAED,IACE,CAAC,eAAe,CAAC,OAAO,CAAC,YAAY,CAAC;QACtC,CAAC,WAAW,CAAC,OAAO,CAAC,aAAa,EAAE,2BAA2B,CAAC;QAChE,CAAC,WAAW,CAAC,OAAO,CAAC,YAAY,EAAE,0BAA0B,CAAC,EAC9D,CAAC;QACD,WAAW,CAAC,IAAI,CACd,UAAU,CACR,WAAW,EACX,4DAA4D,CAC7D,CACF,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IACnF,IACE,OAAO,CAAC,SAAS,CAAC,MAAM,KAAK,2BAA2B,CAAC,MAAM;QAC/D,WAAW,CAAC,IAAI,KAAK,OAAO,CAAC,SAAS,CAAC,MAAM;QAC7C,CAAC,WAAW,CACV,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,EACrD,2BAA2B,CAC5B,EACD,CAAC;QACD,WAAW,CAAC,IAAI,CACd,UAAU,CACR,WAAW,EACX,8DAA8D,CAC/D,CACF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAS,2BAA2B,CAAC,CAAC;IAC1E,KAAK,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpD,IACE,KAAK,CAAC,MAAM,KAAK,CAAC;YAClB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;YAClB,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC;YAC/B,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAC5B,CAAC;YACD,WAAW,CAAC,IAAI,CACd,UAAU,CACR,WAAW,EACX,SAAS,KAAK,sDAAsD,EACpE,UAAU,CACX,CACF,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,IACE,CAAC,WAAW,CACV,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,EACzC,CAAC,MAAM,CAAC,CACT;QACD,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,KAAK,YAAY,EAC/C,CAAC;QACD,WAAW,CAAC,IAAI,CACd,UAAU,CAAC,WAAW,EAAE,8CAA8C,CAAC,CACxE,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,GAAG,EAAmC,CAAC;IAClE,MAAM,eAAe,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAC/C,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACd,2BAA2B,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;QAClD,2BAA2B,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC;QACvD,wBAAwB,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAC1D,CAAC;IACF,IACE,CAAC,WAAW,CACV,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,EAC/C,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,CAChD,EACD,CAAC;QACD,WAAW,CAAC,IAAI,CACd,UAAU,CAAC,WAAW,EAAE,sCAAsC,CAAC,CAChE,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACrC,IACE,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;YACnC,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC;YACnC,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YACzB,CAAC,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC;YAC/B,CAAC,eAAe,CAAC,MAAM,CAAC,UAAU,CAAC;YACnC,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC,YAAY,EACxC,CAAC;YACD,WAAW,CAAC,IAAI,CACd,UAAU,CACR,WAAW,EACX,UAAU,MAAM,CAAC,QAAQ,cAAc,EACvC,MAAM,CAAC,UAAU,CAClB,CACF,CAAC;QACJ,CAAC;QACD,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,IAAI,cAAc,GAAG,CAAC,CAAC,CAAC;IACxB,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAChD,MAAM,WAAW,GAAG,sBAAsB,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACpE,IACE,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC;YACpC,WAAW,GAAG,cAAc;YAC5B,CAAC,yBAAyB,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;YACvD,CAAC,iBAAiB,CAAC,QAAQ,CAAC,UAAU,EAAE,0BAA0B,EAAE,IAAI,CAAC;YACzE,CAAC,QAAQ,CAAC,MAAM,KAAK,iBAAiB;gBACpC,CAAC,QAAQ,CAAC,SAAS,KAAK,MAAM,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,EACtE,CAAC;YACD,WAAW,CAAC,IAAI,CACd,UAAU,CACR,WAAW,EACX,YAAY,QAAQ,CAAC,UAAU,0CAA0C,CAC1E,CACF,CAAC;QACJ,CAAC;QACD,cAAc,GAAG,WAAW,CAAC;QAC7B,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACrC,gBAAgB,CACd,QAAQ,CAAC,WAAW,EACpB,YAAY,QAAQ,CAAC,UAAU,EAAE,EACjC,mBAAmB,EACnB,WAAW,EACX,IAAI,EACJ,IAAI,CACL,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACxC,IACE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;YACxB,CAAC,yBAAyB,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9C,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,EAAE,0BAA0B,EAAE,KAAK,CAAC;YACtE,IAAI,CAAC,qBAAqB,CAAC,MAAM,KAAK,CAAC;YACvC,IAAI,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,IAAI;gBACtC,IAAI,CAAC,qBAAqB,CAAC,MAAM;YACnC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAC7B,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAC7C,EACD,CAAC;YACD,WAAW,CAAC,IAAI,CACd,UAAU,CACR,WAAW,EACX,QAAQ,IAAI,CAAC,MAAM,0CAA0C,CAC9D,CACF,CAAC;QACJ,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzB,gBAAgB,CACd,IAAI,CAAC,WAAW,EAChB,QAAQ,IAAI,CAAC,MAAM,EAAE,EACrB,mBAAmB,EACnB,WAAW,EACX,IAAI,EACJ,IAAI,CACL,CAAC;IACJ,CAAC;IAED,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACzC,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO;aACpC,MAAM,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU,KAAK,QAAQ,CAAC,UAAU,CAAC;aAC9D,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;QAC7B,IACE,QAAQ,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;YACjC,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;YAC/C,CAAC,WAAW,CACV,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,EACnD,0BAA0B,CAC3B,EACD,CAAC;YACD,WAAW,CAAC,IAAI,CACd,UAAU,CACR,WAAW,EACX,gDAAgD,EAChD,QAAQ,CAAC,UAAU,CACpB,CACF,CAAC;QACJ,CAAC;QAED,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACxC,IACE,CAAC,+BAA+B,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC;gBAChE,CAAC,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAE,wBAAwB,EAAE,KAAK,CAAC;gBACnE,OAAO,CAAC,aAAa,CAAC,MAAM,KAAK,CAAC;gBAClC,IAAI,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,aAAa,CAAC,MAAM,EACpE,CAAC;gBACD,WAAW,CAAC,IAAI,CACd,UAAU,CACR,WAAW,EACX,+CAA+C,EAC/C,QAAQ,CAAC,UAAU,EACnB,OAAO,CAAC,SAAS,CAClB,CACF,CAAC;YACJ,CAAC;YAED,MAAM,gBAAgB,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC;YAC5E,MAAM,eAAe,GAAG,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACtE,IACE,CAAC,WAAW,CACV,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,EACrD,eAAe,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,CACpD;gBACD,CAAC,OAAO,CAAC,kBAAkB,KAAK,OAAO;oBACrC,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;wBAC7B,gBAAgB,CAAC,MAAM,KAAK,CAAC;wBAC7B,OAAO,CAAC,iBAAiB,KAAK,gBAAgB,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;gBACnE,CAAC,OAAO,CAAC,kBAAkB,KAAK,OAAO;oBACrC,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;wBAC7B,gBAAgB,CAAC,MAAM,KAAK,CAAC;wBAC7B,OAAO,CAAC,iBAAiB,KAAK,IAAI,CAAC,CAAC,EACxC,CAAC;gBACD,WAAW,CAAC,IAAI,CACd,UAAU,CACR,WAAW,EACX,gEAAgE,EAChE,QAAQ,CAAC,UAAU,EACnB,OAAO,CAAC,SAAS,CAClB,CACF,CAAC;YACJ,CAAC;YACD,IACE,gBAAgB,CAAC,CAAC,CAAC,KAAK,SAAS;gBACjC,gBAAgB,CAAC,CAAC,CAAC,CAAC,aAAa,KAAK,OAAO,CAAC,aAAa,EAC3D,CAAC;gBACD,WAAW,CAAC,IAAI,CACd,UAAU,CACR,WAAW,EACX,qDAAqD,EACrD,QAAQ,CAAC,UAAU,EACnB,OAAO,CAAC,SAAS,CAClB,CACF,CAAC;YACJ,CAAC;YAED,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;YACtC,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBACzC,IACE,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC;oBACpC,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;oBAC1B,CAAC,+BAA+B,CAAC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC;oBACjE,CAAC,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,EAAE,KAAK,CAAC,EACtE,CAAC;oBACD,WAAW,CAAC,IAAI,CACd,UAAU,CACR,WAAW,EACX,YAAY,QAAQ,CAAC,UAAU,cAAc,EAC7C,QAAQ,CAAC,UAAU,EACnB,OAAO,CAAC,SAAS,CAClB,CACF,CAAC;gBACJ,CAAC;gBACD,WAAW,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;gBACrC,aAAa,CACX,QAAQ,CAAC,cAAc,EACvB,QAAQ,CAAC,aAAa,EACtB,cAAc,EACd,QAAQ,CAAC,UAAU,EACnB,OAAO,CAAC,SAAS,EACjB,mBAAmB,EACnB,WAAW,CACZ,CAAC;YACJ,CAAC;YAED,IACE,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBACtE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACtD,CAAC,WAAW,CACV,OAAO,CAAC,WAAW,EACnB,OAAO,CAAC,gBAAgB;qBACrB,MAAM,CACL,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CACjB,UAAU,CAAC,MAAM,KAAK,CAAC;oBACvB,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CACzC;qBACA,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,CACvC;gBACD,CAAC,WAAW,CACV,OAAO,CAAC,OAAO,EACf,OAAO,CAAC,YAAY;qBACjB,MAAM,CACL,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,CACzB,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC;oBACtC,CAAC,MAAM,KAAK,uBAAuB;wBACjC,OAAO,CAAC,kBAAkB,KAAK,SAAS,CAAC;oBAC3C,CAAC,MAAM,KAAK,0BAA0B;wBACpC,OAAO,CAAC,SAAS,CAAC,IAAI,CACpB,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,aAAa,KAAK,YAAY,CACtD,CAAC,CACP;qBACA,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,CAC/B,EACD,CAAC;gBACD,WAAW,CAAC,IAAI,CACd,UAAU,CACR,WAAW,EACX,iEAAiE,EACjE,QAAQ,CAAC,UAAU,EACnB,OAAO,CAAC,SAAS,CAClB,CACF,CAAC;YACJ,CAAC;YAED,IACE,CAAC,uBAAuB,CAAC,OAAO,CAAC,UAAU,CAAC;gBAC5C,CAAC,uBAAuB,CAAC,OAAO,CAAC,WAAW,CAAC;gBAC7C,CAAC,OAAO,CAAC,UAAU,KAAK,IAAI;oBAC1B,OAAO,CAAC,WAAW,KAAK,IAAI;oBAC5B,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;gBAC3C,CAAC,OAAO,CAAC,UAAU,KAAK,IAAI;oBAC1B,OAAO,CAAC,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,EAC5C,CAAC;gBACD,WAAW,CAAC,IAAI,CACd,UAAU,CACR,WAAW,EACX,sCAAsC,EACtC,QAAQ,CAAC,UAAU,EACnB,OAAO,CAAC,SAAS,CAClB,CACF,CAAC;YACJ,CAAC;YAED,aAAa,CACX,OAAO,CAAC,cAAc,EACtB,OAAO,CAAC,aAAa,EACrB,cAAc,EACd,QAAQ,CAAC,UAAU,EACnB,OAAO,CAAC,SAAS,EACjB,mBAAmB,EACnB,WAAW,CACZ,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,yBAAyB,CAAC,WAAW,CAAC,CAAC;IACtD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;QACvB,aAAa;QACb,WAAW,EAAE,MAAM;KACpB,CAAC;AACJ,CAAC"}
@@ -0,0 +1,12 @@
1
+ import { type HelpLevel, type HelpResult } from "./registry.js";
2
+ export interface GuideResult extends HelpResult {
3
+ readonly schemaVersion: "Perttool.GuideResult.v1";
4
+ readonly cliContractVersion: 3;
5
+ readonly toolVersion: string;
6
+ readonly operation: "guide";
7
+ }
8
+ export declare function getGuide(topicId: string | null, level: HelpLevel): GuideResult;
9
+ export declare function guideResultToJson(result: GuideResult): Readonly<Record<string, unknown>>;
10
+ export declare function serializeGuideResult(result: GuideResult): string;
11
+ export declare function renderGuideResult(result: GuideResult): string;
12
+ //# sourceMappingURL=guide.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"guide.d.ts","sourceRoot":"","sources":["../../src/help/guide.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,UAAU,EAChB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,QAAQ,CAAC,aAAa,EAAE,yBAAyB,CAAC;IAClD,QAAQ,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAsDD,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,KAAK,EAAE,SAAS,GACf,WAAW,CASb;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,GAClB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkBnC;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEhE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAmC7D"}
@@ -0,0 +1,103 @@
1
+ import { TOOL_VERSION } from "../version.js";
2
+ import { getHelp, } from "./registry.js";
3
+ function jsonPosition(position) {
4
+ return {
5
+ offset: position.offset,
6
+ line: position.line + 1,
7
+ column: position.column + 1,
8
+ };
9
+ }
10
+ function jsonSpan(span) {
11
+ return {
12
+ start: jsonPosition(span.start),
13
+ end: jsonPosition(span.end),
14
+ };
15
+ }
16
+ function guideDiagnosticToJson(diagnostic) {
17
+ return {
18
+ code: diagnostic.code,
19
+ severity: diagnostic.severity,
20
+ message: diagnostic.message,
21
+ entity_id: diagnostic.entityId ?? null,
22
+ span: diagnostic.span === undefined ? null : jsonSpan(diagnostic.span),
23
+ related: (diagnostic.related ?? []).map((related) => ({
24
+ message: related.message,
25
+ span: jsonSpan(related.span),
26
+ })),
27
+ help_topic: null,
28
+ guide_topic: diagnostic.helpTopic ?? null,
29
+ expected_syntax: diagnostic.expectedSyntax ?? null,
30
+ fixes: [],
31
+ data: diagnostic.data ?? {},
32
+ };
33
+ }
34
+ function guideInvocation(topicId) {
35
+ return ["perttool", "guide", ...topicId.split("."), "--level", "quick"]
36
+ .join(" ");
37
+ }
38
+ function renderGuideDiagnostic(diagnostic) {
39
+ return [
40
+ `${diagnostic.code} ${diagnostic.severity}: ${diagnostic.message}`,
41
+ ...(diagnostic.helpTopic === undefined
42
+ ? []
43
+ : [` guide: ${guideInvocation(diagnostic.helpTopic)}`]),
44
+ ].join("\n");
45
+ }
46
+ export function getGuide(topicId, level) {
47
+ const help = getHelp(topicId, level);
48
+ return Object.freeze({
49
+ schemaVersion: "Perttool.GuideResult.v1",
50
+ cliContractVersion: 3,
51
+ toolVersion: TOOL_VERSION,
52
+ operation: "guide",
53
+ ...help,
54
+ });
55
+ }
56
+ export function guideResultToJson(result) {
57
+ return {
58
+ schema_version: result.schemaVersion,
59
+ cli_contract_version: result.cliContractVersion,
60
+ tool_version: result.toolVersion,
61
+ operation: result.operation,
62
+ ok: result.ok,
63
+ diagnostics: result.diagnostics.map(guideDiagnosticToJson),
64
+ topic_id: result.topicId,
65
+ level: result.level,
66
+ title: result.title,
67
+ summary: result.summary,
68
+ sections: result.sections,
69
+ syntax: result.syntax,
70
+ examples: result.examples,
71
+ related: result.related,
72
+ topics: result.topics,
73
+ };
74
+ }
75
+ export function serializeGuideResult(result) {
76
+ return `${JSON.stringify(guideResultToJson(result))}\n`;
77
+ }
78
+ export function renderGuideResult(result) {
79
+ if (!result.ok) {
80
+ return `${result.diagnostics.map(renderGuideDiagnostic).join("\n")}\n`;
81
+ }
82
+ const lines = [result.title, "", result.summary];
83
+ if (result.topics.length > 0) {
84
+ lines.push("", "Topics:");
85
+ for (const topic of result.topics) {
86
+ lines.push(` ${topic.id.padEnd(12)} ${topic.summary}`);
87
+ }
88
+ }
89
+ for (const section of result.sections) {
90
+ lines.push("", section.title, section.body);
91
+ }
92
+ if (result.syntax.length > 0) {
93
+ lines.push("", "Syntax:", ...result.syntax.map((line) => ` ${line}`));
94
+ }
95
+ if (result.examples.length > 0) {
96
+ lines.push("", "Examples:", ...result.examples.map((example) => ` ${example.id}: ${example.text}`));
97
+ }
98
+ if (result.related.length > 0) {
99
+ lines.push("", `Related: ${result.related.join(", ")}`);
100
+ }
101
+ return `${lines.join("\n")}\n`;
102
+ }
103
+ //# sourceMappingURL=guide.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"guide.js","sourceRoot":"","sources":["../../src/help/guide.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/help/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC;IACvE,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AA6lBD,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,GAAG,UAAU,CAsD5E"}
1
+ {"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/help/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC;IACvE,QAAQ,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,CAAC;CAC7C;AAsmBD,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,SAAS,GAAG,UAAU,CAsD5E"}