@open-agent-toolkit/cli 0.2.65 → 0.2.66

package/dist/commands/pjm/remote/provider-conformance.js

@@ -0,0 +1,37 @@
+import { contextsEqual, } from './provider.js';
+export function evaluateProviderConformance(fixture) {
+    const failures = [];
+    const issue = fixture.adapter.normalize(fixture.observation);
+    if (issue.provider !== fixture.adapter.provider)
+        failures.push('provider-identity');
+    if (issue.stableId !== fixture.expected.stableId)
+        failures.push('stable-identity');
+    if (JSON.stringify(issue.aliases) !== JSON.stringify(fixture.expected.aliases)) {
+        failures.push('aliases');
+    }
+    const action = fixture.adapter.plan('update', {
+        stableId: issue.stableId,
+        fields: { title: issue.title },
+    });
+    if (!contextsEqual(action.context, fixture.observation.context)) {
+        failures.push('action-context');
+    }
+    const validation = fixture.adapter.validateObservation(action, fixture.observation);
+    if (!validation.valid)
+        failures.push(...validation.reasons.map((reason) => `observation:${reason}`));
+    if (JSON.stringify(fixture.adapter.verificationFields(action)) !==
+        JSON.stringify(fixture.expected.verificationFields)) {
+        failures.push('verification-fields');
+    }
+    return failures;
+}
+export function validateSemanticObservation(action, observation) {
+    const reasons = [];
+    if (action.provider !== observation.provider)
+        reasons.push('provider-mismatch');
+    if (!contextsEqual(action.context, observation.context))
+        reasons.push('context-mismatch');
+    if (!observation.capabilityEvidenceDigest)
+        reasons.push('capability-evidence-missing');
+    return reasons;
+}

package/dist/commands/pjm/remote/provider.d.ts

@@ -0,0 +1,57 @@
+export type RemoteProvider = 'github' | 'linear' | 'jira';
+export type SemanticOperation = 'read' | 'read-discussion' | 'search-duplicates' | 'create' | 'update' | 'transition' | 'annotate';
+export interface ProviderContext {
+    readonly [key: string]: string | undefined;
+}
+export interface SanitizedProviderObservation {
+    provider: RemoteProvider;
+    context: ProviderContext;
+    identity: {
+        stableId: string;
+        aliases: string[];
+    };
+    fields: Record<string, unknown>;
+    revision: {
+        token?: string;
+        updatedAt?: string;
+        contentDigest: string;
+    };
+    capabilityEvidenceDigest: string;
+}
+export interface NormalizedRemoteIssue {
+    provider: RemoteProvider;
+    context: ProviderContext;
+    stableId: string;
+    aliases: string[];
+    title: string;
+    description: string | null;
+    priority: string | null;
+    status: string;
+    revisionDigest: string;
+    extensions: Record<string, unknown>;
+}
+export interface SemanticAction {
+    provider: RemoteProvider;
+    operation: SemanticOperation;
+    context: ProviderContext;
+    intent: Record<string, unknown>;
+}
+export interface ObservationValidation {
+    valid: boolean;
+    reasons: string[];
+}
+export interface FieldVerification {
+    field: string;
+    status: 'verified' | 'mismatch' | 'unavailable';
+}
+export interface ProviderAdapter {
+    readonly provider: RemoteProvider;
+    normalize(observation: SanitizedProviderObservation): NormalizedRemoteIssue;
+    plan(operation: SemanticOperation, input: Record<string, unknown>): SemanticAction;
+    validateObservation(action: SemanticAction, observation: SanitizedProviderObservation): ObservationValidation;
+    verificationFields(action: SemanticAction): string[];
+    verify(action: SemanticAction, issue: NormalizedRemoteIssue): FieldVerification[];
+}
+export declare function semanticDigest(value: unknown): string;
+export declare function contextsEqual(left: ProviderContext, right: ProviderContext): boolean;
+//# sourceMappingURL=provider.d.ts.map

