cngkit 1.0.0 → 1.1.1

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/README.md CHANGED
@@ -1,18 +1,27 @@
1
1
  # cngkit
2
2
 
3
- Opinionated Curly.ng CLI kit for repo sync and website tooling.
3
+ Opinionated Curly.ng CLI kit for repo sync, Harness knowledges, and website tooling.
4
4
 
5
5
  ```bash
6
6
  npx cngkit
7
7
  ```
8
8
 
9
- The first MVP provides a real-time repository sync room:
9
+ The CLI provides a real-time repository sync room and a terminal front door to
10
+ the Cloudflare-backed Harness knowledges catalog:
10
11
 
11
12
  - `cngkit share` starts a room from the current directory.
12
13
  - `cngkit join <room-code>` joins another machine to that room.
13
14
  - `cngkit login` opens Curly.ng login in a browser, or prints the URL in headless environments.
14
15
  - `cngkit scrub [path]` scans a file or directory with TruffleHog and prints a redacted report.
15
16
  - `cngkit scrub [path] --yes` rewrites detected secret values inline with `CNGKIT_SECRET` placeholders.
17
+ - `cngkit knowledges status` prints the remote catalog state.
18
+ - `cngkit knowledges audiences` lists available audience filters.
19
+ - `cngkit knowledges search <query>` runs semantic search against Cloudflare Vectorize.
20
+ - `cngkit knowledges list [query]` lists known subskills.
21
+ - `cngkit knowledges files [query]` lists uploaded catalog files.
22
+ - `cngkit knowledges read <file-path>` reads a catalog file excerpt.
23
+ - `cngkit knowledges grep <pattern>` searches catalog file contents.
24
+ - `cngkit knowledges glob [pattern]` lists catalog files by supported glob pattern.
16
25
  - `.git/` and files ignored by the repo's `.gitignore` are not synced.
17
26
  - Later changes override earlier changes for the MVP conflict rule.
18
27
 
@@ -24,6 +33,25 @@ brew install trufflehog
24
33
 
25
34
  Inline masking is intentionally gated behind `--yes` because it rewrites files in place.
26
35
 
36
+ ## Harness Knowledges
37
+
38
+ The `knowledges` command group reads the Cloudflare-backed Harness catalog from the
39
+ Curly API. These commands are read-only:
40
+
41
+ ```bash
42
+ cngkit knowledges status
43
+ cngkit knowledges audiences
44
+ cngkit knowledges search "cloudflare backend" --limit 3
45
+ cngkit knowledges files "vector search" --audience builders
46
+ cngkit knowledges read /libraries/lib-cloudflare/SUBSKILL.md --limit 80
47
+ cngkit knowledges grep Cloudflare --path /libraries/lib-cloudflare --output-mode files_with_matches
48
+ cngkit knowledges glob "**/*.md" --path /libraries/lib-cloudflare
49
+ ```
50
+
51
+ Add `--json` to any `knowledges` command when another tool should consume the
52
+ raw API response. `grep` also accepts `--output-mode <content|files_with_matches|count>`,
53
+ `--include <glob>`, `--context <n>`, and `--case-insensitive`.
54
+
27
55
  This package is mostly personal tooling for Curly.ng. It is intentionally opinionated,
28
56
  small, and practical rather than a general synchronization platform.
29
57