pi-para 0.6.6 → 0.7.0

package/ARCHITECTURE.md

@@ -11,8 +11,7 @@ Pi process
       ├─ QMD SDK store (.qmd.sqlite)
       ├─ in-process scheduler (.pi-para.sqlite)
       ├─ tools + slash commands
-      ├─ context injection
-      └─ optional WebWiki UI
+      └─ context injection
 ```
 
 No separate OS daemon is required. The scheduler runs while Pi is open and catches up on the next startup if Pi was closed.
@@ -142,10 +141,9 @@ Tool API contracts and behavioral guidance are separated:
 
 Kept temporarily:
 
-- `pi-para-daemon` binary alias,
-- `/wiki-daemon` slash command alias,
-- legacy daemon CLI subcommands,
+- `pi-para-daemon` binary name, which exits nonzero with scheduler migration guidance,
+- `/wiki-daemon` slash command alias for `/wiki-scheduler`,
 - legacy config migration from `~/.pi/wiki/config.json`,
 - legacy QMD YAML provider fallback.
 
-Primary docs and setup should point users to `pi-para`, `/wiki-scheduler`, and `~/.pi/para/config.jsonc`.
+Primary docs and setup point users to `pi-para`, `/wiki-scheduler`, and `~/.pi/para/config.jsonc`.

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 ## Unreleased
 
+## [0.7.0] — 2026-07-18
+
+### Removed (breaking for deprecated daemon aliases)
+- Removed the legacy daemon subsystem: daemon, watcher, maintainer, Web Wiki server/bundle (which defaulted to binding 0.0.0.0:10973), the systemd service file, and the daemon plan. Capture and maintenance run automatically via the embedded scheduler. `pi-para daemon`/`watch` and the retained `pi-para-daemon` binary now exit nonzero with guidance pointing to `pi-para tasks` and `pi-para doctor`; legacy `webWiki` config keys are ignored with a notice.
+- Removed the unused Python capture prototypes and compiled bytecode that were shipped in the npm package.
+- Removed the unreferenced link-discovery module and its package export; finished implementation plans now live under `docs/archive/`.
+
+### Fixed
+- CLI scheduler commands (`pi-para tasks …`) now honor a configured `wiki.dir` instead of always using `~/.pi/wiki`, matching the extension's path resolution. Regressions cover custom directories and malformed-config fallback.
+
+### Changed
+- Split the wiki tool registrations into focused `src/tools/` modules with byte-identical tool names, schemas, descriptions, and guidance.
+- The build script no longer copies Web Wiki assets; `npm run build` cleans `dist/` and compiles.
+
+## [0.6.7] — 2026-07-18
+
+### Fixed
+- Recoverable embedding-provider failures during background embedding and best-effort vector search no longer flash raw `embed error:`/`embedBatch error:` output; they are captured per operation and fall back quietly to BM25 while durable scheduler retry history keeps deduplicated provider causes. Unrelated `console.error` output still passes through.
+
+### Changed
+- The wiki system reminder now opens with a MANDATORY FIRST STEP instruction: for any non-trivial request, the first tool call must be `wiki_query` with keywords from the request, followed by `wiki_read` of relevant results. `wiki_query` tool guidelines and the centralized wiki tool guidance were strengthened to match.
+
 ## [0.6.6] — 2026-07-17
 
 ### Fixed

package/CONFIGURATION.md

@@ -60,12 +60,6 @@ Planned/project-level overrides may use `<project>/.pi/para.jsonc` in a later sl
   "lint": {
     "autoFix": true,
     "staleDays": 90
-  },
-  "webWiki": {
-    "enabled": false,
-    "host": "127.0.0.1",
-    "port": 10973,
-    "launch": "manual"
   }
 }
 ```
@@ -203,16 +197,7 @@ pi-para never uses QMD's local/node-llama-cpp LLM fallback. If no API provider i
 | `autoFix` | Default lint autofix behavior |
 | `staleDays` | Age threshold for stale pages |
 
-### `webWiki`
-
-Optional browser UI.
-
-| Field | Meaning |
-|---|---|
-| `enabled` | Show/use WebWiki status |
-| `host` | Bind host |
-| `port` | Port |
-| `launch` | `manual` or `disabled` |
+Legacy `webWiki` keys are accepted for compatibility but ignored with a one-line notice because Web Wiki was removed in 0.7.
 
 ## Diagnostics
 

package/README.md

