snipara-companion 2.0.2 → 2.0.4

package/dist/index.d.ts

@@ -541,6 +541,41 @@ interface EmitEventResult {
     sessionIds: string[];
     events: AutomationCheckpointSummary[];
 }
+type AdvisorInfluenceAgentDecision = "accepted" | "modified" | "ignored" | "blocked";
+type AdvisorInfluenceOutcomeLinkStatus = "pending" | "linked" | "missed" | "unevaluated";
+interface AdvisorInfluenceRecommendationInput {
+    id: string;
+    version?: "advisor-recommendation-v0";
+    source: string;
+    severity: string;
+    title: string;
+    rationale: string;
+    reasonCodes: string[];
+    historicalImpactSummary?: string | null;
+    reasonCodeReliability?: number | null;
+    recommendedVerification: string[];
+    expectedBehaviorChange: string;
+    evidence?: unknown[];
+    caveats?: string[];
+}
+interface RecordAdvisorInfluenceReceiptInput {
+    servedJudgmentId: string;
+    recommendation: AdvisorInfluenceRecommendationInput;
+    agentDecision: AdvisorInfluenceAgentDecision;
+    behaviorChange: string;
+    verificationExecuted: string[];
+    outcomeLinkStatus?: AdvisorInfluenceOutcomeLinkStatus;
+    metadata?: Record<string, unknown>;
+}
+interface RecordAdvisorInfluenceReceiptResult {
+    project: {
+        id: string;
+        name: string;
+        slug: string;
+    };
+    receipt: Record<string, unknown>;
+    advisorInfluence: Record<string, unknown>;
+}
 interface AutomationConfigFile {
     path: string;
     content: string;
@@ -1179,6 +1214,7 @@ declare class RLMClient {
         privacy_level: "standard" | "sensitive" | "restricted";
         payload?: Record<string, unknown>;
     }): Promise<EmitEventResult>;
