skillwiki 0.10.22 → 0.10.23

package/templates/SCHEMA.md

@@ -12,7 +12,7 @@ This sets the language of generated page prose. Frontmatter keys, schema section
 
 ## Layers
 
-- `raw/` — immutable source material (never modify after ingest).
+- `raw/` — immutable evidence. Never rewrite existing content/frontmatter or autonomously remove an object. Attended rename/relocate/archive/dedup is allowed only when exact bytes remain somewhere under `raw/`.
 - `entities/`, `concepts/`, `comparisons/`, `queries/` — typed knowledge unified across origin via `provenance:`.
 - `meta/` — cross-project synthesis (notes naming ≥2 projects).
 - `projects/{slug}/` — per-project lifecycle workspace.
@@ -42,6 +42,7 @@ Rule: every tag on every page MUST appear in this taxonomy. Add new tags here fi
 - DO NOT create a page for passing mentions.
 - Split a page when it exceeds ~200 lines.
 - Archive a page when fully superseded — move to `_archive/`, remove from `index.md`.
+- Raw source lifecycle is separate: preserve archived sources under `raw/archived/{articles,papers,transcripts}/` and preserved duplicates under `raw/duplicates/{articles,papers,transcripts}/`. Legacy `_archive/raw/` is read-only compatibility, never a new-write target.
 
 ## Update Policy
 
@@ -71,8 +72,9 @@ Obsidian-compatible Mermaid rules:
 
 ## Ad-Hoc Capture Format
 
-Ad-hoc captures are mutable working notes created during development
+Ad-hoc captures are immutable completed evidence created during development
 (via `/wiki-add-task` or filesystem drop). They live in `raw/transcripts/`.
+Corrections create a new capture or a maintained work-item note; never edit an existing transcript.
 
 ### Frontmatter
 
@@ -98,15 +100,16 @@ project:          # optional: "[[slug]]" for cross-reference
 | Aspect | Ad-Hoc Capture | Ingested Source |
 |--------|----------------|-----------------|
 | Location | `raw/transcripts/` | `raw/articles/`, `raw/papers/`, etc. |
-| Mutability | Mutable (working notes) | Immutable after ingest |
+| Mutability | Immutable after capture | Immutable after ingest |
 | `sha256` | **Omitted** | Required |
 | `created` | Required | Use `ingested` |
 | Entry | `/wiki-add-task`, filesystem drop | `wiki-ingest`, `skillwiki fetch` |
 
 ## Obsidian Integration
 
-- **Attachment folder:** `raw/assets/` — binary assets (images, diagrams) live here.
-  Set Obsidian's "Attachment folder path" to `raw/assets` for automatic filing.
+- **Stable asset pool:** binary assets may use any flat or URL-friendly nested path under `raw/assets/`; no fixed internal taxonomy such as papers/transcripts is required.
+- Use explicit vault-root embeds such as `![[raw/assets/example/diagram.png]]` so Obsidian preview and GitHub browsing remain unambiguous.
+- Resolve and preview a new local embed before finalizing its raw capture. Once referenced, the asset path freezes; source archive/dedup does not move it. Remote HTTP(S) images remain external dependencies unless separately captured.
 - **Dataview queries** (read-only; do not replace index.md):
 
 ```dataview

package/templates/web-clipper/llm-wiki-clippings.json

@@ -0,0 +1,56 @@
+{
+  "schemaVersion": "0.1.0",
+  "name": "llm-wiki-clippings",
+  "behavior": "create",
+  "noteContentFormat": "{{content}}",
+  "properties": [
+    {
+      "name": "title",
+      "value": "{{title}}",
+      "type": "text"
+    },
+    {
+      "name": "source_url",
+      "value": "{{url}}",
+      "type": "text"
+    },
+    {
+      "name": "author",
+      "value": "{{author|split:\", \"|wikilink|join}}",
+      "type": "multitext"
+    },
+    {
+      "name": "published",
+      "value": "{{published|date:\"YYYY-MM-DD\"}}",
+      "type": "date"
+    },
+    {
+      "name": "created",
+      "value": "{{date|date:\"YYYY-MM-DD\"}}",
+      "type": "date"
+    },
+    {
+      "name": "ingested",
+      "value": "{{date|date:\"YYYY-MM-DD\"}}",
+      "type": "date"
+    },
+    {
+      "name": "ingested_by",
+      "value": "manual",
+      "type": "text"
+    },
+    {
+      "name": "description",
+      "value": "{{description}}",
+      "type": "text"
+    },
+    {
+      "name": "tags",
+      "value": "clippings",
+      "type": "multitext"
+    }
+  ],
+  "triggers": [],
+  "noteNameFormat": "{{date|date:\"YYYY-MM-DD\"}}-{{title|safe_name}}",
+  "path": "raw/articles"
+}

package/templates/web-clipper/readme.txt

@@ -0,0 +1,16 @@
+SkillWiki Obsidian Web Clipper template
+
+1. Open Obsidian Web Clipper Settings in the browser profile that will capture this vault.
+2. Import llm-wiki-clippings.json.
+3. Confirm the destination path is raw/articles and the behavior is Create.
+4. Repeat the import for every browser profile that should capture into this vault.
+
+The generic template preserves Web Clipper's {{content}} output. Remote HTTP(S)
+images remain external dependencies and are not guaranteed to be downloaded or
+available offline.
+
+For attended local asset materialization, an agent may choose any URL-friendly
+path under raw/assets/. Write the asset first, use an explicit vault-qualified
+Obsidian embed such as ![[raw/assets/example/diagram.png]], verify the target and
+preview, and only then finalize the new raw capture. Referenced asset paths are
+stable after capture.