Reorganize repo structure and standards references

This commit is contained in:
david committed 2026-06-29 05:03:42 +02:00
1 parent 3cb93a81be
commit be2054274d
5885 files changed
+2588 -195

No files matched your search

@@ -0,0 +1,30 @@
# @toolctrl/plugin-sdk
Phase 06 Task #21 foundation — TypeScript SDK plugin authors import against.
## Scope (foundation)
- Type definitions: `HostApi`, `PluginContext`, `HookHandler`
- Example plugin scaffold under `examples/hello-world/` (TypeScript source + manifest)
## How plugin authors use this
1. `pnpm add -D @toolctrl/plugin-sdk`
2. Implement a hook handler:
```ts
import type { HookHandler } from "@toolctrl/plugin-sdk";
export const handler: HookHandler<{ name: string }, { greeting: string }> = (input, ctx) => {
ctx.log.info({ name: input.name }, "hello");
return { greeting: `Hello, ${input.name}!` };
};
```
3. Build to WASM with `wasm-pack`, AssemblyScript, or similar (operator-side CLI tooling is **deferred**, see `docs/improvement-plan/06-plugin-system/wasm-sandbox.md`).
4. Sign the resulting `.wasm` and ship to operator alongside the `plugin.toml` manifest.
## Deferred
- AssemblyScript/Rust toolchain bindings → Phase 06 Task #23 docs follow-up
- Plugin build/sign/publish CLI → backlog