perttool 0.1.0-alpha.2 → 0.2.0

package/dist/guidance/text.js

@@ -0,0 +1,118 @@
+function list(values) {
+    return values.length === 0 ? "-" : values.join(",");
+}
+function date(value) {
+    return value ?? "?";
+}
+function readOnlyLine(result) {
+    return [
+        "READ-ONLY",
+        `files=${result.capabilities.writesFiles}`,
+        `hooks=${result.capabilities.executesHooks}`,
+        `commands=${result.capabilities.executesCommands}`,
+        `network=${result.capabilities.accessesNetwork}`,
+        `provider-write=${result.capabilities.writesProviderState}`,
+    ].join(" ");
+}
+function collectEvidence(result) {
+    const values = [];
+    const keys = new Set();
+    for (const provider of result.providers) {
+        for (const surface of provider.surfaces) {
+            for (const evidence of [
+                surface.statusEvidence,
+                ...surface.artifacts.map(({ statusEvidence }) => statusEvidence),
+            ]) {
+                const key = `${evidence.evidenceKind}\0${evidence.sourceIds.join("\0")}`;
+                if (!keys.has(key)) {
+                    keys.add(key);
+                    values.push(evidence);
+                }
+            }
+        }
+    }
+    return values;
+}
+function collectDescriptions(result) {
+    const values = [];
+    const keys = new Set();
+    const add = (description) => {
+        if (description === null)
+            return;
+        const key = [
+            description.key,
+            ...description.parameters.flatMap(({ name, value }) => [name, value]),
+            description.text,
+        ].join("\0");
+        if (keys.has(key))
+            return;
+        keys.add(key);
+        values.push(description);
+    };
+    for (const provider of result.providers) {
+        for (const surface of provider.surfaces) {
+            add(surface.statusEvidence.description);
+            for (const artifact of surface.artifacts) {
+                add(artifact.statusEvidence.description);
+            }
+        }
+    }
+    for (const guidance of result.guidanceRecords)
+        add(guidance.description);
+    for (const risk of result.riskRecords)
+        add(risk.description);
+    return values;
+}
+export function renderAgentGuidanceText(result) {
+    const lines = [
+        `AGENT GUIDANCE schema=${result.schemaVersion} profile=${result.profileDataVersion} snapshot=${result.snapshotAsOf}`,
+    ];
+    if (result.query.level === "index") {
+        for (const provider of result.providers) {
+            lines.push(`PROVIDER ${provider.providerId} aliases=${list(provider.aliases)} surfaces=${list(provider.availableSurfaceIds)}`);
+        }
+        lines.push(readOnlyLine(result));
+        return `${lines.join("\n")}\n`;
+    }
+    lines.push(`QUERY provider=${result.query.canonicalProviderId ?? "*"} surface=${result.query.surfaceId ?? "*"} level=${result.query.level} alias=${result.query.aliasApplied}`);
+    for (const provider of result.providers) {
+        lines.push(`PROVIDER ${provider.providerId} ${provider.displayName}`);
+        for (const surface of provider.surfaces) {
+            lines.push(`SURFACE ${surface.surfaceId} support=${surface.supportStatus} artifact=${surface.artifactResolution}`);
+            for (const artifact of surface.artifacts) {
+                lines.push(`ARTIFACT ${artifact.artifactId} primary=${artifact.primary} scopes=${list(artifact.scopeIds)} status=${artifact.supportStatus} path=${artifact.path ?? "?"}`);
+            }
+        }
+    }
+    for (const guidance of result.guidanceRecords) {
+        lines.push(`GUIDANCE ${guidance.guidanceId} directive=${guidance.directive}`);
+    }
+    for (const risk of result.riskRecords) {
+        lines.push(`RISK ${risk.riskId} kind=${risk.kind} mitigated-by=${list(risk.mitigationGuidanceIds)}`);
+    }
+    for (const provider of result.providers) {
+        for (const surface of provider.surfaces) {
+            lines.push(`STALENESS status=${surface.staleness.status} verified-at=${date(surface.staleness.verifiedAt)} review-after=${date(surface.staleness.reviewAfter)} basis=${surface.staleness.basisDate}`);
+        }
+    }
+    for (const evidence of collectEvidence(result)) {
+        lines.push(`EVIDENCE ${evidence.evidenceKind} sources=${list(evidence.sourceIds)}`);
+    }
+    if (result.query.level === "detail") {
+        for (const description of collectDescriptions(result)) {
+            lines.push(`DESCRIPTION ${description.key}: ${description.text}`);
+        }
+        for (const source of result.sources) {
+            lines.push(`SOURCE ${source.sourceId} ${source.url ?? "?"}`);
+        }
+    }
+    lines.push(readOnlyLine(result));
+    return `${lines.join("\n")}\n`;
+}
+export function agentGuidanceExitCode(diagnostics) {
+    if (diagnostics.some(({ code }) => code === "PTAGT-302" || code === "PTAGT-303")) {
+        return 70;
+    }
+    return diagnostics.some(({ severity }) => severity === "error") ? 1 : 0;
+}
+//# sourceMappingURL=text.js.map

