docs(positioning): lead with confidential local RAG (#117) (#119)

Author: jb-thery

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -7,7 +7,7 @@ body:
     attributes:
       value: |
         Thanks for taking the time to suggest a feature. Ragmir focuses on
-        sovereign local RAG for confidential datasets and AI agents. Features
+        confidential local RAG for coding agents and private project files. Features
         that add cloud dependencies, telemetry, or hosted services are out of
         scope.
   - type: textarea
@@ -49,7 +49,7 @@ body:
   - type: checkboxes
     id: sovereign
     attributes:
-      label: Sovereignty check
+      label: Local-first privacy check
       description: Confirm this feature is compatible with Ragmir's local-first, zero-telemetry posture.
       options:
         - label: This feature does not require sending documents, queries, or telemetry to a hosted service.

README.md

@@ -6,7 +6,7 @@
 [![Node.js](https://img.shields.io/node/v/@jcode.labs/ragmir)](https://www.npmjs.com/package/@jcode.labs/ragmir)
 [![MIT](https://img.shields.io/github/license/jcode-works/jcode-ragmir)](./LICENSE)
 
-**Local RAG for your coding agents.**
+**Confidential local RAG for your coding agents.**
 
 Ragmir indexes the project files you choose on your machine and retrieves bounded, cited evidence
 offline by default. The corpus and generated index remain local, so confidential source files are
@@ -242,7 +242,7 @@ Installing Core does not install Chat or TTS. Add only the optional package need
 
 | Example | What it proves |
 | --- | --- |
-| [Sovereign RAG demo](./packages/ragmir-core/examples/sovereign-rag-demo/README.md) | End-to-end CLI ingestion, retrieval, redaction, audit, and evaluation |
+| [Confidential local RAG demo](./packages/ragmir-core/examples/sovereign-rag-demo/README.md) | End-to-end CLI ingestion, retrieval, redaction, audit, and evaluation |
 | [Library API demo](./packages/ragmir-core/examples/library-api-demo/README.md) | The public TypeScript API against a synthetic local corpus |
 | [Document evidence benchmark](./packages/ragmir-core/examples/document-evidence-benchmark/README.md) | Deterministic recall and exact file, line, chunk, and PDF-page citations |
 

context7.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://context7.com/schema/context7.json",
   "projectTitle": "Ragmir",
-  "description": "Local RAG for coding agents and scripts, with offline cited retrieval. The TypeScript CLI, library, read-focused MCP server, and portable skills keep the corpus and index under ignored local state. Optional local Chat and TTS remain separate packages.",
+  "description": "Confidential local RAG for coding agents and scripts, with offline cited retrieval. The TypeScript CLI, library, read-focused MCP server, and portable skills keep the corpus and index under ignored local state. Optional local Chat and TTS remain separate packages.",
   "excludeFolders": [
     "node_modules",
     "packages/ragmir-core/dist",

package.json

@@ -2,7 +2,7 @@
   "name": "jcode-ragmir",
   "version": "0.4.12",
   "private": true,
-  "description": "Monorepo for Ragmir, local RAG with offline cited retrieval for coding agents and scripts, plus optional local Chat and TTS.",
+  "description": "Monorepo for Ragmir, confidential local RAG with offline cited retrieval for coding agents and scripts, plus optional local Chat and TTS.",
   "type": "module",
   "license": "MIT",
   "author": "Jean-Baptiste Thery (https://github.com/jb-thery)",
@@ -18,13 +18,14 @@
     "ragmir",
     "rag",
     "local-rag",
-    "sovereign-rag",
+    "confidential-rag",
     "mcp",
     "ai-agents",
     "coding-agents",
     "nodejs",
     "typescript",
-    "private-ai",
+    "offline-first",
+    "cited-retrieval",
     "local-first",
     "knowledge-base"
   ],

packages/ragmir-chat/README.md

@@ -7,10 +7,11 @@
 
 **Optional local answers for your coding-agent RAG workflow.**
 
-Ragmir Core indexes selected project files on your machine and retrieves cited evidence offline by
-default, without uploading the source corpus to a hosted RAG service. `@jcode.labs/ragmir-chat` adds
-an optional answer step on the same machine: it runs a verified local model, limits generation to
-the retrieved passages, and validates the source markers in the visible answer.
+Ragmir Core is a confidential local RAG for coding agents. It indexes selected project files on your
+machine and retrieves cited evidence offline by default, without uploading the source corpus to a
+hosted RAG service. `@jcode.labs/ragmir-chat` adds an optional answer step on the same machine: it
+runs a verified local model, limits generation to the retrieved passages, and validates the source
+markers in the visible answer.
 
 Core does not require Chat or any generative model. Use this package only when the answer itself,
 not just retrieval, must stay on the workstation.

packages/ragmir-chat/package.json

@@ -18,7 +18,9 @@
     "qwen",
     "local-llm",
     "llama-cpp",
-    "private-ai",
+    "confidential-rag",
+    "coding-agents",
+    "cited-retrieval",
     "rag"
   ],
   "repository": {

packages/ragmir-core/README.md

@@ -5,7 +5,7 @@
 [![Node.js](https://img.shields.io/node/v/@jcode.labs/ragmir)](https://www.npmjs.com/package/@jcode.labs/ragmir)
 [![MIT](https://img.shields.io/npm/l/@jcode.labs/ragmir)](https://github.com/jcode-works/jcode-ragmir/blob/main/LICENSE)
 
-**Local RAG for your coding agents.**
+**Confidential local RAG for your coding agents.**
 
 `@jcode.labs/ragmir` indexes the project files you select on your machine and retrieves bounded,
 cited evidence offline by default. The corpus and generated index remain local, so confidential
@@ -213,7 +213,7 @@ before indexing sensitive material.
 
 | Example | Demonstrates |
 | --- | --- |
-| [Sovereign RAG demo](https://github.com/jcode-works/jcode-ragmir/tree/main/packages/ragmir-core/examples/sovereign-rag-demo) | CLI ingestion, search, audit, redaction, and evaluation |
+| [Confidential local RAG demo](https://github.com/jcode-works/jcode-ragmir/tree/main/packages/ragmir-core/examples/sovereign-rag-demo) | CLI ingestion, search, audit, redaction, and evaluation |
 | [Library API demo](https://github.com/jcode-works/jcode-ragmir/tree/main/packages/ragmir-core/examples/library-api-demo) | The public library surface against fictional files |
 | [Document evidence benchmark](https://github.com/jcode-works/jcode-ragmir/tree/main/packages/ragmir-core/examples/document-evidence-benchmark) | Recall and exact citation evaluation |
 

packages/ragmir-core/examples/document-evidence-benchmark/README.md

@@ -1,7 +1,7 @@
 # Document evidence benchmark
 
-A deterministic, public-safe benchmark for the retrieval and citation quality agents receive from
-Ragmir.
+A deterministic, public-safe benchmark for the retrieval and citation quality coding agents receive
+from Ragmir's confidential local RAG pipeline.
 
 Use this example when you want to prove more than "a relevant file appeared." Its six golden queries
 check that Ragmir retrieves the expected path and the exact file, line, chunk, or PDF-page citation.
@@ -89,4 +89,4 @@ under ignored local state.
 - A perfect synthetic score proves this fixture, not universal retrieval quality.
 
 Return to the [Ragmir Core README](../../README.md) or try the
-[sovereign RAG demo](../sovereign-rag-demo/README.md) for a broader CLI walkthrough.
+[confidential local RAG demo](../sovereign-rag-demo/README.md) for a broader CLI walkthrough.

packages/ragmir-core/examples/library-api-demo/README.md

@@ -1,7 +1,7 @@
 # Library API demo
 
-A runnable smoke test for the public `@jcode.labs/ragmir` TypeScript API behind agent and script
-workflows.
+A runnable smoke test for the public `@jcode.labs/ragmir` TypeScript API behind confidential local
+RAG workflows for coding agents and scripts.
 
 Use this example when you are changing Ragmir Core or evaluating it as a library rather than as a
 CLI. It imports the same package name an external consumer uses, runs the full retrieval loop, and
@@ -69,7 +69,7 @@ long-running Node.js process and close it during shutdown. For one-shot scripts,
 
 ## Data used by the demo
 
-The script reuses the sibling [sovereign RAG demo](../sovereign-rag-demo/README.md):
+The script reuses the sibling [confidential local RAG demo](../sovereign-rag-demo/README.md):
 
 - committed synthetic Markdown, CSV, JSONL, YAML, and custom text files;
 - an offline `local-hash` configuration;
@@ -83,7 +83,7 @@ deterministic and public-safe. Use a separate ignored corpus for private evaluat
 
 | Need | Example |
 | --- | --- |
-| Learn the complete CLI workflow | [Sovereign RAG demo](../sovereign-rag-demo/README.md) |
+| Learn the complete CLI workflow | [Confidential local RAG demo](../sovereign-rag-demo/README.md) |
 | Measure exact paths and citations | [Document evidence benchmark](../document-evidence-benchmark/README.md) |
 | Explore every exported function and option | [Complete TypeScript API reference](../../../../docs/api-reference.md) |
 

packages/ragmir-core/examples/sovereign-rag-demo/README.md

@@ -1,4 +1,4 @@
-# Sovereign RAG demo
+# Confidential local RAG demo
 
 A complete, fictional workspace for learning how agents and scripts retrieve cited local project
 context with Ragmir.