snipara-companion 3.0.5 → 3.0.7

package/README.md

@@ -43,10 +43,12 @@ These commands are useful without hosted Snipara:
 | ------------------------------------------------------------ | ------------------------------------------------------------ |
 | `source init` / `source sync` / `source status`              | Local source snapshot, document preview, and code overlay    |
 | `impact` / `code impact`                                     | File-level blast-radius from the local code overlay          |
+| `reality-check`                                              | Intent/verification checks for local or supplied changes     |
 | `code callers` / `imports` / `neighbors` / `shortest-path`   | Structural repo questions from local files                   |
 | `workflow start` / `phase-start` / `phase-commit` / `resume` | Agent continuity that survives compaction                    |
 | `context-pack`                                               | Reversible local packs for long logs, diffs, and tool output |
 | `judgment-card`, `verify`, `lead-plan`, `agent-readiness`    | Local review artifacts and delegation contracts              |
+| `intelligence ledger-export`                                 | Structured redacted ledger JSON for replay and review        |
 | `stuck-guard`, `memory-guard`, `pre-tool`, `post-tool`       | Fail-soft local guards and hook helpers                      |
 
 ## Agent Continuity

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { ProjectIntelligenceEngineeringLeadPlanSummary } from '@snipara/project-intelligence-contracts';
+import { ProjectRealityCheckResult, ProjectIntelligenceEngineeringLeadPlanSummary } from '@snipara/project-intelligence-contracts';
 
 declare function resolveQueryFromToolInput(toolInput?: string, tool?: string): string | null;
 
