fix: align plugin packaging with platform standards

Author: SummerSec

.claude-plugin/marketplace.json

@@ -11,7 +11,7 @@
     {
       "name": "ai-inner-os",
       "description": "Claude Code hook-based plugin scaffold for visible AI inner monologue.",
-      "version": "0.7.1",
+      "version": "0.7.2",
       "source": "./",
       "author": {
         "name": "SummerSec",

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-inner-os",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Makes Claude Code sessions expose a visible Inner OS monologue layer in the format ▎InnerOS：...",
   "author": {
     "name": "SummerSec",

.cursor-plugin/marketplace.json

@@ -0,0 +1,28 @@
+{
+  "name": "ai-inner-os-cursor",
+  "metadata": {
+    "description": "Cursor plugin packaging for AI Inner OS, exposing a visible Inner OS monologue layer through rules and hooks."
+  },
+  "owner": {
+    "name": "SummerSec",
+    "url": "https://github.com/SummerSec"
+  },
+  "plugins": [
+    {
+      "name": "ai-inner-os",
+      "description": "Visible Inner OS monologue layer for Cursor sessions.",
+      "version": "0.7.2",
+      "source": "./",
+      "author": {
+        "name": "SummerSec",
+        "url": "https://github.com/SummerSec"
+      },
+      "category": "productivity",
+      "tags": [
+        "agent-context",
+        "rules",
+        "hooks"
+      ]
+    }
+  ]
+}

.cursor-plugin/plugin.json

@@ -0,0 +1,29 @@
+{
+  "name": "ai-inner-os",
+  "displayName": "AI Inner OS",
+  "version": "0.7.2",
+  "description": "Expose a visible Inner OS monologue layer in Cursor sessions, with optional hook-based event context and persona-aware protocol injection.",
+  "author": {
+    "name": "SummerSec",
+    "url": "https://github.com/SummerSec"
+  },
+  "homepage": "https://github.com/SummerSec/AI-Inner-Os",
+  "repository": "https://github.com/SummerSec/AI-Inner-Os",
+  "license": "Apache-2.0",
+  "keywords": [
+    "cursor",
+    "inner-os",
+    "agent",
+    "rules",
+    "hooks",
+    "persona"
+  ],
+  "category": "productivity",
+  "tags": [
+    "agent-context",
+    "rules",
+    "hooks"
+  ],
+  "rules": "./cursor/rules/",
+  "hooks": "./cursor/hooks.json"
+}

.gitignore

@@ -5,3 +5,4 @@ state/*.log
 .claude/
 personas/_active.json
 docs/superpowers/
+.cursor/

CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.7.2] - 2026-05-10
+
+### Fixed
+
+- **Claude Code plugin**: Store session state and active persona under `${CLAUDE_PLUGIN_DATA}` so marketplace installs keep persistent data across plugin cache updates.
+- **Persona switching**: Avoid modifying plugin cache source files when `/inner-os persona use` runs inside Claude Code; repository and global-install workflows still update platform adapter files.
+
 ## [0.7.1] - 2026-04-16
 
 ### Fixed
@@ -54,6 +61,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Persona system: preset personas, custom template, `/inner-os` command updates, and persona sections in platform adapter docs.
 
+[0.7.2]: https://github.com/SummerSec/AI-Inner-Os/releases/tag/v0.7.2
 [0.7.1]: https://github.com/SummerSec/AI-Inner-Os/releases/tag/v0.7.1
 [0.7.0]: https://github.com/SummerSec/AI-Inner-Os/releases/tag/v0.7.0
 [0.6.1]: https://github.com/SummerSec/AI-Inner-Os/releases/tag/v0.6.1

CLAUDE.md

@@ -44,18 +44,22 @@ Stop → deletes session state file
 
 ### Persona Switching Script
 
-`scripts/switch-persona.js` handles cross-platform persona switching. It reads persona files from `personas/`, updates `personas/_active.json`, and injects the persona content between `<!-- ACTIVE_PERSONA_START -->` / `<!-- ACTIVE_PERSONA_END -->` markers in all 6 platform adapter files. The `/inner-os persona use` command calls this script via Bash.
+`scripts/switch-persona.js` handles persona switching for both repository/global-install workflows and Claude Code plugin runtime:
+
+- Repository/global install: reads persona files from `personas/`, updates `personas/_active.json`, and injects persona content between `<!-- ACTIVE_PERSONA_START -->` / `<!-- ACTIVE_PERSONA_END -->` markers in all platform adapter files.
+- Claude Code plugin runtime: when `CLAUDE_PLUGIN_DATA` is present, writes the active persona to `${CLAUDE_PLUGIN_DATA}/personas/_active.json` and does **not** modify plugin cache source files.
+- `/inner-os persona use` calls this script via Bash from the installed Claude Code plugin.
 
 ### hooks/lib/ — Shared Logic
 
 All hook scripts (including codex/ and cursor/ adapters) import from `hooks/lib/`:
 
 - **io.js** — stdin JSON reader, stdout JSON/text writers (the I/O boundary)
-- **state.js** — per-session JSON files in `state/`, recent-events ring buffer (max 10), consecutive failure counter
+- **state.js** — per-session JSON files in `${CLAUDE_PLUGIN_DATA}/state/` for Claude Code plugin installs, falling back to repo `state/` outside plugin runtime; recent-events ring buffer (max 10), consecutive failure counter
 - **events.js** — `inferEventType()` classifies tools by name; `inferResult()` derives success/failure; `normalizeToolEvent()` / `normalizeFailureEvent()` produce structured events; `extractToolTarget()` pulls the key field from tool input
 - **prompt.js** — builds all `additionalContext` strings: session-start protocol, pre-tool context, post-tool recent-event context, failure context
 - **session.js** — extracts session ID from various payload field names
-- **constants.js** — plugin ID, prefix `▎InnerOS：`, paths (STATE_DIR, SKILL_PATH), event type/result enums
+- **constants.js** — plugin ID, prefix `▎InnerOS：`, paths (PLUGIN_DATA_DIR, STATE_DIR, SKILL_PATH, persona paths), event type/result enums
 
 ### Multi-Platform Adaptation
 
@@ -75,13 +79,39 @@ Platforms degrade gracefully in hook richness:
 - `hooks/hooks.json` — Claude Code hook registration (the authoritative config)
 - `.claude-plugin/plugin.json` — plugin identity for Claude Code
 - `.claude-plugin/marketplace.json` — local marketplace listing
+- `.cursor-plugin/plugin.json` — plugin identity and component paths for Cursor plugin packaging
+- `.cursor-plugin/marketplace.json` — Cursor marketplace metadata
 - `plugin.json` — repo-level metadata
-- Version must be bumped in all three `plugin.json` / `package.json` files for updates to reach installed users
+- Version must be bumped across all platform manifests and package metadata for updates to reach installed users: `package.json`, `plugin.json`, `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json`, `.cursor-plugin/plugin.json`, `.cursor-plugin/marketplace.json`, and `openclaw.plugin.json`
+
+### Claude Code Plugin Standards
+
+Follow the Claude Code plugin reference when changing Claude plugin packaging:
+
+- The Claude Code manifest lives at `.claude-plugin/plugin.json`. Only manifest files belong under `.claude-plugin/`; component directories stay at the plugin root.
+- Default component locations are root-level `commands/`, `skills/`, `agents/`, `hooks/hooks.json`, `.mcp.json`, `.lsp.json`, `output-styles/`, `themes/`, and `monitors/`.
+- Custom component paths in `.claude-plugin/plugin.json` must be relative to the plugin root and start with `./`. Do not use absolute paths or `..` traversal.
+- Hook commands bundled with the plugin must reference plugin files through `${CLAUDE_PLUGIN_ROOT}`. Do not assume the repository checkout path exists after marketplace installation.
+- Persistent state must go under `${CLAUDE_PLUGIN_DATA}`. Do not write mutable runtime data, active persona settings, caches, or generated files into the plugin root/cache.
+- Marketplace installs are cached by plugin version. If `.claude-plugin/plugin.json` has an explicit `version`, bump it for every published update; pushing commits alone is not enough.
+- Validate packaging changes with `claude plugin validate .`, then run `npm run check` and `npm test`.
+
+### Cursor Plugin Standards
+
+This repository also ships Cursor plugin metadata because AI Inner OS is multi-platform:
+
+- Cursor plugin metadata lives in `.cursor-plugin/plugin.json`; `.cursor-plugin/marketplace.json` is the Cursor marketplace metadata entry.
+- The current Cursor design uses `cursor/` as the plugin component directory. `.cursor-plugin/plugin.json` points to `rules: "./cursor/rules/"` and `hooks: "./cursor/hooks.json"`.
+- Cursor component paths must be relative, stay inside the plugin/repository root, and must not use absolute paths or `..` traversal.
+- Cursor rules are `.mdc` files with YAML frontmatter. `cursor/rules/inner-os-protocol.mdc` must keep `description` and `alwaysApply: true`.
+- Cursor hooks use lowercase event names in this repo's Cursor adapter: `sessionStart`, `postToolUse`, and `stop`. Cursor hook output uses top-level `{ "additional_context": "..." }`.
+- Cursor `preToolUse` is intentionally not used for context injection because it cannot inject `additional_context`.
+- Keep Cursor documentation in `cursor/README.md` and `docs/install-cursor.md` aligned with `.cursor-plugin/plugin.json` and `cursor/hooks.json`.
 
 ### Key Patterns
 
 - Every hook wraps its body in `try/catch` and fails silently — hook errors never interrupt the session
-- Session state files live in `state/` (gitignored), keyed by sanitized session ID
+- Claude Code plugin session state files live in `${CLAUDE_PLUGIN_DATA}/state/`; repo/global-install fallback state files live in `state/` (gitignored), keyed by sanitized session ID
 - `failureCount` increments on consecutive failures, resets to 0 on any success
 - Claude Code: PreToolUse uses `hookSpecificOutput.additionalContext`; PostToolUse/PostToolUseFailure output plain text to stdout
 - Cursor: sessionStart/postToolUse use `{ additional_context: string }` top-level format; preToolUse removed (can't inject context)

README.md

@@ -99,11 +99,12 @@ See [codex/README.md](codex/README.md) | [Detailed installation guide](docs/inst
 ### Cursor
 
 ```bash
-# Copy rule file to project
-mkdir -p .cursor/rules
-cp cursor/rules/inner-os-protocol.mdc .cursor/rules/
+# Install Cursor adapter globally
+node scripts/install.js --platform cursor
 ```
 
+The repository also includes `.cursor-plugin/plugin.json`, which packages `cursor/` as a Cursor plugin component directory.
+
 See [cursor/README.md](cursor/README.md) | [Detailed installation guide](docs/install-cursor.md).
 
 ### OpenCode CLI

README_CN.md

@@ -99,11 +99,12 @@ cp codex/hooks.json ~/.codex/hooks.json
 ### Cursor
 
 ```bash
-# 复制规则文件到项目
-mkdir -p .cursor/rules
-cp cursor/rules/inner-os-protocol.mdc .cursor/rules/
+# 全局安装 Cursor 适配
+node scripts/install.js --platform cursor
 ```
 
+仓库也包含 `.cursor-plugin/plugin.json`，会将 `cursor/` 目录作为 Cursor 插件组件目录声明。
+
 详见 [cursor/README.md](cursor/README.md) | [详细安装指南](docs/install-cursor.md)。
 
 ### OpenCode CLI

commands/inner-os.md

@@ -15,7 +15,7 @@ argument-hint: "[status|on|off|reload|persona list|persona use <name>|persona sh
 
 1. 确认 Inner OS 协议是否已注入（本命令被加载即表示插件已安装）
 2. 展示当前独白前缀：`▎InnerOS：`
-3. 读取 `personas/_active.json` 展示当前人设名称
+3. 读取插件数据目录中的 `personas/_active.json` 展示当前人设名称；如果不存在，视为 `default`
 4. 用一句 Inner OS 独白证明它正在工作
 
 示例输出：
@@ -58,23 +58,24 @@ Inner OS 状态：已启用
 
 1. 读取 `personas/` 目录下的所有 `.md` 文件（排除 README）
 2. 读取 `personas/custom/` 目录下的所有 `.md` 文件
-3. 从每个文件的 YAML frontmatter 中提取 `name`、`displayName`、`description`
-4. 以表格形式展示，标记当前激活的人设
+3. 读取插件数据目录中 `personas/custom/` 下的自定义 `.md` 文件
+4. 从每个文件的 YAML frontmatter 中提取 `name`、`displayName`、`description`
+5. 以表格形式展示，标记当前激活的人设
 
 ### `persona use <name>`
 
 切换到指定人设：
 
 1. 调用切换脚本：`node "${CLAUDE_PLUGIN_ROOT}/scripts/switch-persona.js" <name>`
-2. 脚本会自动更新 `personas/_active.json` 并将人设内容注入到所有平台适配文件中
+2. 在 Claude Code 插件运行时，脚本会更新 `${CLAUDE_PLUGIN_DATA}/personas/_active.json`，不会修改插件缓存中的源码文件
 3. 如果人设不存在，脚本会报错并提示运行 `--list` 查看可用选项
 4. 切换成功后，立刻用新人设的风格输出一句独白作为确认
 
 ### `persona show`
 
 显示当前激活的人设：
 
-1. 读取 `personas/_active.json` 获取当前人设名称
+1. 读取插件数据目录中的 `personas/_active.json` 获取当前人设名称
 2. 如果文件不存在或无法读取，视为 `default`
 3. 读取对应人设文件，展示名称和风格描述
 
@@ -83,6 +84,6 @@ Inner OS 状态：已启用
 恢复到自由模式：
 
 1. 调用切换脚本：`node "${CLAUDE_PLUGIN_ROOT}/scripts/switch-persona.js" default`
-2. 脚本会清空所有平台适配文件中的人设内容，并将 `_active.json` 设为 `default`
+2. 在 Claude Code 插件运行时，脚本会将 `${CLAUDE_PLUGIN_DATA}/personas/_active.json` 设为 `default`，不会修改插件缓存中的源码文件
 3. 确认已恢复自由模式
 4. 用一句自由风格的独白确认