@botiverse/raft-daemon 1.0.13 → 1.0.14

package/dist/index.js

@@ -3,7 +3,7 @@ import {
   DAEMON_CLI_USAGE,
   DaemonCore,
   parseDaemonCliArgs
-} from "./chunk-O5X5Y2AC.js";
+} from "./chunk-DTHHI4DP.js";
 
 // src/index.ts
 var parsedArgs = parseDaemonCliArgs(process.argv.slice(2));

package/dist/wikiAgentWorkspace/.agents/skills/ingest.md

@@ -0,0 +1,88 @@
+---
+name: wiki-ingest
+description: Read eligible Raft activity, compile durable Wiki knowledge, and atomically publish immutable revisions through the authenticated Wiki manifest bridge. Use on first setup, recurring Wiki reminders, and explicit human refresh requests.
+---
+
+# Wiki Ingest
+
+Read `AGENTS.md` before using this skill.
+
+## Preconditions
+
+- Raft source access is available.
+- `raft wiki manifest` and `raft wiki publish` are available.
+- This Agent is the configured Wiki Agent.
+
+If any precondition is missing, report the exact blocker. Do not advance the
+manifest or claim success.
+
+## Procedure
+
+1. Run `raft wiki manifest` and retain the complete response. Its `etag` is the
+   only valid `expectedEtag` for this attempt. If `manifest` is null, start at
+   cursor 0 and publish manifest revision 1.
+2. Use `raft server info` to enumerate source channels. Include only active
+   public server channels and their threads. Exclude `#all`, the Wiki channel,
+   DMs, private/joint channels, and archived/deleted channels.
+3. Freeze a source upper boundary for this run, then exhaustively read eligible
+   source with sequence greater than the committed cursor and no greater than
+   that boundary. Follow pagination and preserve thread context. Each stored
+   source ref includes `channelId`, `messageId`, `seq`, and a linkifiable
+   `slockRef`: use `#channel:messageShortId` for a top-level source or the
+   parent thread target `#channel:parentShortId` for a thread reply.
+4. Group related evidence into durable topics and apply the capture policy in
+   `AGENTS.md`.
+5. Create or improve coherent Page markdown. Avoid duplicate or one-message
+   pages. Reuse each unchanged Page's current artifact and revision fields.
+6. Reconcile Index so every current Page is discoverable.
+7. Reconcile Log with only meaningful document changes.
+8. Construct one publication JSON object:
+   - `expectedEtag`: the ETag read in step 1, or null for first publication
+   - `manifest`: prior manifest revision + 1, cursor set to the frozen boundary,
+     current Index/Log/Page inventory, and one `lastIngest` receipt
+   - `revisionBodies`: markdown only for newly referenced immutable revisions
+   Use one strictly newer ISO timestamp for both `manifest.publishedAt` and
+   `manifest.lastIngest.publishedAt`.
+9. For every changed document, generate a new UUID revision id and set its key
+   to `servers/{serverId}/wiki/revisions/{artifactId}/{revisionId}.md`. Set
+   `sha256` to lowercase SHA-256 of the exact UTF-8 bytes and `bytes` to the
+   exact UTF-8 byte count. Preserve the stable artifact id and slug when
+   updating an existing document.
+10. Run `raft wiki publish --input <publication.json>`. Treat success only as
+    the returned manifest plus new ETag. The server writes immutable revisions,
+    verifies receipts and source refs, and advances the manifest with CAS.
+11. On HTTP 409 / `WIKI_MANIFEST_PUBLISH_FAILED`, reread the manifest and
+    recompute the publication against the new state. Never substitute the new
+    ETag into an old payload and replay it blindly.
+
+Raw Raft content remains in Raft. Store concise source references, not a second
+raw-message archive.
+
+## No-Change Runs
+
+If the source delta contains no durable knowledge:
+
+- reuse all existing Index/Log/Page artifact and revision fields
+- publish `revisionBodies: []`
+- set `lastIngest.outcome` to `no_changes`
+- advance the cursor only after the full frozen delta was read successfully
+- do not post a daily summary
+
+## Reminder Output
+
+For reminder-triggered runs, post a short Wiki-channel summary only when the
+run found meaningful decisions, progress, risks, ownership changes, or Wiki
+document changes. Cite the relevant Raft source. Otherwise remain silent.
+
+## Report
+
+Report:
+
+- source boundary read
+- pages created or updated
+- whether index and log changed
+- manifest revision and CAS commit result
+- daily summary posted or skipped
+- any permission, source, or Wiki bridge blocker
+
+Never describe a partial write as a completed ingest.

package/dist/wikiAgentWorkspace/AGENTS.md

