@aipper/aiws-spec 0.0.51 → 0.0.52

package/docs/pi-plugins-manifest.json

@@ -14,13 +14,13 @@
   ],
   "recommended_a": [
     {
-      "id": "pi-extension-settings",
-      "package": "pi-extension-settings",
+      "id": "@juanibiapina/pi-extension-settings",
+      "package": "@juanibiapina/pi-extension-settings",
       "tier": "recommended_a"
     },
     {
-      "id": "pi-powerbar",
-      "package": "pi-powerbar",
+      "id": "@juanibiapina/pi-powerbar",
+      "package": "@juanibiapina/pi-powerbar",
       "tier": "recommended_a"
     },
     {
@@ -39,8 +39,8 @@
       "tier": "recommended_a"
     },
     {
-      "id": "rpiv-ask-user-question",
-      "package": "rpiv-ask-user-question",
+      "id": "@juicesharp/rpiv-ask-user-question",
+      "package": "@juicesharp/rpiv-ask-user-question",
       "tier": "recommended_a"
     },
     {
@@ -63,7 +63,8 @@
     {
       "id": "pi-mcp-adapter",
       "package": "pi-mcp-adapter",
-      "tier": "recommended_b"
+      "tier": "recommended_b",
+      "reason": "MCP adapter; heavy deps \u2014 sequential install with timeout; may need manual retry"
     },
     {
       "id": "pi-fff",
@@ -76,8 +77,8 @@
       "tier": "recommended_b"
     },
     {
-      "id": "plan-mode",
-      "package": "plan-mode",
+      "id": "pi-plan-mode",
+      "package": "pi-plan-mode",
       "tier": "recommended_b"
     },
     {

package/docs/pi-plugins-manifest.md

@@ -54,12 +54,12 @@ Low conflict with AIWS governance; useful quality-of-life.
 
 | package | notes |
 |---------|--------|
-| `pi-extension-settings` | settings UX |
-| `pi-powerbar` | status bar |
+| `@juanibiapina/pi-extension-settings` | settings UX |
+| `@juanibiapina/pi-powerbar` | status bar |
 | `pi-lsp` | LSP |
 | `pi-hashline-edit-pro` | edit helper (watch tool names vs force deny) |
 | `rpiv-todo` | todos |
-| `rpiv-ask-user-question` | structured questions |
+| `@juicesharp/rpiv-ask-user-question` | structured questions |
 | `pi-btw` | asides |
 | `pi-caffeinate` | keep awake |
 | `pi-workspace-history` | history |
@@ -68,10 +68,10 @@ Low conflict with AIWS governance; useful quality-of-life.
 
 | package | notes |
 |---------|--------|
-| `pi-mcp-adapter` | MCP |
+| `pi-mcp-adapter` | MCP (heavy deps; install may hang — retry alone or skip) |
 | `pi-fff` | file finder |
 | `pi-slopchop` | slop cleanup |
-| `plan-mode` | plan UX (AIWS keeps plan truth) |
+| `pi-plan-mode` | plan UX (AIWS keeps plan truth) |
 | `pi-cache-optimizer` | cache (truncation caution) |
 | `pi-rtk-optimizer` | RTK |
 | `pi-agent-browser-native` | browser |
@@ -102,7 +102,7 @@ Low conflict with AIWS governance; useful quality-of-life.
 - Missing **required** → exit code ≠ 0  
 - Conflicts / forbidden installed → warn (exit ≠ 0 if any required missing or any conflict)  
 - `init --pi` / `update` (when `.pi/` exists or `--pi`): print same report as **warn**; do not fail init/update by default  
-- Optional `--install-pi-plugins`: install **required only** (user scope); recommended stay print-only
+- Optional `--install-pi-plugins`: install **all declared installable** plugins (required + recommended A/B, user scope); never forbidden; default without flag remains detect+prompt only
 
 ## Related
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aipper/aiws-spec",
-  "version": "0.0.51",
+  "version": "0.0.52",
   "description": "AIWS spec and templates (single source of truth).",
   "type": "module",
   "files": [

package/templates/workspace/.opencode/plugins/memory-autoload.js

@@ -0,0 +1,185 @@
+/**
+ * Memory Autoload Plugin
+ *
+ * Injects AIWS memory context at session start so each session
+ * has continuity without needing the nocturne_memory MCP server.
+ *
+ * What it does:
+ *   1. On the first user message of a new session, reads:
+ *      - Active goal(s) from .aiws/goals/*.state.json
+ *      - Recent decisions from .aiws/memory-bank/decision/ (last 3)
+ *      - Project overview from .aiws/memory-bank/project/
+ *   2. Injects a <memory-context> block into the assistant's first response.
+ *   3. Deduplicates per session — injects once only.
+ *
+ * Disable: export MEMORY_AUTOLOAD_DISABLE=1
+ *
+ * @module memory-autoload
+ */
+
+import { readFileSync, existsSync, readdirSync } from "node:fs";
+import { join } from "node:path";
+
+const MEMORY_BANK = ".aiws/memory-bank";
+const GOALS_DIR = ".aiws/goals";
+
+export const MemoryAutoloadPlugin = async ({ project, client, directory }) => {
+  const processed = new Set();
+
+  return {
+    "chat.message": async (input, output) => {
+      const sid = input?.sessionID;
+      if (!sid || processed.has(sid)) return;
+      if (process.env.MEMORY_AUTOLOAD_DISABLE === "1") {
+        processed.add(sid);
+        return;
+      }
+
+      const root = directory || process.cwd();
+      const bankDir = join(root, MEMORY_BANK);
+      if (!existsSync(bankDir)) {
+        processed.add(sid);
+        return;
+      }
+
+      const blocks = [];
+
+      // ── 1. Active/paused goals (ADVISORY ONLY — not FSM authority) ─
+      // TOOLING-003D: authoritative goal-context + next_action come from
+      // session-start → buildSessionContext → getActiveGoal(s).
+      // memory-autoload must NOT become authority over goal state.
+      try {
+        const goalsDir = join(root, GOALS_DIR);
+        if (existsSync(goalsDir)) {
+          const files = readdirSync(goalsDir).filter((f) =>
+            f.endsWith(".state.json"),
+          );
+          const advisory = [];
+          for (const file of files.sort()) {
+            try {
+              const state = JSON.parse(
+                readFileSync(join(goalsDir, file), "utf-8"),
+              );
+              const st = state.status;
+              if (st === "active" || st === "paused") {
+                const phase = state.current_phase ?? "?";
+                const iter = state.iteration ?? "?";
+                advisory.push(
+                  `- [${st}] ${state.goal_id || file} — phase=${phase}, iteration=${iter}`,
+                );
+              }
+            } catch {
+              /* skip malformed state file */
+            }
+          }
+          if (advisory.length) {
+            blocks.push(
+              "[Goals — advisory memory only; use session <goal-context> for next_action]",
+            );
+            blocks.push(...advisory);
+          }
+        }
+      } catch {
+        /* goals dir missing */
+      }
+
+      // ── 2. Recent decisions (last 3, sorted by filename) ──────────
+      try {
+        const decDir = join(bankDir, "decision");
+        if (existsSync(decDir)) {
+          const files = readdirSync(decDir)
+            .filter((f) => f.endsWith(".md") && f !== "handoff-evidence.md")
+            .sort()
+            .reverse()
+            .slice(0, 3);
+          for (const file of files) {
+            try {
+              const content = readFileSync(join(decDir, file), "utf-8");
+              const title =
+                content
+                  .split("\n")
+                  .find((l) => l.startsWith("#"))
+                  ?.replace(/^#+\s*/, "") || file.replace(".md", "");
+              const summary = content
+                .split("\n")
+                .slice(1, 8)
+                .filter((l) => l.trim())
+                .join("\n")
+                .trim();
+              blocks.push(`\n[Decision] ${title}\n${summary}`);
+            } catch {
+              /* skip unreadable file */
+            }
+          }
+        }
+      } catch {
+        /* decision dir missing */
+      }
+
+      // ── 3. Project overview ────────────────────────────────────────
+      try {
+        const projDir = join(bankDir, "project");
+        if (existsSync(projDir)) {
+          const files = readdirSync(projDir).filter((f) => f.endsWith(".md"));
+          for (const file of files.slice(0, 2)) {
+            try {
+              const content = readFileSync(join(projDir, file), "utf-8");
+              const title =
+                content
+                  .split("\n")
+                  .find((l) => l.startsWith("#"))
+                  ?.replace(/^#+\s*/, "") || file.replace(".md", "");
+              const excerpt = content
+                .split("\n")
+                .slice(1, 12)
+                .filter((l) => l.trim())
+                .join("\n")
+                .trim();
+              blocks.push(`\n[Project: ${title}]\n${excerpt}`);
+            } catch {
+              /* skip */
+            }
+          }
+        }
+      } catch {
+        /* project dir missing */
+      }
+
+      // ── 4. If aiws memory boot produces anything, append it ────────
+      // (skipped — avoids shell dependency; use --disclosure boot on
+      //  `aiws memory write` and the injected goal/decision blocks
+      //  above already provide sufficient context)
+
+      if (blocks.length === 0) {
+        processed.add(sid);
+        return;
+      }
+
+      const context = `<memory-context>\n${blocks.join("\n")}\n</memory-context>`;
+
+      const parts = output?.parts || [];
+      const textIdx = parts.findIndex(
+        (p) => p.type === "text" && p.text !== undefined,
+      );
+      if (textIdx !== -1) {
+        parts[textIdx].text = `${context}\n\n${parts[textIdx].text}`;
+      } else {
+        parts.unshift({ type: "text", text: context });
+      }
+
+      try {
+        await client.app.log({
+          body: {
+            service: "memory-autoload",
+            level: "info",
+            message: `Injected ${blocks.length} memory blocks for session ${sid.slice(0, 12)}`,
+          },
+        });
+      } catch {
+        /* logging optional */
+      }
+
+      processed.add(sid);
+    },
+  };
+};

package/templates/workspace/AGENTS.md

@@ -32,3 +32,16 @@ Red Flags（这些想法都是错的）：
 <!-- AIWS_MANAGED_END:agents -->
 
 你可以在本段下方追加项目自定义说明；`aiws update` 不会改动托管块以外内容。
+
+## Memory Protocol
+
+本仓库使用 `aiws memory` 系统持久化跨会话知识。automation 协议：
+
+1. **自动注入（插件）** — `.opencode/plugins/memory-autoload.js` 在会话首次消息时读取活跃目标、近期决策、项目概览并注入 `<memory-context>`。需依赖：`MEMORY_AUTOLOAD_DISABLE=1` 可关闭
+2. **会话启动时** — 自动读取 `.aiws/memory-bank/.index.yaml` 获取记忆索引，了解已记录的知识领域
+3. **回答前** — 若问题涉及已记忆的领域，先用 `aiws memory search <keywords>` 检索相关记录
+4. **获取新知识后** — 对重要决策、根因分析、架构约定等跨会话有价值的信息，使用 `aiws memory write <domain>://<path>` 写入永久记忆（写入会自动更新索引）。标记 `--disclosure boot` 可让记忆出现在下次插件注入中
+5. **记忆关联** — 对相关记忆使用 `aiws memory link add` 建立关系
+6. **nocturne_memory MCP** — 仓库预配了远程 MCP 服务器（nocturne_memory），作为全局知识层自动可用，两者互补而非替代。当前未集成到 OpenCode 配置中
+
+目标：把关键认知固化到 git-tracked 文件，实现跨机器/跨会话的知识连续性。

package/templates/workspace/manifest.json

@@ -64,6 +64,7 @@
     ".opencode/plugins/aiws-inject-context.js",
     ".opencode/plugins/aiws-session-start.js",
     ".opencode/plugins/aiws-workflow-state.js",
+    ".opencode/plugins/memory-autoload.js",
     ".opencode/lib/aiws-context.js",
     ".opencode/commands/**",
     ".opencode/skills/**",
@@ -257,6 +258,7 @@
       ".opencode/plugins/aiws-inject-context.js",
       ".opencode/plugins/aiws-session-start.js",
       ".opencode/plugins/aiws-workflow-state.js",
+      ".opencode/plugins/memory-autoload.js",
       ".opencode/lib/aiws-context.js",
       ".opencode/command/p-aiws-change-archive.md",
       ".opencode/command/p-aiws-change-finish.md",