fengming 0.3.8 → 0.3.9

package/dist/zod-schema.core-BGLctDlK.d.ts

@@ -1,166 +0,0 @@
-import { B as ZodLiteral, C as ZodEnum, Q as ZodOptional, Y as ZodNumber, Z as ZodObject, bt as ZodUnion, c as ZodBoolean, ea as $catchall, it as ZodRecord, na as $strict, q as ZodNull, r as ZodArray, st as ZodString, xt as ZodUnknown, y as ZodDiscriminatedUnion, zr as $RefinementCtx } from "./schemas-CkRCGSfd.js";
-
-//#region src/config/zod-schema.core.d.ts
-declare const DmConfigSchema: ZodObject<{
-  historyLimit: ZodOptional<ZodNumber>;
-}, $strict>;
-declare const GroupPolicySchema: ZodEnum<{
-  disabled: "disabled";
-  allowlist: "allowlist";
-  open: "open";
-}>;
-declare const DmPolicySchema: ZodEnum<{
-  disabled: "disabled";
-  allowlist: "allowlist";
-  pairing: "pairing";
-  open: "open";
-}>;
-declare const ContextVisibilityModeSchema: ZodEnum<{
-  all: "all";
-  allowlist: "allowlist";
-  allowlist_quote: "allowlist_quote";
-}>;
-declare const BlockStreamingCoalesceSchema: ZodObject<{
-  minChars: ZodOptional<ZodNumber>;
-  maxChars: ZodOptional<ZodNumber>;
-  idleMs: ZodOptional<ZodNumber>;
-}, $strict>;
-declare const ReplyRuntimeConfigSchemaShape: {
-  historyLimit: ZodOptional<ZodNumber>;
-  dmHistoryLimit: ZodOptional<ZodNumber>;
-  contextVisibility: ZodOptional<ZodEnum<{
-    all: "all";
-    allowlist: "allowlist";
-    allowlist_quote: "allowlist_quote";
-  }>>;
-  dms: ZodOptional<ZodRecord<ZodString, ZodOptional<ZodObject<{
-    historyLimit: ZodOptional<ZodNumber>;
-  }, $strict>>>>;
-  textChunkLimit: ZodOptional<ZodNumber>;
-  chunkMode: ZodOptional<ZodEnum<{
-    length: "length";
-    newline: "newline";
-  }>>;
-  blockStreaming: ZodOptional<ZodBoolean>;
-  blockStreamingCoalesce: ZodOptional<ZodObject<{
-    minChars: ZodOptional<ZodNumber>;
-    maxChars: ZodOptional<ZodNumber>;
-    idleMs: ZodOptional<ZodNumber>;
-  }, $strict>>;
-  responsePrefix: ZodOptional<ZodString>;
-  mediaMaxMb: ZodOptional<ZodNumber>;
-};
-declare const MarkdownConfigSchema: ZodOptional<ZodObject<{
-  tables: ZodOptional<ZodEnum<{
-    code: "code";
-    block: "block";
-    off: "off";
-    bullets: "bullets";
-  }>>;
-}, $strict>>;
-declare const TtsProviderSchema: ZodString;
-declare const TtsModeSchema: ZodEnum<{
-  all: "all";
-  final: "final";
-}>;
-declare const TtsAutoSchema: ZodEnum<{
-  off: "off";
-  always: "always";
-  inbound: "inbound";
-  tagged: "tagged";
-}>;
-declare const TtsConfigSchema: ZodOptional<ZodObject<{
-  auto: ZodOptional<ZodEnum<{
-    off: "off";
-    always: "always";
-    inbound: "inbound";
-    tagged: "tagged";
-  }>>;
-  enabled: ZodOptional<ZodBoolean>;
-  mode: ZodOptional<ZodEnum<{
-    all: "all";
-    final: "final";
-  }>>;
-  provider: ZodOptional<ZodString>;
-  persona: ZodOptional<ZodString>;
-  personas: ZodOptional<ZodRecord<ZodString, ZodObject<{
-    label: ZodOptional<ZodString>;
-    description: ZodOptional<ZodString>;
-    provider: ZodOptional<ZodString>;
-    fallbackPolicy: ZodOptional<ZodUnion<readonly [ZodLiteral<"preserve-persona">, ZodLiteral<"provider-defaults">, ZodLiteral<"fail">]>>;
-    prompt: ZodOptional<ZodObject<{
-      profile: ZodOptional<ZodString>;
-      scene: ZodOptional<ZodString>;
-      sampleContext: ZodOptional<ZodString>;
-      style: ZodOptional<ZodString>;
-      accent: ZodOptional<ZodString>;
-      pacing: ZodOptional<ZodString>;
-      constraints: ZodOptional<ZodArray<ZodString>>;
-    }, $strict>>;
-    providers: ZodOptional<ZodRecord<ZodString, ZodObject<{
-      apiKey: ZodOptional<ZodUnion<readonly [ZodString, ZodDiscriminatedUnion<[ZodObject<{
-        source: ZodLiteral<"env">;
-        provider: ZodString;
-        id: ZodString;
-      }, $strict>, ZodObject<{
-        source: ZodLiteral<"file">;
-        provider: ZodString;
-        id: ZodString;
-      }, $strict>, ZodObject<{
-        source: ZodLiteral<"exec">;
-        provider: ZodString;
-        id: ZodString;
-      }, $strict>], "source">]>>;
-    }, $catchall<ZodUnion<readonly [ZodString, ZodNumber, ZodBoolean, ZodNull, ZodArray<ZodUnknown>, ZodRecord<ZodString, ZodUnknown>]>>>>>;
-  }, $strict>>>;
-  summaryModel: ZodOptional<ZodString>;
-  modelOverrides: ZodOptional<ZodObject<{
-    enabled: ZodOptional<ZodBoolean>;
-    allowText: ZodOptional<ZodBoolean>;
-    allowProvider: ZodOptional<ZodBoolean>;
-    allowVoice: ZodOptional<ZodBoolean>;
-    allowModelId: ZodOptional<ZodBoolean>;
-    allowVoiceSettings: ZodOptional<ZodBoolean>;
-    allowNormalization: ZodOptional<ZodBoolean>;
-    allowSeed: ZodOptional<ZodBoolean>;
-  }, $strict>>;
-  providers: ZodOptional<ZodRecord<ZodString, ZodObject<{
-    apiKey: ZodOptional<ZodUnion<readonly [ZodString, ZodDiscriminatedUnion<[ZodObject<{
-      source: ZodLiteral<"env">;
-      provider: ZodString;
-      id: ZodString;
-    }, $strict>, ZodObject<{
-      source: ZodLiteral<"file">;
-      provider: ZodString;
-      id: ZodString;
-    }, $strict>, ZodObject<{
-      source: ZodLiteral<"exec">;
-      provider: ZodString;
-      id: ZodString;
-    }, $strict>], "source">]>>;
-  }, $catchall<ZodUnion<readonly [ZodString, ZodNumber, ZodBoolean, ZodNull, ZodArray<ZodUnknown>, ZodRecord<ZodString, ZodUnknown>]>>>>>;
-  prefsPath: ZodOptional<ZodString>;
-  maxTextLength: ZodOptional<ZodNumber>;
-  timeoutMs: ZodOptional<ZodNumber>;
-}, $strict>>;
-declare const requireOpenAllowFrom: (params: {
-  policy?: string;
-  allowFrom?: Array<string | number>;
-  ctx: $RefinementCtx;
-  path: Array<string | number>;
-  message: string;
-}) => void;
-/**
- * Validate that dmPolicy="allowlist" has a non-empty allowFrom array.
- * Without this, all DMs are silently dropped because the allowlist is empty
- * and no senders can match.
- */
-declare const requireAllowlistAllowFrom: (params: {
-  policy?: string;
-  allowFrom?: Array<string | number>;
-  ctx: $RefinementCtx;
-  path: Array<string | number>;
-  message: string;
-}) => void;
-//#endregion
-export { GroupPolicySchema as a, TtsAutoSchema as c, TtsProviderSchema as d, requireAllowlistAllowFrom as f, DmPolicySchema as i, TtsConfigSchema as l, ContextVisibilityModeSchema as n, MarkdownConfigSchema as o, requireOpenAllowFrom as p, DmConfigSchema as r, ReplyRuntimeConfigSchemaShape as s, BlockStreamingCoalesceSchema as t, TtsModeSchema as u };

