fengming 0.3.8 → 0.3.10

package/skills/coding-agent/SKILL.md

@@ -1,143 +0,0 @@
----
-name: coding-agent
-description: "Delegate coding work to Codex, Claude Code, or OpenCode as background workers; not simple edits or read-only code lookup."
-metadata:
-  {
-    "fengming":
-      {
-        "emoji": "🧩",
-        "requires":
-          {
-            "anyBins": ["claude", "codex", "opencode"],
-            "config": ["skills.entries.coding-agent.enabled"],
-          },
-        "install":
-          [
-            {
-              "id": "node-claude",
-              "kind": "node",
-              "package": "@anthropic-ai/claude-code",
-              "bins": ["claude"],
-              "label": "Install Claude Code CLI (npm)",
-            },
-            {
-              "id": "node-codex",
-              "kind": "node",
-              "package": "@openai/codex",
-              "bins": ["codex"],
-              "label": "Install Codex CLI (npm)",
-            },
-          ],
-      },
-  }
----
-
-# Coding Agent
-
-Use for background feature builds, PR reviews, large refactors, and issue-to-PR loops. Do not use for simple edits, read-only lookup, ACP thread-bound work, or any run inside `~/.fengming`, `$FENGMING_STATE_DIR`, or active FengMing state dirs.
-
-## Hard rules
-
-- Always launch with `background:true`.
-- Codex and OpenCode: use `pty:true`.
-- Claude Code: no PTY; use `claude --permission-mode bypassPermissions --print`.
-- Capture a real notification route before spawning.
-- Worker must send completion/failure via `fengming message send`.
-- Do not rely on heartbeat, system events, or notify-on-exit.
-- Monitor with `process`; do not kill slow workers without cause.
-- If user asked for a specific agent, use that agent.
-- If worker fails/hangs, respawn or ask; do not silently hand-code instead.
-- Never checkout branches or run background coding agents in `~/Projects/fengming`; use an isolated checkout.
-
-## Notification block
-
-Append this shape to every worker prompt with real values:
-
-```text
-Notification route:
-- channel: <notifyChannel>
-- target: <notifyTarget>
-- account: <notifyAccount or omit>
-- reply_to: <notifyReplyTo or omit>
-- thread_id: <notifyThreadId or omit>
-
-When finished, send exactly one completion or failure message using:
-fengming message send --channel <channel> --target '<target>' --message '<brief result>'
-Add --account, --reply-to, or --thread-id only when present above.
-Do not use fengming system event or heartbeat.
-```
-
-If no trustworthy route exists, say completion auto-notify is unavailable.
-
-## Launch forms
-
-Write the worker prompt to a temp file first. This avoids shell quoting bugs when the required notification block contains quotes or newlines.
-
-```bash
-PROMPT=$(mktemp -t fengming-worker-prompt.XXXXXX)
-cat >"$PROMPT" <<'EOF'
-Task.
-<notification block>
-EOF
-printf 'prompt file: %s\n' "$PROMPT"
-```
-
-Use `$PROMPT` when launching from the same shell/session. If using a separate tool call, substitute the printed path.
-
-Codex:
-
-```bash
-bash pty:true background:true workdir:/path/repo command:"codex exec - < \"$PROMPT\""
-```
-
-Claude Code:
-
-```bash
-bash background:true workdir:/path/repo command:"claude --permission-mode bypassPermissions --print < \"$PROMPT\""
-```
-
-OpenCode:
-
-```bash
-bash pty:true background:true workdir:/path/repo command:"opencode run < \"$PROMPT\""
-```
-
-## Long issue-to-PR work
-
-1. Create/reuse a GitHub issue as durable spec.
-2. Include issue URL, repo, base branch, expected PR, proof, and notification route.
-3. Tell worker to branch, implement, test, run review until no accepted actionable findings, open PR.
-4. Return issue URL and `sessionId` immediately.
-5. Monitor with `process`; cancel through Task Registry if mirrored there.
-
-## Scratch Codex
-
-Codex needs a trusted git repo:
-
-```bash
-SCRATCH=$(mktemp -d)
-git -C "$SCRATCH" init
-PROMPT=$(mktemp -t fengming-worker-prompt.XXXXXX)
-cat >"$PROMPT" <<'EOF'
-Build X.
-<notification block>
-EOF
-printf 'prompt file: %s\n' "$PROMPT"
-bash pty:true background:true workdir:$SCRATCH command:"codex exec - < \"$PROMPT\""
-```
-
-## Process actions
-
-- `list`: running/recent sessions.
-- `poll`: status.
-- `log`: output.
-- `submit`: send input + Enter.
-- `write`: raw stdin.
-- `paste`: paste text.
-- `kill`: terminate.
-
-## Status to user
-
-- Say what started, where, and `sessionId`.
-- Update only on milestone, worker question, error, user action needed, or finish.
-- If killed, say why.