@@ -46,7 +46,7 @@ Default user files:
 ~/.pi/wiki/.qmd.sqlite        # QMD SDK search index
 ```
 
-Legacy files such as `~/.pi/wiki/config.json`, `~/.pi/wiki/.daemon.sqlite`, and `~/.config/qmd/index.yml` are still read for migration/compatibility.
+Legacy files such as `~/.pi/wiki/config.json` and `~/.config/qmd/index.yml` are still read for migration/compatibility.
 
 ## Core commands
 
@@ -63,7 +63,6 @@ Legacy files such as `~/.pi/wiki/config.json`, `~/.pi/wiki/.daemon.sqlite`, and
 | `/wiki-summarize [target]` | Summarize a page/category/all |
 | `/wiki-settings` | Interactive settings for config/providers/scheduler |
 | `/wiki-scheduler [status\|queue\|history\|capture-history]` | Scheduler/capture observability |
-| `/wiki-daemon ...` | Compatibility alias for `/wiki-scheduler` |
 | `/wiki-migrate` | Batch-migrate pages to current schema |
 | `/wiki-project <name> <goal>` | Create/archive project pages |
 
@@ -85,7 +84,7 @@ pi-para providers set-secret <name> <value>
 pi-para providers remove-secret <name>
 ```
 
-`pi-para-daemon` remains as a temporary compatibility binary, but the primary runtime is the in-process scheduler. Legacy daemon status is available as `pi-para legacy-status` for troubleshooting old installs.
+The `pi-para-daemon` binary name is retained only to print migration guidance; its legacy commands were removed in 0.7.
 
 ## Tools available to agents
 
@@ -142,16 +141,6 @@ When Pi is running, pi-para starts an in-process scheduler. It handles:
 
 No background OS service is required. If Pi is closed, queued work resumes on the next Pi session.
 
-## Web Wiki UI
-
-The optional web wiki can be enabled from `/wiki-settings`:
-
-```text
-/wiki-settings → [WebWiki] Enabled
-```
-
-It serves the wiki viewer/editor/graph on the configured host/port.
-
 ## Obsidian compatibility
 
 The wiki is plain markdown with YAML frontmatter and `[[wikilinks]]`. You can open `~/.pi/wiki/` as an Obsidian vault.

package/SETUP.md

@@ -103,7 +103,6 @@ Legacy migration inputs:
 
 ```text
 ~/.pi/wiki/config.json
-~/.pi/wiki/.daemon.sqlite
 ~/.config/qmd/index.yml
 ```
 
@@ -147,7 +146,6 @@ The settings menu writes through the same config service as the CLI. It can conf
 - search limit and graph boost,
 - lint autofix/stale days,
 - capture model,
-- WebWiki host/port/enabled,
 - embedding and rerank provider profiles,
 - local secrets.
 
@@ -197,7 +195,7 @@ Inside Pi:
 /wiki-scheduler capture-history
 ```
 
-`/wiki-daemon` and `pi-para-daemon` remain compatibility aliases for older workflows.
+The `pi-para-daemon` binary name remains only to print migration guidance and exits nonzero.
 
 ## QMD search
 
@@ -251,7 +249,3 @@ pi-para doctor
 ```
 
 Then configure or disable embedding.
-
-### Old daemon/systemd service exists
-
-The old service is no longer required. You can leave it stopped while using the in-process scheduler. Do not start both old daemon capture and the scheduler for the same wiki unless you are intentionally testing legacy behavior.

package/STRUCTURE.md

@@ -7,9 +7,7 @@ README.md                     # user overview
 SETUP.md                      # current setup/onboarding
 ARCHITECTURE.md               # runtime architecture
 CONFIGURATION.md              # config schema and credentials
-NO_DAEMON_REFACTOR_ROADMAP.md # implementation roadmap/history
-PROVIDER_MODEL_SELECTION_PLAN.md
-SETUP_SETTINGS_FLOW_PLAN.md
+docs/archive/                 # historical implementation plans
 package.json
 src/
 test/
@@ -23,7 +21,7 @@ skills/
 | Path | Purpose |
 |---|---|
 | `src/index.ts` | Pi extension entry point; registers lifecycle handlers/tools/commands/scheduler |
-| `src/cli.ts` | `pi-para` and compatibility `pi-para-daemon` CLI |
+| `src/cli.ts` | `pi-para` CLI and removed-daemon compatibility message |
 | `src/commands.ts` | Pi slash commands |
 | `src/tools.ts` | Pi tool definitions |
 
