skillwiki 0.0.1 → 0.2.0-beta.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/dist/cli.js +1350 -0
- package/package.json +20 -23
- package/templates/SCHEMA.md +53 -0
- package/templates/index.md +21 -0
- package/templates/log.md +9 -0
- package/templates/project-README.md +14 -0
- package/README.md +0 -3
- package/index.js +0 -3
package/package.json
CHANGED
|
@@ -1,30 +1,27 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "skillwiki",
|
|
3
|
-
"version": "0.0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
"
|
|
7
|
-
"doc": "docs"
|
|
8
|
-
},
|
|
3
|
+
"version": "0.2.0-beta.2",
|
|
4
|
+
"type": "module",
|
|
5
|
+
"bin": { "skillwiki": "dist/cli.js" },
|
|
6
|
+
"files": ["dist", "templates", "README.md"],
|
|
9
7
|
"scripts": {
|
|
10
|
-
"
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
"
|
|
14
|
-
"url": "git+https://github.com/karlorz/llm-wiki.git"
|
|
8
|
+
"build": "tsup",
|
|
9
|
+
"test": "vitest run",
|
|
10
|
+
"test:watch": "vitest",
|
|
11
|
+
"typecheck": "tsc --noEmit"
|
|
15
12
|
},
|
|
16
|
-
"
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
"bugs": {
|
|
21
|
-
"url": "https://github.com/karlorz/llm-wiki/issues"
|
|
13
|
+
"dependencies": {
|
|
14
|
+
"commander": "^12.1.0",
|
|
15
|
+
"js-yaml": "^4.1.0",
|
|
16
|
+
"zod": "^3.23.0"
|
|
22
17
|
},
|
|
23
|
-
"
|
|
24
|
-
|
|
25
|
-
"
|
|
18
|
+
"devDependencies": {
|
|
19
|
+
"@skillwiki/shared": "*",
|
|
20
|
+
"@types/js-yaml": "^4.0.9",
|
|
21
|
+
"@types/node": "^20.12.0",
|
|
22
|
+
"tsup": "^8.3.0",
|
|
23
|
+
"typescript": "^5.7.0",
|
|
24
|
+
"vitest": "^2.1.0"
|
|
26
25
|
},
|
|
27
|
-
"
|
|
28
|
-
"index.js"
|
|
29
|
-
]
|
|
26
|
+
"engines": { "node": ">=20" }
|
|
30
27
|
}
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
# Vault Schema
|
|
2
|
+
|
|
3
|
+
## Domain
|
|
4
|
+
|
|
5
|
+
{{DOMAIN}}
|
|
6
|
+
|
|
7
|
+
## Output Language
|
|
8
|
+
|
|
9
|
+
{{WIKI_LANG}}
|
|
10
|
+
|
|
11
|
+
This sets the language of generated page prose. Frontmatter keys, schema section headers, file names, and log/index structural lines remain English (parser and Hermes wire-compat invariant).
|
|
12
|
+
|
|
13
|
+
## Layers
|
|
14
|
+
|
|
15
|
+
- `raw/` — immutable source material (never modify after ingest).
|
|
16
|
+
- `entities/`, `concepts/`, `comparisons/`, `queries/` — typed knowledge unified across origin via `provenance:`.
|
|
17
|
+
- `meta/` — cross-project synthesis (notes naming ≥2 projects).
|
|
18
|
+
- `projects/{slug}/` — per-project lifecycle workspace.
|
|
19
|
+
|
|
20
|
+
## Frontmatter
|
|
21
|
+
|
|
22
|
+
Four shapes: typed-knowledge, raw, work-item, compound. See spec for full Zod schemas.
|
|
23
|
+
|
|
24
|
+
## Tag Taxonomy
|
|
25
|
+
|
|
26
|
+
```yaml
|
|
27
|
+
taxonomy:
|
|
28
|
+
{{TAXONOMY_YAML}}
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
Rule: every tag on every page MUST appear in this taxonomy. Add new tags here first, then use them.
|
|
32
|
+
|
|
33
|
+
## Page Thresholds
|
|
34
|
+
|
|
35
|
+
- Create a page when an entity/concept appears in 2+ sources OR is central to one source.
|
|
36
|
+
- Add to an existing page when overlap with covered material.
|
|
37
|
+
- DO NOT create a page for passing mentions.
|
|
38
|
+
- Split a page when it exceeds ~200 lines.
|
|
39
|
+
- Archive a page when fully superseded — move to `_archive/`, remove from `index.md`.
|
|
40
|
+
|
|
41
|
+
## Update Policy
|
|
42
|
+
|
|
43
|
+
- Newer sources generally supersede older ones (compare dates).
|
|
44
|
+
- Genuine contradictions: note both positions with dates and sources.
|
|
45
|
+
- Mark in frontmatter: `contested: true` and `contradictions: [other-page]`.
|
|
46
|
+
- Flag for user review during lint.
|
|
47
|
+
|
|
48
|
+
## Conventions
|
|
49
|
+
|
|
50
|
+
- File names: lowercase-hyphenated, no spaces.
|
|
51
|
+
- Wikilinks in YAML: quoted, `"[[name]]"`. Body wikilinks: unquoted `[[name]]`.
|
|
52
|
+
- Citations in body: `^[raw/...]` markers; every entry in `sources:` MUST appear in body.
|
|
53
|
+
- sha256 in `raw/` frontmatter is computed by `skillwiki hash` over body bytes after closing `---`.
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# Vault Index
|
|
2
|
+
|
|
3
|
+
> Last updated: {{INIT_DATE}} | Total pages: 0
|
|
4
|
+
|
|
5
|
+
## Entities
|
|
6
|
+
<!-- entities listed here -->
|
|
7
|
+
|
|
8
|
+
## Concepts
|
|
9
|
+
<!-- concepts listed here -->
|
|
10
|
+
|
|
11
|
+
## Comparisons
|
|
12
|
+
<!-- comparisons listed here -->
|
|
13
|
+
|
|
14
|
+
## Queries
|
|
15
|
+
<!-- queries listed here -->
|
|
16
|
+
|
|
17
|
+
## Projects
|
|
18
|
+
<!-- registered projects listed here -->
|
|
19
|
+
|
|
20
|
+
## Meta
|
|
21
|
+
<!-- cross-project synthesis listed here -->
|
package/templates/log.md
ADDED
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
# Vault Log
|
|
2
|
+
|
|
3
|
+
Chronological action log. Newest entries last. Skill writes append entries; lint may rotate.
|
|
4
|
+
|
|
5
|
+
## [{{INIT_DATE}}] create | Wiki initialized
|
|
6
|
+
|
|
7
|
+
- Domain: {{DOMAIN}}
|
|
8
|
+
- Output language: {{WIKI_LANG}}
|
|
9
|
+
- Structure created with SCHEMA.md, index.md, log.md
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
# Project: {{slug}}
|
|
2
|
+
|
|
3
|
+
**Created:** {{date}}
|
|
4
|
+
|
|
5
|
+
## Intent
|
|
6
|
+
|
|
7
|
+
<!-- 2-4 sentences: what this project is and why it exists -->
|
|
8
|
+
|
|
9
|
+
## Layout
|
|
10
|
+
|
|
11
|
+
- `requirements/` — what we're building (incl. roadmap docs).
|
|
12
|
+
- `architecture/` — how it's designed (incl. ADRs).
|
|
13
|
+
- `work/YYYY-MM-DD-{slug}/` — per-work-item folders containing `spec.md`, `plan.md`, `log.md`.
|
|
14
|
+
- `compound/` — project-local concrete learnings.
|
package/README.md
DELETED
package/index.js
DELETED