package/skills/diagram-maker/SKILL.md

@@ -1,53 +0,0 @@
----
-name: diagram-maker
-description: Create SVG/HTML or Excalidraw diagrams for concepts, architecture, flows, and whiteboards.
-metadata: { "fengming": { "emoji": "🧭" } }
----
-
-# Diagram Maker
-
-Create diagrams as artifacts, not prose. Choose one output mode:
-
-- `clean-svg`: educational concepts, physical systems, processes, lifecycle, simple data flow.
-- `architecture-svg`: software/cloud/infra topology, services, databases, queues, trust zones.
-- `excalidraw`: editable hand-drawn whiteboard, flowchart, sequence, architecture sketch.
-
-Routing
-
-- User wants editable/collaborative: choose Excalidraw.
-- User wants polished standalone browser output: choose SVG/HTML.
-- Software architecture with infra components: choose architecture SVG.
-- Science, product, process, concept map, physical object: choose clean SVG.
-- Unsure: ask one short question only if output format matters; otherwise choose clean SVG.
-
-Workflow
-
-1. Extract nodes, groups, labels, and directed relationships.
-2. Pick layout first: left-to-right, top-down, hub-spoke, swimlanes, layered stack, sequence.
-3. Keep labels short. Prefer 5-9 main elements over dense diagrams.
-4. Generate the file at the requested path, or `./diagram.html` / `./diagram.excalidraw`.
-5. Verify syntax by opening/parsing when feasible.
-
-SVG/HTML rules
-
-- Single standalone `.html` file with inline CSS and inline SVG.
-- No external fonts, JS, images, gradients, glows, decorative blobs, or remote assets.
-- Use semantic colors, not rainbow sequences: neutral, input, process, storage, external, risk.
-- Draw connectors before nodes so arrows sit behind boxes.
-- Every connector path has `fill="none"` and a marker arrow when directed.
-- Leave 24px text padding inside boxes; do not let text touch borders.
-- Legend only when symbols/colors are not obvious.
-
-SVG template
-
-Use `references/svg-template.md` as the wrapper and replace `<!-- SVG -->`.
-
-Excalidraw rules
-
-- Save `.excalidraw` JSON with `type`, `version`, `source`, `elements`, and `appState`.
-- Use bound text for shape labels. Do not use a nonstandard `label` property.
-- Keep bound text immediately after its container in the elements array.
-- Minimum labeled shape: 120x60. Minimum body text: 16px.
-- Use roughness `1`, `fontFamily: 1`, and simple fills.
-
-For exact Excalidraw element snippets, read `references/excalidraw-patterns.md`.

package/skills/diagram-maker/references/excalidraw-patterns.md

@@ -1,85 +0,0 @@
-# Excalidraw Patterns
-
-Envelope:
-
-```json
-{
-  "type": "excalidraw",
-  "version": 2,
-  "source": "fengming/diagram-maker",
-  "elements": [],
-  "appState": { "viewBackgroundColor": "#ffffff" }
-}
-```
-
-Labeled rounded rectangle:
-
-```json
-{
-  "type": "rectangle",
-  "id": "svc",
-  "x": 100,
-  "y": 100,
-  "width": 180,
-  "height": 72,
-  "roundness": { "type": 3 },
-  "backgroundColor": "#a5d8ff",
-  "fillStyle": "solid",
-  "strokeWidth": 2,
-  "roughness": 1,
-  "opacity": 100,
-  "boundElements": [{ "id": "svc_text", "type": "text" }]
-}
-```
-
-Bound text:
-
-```json
-{
-  "type": "text",
-  "id": "svc_text",
-  "x": 112,
-  "y": 124,
-  "width": 156,
-  "height": 24,
-  "text": "API service",
-  "originalText": "API service",
-  "fontSize": 20,
-  "fontFamily": 1,
-  "strokeColor": "#1e1e1e",
-  "textAlign": "center",
-  "verticalAlign": "middle",
-  "containerId": "svc",
-  "autoResize": true
-}
-```
-
-Bound arrow:
-
-```json
-{
-  "type": "arrow",
-  "id": "a1",
-  "x": 280,
-  "y": 136,
-  "width": 140,
-  "height": 0,
-  "points": [
-    [0, 0],
-    [140, 0]
-  ],
-  "endArrowhead": "arrow",
-  "startBinding": { "elementId": "svc", "fixedPoint": [1, 0.5] },
-  "endBinding": { "elementId": "db", "fixedPoint": [0, 0.5] }
-}
-```
-
-Palette:
-
-- Primary/input: `#a5d8ff`
-- Process: `#d0bfff`
-- Success/output: `#b2f2bb`
-- Storage/data: `#c3fae8`
-- External/warning: `#ffd8a8`
-- Error/risk: `#ffc9c9`
-- Note/decision: `#fff3bf`

