@vypdev/copilot 3.10.5 → 3.10.6

package/build/api/src/application/ports/bugbot_pull_request_resolution_ports.d.ts

@@ -1,7 +1,8 @@
-import type { PullRequestReviewComment, PullRequestReviewCommentListQueryPort, PullRequestReviewCommentUpdatePort, PullRequestReviewThreadCommandPort } from "./pull_request_review_comment_ports";
-export interface BugbotPullRequestResolutionPort extends PullRequestReviewCommentListQueryPort, PullRequestReviewCommentUpdatePort, PullRequestReviewThreadCommandPort {
+import type { PullRequestReviewThreadStateQueryPort, BoundPullRequestReviewThreadStateQueryPort, PullRequestReviewComment, PullRequestReviewCommentListQueryPort, PullRequestReviewCommentUpdatePort, PullRequestReviewThreadCommandPort } from "./pull_request_review_comment_ports";
+export interface BugbotPullRequestResolutionPort extends PullRequestReviewCommentListQueryPort, PullRequestReviewCommentUpdatePort, PullRequestReviewThreadCommandPort, Partial<PullRequestReviewThreadStateQueryPort> {
 }
-export interface BoundBugbotPullRequestResolutionPort {
+/** Re-adjudicating a withdrawn dismissal requires the optional fresh-thread query. */
+export interface BoundBugbotPullRequestResolutionPort extends Partial<BoundPullRequestReviewThreadStateQueryPort> {
     listPullRequestReviewComments(pullRequestNumber: number): Promise<PullRequestReviewComment[]>;
     updatePullRequestReviewComment(commentIdentity: string, body: string): Promise<void>;
     resolvePullRequestReviewThread(pullRequestNumber: number, commentIdentity: string): Promise<void>;

package/build/api/src/application/ports/bugbot_pull_request_write_ports.d.ts

@@ -1,8 +1,9 @@
-import type { PullRequestReviewCommentDraft, PullRequestReviewReference, PullRequestReviewCommentCommandPort, PullRequestReviewThreadCommandPort } from "./pull_request_review_comment_ports";
+import type { PullRequestReviewThreadStateQueryPort, BoundPullRequestReviewThreadStateQueryPort, PullRequestReviewCommentDraft, PullRequestReviewReference, PullRequestReviewCommentCommandPort, PullRequestReviewThreadCommandPort } from "./pull_request_review_comment_ports";
 /** Publication may refresh a comment and reopen its thread when a finding returns. */
-export interface BugbotPullRequestWritePort extends PullRequestReviewCommentCommandPort, Pick<PullRequestReviewThreadCommandPort, "unresolvePullRequestReviewThread"> {
+export interface BugbotPullRequestWritePort extends PullRequestReviewCommentCommandPort, Pick<PullRequestReviewThreadCommandPort, "unresolvePullRequestReviewThread">, Partial<PullRequestReviewThreadStateQueryPort> {
 }
-export interface BoundBugbotPullRequestWritePort {
+/** Re-adjudicating a withdrawn dismissal requires the optional fresh-thread query. */
+export interface BoundBugbotPullRequestWritePort extends Partial<BoundPullRequestReviewThreadStateQueryPort> {
     createReviewWithComments(pullRequestNumber: number, commitId: string, body: string, comments: PullRequestReviewCommentDraft[]): Promise<PullRequestReviewReference | undefined>;
     updatePullRequestReviewComment(commentIdentity: string, body: string): Promise<void>;
     unresolvePullRequestReviewThread(pullRequestNumber: number, commentIdentity: string): Promise<void>;

package/build/api/src/application/ports/pull_request_review_comment_ports.d.ts

@@ -70,3 +70,7 @@ export interface PullRequestReviewThreadState {
     resolved: boolean;
     resolvedByLogin?: string;
 }
+/** Fresh thread facts for an already-bound repository identity. */
+export interface BoundPullRequestReviewThreadStateQueryPort {
+    listPullRequestReviewThreadStates(pullRequestNumber: number): Promise<Record<string, PullRequestReviewThreadState>>;
+}

package/build/api/src/data/model/application_error.d.ts

@@ -1,11 +1,19 @@
+import { type ProgressBinaryEvidenceFacts } from '../../domain/progress_binary_evidence_diagnostic';
+import { type IssueWorkflowDiagnosticFacts } from '../../domain/issue_workflow_diagnostic';
+import { type ChangeSizeReconciliationFacts } from '../../domain/change_size_reconciliation';
+import { type CopilotCommandValidationReason } from '../../domain/copilot_command_validation';
+import type { CopilotCommandName } from '../../domain/copilot_command';
 import { type ClosedIssueReconciliationFacts } from '../../domain/closed_issue_reconciliation';
 import { type ApprovalEvidenceDiagnostic } from '../../domain/approval_evidence_diagnostic';
 import { type BranchSyncValidationCode } from '../../domain/branch_sync_validation';
+import { type BranchSyncVerificationFailure } from '../../domain/verification_failure';
 export type ApplicationErrorKind = 'configuration' | 'authorization' | 'provider' | 'agent' | 'validation' | 'workflow' | 'unknown';
 export type ApplicationErrorCode = 'configuration.invalid' | 'configuration.unsupported' | 'authorization.denied' | 'authorization.credential-invalid' | 'provider.not-found' | 'provider.conflict' | 'provider.rate-limited' | 'provider.unavailable' | 'provider.contract-invalid' | 'agent.policy-rejected' | 'agent.failed' | 'locale.output-invalid' | 'locale.translation-failed' | 'validation.invalid-input' | 'validation.evidence-too-large' | 'validation.evidence-unavailable' | 'workflow.invalid-event' | 'workflow.stale' | 'workflow.cancelled' | 'workflow.failed' | 'workflow.presentation-pending' | 'timeout' | 'unexpected';
-export declare const APPLICATION_ERROR_RECOVERY_IDS: readonly ["pull-request-link-restored", "pull-request-link-base-retained", "pull-request-link-reference-retained", "pull-request-link-base-and-reference-retained", "managed-branch-enrichment-failed", "inactivity-explanation-failed", "bugbot-review-blocks-pending", "branch-sync-agent-disabled", "branch-sync-fixer-unavailable", "branch-sync-resolution-invalid", "sdd-draft-size-exceeded", "sdd-draft-format-invalid", "sdd-draft-case-identity-invalid", "sdd-draft-case-budget-invalid", "sdd-draft-requirement-mapping-invalid", "sdd-draft-repository-path-invalid", "workspace-changes-rejected", "closed-issue-reconciliation-failed", "approval-evidence-read-failed", "stored-configuration-schema-missing", "stored-configuration-schema-unsupported", "stored-configuration-invalid"];
+export declare const APPLICATION_ERROR_RECOVERY_IDS: readonly ["comment-command-length", "comment-command-name-missing", "comment-command-name-unknown", "comment-command-argument-count", "comment-command-arguments-unexpected", "comment-command-arguments-missing", "comment-command-finding-quoting", "comment-command-review-format", "comment-command-review-effort", "comment-command-review-boolean", "comment-command-review-option", "comment-command-sync-option", "comment-command-sync-parent", "pull-request-link-restored", "pull-request-link-base-retained", "pull-request-link-reference-retained", "pull-request-link-base-and-reference-retained", "managed-branch-enrichment-failed", "inactivity-explanation-failed", "bugbot-review-blocks-pending", "branch-sync-agent-disabled", "branch-sync-fixer-unavailable", "branch-sync-resolution-invalid", "branch-sync-verification-failed", "sdd-draft-size-exceeded", "sdd-catalog-unsupported-profile", "sdd-catalog-format-invalid", "sdd-draft-format-invalid", "sdd-draft-case-identity-invalid", "sdd-draft-case-budget-invalid", "sdd-draft-requirement-mapping-invalid", "sdd-draft-repository-path-invalid", "deployment-publication-context-missing", "workspace-changes-rejected", "closed-issue-reconciliation-failed", "approval-evidence-read-failed", "change-size-reconciliation-failed", "issue-workflow-admission-blocked", "progress-binary-evidence-unavailable", "stored-configuration-schema-missing", "stored-configuration-schema-unsupported", "stored-configuration-invalid"];
 export type ApplicationErrorRecoveryId = typeof APPLICATION_ERROR_RECOVERY_IDS[number];
-interface ApplicationErrorRecoveryVariables {
+interface ApplicationErrorRecoveryVariables extends Readonly<Record<CopilotCommandValidationReason, Readonly<{
+    command: CopilotCommandName;
+}>>> {
     readonly 'stored-configuration-schema-missing': Readonly<{
         issueNumber: number;
         expectedVersion: number;
@@ -21,6 +29,9 @@ interface ApplicationErrorRecoveryVariables {
     }>;
     readonly 'closed-issue-reconciliation-failed': ClosedIssueReconciliationFacts;
     readonly 'approval-evidence-read-failed': ApprovalEvidenceDiagnostic;
+    readonly 'change-size-reconciliation-failed': ChangeSizeReconciliationFacts;
+    readonly 'issue-workflow-admission-blocked': IssueWorkflowDiagnosticFacts;
+    readonly 'progress-binary-evidence-unavailable': ProgressBinaryEvidenceFacts;
     readonly 'pull-request-link-restored': Readonly<Record<string, never>>;
     readonly 'pull-request-link-base-retained': Readonly<Record<string, never>>;
     readonly 'pull-request-link-reference-retained': Readonly<Record<string, never>>;
@@ -44,12 +55,16 @@ interface ApplicationErrorRecoveryVariables {
         validationCode: BranchSyncValidationCode;
         command: '/copilot sync-branch';
     }>;
+    readonly 'branch-sync-verification-failed': BranchSyncVerificationFailure;
     readonly 'sdd-draft-size-exceeded': Readonly<Record<string, never>>;
+    readonly 'sdd-catalog-unsupported-profile': Readonly<Record<string, never>>;
+    readonly 'sdd-catalog-format-invalid': Readonly<Record<string, never>>;
     readonly 'sdd-draft-format-invalid': Readonly<Record<string, never>>;
     readonly 'sdd-draft-case-identity-invalid': Readonly<Record<string, never>>;
     readonly 'sdd-draft-case-budget-invalid': Readonly<Record<string, never>>;
     readonly 'sdd-draft-requirement-mapping-invalid': Readonly<Record<string, never>>;
     readonly 'sdd-draft-repository-path-invalid': Readonly<Record<string, never>>;
+    readonly 'deployment-publication-context-missing': Readonly<Record<string, never>>;
     readonly 'workspace-changes-rejected': Readonly<Record<string, never>>;
 }
 export type ApplicationErrorRecovery = {

package/build/api/src/domain/change_size_reconciliation.d.ts

@@ -0,0 +1,15 @@
+export declare const CHANGE_SIZE_OPERATIONS: readonly ["calculate-size", "issue-labels", "issue-project-size", "list-pull-requests", "pr-label-read", "pr-label-write", "pr-project-membership", "pr-project-size"];
+export type ChangeSizeOperation = typeof CHANGE_SIZE_OPERATIONS[number];
+/** Only bounded identifiers and closed operation names cross the public error boundary. */
+export interface ChangeSizeReconciliationFacts {
+    readonly operation: ChangeSizeOperation;
+    readonly issueNumber: number;
+    readonly targetNumber: number;
+    /** One-based configured Project position; zero means no Project operation. */
+    readonly projectIndex: number;
+    readonly verifiedOperations: number;
+    readonly pendingProjectSizes: number;
+    readonly providerStatus: string;
+    readonly providerReference: string;
+}
+export declare function isChangeSizeReconciliationFacts(value: Readonly<Record<string, unknown>>): boolean;

package/build/api/src/domain/copilot_command.d.ts

@@ -0,0 +1,25 @@
+import type { CopilotCommandValidationDiagnostic } from './copilot_command_validation';
+import { type CopilotCommandName } from './copilot_command_vocabulary';
+export { COPILOT_COMMAND_NAMES, type CopilotCommandName } from './copilot_command_vocabulary';
+/** Commands whose arguments may contain human prose that benefits from locale adaptation. */
+export declare function copilotCommandAcceptsAdaptableProse(name: CopilotCommandName): boolean;
+export interface ParsedCopilotCommand {
+    readonly name: CopilotCommandName;
+    readonly arguments: readonly string[];
+    readonly raw: string;
+}
+export type CopilotCommandParseResult = {
+    readonly kind: 'none';
+} | {
+    readonly kind: 'command';
+    readonly command: ParsedCopilotCommand;
+} | {
+    readonly kind: 'invalid';
+    readonly reason: string;
+    readonly validation: CopilotCommandValidationDiagnostic;
+};
+/**
+ * Parses only a command at the beginning of a comment. Everything else is
+ * ordinary user data and must continue through the existing agent flow.
+ */
+export declare function parseCopilotCommand(raw: unknown): CopilotCommandParseResult;

package/build/api/src/domain/copilot_command_validation.d.ts

@@ -0,0 +1,10 @@
+import type { CopilotCommandName } from './copilot_command_vocabulary';
+/** Closed public reasons; none contains user text, operands, paths or credentials. */
+export declare const COPILOT_COMMAND_VALIDATION_REASONS: readonly ["comment-command-length", "comment-command-name-missing", "comment-command-name-unknown", "comment-command-argument-count", "comment-command-arguments-unexpected", "comment-command-arguments-missing", "comment-command-finding-quoting", "comment-command-review-format", "comment-command-review-effort", "comment-command-review-boolean", "comment-command-review-option", "comment-command-sync-option", "comment-command-sync-parent"];
+export type CopilotCommandValidationReason = typeof COPILOT_COMMAND_VALIDATION_REASONS[number];
+export interface CopilotCommandValidationDiagnostic {
+    readonly reason: CopilotCommandValidationReason;
+    readonly command: CopilotCommandName;
+}
+export declare function isCopilotCommandValidationReason(value: unknown): value is CopilotCommandValidationReason;
+export declare function isValidCopilotCommandValidation(reason: unknown, command: unknown): boolean;

package/build/api/src/domain/copilot_command_vocabulary.d.ts

@@ -0,0 +1,3 @@
+/** Explicit commands are the safe, deterministic entry point for mutations. */
+export declare const COPILOT_COMMAND_NAMES: readonly ["help", "analyze", "plan", "clarify", "estimate", "test-plan", "status", "sdd-diff", "doctor", "history", "description", "explain", "diagnose", "review", "findings", "fix", "dismiss", "remember", "recheck", "implement", "sync-branch"];
+export type CopilotCommandName = typeof COPILOT_COMMAND_NAMES[number];

package/build/api/src/domain/issue_workflow_diagnostic.d.ts

@@ -0,0 +1,10 @@
+import { type IssueWorkflowAdmission } from './issue_workflow_profile';
+export interface IssueWorkflowDiagnosticFacts {
+    readonly kind: string;
+    readonly reason: 'missing-fields' | 'invalid-fields' | 'disabled-kind' | 'conflicting-kinds' | 'unmanaged';
+    readonly fields: string;
+}
+export declare function issueWorkflowDiagnostic(admission: IssueWorkflowAdmission | undefined): IssueWorkflowDiagnosticFacts | undefined;
+export declare function isIssueWorkflowDiagnostic(value: Readonly<Record<string, unknown>>): boolean;
+/** Bound heading data stays inert in Markdown tables, HTML, mentions and code spans. */
+export declare function issueWorkflowDiagnosticPresentation(facts: IssueWorkflowDiagnosticFacts): Readonly<Record<string, string>>;

package/build/api/src/domain/issue_workflow_field_mapping.d.ts

@@ -0,0 +1,10 @@
+export type WorkflowFieldMappings<Kind extends string = string> = Readonly<Partial<Record<Kind, Readonly<Record<string, string>>>>>;
+export declare const ISSUE_FIELD_HEADING_MAX_BYTES = 128;
+type Definitions = Readonly<Record<string, {
+    readonly requiredHeadings: readonly string[];
+}>>;
+/** One explicit replacement per canonical semantic field; never guesses an alias from an issue body. */
+export declare function normalizeWorkflowFieldMappings(value: unknown, definitions: Definitions, enabled: readonly string[]): WorkflowFieldMappings | undefined;
+export declare function isIssueFieldHeading(value: unknown): value is string;
+export declare function escapeIssueFieldHeadingMarkdown(field: string): string;
+export {};

package/build/api/src/domain/issue_workflow_profile.d.ts

@@ -0,0 +1,67 @@
+import { type WorkflowFieldMappings } from './issue_workflow_field_mapping';
+/** Stable workflow identifiers used by setup, generated guidance, and Actions. */
+export type IssueWorkflowKind = 'feature' | 'bugfix' | 'documentation' | 'chore' | 'help' | 'hotfix' | 'release';
+export declare const ISSUE_WORKFLOW_KINDS: readonly IssueWorkflowKind[];
+/** Canonical values shared by admission, form inspection and deterministic readers. */
+export declare const ISSUE_WORKFLOW_RELEASE_TYPES: readonly ["Patch", "Minor", "Major"];
+export declare function parseIssueWorkflowReleaseType(value: string): typeof ISSUE_WORKFLOW_RELEASE_TYPES[number] | undefined;
+export interface IssueWorkflowDefinition {
+    readonly id: IssueWorkflowKind;
+    readonly label: string;
+    readonly formFile: string;
+    readonly nativeIssueType: 'Feature' | 'Bug' | 'Documentation' | 'Maintenance' | 'Question' | 'Help' | 'Hotfix' | 'Release';
+    readonly labels: readonly string[];
+    readonly branchManaged: boolean;
+    readonly requiredHeadings: readonly string[];
+    readonly requiredValueHeadings: readonly string[];
+}
+export declare const ISSUE_WORKFLOW_CATALOG: Readonly<Record<IssueWorkflowKind, IssueWorkflowDefinition>>;
+export interface IssueWorkflowProfile {
+    readonly schemaVersion: 1 | 2;
+    readonly enabled: readonly IssueWorkflowKind[];
+    readonly fieldMappings?: WorkflowFieldMappings<IssueWorkflowKind>;
+}
+export type IssueWorkflowProfileParseResult = {
+    readonly profile: IssueWorkflowProfile;
+} | {
+    readonly error: string;
+};
+export type IssueWorkflowAdmission = {
+    readonly status: 'eligible';
+    readonly kind: IssueWorkflowKind;
+} | {
+    readonly status: 'unmanaged';
+    readonly reason: 'no-recognized-kind';
+} | {
+    readonly status: 'disabled';
+    readonly kind: IssueWorkflowKind;
+} | {
+    readonly status: 'conflict';
+    readonly kinds: readonly IssueWorkflowKind[];
+} | {
+    readonly status: 'invalid';
+    readonly kind: IssueWorkflowKind;
+    readonly missingHeadings: readonly string[];
+    readonly invalidFields?: readonly string[];
+};
+export interface IssueWorkflowLabelConfiguration {
+    readonly feature?: readonly string[];
+    readonly bugfix?: readonly string[];
+    readonly documentation?: readonly string[];
+    readonly chore?: readonly string[];
+    readonly help?: readonly string[];
+    readonly hotfix?: readonly string[];
+    readonly release?: readonly string[];
+}
+export declare const ALL_ISSUE_WORKFLOWS: IssueWorkflowProfile;
+export declare function createIssueWorkflowProfile(enabled: readonly IssueWorkflowKind[], fieldMappings?: WorkflowFieldMappings<IssueWorkflowKind>): IssueWorkflowProfile;
+/** Empty input selects all workflows with the same admission checks as an explicit profile. */
+export declare function parseIssueWorkflowProfile(raw: string | undefined): IssueWorkflowProfileParseResult;
+export declare function serializeIssueWorkflowProfile(profile: IssueWorkflowProfile): string;
+export declare function classifyIssueWorkflow(labels: readonly string[], profile?: IssueWorkflowProfile, labelConfiguration?: IssueWorkflowLabelConfiguration, body?: string, validateBody?: boolean): IssueWorkflowAdmission;
+export declare function hasMarkdownHeading(body: string, heading: string): boolean;
+export declare function issueWorkflowFormFiles(profile: IssueWorkflowProfile): readonly string[];
+export declare function isAutomaticOrVersion(value: string): boolean;
+export declare function issueWorkflowHeading(profile: IssueWorkflowProfile, kind: IssueWorkflowKind, canonical: string): string;
+export declare function issueWorkflowRequiredHeadings(profile: IssueWorkflowProfile, kind: IssueWorkflowKind): readonly string[];
+export type IssueWorkflowFieldMappings = WorkflowFieldMappings<IssueWorkflowKind>;

package/build/api/src/domain/progress_binary_evidence_diagnostic.d.ts

@@ -0,0 +1,9 @@
+export interface ProgressBinaryEvidenceFacts {
+    readonly paths: string;
+    readonly pathCount: number;
+}
+/** Canonical, bounded exact paths. The total discloses additional unreviewed paths in the pinned inventory. */
+export declare function progressBinaryEvidenceFacts(paths: readonly string[]): ProgressBinaryEvidenceFacts;
+export declare function isProgressBinaryEvidenceFacts(value: Readonly<Record<string, unknown>>): boolean;
+/** JSON renders control characters literally; a noncolliding code span keeps paths inert in Markdown and plain CLI text. */
+export declare function progressBinaryEvidencePresentation(facts: ProgressBinaryEvidenceFacts): Readonly<Record<string, string | number>>;

package/build/api/src/domain/verification_failure.d.ts

@@ -0,0 +1,15 @@
+/** Closed operational facts; never populate these with subprocess output or arbitrary argv. */
+export declare const VERIFICATION_FAILURE_STAGES: readonly ["dependencies", "repository-setup", "runtime", "command"];
+export declare const VERIFICATION_FAILURE_REASONS: readonly ["tool-unavailable", "unsupported-graph", "install-failed", "candidate-changed", "setup-blocked", "runtime-blocked", "command-failed", "command-invalid"];
+export declare const VERIFICATION_COMMAND_LABELS: readonly ["configured-command", "pnpm run build", "pnpm run typecheck", "pnpm run test:coverage", "pnpm run lint", "pnpm run validate:documentation", "pnpm run validate:specifications"];
+export type VerificationFailure = {
+    readonly stage: typeof VERIFICATION_FAILURE_STAGES[number];
+    readonly reason: typeof VERIFICATION_FAILURE_REASONS[number];
+    readonly command: typeof VERIFICATION_COMMAND_LABELS[number];
+    readonly commandIndex: number;
+};
+export type BranchSyncVerificationFailure = VerificationFailure & {
+    readonly childSha: string;
+    readonly restoration: 'restored' | 'unverified';
+};
+export declare function isBranchSyncVerificationFailure(value: Readonly<Record<string, unknown>>): boolean;