skillwiki 0.4.0 → 0.4.2

package/dist/cli.js

@@ -2567,9 +2567,20 @@ async function runLint(input) {
       workItemDirs.set(dir, pages);
     }
     for (const [dir, pages] of workItemDirs) {
-      const hasSpec = pages.some((p) => p.relPath.endsWith("/spec.md"));
+      const specPage = pages.find((p) => p.relPath.endsWith("/spec.md"));
       const hasPlan = pages.some((p) => p.relPath.endsWith("/plan.md"));
-      if (hasSpec && !hasPlan) {
+      let specStatus;
+      let specStarted;
+      if (specPage) {
+        const text = await readPage(specPage);
+        const fm = extractFrontmatter(text);
+        if (fm.ok) {
+          specStatus = fm.data.status;
+          specStarted = fm.data.started;
+        }
+      }
+      const isClosed = specStatus === "completed" || specStatus === "abandoned";
+      if (specPage && !hasPlan && !isClosed) {
         const lastSegment = dir.split("/").pop();
         const dateMatch = lastSegment.match(/^(\d{4}-\d{2}-\d{2})/);
         if (dateMatch) {
@@ -2579,13 +2590,8 @@ async function runLint(input) {
           }
         }
       }
-      for (const page of pages) {
-        if (!page.relPath.endsWith("/spec.md")) continue;
-        const text = await readPage(page);
-        const fm = extractFrontmatter(text);
-        if (fm.ok && fm.data.status === "in-progress" && !fm.data.started) {
-          workItemHealth.push(`${page.relPath}: in-progress without started date`);
-        }
+      if (specPage && specStatus === "in-progress" && !specStarted) {
+        workItemHealth.push(`${specPage.relPath}: in-progress without started date`);
       }
     }
     if (workItemHealth.length > 0) buckets.work_item_health = workItemHealth;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "type": "module",
   "bin": {
     "skillwiki": "dist/cli.js"

package/skills/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "skills": "./",
   "description": "Project-aware Karpathy-style knowledge base for Claude Code: 18 prompt-only skills (wiki-*, proj-*, using-skillwiki) backed by the deterministic `skillwiki` CLI.",
   "author": {

package/skills/.codex-plugin/plugin.json

@@ -0,0 +1,39 @@
+{
+  "name": "skillwiki",
+  "version": "0.4.2",
+  "description": "Project-aware Karpathy-style knowledge base for Codex with 18 prompt-only skills backed by the deterministic skillwiki CLI.",
+  "author": {
+    "name": "karlorz",
+    "url": "https://github.com/karlorz"
+  },
+  "homepage": "https://github.com/karlorz/llm-wiki",
+  "repository": "https://github.com/karlorz/llm-wiki",
+  "license": "MIT",
+  "keywords": [
+    "knowledge-base",
+    "wiki",
+    "codex",
+    "skills",
+    "obsidian",
+    "karpathy"
+  ],
+  "skills": "./",
+  "interface": {
+    "displayName": "SkillWiki",
+    "shortDescription": "Project-aware wiki skills for Codex agents",
+    "longDescription": "18 prompt-only skills (wiki-*, proj-*, using-skillwiki) for deterministic, project-aware knowledge workflows.",
+    "developerName": "karlorz",
+    "category": "Productivity",
+    "capabilities": [
+      "Read",
+      "Write"
+    ],
+    "websiteURL": "https://github.com/karlorz/llm-wiki",
+    "defaultPrompt": [
+      "Initialize a project wiki and schema for this repository.",
+      "Ingest this PRD and produce typed knowledge pages with provenance.",
+      "Run a vault lint pass and summarize the highest priority fixes."
+    ],
+    "brandColor": "#1f6feb"
+  }
+}

package/skills/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillwiki/skills",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "private": true,
   "files": [
     "wiki-*",
@@ -8,6 +8,7 @@
     "dev-loop-research",
     "using-skillwiki",
     ".claude-plugin",
+    ".codex-plugin",
     "hooks",
     "README.md"
   ]

package/templates/SCHEMA.md

@@ -64,6 +64,40 @@ Obsidian-compatible Mermaid rules:
 - Avoid `\n` in labels; use `<br/>` or single-line labels.
 - Keep node IDs ASCII and simple (`CMUX_DB`, `OC_GW`).
 
+## Ad-Hoc Capture Format
+
+Ad-hoc captures are mutable working notes created during development
+(via `/wiki-add-task` or filesystem drop). They live in `raw/transcripts/`.
+
+### Frontmatter
+
+```yaml
+---
+source_url:       # null for ad-hoc (locally originated)
+created: YYYY-MM-DD     # when capture was written
+ingested:          # filled by ingest pipeline (empty at creation)
+kind:             # idea | bug | task | note | other
+project:          # optional: "[[slug]]" for cross-reference
+---
+```
+
+### Fields
+
+- `created`: Date the ad-hoc capture was created. Set by `/wiki-add-task` or filesystem.
+- `ingested`: Date processed into typed knowledge. **Empty at creation.** Filled by `wiki-ingest`, `wiki-crystallize`.
+- `kind`: Capture type. Affects dev-loop routing (`bug`/`task` → work items; `idea` → knowledge development).
+- `project`: Optional project cross-reference. Enables `provenance_projects:` auto-linking.
+
+### vs Ingested Sources
+
+| Aspect | Ad-Hoc Capture | Ingested Source |
+|--------|----------------|-----------------|
+| Location | `raw/transcripts/` | `raw/articles/`, `raw/papers/`, etc. |
+| Mutability | Mutable (working notes) | 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.

package/templates/tpl-ad-hoc-capture.md

@@ -0,0 +1,8 @@
+---
+source_url:
+created: {{date:YYYY-MM-DD}}
+ingested:          # filled by ingest pipeline
+kind:             # idea | bug | task | note | other
+project:          # optional: "[[slug]]"
+---
+