snipara-companion 3.6.5 → 3.6.6

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 Release notes for `snipara-companion`, newest first.
 
+## New In 3.6.6
+
+- Secures workspace and global companion configuration with owner-only
+  directory/file permissions and automatically ignores the secret-bearing
+  workspace config in Git.
+- Makes initial document indexing an explicit `init` next step and distinguishes
+  a zero-document index from an ordinary query with no relevant matches.
+- Warns once per day when the installed companion is behind npm, while keeping
+  offline and automated runs non-blocking.
+- Enables command suggestions and help recovery for mistyped or undiscovered
+  commands.
+
 ## New In 3.6.5
 
 - Adds a local `agent-context` manifest and resolver for composing shared

package/README.md

@@ -65,6 +65,19 @@ Hosted MCP call and labels supported retrieval traffic as
 `snipara-companion`, unless the caller supplied an explicit client label. This
 improves join coverage without inventing a second server-side identity.
 
+The workspace API key is stored in `.snipara/companion/config.json`. Companion
+keeps that directory and file owner-only on POSIX systems (`0700`/`0600`) and
+adds `/.snipara/companion/` to the workspace `.gitignore`. After initialization,
+index documentation before expecting project-specific query results:
+
+```bash
+npx -y snipara-companion@latest sync-documents --dir ./docs --recursive --reindex
+npx -y snipara-companion@latest doctor
+```
+
+An empty index is reported explicitly as “0 documents indexed” with that
+recovery command; it is not presented as an ordinary no-match.
+
 Example output excerpt:
 
 ```text

package/dist/index.d.ts

@@ -272,6 +272,14 @@ interface ContextQueryResult {
     search_mode?: ContextQuerySearchMode;
     timing?: Record<string, number>;
     retrieval_diagnostics?: Record<string, unknown>;
+    index_state?: {
+        status: "empty" | "ready";
+        indexed_documents: number;
+        files_loaded: number;
+        message?: string;
+        recommended_command?: string;
+        recommended_tool?: string;
+    };
 }
 type ContextQuerySearchMode = "keyword" | "semantic" | "hybrid";
 interface ContextQueryOptions {