okf-catalog 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,6 +1,18 @@
1
1
  # Changelog
2
2
 
3
- The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). The version in `package.json` names the release. 0.1.0 is published before the clean-account run of the acceptance list in `docs/acceptance/version-0.md`, by the maintainer's choice; what that run finds goes into 0.1.1.
3
+ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). The version in `package.json` names the release. 0.1.0 was published on 2026-10-07, before the clean-account run of the acceptance list in `docs/acceptance/version-0.md`, by the maintainer's choice; what that run finds goes into a later patch release.
4
+
5
+ ## [0.1.2] - 2026-10-07
6
+
7
+ ### Changed
8
+
9
+ - The README carries the npm badge, the measured install size and how releases are published. This is the first version published by the release workflow itself, through npm's trusted publishing with a provenance statement; the code is that of 0.1.1.
10
+
11
+ ## [0.1.1] - 2026-10-07
12
+
13
+ ### Fixed
14
+
15
+ - The package no longer ships `npm-shrinkwrap.json`. npm honours a shrinkwrap found inside an installed package and installs its whole locked tree nested under the package, development tools and every platform's native binaries included: `npm install okf-catalog@0.1.0` put 336 packages and 3.1 GB under `node_modules/okf-catalog/node_modules`. Without the file the same install is 204 packages and 227 MB, hoisted and filtered by platform. Nothing else changes; 0.1.0 works, it is only large.
4
16
 
5
17
  ## [0.1.0] - 2026-10-07
6
18
 
@@ -21,4 +33,4 @@ Version 0: serve a company's Open Knowledge Format 0.2 bundle to Claude Code, lo
21
33
 
22
34
  ### Not in this version
23
35
 
24
- HTTP transport and authorization, full mode as a product option, Codex and Grok Build plugins, Windows, npm publication.
36
+ HTTP transport and authorization, full mode as a product option, Codex and Grok Build plugins, Windows.
package/README.md CHANGED
@@ -1,29 +1,31 @@
1
1
  # okf-catalog
2
2
 
3
+ [![npm](https://img.shields.io/npm/v/okf-catalog)](https://www.npmjs.com/package/okf-catalog)
4
+
3
5
  A small-company hosted knowledge catalog for AI agents.
4
6
 
5
7
  okf-catalog is an MCP server that serves a company's [Open Knowledge Format](https://github.com/GoogleCloudPlatform/open-knowledge-format) bundle to agents. It runs on a developer's machine today and from a cheap cloud recipe later, so that local coding agents (Claude Code, Codex, Grok Build) and the web versions of Claude and ChatGPT answer from the same cited knowledge.
6
8
 
7
9
  What it adds: **qmd done right for OKF.** [qmd](https://github.com/tobi/qmd) is the best Markdown search engine there is. okf-catalog makes it understand OKF's fields: titles, descriptions and tags ranked as they should be, status and recheck dates respected, trust and provenance returned with every answer, deprecated pages pointing to their replacements.
8
10
 
9
- **Status: version 0 release candidate (0.1.0), not yet accepted, not published.** Every item of the version 0 acceptance list that a test can prove is proven on every run; the items that need a person on a clean account (a signed-in Claude Code answering from a bundle, a real publish, the network off) are pending, with their runbook in [docs/acceptance/version-0.md](docs/acceptance/version-0.md). The package is marked private and nothing is on npm; the licence is Apache-2.0 (decision D1). Start with [docs/intent.md](docs/intent.md); the implementation plan and its execution record are under [docs/plans/](docs/plans/).
11
+ **Status: version 0 (0.1.2) on npm, not yet accepted.** Every item of the version 0 acceptance list that a test can prove is proven on every run; the items that need a person on a clean account (a signed-in Claude Code answering from a bundle, a real publish, the network off) are pending, with their runbook in [docs/acceptance/version-0.md](docs/acceptance/version-0.md). The package is public on npm as `okf-catalog`; releases are tagged `v<version>` and published by the repository's release workflow through npm's trusted publishing, each with a provenance statement, and `CHANGELOG.md` has the entries. The licence is Apache-2.0 (decision D1). Start with [docs/intent.md](docs/intent.md); the implementation plan and its execution record are under [docs/plans/](docs/plans/).
10
12
 
11
13
  ## Quickstart
12
14
 
13
- Once the package is on npm, the install is one command, and the `okf-catalog` command lands on your PATH:
15
+ The install is one command, and the `okf-catalog` command lands on your PATH:
14
16
 
15
17
  ```bash
16
18
  NODE_LLAMA_CPP_SKIP_DOWNLOAD=1 npm install -g okf-catalog
17
19
  ```
18
20
 
19
- Until then, or to work on the code, use a checkout:
21
+ To work on the code, use a checkout:
20
22
 
21
23
  ```bash
22
24
  git clone https://github.com/drathm/okf-catalog.git && cd okf-catalog
23
25
  NODE_LLAMA_CPP_SKIP_DOWNLOAD=1 npm ci
24
26
  ```
25
27
 
26
- `npm ci` builds `dist/` on its way out (the `prepare` script), and the flag keeps qmd's native dependency from downloading or compiling anything: lexical mode needs no model. Check the install and a bundle (`node dist/cli.js` in a checkout stands in for `okf-catalog`, or `npm install -g .` puts the command on PATH):
28
+ `npm ci` builds `dist/` on its way out (the `prepare` script), and the flag keeps qmd's native dependency from downloading or compiling anything: lexical mode needs no model. Either install pulls about 230 MB of dependencies, most of it qmd's search engine and its native packages. Check the install and a bundle (`node dist/cli.js` in a checkout stands in for `okf-catalog`, or `npm install -g .` puts the command on PATH):
27
29
 
28
30
  ```bash
29
31
  okf-catalog --version
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "okf-catalog",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "An MCP server that serves a company's Open Knowledge Format (OKF) bundle to AI agents, with citations, provenance and a publish loop: qmd done right for OKF.",
5
5
  "keywords": [
6
6
  "okf",
@@ -37,8 +37,7 @@
37
37
  "plugin",
38
38
  "recipes/publish",
39
39
  "NOTICE",
40
- "CHANGELOG.md",
41
- "npm-shrinkwrap.json"
40
+ "CHANGELOG.md"
42
41
  ],
43
42
  "scripts": {
44
43
  "build": "node node_modules/@typescript/native/bin/tsc -p tsconfig.build.json",
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "okf-catalog",
3
- "version": "0.1.0",
3
+ "version": "0.1.2",
4
4
  "description": "Serves a company's Open Knowledge Format bundle to Claude: search, read pages whole, cite path, trust and recheck date. Needs the okf-catalog command on PATH (npm install -g okf-catalog) and an okf-catalog.yaml in the project folder or named by OKF_CATALOG_CONFIG.",
5
5
  "author": {
6
6
  "name": "Bitfusion PR LLC",