package/skills/canvas/SKILL.md

@@ -1,78 +0,0 @@
----
-name: canvas
-description: "Present HTML on connected FengMing node canvases, navigate/eval/snapshot, and debug canvas host URLs."
-metadata: { "fengming": { "emoji": "🖼️" } }
----
-
-# Canvas
-
-Use canvas to show HTML on connected Mac/iOS/Android nodes.
-
-## Model
-
-- Canvas host serves files from `plugins.entries.canvas.config.host.root`.
-- Canvas routes live on the Gateway HTTP port (`gateway.port`, default `18789`).
-- Node bridge sends canvas URLs to connected node apps.
-- Node apps render URLs in a WebView.
-- Host name follows `gateway.bind`: loopback local only, LAN IP for LAN, Tailscale host for tailnet, auto picks best route.
-- Localhost URLs only work for a node on the same machine.
-- Paired nodes normally receive node-scoped `pluginSurfaceUrls.canvas` capability URLs; prefer those when available.
-
-## Config
-
-Active config: `$FENGMING_CONFIG_PATH` or `~/.fengming/fengming.json`.
-
-```json
-{
-  "plugins": {
-    "entries": {
-      "canvas": {
-        "config": {
-          "host": {
-            "enabled": true,
-            "root": "~/.fengming/canvas",
-            "liveReload": true
-          }
-        }
-      }
-    }
-  },
-  "gateway": { "bind": "auto" }
-}
-```
-
-## Actions
-
-- `present`: show canvas, optional URL.
-- `hide`: hide canvas.
-- `navigate`: open new URL.
-- `eval`: run JavaScript in current canvas.
-- `snapshot`: capture screenshot.
-
-## Workflow
-
-1. Ensure Canvas plugin host is enabled.
-2. Put HTML/CSS/JS under `plugins.entries.canvas.config.host.root` or the default state canvas dir.
-3. Use a route reachable by the target node.
-4. Present the hosted URL: `/__fengming__/canvas/<file>.html`.
-5. Use `snapshot` when the user needs proof.
-
-## URL shape
-
-```text
-http://<gateway-host>:<gateway.port>/__fengming__/canvas/index.html
-http://<gateway-host>:<gateway.port>/__fengming__/canvas/games/snake.html
-```
-
-Path mapping:
-
-- `/__fengming__/canvas/index.html` -> `<canvas host root>/index.html`
-- `/__fengming__/canvas/games/snake.html` -> `<canvas host root>/games/snake.html`
-
-## Troubleshooting
-
-- Node sees localhost but is remote: fix `gateway.bind` or public URL, regenerate URL.
-- LAN node cannot load: verify same network, firewall, Gateway port, and auth/capability URL.
-- Tailnet node cannot load: verify Tailscale status and advertised host.
-- Blank page: open URL locally, check browser console, then snapshot node.
-- Live reload missing: verify `liveReload` and file write under root.