package/dist/commands/pjm/remote/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/commands/pjm/remote/provider.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAC1D,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,iBAAiB,GACjB,mBAAmB,GACnB,QAAQ,GACR,QAAQ,GACR,YAAY,GACZ,UAAU,CAAC;AAEf,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC5C;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAClD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC;CACjD;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,SAAS,CAAC,WAAW,EAAE,4BAA4B,GAAG,qBAAqB,CAAC;IAC5E,IAAI,CACF,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,cAAc,CAAC;IAClB,mBAAmB,CACjB,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,4BAA4B,GACxC,qBAAqB,CAAC;IACzB,kBAAkB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAAC;IACrD,MAAM,CACJ,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,qBAAqB,GAC3B,iBAAiB,EAAE,CAAC;CACxB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAErD;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,eAAe,GACrB,OAAO,CAET"}

package/dist/commands/pjm/remote/provider.js

@@ -0,0 +1,28 @@
+import { createHash } from 'node:crypto';
+export function semanticDigest(value) {
+    return `sha256:${createHash('sha256').update(canonicalJson(value)).digest('hex')}`;
+}
+export function contextsEqual(left, right) {
+    return canonicalJson(left) === canonicalJson(right);
+}
+function canonicalJson(value) {
+    return JSON.stringify(canonicalize(value));
+}
+function canonicalize(value) {
+    if (value === null || ['string', 'boolean'].includes(typeof value))
+        return value;
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value))
+            throw new Error('Semantic values must be finite.');
+        return value;
+    }
+    if (Array.isArray(value))
+        return value.map(canonicalize);
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value)
+            .filter(([, entry]) => entry !== undefined)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, entry]) => [key, canonicalize(entry)]));
+    }
+    throw new Error(`Unsupported semantic value '${typeof value}'.`);
+}

package/dist/commands/pjm/remote/providers/github-publication-safety.d.ts

@@ -0,0 +1,46 @@
+import { type OutboundProjection, type OutboundProjectionSafetyResult } from '../../../pjm/remote/outbound-projection-safety.js';
+import { type ProviderContext } from '../../../pjm/remote/provider.js';
+export type GitHubRepositoryVisibility = 'private' | 'public' | 'unavailable';
+export type GitHubPublicationBlockReason = 'visibility-unavailable' | 'visibility-stale' | 'universal-safety-invalid' | 'prohibited-private-artifact';
+export interface GitHubRepositoryVisibilityObservation {
+    provider: 'github';
+    context: ProviderContext;
+    visibility: GitHubRepositoryVisibility;
+    capabilityEvidenceDigest: string;
+    observedAt: string;
+    evidenceDigest: string;
+}
+export interface GitHubPublicationSafetyInput {
+    visibilityObservation: GitHubRepositoryVisibilityObservation;
+    projection: OutboundProjection;
+    outboundSafety: OutboundProjectionSafetyResult | null;
+    assessedAt: string;
+}
+export interface GitHubPublicationSafetyResult {
+    schemaVersion: 1;
+    verdict: 'safe' | 'blocked';
+    reasons: GitHubPublicationBlockReason[];
+    assessedAt: string;
+    resultDigest: string;
+    preview: {
+        visibility: GitHubRepositoryVisibility;
+        contextDigest: string;
+        capabilityEvidenceDigest: string;
+        visibilityEvidenceDigest: string;
+        projectionDigest: string;
+        universalSafetyResultDigest: string;
+        verdict: 'safe' | 'blocked';
+        reasonCodes: GitHubPublicationBlockReason[];
+    };
+}
+export interface CurrentGitHubPublicationSafetyInput {
+    context: ProviderContext;
+    capabilityEvidenceDigest: string;
+    projection: OutboundProjection;
+    outboundSafety: OutboundProjectionSafetyResult;
+    result: GitHubPublicationSafetyResult;
+}
+export declare function observeGitHubRepositoryVisibility(input: Omit<GitHubRepositoryVisibilityObservation, 'provider' | 'evidenceDigest'>): GitHubRepositoryVisibilityObservation;
+export declare function assessGitHubPublicationSafety(input: GitHubPublicationSafetyInput): GitHubPublicationSafetyResult;
+export declare function requireCurrentGitHubPublicationSafety(input: CurrentGitHubPublicationSafetyInput): void;
+//# sourceMappingURL=github-publication-safety.d.ts.map

