Install shared authoring skill and add retained drafts browser

This commit is contained in:
2026-10-09 01:33:59 +01:00
parent 94a76f9c5c
commit 998b0941d3
28 changed files with 787 additions and 520 deletions
+24 -11
View File
@@ -2,16 +2,16 @@
`pipelines help` lists commands; `pipelines help edit` (or `edit --help`) shows
command-specific flags and examples. Installed commands work from any directory.
The installed command is a compiled Go binary; only service lifecycle management
delegates to the private Python helper. The binary discovers its manifest through
the system command symlink. A separately `go install ./cmd/pipelines`-installed
binary can select a managed installation using `PIPELINES_PREFIX`.
The installed command is a compiled Go binary. Optional autostart uses the OS user
service manager directly. Legacy Python-managed installations require an explicit
`PIPELINES_PREFIX`; no configuration is inferred from the executable's location.
For source development, use `go run ./cmd/pipelines help`; start the native server
separately. Set `PIPELINES_URL` or pass `--url` to select another server.
## Draft-first OpenCode workflow
```sh
pipelines new # OpenCode asks what to build and names it
pipelines edit # fuzzy pipeline selection
pipelines edit "bug fix" # ask OpenCode what to change
pipelines edit "bug fix" "Add a review step"
@@ -19,19 +19,32 @@ pipelines new "release notes" "Summarize changes and notify my phone"
pipelines new "weekly digest" --template scheduled-summary
```
`new` asks for a name when omitted. `edit` accepts an exact name or ID, with names
taking precedence over numeric IDs. Both copy a definition into a private draft
and launch the host OpenCode interface. An isolated authoring workspace contains
the bundled `pipelines` skill and format reference. The CLI creates an OpenCode
session and **explicitly activates the skill with `resume=false` before opening
the interface**. It does not modify shared OpenCode configuration or copy login
credentials. Your OpenCode permissions remain in effect; auto-approval is not used.
`new` opens OpenCode immediately when its name/request is omitted. The skill asks
only for missing decisions and records the chosen name in draft metadata. `edit`
accepts an exact name or ID, with names taking precedence over numeric IDs.
Both retain private drafts and launch the host interface once with a short
`@pipelines` reference and context-file path. There is no preliminary OpenCode
API call, temporary service, session creation, or instruction preload.
`install.sh` installs/updates the global skill and format reference. Plain
`go install` users run `pipelines skill install` separately. Shared login/config
and user-modified skills are preserved; OpenCode permissions remain in effect.
The skill encourages editing only the draft, running server validation, summarizing
the changes, and leaving submission to the user. This is an instruction, not a
security sandbox: an agent with CLI/shell access can submit when explicitly asked.
Every submission, including agent-issued `submit`/`rpc`, still uses server validation.
## Drafts in the TUI
Press `d` on the dashboard or use `:drafts` to browse the same retained drafts as
`pipelines drafts`. Use `n/p` to select, `j/k` to scroll source, `e`/Enter to reopen
the existing draft, `v` for server validation, and `s` for submission confirmation.
`r` refreshes the list. Submission preserves create-only/version guards and rejects
drafts belonging to another server. An unnamed draft must be named through OpenCode
or CLI `submit --name`. Draft selection/editor completion never publishes it.
New unnamed drafts open OpenCode so the skill can name them. For named drafts,
the default editor is OpenCode; explicit `VISUAL`/`EDITOR` overrides remain.
For agents or scripts that should not open a terminal:
```sh