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.
- package/CHANGELOG.md +78 -28
- package/README.md +173 -95
- package/dist/application/agent-help.d.ts +3 -0
- package/dist/application/agent-help.d.ts.map +1 -0
- package/dist/application/agent-help.js +5 -0
- package/dist/application/agent-help.js.map +1 -0
- package/dist/application/analyze.js +5 -5
- package/dist/application/analyze.js.map +1 -1
- package/dist/application/init.d.ts +42 -0
- package/dist/application/init.d.ts.map +1 -0
- package/dist/application/init.js +217 -0
- package/dist/application/init.js.map +1 -0
- package/dist/application/mutate.d.ts.map +1 -1
- package/dist/application/mutate.js +28 -15
- package/dist/application/mutate.js.map +1 -1
- package/dist/application/project.d.ts +25 -0
- package/dist/application/project.d.ts.map +1 -0
- package/dist/application/project.js +54 -0
- package/dist/application/project.js.map +1 -0
- package/dist/cli.js +419 -331
- package/dist/cli.js.map +1 -1
- package/dist/command/discovery.d.ts +30 -0
- package/dist/command/discovery.d.ts.map +1 -0
- package/dist/command/discovery.js +625 -0
- package/dist/command/discovery.js.map +1 -0
- package/dist/command/registry.d.ts +84 -0
- package/dist/command/registry.d.ts.map +1 -0
- package/dist/command/registry.js +951 -0
- package/dist/command/registry.js.map +1 -0
- package/dist/command/usage.d.ts +42 -0
- package/dist/command/usage.d.ts.map +1 -0
- package/dist/command/usage.js +337 -0
- package/dist/command/usage.js.map +1 -0
- package/dist/conversion/mermaid-import.js +56 -56
- package/dist/conversion/mermaid-import.js.map +1 -1
- package/dist/conversion/mermaid.js +1 -1
- package/dist/conversion/mermaid.js.map +1 -1
- package/dist/guidance/profile.d.ts +6 -0
- package/dist/guidance/profile.d.ts.map +1 -0
- package/dist/guidance/profile.js +1158 -0
- package/dist/guidance/profile.js.map +1 -0
- package/dist/guidance/projection.d.ts +16 -0
- package/dist/guidance/projection.d.ts.map +1 -0
- package/dist/guidance/projection.js +276 -0
- package/dist/guidance/projection.js.map +1 -0
- package/dist/guidance/query.d.ts +4 -0
- package/dist/guidance/query.d.ts.map +1 -0
- package/dist/guidance/query.js +178 -0
- package/dist/guidance/query.js.map +1 -0
- package/dist/guidance/text.d.ts +4 -0
- package/dist/guidance/text.d.ts.map +1 -0
- package/dist/guidance/text.js +118 -0
- package/dist/guidance/text.js.map +1 -0
- package/dist/guidance/types.d.ts +227 -0
- package/dist/guidance/types.d.ts.map +1 -0
- package/dist/guidance/types.js +54 -0
- package/dist/guidance/types.js.map +1 -0
- package/dist/guidance/validator.d.ts +8 -0
- package/dist/guidance/validator.d.ts.map +1 -0
- package/dist/guidance/validator.js +383 -0
- package/dist/guidance/validator.js.map +1 -0
- package/dist/help/guide.d.ts +12 -0
- package/dist/help/guide.d.ts.map +1 -0
- package/dist/help/guide.js +103 -0
- package/dist/help/guide.js.map +1 -0
- package/dist/help/registry.d.ts.map +1 -1
- package/dist/help/registry.js +76 -67
- package/dist/help/registry.js.map +1 -1
- package/dist/index.d.ts +21 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +13 -0
- package/dist/index.js.map +1 -1
- package/dist/io/safe-write.js +17 -17
- package/dist/io/safe-write.js.map +1 -1
- package/dist/mutation/gate.d.ts +5 -0
- package/dist/mutation/gate.d.ts.map +1 -0
- package/dist/mutation/gate.js +156 -0
- package/dist/mutation/gate.js.map +1 -0
- package/dist/mutation/milestone.js +26 -26
- package/dist/mutation/milestone.js.map +1 -1
- package/dist/mutation/project.d.ts +5 -0
- package/dist/mutation/project.d.ts.map +1 -0
- package/dist/mutation/project.js +148 -0
- package/dist/mutation/project.js.map +1 -0
- package/dist/mutation/resource.js +22 -22
- package/dist/mutation/resource.js.map +1 -1
- package/dist/mutation/task.js +40 -40
- package/dist/mutation/task.js.map +1 -1
- package/dist/mutation/types.d.ts +46 -1
- package/dist/mutation/types.d.ts.map +1 -1
- package/dist/parser/document-parser.js +17 -17
- package/dist/parser/document-parser.js.map +1 -1
- package/dist/semantic/validator.js +41 -41
- package/dist/semantic/validator.js.map +1 -1
- package/dist/version.d.ts +1 -1
- package/dist/version.d.ts.map +1 -1
- package/dist/version.js +1 -1
- package/dist/version.js.map +1 -1
- 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":"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"}
|
|
@@ -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;
|
|
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"}
|