package/dist/commands/pjm/remote/providers/github-publication-safety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-publication-safety.d.ts","sourceRoot":"","sources":["../../../../../src/commands/pjm/remote/providers/github-publication-safety.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,8BAA8B,EACpC,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,MAAM,0BAA0B,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE9E,MAAM,MAAM,4BAA4B,GACpC,wBAAwB,GACxB,kBAAkB,GAClB,0BAA0B,GAC1B,6BAA6B,CAAC;AAElC,MAAM,WAAW,qCAAqC;IACpD,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,0BAA0B,CAAC;IACvC,wBAAwB,EAAE,MAAM,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,4BAA4B;IAC3C,qBAAqB,EAAE,qCAAqC,CAAC;IAC7D,UAAU,EAAE,kBAAkB,CAAC;IAC/B,cAAc,EAAE,8BAA8B,GAAG,IAAI,CAAC;IACtD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,6BAA6B;IAC5C,aAAa,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,4BAA4B,EAAE,CAAC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE;QACP,UAAU,EAAE,0BAA0B,CAAC;QACvC,aAAa,EAAE,MAAM,CAAC;QACtB,wBAAwB,EAAE,MAAM,CAAC;QACjC,wBAAwB,EAAE,MAAM,CAAC;QACjC,gBAAgB,EAAE,MAAM,CAAC;QACzB,2BAA2B,EAAE,MAAM,CAAC;QACpC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;QAC5B,WAAW,EAAE,4BAA4B,EAAE,CAAC;KAC7C,CAAC;CACH;AAED,MAAM,WAAW,mCAAmC;IAClD,OAAO,EAAE,eAAe,CAAC;IACzB,wBAAwB,EAAE,MAAM,CAAC;IACjC,UAAU,EAAE,kBAAkB,CAAC;IAC/B,cAAc,EAAE,8BAA8B,CAAC;IAC/C,MAAM,EAAE,6BAA6B,CAAC;CACvC;AAaD,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,IAAI,CACT,qCAAqC,EACrC,UAAU,GAAG,gBAAgB,CAC9B,GACA,qCAAqC,CAmBvC;AAED,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,4BAA4B,GAClC,6BAA6B,CAmD/B;AAED,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,mCAAmC,GACzC,IAAI,CAgCN"}

package/dist/commands/pjm/remote/providers/github-publication-safety.js

