docpack bundle --input ./docs --output ./mykb --converter ./convert.ts
docpack toc ./mykb "getting-started" --depth 2
docpack search ./mykb "authentication AND OAuth" --limit 5

# Bundle a directory of PDFs
docpack bundle --input ./docs --output ./mykb --converter ./convert.ts

# Explore the knowledge base
docpack manifest ./mykb
docpack toc ./mykb "my-root-slug" --depth 2
docpack search ./mykb "keyword" --limit 10

# Start an MCP server
docpack serve ./mykb --mcp

npx @rlemaigre/docpack manifest ./mykb

npm install @rlemaigre/docpack
docpack manifest ./mykb

import { bundle, query } from "@rlemaigre/docpack";

npx skills add rlemaigre/docpack

mykb/
  docpack.db        # SQLite knowledge base
  docpack.yaml      # human-readable manifest and entry points

flowchart LR
    A[files/] --> B[converter]
    B -->|Markdown| C[bundle]
    C --> D[docpack.db]
    C --> E[docpack.yaml]
    D --> F[query / search]
    E --> F
    F --> G[CLI / MCP / TS library]

graph TD
    D[directory] --> F1[file]
    D --> F2[file]
    F1 --> S1[section]
    F1 --> S2[section]
    S1 --> L1[leaf]
    S1 --> L2[leaf]
    S2 --> L3[leaf]

docpack bundle --input <path> --output <path> --converter <path> [--include <glob>]

import * as fs from "node:fs";

export default function converter(path: string): string | null {
  const ext = path.split(".").pop();
  if (ext === "md") return fs.readFileSync(path, "utf8");
  if (ext === "txt") return fs.readFileSync(path, "utf8");
  return null; // skip
}

docpack manifest <kb>

docpack toc <kb> <slug> [--depth <mode>]

docpack get <kb> <slug>

docpack search <kb> "query" [--limit N] [--offset O]

docpack summarize <kb> --fn <path>

export default async function (kb, emit) {
  const manifest = kb.manifest();
  for (const file of manifest.files) {
    const doc = kb.get(file.slug);
    const summary = await summarizeWithLLM(doc);
    emit(file.slug, summary);
  }
}

docpack serve <kb> --mcp

import { bundle } from "@rlemaigre/docpack";

const stats = bundle({
  input: "./docs",
  output: "./mykb",
  converter: (path) => {
    // return Markdown string or null to skip
  },
  include: "**/*.md",
  onProgress: (path, done, total) => console.log(`${done}/${total}`),
  onError: (path, err) => console.error(err),
});

console.log(stats);
// { filesProcessed: 10, filesSkipped: 2, totalChunks: 85, totalBytes: 133714 }

import { query } from "@rlemaigre/docpack";

const kb = query("./mykb");

// Discover structure
const manifest = kb.manifest();
console.log(manifest.roots);
// ["getting-started", "api-reference"]

// Navigate with clipped summaries
const toc = kb.toc("api-reference", 2);

// Get full subtree
const doc = kb.get("api-auth");

// Search
const results = kb.search({
  query: "authentication AND OAuth",
  limit: 10,
  offset: 0,
});

kb.close();

import { summarize } from "@rlemaigre/docpack";

await summarize({
  input: "./mykb",
  async summarizer(kb, emit) {
    const manifest = kb.manifest();
    for (const file of manifest.files) {
      const doc = kb.get(file.slug);
      if (!doc) continue;
      const summary = await callLLM(doc);
      emit(file.slug, summary);
    }
  },
});

Node = {
  type: "directory" | "file" | "section",
  title: string,
  slug: string,
  index: number,
  chunk: string?,      // self content (Markdown)
  summary: string?,    // subtree overview
  children: Node[] | Summary
}

Summary = {
  chunkCount: number,   // descendants with content
  totalBytes: number,   // total chunk bytes in subtree
  depth: number,        // max depth below this node
  text?: string         // AI-generated overview
}

<document slug="api-auth" title="Authentication" level="2" depth="0" parent="api" prev="api-overview" next="api-billing">
  <chunk>...</chunk>
  <children>
    <document slug="api-auth-oauth" title="OAuth" level="3" depth="0" parent="api-auth" prev="" next="api-auth-apikey">
      <chunk>...</chunk>
    </document>
  </children>
</document>