@oisincoveney/pipeline 1.20.0 → 1.22.0

package/README.md

@@ -1,16 +1,15 @@
 # @oisincoveney/pipeline
 
-Config-driven multi-agent pipeline runner for repository work. The source of
-truth is three YAML files: `.pipeline/runners.yaml` declares runner adapters,
-`.pipeline/profiles.yaml` declares reusable profiles and their grants, and
-`.pipeline/pipeline.yaml` declares orchestration, workflows, gates, hooks, and
-artifacts.
+Config-driven multi-agent pipeline runner for repository work. Runtime config is
+owned by the installed `@oisincoveney/pipeline` package. Repo-local `.pipeline`
+paths are runtime artifact locations only; they are not the runtime config
+source.
 
 ## Requirements
 
 - Bun 1.1 or newer
 - Node.js 22.13 or newer
-- `npx`, `backlog`, `uvx`, and Docker on `PATH` for default skills and MCP setup
+- `npx`, `backlog`, `uvx`, and Docker on `PATH` for default skills and MCP gateway setup
 - At least one configured runner CLI on `PATH`: `codex`, `opencode`, `kimi`,
   `pi`, or a declared command runner
 
@@ -22,33 +21,32 @@ bun install --frozen-lockfile
 
 ## Start A Repository
 
-Scaffold the default YAML workflow:
+Initialize package-owned pipeline support:
 
 ```shell
 pipe init
 ```
 
 `pipe init` installs default project skills with
-`npx skills add oisincoveney/skills` and registers default MCP servers with the
-MCPM CLI from https://mcpm.sh/. Default profiles point at the installed
-`.agents/skills/<skill>/SKILL.md` files in the target repository. The package
-invokes MCPM through `uvx --python 3.12 mcpm`, so generated `.mcp.json` entries
-do not depend on a globally installed `mcpm` binary. The default Qdrant/memory
-MCP is the Momokaya remote endpoint
-`https://memory-mcp.momokaya.ee/mcp/`.
-
-The default GitHub MCP registration uses GitHub's official container in
-read-only mode and reads `GITHUB_PERSONAL_ACCESS_TOKEN` from the environment.
-The Momokaya gateway endpoint is protected by Traefik HTTP Basic auth. Set
-`PIPELINE_MCP_GATEWAY_AUTHORIZATION` to the full HTTP `Authorization` header
-value before starting Codex or OpenCode:
+`npx skills add oisincoveney/skills`, then writes generated OpenCode and Codex
+command surfaces plus their singleton `pipeline-gateway` MCP entries. OpenCode
+is the package default runtime; Codex remains a compatibility runner and host
+surface. The command does not create repo-local `.pipeline` config files.
+
+The default MCP gateway can run locally or point at the hosted Momokaya
+gateway. Set `PIPELINE_MCP_GATEWAY_AUTHORIZATION` to the full HTTP
+`Authorization` header value before starting Codex or OpenCode when using a
+protected gateway:
 
 ```shell
 export PIPELINE_MCP_GATEWAY_AUTHORIZATION="Basic $(printf '%s' 'user:password' | base64)"
 ```
 
-`pipe init` writes project-level Codex and OpenCode config that points at the
-singleton `pipeline-gateway` MCP server.
+To refresh or check generated host files later, use:
+
+```shell
+pipe install-commands --host all --check
+```
 
 Check local prerequisites and config health:
 
@@ -136,9 +134,12 @@ validation, contract-version checks, and JSON Schema generation.
 Use `PIPELINE_TARGET_PATH=/path/to/worktree` when the checked-out target repo is
 mounted somewhere other than the process working directory.
 
-## Minimal YAML
+## Custom YAML Parts
+
+Runtime execution uses package-owned defaults. Tests and advanced embedding code
+can still parse explicit YAML parts with `parsePipelineConfigParts()`.
 
-`.pipeline/runners.yaml`:
+`runners`:
 
 ```yaml
 version: 1
@@ -156,7 +157,7 @@ runners:
       output_formats: [text, json, jsonl, json_schema]
 ```
 
-`.pipeline/profiles.yaml`:
+`profiles`:
 
 ```yaml
 version: 1
@@ -182,7 +183,7 @@ profiles:
       format: text
 ```
 
-`.pipeline/pipeline.yaml`:
+Example workflow shape:
 
 ```yaml
 version: 1
@@ -215,14 +216,12 @@ workflows:
             builtin: typecheck
 ```
 
-Projects can also declare `entrypoints` in `.pipeline/pipeline.yaml` to expose
-stable app or CLI names that resolve to workflows or schedule policies. Direct
-`--workflow` selection remains available and takes precedence over `--entrypoint`
-when both are set.
+Package-owned defaults declare `entrypoints` that expose stable app or CLI names
+resolving to workflows or schedule policies. Direct `--workflow` selection
+remains available and takes precedence over `--entrypoint` when both are set.
 