@@ -0,0 +1,126 @@
+import { requireCurrentOutboundSafety, } from '../../../pjm/remote/outbound-projection-safety.js';
+import { contextsEqual, semanticDigest, } from '../../../pjm/remote/provider.js';
+const PRIVATE_ARTIFACT_MARKERS = [
+    '.oat/projects/',
+    'discovery.md',
+    'spec.md',
+    'design.md',
+    'plan.md',
+    'implementation.md',
+    'review artifact',
+];
+const MAX_VISIBILITY_AGE_MS = 5 * 60 * 1000;
+export function observeGitHubRepositoryVisibility(input) {
+    if (!Number.isFinite(Date.parse(input.observedAt))) {
+        throw new Error('GitHub visibility observation requires a valid timestamp.');
+    }
+    if (!input.capabilityEvidenceDigest) {
+        throw new Error('GitHub visibility observation requires capability evidence.');
+    }
+    const evidence = {
+        provider: 'github',
+        context: input.context,
+        visibility: input.visibility,
+        capabilityEvidenceDigest: input.capabilityEvidenceDigest,
+        observedAt: input.observedAt,
+    };
+    return { ...evidence, evidenceDigest: semanticDigest(evidence) };
+}
+export function assessGitHubPublicationSafety(input) {
+    if (!Number.isFinite(Date.parse(input.assessedAt))) {
+        throw new Error('GitHub publication safety requires a valid timestamp.');
+    }
+    assertVisibilityObservation(input.visibilityObservation);
+    const reasons = [];
+    if (input.visibilityObservation.visibility === 'unavailable') {
+        reasons.push('visibility-unavailable');
+    }
+    const visibilityAge = Date.parse(input.assessedAt) -
+        Date.parse(input.visibilityObservation.observedAt);
+    if (visibilityAge < 0 || visibilityAge > MAX_VISIBILITY_AGE_MS) {
+        reasons.push('visibility-stale');
+    }
+    try {
+        requireCurrentOutboundSafety(input.projection, input.outboundSafety);
+    }
+    catch {
+        reasons.push('universal-safety-invalid');
+    }
+    if (containsPrivateArtifact(input.projection)) {
+        reasons.push('prohibited-private-artifact');
+    }
+    const uniqueReasons = [...new Set(reasons)];
+    const verdict = uniqueReasons.length === 0 ? 'safe' : 'blocked';
+    const preview = {
+        visibility: input.visibilityObservation.visibility,
+        contextDigest: semanticDigest(input.visibilityObservation.context),
+        capabilityEvidenceDigest: input.visibilityObservation.capabilityEvidenceDigest,
+        visibilityEvidenceDigest: input.visibilityObservation.evidenceDigest,
+        projectionDigest: input.outboundSafety?.projectionDigest ??
+            semanticDigest(input.projection),
+        universalSafetyResultDigest: input.outboundSafety?.resultDigest ?? 'missing',
+        verdict,
+        reasonCodes: uniqueReasons,
+    };
+    const resultWithoutDigest = {
+        schemaVersion: 1,
+        verdict,
+        reasons: uniqueReasons,
+        assessedAt: input.assessedAt,
+        preview,
+    };
+    return {
+        ...resultWithoutDigest,
+        resultDigest: semanticDigest(resultWithoutDigest),
+    };
+}
+export function requireCurrentGitHubPublicationSafety(input) {
+    requireCurrentOutboundSafety(input.projection, input.outboundSafety);
+    if (input.result.verdict !== 'safe') {
+        throw new Error('GitHub publication safety blocks execution.');
+    }
+    if (input.result.preview.capabilityEvidenceDigest !==
+        input.capabilityEvidenceDigest) {
+        throw new Error('GitHub publication capability evidence is mismatched.');
+    }
+    if (input.result.preview.contextDigest !== semanticDigest(input.context)) {
+        throw new Error('GitHub publication context evidence is mismatched.');
+    }
+    if (input.result.preview.projectionDigest !==
+        input.outboundSafety.projectionDigest ||
+        input.result.preview.universalSafetyResultDigest !==
+            input.outboundSafety.resultDigest) {
+        throw new Error('GitHub publication projection evidence is mismatched.');
+    }
+    const expectedDigest = semanticDigest({
+        schemaVersion: input.result.schemaVersion,
+        verdict: input.result.verdict,
+        reasons: input.result.reasons,
+        assessedAt: input.result.assessedAt,
+        preview: input.result.preview,
+    });
+    if (expectedDigest !== input.result.resultDigest) {
+        throw new Error('GitHub publication safety result digest is invalid.');
+    }
+}
+function assertVisibilityObservation(observation) {
+    if (observation.provider !== 'github') {
+        throw new Error('GitHub visibility evidence has the wrong provider.');
+    }
+    const expected = observeGitHubRepositoryVisibility({
+        context: observation.context,
+        visibility: observation.visibility,
+        capabilityEvidenceDigest: observation.capabilityEvidenceDigest,
+        observedAt: observation.observedAt,
+    });
+    if (expected.evidenceDigest !== observation.evidenceDigest) {
+        throw new Error('GitHub visibility evidence digest is invalid.');
+    }
+    if (!contextsEqual(expected.context, observation.context)) {
+        throw new Error('GitHub visibility context evidence is invalid.');
+    }
+}
+function containsPrivateArtifact(projection) {
+    return Object.values(projection).some((value) => typeof value === 'string' &&
+        PRIVATE_ARTIFACT_MARKERS.some((marker) => value.toLowerCase().includes(marker)));
+}

package/dist/commands/pjm/remote/providers/github.d.ts

