@zosmaai/pi-llm-wiki 0.9.1 → 0.9.2

package/extensions/llm-wiki/lib/tools.ts

@@ -513,7 +513,8 @@ export function registerWikiEnsurePage(pi: ExtensionAPI, runtime?: Runtime): voi
     ],
     parameters: Type.Object({
       type: Type.String({
-        description: "Page type: entity | concept | synthesis | analysis | requirement",
+        description:
+          "Page type: entity | concept | synthesis | analysis | requirement | skill | case",
       }),
       title: Type.String({ description: "Page title" }),
       content: Type.Optional(
@@ -531,7 +532,14 @@ export function registerWikiEnsurePage(pi: ExtensionAPI, runtime?: Runtime): voi
         };
       }
 
-      const type = params.type as "entity" | "concept" | "synthesis" | "analysis";
+      const type = params.type as
+        | "entity"
+        | "concept"
+        | "synthesis"
+        | "analysis"
+        | "requirement"
+        | "skill"
+        | "case";
       const slug = params.title
         .toLowerCase()
         .replace(/[^a-z0-9\s-]/g, "")
@@ -545,6 +553,8 @@ export function registerWikiEnsurePage(pi: ExtensionAPI, runtime?: Runtime): voi
         synthesis: "syntheses",
         analysis: "analyses",
         requirement: "requirements",
+        skill: "skills",
+        case: "cases",
       };
       const folder = folderMap[type] || "concepts";
       const pagePath = join(paths.wiki, folder, `${slug}.md`);
@@ -622,6 +632,76 @@ function buildPageTemplate(
       "Durable answer from a query.\n\n## Question\n\n[Original question]",
     );
   }