package/dist/guidance/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../../src/guidance/text.ts"],"names":[],"mappings":"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"}

package/dist/guidance/types.d.ts

@@ -0,0 +1,227 @@
+import type { DiagnosticSeverity } from "../model/diagnostics.js";
+export declare const AGENT_GUIDANCE_PROVIDER_IDS: readonly ["codex", "github-copilot", "claude-code", "grok-build", "antigravity"];
+export declare const AGENT_GUIDANCE_SURFACE_IDS: readonly ["instruction", "workflow", "delegated_agent", "enforcement", "prompt", "connector"];
+export declare const AGENT_GUIDANCE_SUPPORT_STATUSES: readonly ["native", "compatible", "preview", "deprecated", "unsupported", "unknown"];
+export declare const AGENT_GUIDANCE_SCOPE_IDS: readonly ["repository", "directory", "workspace", "user", "organization", "enterprise", "managed", "session", "conversation", "local", "admin", "system", "plugin", "compatibility"];
+export declare const AGENT_GUIDANCE_ORIGINS: readonly ["project_control", "common_surface", "provider"];
+export declare const AGENT_GUIDANCE_DIRECTIVES: readonly ["must", "should", "may"];
+export declare const AGENT_GUIDANCE_RISK_KINDS: readonly ["scope", "execution", "delegation", "external_access", "compatibility", "staleness"];
+export type AgentGuidanceProviderId = (typeof AGENT_GUIDANCE_PROVIDER_IDS)[number];
+export type AgentGuidanceSurfaceId = (typeof AGENT_GUIDANCE_SURFACE_IDS)[number];
+export type AgentGuidanceSupportStatus = (typeof AGENT_GUIDANCE_SUPPORT_STATUSES)[number];
+export type AgentGuidanceScopeId = (typeof AGENT_GUIDANCE_SCOPE_IDS)[number];
+export type AgentGuidanceOrigin = (typeof AGENT_GUIDANCE_ORIGINS)[number];
+export type AgentGuidanceDirective = (typeof AGENT_GUIDANCE_DIRECTIVES)[number];
+export type AgentGuidanceRiskKind = (typeof AGENT_GUIDANCE_RISK_KINDS)[number];
+export type AgentGuidanceLevel = "index" | "quick" | "detail";
+export type AgentGuidanceArtifactResolution = "known" | "not_applicable" | "unknown";
+export type AgentGuidanceEvidenceKind = "official_native_documentation" | "official_compatibility_documentation" | "official_preview_notice" | "official_deprecation_notice" | "official_unsupported_notice" | "insufficient_official_evidence";
+export type AgentGuidanceStalenessStatus = "verified" | "review_due" | "unknown";
+export interface GuidanceDescriptionParameter {
+    readonly name: string;
+    readonly value: string;
+}
+export interface GuidanceDescription {
+    readonly key: string;
+    readonly parameters: readonly GuidanceDescriptionParameter[];
+    readonly text: string;
+}
+export interface AgentGuidanceStatusEvidence {
+    readonly evidenceKind: AgentGuidanceEvidenceKind;
+    readonly sourceIds: readonly string[];
+    readonly facts: readonly string[];
+    readonly description: GuidanceDescription;
+}
+export interface AgentGuidanceArtifactProfile {
+    readonly artifactId: string;
+    readonly path: string;
+    readonly scopeIds: readonly AgentGuidanceScopeId[];
+    readonly primary: boolean;
+    readonly supportStatus: AgentGuidanceSupportStatus;
+    readonly statusEvidence: AgentGuidanceStatusEvidence;
+}
+export interface AgentGuidanceSurfaceProfile {
+    readonly surfaceId: AgentGuidanceSurfaceId;
+    readonly supportStatus: AgentGuidanceSupportStatus;
+    readonly primaryArtifactId: string | null;
+    readonly artifactResolution: AgentGuidanceArtifactResolution;
+    readonly providerTerms: readonly string[];
+    readonly scopes: readonly AgentGuidanceScopeId[];
+    readonly artifacts: readonly AgentGuidanceArtifactProfile[];
+    readonly guidanceIds: readonly string[];
+    readonly riskIds: readonly string[];
+    readonly statusEvidence: AgentGuidanceStatusEvidence;
+    readonly verifiedAt: string | null;
+    readonly reviewAfter: string | null;
+}
+export interface AgentGuidanceProviderProfile {
+    readonly providerId: AgentGuidanceProviderId;
+    readonly displayName: string;
+    readonly aliases: readonly string[];
+    readonly surfaces: readonly AgentGuidanceSurfaceProfile[];
+}
+export interface AgentGuidanceRecordProfile {
+    readonly guidanceId: string;
+    readonly origin: AgentGuidanceOrigin;
+    readonly directive: AgentGuidanceDirective;
+    readonly surfaceIds: readonly AgentGuidanceSurfaceId[];
+    readonly description: GuidanceDescription;
+}
+export interface AgentGuidanceRiskProfile {
+    readonly riskId: string;
+    readonly kind: AgentGuidanceRiskKind;
+    readonly surfaceIds: readonly AgentGuidanceSurfaceId[];
+    readonly mitigationGuidanceIds: readonly string[];
+    readonly description: GuidanceDescription;
+}
+export interface AgentGuidanceSourceProfile {
+    readonly sourceId: string;
+    readonly providerId: AgentGuidanceProviderId;
+    readonly title: string;
+    readonly url: string;
+    readonly verifiedAt: string;
+}
+export interface AgentGuidanceAlias {
+    readonly alias: string;
+    readonly providerId: AgentGuidanceProviderId;
+}
+export interface AgentGuidanceProfile {
+    readonly schemaVersion: "Perttool.AgentGuidanceProfile.v1";
+    readonly profileDataVersion: 1;
+    readonly guidanceTaxonomyVersion: 1;
+    readonly riskTaxonomyVersion: 1;
+    readonly descriptionRegistryVersion: 1;
+    readonly descriptionLocale: "en";
+    readonly stalenessPolicyVersion: 1;
+    readonly snapshotAsOf: string;
+    readonly providerOrder: readonly AgentGuidanceProviderId[];
+    readonly surfaceOrder: readonly AgentGuidanceSurfaceId[];
+    readonly aliases: readonly AgentGuidanceAlias[];
+    readonly providers: readonly AgentGuidanceProviderProfile[];
+    readonly guidanceRegistry: readonly AgentGuidanceRecordProfile[];
+    readonly riskRegistry: readonly AgentGuidanceRiskProfile[];
+    readonly sources: readonly AgentGuidanceSourceProfile[];
+}
+export interface AgentGuidanceProfileSnapshot {
+    readonly profile: AgentGuidanceProfile;
+    readonly canonicalJson: string;
+    readonly profileDigest: string;
+}
+export interface AgentGuidanceDiagnostic {
+    readonly code: string;
+    readonly severity: DiagnosticSeverity;
+    readonly message: string;
+    readonly providerId: string | null;
+    readonly surfaceId: string | null;
+}
+export interface AgentGuidanceProfileValidationResult {
+    readonly ok: boolean;
+    readonly profileDigest: string;
+    readonly diagnostics: readonly AgentGuidanceDiagnostic[];
+}
+export interface AgentGuidanceQuery {
+    readonly providerId?: string | null;
+    readonly surfaceId?: string | null;
+    readonly level?: AgentGuidanceLevel;
+}
+export interface AgentGuidanceQueryProjection {
+    readonly inputProviderId: string | null;
+    readonly canonicalProviderId: AgentGuidanceProviderId | null;
+    readonly surfaceId: string | null;
+    readonly level: AgentGuidanceLevel;
+    readonly aliasApplied: boolean;
+}
+export interface AgentGuidanceStaleness {
+    readonly status: AgentGuidanceStalenessStatus;
+    readonly verifiedAt: string | null;
+    readonly reviewAfter: string | null;
+    readonly basisDate: string;
+}
+export interface AgentGuidanceArtifact {
+    readonly artifactId: string;
+    readonly path: string | null;
+    readonly scopeIds: readonly AgentGuidanceScopeId[];
+    readonly primary: boolean;
+    readonly supportStatus: AgentGuidanceSupportStatus;
+    readonly statusEvidence: AgentGuidanceProjectedStatusEvidence;
+}
+export interface AgentGuidanceProjectedStatusEvidence {
+    readonly evidenceKind: AgentGuidanceEvidenceKind;
+    readonly sourceIds: readonly string[];
+    readonly facts: readonly string[];
+    readonly description: GuidanceDescription | null;
+}
+export interface AgentGuidanceSurface {
+    readonly surfaceId: AgentGuidanceSurfaceId;
+    readonly supportStatus: AgentGuidanceSupportStatus;
+    readonly primaryArtifactId: string | null;
+    readonly artifactResolution: AgentGuidanceArtifactResolution;
+    readonly providerTerms: readonly string[];
+    readonly scopes: readonly AgentGuidanceScopeId[];
+    readonly artifacts: readonly AgentGuidanceArtifact[];
+    readonly guidanceIds: readonly string[];
+    readonly riskIds: readonly string[];
+    readonly statusEvidence: AgentGuidanceProjectedStatusEvidence;
+    readonly staleness: AgentGuidanceStaleness;
+}
+export interface AgentGuidanceProvider {
+    readonly providerId: AgentGuidanceProviderId;
+    readonly displayName: string;
+    readonly aliases: readonly string[];
+    readonly availableSurfaceIds: readonly AgentGuidanceSurfaceId[];
+    readonly surfaces: readonly AgentGuidanceSurface[];
+}
+export interface AgentGuidanceRecord {
+    readonly guidanceId: string;
+    readonly origin: AgentGuidanceOrigin;
+    readonly directive: AgentGuidanceDirective;
+    readonly surfaceIds: readonly AgentGuidanceSurfaceId[];
+    readonly description: GuidanceDescription | null;
+}
+export interface AgentGuidanceRisk {
+    readonly riskId: string;
+    readonly kind: AgentGuidanceRiskKind;
+    readonly surfaceIds: readonly AgentGuidanceSurfaceId[];
+    readonly mitigationGuidanceIds: readonly string[];
+    readonly description: GuidanceDescription | null;
+}
+export interface AgentGuidanceSource {
+    readonly sourceId: string;
+    readonly providerId: AgentGuidanceProviderId;
+    readonly title: string | null;
+    readonly url: string | null;
+    readonly verifiedAt: string;
+}
+export interface AgentGuidanceCapabilities {
+    readonly readsProjectFiles: false;
+    readonly writesFiles: false;
+    readonly executesHooks: false;
+    readonly executesCommands: false;
+    readonly accessesNetwork: false;
+    readonly readsProviderState: false;
+    readonly writesProviderState: false;
+}
+export interface AgentGuidanceResult {
+    readonly schemaVersion: "Perttool.AgentGuidanceResult.v1";
+    readonly guidanceInterfaceVersion: 1;
+    readonly profileSchemaVersion: "Perttool.AgentGuidanceProfile.v1";
+    readonly profileDataVersion: 1;
+    readonly guidanceTaxonomyVersion: 1;
+    readonly riskTaxonomyVersion: 1;
+    readonly descriptionRegistryVersion: 1;
+    readonly descriptionLocale: "en";
+    readonly stalenessPolicyVersion: 1;
+    readonly toolVersion: string;
+    readonly operation: "agent.help";
+    readonly ok: boolean;
+    readonly profileDigest: string;
+    readonly snapshotAsOf: string;
+    readonly query: AgentGuidanceQueryProjection;
+    readonly providers: readonly AgentGuidanceProvider[];
+    readonly guidanceRecords: readonly AgentGuidanceRecord[];
+    readonly riskRecords: readonly AgentGuidanceRisk[];
+    readonly sources: readonly AgentGuidanceSource[];
+    readonly capabilities: AgentGuidanceCapabilities;
+    readonly diagnostics: readonly AgentGuidanceDiagnostic[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/guidance/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/guidance/types.ts"],"names":[],"mappings":"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"}

package/dist/guidance/types.js

@@ -0,0 +1,54 @@
+export const AGENT_GUIDANCE_PROVIDER_IDS = [
+    "codex",
+    "github-copilot",
+    "claude-code",
+    "grok-build",
+    "antigravity",
+];
+export const AGENT_GUIDANCE_SURFACE_IDS = [
+    "instruction",
+    "workflow",
+    "delegated_agent",
+    "enforcement",
+    "prompt",
+    "connector",
+];
+export const AGENT_GUIDANCE_SUPPORT_STATUSES = [
+    "native",
+    "compatible",
+    "preview",
+    "deprecated",
+    "unsupported",
+    "unknown",
+];
+export const AGENT_GUIDANCE_SCOPE_IDS = [
+    "repository",
+    "directory",
+    "workspace",
+    "user",
+    "organization",
+    "enterprise",
+    "managed",
+    "session",
+    "conversation",
+    "local",
+    "admin",
+    "system",
+    "plugin",
+    "compatibility",
+];
+export const AGENT_GUIDANCE_ORIGINS = [
+    "project_control",
+    "common_surface",
+    "provider",
+];
+export const AGENT_GUIDANCE_DIRECTIVES = ["must", "should", "may"];
+export const AGENT_GUIDANCE_RISK_KINDS = [
+    "scope",
+    "execution",
+    "delegation",
+    "external_access",
+    "compatibility",
+    "staleness",
+];
+//# sourceMappingURL=types.js.map

package/dist/guidance/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/guidance/types.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,2BAA2B,GAAG;IACzC,OAAO;IACP,gBAAgB;IAChB,aAAa;IACb,YAAY;IACZ,aAAa;CACL,CAAC;AAEX,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,aAAa;IACb,UAAU;IACV,iBAAiB;IACjB,aAAa;IACb,QAAQ;IACR,WAAW;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,+BAA+B,GAAG;IAC7C,QAAQ;IACR,YAAY;IACZ,SAAS;IACT,YAAY;IACZ,aAAa;IACb,SAAS;CACD,CAAC;AAEX,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,YAAY;IACZ,WAAW;IACX,WAAW;IACX,MAAM;IACN,cAAc;IACd,YAAY;IACZ,SAAS;IACT,SAAS;IACT,cAAc;IACd,OAAO;IACP,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,eAAe;CACP,CAAC;AAEX,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,iBAAiB;IACjB,gBAAgB;IAChB,UAAU;CACF,CAAC;AAEX,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAU,CAAC;AAE5E,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,OAAO;IACP,WAAW;IACX,YAAY;IACZ,iBAAiB;IACjB,eAAe;IACf,WAAW;CACH,CAAC"}

package/dist/guidance/validator.d.ts

@@ -0,0 +1,8 @@
+import { type AgentGuidanceProfile, type AgentGuidanceProfileSnapshot, type AgentGuidanceProfileValidationResult } from "./types.js";
+export declare function compareAgentGuidanceUtf8(left: string, right: string): number;
+export declare function agentGuidanceProfileToJson(profile: AgentGuidanceProfile): Readonly<Record<string, unknown>>;
+export declare function serializeAgentGuidanceProfile(profile: AgentGuidanceProfile): string;
+export declare function digestAgentGuidanceProfile(canonicalJson: string): string;
+export declare function createAgentGuidanceProfileSnapshot(profile: AgentGuidanceProfile): AgentGuidanceProfileSnapshot;
+export declare function validateAgentGuidanceProfile(profileOrSnapshot: AgentGuidanceProfile | AgentGuidanceProfileSnapshot): AgentGuidanceProfileValidationResult;
+//# sourceMappingURL=validator.d.ts.map

package/dist/guidance/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/guidance/validator.ts"],"names":[],"mappings":"AAEA,OAAO,EAWL,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EACjC,KAAK,oCAAoC,EAM1C,MAAM,YAAY,CAAC;AAapB,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,MAAM,CAER;AAiCD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,oBAAoB,GAC5B,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAyDnC;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAER;AAED,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,oBAAoB,GAC5B,4BAA4B,CAO9B;AA6LD,wBAAgB,4BAA4B,CAC1C,iBAAiB,EAAE,oBAAoB,GAAG,4BAA4B,GACrE,oCAAoC,CA8XtC"}