-The default scaffold includes a full research, red, green, verify, learn
-workflow. See `docs/config-architecture.md` for a complete example and the host
-support matrix.
+The package defaults include a full research, red, green, verify, learn
+workflow. See `docs/config-architecture.md` for the host support matrix.
 
 ### Structural Parallelism
 
@@ -292,22 +291,45 @@ branches share a base SHA, and merges passing branches into an integration
 branch in declaration order. It reports merge conflicts; it does not resolve
 them automatically.
 
-Default profile skills are installed into `.agents/skills` by `pipe init`.
-Runtime MCP projection and host-specific isolation policy live in `src/mcp`; see
-[`docs/mcp-host-isolation.md`](docs/mcp-host-isolation.md) and
+Default profile skills and generated host resources are installed by
+`pipe init`. Runtime MCP projection and host-specific isolation policy live in
+`src/mcp`; see [`docs/mcp-host-isolation.md`](docs/mcp-host-isolation.md) and
 [`docs/mcp-gateway.md`](docs/mcp-gateway.md).
 
+## OpenCode-First Goal Loop
+
+Package defaults run built-in profiles through OpenCode first. Pipeline-owned
+goal state remains authoritative: continuation prompts, stop reasons, verifier
+evidence, acceptance evidence, changed files, and failed gates are stored by the
+pipeline, not inferred from an OpenCode session. A goal is complete only when
+deterministic verifier evidence and acceptance coverage are both present.
+
+The curated OpenCode stack generated by package config includes:
+
+- project commands, agents, projected skills, explicit permissions, LSP, and the
+  singleton `pipeline-gateway` MCP server;
+- `.opencode/plugins/pipeline-goal-context.ts`, a package-owned compaction hook
+  that injects current goal-loop context into OpenCode continuation summaries;
+- `@devtheops/opencode-plugin-otel@1.1.0` in `.opencode/opencode.json`;
+- surfaced ecosystem inputs for DCP code, handoff/session capture,
+  background-agent delegation, prompt snippets, memory/context helpers, and
+  policy hooks.
+
+Team mode is generated as an auditable schedule graph. OpenCode subagents can
+execute graph nodes, but dependencies, retries, gates, verifier passes, and
+acceptance evidence stay pipeline-owned.
+
 ## Generated Host Resources
 
-Generate native host files from the YAML config:
+Generate native host files during setup:
 
 ```shell
-pipe install-commands --host all
+pipe init
 ```
 
-Generated resources are derived from the three config files; they are not
-separate sources of truth. Host resources use exact native agents when the node
-runner matches the host. OpenCode also uses native subagents for cross-runner
+Generated resources are derived from package-owned config; they are not separate
+sources of truth. Host resources use exact native agents when the node runner
+matches the host. OpenCode also uses native subagents for cross-runner
 model-backed nodes when the runner/profile provides an OpenCode-compatible
 `model` or `host_models.opencode` value. Otherwise generated instructions
 dispatch to that runner's CLI instead of inventing a host model.
@@ -316,7 +338,7 @@ The installer creates one command surface per configured entrypoint.
 | Host        | Generated files                                                   | Invocation                         |
 | ----------- | ----------------------------------------------------------------- | ---------------------------------- |
 | Codex       | `.agents/skills/<entrypoint>/SKILL.md`, `.agents/plugins/oisin-pipeline/commands/<entrypoint>.md`, `.agents/plugins/oisin-pipeline/agents/*.md`, `.codex/config.toml` | `$pipe <task>`, `$inspect <task>`, `$epic <task>`, `/pipe <task>`, `/inspect <task>`, `/epic <task>` |
-| OpenCode    | `.opencode/commands/<entrypoint>.md`, `.opencode/agents/*.md`     | `/pipe <task>`, `/inspect <task>`, `/epic <task>` |
+| OpenCode    | `.opencode/commands/<entrypoint>.md`, `.opencode/agents/*.md`, `.opencode/skills/*/SKILL.md`, `.opencode/plugins/*.ts`, `.opencode/opencode.json` | `/pipe <task>`, `/inspect <task>`, `/epic <task>` |
 | Kimi        | `.kimi/commands/<entrypoint>.md`, `.kimi/agents/*.yaml`           | `/pipe <task>`, `/inspect <task>`, `/epic <task>` |
 | Pi          | `.pi/prompts/<entrypoint>.md`                                     | `/pipe <task>`, `/inspect <task>`, `/epic <task>` |
 