@@ -39,7 +37,7 @@ skills/
 | `src/raw.ts` | Raw source storage and session digest helpers |
 | `src/lint.ts` | Wiki health checks/autofix |
 | `src/summarize.ts` | Summary operations |
-| `src/link-utils.ts`, `src/link-discovery.ts`, `src/tag-registry.ts` | Link/tag helpers |
+| `src/link-utils.ts`, `src/tag-registry.ts` | Link/tag helpers |
 
 ### Runtime/search/state
 
@@ -49,7 +47,7 @@ skills/
 | `src/qmd-providers.ts` | Convert pi-para provider profiles into QMD SDK provider config |
 | `src/context.ts` | Wiki context injection into Pi sessions |
 | `src/wiki-tool-guidance.ts` | Shared wiki tool descriptions, prompt snippets, and behavior guidance |
-| `src/state.ts` | Legacy/session capture state DB helpers |
+| `src/state.ts` | Session capture state DB helpers |
 
 ### Config/setup/diagnostics
 
@@ -76,17 +74,12 @@ src/scheduler/
 └── session-capture.ts # completed-session registry and capture task handler
 ```
 
-### Legacy/compatibility
+### Capture processing
 
 | Path | Purpose |
 |---|---|
-| `src/daemon.ts` | Legacy daemon foreground mode |
-| `src/watcher.ts` | Legacy `.completed-sessions` watcher |
-| `src/processor.ts` | Legacy session processor |
+| `src/processor.ts` | Session processor shared by capture workflows |
 | `src/session-tools.ts` | Session exploration tools used by capture |
-| `src/maintainer.ts` | Legacy/maintenance helpers |
-
-New code should avoid adding daemon-only dependencies unless intentionally maintaining compatibility.
 
 ## `test/`
 
@@ -124,8 +117,4 @@ Primary binary:
 pi-para -> dist/cli.js
 ```
 
-Compatibility binary:
-
-```text
-pi-para-daemon -> dist/cli.js
-```
+The `pi-para-daemon` compatibility binary also points to `dist/cli.js` and exits nonzero with scheduler migration guidance.

package/dist/cli-legacy.d.ts

@@ -1,4 +1,5 @@
 export declare const LEGACY_DAEMON_COMMANDS: Set<string>;
 export declare function isLegacyDaemonCommand(command: string | undefined): boolean;
-export declare function formatLegacyDaemonWarning(command: string): string;
+export declare function isLegacyDaemonBinary(executablePath: string | undefined): boolean;
+export declare function formatLegacyDaemonRemoval(command: string): string;
 //# sourceMappingURL=cli-legacy.d.ts.map

