@lchase/kiln 0.3.0 → 0.5.0

package/dist/workflow.js

@@ -6,10 +6,12 @@ const FACTORY_DIRECTIVE = /^<!--\s*factory:\s*(prompts\/factory\/[a-z0-9-]+\.md)
 const WORKFLOW_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
 const FEATURE_PROMPTS = 7;
 const INVESTIGATION_PROMPTS = 1;
+const FIX_PROMPTS = 1;
 /** Prompt files Kiln rewrites before launch. A mismatch refuses the launch. */
 const PROMPT_COUNTS = {
     feature: FEATURE_PROMPTS,
     investigation: INVESTIGATION_PROMPTS,
+    fix: FIX_PROMPTS,
 };
 /**
  * Values Kiln can pass into a workflow. A workflow's inputSchema lists the
@@ -81,6 +83,73 @@ export function workflowInputs(workflowYaml, input) {
     }
     return out;
 }
+/**
+ * Leaf step ids under the root `steps:` block, in file order.
+ * A step that contains nested `- id:` entries is a loop or map container
+ * and is omitted; its nested ids are the ones a run actually starts.
+ */
+export function workflowLeafSteps(yaml) {
+    const lines = yaml.split("\n");
+    let inSteps = false;
+    const nodes = [];
+    for (const line of lines) {
+        if (!inSteps) {
+            if (line === "steps:" || line.startsWith("steps:"))
+                inSteps = true;
+            continue;
+        }
+        if (/^\S/.test(line))
+            break;
+        const match = /^(\s*)- id:\s*([A-Za-z0-9._-]+)\s*(?:#.*)?$/.exec(line);
+        if (!match?.[2])
+            continue;
+        nodes.push({ id: match[2], indent: match[1]?.length ?? 0 });
+    }
+    const leaves = [];
+    for (let index = 0; index < nodes.length; index += 1) {
+        const node = nodes[index];
+        const next = nodes[index + 1];
+        if (!node)
+            continue;
+        if (next && next.indent > node.indent)
+            continue;
+        leaves.push(node.id);
+    }
+    return leaves;
+}
+/** Leaf step ids from a yak `workflow.json` `steps` array. Loop and map containers expand to their body. */
+export function leafStepIds(steps) {
+    if (!Array.isArray(steps))
+        return [];
+    const ids = [];
+    for (const step of steps) {
+        if (typeof step !== "object" || step === null || !("id" in step))
+            continue;
+        const id = step.id;
+        if (typeof id !== "string" || id.length === 0)
+            continue;
+        const kind = "kind" in step ? step.kind : undefined;
+        if (kind === "loop" && "body" in step) {
+            ids.push(...leafStepIds(step.body));
+            continue;
+        }
+        if (kind === "map" && "step" in step) {
+            ids.push(...leafStepIds([step.step]));
+            continue;
+        }
+        ids.push(id);
+    }
+    return ids;
+}
+/** Leaf steps of a packaged workflow. An unknown name is an empty plan, not an error. */
+export function workflowStepPlan(name) {
+    if (!WORKFLOW_NAME.test(name))
+        return [];
+    const path = join(packageRoot(), "workflows", `${name}.yaml`);
+    if (!existsSync(path))
+        return [];
+    return workflowLeafSteps(readFileSync(path, "utf8"));
+}
 /** True when the workflow runs the repo test command. Investigation does not. */
 export function workflowNeedsTestCommand(workflowYaml) {
     return /\bKILN_TEST\b/.test(workflowYaml) || workflowYaml.includes("KILN_VERIFY_WRAPPER");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lchase/kiln",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Run a workflow on any registered repo. A markdown spec is the input.",
   "type": "module",
   "bin": {

package/prompts/kiln/fix.md

@@ -0,0 +1,17 @@
+<!-- factory: prompts/factory/builder.md -->
+
+Kiln runs this factory agent inside yak to answer pull request feedback. The working directory is the worktree (there is no separate worktree path). There is no `.factory/` job folder and no `.factory/repo.md`; read the repo for conventions. `.factory/lessons.md` applies only when that file is really present.
+
+`<main branch>` is the base SHA `{{input.baseRef}}` (the pull request head this worktree was branched from, via yak `--from`). Use that SHA wherever the factory instructions say `<main branch>`. Do not guess `main`.
+
+Your branch is whatever `git branch --show-current` prints. It is `yak/<run-id>`. That is the branch name in this prompt. Do not BLOCK because it is not `factory/...` or `main`.
+
+Commit on that branch. Do not push. Do not force-push. Do not open a pull request. Do not approve one. Do not comment on one. Kiln fast-forwards the existing pull request branch after this run.
+
+Do not write `build.md`. Return JSON: `status` is `READY` or `BLOCKED`, `summary` is what you changed. The original spec and the feedback items are the task text below, not files.
+
+Task: {{input.title}}
+
+{{input.description}}
+
+The factory agent instructions follow. Their frontmatter is the original definition; follow the prose, and return the JSON above instead of writing the file they name.

package/workflows/fix.yaml

@@ -0,0 +1,44 @@
+# One pull-request fix, run by yak (@lchase/yak).
+#
+# The same builder as workflows/feature.yaml (factory builder, opus). Kiln
+# launches it with `yak run --isolation worktree --from <pull request head>`
+# on a job whose pull request is already open. Yak cuts a worktree branch
+# `yak/<run-id>` from that commit. The agent commits there. Kiln fast-forwards
+# the open pull request branch. This workflow does not open, approve, merge,
+# or comment on a pull request, and it does not force-push.
+name: kiln-fix
+version: "1"
+inputSchema:
+  inline:
+    type: object
+    additionalProperties: false
+    properties:
+      title: { type: string }
+      description: { type: string }
+      acceptance: { type: string }
+      runNonce: { type: string }
+      baseRef: { type: string }
+    required: [title, description, acceptance, runNonce, baseRef]
+steps:
+  - id: build
+    needs: [input]
+    agent:
+      model: opus
+      prompt:
+        file: prompts/kiln/fix.md
+      schema:
+        inline:
+          type: object
+          additionalProperties: false
+          properties:
+            summary: { type: string }
+            status: { type: string, enum: [READY, BLOCKED] }
+          required: [summary, status]
+      tools: [Read, Grep, Glob, Bash, Write, Edit, Skill]
+    produces: build
+
+  - id: land
+    needs: [input, build]
+    skipIf: 'build.status != "READY"'
+    command:
+      run: 'git add -A && git diff --cached --quiet || git commit -m "kiln: $KILN_TASK_TITLE"'