diff --git a/CLAUDE.md b/CLAUDE.md index 9cfadc5..de8ead3 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -31,13 +31,13 @@ Manual workflow dispatch via GitHub Actions (`release.yml`). **Critical rules:** - Never push directly to `main` — always branch + PR - Conventional Commits: `feat:`, `fix:`, `chore:`, `ci:`, `docs:` -- `ci.yml`: runs lint + tests on branch pushes and PRs to main +- `ci.yml`: runs lint + tests on PRs to main - `release.yml`: manual workflow dispatch from main — creates tag, GitHub release, publishes to npm, builds binaries ## Commands ```bash -bun test # run tests (354+) +bun test # run tests (402+) bun run check # biome lint + format bun run packages/cli/bin/kib.ts # run CLI locally ``` diff --git a/README.md b/README.md index 9bbec7b..557a174 100644 --- a/README.md +++ b/README.md @@ -132,7 +132,7 @@ INTEGRATION MANAGEMENT config [key] [val] Get or set configuration - skill [name] Manage skills (list, run) + skill [name] Manage skills (install, list, run, create) export Export wiki to markdown or HTML FLAGS @@ -252,7 +252,7 @@ You can also set provider via environment variables: | Provider | Env Variable | Default Model | |---|---|---| -| **Anthropic** | `ANTHROPIC_API_KEY` | claude-sonnet-4-20250514 | +| **Anthropic** | `ANTHROPIC_API_KEY` | claude-sonnet-4-6-20250514 | | **OpenAI** | `OPENAI_API_KEY` | gpt-4o | | **Ollama** | (auto-detect on localhost:11434) | llama3 | @@ -275,9 +275,9 @@ That's it. Restart your AI client and it can search, query, ingest, and compile Already have a vault? Run `kib mcp` to configure MCP clients without re-initializing. -**8 tools:** `kib_status`, `kib_list`, `kib_read`, `kib_search`, `kib_query`, `kib_ingest`, `kib_compile`, `kib_lint` +**11 tools:** `kib_status`, `kib_list`, `kib_read`, `kib_search`, `kib_query`, `kib_ingest`, `kib_compile`, `kib_lint`, `kib_config`, `kib_skill`, `kib_export` -**2 resources:** `wiki://index`, `wiki://graph` +**3 resources:** `wiki://index`, `wiki://graph`, `wiki://log`
Manual setup (other clients) diff --git a/ROADMAP.md b/ROADMAP.md index 49c3f53..1fbb1aa 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -4,7 +4,7 @@ What's built, what's next, and what's deferred. --- -## Shipped (v0.4.x) +## Shipped (v1.0.0) ### Core (v0.2.0) - `kib init` — vault creation with auto-detected LLM provider @@ -30,14 +30,14 @@ What's built, what's next, and what's deferred. - Published to npm as `@kibhq/core` and `@kibhq/cli` - Standalone binaries for macOS/Linux via `bun build --compile` - Release Please: auto-versioning, changelogs, npm publish, binary builds -- CI: Biome lint + 412 tests on every push +- CI: Biome lint + 402 tests on PRs to main ### MCP Server (v0.2.0) - `kib serve` — expose vault as MCP tools over stdio - `kib init` auto-configures MCP in Claude Code, Claude Desktop, and Cursor - `kib mcp` to re-configure MCP clients independently -- 8 tools: `kib_status`, `kib_list`, `kib_read`, `kib_search`, `kib_query`, `kib_ingest`, `kib_compile`, `kib_lint` -- 2 resources: `wiki://index`, `wiki://graph` +- 11 tools: `kib_status`, `kib_list`, `kib_read`, `kib_search`, `kib_query`, `kib_ingest`, `kib_compile`, `kib_lint`, `kib_config`, `kib_skill`, `kib_export` +- 3 resources: `wiki://index`, `wiki://graph`, `wiki://log` ### CLI Polish (v0.3.0) - `--json` flag working consistently across all commands diff --git a/docs/provider-config.md b/docs/provider-config.md index 0eb7511..9595ac1 100644 --- a/docs/provider-config.md +++ b/docs/provider-config.md @@ -33,7 +33,7 @@ kib config provider.model gpt-4o | Feature | Anthropic | OpenAI | Ollama | |---------|-----------|--------|--------| -| Default model | claude-sonnet-4-20250514 | gpt-4o | llama3 | +| Default model | claude-sonnet-4-6-20250514 | gpt-4o | llama3 | | Fast model | claude-haiku-4-5-20251001 | gpt-4o | llama3 | | Vision (image ingest) | Yes | Yes | No | | Embeddings (vector search) | No | Yes (text-embedding-3-small) | Yes (nomic-embed-text) | @@ -72,7 +72,7 @@ Run `kib init` and follow the prompts to select a provider and enter your API ke Used for heavy operations (compile, query, chat): ```bash -kib config provider.model claude-sonnet-4-20250514 +kib config provider.model claude-sonnet-4-6-20250514 ``` ### Fast model @@ -92,7 +92,7 @@ Override the model for specific operations: kib config compile.model gpt-4o # Use a different model for queries -kib config query.model claude-sonnet-4-20250514 +kib config query.model claude-sonnet-4-6-20250514 ``` These override `provider.model` for that specific operation only. @@ -104,7 +104,7 @@ All provider settings live in `.kb/config.toml`: ```toml [provider] default = "anthropic" -model = "claude-sonnet-4-20250514" +model = "claude-sonnet-4-6-20250514" fast_model = "claude-haiku-4-5-20251001" [compile] diff --git a/docs/vault-format.md b/docs/vault-format.md index ace7d14..dfcbe11 100644 --- a/docs/vault-format.md +++ b/docs/vault-format.md @@ -48,7 +48,7 @@ The manifest is the source of truth for vault state. Schema version: `"1"`. "created": "2024-01-15T10:00:00.000Z", "lastCompiled": "2024-01-15T12:00:00.000Z", "provider": "anthropic", - "model": "claude-sonnet-4-20250514" + "model": "claude-sonnet-4-6-20250514" }, "sources": { "src_a1b2c3d4e5f6": { @@ -116,7 +116,7 @@ Vault configuration lives at `.kb/config.toml`: ```toml [provider] default = "anthropic" -model = "claude-sonnet-4-20250514" +model = "claude-sonnet-4-6-20250514" fast_model = "claude-haiku-4-5-20251001" [compile] diff --git a/examples/ml-research/.kb/config.toml b/examples/ml-research/.kb/config.toml index 3f9b170..113004c 100644 --- a/examples/ml-research/.kb/config.toml +++ b/examples/ml-research/.kb/config.toml @@ -1,6 +1,6 @@ [provider] default = "anthropic" -model = "claude-sonnet-4-20250514" +model = "claude-sonnet-4-6-20250514" fast_model = "claude-haiku-4-5-20251001" [compile] diff --git a/examples/ml-research/.kb/manifest.json b/examples/ml-research/.kb/manifest.json index 010828d..188e980 100644 --- a/examples/ml-research/.kb/manifest.json +++ b/examples/ml-research/.kb/manifest.json @@ -5,7 +5,7 @@ "created": "2026-03-01T09:00:00.000Z", "lastCompiled": "2026-03-15T14:30:00.000Z", "provider": "anthropic", - "model": "claude-sonnet-4-20250514" + "model": "claude-sonnet-4-6-20250514" }, "sources": { "src_att001": { diff --git a/examples/reading-list/.kb/config.toml b/examples/reading-list/.kb/config.toml index 0596805..eab4e09 100644 --- a/examples/reading-list/.kb/config.toml +++ b/examples/reading-list/.kb/config.toml @@ -1,6 +1,6 @@ [provider] default = "anthropic" -model = "claude-sonnet-4-20250514" +model = "claude-sonnet-4-6-20250514" fast_model = "claude-haiku-4-5-20251001" [compile] diff --git a/examples/reading-list/.kb/manifest.json b/examples/reading-list/.kb/manifest.json index 795e096..b1121d2 100644 --- a/examples/reading-list/.kb/manifest.json +++ b/examples/reading-list/.kb/manifest.json @@ -5,7 +5,7 @@ "created": "2026-01-05T10:00:00.000Z", "lastCompiled": "2026-04-01T16:00:00.000Z", "provider": "anthropic", - "model": "claude-sonnet-4-20250514" + "model": "claude-sonnet-4-6-20250514" }, "sources": { "src_tfas001": { diff --git a/package.json b/package.json index 810b766..7b03199 100644 --- a/package.json +++ b/package.json @@ -15,5 +15,5 @@ "devDependencies": { "@biomejs/biome": "^2.4.10" }, - "version": "0.4.3" + "version": "1.0.0" } diff --git a/packages/cli/README.md b/packages/cli/README.md index fdd655b..ac03a4f 100644 --- a/packages/cli/README.md +++ b/packages/cli/README.md @@ -61,7 +61,7 @@ INTEGRATION MANAGEMENT config [key] [val] Get or set configuration - skill [name] Manage skills (list, run) + skill [name] Manage skills (install, list, run, create) export Export wiki to markdown or HTML ``` @@ -83,7 +83,7 @@ On first use, kib walks you through provider setup interactively. Or set via env | Provider | Env Variable | Default Model | |----------|-------------|---------------| -| Anthropic | `ANTHROPIC_API_KEY` | claude-sonnet-4-20250514 | +| Anthropic | `ANTHROPIC_API_KEY` | claude-sonnet-4-6-20250514 | | OpenAI | `OPENAI_API_KEY` | gpt-4o | | Ollama | (auto-detect localhost:11434) | llama3 | @@ -119,7 +119,9 @@ Already have a vault? Run `kib mcp` to configure MCP clients without re-initiali Restart your AI client and it can search, query, ingest, and compile your vault. -8 tools: `kib_status`, `kib_list`, `kib_read`, `kib_search`, `kib_query`, `kib_ingest`, `kib_compile`, `kib_lint` +11 tools: `kib_status`, `kib_list`, `kib_read`, `kib_search`, `kib_query`, `kib_ingest`, `kib_compile`, `kib_lint`, `kib_config`, `kib_skill`, `kib_export` + +3 resources: `wiki://index`, `wiki://graph`, `wiki://log`
Manual setup (other clients) diff --git a/packages/cli/package.json b/packages/cli/package.json index e53d19a..3df5df9 100644 --- a/packages/cli/package.json +++ b/packages/cli/package.json @@ -1,6 +1,6 @@ { "name": "@kibhq/cli", - "version": "0.4.3", + "version": "1.0.0", "description": "The Headless Knowledge Compiler — turn raw sources into a structured, queryable wiki with AI", "type": "module", "bin": { @@ -35,7 +35,7 @@ "test": "bun test" }, "dependencies": { - "@kibhq/core": "^0.4.2", + "@kibhq/core": "^1.0.0", "@modelcontextprotocol/sdk": "^1.29.0", "chalk": "^5.4.1", "commander": "^14.0.0", diff --git a/packages/cli/src/index.ts b/packages/cli/src/index.ts index 0390dd2..2b044c3 100644 --- a/packages/cli/src/index.ts +++ b/packages/cli/src/index.ts @@ -1,10 +1,12 @@ import { Command } from "commander"; import { setVerbose } from "./ui/debug.js"; +const { version } = require("../package.json"); + const program = new Command() .name("kib") .description("The Headless Knowledge Compiler") - .version("0.1.0") + .version(version) .option("-v, --verbose", "enable debug output") .hook("preAction", (_thisCommand, actionCommand) => { const rootOpts = actionCommand.optsWithGlobals(); @@ -156,7 +158,7 @@ program program .command("export") .description("Export wiki to other formats") - .option("--format ", "output format: markdown, html, pdf", "markdown") + .option("--format ", "output format: markdown, html", "markdown") .option("--output ", "output directory") .option("--json", "JSON output") .action(async (opts) => { diff --git a/packages/core/README.md b/packages/core/README.md index 9995ee2..20190c4 100644 --- a/packages/core/README.md +++ b/packages/core/README.md @@ -59,7 +59,7 @@ console.log(answer.answer); | Provider | Env Variable | Default Model | |----------|-------------|---------------| -| Anthropic | `ANTHROPIC_API_KEY` | claude-sonnet-4-20250514 | +| Anthropic | `ANTHROPIC_API_KEY` | claude-sonnet-4-6-20250514 | | OpenAI | `OPENAI_API_KEY` | gpt-4o | | Ollama | (auto-detect localhost:11434) | llama3 | diff --git a/packages/core/package.json b/packages/core/package.json index ee4320b..ea03016 100644 --- a/packages/core/package.json +++ b/packages/core/package.json @@ -1,6 +1,6 @@ { "name": "@kibhq/core", - "version": "0.4.3", + "version": "1.0.0", "description": "Core engine for kib — vault operations, LLM providers, ingest, compile, search, and query", "type": "module", "exports": { diff --git a/packages/core/src/constants.ts b/packages/core/src/constants.ts index f3f1a51..a7795c8 100644 --- a/packages/core/src/constants.ts +++ b/packages/core/src/constants.ts @@ -24,7 +24,7 @@ export const RAW_CATEGORIES = ["articles", "papers", "repos", "images", "transcr /** Default config values */ export const DEFAULTS = { provider: "anthropic", - model: "claude-sonnet-4-20250514", + model: "claude-sonnet-4-6-20250514", fastModel: "claude-haiku-4-5-20251001", maxSourcesPerPass: 10, searchMaxResults: 20, diff --git a/packages/core/tsconfig.json b/packages/core/tsconfig.json index 820fcea..0e15299 100644 --- a/packages/core/tsconfig.json +++ b/packages/core/tsconfig.json @@ -6,5 +6,6 @@ "composite": true, "noEmit": false }, - "include": ["src"] + "include": ["src"], + "exclude": ["src/**/*.test.ts"] }