+  if (type === "skill") {
+    return [
+      "---",
+      "type: skill",
+      `created: ${date}`,
+      `updated: ${date}`,
+      "status: draft",
+      "trajectories: []",
+      "tags: []",
+      "---",
+      "",
+      `# ${title}`,
+      "",
+      "_One-line summary of the reusable pattern this skill captures._",
+      "",
+      "## When to Use",
+      "",
+      "[Trigger conditions — when this pattern applies]",
+      "",
+      "## Procedure",
+      "",
+      "1. [Step 1]",
+      "2. [Step 2]",
+      "",
+      "## Pitfalls",
+      "",
+      "- [Known failure mode or caveat]",
+      "",
+      "## Distilled From",
+      "",
+      "_Trajectories this skill was generalized from._",
+      "",
+      "- [[trajectories/TRJ-...]]",
+      "",
+    ].join("\n");
+  }
+  if (type === "case") {
+    return [
+      "---",
+      "type: case",
+      `created: ${date}`,
+      `updated: ${date}`,
+      "status: draft",
+      "outcome: success",
+      "trajectory_id: ",
+      "tags: []",
+      "---",
+      "",
+      `# ${title}`,
+      "",
+      "_One-line summary of the specific task this case records._",
+      "",
+      "## Task",
+      "",
+      "[What was requested]",
+      "",
+      "## Approach",
+      "",
+      "[How the agent solved it — key steps and decisions]",
+      "",
+      "## Outcome",
+      "",
+      "[Result, and anything worth reusing or avoiding next time]",
+      "",
+      "## Trajectory",
+      "",
+      "- [[trajectories/TRJ-...]] — captured tool-call run",
+      "",
+    ].join("\n");
+  }
   if (type === "requirement") {
     return [
       "---",
@@ -1117,10 +1197,12 @@ export function registerWikiWatch(pi: ExtensionAPI): void {
   pi.registerTool({
     name: "wiki_watch",
     label: "Wiki Watch",
-    description: "Schedule automatic wiki updates (discover → ingest → lint) via pi's cron system.",
+    description:
+      "Print a ready-to-paste crontab line for scheduling automatic wiki updates (discover → ingest → lint). Does NOT schedule anything itself — it returns the command for the user to install.",
     promptSnippet: "Schedule auto-updates for the wiki",
     promptGuidelines: [
       "Use wiki_watch when the user wants the wiki to stay current automatically.",
+      "wiki_watch only PRINTS a cron line — surface the output to the user verbatim so they can install it. Do not claim the schedule is active.",
     ],
     parameters: Type.Object({
       interval: Type.String({ description: "daily, weekly, hourly, or stop" }),
@@ -1132,15 +1214,16 @@ export function registerWikiWatch(pi: ExtensionAPI): void {
             {
               type: "text",
               text: [
-                "🛑 To stop wiki auto-updates:",
+                "🛑 To stop wiki auto-updates, remove the cron line you installed earlier:",
                 "",
+                "```bash",
+                "crontab -e   # then delete the line tagged '# llm-wiki-autoupdate'",
                 "```",
-                "schedule_prompt action=list",
-                "```",
-                "Find the wiki job IDs, then:",
                 "",
-                "```",
-                "schedule_prompt action=remove jobId=<id>",
+                "Or list current jobs to confirm:",
+                "",
+                "```bash",
+                "crontab -l | grep llm-wiki-autoupdate",
                 "```",
               ].join("\n"),
             },
@@ -1149,10 +1232,11 @@ export function registerWikiWatch(pi: ExtensionAPI): void {
         };
       }
 
+      // 5-field POSIX crontab expressions (min hour dom month dow).
       const intervals: Record<string, { cron: string; label: string }> = {
-        daily: { cron: "0 0 8 * * *", label: "Daily at 8:00 AM" },
-        weekly: { cron: "0 0 9 * * 1", label: "Weekly on Monday at 9:00 AM" },
-        hourly: { cron: "0 0 * * * *", label: "Every hour" },
+        daily: { cron: "0 8 * * *", label: "Daily at 8:00 AM" },
+        weekly: { cron: "0 9 * * 1", label: "Weekly on Monday at 9:00 AM" },
+        hourly: { cron: "0 * * * *", label: "Every hour" },
       };
 
       const config = intervals[params.interval];
@@ -1169,18 +1253,37 @@ export function registerWikiWatch(pi: ExtensionAPI): void {
         };
       }
 
+      // Robustness for global crontab environments:
+      //   * `/bin/bash -lc` runs a LOGIN shell that sources /etc/profile +
+      //     ~/.profile / ~/.bash_profile, so npm-global / bun / nvm PATH
+      //     additions are imported — cron's default PATH is only
+      //     `/usr/bin:/bin` and would not find `pi`.
+      //   * `mkdir -p` makes the log dir self-healing for users with only
+      //     a project vault (no `~/.llm-wiki/` yet).
+      //   * All `$HOME` references are double-quoted to survive paths with spaces.
+      //   * `# llm-wiki-autoupdate` tags the line so the user can find and
+      //     remove it via `crontab -e` later (see `interval=stop`).
+      const cronLine = `${config.cron} /bin/bash -lc 'mkdir -p "$HOME/.llm-wiki" && pi -p "/wiki-run" >> "$HOME/.llm-wiki/cron.log" 2>&1' # llm-wiki-autoupdate`;
+
       return {
         content: [
           {
             type: "text",
             text: [
-              `⏰ To set up ${config.label} wiki updates, run:`,
+              `⏰ To set up ${config.label} wiki updates, add this line to your crontab.`,
+              "**This tool only prints the line — it does not install it.**",
               "",
+              "```bash",
+              "crontab -e",
               "```",
-              `schedule_prompt action=add schedule="${config.cron}" prompt="Run /wiki:run for the LLM Wiki" name="llm-wiki-autoupdate"`,
+              "",
+              "Then append:",
+              "",
+              "```cron",
+              cronLine,
               "```",
               "",
-              "This will auto-discover, ingest, and lint on schedule.",
+              `The line uses \`/bin/bash -lc\` so your shell profile (and the \`pi\` binary on npm-global / bun PATH) is loaded. Output goes to \`~/.llm-wiki/cron.log\`. If your system has no \`/bin/bash\`, replace with \`/bin/sh -c\` and ensure \`pi\` is in cron's PATH yourself.`,
             ].join("\n"),
           },
         ],
@@ -1188,6 +1291,8 @@ export function registerWikiWatch(pi: ExtensionAPI): void {
           interval: params.interval,
           cronSchedule: config.cron,
           label: config.label,
+          cronLine,
+          installed: false,
         } as Record<string, unknown>,
       };
     },

package/extensions/llm-wiki/lib/trajectories-command.ts

@@ -0,0 +1,67 @@
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { loadTaskConfig, persistTrajectoriesEnabled, trajectoriesEnabled } from "./task-config.js";
+
+/**
+ * Activation surface for agent-trajectory working-memory (issue #80).
+ *
+ * The feature is opt-in / default-off. The trajectory tools
+ * (`wiki_capture_trajectory`, `wiki_distill_skills`, `wiki_recall_skill`) are
+ * registered conditionally at extension-load time (see index.ts) based on the
+ * `llm-wiki.trajectories` setting. Because pi has no runtime add/remove-tool
+ * API — the extension factory runs once at load — flipping the flag can only
+ * change the registered tool set by RELOADING extensions. This command does
+ * exactly that: persist the setting, then `ctx.reload()` so the gate
+ * re-evaluates and the tools appear (or disappear) immediately.
+ *
+ *   /wiki-trajectories            → show current state
+ *   /wiki-trajectories on         → enable + reload
+ *   /wiki-trajectories off        → disable + reload
+ */
+
+const ON_WORDS = new Set(["on", "true", "enable", "enabled", "yes", "1"]);
+const OFF_WORDS = new Set(["off", "false", "disable", "disabled", "no", "0"]);
+
+export function registerWikiTrajectoriesCommand(pi: ExtensionAPI): void {
+  pi.registerCommand("wiki-trajectories", {
+    description:
+      "Enable or disable agent-trajectory working-memory (capture/distill/recall). Off by default.",
+    handler: async (args, ctx) => {
+      const arg = args.trim().toLowerCase();
+      const current = trajectoriesEnabled(loadTaskConfig(ctx.cwd));
+
+      if (!arg) {
+        ctx.ui.notify(
+          `LLM Wiki trajectories are ${current ? "ON" : "OFF"}. Use \`/wiki-trajectories on\` or \`off\`.`,
+          "info",
+        );
+        return;
+      }
+
+      let next: boolean;
+      if (ON_WORDS.has(arg)) next = true;
+      else if (OFF_WORDS.has(arg)) next = false;
+      else {
+        ctx.ui.notify(
+          `LLM Wiki: could not parse "${args.trim()}". Use \`on\` or \`off\`.`,
+          "error",
+        );
+        return;
+      }
+
+      if (next === current) {
+        ctx.ui.notify(`LLM Wiki trajectories already ${current ? "ON" : "OFF"}.`, "info");
+        return;
+      }
+
+      persistTrajectoriesEnabled(ctx.cwd, next);
+      ctx.ui.notify(
+        `LLM Wiki: trajectory tools ${next ? "enabled" : "disabled"} — reloading extensions…`,
+        "info",
+      );
+      // pi has no runtime register/unregister-tool API: reload re-runs the
+      // extension factory so the conditional registration re-evaluates and the
+      // tool set (and status line) reflect the new state.
+      await ctx.reload();
+    },
+  });
+}