@@ -336,8 +358,8 @@ runners:
 
 ## Runtime Guarantees
 
-- `pipe run` fails without `.pipeline/pipeline.yaml`,
-  `.pipeline/profiles.yaml`, and `.pipeline/runners.yaml`.
+- `pipe run` loads package-owned `@oisincoveney/pipeline` config even when the
+  repository has no repo-local `.pipeline` config files.
 - Multi-agent workflows execute as separate agent boundaries; nodes are not
   merged into one prompt.
 - Native subagent strategy is preferred when the selected runner can represent

package/defaults/opencode/plugins/pipeline-goal-context.ts

@@ -0,0 +1,18 @@
+interface PipelineCompactionOutput {
+  context: string[];
+}
+
+export const PipelineGoalContext = async () => ({
+  "experimental.session.compacting": (
+    _input: unknown,
+    output: PipelineCompactionOutput
+  ) => {
+    output.context.push(
+      [
+        "## Pipeline Goal Context",
+        "Preserve the current task, schedule node, failed gates, verifier evidence, acceptance evidence, changed files, and exact next requirement.",
+        "Do not mark the goal complete without deterministic verifier and acceptance evidence.",
+      ].join("\n")
+    );
+  },
+});

package/defaults/opencode-ecosystem.yaml

@@ -0,0 +1,203 @@
+version: 1
+generated_by: "@oisincoveney/pipeline"
+runtime:
+  default_runner: opencode
+  compatibility_runners: [codex]
+  default_stack_direct: true
+  state_authority: pipeline
+official_dependencies:
+  - id: "@opencode-ai/plugin"
+    package: "@opencode-ai/plugin"
+    role: plugin type surface for package-owned OpenCode plugins
+    dependency_scope: package-code-when-needed
+    source: https://opencode.ai/docs/plugins
+  - id: "@opencode-ai/sdk"
+    package: "@opencode-ai/sdk"
+    role: programmatic OpenCode API access for package-owned integration code
+    dependency_scope: package-code-when-needed
+    source: https://opencode.ai/docs/ecosystem
+ecosystem_code:
+  - id: pipeline-goal-context
+    name: pipeline-goal-context
+    role: package-owned continuation context plugin for OpenCode compaction hooks
+    plugin:
+      kind: local
+      source_path: defaults/opencode/plugins/pipeline-goal-context.ts
+      target_path: .opencode/plugins/pipeline-goal-context.ts
+    default_stack: true
+    source: https://opencode.ai/docs/plugins
+  - id: dcp-code
+    name: DCP code
+    role: dynamic context pruning for long OpenCode sessions
+    default_stack: true
+    source: https://github.com/Tarquinen/opencode-dynamic-context-pruning
+  - id: opencode-background-agents
+    name: opencode-background-agents
+    role: async delegation and background-agent context persistence patterns
+    default_stack: true
+    source: https://github.com/kdcokenny/opencode-background-agents
+  - id: opencode-handoff
+    name: opencode-handoff
+    role: focused continuation and handoff prompt generation
+    default_stack: true
+    source: https://github.com/joshuadavidthomas/opencode-handoff
+  - id: opencode-plugin-otel
+    name: opencode-plugin-otel
+    package: "@devtheops/opencode-plugin-otel"
+    plugin:
+      kind: npm
+      package: "@devtheops/opencode-plugin-otel@1.1.0"
+    role: OpenTelemetry plugin pattern for runtime observability
+    default_stack: true
+    source: https://www.npmjs.com/package/@devtheops/opencode-plugin-otel
+  - id: opencode-snip
+    name: opencode-snip
+    role: prompt snippet and command-discipline helper patterns
+    default_stack: true
+    source: https://www.npmjs.com/package/opencode-snip
+  - id: opencode-mem
+    name: opencode-mem
+    role: OpenCode memory projection for durable goal context
+    default_stack: true
+    source: https://github.com/tickernelz/opencode-mem
+  - id: cupcake
+    name: cupcake
+    role: OpenCode policy enforcement through tool execution hooks
+    default_stack: true
+    source: https://cupcake.eqtylab.io/getting-started/usage/opencode/
+mcp_backends:
+  - id: pipeline-gateway
+    locality: project-remote
+    required: true
+    credentials: [PIPELINE_MCP_GATEWAY_AUTHORIZATION]
+    role: singleton MCP server exposed to generated Codex and OpenCode host config
+  - id: context7
+    name: Context7
+    locality: shared-remote
+    required: true
+    credentials: []
+    role: current library documentation and examples
+  - id: uidotsh
+    locality: shared-remote
+    required: true
+    credentials: []
+    role: package skill and rule resource retrieval
+  - id: qdrant
+    name: Qdrant
+    locality: repo-scoped-remote
+    required: true
+    credentials: [QDRANT_URL, QDRANT_API_KEY]
+    role: repository memory lookup and storage
+  - id: fallow
+    name: Fallow
+    locality: repo-local
+    required: false
+    credentials: []
+    role: dead-code, complexity, duplication, boundary, and runtime coverage analysis
+  - id: serena
+    name: Serena
+    locality: repo-local
+    required: true
+    credentials: []
+    role: repository-local semantic code navigation
+  - id: backlog
+    name: Backlog
+    locality: repo-local
+    required: true
+    credentials: []
+    role: task and ticket state
+  - id: github
+    name: GitHub
+    locality: shared-remote
+    required: true
+    credentials: [GITHUB_TOKEN]
+    role: repository, PR, issue, and release workflow access
+  - id: playwright-browser
+    name: Playwright/browser
+    locality: repo-local
+    required: true
+    credentials: []
+    role: browser automation and frontend verification
+  - id: neon
+    name: Neon
+    locality: shared-remote
+    required: true
+    credentials: [NEON_API_KEY]
+    role: database branch and Postgres environment operations
+skills:
+  - id: pipe
+    path: .agents/skills/pipe/SKILL.md
+    used_by: [orchestrator]
+  - id: inspect
+    path: .agents/skills/inspect/SKILL.md
+    used_by: [pipeline-inspector]
+  - id: epic
+    path: .agents/skills/epic/SKILL.md
+    used_by: [pipeline-epic-router]
+  - id: execute
+    path: .agents/skills/execute/SKILL.md
+    used_by: [pipeline-code-writer]
+  - id: research
+    path: .agents/skills/research/SKILL.md
+    used_by: [pipeline-researcher]
+  - id: library-first-development
+    path: .agents/skills/library-first-development/SKILL.md
+    used_by: [pipeline-researcher, pipeline-code-writer]
+  - id: critique
+    path: .agents/skills/critique/SKILL.md
+    used_by: [pipeline-thermo-nuclear-reviewer]
+  - id: verify
+    path: .agents/skills/verify/SKILL.md
+    used_by: [pipeline-verifier]
+prompts:
+  - id: orchestrator
+    source: package-default-profile
+    used_by: [orchestrator]
+  - id: researcher
+    source: package-default-profile
+    used_by: [pipeline-researcher]
+  - id: inspector
+    source: package-default-profile
+    used_by: [pipeline-inspector]
+  - id: schedule-planner
+    source: package-default-profile
+    used_by: [pipeline-schedule-planner]
+  - id: test-writer
+    source: package-default-profile
+    used_by: [pipeline-test-writer]
+  - id: code-writer
+    source: package-default-profile
+    used_by: [pipeline-code-writer]
+  - id: acceptance-reviewer
+    source: package-default-profile
+    used_by: [pipeline-acceptance-reviewer]
+  - id: verifier
+    source: package-default-profile
+    used_by: [pipeline-verifier]
+host_capabilities:
+  agents: true
+  subagents: true
+  skills: true
+  plugins: true
+  mcp_servers: true
+  lsp: true
+  permissions: true
+  commands: true
+  project_config: true
+sources:
+  - label: OpenCode ecosystem
+    url: https://opencode.ai/docs/ecosystem
+  - label: OpenCode plugins
+    url: https://opencode.ai/docs/plugins
+  - label: OpenCode agents
+    url: https://opencode.ai/docs/agents
+  - label: OpenCode skills
+    url: https://opencode.ai/docs/skills/
+  - label: OpenCode MCP servers
+    url: https://opencode.ai/docs/mcp-servers
+  - label: OpenCode LSP
+    url: https://opencode.ai/docs/lsp/
+  - label: awesome-opencode
+    url: https://github.com/awesome-opencode/awesome-opencode
+  - label: opencode.cafe
+    url: https://www.opencode.cafe/

package/dist/commands/pipeline-command.js

@@ -1,7 +1,6 @@
 //#region src/commands/pipeline-command.ts
 const BUILTIN_PIPE_COMMANDS = new Set([
 	"run",
-	"pipe",
 	"validate",
 	"explain-plan",
 	"doctor",
@@ -12,7 +11,6 @@ const BUILTIN_PIPE_COMMANDS = new Set([
 ]);
 function registerConfiguredEntrypointCommands(program, config, runEntrypoint) {
 	const registered = /* @__PURE__ */ new Set();
-	if (!config) return registered;
 	const reservedCommands = new Set(program.commands.map((command) => command.name()));
 	for (const [id, entrypoint] of Object.entries(config.entrypoints)) {
 		if (reservedCommands.has(id)) continue;