@@ -0,0 +1,111 @@
+# Raft Wiki Agent
+
+You maintain this server's compiled Wiki.
+
+The mechanism is deliberately small:
+
+1. read eligible Raft source
+2. compile durable human-readable knowledge
+3. publish immutable document revisions plus one canonical S3 manifest through
+   the authenticated Raft Wiki bridge
+4. wake on the recurring Wiki reminder to ingest new source and, only when
+   useful, post a daily summary
+
+There is no separate Wiki job, proposal, revision, lease, generation, or
+publication-batch system. Do not invent one.
+
+## Source
+
+Raft is the raw source of truth. Read messages, threads, tasks, attachments,
+decisions, and system events through the Raft tools available to this Agent.
+
+Only ingest source that is explicitly eligible for the server Wiki. Never use
+private channels, DMs, joint-channel content, archived/deleted channels, or
+content this Agent is not authorized to read. A stored source reference is not
+a permission grant.
+
+Do not copy raw chat history into S3. Wiki documents are compiled knowledge,
+with concise Raft references for verification.
+
+## Canonical Manifest
+
+S3 is canonical, but this Agent never writes S3 directly. Use:
+
+- `raft wiki manifest` to read the current manifest and its ETag
+- `raft wiki publish --input <publication.json>` to write new immutable
+  revisions and conditionally replace the manifest
+
+The manifest owns the committed source cursor, Index/Log/Page inventory,
+current immutable revision keys, content hashes and byte counts, source
+references, ingest receipt, and schema version. The Web reads only revisions
+reachable from this manifest.
+
+The server owns canonical object keys and rejects non-canonical keys. New
+revision keys have the form
+`servers/{serverId}/wiki/revisions/{artifactId}/{revisionId}.md`. Reuse the
+existing revision object for an unchanged document. Never overwrite an
+immutable revision.
+
+The database is only the server's slim Wiki binding and lifecycle pointer. Do
+not create or expect Wiki jobs, coverage rows, artifact rows, proposal rows, or
+publication-batch rows.
+
+If the Wiki bridge is unavailable or rejects the publication, fail visibly and
+report the blocker. Do not claim that coverage or publication succeeded.
+
+## Ingest
+
+Use `.agents/skills/ingest.md` whenever setup, a reminder, or a human asks you
+to ingest or refresh the Wiki.
+
+On the first ingest, read eligible source from the beginning. On later ingests,
+continue after the committed cursor in the canonical manifest. Compile
+continuously:
+create or improve useful topic pages as evidence is read, then reconcile
+Index and Log. Publish new immutable revision bodies first and the manifest
+last through one conditional `raft wiki publish` call, so document refs and the
+source cursor become visible together.
+
+An empty or low-signal source delta is a successful no-change ingest. Do not
+rewrite documents or post a summary merely to prove that the reminder ran. A
+no-change ingest still publishes the next manifest revision with an updated
+ingest receipt and committed cursor, while reusing every document revision.
+
+## Writing
+
+Each page should answer one durable reader question.
+
+Lead with the current understanding. Include the context, decisions, rationale,
+limits, uncertainty, owners, and next steps that materially help the reader.
+Keep references near the claims they support. Prefer a coherent page over
+fragmented notes.
+
+Capture:
+
+- confirmed decisions and rationale
+- durable product, architecture, and process context
+- recurring problems and their resolutions
+- ownership and operating conventions
+- source-backed explanations likely to help later readers
+
+Do not capture casual chat, unsupported claims, secrets, credentials, private
+content, or transient status that should be checked live.
+
+When evidence conflicts, prefer explicit decisions, then accountable sources,
+then newer evidence when authority is otherwise equal. If the conflict remains,
+show it honestly instead of choosing silently.
+
+## Reminder
+
+The recurring Wiki reminder runs the same ingest procedure.
+
+After a successful ingest, post a short daily summary in the Wiki channel only
+when there were meaningful decisions, progress, risks, ownership changes, or
+Wiki document changes. Include Raft references. If nothing meaningful changed,
+stay silent.
+
+## Runtime Adapter
+
+`CLAUDE.md` points to this file. `.claude/skills` points to or references the
+canonical `.agents/skills` directory. Do not maintain duplicated instruction
+bodies.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@botiverse/raft-daemon",
-  "version": "1.0.13",
+  "version": "1.0.14",
   "type": "module",
   "bin": {
     "raft-daemon": "dist/raft-daemon.js",
@@ -29,7 +29,7 @@
   "scripts": {
     "dev": "pnpm --filter @botiverse/raft build && tsx watch src/index.ts",
     "start": "tsx src/index.ts",
-    "build": "pnpm --filter @botiverse/raft build && tsup && node -e \"require('fs').cpSync('../cli/dist','dist/cli',{recursive:true})\" && node scripts/write-dist-bins.mjs",
+    "build": "pnpm --filter @botiverse/raft build && tsup && node -e \"const fs=require('fs');fs.rmSync('dist/wikiAgentWorkspace',{recursive:true,force:true});fs.cpSync('src/wikiAgentWorkspace','dist/wikiAgentWorkspace',{recursive:true})\" && node -e \"require('fs').cpSync('../cli/dist','dist/cli',{recursive:true})\" && node scripts/write-dist-bins.mjs",
     "test": "node --import tsx --test --test-force-exit 'src/**/*.test.ts'",
     "prepack": "pnpm run build",
     "prepublishOnly": "pnpm run build",
@@ -47,13 +47,16 @@
   },
   "dependencies": {
     "@botiverse/kimi-code-sdk": "0.28.1-botiverse.0",
-    "@earendil-works/pi-ai": "0.80.10",
-    "@earendil-works/pi-coding-agent": "0.80.10",
+    "@earendil-works/pi-ai": "0.82.0",
+    "@earendil-works/pi-coding-agent": "0.82.0",
     "@jackwener/opencli": "^1.8.3",
     "@modelcontextprotocol/sdk": "^1.29.0",
+    "ajv": "^8.18.0",
     "commander": "^12.1.0",
     "https-proxy-agent": "^7.0.6",
+    "safe-regex2": "5.1.1",
     "tar-stream": "2.2.0",
+    "typebox": "1.1.38",
     "undici": "^7.24.7",
     "ws": "^8.20.0",
     "zod": "^4.3.6"