v0.2 redesign: provider abstraction + dual-host + wizard + 2 real-account providers verified

.claude-plugin/plugin.json

@@ -0,0 +1,27 @@
+{
+  "name": "multi-media-publisher",
+  "version": "0.2.0",
+  "description": "Cross-platform content publishing orchestration: 小红书 / 微信图文 / 微信公众号文章 / X Articles / Substack. Wizard-driven manifest creation, draft-first safety, encrypted credential vault.",
+  "skills": ["./SKILL.md"],
+  "scripts": {
+    "publish": "scripts/mmp.py publish",
+    "validate": "scripts/mmp.py validate",
+    "setup": "scripts/mmp.py setup",
+    "list": "scripts/mmp.py list",
+    "resume": "scripts/mmp.py resume",
+    "doctor": "scripts/mmp.py doctor",
+    "wizard": "scripts/mmp.py wizard"
+  },
+  "homepage": "https://github.com/yxliao-lewis/multi-media-publisher",
+  "license": "MIT",
+  "keywords": [
+    "publishing",
+    "social-media",
+    "xiaohongshu",
+    "wechat",
+    "x",
+    "substack",
+    "claude-code",
+    "openclaw"
+  ]
+}

.github/workflows/ci.yml

@@ -0,0 +1,50 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: ${{ matrix.os }} / py${{ matrix.python-version }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+          cache-dependency-path: pyproject.toml
+
+      - name: Install
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Lint (ruff)
+        run: |
+          python -m ruff check .
+          python -m ruff format --check .
+
+      - name: Typecheck (mypy)
+        run: python -m mypy core
+
+      - name: Unit tests
+        run: python -m pytest -q
+
+      - name: Smoke test
+        env:
+          # Provide ephemeral, fake home so smoke writes its vault into a
+          # job-local dir (the smoke script also overrides XDG_CONFIG_HOME).
+          HOME: ${{ runner.temp }}
+        run: python scripts/test_local.py

.gitignore

@@ -4,3 +4,10 @@ __pycache__/
 runs/
 .env
 *.log
+
+# v0.2 additions
+.coverage
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+*.egg-info/

CHANGELOG.md

@@ -0,0 +1,55 @@
+# Changelog
+
+## 0.2.0 — 2026-05-06
+
+Major refactor: provider abstraction + dual-host distribution + wizard.
+
+Real-account verified end-to-end: `wechat-article` creates real drafts
+on `mp.weixin.qq.com`; `xiaohongshu` creates real local drafts via the
+xhs skill's `draft.sh`. 7 integration bugs discovered + fixed during
+verification. See `docs/HANDOFF.md` "Discovered during real-account
+verification" for the full list.
+
+### Added
+
+- `core/` host-agnostic Python: manifest schema, provider registry,
+  credential vault (age-encrypted), run lifecycle, platform rules, settings,
+  wizard fragments
+- 5 bundled providers: `wechat-article`, `xiaohongshu`, `wechat-image`,
+  `x-article`, `substack`
+- `scripts/mmp.py` unified CLI: `validate`, `publish`, `setup`, `list`,
+  `resume`, `doctor`, `wizard`
+- `.claude-plugin/plugin.json` for Claude Code plugin marketplace
+- 3-stage conversational wizard (source extraction → target selection →
+  manifest assembly) + credential setup wizard
+- Manifest schema v0.2: `schema_version`, full-form/short-form targets,
+  `defaults` block, `dry-run` mode, account override per target
+- Age-encrypted vault at `~/.config/mmp/credentials.json.age`
+- GitHub Actions CI matrix (macOS + ubuntu × Python 3.10/3.11/3.12)
+- User-facing docs: `architecture.md`, `provider-contract.md`,
+  `credentials.md`, `safety-policy.md`, `manual-verification.md`
+
+### Changed
+
+- Default `mode` is `draft`; `publish` requires explicit confirmation
+- Manifest fields normalized; lock-file `manifest.lock.json` written per run
+- `runs/<ts>-<slug>/` is now self-contained: manifest, lock, packs, result,
+  log, checkpoints, artifacts
+- `mode_actual` introduces `"stub"` value to distinguish connector-not-implemented
+  draft fallbacks (x-article, substack) from real dry-run
+
+### Deprecated
+
+- `scripts/prepare_image_post.py`, `scripts/prepare_longform.py`,
+  `scripts/execute_image_post.py`, `scripts/adapt_content.py`,
+  `scripts/publish_manifest.py`, `scripts/wechat_api_draft.py` — kept as
+  thin shims; removal in v0.3
+
+### Removed
+
+- Legacy `references/*.md` (moved to `docs/` or `providers/<name>/notes.md`)
+
+## 0.1.0 — 2026-05 (pre-redesign)
+
+- Initial OpenClaw skill: prepare/execute scripts, image-post + longform
+  pipelines, WeChat API dry-run helper, local smoke test.

Makefile

@@ -1,6 +1,21 @@
-PYTHON ?= python3
+.PHONY: test lint typecheck unit smoke clean
 
-.PHONY: test
+test: lint typecheck unit smoke
 
-test:
-	$(PYTHON) scripts/test_local.py
+unit:
+	python3 -m pytest -q
+
+lint:
+	python3 -m ruff check .
+	python3 -m ruff format --check .
+
+typecheck:
+	python3 -m mypy core
+
+smoke:
+	python3 scripts/test_local.py
+
+clean:
+	rm -rf .pytest_cache .mypy_cache .ruff_cache __pycache__
+	find . -name "__pycache__" -type d -exec rm -rf {} +
+	find . -name "*.pyc" -delete

README.md

@@ -1,56 +1,121 @@
-# Multi-media Publisher / 多媒体发布
+# multi-media-publisher
 
-统一调度多平台内容发布的 OpenClaw skill。
+Publish one piece of content to many platforms — 小红书, 微信图文, 微信公众号
+文章, X Articles, Substack — through one manifest, with draft-first safety
+and an encrypted credential vault.
 
-## MVP 目标
+Works as a Claude Code plugin **and** an OpenClaw skill from the same source.
 
-- 图文内容：小红书 + 微信图文内容
-- 长文章：微信公众号文章 + X Articles + Substack 草稿
-- 未来：视频号 / 小红书视频 / 抖音 / B站 / YouTube Shorts
+## Status
 
-## 当前状态
+v0.2 — provider abstraction + 5 first-party providers + conversational
+manifest wizard + age-encrypted vault. See [`docs/HANDOFF.md`](docs/HANDOFF.md).
 
-已完成：
+## Install
 
-- Skill 骨架：`SKILL.md`
-- Manifest schema：`references/manifest-schema.md`
-- 平台矩阵：`references/platform-map.md`
-- 发布安全策略：`references/publishing-policy.md`
-- 候选技能调研：`references/candidate-skills.md`
-- 工作流规划：`references/workflows.md`
-- 示例 manifest：`examples/image-post.yaml`, `examples/longform.yaml`
-- 辅助脚本：
-  - `scripts/publish_manifest.py`：校验 manifest 并创建 run skeleton
-  - `scripts/adapt_content.py`：生成各平台 content pack 草稿
-  - `scripts/prepare_image_post.py`：生成小红书/微信图文 payload 和预览，不发布；同时生成 `wechat-article-api-bridge` payload，可被 `wechat_api_draft.py --dry-run` 直接验证
-  - `scripts/execute_image_post.py`：执行已确认的草稿动作；当前支持小红书本地草稿 + 微信图文操作指南
-  - `scripts/wechat_api_draft.py`：微信公众号 API 草稿助手，支持 dry-run；`draft-from-payload` 可读取 payload 内的 `cover`
-  - `scripts/prepare_longform.py`：生成公众号文章 / X Articles / Substack 长文 payload 和预览，不发布
-  - `scripts/test_local.py` + `Makefile`：本地 smoke test，覆盖 py_compile、image-post prepare、微信 guide、小红书本地 draft、WeChat API dry-run、longform prepare
+### As a Claude Code plugin
 
-## 基本用法
+(Marketplace submission pending — for now, clone the repo and point Claude
+Code at the directory.)
 
 ```bash
-python3 skills/multi-media-publisher/scripts/publish_manifest.py \
-  skills/multi-media-publisher/examples/image-post.yaml
+git clone https://github.com/yxliao-lewis/multi-media-publisher.git
+# Then in Claude Code: settings → plugins → load from directory
+```
+
+After v0.2.0 marketplace submission lands, the install will be:
+
+```
+/plugin install multi-media-publisher
+```
+
+### As an OpenClaw skill
+
+Clone into your skills directory:
+
+```bash
+git clone https://github.com/yxliao-lewis/multi-media-publisher.git \
+  ~/.openclaw/skills/multi-media-publisher
+```
+
+### Python deps
+
+```bash
+pip install -e ".[dev]"
+```
+
+Requires Python 3.10+.
+
+## Quickstart
 
-python3 skills/multi-media-publisher/scripts/adapt_content.py \
-  skills/multi-media-publisher/examples/longform.yaml \
-  --out /tmp/mmp-adapt
+### Conversational wizard (recommended)
 
-python3 skills/multi-media-publisher/scripts/prepare_image_post.py \
-  /path/to/image-post.yaml
+In Claude Code or OpenClaw, just say what you want:
 
-python3 skills/multi-media-publisher/scripts/execute_image_post.py \
-  /path/to/run-dir --target xiaohongshu --yes-draft
+> 帮我把这篇文章发到公众号、X 长文章、Substack 草稿。
 
-python3 skills/multi-media-publisher/scripts/wechat_api_draft.py \
-  draft-from-payload /path/to/run-dir/packs/wechat-article-api-bridge/payload.json --dry-run
+Claude reads `core/wizard/*.md` and walks you through source extraction →
+target selection → manifest assembly → draft.
 
-python3 skills/multi-media-publisher/scripts/prepare_longform.py \
-  skills/multi-media-publisher/examples/longform.yaml
+### CLI
+
+```bash
+# Validate a manifest
+mmp validate examples/longform.yaml
+
+# Configure credentials for a provider
+mmp setup wechat-article
+
+# Run a publish (defaults to draft mode in the manifest)
+mmp publish examples/longform.yaml
+
+# List providers / accounts / runs
+mmp list providers
+mmp list accounts
+mmp list runs
+
+# Self-check
+mmp doctor
+```
+
+## Safety
+
+- Default `mode: draft`. Public publishing requires explicit `mode: publish`
+  in the manifest **plus** an in-conversation confirmation.
+- Credentials are stored in `~/.config/mmp/credentials.json.age` (age-encrypted).
+- Secrets never appear in `result.json`, `publish-log.md`, or printed output.
+- Full policy: [`docs/safety-policy.md`](docs/safety-policy.md).
+
+## Architecture
+
+- [`docs/architecture.md`](docs/architecture.md) — high-level overview
+- [`docs/provider-contract.md`](docs/provider-contract.md) — write your own provider
+- [`docs/credentials.md`](docs/credentials.md) — vault and ENV usage
+- [`docs/manual-verification.md`](docs/manual-verification.md) — pre-release checklist
+- [`docs/superpowers/specs/`](docs/superpowers/specs/) — full design spec
+
+## Project layout
 
-make -C skills/multi-media-publisher test
 ```
+core/                    # host-agnostic Python (manifest, providers, vault, runs)
+providers/               # bundled first-party providers
+  wechat_article/
+  xiaohongshu/
+  wechat_image/
+  x_article/
+  substack/
+scripts/mmp.py           # CLI entry
+.claude-plugin/          # Claude Code plugin manifest
+SKILL.md                 # OpenClaw + Claude Code skill manifest
+docs/                    # user-facing docs
+tests/                   # core tests + integration tests
+```
+
+## Contributing
+
+- New provider? Read [`docs/provider-contract.md`](docs/provider-contract.md).
+- Bug or design discussion? Open an issue.
+
+## License
 
-脚本不会真实发布。真实外发必须通过已验证的平台 skill，并遵守 draft-first / confirmation-first 策略。
+MIT.