@@ -1946,6 +1946,23 @@ interface ProjectIntelligenceBrief {
 declare function buildProjectIntelligenceBrief(options: ProjectIntelligenceBriefOptions): Promise<ProjectIntelligenceBrief>;
 declare function projectIntelligenceBriefCommand(options: ProjectIntelligenceBriefOptions): Promise<void>;
 
+interface RealityCheckCommandOptions {
+    task?: string;
+    branch?: string;
+    base?: string;
+    changedFiles?: string[];
+    diffSummary?: string;
+    decision?: string[];
+    document?: string[];
+    verification?: string[];
+    includeDirty?: boolean;
+    enforce?: boolean;
+    dir?: string;
+    json?: boolean;
+}
+declare function buildLocalProjectRealityCheck(options: RealityCheckCommandOptions): ProjectRealityCheckResult;
+declare function realityCheckCommand(options: RealityCheckCommandOptions): Promise<void>;
+
 interface MemoryHealthCommandOptions {
     scope?: MemoryScope;
     includeInactive?: boolean;
@@ -2366,6 +2383,195 @@ interface ProjectIntelligenceRunResult {
 declare function buildProjectIntelligenceRun(options: ProjectRunCommandOptions): Promise<ProjectIntelligenceRunResult>;
 declare function projectIntelligenceRunCommand(options: ProjectRunCommandOptions): Promise<void>;
 
+declare const WHY_OUTCOME_CAPTURE_VERSION: "snipara.why_outcome_capture.v1";
+type WhyOutcomeCaptureEventKind = "commit" | "pull_request" | "phase_commit" | "handoff" | "final_commit" | "guard_decision" | "test_result" | "deploy_health" | "review_result" | "feedback";
+type WhyOutcomeCandidateKind = "decision" | "outcome";
+type WhyOutcomeCandidateOutcomeStatus = "positive" | "negative" | "blocked" | "neutral" | "unknown";
+interface WhyOutcomeCaptureEvent {
+    kind?: WhyOutcomeCaptureEventKind | string;
+    event?: WhyOutcomeCaptureEventKind | string;
+    summary?: string;
+    reason?: string | string[];
+    outcome?: string;
+    status?: string;
+    feedback?: string;
+    sourceRef?: string;
+    actor?: string;
+    files?: string[];
+    evidence?: string[];
+    commands?: string[];
+    reviewResult?: string;
+    observedAt?: string;
+    metadata?: Record<string, unknown>;
+}
+interface WhyOutcomeCaptureCandidate {
+    id: string;
+    kind: WhyOutcomeCandidateKind;
+    reviewStatus: "review_pending";
+    authorityStatus: "candidate";
+    content: string;
+    confidence: number;
+    source: {
+        kind: WhyOutcomeCaptureEventKind;
+        ref: string | null;
+        actor: string | null;
+        observedAt: string;
+    };
+    outcome?: {
+        status: WhyOutcomeCandidateOutcomeStatus;
+        label: string;
+    };
+    provenance: {
+        files: string[];
+        evidence: string[];
+        commands: string[];
+        reasonCodes: string[];
+        dedupeKey: string;
+    };
+    redaction: {
+        redacted: boolean;
+        patterns: string[];
+    };
+}
+interface WhyOutcomeCaptureReport {
+    version: typeof WHY_OUTCOME_CAPTURE_VERSION;
+    generatedAt: string;
+    reviewStatus: "review_pending";
+    eventCount: number;
+    candidateCount: number;
+    skippedDuplicateCount: number;
+    candidates: WhyOutcomeCaptureCandidate[];
+    caveats: string[];
+}
+interface WhyOutcomeCaptureOptions {
+    events: WhyOutcomeCaptureEvent[];
+    now?: Date;
+    maxCandidates?: number;
+}
+interface OutcomeCapturePreviewCommandOptions {
+    fromFile?: string;
+    event?: string;
+    summary?: string;
+    outcome?: string;
+    status?: string;
+    sourceRef?: string;
+    actor?: string;
+    files?: string[];
+    evidence?: string[];
+    command?: string[];
+    reason?: string[];
+    feedback?: string;
+    maxCandidates?: string;
+    json?: boolean;
+}
+declare function buildWhyOutcomeCaptureReport(options: WhyOutcomeCaptureOptions): WhyOutcomeCaptureReport;
+declare function outcomeCapturePreviewCommand(options: OutcomeCapturePreviewCommandOptions): Promise<void>;
+
+declare const CODING_INTELLIGENCE_LEDGER_VERSION: "snipara.coding_intelligence_ledger.v0";
+type CodingLedgerSectionName = "served_context" | "plans" | "diffs" | "tests" | "ci" | "reviews" | "outcomes" | "influence_receipts";
+type CodingLedgerConfidenceBand = "high" | "medium" | "low" | "unknown";
+interface CodingLedgerEvidenceItem {
+    id: string;
+    kind: CodingLedgerSectionName;
+    title?: string;
+    summary: string;
+    sourceRef?: string;
+    status?: string;
+    confidence?: number;
+    reasonCodes: string[];
+    files: string[];
+    commands: string[];
+    observedAt?: string;
+}
+interface CodingLedgerPrompt {
+    task?: string;
+    prompt?: string;
+    sourceRef?: string;
+}
+interface CodingLedgerRepoState {
+    branch?: string;
+    commit?: string;
+    dirty?: boolean;
+    stagedFileCount?: number;
+    unstagedFileCount?: number;
+    changedFiles: string[];
+    recentFiles: string[];
+    diffSummary?: string;
+}
+interface CodingLedgerConfidence {
+    score?: number;
+    band: CodingLedgerConfidenceBand;
+    rationale?: string;
+}
+interface CodingLedgerCalibrationMetadata {
+    sampleSize?: number;
+    reliability?: number;
+    status?: string;
+    notes: string[];
+    caveats: string[];
+}
+interface CodingLedgerRedactionSummary {
+    redacted: boolean;
+    redactedValueCount: number;
+    patterns: string[];
+}
+interface CodingIntelligenceLedger {
+    version: typeof CODING_INTELLIGENCE_LEDGER_VERSION;
+    generatedAt: string;
+    portability: {
+        format: "json";
+        schema: typeof CODING_INTELLIGENCE_LEDGER_VERSION;
+        generatedBy: "snipara-companion";
+        contentModel: "structured_redacted_ledger";
+    };
+    prompt: CodingLedgerPrompt;
+    repoState: CodingLedgerRepoState;
+    servedContext: CodingLedgerEvidenceItem[];
+    plans: CodingLedgerEvidenceItem[];
+    diffs: CodingLedgerEvidenceItem[];
+    tests: CodingLedgerEvidenceItem[];
+    ci: CodingLedgerEvidenceItem[];
+    reviews: CodingLedgerEvidenceItem[];
+    outcomes: CodingLedgerEvidenceItem[];
+    influenceReceipts: CodingLedgerEvidenceItem[];
+    reasonCodes: string[];
+    confidence: CodingLedgerConfidence;
+    calibrationMetadata: CodingLedgerCalibrationMetadata;
+    redaction: CodingLedgerRedactionSummary;
+    caveats: string[];
+}
+interface CodingLedgerBuildOptions {
+    input?: unknown;
+    fromFile?: string;
+    dir?: string;
+    now?: Date;
+    task?: string;
+    prompt?: string;
+    sourceRef?: string;
+    branch?: string;
+    commit?: string;
+    changedFiles?: string[];
+    recentFiles?: string[];
+    diffSummary?: string;
+    servedContext?: string[];
+    plan?: string[];
+    diff?: string[];
+    test?: string[];
+    ci?: string[];
+    review?: string[];
+    outcome?: string[];
+    influenceReceipt?: string[];
+    reasonCode?: string[];
+    confidence?: string;
+    calibration?: string[];
+}
+interface CodingLedgerExportCommandOptions extends CodingLedgerBuildOptions {
+    output?: string;
+    json?: boolean;
+}
+declare function buildCodingIntelligenceLedger(options?: CodingLedgerBuildOptions): CodingIntelligenceLedger;
+declare function codingLedgerExportCommand(options: CodingLedgerExportCommandOptions): Promise<void>;
+
 declare const TEAM_SYNC_STATE_RELATIVE_PATH: string;
 type TeamSyncAttention = "note" | "watch" | "review" | "proof";
 type TeamSyncWorkStatus = "active" | "completed" | "archived";
@@ -2497,7 +2703,9 @@ interface AgenticHandoffAdapterPack {
     target: {
         id: AgenticHandoffAdapterTarget;
         label: string;
+        profile: string;
         instruction: string;
+        runtimeControl: "handoff_only";
     };
     contextPack: {
         summary: string;
@@ -3744,4 +3952,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, ENGINEERING_LEAD_EXECUTION_RECEIPT_STAGES, ENGINEERING_LEAD_EXECUTION_RECEIPT_STATUSES, ENGINEERING_LEAD_POSTURES, ENGINEERING_LEAD_PROOF_VERIFICATION_SOURCES, ENGINEERING_LEAD_PROOF_VERIFICATION_STATUSES, ENGINEERING_LEAD_ROUTING_MODES, ENGINEERING_LEAD_STATUSES, ENGINEERING_LEAD_SUPERVISION_STATUSES, ENGINEERING_LEAD_WORKER_ROLES, ENGINEERING_LEAD_WORK_PACKAGE_STATUSES, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, TEAM_SYNC_STATE_RELATIVE_PATH, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, addLocalWorker, agentReadinessAuditCommand, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildEvalCaseArtifact, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalShortestPathResult, buildLocalSourceSnapshot, buildLocalSourceStatus, buildLocalSourceSyncResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapQuality, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWorkflowImpactGate, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, cleanContextPacks, collaborationIdeStatusCommand, collectAgentReadinessLocalSignals, collectSyncDocuments, collectSyncDocumentsInput, compactHostedGuardResources, compareLocalSourceSnapshots, completeTeamSyncStateFromEvidence, completeTeamSyncWorkFromEvidence, contextPackCleanCommand, contextPackPackCommand, contextPackRetrieveCommand, contextPackStatsCommand, createClient, createEmptyCollaborationState, createEmptyTeamSyncState, createLocalQueryCache, deriveLocalCollaborationResourcesFromFiles, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, formatAgentReadinessAuditReport, formatCompanionEngineeringLeadPlanReport, formatOrchestratorRecommendationReason, formatPolicyGateDecision, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getLocalSourceSnapshotPath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, ingestReferences, installAutomationBundle, leadPlanCommand, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readLocalCodeOverlayCache, readLocalCodePromotionState, readLocalSourceSnapshot, readLocalWorkersConfig, referencesIngestCommand, referencesScanCommand, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveLocalWorkerRoutingDefaults, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, workersLocalAddCommand, workersLocalStatusCommand, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeLocalSourceSnapshot, writeOrchestratorHandoff };
+export { AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, CODING_INTELLIGENCE_LEDGER_VERSION, COLLABORATION_STATE_RELATIVE_PATH, ENGINEERING_LEAD_EXECUTION_RECEIPT_STAGES, ENGINEERING_LEAD_EXECUTION_RECEIPT_STATUSES, ENGINEERING_LEAD_POSTURES, ENGINEERING_LEAD_PROOF_VERIFICATION_SOURCES, ENGINEERING_LEAD_PROOF_VERIFICATION_STATUSES, ENGINEERING_LEAD_ROUTING_MODES, ENGINEERING_LEAD_STATUSES, ENGINEERING_LEAD_SUPERVISION_STATUSES, ENGINEERING_LEAD_WORKER_ROLES, ENGINEERING_LEAD_WORK_PACKAGE_STATUSES, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, TEAM_SYNC_STATE_RELATIVE_PATH, WHY_OUTCOME_CAPTURE_VERSION, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, addLocalWorker, agentReadinessAuditCommand, archiveInactiveTeamSyncWork, attachLocalContextPackReceipts, autoArchiveTeamSyncState, buildAdaptiveWorkRoutingRecommendation, buildAgentReadinessAuditReport, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildCodingIntelligenceLedger, buildCollaborationActor, buildCollaborationGuardActionCards, buildCollaborationHooksInstallPlan, buildCompanionEngineeringLeadPlanReport, buildContextPackStats, buildEvalCaseArtifact, buildGeneratedWorkflowPlanDocument, buildHostedCodeOverlayUploadPayload, buildHostedGuardPayload, buildJournalCheckpointEntry, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalContextPackReceipt, buildLocalContextPackReceipts, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalProjectRealityCheck, buildLocalShortestPathResult, buildLocalSourceSnapshot, buildLocalSourceStatus, buildLocalSourceSyncResult, buildMemoryAudit, buildOnboardFolderManifest, buildOrchestratorHandoff, buildProjectIntelligenceBrief, buildProjectIntelligenceRun, buildProjectJudgmentCard, buildSessionBootstrapQuality, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWhyOutcomeCaptureReport, buildWorkflowImpactGate, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, cleanContextPacks, codingLedgerExportCommand, collaborationIdeStatusCommand, collectAgentReadinessLocalSignals, collectSyncDocuments, collectSyncDocumentsInput, compactHostedGuardResources, compareLocalSourceSnapshots, completeTeamSyncStateFromEvidence, completeTeamSyncWorkFromEvidence, contextPackCleanCommand, contextPackPackCommand, contextPackRetrieveCommand, contextPackStatsCommand, createClient, createEmptyCollaborationState, createEmptyTeamSyncState, createLocalQueryCache, deriveLocalCollaborationResourcesFromFiles, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, evalExportCommand, evalRunCommand, evaluateProjectPolicyGates, extractCommandFromToolInput, extractFilesFromToolInput, formatAgentReadinessAuditReport, formatCompanionEngineeringLeadPlanReport, formatOrchestratorRecommendationReason, formatPolicyGateDecision, formatProjectJudgmentCard, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getCollaborationStatePath, getConfigPath, getContextPackStoragePaths, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getLocalSourceSnapshotPath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, ingestReferences, installAutomationBundle, leadPlanCommand, listProjectsForApiKey, loadAutomationManifest, loadCollaborationState, loadConfig, loadTeamSyncState, memoryAuditCommand, memoryCleanCandidatesCommand, memoryCompactCommand, memoryHealthCommand, memoryLocalCommand, normalizeCollaborationFiles, normalizeGuardTag, normalizeWorkflowPlanInput, outcomeCapturePreviewCommand, packContext, parseCollaborationResources, projectIntelligenceBriefCommand, projectIntelligenceRunCommand, readLocalCodeOverlayCache, readLocalCodePromotionState, readLocalSourceSnapshot, readLocalWorkersConfig, realityCheckCommand, referencesIngestCommand, referencesScanCommand, resolveContextPackRecord, resolveFullWorkflowTokenBudget, resolveLocalWorkerRoutingDefaults, resolveQueryFromToolInput, retrieveContextPack, runMemoryGuardCheck, saveCollaborationState, saveConfig, saveTeamSyncState, scanReferences, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, validatePlanResult, verifyCommand, workersLocalAddCommand, workersLocalStatusCommand, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeLocalSourceSnapshot, writeOrchestratorHandoff };