@kody-ade/kody-engine 0.3.20 → 0.3.22

package/dist/executables/release-publish/profile.json

@@ -0,0 +1,53 @@
+{
+  "name": "release-publish",
+  "role": "utility",
+  "phase": "shipped",
+  "describe": "Tag the merged release commit, run the configured publishCommand, create the GitHub release. No agent.",
+  "inputs": [
+    {
+      "name": "dry-run",
+      "flag": "--dry-run",
+      "type": "bool",
+      "required": false,
+      "describe": "Print plan without tagging or publishing."
+    },
+    {
+      "name": "issue",
+      "flag": "--issue",
+      "type": "int",
+      "required": false,
+      "describe": "Issue/PR number to post the terminal notice on. Auto-injected by dispatch."
+    }
+  ],
+  "claudeCode": {
+    "model": "inherit",
+    "permissionMode": "acceptEdits",
+    "maxTurns": 0,
+    "maxThinkingTokens": null,
+    "systemPromptAppend": null,
+    "tools": [],
+    "hooks": [],
+    "skills": [],
+    "commands": [],
+    "subagents": [],
+    "plugins": [],
+    "mcpServers": []
+  },
+  "cliTools": [],
+  "inputArtifacts": [],
+  "outputArtifacts": [],
+  "scripts": {
+    "preflight": [
+      { "script": "setCommentTarget", "with": { "type": "issue" } },
+      { "script": "loadTaskState" },
+      { "shell": "publish.sh" },
+      { "script": "skipAgent" }
+    ],
+    "postflight": [
+      { "script": "recordOutcome" },
+      { "script": "saveTaskState" },
+      { "script": "notifyTerminal", "with": { "label": "release publish" } },
+      { "script": "advanceFlow" }
+    ]
+  }
+}

package/dist/executables/release-publish/publish.sh

@@ -0,0 +1,110 @@
+#!/usr/bin/env bash
+#
+# release-publish: tag the current package version, push the tag, run the
+# configured publishCommand (e.g. `pnpm publish --access public`), create
+# the GitHub release. Runs AFTER the orchestrator has merged the release
+# PR into the default branch. No agent.
+#
+# Inputs (env):
+#   KODY_ARG_DRY_RUN          true|false
+#   KODY_ARG_ISSUE            triggering issue/PR number (optional)
+#
+# Config (env):
+#   KODY_CFG_GIT_DEFAULTBRANCH         e.g. main
+#   KODY_CFG_RELEASE_PUBLISHCOMMAND    optional; $VERSION is substituted
+#   KODY_CFG_RELEASE_DRAFTRELEASE      "true" → create as draft
+#   KODY_CFG_RELEASE_TIMEOUTMS         publish timeout (default 600000ms)
+#
+# Stdout signals:
+#   KODY_REASON=<text>
+#   KODY_PR_URL=<release URL>   — gh release create URL (used as the "PR" link)
+#   KODY_SKIP_AGENT=true
+
+set -euo pipefail
+
+dry_run="${KODY_ARG_DRY_RUN:-false}"
+default_branch="${KODY_CFG_GIT_DEFAULTBRANCH:-main}"
+publish_cmd="${KODY_CFG_RELEASE_PUBLISHCOMMAND:-}"
+draft="${KODY_CFG_RELEASE_DRAFTRELEASE:-false}"
+timeout_ms="${KODY_CFG_RELEASE_TIMEOUTMS:-600000}"
+timeout_s=$((timeout_ms / 1000))
+
+fail() {
+  echo "KODY_REASON=$1"
+  echo "KODY_SKIP_AGENT=true"
+  exit "${2:-1}"
+}
+
+read_pkg_version() {
+  python3 -c "import json; print(json.load(open('package.json'))['version'])"
+}
+
+if [[ ! -f package.json ]]; then
+  fail "release publish: package.json not found" 99
+fi
+
+export HUSKY=0 SKIP_HOOKS=1 CI="${CI:-1}"
+
+# Make sure we're on the merged commit. The orchestrator merged the release
+# PR into default_branch; pull so the local tree has the bump commit.
+git fetch origin "$default_branch" --tags
+git checkout "$default_branch"
+git reset --hard "origin/$default_branch"
+
+version=$(read_pkg_version)
+tag="v${version}"
+
+echo "→ release publish: ${tag}"
+
+# Refuse if the tag already exists locally (left over from a prior failed run).
+if git rev-parse --verify "$tag" >/dev/null 2>&1; then
+  fail "release publish: tag ${tag} already exists" 1
+fi
+
+if [[ "$dry_run" == "true" ]]; then
+  echo "KODY_REASON=dry-run — would tag + publish ${tag}"
+  echo "KODY_SKIP_AGENT=true"
+  exit 0
+fi
+
+# Tag + push.
+git tag -a "$tag" -m "Release ${tag}"
+git push origin "$tag"
+
+# publishCommand (optional). Failure here is recorded but does not abort —
+# we still want the GH release entry so the tag is discoverable.
+publish_status="skipped"
+if [[ -n "$publish_cmd" ]]; then
+  cmd="${publish_cmd//\$VERSION/$version}"
+  echo "  publish: ${cmd}"
+  if timeout "${timeout_s}" bash -c "$cmd"; then
+    publish_status="ok"
+  else
+    publish_status="failed"
+    echo "[kody release-publish] publishCommand failed (continuing to create GH release)" >&2
+  fi
+fi
+
+# GitHub release.
+release_url=""
+draft_flag=""
+[[ "$draft" == "true" ]] && draft_flag="--draft"
+if release_url=$(gh release create "$tag" --title "$tag" --notes "Release ${tag} — automated by kody." $draft_flag 2>&1); then
+  :
+else
+  echo "[kody release-publish] gh release create failed: $release_url" >&2
+  release_url=""
+fi
+
+echo "RELEASE_TAG=${tag}"
+[[ -n "$release_url" ]] && echo "RELEASE_URL=${release_url}"
+
+if [[ "$publish_status" == "failed" ]]; then
+  echo "KODY_REASON=tag + GH release created, but publishCommand failed"
+  echo "KODY_SKIP_AGENT=true"
+  exit 1
+fi
+
+[[ -n "$release_url" ]] && echo "KODY_PR_URL=${release_url}"
+echo "KODY_REASON=tagged ${tag}, published${publish_status:+ ($publish_status)}"
+echo "KODY_SKIP_AGENT=true"

package/dist/executables/research/prompt.md

@@ -57,8 +57,17 @@ documented in `AGENTS.md` / `CLAUDE.md` — reference those files by path
 cite it; don't copy it.
 
 ## Clarifying questions
-Numbered list. Each question must include a one-line "Why:" explaining why
-the answer changes the implementation. Skip if there are genuinely none.
+Numbered list. Each question must include a one-line "Why:" naming the
+concrete implementation decision the answer would unblock — not "why it
+matters" in general, but which fork in the road it picks.
+
+Default to asking. Only skip this section when every entry in
+"Gaps & assumptions" is genuinely safe to proceed on without confirmation;
+if you skip, justify it in one line under the heading. Prefer a few sharp
+questions over many soft ones — a question that wouldn't change the
+implementation is noise. Address the questions to the issue author / a
+human reviewer; they'll be answered in a follow-up comment and picked up
+on the next research run via delta mode.
 
 ## Gaps & assumptions
 What is unknown, and — for each gap — what assumption the implementer would

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.3.20",
+  "version": "0.3.22",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",