@@ -0,0 +1,207 @@
+import { type OutboundProjection, type OutboundProjectionSafetyResult } from '../../../pjm/remote/outbound-projection-safety.js';
+import { type NormalizedRemoteIssue, type ObservationValidation, type FieldVerification, type ProviderAdapter, type ProviderContext, type SanitizedProviderObservation, type SemanticAction, type SemanticOperation } from '../../../pjm/remote/provider.js';
+import { type GitHubPublicationSafetyResult } from './github-publication-safety.js';
+export interface GitHubIssueReference {
+    host?: string;
+    owner: string;
+    name: string;
+    number: number;
+    alias: string;
+}
+export type GitHubSemanticField = 'stable-identity' | 'title' | 'body' | 'state' | 'priority' | 'revision';
+export interface GitHubHostCapabilityObservation {
+    provider: 'github';
+    context: ProviderContext;
+    availability: 'available' | 'unavailable' | 'authorization-required' | 'rate-limited';
+    accountId: string;
+    repositoryId: string;
+    operations: SemanticOperation[];
+    observableFields: GitHubSemanticField[];
+    evidenceDigest: string;
+}
+export interface GitHubCapabilityExpectation {
+    operation: SemanticOperation;
+    context: ProviderContext;
+    requiredFields?: GitHubSemanticField[];
+}
+export type GitHubReadLifecycle = 'current' | 'renamed' | 'transferred' | 'archived' | 'inaccessible' | 'deleted' | 'temporarily-unavailable';
+export interface GitHubReadResult {
+    classification: GitHubReadLifecycle;
+    issue: NormalizedRemoteIssue | null;
+    freshness: {
+        observedAt: string;
+        revisionStrength: 'strong' | 'weak';
+    } | null;
+    preservePriorEvidence: boolean;
+    reasons: string[];
+}
+export interface GitHubReadObservationInput {
+    action: SemanticAction;
+    hostCapability: GitHubHostCapabilityObservation;
+    observedAt: string;
+    outcome: 'found' | 'not-found' | 'temporary-failure';
+    observation?: SanitizedProviderObservation;
+    archived?: boolean;
+    deletionEvidence?: {
+        provider: 'github';
+        stableId: string;
+        context: ProviderContext;
+        capabilityEvidenceDigest: string;
+        actionDigest: string;
+        stepId: string;
+        observedAt: string;
+        evidenceDigest: string;
+    };
+}
+export type GitHubMutationField = 'title' | 'description' | 'priority' | 'status' | 'annotation';
+export interface GitHubMutationPreviewInput {
+    operation: 'create' | 'update' | 'transition' | 'annotate';
+    context: ProviderContext;
+    bindingId: string;
+    stableId?: string;
+    provenance?: {
+        bindingId: string;
+        origin: string;
+    };
+    fieldMask: GitHubMutationField[];
+    descriptionMode: 'managed-section' | 'replace' | 'none';
+    currentBody?: string;
+    projection: OutboundProjection;
+    outboundSafety: OutboundProjectionSafetyResult;
+    hostCapability: GitHubHostCapabilityObservation;
+    publicationSafety: GitHubPublicationSafetyResult;
+}
+export interface GitHubMutationPlanInput extends GitHubMutationPreviewInput {
+    approvedPreviewDigest: string;
+}
+export interface GitHubMutationPreview {
+    previewDigest: string;
+    executionEvidence: {
+        capabilityEvidenceDigest: string;
+        projectionDigest: string;
+        outboundSafetyResultDigest: string;
+        publicationSafetyResultDigest: string;
+        visibilityEvidenceDigest: string;
+    };
+}
+export type GitHubMutationVerificationClassification = 'verified' | 'partial' | 'rejected' | 'uncertain';
+export interface GitHubMutationVerificationInput {
+    action: SemanticAction;
+    attempt: {
+        count: number;
+        outcome: 'accepted' | 'rejected' | 'unknown';
+        capabilityEvidenceDigest: string;
+    };
+    hostCapability: GitHubHostCapabilityObservation;
+    readback: SanitizedProviderObservation | null;
+}
+export interface GitHubMutationVerificationResult {
+    classification: GitHubMutationVerificationClassification;
+    reason: string;
+    fields: FieldVerification[];
+    retryAllowed: false;
+}
+export interface GitHubDuplicateSearchPlanInput {
+    context: ProviderContext;
+    hostCapability: GitHubHostCapabilityObservation;
+    provenanceToken: string;
+    reservedBindingId: string;
+    historicalAliases: string[];
+    maxResults: number;
+}
+export interface GitHubDuplicateCandidate {
+    stableId: string;
+    aliases: string[];
+    context: ProviderContext;
+    matchedBy: 'provenance' | 'reserved-binding' | 'alias';
+    matchedProvenanceToken?: string;
+    matchedReservedBindingId?: string;
+    matchedAlias?: string;
+    stableIdentityVerified: boolean;
+    contextVerified: boolean;
+    historicalRepositoryIds: string[];
+    transferEvidence?: GitHubDuplicateTransferEvidence;
+}
+export interface GitHubDuplicateTransferEvidence {
+    provider: 'github';
+    stableId: string;
+    fromContext: ProviderContext;
+    toContext: ProviderContext;
+    capabilityEvidenceDigest: string;
+    queryDigest: string;
+    observedAt: string;
+    evidenceDigest: string;
+}
+export interface GitHubDuplicateSearchObservation {
+    provider: 'github';
+    context: ProviderContext;
+    availability: 'available' | 'unavailable';
+    capabilityEvidenceDigest: string;
+    queryDigest: string;
+    observedAt: string;
+    results: GitHubDuplicateCandidate[];
+}
+export interface GitHubDuplicateSearchValidationInput {
+    action: SemanticAction;
+    hostCapability: GitHubHostCapabilityObservation;
+    observation: GitHubDuplicateSearchObservation;
+}
+export interface GitHubDuplicateSearchValidationResult {
+    accepted: boolean;
+    classification: 'no-match' | 'one-verified-match' | 'ambiguous' | 'unavailable' | 'invalid';
+    stableId: string | null;
+    reasons: string[];
+}
+export interface GitHubDiscussionReadPlanInput {
+    context: ProviderContext;
+    hostCapability: GitHubHostCapabilityObservation;
+    stableId: string;
+    evidenceKind: 'comments' | 'activity';
+    cursor: string | null;
+    limit: number;
+}
+export interface GitHubDiscussionItemObservation {
+    id: string;
+    kind: 'comment' | 'activity';
+    body: string;
+    observedAt: string;
+}
+export interface GitHubDiscussionReadObservation {
+    provider: 'github';
+    context: ProviderContext;
+    stableId: string;
+    availability: 'available' | 'rate-limited' | 'permission-denied';
+    capabilityEvidenceDigest: string;
+    requestedCursor: string | null;
+    nextCursor: string | null;
+    items: GitHubDiscussionItemObservation[];
+}
+export interface GitHubDiscussionReadValidationInput {
+    action: SemanticAction;
+    hostCapability: GitHubHostCapabilityObservation;
+    observation: GitHubDiscussionReadObservation;
+}
+export interface GitHubDiscussionReadValidationResult {
+    classification: 'page' | 'rate-limited' | 'permission-denied' | 'invalid';
+    page: {
+        items: Array<GitHubDiscussionItemObservation & {
+            contentSuppressed: boolean;
+        }>;
+        nextCursor: string | null;
+    } | null;
+    persistable: false;
+    reasons: string[];
+}
+export declare function parseGitHubIssueReference(reference: string): GitHubIssueReference | null;
+export declare function normalizeGitHubIssueObservation(observation: SanitizedProviderObservation): NormalizedRemoteIssue;
+export declare function validateGitHubHostCapability(expected: GitHubCapabilityExpectation, observed: GitHubHostCapabilityObservation): ObservationValidation;
+export declare function classifyGitHubReadObservation(input: GitHubReadObservationInput): GitHubReadResult;
+export declare function previewGitHubMutation(input: GitHubMutationPreviewInput): GitHubMutationPreview;
+export declare function planGitHubMutation(input: GitHubMutationPlanInput): SemanticAction;
+export declare function verifyGitHubMutationObservation(input: GitHubMutationVerificationInput): GitHubMutationVerificationResult;
+export declare function planDuplicateSearch(input: GitHubDuplicateSearchPlanInput): SemanticAction;
+export declare function validateDuplicateSearchObservation(input: GitHubDuplicateSearchValidationInput): GitHubDuplicateSearchValidationResult;
+export declare function planDiscussionRead(input: GitHubDiscussionReadPlanInput): SemanticAction;
+export declare function validateDiscussionReadObservation(input: GitHubDiscussionReadValidationInput): GitHubDiscussionReadValidationResult;
+export declare const githubAdapter: ProviderAdapter;
+//# sourceMappingURL=github.d.ts.map

package/dist/commands/pjm/remote/providers/github.d.ts.map

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