package/skills/diagram-maker/references/svg-template.md

@@ -1,112 +0,0 @@
-# SVG HTML Template
-
-Copy this to a `.html` file and replace `<!-- SVG -->`.
-
-```html
-<!doctype html>
-<meta charset="utf-8" />
-<meta name="viewport" content="width=device-width, initial-scale=1" />
-<title>Diagram</title>
-<style>
-  :root {
-    color-scheme: light dark;
-    --bg: #f8fafc;
-    --fg: #172033;
-    --muted: #5b6475;
-    --line: #64748b;
-    --neutral: #e2e8f0;
-    --input: #bfdbfe;
-    --process: #c7d2fe;
-    --storage: #99f6e4;
-    --external: #fde68a;
-    --risk: #fecaca;
-  }
-  @media (prefers-color-scheme: dark) {
-    :root {
-      --bg: #0f172a;
-      --fg: #e5e7eb;
-      --muted: #a3adbd;
-      --line: #94a3b8;
-      --neutral: #334155;
-      --input: #1d4ed8;
-      --process: #4338ca;
-      --storage: #0f766e;
-      --external: #92400e;
-      --risk: #991b1b;
-    }
-  }
-  body {
-    margin: 0;
-    background: var(--bg);
-    color: var(--fg);
-    font:
-      14px/1.4 ui-sans-serif,
-      system-ui,
-      -apple-system,
-      BlinkMacSystemFont,
-      "Segoe UI",
-      sans-serif;
-  }
-  main {
-    max-width: 980px;
-    margin: 32px auto;
-    padding: 0 20px;
-  }
-  svg {
-    width: 100%;
-    height: auto;
-    display: block;
-  }
-  .title {
-    font-size: 20px;
-    font-weight: 650;
-    fill: var(--fg);
-  }
-  .label {
-    font-size: 14px;
-    font-weight: 600;
-    fill: var(--fg);
-  }
-  .small {
-    font-size: 12px;
-    fill: var(--muted);
-  }
-  .node {
-    stroke: var(--line);
-    stroke-width: 1;
-  }
-  .neutral {
-    fill: var(--neutral);
-  }
-  .input {
-    fill: var(--input);
-  }
-  .process {
-    fill: var(--process);
-  }
-  .storage {
-    fill: var(--storage);
-  }
-  .external {
-    fill: var(--external);
-  }
-  .risk {
-    fill: var(--risk);
-  }
-  .edge {
-    stroke: var(--line);
-    stroke-width: 1.5;
-    fill: none;
-  }
-  .zone {
-    fill: none;
-    stroke: var(--line);
-    stroke-width: 1;
-    stroke-dasharray: 6 5;
-    opacity: 0.8;
-  }
-</style>
-<main>
-  <!-- SVG -->
-</main>
-```

package/skills/gemini/SKILL.md

