snipara-companion 1.3.3 → 1.3.4

package/dist/index.d.ts

@@ -1213,6 +1213,13 @@ 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;
@@ -1280,6 +1287,17 @@ interface LocalCodeOverlaySummary {
     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;
@@ -1290,6 +1308,7 @@ declare function writeLocalCodePromotionState(state: LocalCodePromotionState): s
 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>;
@@ -1975,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, buildCodeHooksInstallPlan, buildCodePromotionResult, buildCodeStatusResult, buildCodeSyncResult, 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 };
+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 };

package/dist/index.js

@@ -49,6 +49,7 @@ __export(index_exports, {
   buildCodePromotionResult: () => buildCodePromotionResult,
   buildCodeStatusResult: () => buildCodeStatusResult,
   buildCodeSyncResult: () => buildCodeSyncResult,
+  buildHostedCodeOverlayUploadPayload: () => buildHostedCodeOverlayUploadPayload,
   buildJournalCheckpointEntry: () => buildJournalCheckpointEntry,
   buildLocalCallersResult: () => buildLocalCallersResult,
   buildLocalCodeOverlay: () => buildLocalCodeOverlay,
@@ -6164,6 +6165,7 @@ var SUPPORTED_EXTENSIONS = /* @__PURE__ */ new Map([
 ]);
 var DEFAULT_MAX_FILES = 2e3;
 var DEFAULT_MAX_FILE_BYTES = 1024 * 1024;
+var DEFAULT_HOSTED_OVERLAY_TTL_HOURS = 48;
 var CACHE_RELATIVE_PATH = import_path.default.join(".snipara", "code-overlay", "latest.json");
 var PROMOTION_RELATIVE_PATH = import_path.default.join(".snipara", "code-overlay", "promotion.json");
 var HOOK_BLOCK_PREFIX = "snipara:code-overlay";
@@ -6768,6 +6770,31 @@ function buildCodeSyncResult(options) {
   const cachePath = writeLocalCodeOverlayCache(manifest);
   return options.includeGraph ? { ...manifest, cachePath } : { ...summarizeLocalCodeOverlay(manifest), cachePath };
 }
+function buildHostedCodeOverlayUploadPayload(options = {}) {
+  const repoRoot = resolveRepoRoot(options.dir ?? process.cwd());
+  const cached = options.cached ? readLocalCodeOverlayCache(repoRoot) : null;
+  if (options.cached && !cached) {
+    throw new Error("No cached local code overlay found. Run `snipara-companion code sync` first.");
+  }
+  const manifest = cached ?? buildLocalCodeOverlay({
+    cwd: repoRoot,
+    mode: "working_tree",
+    maxFiles: options.maxFiles
+  });
+  const cachePath = writeLocalCodeOverlayCache(manifest);
+  const ttlHours = positiveInteger(options.ttlHours, DEFAULT_HOSTED_OVERLAY_TTL_HOURS);
+  return {
+    manifest,
+    cachePath,
+    request: {
+      overlay: manifest,
+      source_client: options.sourceClient ?? "snipara-companion",
+      ttl_hours: ttlHours,
+      retire_previous: options.retirePrevious !== false,
+      ...options.sessionId ? { session_id: options.sessionId } : {}
+    }
+  };
+}
 function buildLocalImportsResult(options) {
   const manifest = loadQueryManifest(options);
   const symbol = findSymbol(manifest, options);
@@ -6936,6 +6963,23 @@ async function codeSyncCommand(options) {
   const cachePath = writeLocalCodeOverlayCache(manifest);
   printManifestSummary(manifest, cachePath);
 }
+async function codeUploadCommand(options) {
+  const payload = buildHostedCodeOverlayUploadPayload(options);
+  const result = await createClient(3e4, { cwd: payload.manifest.repoRoot }).callTool("snipara_local_code_overlay_upload", payload.request);
+  const output = { ...result, cachePath: payload.cachePath };
+  if (options.json) {
+    console.log(JSON.stringify(output, null, 2));
+    return;
+  }
+  console.log(import_chalk3.default.bold("Hosted Local Code Overlay"));
+  const overlay = result.overlay ?? {};
+  console.log(`Overlay: ${String(overlay.id ?? "uploaded")}`);
+  console.log(`Repo: ${payload.manifest.repositoryId}`);
+  console.log(`Branch: ${payload.manifest.branch ?? "unknown"}`);
+  console.log(`Expires: ${String(result.expires_at ?? "unknown")}`);
+  console.log(`Cache: ${payload.cachePath}`);
+  console.log("Canonical graph: unchanged until hosted code reindex completes.");
+}
 function hookBlockMarker(hookName, type) {
   return `# ${HOOK_BLOCK_PREFIX} ${hookName}:${type}`;
 }
@@ -15023,6 +15067,19 @@ code.addCommand(
       json: options.json
     });
   })
+).addCommand(
+  new import_commander.Command("upload").description("Upload the non-canonical local code overlay through Hosted MCP").option("-d, --dir <directory>", "Repository directory (default: current)").option("--cached", "Upload the cached overlay instead of rebuilding from the working tree").option("--ttl-hours <number>", "Hosted overlay TTL in hours", "48").option("--source-client <name>", "Source client label", "snipara-companion").option("--session-id <id>", "Optional agent/session identifier").option("--no-retire-previous", "Keep older active overlays for the same repository/branch").option("--max-files <number>", "Maximum supported code files to inspect", "2000").option("--json", "Print raw JSON").action(async (options) => {
+    await codeUploadCommand({
+      dir: options.dir,
+      cached: Boolean(options.cached),
+      ttlHours: parseInt(options.ttlHours, 10),
+      sourceClient: options.sourceClient,
+      sessionId: options.sessionId,
+      retirePrevious: options.retirePrevious !== false,
+      maxFiles: parseInt(options.maxFiles, 10),
+      json: options.json
+    });
+  })
 ).addCommand(
   new import_commander.Command("hooks").description(
     "Install Git hooks that keep local code overlays fresh before hosted push/index catches up"
@@ -15342,6 +15399,7 @@ if (require.main === module) {
   buildCodePromotionResult,
   buildCodeStatusResult,
   buildCodeSyncResult,
+  buildHostedCodeOverlayUploadPayload,
   buildJournalCheckpointEntry,
   buildLocalCallersResult,
   buildLocalCodeOverlay,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "snipara-companion",
-  "version": "1.3.3",
+  "version": "1.3.4",
   "description": "Snipara Git-style companion CLI for hosted context, agent continuity, hooks, and automation workflows",
   "main": "dist/index.js",
   "bin": {