skillwiki 0.10.78 → 0.10.79

package/dist/cli.js

@@ -1456,13 +1456,13 @@ function mergeLogConflictStages(input) {
   const out = [];
   const deduped = [];
   const push = (entry) => {
-    const marker2 = publishId(entry);
-    if (marker2) {
-      if (seenMarkers.has(marker2)) {
-        deduped.push(marker2);
+    const marker = publishId(entry);
+    if (marker) {
+      if (seenMarkers.has(marker)) {
+        deduped.push(marker);
         return;
       }
-      seenMarkers.add(marker2);
+      seenMarkers.add(marker);
     } else if (seenExact.has(entry)) {
       return;
     } else {
@@ -1768,10 +1768,27 @@ import { join as join10 } from "path";
 function day(event) {
   return event.occurred_at.slice(0, 10);
 }
-function marker(event) {
+function renderLogEventMarker(event) {
   return `<!-- skillwiki-log-event:${event.operation_id} -->`;
 }
-function bodyFor(event) {
+function verbatimField(event) {
+  if (event.kind === "legacy-log-entry" && typeof event.metadata.legacy_markdown === "string") {
+    return event.metadata.legacy_markdown;
+  }
+  if (event.kind === "log-append" && typeof event.metadata.appended_markdown === "string") {
+    return event.metadata.appended_markdown;
+  }
+  return void 0;
+}
+function verbatimMarkdown(raw, event) {
+  const text = raw.trimEnd();
+  const mark = renderLogEventMarker(event);
+  return text.includes(mark) ? text : `${text}
+${mark}`;
+}
+function renderLogEventBody(event) {
+  const raw = verbatimField(event);
+  if (raw !== void 0) return verbatimMarkdown(raw, event);
   if (event.kind === "page-publish" || event.kind === "project-page-publish") {
     const tax = Array.isArray(event.metadata.taxonomy_added) ? event.metadata.taxonomy_added : [];
     const project = typeof event.metadata.project === "string" ? event.metadata.project : void 0;
@@ -1782,12 +1799,6 @@ function bodyFor(event) {
       event.note ? `- Note: ${event.note}` : ""
     ].filter(Boolean).join("\n");
   }
-  if (event.kind === "legacy-log-entry" && typeof event.metadata.legacy_markdown === "string") {
-    const legacy = event.metadata.legacy_markdown.trimEnd();
-    if (legacy.includes(marker(event))) return legacy;
-    return `${legacy}
-${marker(event)}`;
-  }
   if (event.kind === "session-brief" || event.kind === "archive" || event.kind === "remove" || event.kind === "log-entry") {
     return [
       `- Target: ${event.target}`,
@@ -1817,12 +1828,18 @@ function renderLogProjection(events) {
     ""
   ];
   for (const event of ordered) {
-    if (event.kind === "legacy-log-entry" && typeof event.metadata.legacy_markdown === "string") {
-      const block = bodyFor(event);
+    if (verbatimField(event) !== void 0) {
+      const block = renderLogEventBody(event);
       lines.push(block.endsWith("\n") ? block.trimEnd() : block, "");
       continue;
     }
-    lines.push(`## [${day(event)}] ${event.kind} | ${event.target}`, "", bodyFor(event), marker(event), "");
+    lines.push(
+      `## [${day(event)}] ${event.kind} | ${event.target}`,
+      "",
+      renderLogEventBody(event),
+      renderLogEventMarker(event),
+      ""
+    );
   }
   return `${lines.join("\n").replace(/\n+$/, "")}
 `;
@@ -6292,8 +6309,8 @@ async function runPipelinePreview(strategy, prepared, vault) {
   let logAppended;
   try {
     const logText = await readFile13(logPath, "utf8");
-    const marker2 = strategy.publisherKind === "page" ? `<!-- skillwiki-page-publish:${prepared.operationId} -->` : `<!-- skillwiki-project-page-publish:${prepared.operationId} -->`;
-    logAppended = !logText.includes(marker2);
+    const marker = strategy.publisherKind === "page" ? `<!-- skillwiki-page-publish:${prepared.operationId} -->` : `<!-- skillwiki-project-page-publish:${prepared.operationId} -->`;
+    logAppended = !logText.includes(marker);
   } catch (error) {
     const result = err("FILE_NOT_FOUND", { path: logPath, ...strategy.publisherKind === "page" ? { message: String(error) } : {} });
     return { exitCode: ExitCode.FILE_NOT_FOUND, result };

package/package.json

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

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

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

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

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.78",
+  "version": "0.10.79",
   "description": "Project-aware Karpathy-style knowledge base for Codex with 21 prompt-only skills backed by the deterministic skillwiki CLI.",
   "author": {
     "name": "karlorz",

package/skills/.cursor-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "skillwiki",
-  "version": "0.10.78",
+  "version": "0.10.79",
   "description": "Project-aware Karpathy-style knowledge base: 21 prompt-only skills (wiki-*, proj-*, using-skillwiki, skillwiki-mcp) backed by HTTP MCP wiki_capture.",
   "author": {
     "name": "karlorz"

package/skills/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skillwiki/skills",
-  "version": "0.10.78",
+  "version": "0.10.79",
   "private": true,
   "files": [
     "wiki-*",

package/skills/skills/skillwiki-mcp/SKILL.md

@@ -33,7 +33,7 @@ Remotes still on a pre-HTTP-MCP plugin or CLI must upgrade the plugin channel (a
 On leaf hosts, wiki captures go through MCP. Do **not** write `raw/transcripts/` or `log.md` as local files.
 
 1. Call MCP `wiki_capture` with `kind` (`task` | `idea` | `bug` | `note`), `project`, `title`, and `content`. Optional `agent_note`.
-2. Call MCP `wiki_log_append` when a structural `log.md` line is needed. Pass append-only `content`. Do not rewrite log history.
+2. Call MCP `wiki_log_append` when a structural `log.md` line is needed. Pass append-only `content` (optional `operation_id` is 64 hex). Success returns a receipt (`operation_id`, `event_path`, hashes, `s3_verified`). Verify the exact block via `wiki_read_page(event_path)`. Do not require reading `log.md`. If `log.md` is over 256 KiB, full `wiki_read_page("log.md")` returns `PAGE_TOO_LARGE`; use `tail_bytes` only to browse the newest end.
 3. **Feature-detect work-item and page-publish tools**:
    - When the server advertises `wiki_workitem_write`: use it to create, mutate, or close work items under `projects/<slug>/work/**` or update `projects/<slug>/knowledge.md`, and to save Layer-3 workspace markdown: `projects/<slug>/README.md`, `projects/<slug>/architecture/**/*.md`, `projects/<slug>/requirements/**/*.md`, `projects/<slug>/compound/**/*.md`. Pass `path`, `content`, and `base_sha256` of existing bytes (from `wiki_read_page` or local mirror). On `FILE_CHANGED`, re-read and retry once. Deployed servers that predate the workspace-family allowlist deny those paths — treat that `PATH_DENIED` as "server predates this release"; STOP, do not fall back.
    - When the server advertises `wiki_page_publish`: use it to publish typed Layer-2 pages (`entities/`, `concepts/`, `comparisons/`, `queries/`, `meta/`) using the same CAS protocol.

package/skills/skills/using-skillwiki/SKILL.md

@@ -192,7 +192,7 @@ If the vault has `.WIKI_GIT_FROZEN`:
 | `wiki-remove` | Remove maintained pages; exact raw disposal uses the separate attended `sources dispose` flow |
 | `wiki-reingest` | Detect drift in raw sources (sha256 comparison) and re-ingest updated content |
 | `wiki-add-task` | Quick-capture ideas, bugs, tasks, notes (captures via wiki_capture on leaf hosts; local raw/transcripts/ only on authoring hosts) |
-| `skillwiki-mcp` | HTTP MCP captures (`wiki_capture` / `wiki_log_append`); never local raw/transcripts on leaf hosts |
+| `skillwiki-mcp` | HTTP MCP captures (`wiki_capture` / `wiki_log_append`); never local raw/transcripts on leaf hosts. `wiki_log_append` returns a receipt; verify via `wiki_read_page(event_path)`. Use `wiki_read_page` `tail_bytes` to browse oversized `log.md`. |
 | `wiki-adapter-prd` | Map foreign PRD formats (CodeStable, RFC, AIDE, Hermes) into vault pages |
 | `proj-init` | Bootstrap a project workspace (README, requirements, architecture) |
 | `proj-work` | Open or run a work item under a project's work/ directory |

package/skills/skills/using-skillwiki/activation.md

@@ -80,7 +80,7 @@ Mutating tools (wiki_workitem_write, wiki_page_publish) enforce CAS concurrency
 
 ### Capture Kinds
 Ad-hoc records via wiki_capture require kind in: task | idea | bug | note.
-Captures append remotely to raw/transcripts/ and never overwrite existing files. Use wiki_log_append for append-only log entries.
+Captures append remotely to raw/transcripts/ and never overwrite existing files. Use wiki_log_append for append-only log entries. Success returns a receipt; verify via wiki_read_page(event_path). Do not require reading log.md. wiki_read_page accepts optional tail_bytes for browsing oversized pages.
 
 ### Sensitive Content
 Never send credentials, API keys, auth tokens, passwords, or PII. Redact sensitive values using [REDACTED:<kind>] (e.g. [REDACTED:token]) before writing.

package/skills/skillwiki-mcp/SKILL.md

@@ -33,7 +33,7 @@ Remotes still on a pre-HTTP-MCP plugin or CLI must upgrade the plugin channel (a
 On leaf hosts, wiki captures go through MCP. Do **not** write `raw/transcripts/` or `log.md` as local files.
 
 1. Call MCP `wiki_capture` with `kind` (`task` | `idea` | `bug` | `note`), `project`, `title`, and `content`. Optional `agent_note`.
-2. Call MCP `wiki_log_append` when a structural `log.md` line is needed. Pass append-only `content`. Do not rewrite log history.
+2. Call MCP `wiki_log_append` when a structural `log.md` line is needed. Pass append-only `content` (optional `operation_id` is 64 hex). Success returns a receipt (`operation_id`, `event_path`, hashes, `s3_verified`). Verify the exact block via `wiki_read_page(event_path)`. Do not require reading `log.md`. If `log.md` is over 256 KiB, full `wiki_read_page("log.md")` returns `PAGE_TOO_LARGE`; use `tail_bytes` only to browse the newest end.
 3. **Feature-detect work-item and page-publish tools**:
    - When the server advertises `wiki_workitem_write`: use it to create, mutate, or close work items under `projects/<slug>/work/**` or update `projects/<slug>/knowledge.md`, and to save Layer-3 workspace markdown: `projects/<slug>/README.md`, `projects/<slug>/architecture/**/*.md`, `projects/<slug>/requirements/**/*.md`, `projects/<slug>/compound/**/*.md`. Pass `path`, `content`, and `base_sha256` of existing bytes (from `wiki_read_page` or local mirror). On `FILE_CHANGED`, re-read and retry once. Deployed servers that predate the workspace-family allowlist deny those paths — treat that `PATH_DENIED` as "server predates this release"; STOP, do not fall back.
    - When the server advertises `wiki_page_publish`: use it to publish typed Layer-2 pages (`entities/`, `concepts/`, `comparisons/`, `queries/`, `meta/`) using the same CAS protocol.

package/skills/using-skillwiki/SKILL.md

@@ -192,7 +192,7 @@ If the vault has `.WIKI_GIT_FROZEN`:
 | `wiki-remove` | Remove maintained pages; exact raw disposal uses the separate attended `sources dispose` flow |
 | `wiki-reingest` | Detect drift in raw sources (sha256 comparison) and re-ingest updated content |
 | `wiki-add-task` | Quick-capture ideas, bugs, tasks, notes (captures via wiki_capture on leaf hosts; local raw/transcripts/ only on authoring hosts) |
-| `skillwiki-mcp` | HTTP MCP captures (`wiki_capture` / `wiki_log_append`); never local raw/transcripts on leaf hosts |
+| `skillwiki-mcp` | HTTP MCP captures (`wiki_capture` / `wiki_log_append`); never local raw/transcripts on leaf hosts. `wiki_log_append` returns a receipt; verify via `wiki_read_page(event_path)`. Use `wiki_read_page` `tail_bytes` to browse oversized `log.md`. |
 | `wiki-adapter-prd` | Map foreign PRD formats (CodeStable, RFC, AIDE, Hermes) into vault pages |
 | `proj-init` | Bootstrap a project workspace (README, requirements, architecture) |
 | `proj-work` | Open or run a work item under a project's work/ directory |

package/skills/using-skillwiki/activation.md

@@ -80,7 +80,7 @@ Mutating tools (wiki_workitem_write, wiki_page_publish) enforce CAS concurrency
 
 ### Capture Kinds
 Ad-hoc records via wiki_capture require kind in: task | idea | bug | note.
-Captures append remotely to raw/transcripts/ and never overwrite existing files. Use wiki_log_append for append-only log entries.
+Captures append remotely to raw/transcripts/ and never overwrite existing files. Use wiki_log_append for append-only log entries. Success returns a receipt; verify via wiki_read_page(event_path). Do not require reading log.md. wiki_read_page accepts optional tail_bytes for browsing oversized pages.
 
 ### Sensitive Content
 Never send credentials, API keys, auth tokens, passwords, or PII. Redact sensitive values using [REDACTED:<kind>] (e.g. [REDACTED:token]) before writing.