@jcode.labs/mimir 0.4.6 → 0.4.7

package/dist/skill.js

@@ -7,6 +7,7 @@ import { kbCommand } from "./package-manager.js";
 const PACKAGE_ROOT = path.dirname(path.dirname(fileURLToPath(import.meta.url)));
 const PRIMARY_SKILL_NAME = "mimir";
 const AUDIO_SKILL_NAME = "mimir-audio-summary";
+const REPORT_SKILL_NAME = "mimir-markdown-report";
 export function bundledSkillPath(skillName = PRIMARY_SKILL_NAME) {
     return path.join(PACKAGE_ROOT, "skills", skillName);
 }
@@ -15,22 +16,34 @@ export async function installSkill(options = {}) {
     const targetDir = path.resolve(cwd, options.targetDir ?? DEFAULT_SKILL_TARGET_DIR);
     const skillPath = path.join(targetDir, PRIMARY_SKILL_NAME);
     const audioSkillPath = path.join(targetDir, AUDIO_SKILL_NAME);
+    const reportSkillPath = path.join(targetDir, REPORT_SKILL_NAME);
     const mimirDir = path.resolve(cwd, MIMIR_DIR);
     const mcpConfigPath = path.join(mimirDir, "mcp.json");
+    const claudeConfigPath = path.join(mimirDir, "claude-mcp-server.json");
+    const codexConfigPath = path.join(mimirDir, "codex-mcp.toml");
     const readmePath = path.join(mimirDir, "README.md");
     await mkdir(targetDir, { recursive: true });
     await mkdir(mimirDir, { recursive: true });
     await cp(bundledSkillPath(PRIMARY_SKILL_NAME), skillPath, { recursive: true, force: true });
     await cp(bundledSkillPath(AUDIO_SKILL_NAME), audioSkillPath, { recursive: true, force: true });
+    await cp(bundledSkillPath(REPORT_SKILL_NAME), reportSkillPath, {
+        recursive: true,
+        force: true,
+    });
     const serveCommand = await kbCommand(cwd, ["serve-mcp"]);
     const doctorCommand = await kbCommand(cwd, ["doctor"]);
     await writeFile(mcpConfigPath, `${JSON.stringify(mcpConfig(cwd, serveCommand), null, 2)}\n`, "utf8");
-    await writeFile(readmePath, agentKitReadme(skillPath, audioSkillPath, mcpConfigPath, serveCommand.display, doctorCommand.display), "utf8");
+    await writeFile(claudeConfigPath, `${JSON.stringify(claudeMcpServer(serveCommand), null, 2)}\n`, "utf8");
+    await writeFile(codexConfigPath, codexMcpConfig(cwd, serveCommand), "utf8");
+    await writeFile(readmePath, agentKitReadme(skillPath, audioSkillPath, reportSkillPath, mcpConfigPath, codexConfigPath, serveCommand.display, doctorCommand.display), "utf8");
     const wroteGitignore = await ensureMimirGitignore(cwd);
     const written = [
         path.relative(cwd, skillPath),
         path.relative(cwd, audioSkillPath),
+        path.relative(cwd, reportSkillPath),
         path.relative(cwd, mcpConfigPath),
+        path.relative(cwd, claudeConfigPath),
+        path.relative(cwd, codexConfigPath),
         path.relative(cwd, readmePath),
     ];
     if (wroteGitignore) {
@@ -39,7 +52,10 @@ export async function installSkill(options = {}) {
     return {
         skillPath,
         audioSkillPath,
+        reportSkillPath,
         mcpConfigPath,
+        claudeConfigPath,
+        codexConfigPath,
         readmePath,
         written,
     };
@@ -55,7 +71,28 @@ function mcpConfig(cwd, serveCommand) {
         },
     };
 }
-function agentKitReadme(skillPath, audioSkillPath, mcpConfigPath, serveCommand, doctorCommand) {
+function claudeMcpServer(serveCommand) {
+    return {
+        type: "stdio",
+        command: serveCommand.command,
+        args: serveCommand.args,
+    };
+}
+function codexMcpConfig(cwd, serveCommand) {
+    return `[mcp_servers.mimir]
+command = ${tomlString(serveCommand.command)}
+args = ${tomlArray(serveCommand.args)}
+cwd = ${tomlString(cwd)}
+
+`;
+}
+function tomlArray(values) {
+    return `[${values.map(tomlString).join(", ")}]`;
+}
+function tomlString(value) {
+    return JSON.stringify(value);
+}
+function agentKitReadme(skillPath, audioSkillPath, reportSkillPath, mcpConfigPath, codexConfigPath, serveCommand, doctorCommand) {
     return `# Mimir Agent Kit
 
 This folder contains portable agent instructions for Mimir.
@@ -80,6 +117,15 @@ Use it only when the user asks for a listenable summary. It renders generated au
 local Mimir state by default. Use Transformers.js WAV for confidential content and Edge MP3 only
 when online TTS is explicitly acceptable.
 
+Optional Markdown-report skill folder:
+
+\`\`\`plain text
+${reportSkillPath}
+\`\`\`
+
+Use it when the user asks for a cited Markdown report, dossier, audit memo, or planning note. It
+writes reports under ignored local Mimir state by default.
+
 ## MCP
 
 MCP config example:
@@ -94,6 +140,26 @@ Use the MCP server when your agent supports MCP tools. The server command is:
 ${serveCommand}
 \`\`\`
 
+Claude Code local setup:
+
+\`\`\`bash
+claude mcp add-json --scope local mimir "$(cat ${MIMIR_DIR}/claude-mcp-server.json)"
+\`\`\`
+
+Run that command from this repository root. Mimir also reads \`CLAUDE_PROJECT_DIR\`, so the server
+uses the active Claude Code project as the knowledge-base root.
+
+For other MCP clients that cannot set a working directory, launch the server with
+\`MIMIR_PROJECT_ROOT=/absolute/path/to/repository\`.
+
+Codex setup:
+
+\`\`\`plain text
+${codexConfigPath}
+\`\`\`
+
+Copy that TOML snippet into \`~/.codex/config.toml\` or another trusted Codex config layer.
+
 Before relying on retrieved context, run:
 
 \`\`\`bash

package/dist/skill.js.map

@@ -1 +1 @@
-{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../src/skill.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -17,6 +17,9 @@ export interface Config {
     topK: number;
     chunkSize: number;
     chunkOverlap: number;
+    maxFileBytes: number;
+    ingestConcurrency: number;
+    embeddingBatchSize: number;
     includeExtensions: string[];
 }
 export type EmbeddingProvider = "local-hash" | "transformers";
@@ -44,6 +47,19 @@ export interface SourceFile {
     mtimeMs: number;
     checksum: string;
 }
+export type SkippedSourceReason = "unsupported-extension" | "oversized" | "sensitive-name";
+export interface SkippedSourceFile {
+    relativePath: string;
+    source: string;
+    extension: string;
+    bytes: number;
+    reason: SkippedSourceReason;
+}
+export interface SourceInventory {
+    discoveredFiles: number;
+    supportedFiles: SourceFile[];
+    skippedFiles: SkippedSourceFile[];
+}
 export interface ParsedDocument {
     file: SourceFile;
     text: string;
@@ -66,9 +82,18 @@ export interface IngestOptions {
     rebuild?: boolean;
 }
 export interface IngestResult {
+    discoveredFiles: number;
+    supportedFiles: number;
     indexedFiles: number;
     chunks: number;
     skippedFiles: number;
+    unsupportedFiles: number;
+    oversizedFiles: number;
+    sensitiveFiles: number;
+    unsupportedExtensions: Array<{
+        extension: string;
+        count: number;
+    }>;
     redactions: number;
     errors: Array<{
         path: string;
@@ -96,6 +121,11 @@ export interface AuditReport {
         chunks: number;
     }>;
     supportedFiles: string[];
+    skippedFiles: SkippedSourceFile[];
+    unsupportedExtensions: Array<{
+        extension: string;
+        count: number;
+    }>;
     missingFromIndex: string[];
     staleInIndex: string[];
     totalChunks: number;
@@ -118,6 +148,8 @@ export interface DoctorReport {
     redactionEnabled: boolean;
     accessLog: boolean;
     supportedFiles: number;
+    skippedFiles: number;
+    unsupportedFiles: number;
     indexedFiles: number;
     chunksIndexed: number;
     missingFromIndex: number;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.4.6";
+export declare const VERSION = "0.4.7";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "0.4.6";
+export const VERSION = "0.4.7";
 //# sourceMappingURL=version.js.map

package/examples/sovereign-rag-demo/README.md

@@ -13,6 +13,7 @@ This folder must never contain real-world sensitive, regulated, or production do
 - JSONL incident timelines.
 - YAML policy metadata.
 - A custom `.evidence` text extension enabled through `.kb/config.json`.
+- Unsupported/skipped-file reporting through `audit --unsupported`.
 
 ## Run From This Repository Checkout
 
@@ -32,6 +33,7 @@ node ../../dist/cli.js search "offline retrieval approval"
 node ../../dist/cli.js search "dataset residency"
 node ../../dist/cli.js ask "What evidence supports offline operation?"
 node ../../dist/cli.js audit
+node ../../dist/cli.js audit --unsupported
 node ../../dist/cli.js status
 ```
 
@@ -46,6 +48,17 @@ Retrieval is lexical/hash-based rather than model-semantic.
 - `who owns the usage review`
 - `what documents support sovereign deployment`
 
+## Agent Report Prompt
+
+After running `kb setup` in a real project, an MCP-compatible agent can use the generated
+`.mimir/mcp.json`. For this synthetic demo, ask an agent:
+
+```plain text
+Use Mimir to inspect the local knowledge base, search for "offline retrieval approval", and write a
+cited Markdown report under .mimir/reports/demo-sovereign-rag.md. Mention any unsupported or stale
+files reported by the audit.
+```
+
 ## Switch To Transformers Semantic Mode
 
 To compare no-model retrieval with semantic local retrieval, change `.kb/config.json`:

package/examples/sovereign-rag-demo/raw/facility-scan.heic

@@ -0,0 +1,3 @@
+Synthetic placeholder for an unsupported scanned document format.
+
+Convert scans to OCR text or PDF before expecting Mimir to index their content.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jcode.labs/mimir",
-  "version": "0.4.6",
+  "version": "0.4.7",
   "description": "Mimir: open-source sovereign local RAG for confidential datasets and AI agents.",
   "type": "module",
   "license": "MIT",
@@ -65,7 +65,7 @@
     "unpdf": "^1.4.0",
     "yaml": "^2.8.1",
     "zod": "^4.1.13",
-    "@jcode.labs/mimir-tts": "0.4.6"
+    "@jcode.labs/mimir-tts": "0.4.7"
   },
   "devDependencies": {
     "@types/html-to-text": "^9.0.4",

package/skills/mimir/SKILL.md

@@ -23,6 +23,7 @@ private/          # raw documents to ingest
 .kb/sources.txt   # optional extra source paths
 .kb/storage/      # generated local index
 .kb/access.log    # metadata-only access log
+.mimir/reports/   # generated local Markdown reports
 ```
 
 ## Data Safety
@@ -63,7 +64,7 @@ npx kb setup
 ```
 
 Use `status`, `audit`, and `security-audit` for deeper checks after `doctor` explains the current
-state.
+state. Use `audit --unsupported` when files exist but may not have been indexed.
 
 ## Provider Modes
 
@@ -100,6 +101,7 @@ After documents are added or changed:
 ```bash
 pnpm exec kb doctor --fix
 pnpm exec kb audit
+pnpm exec kb audit --unsupported
 pnpm exec kb security-audit
 pnpm exec kb status
 ```
@@ -160,6 +162,18 @@ If the agent supports MCP, configure a server for the repository:
 }
 ```
 
+For Claude Code, run this from the target repository root after `pnpm exec kb setup`:
+
+```bash
+claude mcp add-json --scope local mimir "$(cat .mimir/claude-mcp-server.json)"
+```
+
+For Codex, copy `.mimir/codex-mcp.toml` into `~/.codex/config.toml` or another trusted Codex config
+layer.
+
+For other MCP clients that cannot set `cwd`, set `MIMIR_PROJECT_ROOT=/absolute/path/to/repository`
+when launching `kb serve-mcp`.
+
 Available MCP tools:
 
 - `mimir_status`: show config and chunk count.
@@ -178,13 +192,26 @@ destroy-index --yes` from the shell when the user explicitly wants to remove the
 If the user asks for a listenable or TTS summary, load the optional
 `.mimir/skills/mimir-audio-summary/` skill installed by `pnpm exec kb setup`.
 
-That skill should:
+The audio skill should:
 
 - gather evidence through Mimir first;
 - write narration text only to a temp file outside the repository;
 - render generated audio under `.mimir/audio/` by default;
 - prefer offline TTS engines for confidential content.
 
+## Optional Markdown Reports
+
+If the user asks for a Markdown report, dossier, audit memo, planning note, or decision brief, load
+the optional `.mimir/skills/mimir-markdown-report/` skill installed by `pnpm exec kb setup`.
+
+The report skill should:
+
+- gather evidence through multiple Mimir searches first;
+- cite source paths and chunk numbers;
+- separate facts, inference, uncertainty, and missing evidence;
+- write reports under `.mimir/reports/` by default;
+- keep generated reports uncommitted unless the user explicitly wants a sanitized tracked report.
+
 ## Installing This Skill Into A Repository
 
 Most repositories should run the full setup command:
@@ -204,11 +231,16 @@ This creates:
 
 ```plain text
 .mimir/skills/mimir/SKILL.md
+.mimir/skills/mimir-audio-summary/SKILL.md
+.mimir/skills/mimir-markdown-report/SKILL.md
 .mimir/mcp.json
+.mimir/claude-mcp-server.json
+.mimir/codex-mcp.toml
 .mimir/README.md
 ```
 
-Agents that understand skill folders can load `.mimir/skills/mimir/`. Other agents can read `.mimir/README.md` and `.mimir/mcp.json`.
+Agents that understand skill folders can load `.mimir/skills/mimir/`. Other agents can read
+`.mimir/README.md` and `.mimir/mcp.json`.
 
 ## Answer Style
 

package/skills/mimir-audio-summary/SKILL.md

@@ -33,6 +33,7 @@ From the repository root, run:
 pnpm exec kb doctor
 pnpm exec kb status
 pnpm exec kb audit
+pnpm exec kb audit --unsupported
 pnpm exec kb security-audit
 ```
 
@@ -40,7 +41,7 @@ If the audit reports missing or stale files, run:
 
 ```bash
 pnpm exec kb doctor --fix
-pnpm exec kb audit
+pnpm exec kb audit --unsupported
 ```
 
 `kb doctor --fix` rebuilds the index only when supported files are present and the privacy posture

package/skills/mimir-markdown-report/SKILL.md

@@ -0,0 +1,110 @@
+---
+name: mimir-markdown-report
+description: >-
+  Create a cited Markdown report from a Mimir local knowledge base. Use when the user asks for a
+  report, dossier, audit memo, planning note, evidence summary, or Markdown deliverable grounded in
+  private repository documents indexed by Mimir.
+---
+
+# Mimir Markdown Report
+
+Use this skill to write a Markdown report from local Mimir evidence without leaking raw documents.
+Generated reports are derived artifacts and should stay local unless the user explicitly decides a
+sanitized report is safe to commit or share.
+
+## Confidentiality Rules
+
+- Treat source documents, retrieved passages, notes, drafts, and generated reports as sensitive.
+- Prefer writing reports under `.mimir/reports/`, which is ignored by Git when Mimir is installed.
+- Do not commit generated reports by default.
+- Do not paste long raw passages into the report. Use summaries, short cited extracts when needed,
+  and source references.
+- Separate proven facts, inference, uncertainty, and missing evidence.
+- For legal, tax, medical, immigration, financial, or compliance reports, include a professional
+  review section instead of presenting the report as final advice.
+
+## 1. Verify The Knowledge Base
+
+From the repository root:
+
+```bash
+pnpm exec kb doctor
+pnpm exec kb audit
+pnpm exec kb security-audit
+```
+
+If files are missing, stale, or setup is incomplete:
+
+```bash
+pnpm exec kb doctor --fix
+pnpm exec kb audit --unsupported
+```
+
+Do not write a final report from stale evidence unless the user explicitly accepts that limitation.
+
+## 2. Build An Evidence Plan
+
+For a broad report, use multiple targeted retrieval passes instead of one generic query:
+
+```bash
+pnpm exec kb search "<main report topic>" --top-k 8
+pnpm exec kb search "<people, dates, amounts, obligations, risks, decisions>" --top-k 8
+pnpm exec kb ask "<specific synthesis question>" --top-k 8
+```
+
+When MCP is available, prefer `mimir_search`, `mimir_ask`, `mimir_audit`, and
+`mimir_security_audit` over shell commands.
+
+Keep a working note of source paths and chunk numbers for each claim you plan to include.
+
+## 3. Write The Report
+
+Default report structure:
+
+```markdown
+# <Report Title>
+
+## Scope
+
+## Executive Summary
+
+## Evidence Inventory
+
+## Findings
+
+## Risks And Open Questions
+
+## Recommended Next Actions
+
+## Sources
+```
+
+Use tables only when they make comparisons easier. Keep each finding tied to one or more source
+paths and chunk numbers when possible.
+
+## 4. Save Locally
+
+Create the report directory:
+
+```bash
+mkdir -p .mimir/reports
+```
+
+Write the report to:
+
+```plain text
+.mimir/reports/<subject-kebab>.md
+```
+
+If the user explicitly wants a tracked report, create a sanitized file outside `.mimir/` and state
+which private details were excluded.
+
+## 5. Report The Result
+
+After writing the report, tell the user:
+
+- the report path;
+- whether the index was ready;
+- how many source paths were used;
+- any unsupported, stale, or missing files that weaken the report;
+- whether the report is safe to commit or should remain local.