imprnt 0.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/CLAUDE.md +173 -0
- package/LICENSE +21 -0
- package/README.md +176 -0
- package/dist/cli.js +2339 -0
- package/dist/imp.js +2342 -0
- package/package.json +46 -0
- package/templates/_tags.md +23 -0
- package/templates/hot.md +28 -0
- package/templates/index.md +33 -0
- package/templates/log.md +8 -0
- package/templates/pointer.md +12 -0
package/package.json
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "imprnt",
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"description": "Deterministic-first, plain-markdown knowledge vault. Code does the bulk transform. The LLM only touches the irreducibly-semantic 20%. Native grep plus BM25 retrieval, zero MCP on the vault.",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"bin": {
|
|
7
|
+
"imprnt": "dist/cli.js",
|
|
8
|
+
"imp": "dist/imp.js"
|
|
9
|
+
},
|
|
10
|
+
"scripts": {
|
|
11
|
+
"build": "bun build scripts/cli.ts scripts/imp.ts --target=node --outdir=dist --banner '#!/usr/bin/env node' && chmod +x dist/cli.js dist/imp.js",
|
|
12
|
+
"typecheck": "tsc --noEmit",
|
|
13
|
+
"test": "bun test",
|
|
14
|
+
"shipdocs": "cp ../../CLAUDE.md ../../README.md ../../LICENSE .",
|
|
15
|
+
"prepublishOnly": "bun run shipdocs && bun run typecheck && bun run test && bun run build"
|
|
16
|
+
},
|
|
17
|
+
"engines": {
|
|
18
|
+
"node": ">=18"
|
|
19
|
+
},
|
|
20
|
+
"license": "MIT",
|
|
21
|
+
"author": "Aleksandr Bogdanov",
|
|
22
|
+
"repository": {
|
|
23
|
+
"type": "git",
|
|
24
|
+
"url": "git+https://github.com/aleksandr-bogdanov/imprnt.git",
|
|
25
|
+
"directory": "packages/imprnt"
|
|
26
|
+
},
|
|
27
|
+
"keywords": [
|
|
28
|
+
"knowledge-base",
|
|
29
|
+
"markdown",
|
|
30
|
+
"second-brain",
|
|
31
|
+
"deterministic",
|
|
32
|
+
"cli",
|
|
33
|
+
"agent-context"
|
|
34
|
+
],
|
|
35
|
+
"files": [
|
|
36
|
+
"dist",
|
|
37
|
+
"templates",
|
|
38
|
+
"CLAUDE.md",
|
|
39
|
+
"README.md",
|
|
40
|
+
"LICENSE"
|
|
41
|
+
],
|
|
42
|
+
"devDependencies": {
|
|
43
|
+
"@types/bun": "^1.3.14",
|
|
44
|
+
"typescript": "^5.7.2"
|
|
45
|
+
}
|
|
46
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
---
|
|
2
|
+
type: tags
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Tags + synonym map
|
|
6
|
+
|
|
7
|
+
Your vault's tag vocabulary. `imprnt check` keeps this in sync with the tags your notes actually use,
|
|
8
|
+
so you rarely edit it by hand. The synonym map normalizes both a note's tag and a search query, so
|
|
9
|
+
related terms resolve to one tag at write time and at read time.
|
|
10
|
+
|
|
11
|
+
Keep it lean. One concept, one tag. A tag applied to most notes cannot tell notes apart, which weakens
|
|
12
|
+
BM25 ranking, so avoid over-broad catch-all tags.
|
|
13
|
+
|
|
14
|
+
This file ships with a small generic seed so search has a tag tier from the first ingest. Replace these
|
|
15
|
+
with your own life-areas and grow the list as you go.
|
|
16
|
+
|
|
17
|
+
## Tags
|
|
18
|
+
identity, health, finances, work, life, projects, people
|
|
19
|
+
|
|
20
|
+
## Synonyms
|
|
21
|
+
pipeline, ingestion, data-pipeline -> etl
|
|
22
|
+
on-call, pager -> oncall
|
|
23
|
+
money, salary, savings, budget -> finances
|
package/templates/hot.md
ADDED
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
---
|
|
2
|
+
type: hot
|
|
3
|
+
tags: ["hot"]
|
|
4
|
+
updated: ""
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Hot — what's active right now
|
|
8
|
+
|
|
9
|
+
> The current-context primer. Keep it under ~500 tokens.
|
|
10
|
+
> When it grows past a screen, promote detail into the relevant project note.
|
|
11
|
+
|
|
12
|
+
## ⚠ Needs review
|
|
13
|
+
<!-- `imprnt hot` prints open needs-review items above this file. Clear them as you go. -->
|
|
14
|
+
|
|
15
|
+
## Review-due (optional)
|
|
16
|
+
<!-- perishable facts with a `review_by:` that's come due. Surfaced on demand only — never a loop. -->
|
|
17
|
+
|
|
18
|
+
## Active project
|
|
19
|
+
<!-- one line: what you're driving this week, link [[projects/...]] -->
|
|
20
|
+
|
|
21
|
+
## Recent decisions
|
|
22
|
+
<!-- 2-4 bullets, most recent first -->
|
|
23
|
+
|
|
24
|
+
## Waiting on
|
|
25
|
+
<!-- who / what you're blocked by -->
|
|
26
|
+
|
|
27
|
+
## Next
|
|
28
|
+
<!-- the single next action -->
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
---
|
|
2
|
+
type: moc
|
|
3
|
+
tags: ["index"]
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Vault — Map of Content
|
|
7
|
+
|
|
8
|
+
The entry point. Link the things that matter; let `recall` find the rest.
|
|
9
|
+
Sections mirror the 8 entity types (folders). Topic is a tag, never a section here.
|
|
10
|
+
|
|
11
|
+
## People
|
|
12
|
+
<!-- - [[people/...]] -->
|
|
13
|
+
|
|
14
|
+
## Orgs
|
|
15
|
+
<!-- institutions: employer, insurer, Behörde, bank, vendor — [[orgs/...]] -->
|
|
16
|
+
|
|
17
|
+
## Projects
|
|
18
|
+
<!-- bounded efforts with a status — [[projects/...]] -->
|
|
19
|
+
|
|
20
|
+
## Things
|
|
21
|
+
<!-- owned/used objects: tool, service, dataset, asset, product, policy — [[things/...]] -->
|
|
22
|
+
|
|
23
|
+
## Principles
|
|
24
|
+
<!-- held positions: belief, model, frame, strategy, mission, narrative — [[principles/...]] -->
|
|
25
|
+
|
|
26
|
+
## Notes
|
|
27
|
+
<!-- reference knowledge that isn't an entity — [[notes/...]] -->
|
|
28
|
+
|
|
29
|
+
## Mistakes (read before related work)
|
|
30
|
+
<!-- - [[mistakes/...]] -->
|
|
31
|
+
|
|
32
|
+
## Recent events
|
|
33
|
+
<!-- dated occurrences — [[events/...]] -->
|
package/templates/log.md
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
# imprnt vault (the user's long-term memory)
|
|
2
|
+
|
|
3
|
+
This user keeps a persistent knowledge vault at {{VAULT_PROJECT}} holding people, orgs, projects,
|
|
4
|
+
decisions, finances, health, and history.
|
|
5
|
+
|
|
6
|
+
- When the user references their own world (a person, a past decision, a deadline, anything not
|
|
7
|
+
in this workspace), search the vault before saying you don't know:
|
|
8
|
+
`imprnt recall "<keywords>"`, then read the top hits.
|
|
9
|
+
- Before filing or editing ANYTHING in the vault, run `imprnt context` and follow what it prints.
|
|
10
|
+
Never write a vault note without it.
|
|
11
|
+
- The vault is private data. Never copy its contents into committed files, code, or external
|
|
12
|
+
services.
|