@@ -1,47 +0,0 @@
----
-name: gemini
-description: "Gemini CLI one-shot prompts, summaries, generation, skills, hooks, MCP, or Gemma routing."
-homepage: https://ai.google.dev/
-metadata:
-  {
-    "fengming":
-      {
-        "emoji": "✨",
-        "requires": { "bins": ["gemini"] },
-        "install":
-          [
-            {
-              "id": "brew",
-              "kind": "brew",
-              "formula": "gemini-cli",
-              "bins": ["gemini"],
-              "label": "Install Gemini CLI (brew)",
-            },
-          ],
-      },
-  }
----
-
-# Gemini CLI
-
-Use Gemini in headless one-shot mode. Positional text starts interactive mode; use `-p/--prompt`.
-
-Quick start
-
-- `gemini -p "Answer this question..."`
-- `gemini -m <model> -p "Prompt..."`
-- `gemini -p "Return JSON" --output-format json`
-- stdin appends to `-p`: `cat notes.md | gemini -p "Summarize"`
-
-Extensions
-
-- List: `gemini --list-extensions`
-- Manage: `gemini extensions <command>`
-- Skills: `gemini skills <command>`
-- Hooks: `gemini hooks <command>`
-- MCP: `gemini mcp <command>`
-
-Notes
-
-- If auth is required, run `gemini` once interactively and follow the login flow.
-- Avoid `--yolo` for safety.

package/skills/gh-issues/SKILL.md

