skillwiki 0.10.22 → 0.10.24

package/skills/wiki-remove/SKILL.md

@@ -1,13 +1,14 @@
 ---
 name: wiki-remove
-description: Hard-delete a vault path with a durable delete-intent tombstone so S3+snapshot cannot resurrect it. Prefer skillwiki remove; if CLI missing, failsafe-git via private GitHub.
+description: Remove maintained vault paths with durable delete intent; raw evidence requires the separate attended exact-target sources dispose workflow.
 ---
 
 # wiki-remove
 
 ## When This Skill Activates
 
-- User wants to permanently remove a vault path (not archive-for-reference).
+- User wants to permanently remove a maintained vault path (not archive-for-reference).
+- User explicitly requests permanent disposal of one exact raw object.
 - Cleanup of stale pages that should not return via snapshot resurrection.
 - User says hard delete, remove for real, stop resurrecting.
 
@@ -17,7 +18,7 @@ If `skillwiki` is available: run `skillwiki lang` at the start. Otherwise defaul
 
 ## Pre-orientation
 
-Read SCHEMA/index only as needed. Confirm full vault-relative path with the user before delete.
+Read SCHEMA/index only as needed. Confirm the full vault-relative path. First classify the target as maintained content or `raw/**` evidence.
 
 ## Probe (required)
 
@@ -33,7 +34,7 @@ Read SCHEMA/index only as needed. Confirm full vault-relative path with the user
 
 Do not auto `npm install -g skillwiki` in headless/goal/satellite sessions.
 
-## PRIMARY steps
+## PRIMARY — maintained pages
 
 1. Resolve vault: `skillwiki path`.
 2. Confirm path with user.
@@ -44,9 +45,22 @@ Do not auto `npm install -g skillwiki` in headless/goal/satellite sessions.
 5. Commit + push via normal wiki-sync / git (tombstone + deletion must reach private `main` for durability).
 6. Report MODE=primary, paths, and whether remote-delete ran.
 
+`skillwiki remove` must refuse every `raw/**` target. Do not bypass that refusal.
+
+## PRIMARY — exact raw disposal
+
+Permanent raw disposal is exceptional and never inferred from cleanup, dedup, stale, archive, or reingest intent.
+
+1. Require an explicit user request naming one exact raw file and a reason. Refuse basenames, globs, directories, symlinks, batches, and inferred targets.
+2. Run `skillwiki sources dispose <exact-raw-path> [vault] --reason "<text>"`.
+3. Present the preview: complete-file SHA-256, byte size, typed/other/asset inbound references, delete-intent path, recoverability statement, operation ID, and approval token.
+4. Only in the same attended session, after the user approves that exact preview, run the identical command with `--write --approve <token>`.
+5. The command revalidates bytes and inbound references under the managed lock, writes append-only approval/completion events plus durable delete intent, then removes the exact object.
+6. Scheduled/headless disposal is always refused. A stale token never authorizes changed state.
+
 ## FAILSAFE-GIT steps (no skillwiki CLI)
 
-Agent **must** have git (and preferably gh) access to private vault remote.
+Agent **must** have git (and preferably gh) access to private vault remote. This fallback is for maintained pages only. If the target is under `raw/`, fail closed until `skillwiki sources dispose` is available; never reproduce raw disposal by hand.
 
 1. Confirm path with user. Set `PATH_REL` (vault-relative, no `..`).
 2. Write tombstone `meta/delete-intents/<slug>.json` where slug is path with `/` → `__`, e.g. `summaries/foo.md` → `summaries__foo.md.json`:
@@ -83,6 +97,7 @@ Delete-Source: failsafe-git
 - FAIL CLOSED (no CLI and no private git access).
 - Push to private wiki fails.
 - Path invalid or under `_archive/` without explicit restore/remove policy.
+- Raw target cannot be processed by the attended exact-target CLI flow.
 
 ## Forbidden
 
@@ -90,6 +105,8 @@ Delete-Source: failsafe-git
 - Force-push.
 - Unbounded `rclone sync` / mass remote delete.
 - Claiming fleet delete complete without tombstone on `origin/main` (and push success).
+- Passing raw paths to ordinary `skillwiki remove`, or using FAILSAFE-GIT/bare filesystem deletion for raw evidence.
+- Scheduled, headless, batch, glob, directory, basename-inferred, or stale-token raw disposal.
 
 ## Reversibility
 

package/skills/wiki-sync/SKILL.md

@@ -162,7 +162,7 @@ git -C "$VAULT" rebase --continue
 
 **Prevention**:
 - Sync more frequently — don't let local fall >5 commits behind origin/main
-- Bundle archive commits — `skillwiki archive --batch` groups 5-10 transcript archives into one commit, reducing rebase surface
+- Prefer smaller, attended exact-target archive operations and sync promptly; there is no batch raw-archive apply mode.
 - For vaults with snapshot cron, prefer smaller, more frequent syncs over large batch rebases
 
 See `concepts/wiki-sync-rebase-conflict-storm-pattern.md` for detailed analysis.
@@ -220,7 +220,7 @@ Some older deployments separated a cloud-backed live vault from a Git snapshot w
 - Pushing when lint errors exist.
 - Auto-resolving body conflicts without user review.
 - Force-pushing (`git push --force`).
-- Modifying files in `raw/` to resolve conflicts (N9 — archive and re-ingest instead).
+- Rewriting raw content/frontmatter to resolve conflicts. Preserve-moves must stay under `raw/` (normally `raw/archived/` or `raw/duplicates/`) and require an attended approved structural command; scheduled/headless sync remains report-only.
 - Stashing without the `wiki-sync:...` name format (breaks peer detection).
 - Force-deleting a peer's lockfile (use `--force` only if peer is confirmed dead).
 - Authoring, copying, editing, staging, committing, pulling, resetting, or pushing agent changes in `/root/wiki-git` (or any configured snapshot worktree).
@@ -242,4 +242,3 @@ Drop a local commit from rebase only when every path is proven present on the ta
 - CLI: `skillwiki sync lint-delta <vault> --base-ref origin/main`
 - Block publication only when `new_errors > 0`; inherited full debt remains visible.
 - Missing/malformed delta evidence blocks (never silent lint skip).
-

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.