hephaestus-build

Hephaestus Build

Procedure

1. Treat this as the public Codex build surface. Do not expose or ask the user to invoke the older internal support skill names.

2. Resolve the trusted engine root before reading any build contract:

   ENGINE=""
   for candidate in \
     "${CODEX_PLUGIN_ROOT:-}" \
     "${CLAUDE_PLUGIN_ROOT:-}" \
     "${PLUGIN_ROOT:-}" \
     "$HOME/.agentlas/runtime/current/host_adapters/codex/plugins/agentlas-core-engine-meta-agent" \
     "$HOME/.agentlas/runtime/current/host_adapters/claude/plugins/agentlas-core-engine-meta-agent" \
     "$HOME/.agentlas/runtime/current" \
     "."
   do
     if [ -n "$candidate" ] && [ -f "$candidate/AGENTS.md" ] && [ -f "$candidate/package-contract.json" ] && [ -f "$candidate/contracts/builder-interview-research-gate.md" ]; then
       ENGINE="$candidate"
       break
     fi
   done
   [ -n "$ENGINE" ] || { echo "Hephaestus engine not found. Run the installer first." >&2; exit 1; }
   RUNNER=""
   for candidate in "$HOME/.agentlas/runtime/current/bin/hephaestus" "$ENGINE/bin/hephaestus"; do
     if [ -x "$candidate" ]; then RUNNER="$candidate"; break; fi
   done
   [ -n "$RUNNER" ] || { echo "Hephaestus runner not found." >&2; exit 1; }
   

   For an interactive request whose first argument is session, do not resolve a generic PACKAGE_TARGET and do not ask for a JSON/JSONL export. Ask first: "이 세션에서 만든 에이전트를 기본 전역 Agentlas 에이전트 폴더에 만들까요? 다른 위치를 원하면 경로를 알려주세요. 별도 위치를 지정하지 않으면 전역 폴더에 만듭니다." If no alternate location is named, use AGENTLAS_AGENT_HOME or ~/.agentlas/agentlas-agent and create a new safe-slug child package. If a destination is supplied, validate that exact folder. Never overwrite an existing child. The current conversation is the source; do not inspect recent sessions or host databases.

   For every other build request, take exactly one folder explicitly named or confirmed by the user as PACKAGE_TARGET. If none was named, or multiple candidates exist, stop and ask. Never default to ., the cwd, or $ENGINE. Run "$RUNNER" contract resolve-target "$PACKAGE_TARGET" --base "$PWD" and set PACKAGE_ROOT only to the status-ok receipt's exact package_root. Nonzero or error receipts are blockers.