@justestif/pk 0.1.10 → 0.1.12

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/dist/index.js CHANGED
@@ -17713,7 +17713,7 @@ var {
17713
17713
  var package_default = {
17714
17714
  name: "@justestif/pk",
17715
17715
  type: "module",
17716
- version: "0.1.10",
17716
+ version: "0.1.12",
17717
17717
  description: "Project knowledge \u2014 structured intake, search, and recall",
17718
17718
  bin: {
17719
17719
  pk: "dist/index.js"
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@justestif/pk",
3
3
  "type": "module",
4
- "version": "0.1.10",
4
+ "version": "0.1.12",
5
5
  "description": "Project knowledge — structured intake, search, and recall",
6
6
  "bin": {
7
7
  "pk": "dist/index.js"
package/skill/SKILL.md CHANGED
@@ -7,54 +7,33 @@ description: "Load when maintaining project knowledge, capturing decisions or qu
7
7
 
8
8
  Structured project knowledge — intake, search, recall, and audit over `knowledge/`.
9
9
 
10
- ## Prerequisites
10
+ ## Tools
11
11
 
12
- Verify before every operation:
13
-
14
- ```bash
15
- pk --version 2>/dev/null || npm install -g @justestif/pk
16
- ```
17
-
18
- ## First use in a project
19
-
20
- ```bash
21
- pk init
22
- ```
23
-
24
- Creates `knowledge/`, installs Claude Code hook at `.claude/hooks/pk-user-prompt-submit.ts`.
25
- The hook injects open questions, recent decisions, and active notes into every prompt automatically.
26
-
27
- ## Commands
28
-
29
- ```bash
30
- pk new <type> <title> [--tags tag1,tag2] # type: note|decision|question|source
31
- pk search <query> [--context] [--limit 5]
32
- pk synthesize [query] [--all] [--session-start]
33
- pk index # rebuild FTS5 + markdown indexes
34
- pk lint # validate structure — exit 1 on errors
35
- pk instructions <command> # full behavioral guide per command
36
- ```
37
-
38
- Run all commands from the project root (where `knowledge/` lives).
12
+ | Task | Tool |
13
+ |---|---|
14
+ | Search notes | `pk_search` |
15
+ | Context dump / session start | `pk_synthesize` |
16
+ | Create a note | `pk_new` |
17
+ | Validate structure | `pk_lint` |
39
18
 
40
19
  ## Intake
41
20
 
42
- **Search before creating** — always run `pk search` first.
21
+ **Search before creating** — always call `pk_search` first.
43
22
 
44
23
  - Substantial messy input → `source`. Extract `note`, `decision`, `question` only when durable beyond this session.
45
24
  - Update existing when the match is obvious; otherwise create and link in body.
46
- - Run `pk lint` before committing. Auto-commit coherent operations only when lint passes and no unrelated files are staged.
25
+ - Call `pk_lint` before committing. Auto-commit coherent operations only when lint passes and no unrelated files are staged.
47
26
 
48
27
  ## Asking
49
28
 
50
- 1. `pk search <query> [--context]`
29
+ 1. `pk_search` with the relevant query
51
30
  2. Read top results directly
52
31
  3. Answer with citations to note paths/IDs
53
32
  4. If silent or ambiguous, offer to create a `question` note
54
33
 
55
34
  ## NEVER
56
35
 
57
- - **Skip `pk search` before creating** — duplicates erode trust in the knowledge base
36
+ - **Skip `pk_search` before creating** — duplicates erode trust in the knowledge base
58
37
  - **Dump raw input into durable notes** — preserve in `source`, extract selectively
59
38
  - **Silently merge related-but-different claims** — create and link instead
60
39
  - **Auto-commit when lint fails or unrelated files are staged**