@@ -1,213 +0,0 @@
----
-name: gh-issues
-description: "Fetch GitHub issues, select candidates, spawn background fix agents, open PRs, and optionally process PR review comments."
-user-invocable: true
-metadata:
-  {
-    "fengming":
-      {
-        "requires": { "bins": ["git", "gh"] },
-        "primaryEnv": "GH_TOKEN",
-        "install":
-          [
-            {
-              "id": "brew",
-              "kind": "brew",
-              "formula": "gh",
-              "bins": ["gh"],
-              "label": "Install GitHub CLI (brew)",
-            },
-          ],
-      },
-  }
----
-
-# gh-issues
-
-Use for issue-to-PR automation. Prefer `gh` CLI; fall back to `gh api` only when a high-level command lacks the needed field.
-
-## Arguments
-
-- positional `owner/repo`: optional; else infer from `git remote get-url origin`.
-- `--label <label>`: filter.
-- `--limit <n>`: default 10.
-- `--milestone <title>`: filter.
-- `--assignee <login|@me>`: filter.
-- `--state open|closed|all`: default open.
-- `--fork <owner/repo>`: push branches to fork, PR to source.
-- `--watch`: poll issues + reviews.
-- `--interval <minutes>`: default 5.
-- `--dry-run`: list only.
-- `--yes`: no confirmation.
-- `--reviews-only`: skip issue fixing; handle PR reviews.
-- `--cron`: spawn and exit; implies `--yes`.
-- `--model <id>`: pass to workers when supported.
-- `--notify-channel <id>`: optional final notification target.
-
-## Phase 1: resolve repo
-
-```bash
-git remote get-url origin
-if [ -z "${GH_TOKEN:-}" ]; then
-  CONFIG_PATH="${FENGMING_CONFIG_PATH:-${FENGMING_STATE_DIR:-$HOME/.fengming}/fengming.json}"
-  GH_TOKEN=$(jq -r '.skills.entries["gh-issues"].apiKey // empty' "$CONFIG_PATH" 2>/dev/null || true)
-  if [ -n "$GH_TOKEN" ]; then export GH_TOKEN; fi
-fi
-gh auth status
-gh repo view OWNER/REPO --json nameWithOwner,defaultBranchRef
-```
-
-If `gh auth status` fails and `GH_TOKEN` is missing, stop and ask for GitHub auth/config.
-
-Derived:
-
-- `SOURCE_REPO`: issue repo.
-- `PUSH_REPO`: fork if set, else source.
-- `BASE_BRANCH`: source default branch unless user says otherwise.
-- `PUSH_REMOTE`: `fork` in fork mode, else `origin`.
-
-Stop on dirty worktree unless user confirms that workers should ignore uncommitted changes.
-
-In fork mode, do not mutate remotes before confirmation or during `--dry-run`.
-
-Verify auth/read access only:
-
-```bash
-gh auth token >/dev/null || test -n "${GH_TOKEN:-}"
-gh repo view "$PUSH_REPO" --json nameWithOwner
-git ls-remote --exit-code origin HEAD
-```
-
-## Phase 2: fetch issues
-
-Build filters and fetch:
-
-```bash
-gh issue list --repo "$SOURCE_REPO" --state open --limit 10 --json number,title,labels,url,body,assignees,milestone
-```
-
-Add `--label`, `--milestone`, `--assignee`, `--state`, `--limit` as requested. `gh issue list` already excludes PRs.
-
-If none found: report no matches. If `--dry-run`: show compact list and stop.
-
-## Phase 3: avoid duplicate work
-
-For each candidate:
-
-```bash
-gh pr list --repo "$SOURCE_REPO" --search "$SOURCE_REPO#<n>" --state open --json number,url,title,headRefName
-gh pr list --repo "$SOURCE_REPO" --head "fix/issue-<n>" --state open --json number,url
-gh api "repos/$PUSH_REPO/branches/fix/issue-<n>" >/dev/null
-```
-
-Skip candidates with an open PR, existing branch, or active local claim.
-
-Claim file:
-
-```text
-${FENGMING_STATE_DIR:-$HOME/.fengming}/gh-issues-<owner>-<repo>.json
-```
-
-Expire claims older than 2 hours.
-Create the parent directory before writing.
-
-## Phase 4: confirm
-
-Unless `--yes` or `--cron`, ask user to choose:
-
-- `all`
-- comma-separated issue numbers
-- `cancel`
-
-After confirmation, in fork mode, configure the push remote before handing work to agents:
-
-```bash
-gh auth setup-git
-git remote get-url fork || git remote add fork "https://github.com/$PUSH_REPO.git"
-git remote set-url fork "https://github.com/$PUSH_REPO.git"
-git ls-remote --exit-code fork HEAD
-```
-
-## Phase 5: spawn workers
-
-Launch up to 8 background workers. Do not block on each worker when `--cron`.
-
-Before each spawn, write a claim for `SOURCE_REPO#<n>` with the current ISO timestamp. After a worker reports PR/failure, remove or update the claim. This prevents watch/cron overlap before a branch or PR exists.
-
-Worker prompt must include:
-
-- issue URL, title, body, labels.
-- `SOURCE_REPO`, `PUSH_REPO`, `BASE_BRANCH`, `PUSH_REMOTE`, fork mode.
-- target branch `fix/issue-<n>`.
-- required proof and PR body.
-- notification route.
-
-Worker instructions:
-
-```text
-Use gh and git. Do not handwave.
-Checkout/create fix/issue-<n> from BASE_BRANCH.
-Implement minimal fix.
-Run relevant tests.
-Commit with conventional message.
-Push to PUSH_REMOTE.
-Open PR against SOURCE_REPO BASE_BRANCH.
-PR body: Summary + Verification + Fixes SOURCE_REPO#<n>.
-Report PR URL or failure reason.
-Send completion/failure with fengming message send if route provided.
-```
-
-Use `coding-agent` launch rules when available.
-
-## Phase 6: collect
-
-Poll workers with `process` or task registry. Report:
-
-- issue number + title.
-- status: PR opened, skipped, failed, timed out.
-- PR URL or reason.
-
-Notify channel only with final compact summary.
-
-## Reviews-only / watch reviews
-
-Discover open PRs:
-
-```bash
-gh pr list --repo "$SOURCE_REPO" --state open --json number,title,url,headRefName,reviewDecision \
-  --jq '[.[] | select(.headRefName | startswith("fix/issue-"))]'
-```
-
-Fetch review threads/comments:
-
-```bash
-gh pr view <n> --repo "$SOURCE_REPO" --json url,headRefName,comments,reviews
-gh api "repos/$SOURCE_REPO/pulls/<n>/comments"
-gh api "repos/$SOURCE_REPO/issues/<n>/comments"
-```
-
-Only process `fix/issue-*` PRs created by this workflow unless the user explicitly named PR numbers. Group actionable comments by PR. Ignore praise, status, duplicates, and already-addressed comments. Spawn one worker per selected/scoped PR, same background rules.
-
-Review worker instructions:
-
-```text
-Checkout PR branch.
-Read all actionable review comments.
-Patch minimal changes.
-Run relevant tests.
-Commit and push normally; do not force-push unless explicitly told.
-Reply to addressed comments with fix + commit/file reference.
-Report comments addressed/skipped and proof.
-```
-
-## Watch mode
-
-Loop:
-
-1. Fetch issues.
-2. Spawn eligible issue workers.
-3. Process actionable PR reviews.
-4. Sleep `--interval`.
-5. Stop when user says stop.
-
-Keep cumulative summary small.