+    recordAdvisorInfluenceReceipt(input: RecordAdvisorInfluenceReceiptInput): Promise<RecordAdvisorInfluenceReceiptResult>;
     getAutomationEvents(args?: {
         sessionId?: string;
         limit?: number;
@@ -1992,6 +2028,74 @@ declare function memoryLocalCommand(options: LocalMemoryCommandOptions): Promise
 declare function evalExportCommand(options: EvalExportOptions): Promise<void>;
 declare function evalRunCommand(options: EvalRunOptions): Promise<void>;
 
+type ProjectPolicyGateSeverity = "advisory" | "required_action" | "block";
+type ProjectPolicyGateSurface = "release" | "schema" | "auth" | "billing" | "deploy" | "package_surface";
+type ProjectPolicyGateSampleMode = "not_applicable" | "structural" | "explicit_contract" | "sample_gated";
+interface ProjectPolicyGateSampleGate {
+    mode: ProjectPolicyGateSampleMode;
+    satisfied: boolean;
+    observedSamples: number;
+    requiredSamples: number;
+    rationale: string;
+}
+interface ProjectPolicyGateAudit {
+    registryVersion: "project-intelligence.policy-gates.registry.v1";
+    source: string;
+    reasonCodes: string[];
+    humanOverrideAllowed: boolean;
+    humanOverrideRequiresReason: boolean;
+}
+interface ProjectPolicyGateDecision {
+    id: string;
+    surface: ProjectPolicyGateSurface;
+    severity: ProjectPolicyGateSeverity;
+    title: string;
+    rationale: string;
+    evidence: string[];
+    requiredActions: string[];
+    suggestedCommands: string[];
+    sampleGate: ProjectPolicyGateSampleGate;
+    audit: ProjectPolicyGateAudit;
+}
+interface ProjectPolicyGatesSummary {
+    advisory: number;
+    requiredAction: number;
+    block: number;
+    strongestSeverity: ProjectPolicyGateSeverity;
+    affectedSurfaces: ProjectPolicyGateSurface[];
+}
+interface ProjectPolicyGatesResult {
+    version: "project-intelligence.policy-gates.v1";
+    generatedAt: string;
+    registryVersion: "project-intelligence.policy-gates.registry.v1";
+    release: boolean;
+    summary: ProjectPolicyGatesSummary;
+    gates: ProjectPolicyGateDecision[];
+    suggestedCommands: string[];
+}
+interface EvaluateProjectPolicyGatesInput {
+    task?: string;
+    release?: boolean;
+    changedFiles?: string[];
+    diffSummary?: string;
+    skipGuard?: boolean;
+    skipPackageReview?: boolean;
+    guard?: {
+        status?: number | null;
+        payload?: Record<string, unknown>;
+        error?: string;
+        stderr?: string;
+    };
+    packageReview?: {
+        status?: string;
+        error?: string;
+        command?: string;
+    };
+    judgmentCard?: ProjectIntelligenceJudgmentCard;
+}
+declare function evaluateProjectPolicyGates(input: EvaluateProjectPolicyGatesInput): ProjectPolicyGatesResult;
+declare function formatPolicyGateDecision(gateDecision: ProjectPolicyGateDecision): string[];
+
 interface ProjectRunCommandOptions {
     task?: string;
     branch?: string;
@@ -2004,6 +2108,8 @@ interface ProjectRunCommandOptions {
     skipMemoryHealth?: boolean;
     skipGuard?: boolean;
     skipPackageReview?: boolean;
+    servedJudgmentId?: string;
+    skipAdvisorReceipts?: boolean;
     json?: boolean;
 }
 interface ProjectRunGuardResult {
@@ -2021,6 +2127,20 @@ interface ProjectRunPackageReview {
     data?: unknown;
     error?: string;
 }
+interface ProjectRunAdvisorReceiptWrite {
+    advisorRecommendationId: string;
+    status: "recorded" | "error";
+    result?: RecordAdvisorInfluenceReceiptResult;
+    error?: string;
+}
+interface ProjectRunAdvisorReceiptCapture {
+    status: "skipped" | "recorded" | "partial" | "error";
+    servedJudgmentId?: string;
+    attemptedCount: number;
+    recordedCount: number;
+    writes: ProjectRunAdvisorReceiptWrite[];
+    reason?: string;
+}
 interface ProjectIntelligenceRunResult {
     version: "project-intelligence.production-run.v1";
     generatedAt: string;
@@ -2028,6 +2148,8 @@ interface ProjectIntelligenceRunResult {
     brief: ProjectIntelligenceBrief;
     guard?: ProjectRunGuardResult;
     packageReview?: ProjectRunPackageReview;
+    policyGates: ProjectPolicyGatesResult;
+    advisorReceiptCapture?: ProjectRunAdvisorReceiptCapture;
     judgmentCard: ProjectIntelligenceJudgmentCard;
     suggestedCommands: string[];
 }
@@ -3162,4 +3284,4 @@ declare function buildOrchestratorHandoff(options: OrchestratorHandoffOptions):
 declare function buildAdaptiveWorkRoutingRecommendation(options: AdaptiveWorkRoutingOptions): AdaptiveWorkRoutingRecommendation;
 declare function writeOrchestratorHandoff(options: OrchestratorHandoffOptions): WrittenOrchestratorHandoff;
 
-export { AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, COLLABORATION_STATE_RELATIVE_PATH, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, TEAM_SYNC_STATE_RELATIVE_PATH, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildContextPackStats, buildEvalCaseArtifact, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalShortestPathResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapQuality, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWorkflowImpactGate, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, cleanContextPacks, collaborationIdeStatusCommand, collectSyncDocuments, collectSyncDocumentsInput, compactHostedGuardResources, completeTeamSyncStateFromEvidence, completeTeamSyncWorkFromEvidence, contextPackCleanCommand, contextPackPackCommand, contextPackRetrieveCommand, contextPackStatsCommand, createClient, createEmptyCollaborationState, createEmptyTeamSyncState, createLocalQueryCache, deriveLocalCollaborationResourcesFromFiles, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, evalExportCommand, evalRunCommand, extractCommandFromToolInput, extractFilesFromToolInput, formatOrchestratorRecommendationReason, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, ingestReferences, installAutomationBundle, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readLocalCodeOverlayCache, readLocalCodePromotionState, referencesIngestCommand, referencesScanCommand, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeOrchestratorHandoff };
+export { AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, COLLABORATION_STATE_RELATIVE_PATH, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, TEAM_SYNC_STATE_RELATIVE_PATH, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildContextPackStats, buildEvalCaseArtifact, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalShortestPathResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapQuality, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWorkflowImpactGate, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, cleanContextPacks, collaborationIdeStatusCommand, collectSyncDocuments, collectSyncDocumentsInput, compactHostedGuardResources, completeTeamSyncStateFromEvidence, completeTeamSyncWorkFromEvidence, contextPackCleanCommand, contextPackPackCommand, contextPackRetrieveCommand, contextPackStatsCommand, createClient, createEmptyCollaborationState, createEmptyTeamSyncState, createLocalQueryCache, deriveLocalCollaborationResourcesFromFiles, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, formatOrchestratorRecommendationReason, formatPolicyGateDecision, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, ingestReferences, installAutomationBundle, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readLocalCodeOverlayCache, readLocalCodePromotionState, referencesIngestCommand, referencesScanCommand, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeOrchestratorHandoff };