snipara-companion 1.3.2 → 1.3.4

package/dist/index.d.ts

@@ -1140,6 +1140,183 @@ interface BuildVerificationPlanOptions extends VerifyCommandOptions {
 declare function buildVerificationPlan(options: BuildVerificationPlanOptions): VerificationPlan;
 declare function verifyCommand(options: VerifyCommandOptions): Promise<void>;
 
+type LocalCodeOverlayMode = "working_tree" | "local_commit";
+type LocalCodeOverlayKind = "none" | "local_commit" | "working_tree" | "mixed";
+interface LocalCodeOverlayOptions {
+    cwd?: string;
+    mode?: LocalCodeOverlayMode;
+    commit?: string;
+    maxFiles?: number;
+    maxFileBytes?: number;
+}
+interface LocalCodeOverlayFile {
+    path: string;
+    language: "typescript" | "python" | "go";
+    sizeBytes: number;
+    sha256: string;
+    symbolCount: number;
+    importCount: number;
+}
+interface LocalCodeOverlaySymbol {
+    name: string;
+    kind: "function" | "class" | "interface" | "type" | "variable" | "method";
+    filePath: string;
+    line: number;
+    localKey: string;
+}
+interface LocalCodeOverlayImport {
+    filePath: string;
+    specifier: string;
+    line: number;
+}
+interface LocalCodeOverlayExcludedFile {
+    path: string;
+    reason: "ignored" | "unsupported_language" | "too_large" | "secret_pattern" | "read_error";
+}
+interface LocalCodeOverlayManifest {
+    version: "snipara.local_code_overlay.v1";
+    generatedAt: string;
+    indexedAt: string;
+    repoRoot: string;
+    repositoryId: string;
+    branch: string | null;
+    baseSha: string | null;
+    localHeadSha: string | null;
+    commit: string | null;
+    dirtyTreeHash: string | null;
+    overlayKind: LocalCodeOverlayKind;
+    canonicalIndexedSha: null;
+    currentWorkingTreeVisible: boolean;
+    canonical: false;
+    mode: LocalCodeOverlayMode;
+    files: LocalCodeOverlayFile[];
+    symbols: LocalCodeOverlaySymbol[];
+    imports: LocalCodeOverlayImport[];
+    excluded: {
+        total: number;
+        byReason: Record<LocalCodeOverlayExcludedFile["reason"], number>;
+        samples: LocalCodeOverlayExcludedFile[];
+    };
+    warnings: Array<{
+        code: string;
+        severity: "info" | "warning";
+        message: string;
+    }>;
+}
+interface CodeStatusCommandOptions {
+    dir?: string;
+    maxFiles?: number;
+    includeGraph?: boolean;
+    json?: boolean;
+}
+interface CodeSyncCommandOptions extends CodeStatusCommandOptions {
+    commit?: string;
+    workingTree?: boolean;
+}
+interface CodeUploadCommandOptions extends CodeStatusCommandOptions {
+    cached?: boolean;
+    ttlHours?: number;
+    sourceClient?: string;
+    sessionId?: string;
+    retirePrevious?: boolean;
+}
+interface LocalCodeQueryCommandOptions extends CodeStatusCommandOptions {
+    cached?: boolean;
+    qualifiedName?: string;
+    symbolKey?: string;
+    filePath?: string;
+    changedFiles?: string[];
+    from?: string;
+    to?: string;
+    maxHops?: number;
+}
+interface CodeHooksInstallCommandOptions {
+    dir?: string;
+    maxFiles?: number;
+    requestReindex?: boolean;
+    dryRun?: boolean;
+    json?: boolean;
+}
+interface CodePromoteCommandOptions extends CodeStatusCommandOptions {
+    pushedSha?: string;
+    indexedSha?: string;
+    requestReindex?: boolean;
+    fromHook?: "pre-push";
+    strict?: boolean;
+}
+interface LocalCodePromotionState {
+    version: "snipara.local_code_promotion.v1";
+    updatedAt: string;
+    repoRoot: string;
+    repositoryId: string;
+    branch: string | null;
+    pushedSha: string | null;
+    localHeadSha: string | null;
+    indexedSha: string | null;
+    overlayCachePath: string;
+    status: "local_commit_cached" | "reindex_requested" | "reindex_skipped_unconfigured" | "reindex_failed" | "superseded_by_hosted_index";
+    canonical: false;
+    hostedCanonicalVisible: boolean;
+    reindexRequestedAt: string | null;
+    reindexResult?: Record<string, unknown>;
+    warnings: LocalCodeOverlayManifest["warnings"];
+}
+interface LocalCodeOverlaySummary {
+    version: LocalCodeOverlayManifest["version"];
+    generatedAt: string;
+    indexedAt: string;
+    repoRoot: string;
+    repositoryId: string;
+    branch: string | null;
+    baseSha: string | null;
+    localHeadSha: string | null;
+    commit: string | null;
+    dirtyTreeHash: string | null;
+    overlayKind: LocalCodeOverlayKind;
+    canonicalIndexedSha: null;
+    currentWorkingTreeVisible: boolean;
+    canonical: false;
+    mode: LocalCodeOverlayMode;
+    counts: {
+        files: number;
+        symbols: number;
+        imports: number;
+        excluded: number;
+    };
+    excludedByReason: Record<LocalCodeOverlayExcludedFile["reason"], number>;
+    fileSamples: string[];
+    warnings: LocalCodeOverlayManifest["warnings"];
+}
+interface HostedCodeOverlayUploadPayload {
+    manifest: LocalCodeOverlayManifest;
+    cachePath: string;
+    request: {
+        overlay: LocalCodeOverlayManifest;
+        source_client: string;
+        ttl_hours: number;
+        retire_previous: boolean;
+        session_id?: string;
+    };
+}
+declare function getLocalCodeOverlayCachePath(cwd?: string): string;
+declare function getLocalCodePromotionStatePath(cwd?: string): string;
+declare function buildLocalCodeOverlay(options?: LocalCodeOverlayOptions): LocalCodeOverlayManifest;
+declare function summarizeLocalCodeOverlay(manifest: LocalCodeOverlayManifest): LocalCodeOverlaySummary;
+declare function writeLocalCodeOverlayCache(manifest: LocalCodeOverlayManifest): string;
+declare function readLocalCodeOverlayCache(cwd?: string): LocalCodeOverlayManifest | null;
+declare function writeLocalCodePromotionState(state: LocalCodePromotionState): string;
+declare function readLocalCodePromotionState(cwd?: string): LocalCodePromotionState | null;
+declare function buildCodeStatusResult(options: CodeStatusCommandOptions): Record<string, unknown>;
+declare function buildCodeSyncResult(options: CodeSyncCommandOptions): Record<string, unknown>;
+declare function buildHostedCodeOverlayUploadPayload(options?: CodeUploadCommandOptions): HostedCodeOverlayUploadPayload;
+declare function buildLocalImportsResult(options: LocalCodeQueryCommandOptions): Record<string, unknown>;
+declare function buildLocalCallersResult(options: LocalCodeQueryCommandOptions): Record<string, unknown>;
+declare function buildLocalNeighborsResult(options: LocalCodeQueryCommandOptions): Record<string, unknown>;
+declare function buildLocalShortestPathResult(options: LocalCodeQueryCommandOptions): Record<string, unknown>;
+declare function buildLocalImpactResult(options: LocalCodeQueryCommandOptions): Record<string, unknown>;
+declare function buildCodeHooksInstallPlan(options?: CodeHooksInstallCommandOptions): Record<string, unknown>;
+declare function buildCodePromotionResult(options?: CodePromoteCommandOptions): Promise<Record<string, unknown>>;
+
 type SyncDocumentKind = "DOC" | "BINARY";
 type WorkflowMode = "lite" | "standard" | "auto" | "full" | "orchestrate";
 type OnboardFolderMode = "auto" | "business_context" | "code_project" | "mixed";
@@ -1817,4 +1994,4 @@ interface WrittenOrchestratorHandoff {
 declare function buildOrchestratorHandoff(options: OrchestratorHandoffOptions): OrchestratorHandoffArtifact;
 declare function writeOrchestratorHandoff(options: OrchestratorHandoffOptions): WrittenOrchestratorHandoff;
 
-export { AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, TEAM_SYNC_STATE_RELATIVE_PATH, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, archiveInactiveTeamSyncWork, autoArchiveTeamSyncState, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildJournalCheckpointEntry, buildOnboardFolderManifest, buildOrchestratorHandoff, buildProjectIntelligenceBrief, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, collectSyncDocuments, collectSyncDocumentsInput, createClient, createEmptyTeamSyncState, createLocalQueryCache, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, extractCommandFromToolInput, extractFilesFromToolInput, formatOrchestratorRecommendationReason, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getConfigPath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, installAutomationBundle, listProjectsForApiKey, loadAutomationManifest, loadConfig, loadTeamSyncState, normalizeGuardTag, normalizeWorkflowPlanInput, projectIntelligenceBriefCommand, resolveQueryFromToolInput, runMemoryGuardCheck, saveConfig, saveTeamSyncState, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, teamSyncSweepCommand, verifyCommand, writeOrchestratorHandoff };
+export { AUTOMATION_MANIFEST_RELATIVE_PATH, AutomationInstallConflictError, AutomationUnsupportedHookBundleError, ORCHESTRATOR_HANDOFF_RELATIVE_PATH, TEAM_SYNC_STATE_RELATIVE_PATH, WORKFLOW_PLANS_RELATIVE_DIR, WORKFLOW_STATE_RELATIVE_PATH, archiveInactiveTeamSyncWork, autoArchiveTeamSyncState, buildAgenticHandoffMarkdown, buildAgenticTimeline, buildAgenticWorkStatus, buildAutomationInstallPlan, buildCanonicalEvent, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, buildHostedCodeOverlayUploadPayload, buildJournalCheckpointEntry, buildLocalCallersResult, buildLocalCodeOverlay, buildLocalImpactResult, buildLocalImportsResult, buildLocalNeighborsResult, buildLocalShortestPathResult, buildOnboardFolderManifest, buildOrchestratorHandoff, buildProjectIntelligenceBrief, buildSyncDocumentsDryRun, buildTeamSyncHandoffRecord, buildTeamSyncStartWorkRecord, buildTeamSyncSummary, buildToolCallPayload, buildToolResultPayload, buildVerificationPlan, buildWorkflowPhaseCommitSummary, buildWorkflowPlanScaffold, categoryFromGuardTag, classifyToolResult, collectSyncDocuments, collectSyncDocumentsInput, createClient, createEmptyTeamSyncState, createLocalQueryCache, detectReleaseSurfacesFromFiles, detectRuntimeEnvironment, extractCommandFromToolInput, extractFilesFromToolInput, formatOrchestratorRecommendationReason, formatStuckGuardDecision, getAutomationManifestPath, getAutomationStatus, getConfigPath, getLocalCodeOverlayCachePath, getLocalCodePromotionStatePath, getOrchestratorRecommendation, getPlanStepDisplayTitle, getStagedFiles, getStuckGuardInjection, getTeamSyncStatePath, installAutomationBundle, listProjectsForApiKey, loadAutomationManifest, loadConfig, loadTeamSyncState, normalizeGuardTag, normalizeWorkflowPlanInput, projectIntelligenceBriefCommand, readLocalCodeOverlayCache, readLocalCodePromotionState, resolveQueryFromToolInput, runMemoryGuardCheck, saveConfig, saveTeamSyncState, shouldSuggestOrchestratorForWorkflow, shouldSuggestRuntimeForWorkflow, summarizeLocalCodeOverlay, teamSyncSweepCommand, verifyCommand, writeLocalCodeOverlayCache, writeLocalCodePromotionState, writeOrchestratorHandoff };