feat: complete improvement plans 001-013 (cli features, docs expansion, distribution spike) - #4
Merged
Merged
Conversation
Adds four CLI features from improvement plans 002/005/006/013: - ap-sdk init scaffolds a working plugin.ts + .gitignore with dry-run and overwrite protection - ap-sdk install records an install manifest; ap-sdk uninstall reverses only recorded files/entries and leaves foreign config intact - ap-sdk dev watches the plugin dir, rebuilds on change, survives broken plugins, and optionally reinstalls with --install - npm:<package>[@Version] as a remote source for install/check, with the same compatibility gate as GitHub sources Docs: quickstart now leads with npx ap-sdk init; installing-plugins gains a From npm section.
Fixes the broken Docs link, makes the Examples link absolute, adds a 'What you can define' feature table and an 'Already have a plugin?' porting section, and gives the npm package a README with all-absolute links. Both attribution credits preserved. (plan 001)
…ch + nav Implements docs plans 003/004/009/010/011/012: - seven Define pages (skills, commands, subagents, hooks, mcp, tools, instructions-and-files) wired into the sidebar - porting reframed as a harness-neutral hub with per-source subpages matching exactly what src/port.ts detects - generated API reference section (pnpm generate:api, runs on prebuild) - search dialog (cmd-K) on fumadocs-core's useDocsSearch, prev/next pagination, and edit-this-page links - Callout + Tabs MDX components, mobile TOC + AI copy row below xl, dead floating navbar variant removed - /docs/plugins registry driven by the ap-sdk-plugin GitHub topic and npm keyword, with filter/sort/channel badges and degraded/empty states
Checks in the 13 improvement plans with statuses updated to DONE (008 superseded by 012), plus plan 007's deliverables: the design doc, reference template tree, and draft composite action, and plan 009's tooling decision record.
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
Contributor
Commit-Check ✔️ |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Executes all 13 improvement plans in
plans/(008 superseded by 012):SDK CLI (
@jalco/ap-sdk)ap-sdk init— scaffolds a workingplugin.ts+.gitignore(dry-run, overwrite protection)ap-sdk uninstall— backed by an install manifest written byinstall; removes only recorded files/entries, leaves foreign config intactap-sdk dev— watch mode with rebuild-on-change, error recovery, and optional--installnpm:<package>[@version]as a remote source forinstall/check, same compatibility gate as GitHub sources;--ref+ npm rejected with a clear errorDocs site
jnsahajcredits preserved)src/port.tsdetectspnpm --filter @jal-co/docs generate:api, runs on prebuild)fumadocs-core'suseDocsSearch, prev/next pagination, edit-this-page linksCallout+TabsMDX components, mobile TOC + AI copy row belowxl, dead floating navbar variant removed/docs/pluginsregistry driven by theap-sdk-pluginGitHub topic + npm keyword (filter, channel filter, three sorts, degraded/empty states, hourly ISR)Distribution spike (plan 007)
plans/007-artifacts/: design doc with transcripts, reference template tree (passesap-sdk check), draft composite action (BLOCKED-ONmarker for the proposed--fail-on-warningsflag)Why
Executes the growth-focused improvement plans generated at commit
fe6fb92— features, DX, docs, and distribution. Seeplans/README.mdfor the full index and dependency notes.How
src/cli.tsand were done serially on one branchPromise.allSettled; one source failing still renders the other, both failing → degraded stateplans/009-artifacts/decision.md).tegami/changelogs: 4 minor (init, uninstall, dev, npm source) + 1 patch (package README)Testing
pnpm turbo typecheck test lint build— all green (147 tests, 26 files)plugin.tspassesap-sdk check;action.ymlparses as YAMLap-sdk check https://github.com/jal-co/agent-plugin-sdk --path packages/agent-plugin-sdk/examples/git-helper→ compatible/docs/plugins(empty state) and the API referenceTour (large PR)
plans/README.md— index + statusespackages/agent-plugin-sdk/src/{cli,scaffold-plugin,uninstall,dev,npm}.ts+ matching testsapps/docs/content/docs/— new pages +meta.jsonapps/docs/src/components/{search-dialog,docs-pagination,callout,tabs,plugin-directory}.tsxapps/docs/src/lib/github-plugins.ts,apps/docs/scripts/generate-api-docs.mjsplans/007-artifacts/,plans/009-artifacts/Operator follow-ups (from plan 007/012)
jal-co/ap-sdk-plugin-template+jal-co/ap-sdk-actionfrom the spike artifactsap-sdk-plugintopic to seed the registry