package/skills/clawhub/SKILL.md

@@ -1,77 +0,0 @@
----
-name: clawhub
-description: "Search, install, update, sync, or publish agent skills with the ClawHub CLI and registry."
-metadata:
-  {
-    "fengming":
-      {
-        "requires": { "bins": ["clawhub"] },
-        "install":
-          [
-            {
-              "id": "node",
-              "kind": "node",
-              "package": "clawhub",
-              "bins": ["clawhub"],
-              "label": "Install ClawHub CLI (npm)",
-            },
-          ],
-      },
-  }
----
-
-# ClawHub CLI
-
-Install
-
-```bash
-npm i -g clawhub
-```
-
-Auth (publish)
-
-```bash
-clawhub login
-clawhub whoami
-```
-
-Search
-
-```bash
-clawhub search "postgres backups"
-```
-
-Install
-
-```bash
-clawhub install my-skill
-clawhub install my-skill --version 1.2.3
-```
-
-Update (hash-based match + upgrade)
-
-```bash
-clawhub update my-skill
-clawhub update my-skill --version 1.2.3
-clawhub update --all
-clawhub update my-skill --force
-clawhub update --all --no-input --force
-```
-
-List
-
-```bash
-clawhub list
-```
-
-Publish
-
-```bash
-clawhub publish ./my-skill --slug my-skill --name "My Skill" --version 1.2.0 --changelog "Fixes + docs"
-```
-
-Notes
-
-- Default registry: https://clawhub.com (override with CLAWHUB_REGISTRY or --registry)
-- Default workdir: cwd (falls back to FengMing workspace); install dir: ./skills (override with --workdir / --dir / CLAWHUB_WORKDIR)
-- Update command hashes local files, resolves matching version, and upgrades to latest unless --version is set

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`