@oisincoveney/pipeline 1.4.1 → 1.5.0

package/README.md

@@ -51,6 +51,12 @@ Run a read-only repository inspection:
 pipe run --workflow inspect "Report the app structure and available checks. Do not modify files."
 ```
 
+Run a configured entrypoint alias:
+
+```shell
+pipe run --entrypoint dogfood "Run deterministic local verification."
+```
+
 The `pipe` binary also accepts the task directly:
 
 ```shell
@@ -130,6 +136,10 @@ workflows:
             builtin: typecheck
 ```
 
+Projects can also declare `entrypoints` in `.pipeline/pipeline.yaml` to expose
+stable app or CLI names that resolve to workflows. 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.
@@ -168,6 +178,21 @@ overwrite manually edited files unless `--force` is supplied.
   the configured semantics. Otherwise the runtime uses a subprocess boundary.
 - Parallel DAG batches run concurrently after dependencies and gates pass.
 - Agent self-reporting is not enough to pass deterministic gates.
+- JSON Schema gates validate structure only. Use `verdict` and `acceptance`
+  gates to enforce semantic pass/fail and per-criterion coverage.
+- Command hooks support host policy controls, sanitized environments, timeouts,
+  output limits, and JSON payloads on stdin.
+
+## App-Facing API
+
+External apps can import the stable config, planner, and runtime surfaces
+without deep-importing private source paths:
+
+```ts
+import { loadPipelineConfig, parsePipelineConfigParts } from "@oisincoveney/pipeline/config";
+import { compileWorkflowPlan } from "@oisincoveney/pipeline/planner";
+import { runPipelineFromConfig, type PipelineRuntimeResult, type PipelineTaskContext } from "@oisincoveney/pipeline/runtime";
+```
 
 ## Verification
 

package/dist/{mastra/config.d.ts → config.d.ts}

@@ -5,7 +5,7 @@ export declare const PROFILES_CONFIG_PATH = ".pipeline/profiles.yaml";
 declare const RUNNER_TYPES: readonly ["claude", "codex", "opencode", "kimi", "pi", "command"];
 declare const NODE_KINDS: readonly ["agent", "command", "builtin", "group"];
 declare const HOOK_EVENTS: readonly ["workflow.start", "workflow.success", "workflow.failure", "workflow.complete", "node.start", "node.success", "node.error", "gate.failure"];
-declare const GATE_KINDS: readonly ["artifact", "builtin", "command", "json_schema"];
+declare const GATE_KINDS: readonly ["acceptance", "artifact", "builtin", "changed_files", "command", "json_schema", "verdict"];
 export type PipelineConfigErrorCode = "PIPELINE_CONFIG_LEGACY_UNSUPPORTED" | "PIPELINE_CONFIG_MISSING" | "PIPELINE_CONFIG_PARSE_ERROR" | "PIPELINE_CONFIG_VALIDATION_ERROR";
 export interface PipelineConfigIssue {
     message: string;
@@ -18,9 +18,21 @@ export declare class PipelineConfigError extends Error {
 }
 declare const configSchema: z.ZodObject<{
     default_workflow: z.ZodString;
+    entrypoints: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        task_context: z.ZodOptional<z.ZodObject<{
+            type: z.ZodString;
+        }, z.core.$loose>>;
+        workflow: z.ZodString;
+    }, z.core.$strict>>>;
     hooks: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         builtin: z.ZodOptional<z.ZodString>;
         command: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        env: z.ZodOptional<z.ZodObject<{
+            passthrough: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            set: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        }, z.core.$strict>>;
         event: z.ZodEnum<{
             "workflow.start": "workflow.start";
             "workflow.success": "workflow.success";
@@ -35,8 +47,13 @@ declare const configSchema: z.ZodObject<{
             command: "command";
             builtin: "builtin";
         }>;
+        output_limit_bytes: z.ZodOptional<z.ZodNumber>;
+        payload: z.ZodOptional<z.ZodEnum<{
+            stdin: "stdin";
+        }>>;
         required: z.ZodOptional<z.ZodBoolean>;
         timeout_ms: z.ZodOptional<z.ZodNumber>;
+        trusted: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$strict>>>;
     mcp_servers: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         args: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -71,8 +88,8 @@ declare const configSchema: z.ZodObject<{
         }, z.core.$strict>>;
         output: z.ZodOptional<z.ZodObject<{
             format: z.ZodEnum<{
-                text: "text";
                 json: "json";
+                text: "text";
                 jsonl: "jsonl";
                 json_schema: "json_schema";
             }>;
@@ -87,14 +104,14 @@ declare const configSchema: z.ZodObject<{
         runner: z.ZodString;
         skills: z.ZodOptional<z.ZodArray<z.ZodString>>;
         tools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            task: "task";
+            edit: "edit";
             read: "read";
             list: "list";
             grep: "grep";
             glob: "glob";
             bash: "bash";
-            edit: "edit";
             write: "write";
-            task: "task";
         }>>>;
     }, z.core.$strict>>>;
     rules: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
@@ -114,22 +131,22 @@ declare const configSchema: z.ZodObject<{
                 disabled: "disabled";
             }>>>;
             output_formats: z.ZodOptional<z.ZodArray<z.ZodEnum<{
-                text: "text";
                 json: "json";
+                text: "text";
                 jsonl: "jsonl";
                 json_schema: "json_schema";
             }>>>;
             rules: z.ZodOptional<z.ZodBoolean>;
             skills: z.ZodOptional<z.ZodBoolean>;
             tools: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                task: "task";
+                edit: "edit";
                 read: "read";
                 list: "list";
                 grep: "grep";
                 glob: "glob";
                 bash: "bash";
-                edit: "edit";
                 write: "write";
-                task: "task";
             }>>>;
         }, z.core.$strict>;
         command: z.ZodOptional<z.ZodString>;
@@ -146,6 +163,9 @@ declare const configSchema: z.ZodObject<{
     skills: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         path: z.ZodString;
     }, z.core.$strict>>>;
+    task_context: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+    }, z.core.$loose>>;
     version: z.ZodLiteral<1>;
     workflows: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
@@ -158,26 +178,38 @@ declare const configSchema: z.ZodObject<{
             builtin: z.ZodOptional<z.ZodString>;
             command: z.ZodOptional<z.ZodArray<z.ZodString>>;
             gates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                acceptance_key: z.ZodOptional<z.ZodString>;
                 builtin: z.ZodOptional<z.ZodEnum<{
                     duplication: "duplication";
                     test: "test";
                     typecheck: "typecheck";
                 }>>;
+                changed_files: z.ZodOptional<z.ZodObject<{
+                    allow: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    deny: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                    include_untracked: z.ZodOptional<z.ZodBoolean>;
+                    require_any: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>>;
                 command: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                equals: z.ZodOptional<z.ZodString>;
                 expect_exit_code: z.ZodOptional<z.ZodNumber>;
+                field: z.ZodOptional<z.ZodString>;
                 id: z.ZodOptional<z.ZodString>;
                 kind: z.ZodEnum<{
                     command: "command";
                     builtin: "builtin";
                     json_schema: "json_schema";
+                    acceptance: "acceptance";
                     artifact: "artifact";
+                    changed_files: "changed_files";
+                    verdict: "verdict";
                 }>;
                 path: z.ZodOptional<z.ZodString>;
                 required: z.ZodOptional<z.ZodBoolean>;
                 schema_path: z.ZodOptional<z.ZodString>;
                 target: z.ZodOptional<z.ZodEnum<{
-                    artifact: "artifact";
                     stdout: "stdout";
+                    artifact: "artifact";
                 }>>;
                 timeout_ms: z.ZodOptional<z.ZodNumber>;
             }, z.core.$strict>>>;