package/dist/cli-legacy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-legacy.d.ts","sourceRoot":"","sources":["../src/cli-legacy.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,aAQjC,CAAC;AAEH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE1E;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOjE"}
+{"version":3,"file":"cli-legacy.d.ts","sourceRoot":"","sources":["../src/cli-legacy.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,sBAAsB,aAUjC,CAAC;AAEH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE1E;AAED,wBAAgB,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAIhF;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMjE"}

package/dist/cli-legacy.js

@@ -1,4 +1,7 @@
+import { basename } from "node:path";
 export const LEGACY_DAEMON_COMMANDS = new Set([
+    "daemon",
+    "watch",
     "start",
     "stop",
     "legacy-status",
@@ -10,32 +13,17 @@ export const LEGACY_DAEMON_COMMANDS = new Set([
 export function isLegacyDaemonCommand(command) {
     return command !== undefined && LEGACY_DAEMON_COMMANDS.has(command);
 }
-export function formatLegacyDaemonWarning(command) {
-    const replacement = replacementForLegacyCommand(command);
+export function isLegacyDaemonBinary(executablePath) {
+    if (!executablePath)
+        return false;
+    const name = basename(executablePath.replaceAll("\\", "/")).toLowerCase();
+    return name === "pi-para-daemon" || name === "pi-para-daemon.cmd" || name === "pi-para-daemon.exe";
+}
+export function formatLegacyDaemonRemoval(command) {
     return [
-        `[pi-para] Warning: '${command}' is a deprecated legacy daemon command.`,
-        "pi-para now uses an in-process scheduler while Pi is open; no system daemon is required.",
-        replacement ? `Use ${replacement} for the current workflow.` : "Use 'pi-para tasks' or '/wiki-scheduler status' for the current workflow.",
+        `[pi-para] Legacy daemon command '${command}' was removed in 0.7.`,
+        "Capture and maintenance run automatically via the embedded scheduler.",
+        "Use 'pi-para tasks' to inspect scheduler work and 'pi-para doctor' for diagnostics.",
     ].join("\n");
 }
-function replacementForLegacyCommand(command) {
-    switch (command) {
-        case "start":
-            return "'pi-para setup' and restart Pi";
-        case "stop":
-            return "'/wiki-scheduler status' or close/restart Pi sessions";
-        case "legacy-status":
-            return "'pi-para tasks' or '/wiki-scheduler status'";
-        case "process":
-            return "'pi-para capture-recent --hours N' or '/wiki-capture'";
-        case "process-recent":
-            return "'pi-para capture-recent --hours N'";
-        case "retry-failed":
-            return "'pi-para tasks retry'";
-        case "history":
-            return "'pi-para tasks history'";
-        default:
-            return null;
-    }
-}
 //# sourceMappingURL=cli-legacy.js.map

package/dist/cli-legacy.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-legacy.js","sourceRoot":"","sources":["../src/cli-legacy.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IAC5C,OAAO;IACP,MAAM;IACN,eAAe;IACf,SAAS;IACT,gBAAgB;IAChB,cAAc;IACd,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CAAC,OAA2B;IAC/D,OAAO,OAAO,KAAK,SAAS,IAAI,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAAe;IACvD,MAAM,WAAW,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACzD,OAAO;QACL,uBAAuB,OAAO,0CAA0C;QACxE,0FAA0F;QAC1F,WAAW,CAAC,CAAC,CAAC,OAAO,WAAW,4BAA4B,CAAC,CAAC,CAAC,2EAA2E;KAC3I,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,SAAS,2BAA2B,CAAC,OAAe;IAClD,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,OAAO;YACV,OAAO,gCAAgC,CAAC;QAC1C,KAAK,MAAM;YACT,OAAO,uDAAuD,CAAC;QACjE,KAAK,eAAe;YAClB,OAAO,6CAA6C,CAAC;QACvD,KAAK,SAAS;YACZ,OAAO,uDAAuD,CAAC;QACjE,KAAK,gBAAgB;YACnB,OAAO,oCAAoC,CAAC;QAC9C,KAAK,cAAc;YACjB,OAAO,uBAAuB,CAAC;QACjC,KAAK,SAAS;YACZ,OAAO,yBAAyB,CAAC;QACnC;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}
+{"version":3,"file":"cli-legacy.js","sourceRoot":"","sources":["../src/cli-legacy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IAC5C,QAAQ;IACR,OAAO;IACP,OAAO;IACP,MAAM;IACN,eAAe;IACf,SAAS;IACT,gBAAgB;IAChB,cAAc;IACd,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CAAC,OAA2B;IAC/D,OAAO,OAAO,KAAK,SAAS,IAAI,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,cAAkC;IACrE,IAAI,CAAC,cAAc;QAAE,OAAO,KAAK,CAAC;IAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1E,OAAO,IAAI,KAAK,gBAAgB,IAAI,IAAI,KAAK,oBAAoB,IAAI,IAAI,KAAK,oBAAoB,CAAC;AACrG,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAAe;IACvD,OAAO;QACL,oCAAoC,OAAO,uBAAuB;QAClE,uEAAuE;QACvE,qFAAqF;KACtF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/cli.d.ts

@@ -2,29 +2,7 @@
 /**
  * CLI for pi-para.
  *
- * The old pi-para-daemon commands remain as deprecated compatibility aliases.
+ * The pi-para-daemon binary remains only to report the legacy daemon removal.
  */
-export declare function createModel(modelArg?: string): Promise<{
-    model: import("@earendil-works/pi-ai").Model<any>;
-    getApiKey: (provider: string) => Promise<string | undefined>;
-} | {
-    model: {
-        id: any;
-        name: any;
-        provider: string;
-        api: "openai-completions" | "anthropic-messages";
-        baseUrl: any;
-        reasoning: boolean;
-        input: "text"[];
-        cost: {
-            input: number;
-            output: number;
-            cacheRead: number;
-            cacheWrite: number;
-        };
-        contextWindow: number;
-        maxTokens: number;
-    };
-    getApiKey: (_provider: string) => Promise<string>;
-}>;
+export {};
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAeH,wBAAsB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM;;0BAiDR,MAAM;;;;;;;;;;;;;;;;;;;2BAgDE,MAAM;GAMxD"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;GAIG"}