chore(release): version packages

[github-actions]

Summary

Merge this PR to publish the versioned packages.

• @jal-co/docs: 0.0.1 → 0.0.2
• @jalco/ap-sdk: 0.2.0 → 0.3.0

Changelogs

2026-06-30-companion-files.md

Ship companion files with a plugin

Plugin.files bundles companion files at the plugin root — hook scripts,
reference docs, JSON read by the plugin's instructions — emitted into every
harness build tree at their path. The new readDir helper loads a whole src/
folder (recursively, preserving the executable bit), so hooks can reference their
scripts via the harness's plugin-root variable (e.g. ${CLAUDE_PLUGIN_ROOT}/…).

2026-06-30-file-loading-and-hook-events.md

Load plugin text from files, plus more hook events

• New readText / readTextFrom helpers load instructions, skill and command
  bodies, and subagent prompts from a src/ folder instead of inlining big
  strings — resolve paths relative to the plugin via import.meta.url.
• New portable hook events: notification, permission-request,
  subagent-stop, pre-compact, and session-end, translated to each harness's
  native names. A harness with no native form for an event now emits a structured
  warning and skips it instead of guessing.

2026-06-30-frontmatter-passthrough.md

Frontmatter passthrough on skills and subagents

defineSkill and defineSubagent accept a frontmatter escape hatch for extra
native frontmatter fields the SDK doesn't model (e.g. effort, a nested
stage: block). It's merged into every skill's SKILL.md and into subagent YAML
frontmatter (Claude, OpenCode, Copilot, Gemini); the SDK's own fields win on a
key clash.

2026-06-30-install-companion-files.md

Install companion files into local harness dirs

ap-sdk install now relocates a plugin's companion files (plugin.files) into
each harness's config root (e.g. .claude/, .gemini/), preserving each file's
subpath and executable bit — not just into the build tree. Harnesses declare the
location via a new optional filesInstallDir(scope) on the Harness contract.

2026-06-30-port-command.md

ap-sdk port — generate a portable plugin from an existing one

New ap-sdk port [dir] reads an existing plugin/config in any harness's native
layout (auto-detected: Claude Code, Codex, Gemini, Copilot, Cursor, Windsurf,
OpenCode, Pi, or a generic skills/commands/agents tree) and writes a plugin.ts
that loads its files — mapping the manifest, instruction file, **/SKILL.md
skills, commands, agents (model + extra frontmatter), and hooks (native event
names → portable), and shipping companion directories via readDir. Adds
readBody / readBodyFrom helpers that load a body from its native
frontmatter + body file.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
agent-plugin-sdk-docs	Ready	Preview, Comment	Jul 1, 2026 5:27am

[github-actions]

Commit-Check ✔️