Self-hosted workflows for coding-agent delivery. Orchestrate CodeBuddy, Codex and Claude Code with scripts and human approval gates. Includes Local workflows for coding assistants.
JavaScript agent-orchestrationagentic-workflowai-agentsai-codingclaude-codecode-reviewcodebuddycodexcoding-agentscursordeveloper-toolshuman-on-the-loopllmmcpmulti-agentsdlcself-hostedsopworkflow-automationworkflow-engine
package runtime
import (
"crypto/sha256"
"encoding/hex"
"fmt"
"os"
"path/filepath"
"strings"
"unicode/utf8"
)
func WorkspaceContentSHA(content string) string {
sum := sha256.Sum256([]byte(content))
return hex.EncodeToString(sum[:])
}
// Edits use a content hash; a new file requires the explicit "missing" version. Reject every symlink
// component and use os.Root so replacement cannot escape the workspace.
func WriteWorkspaceFile(root, path, content, expected string) (string, error) {
if len(content) > 1<<20 || !utf8.ValidString(content) || strings.ContainsRune(content, 0) {
return "", fmt.Errorf("只支持 1 MB 以内的文本文件")
}
rel, err := resolveWorkspaceEditPath(root, path, expected)
if err != nil {
return "", err
}
base, err := os.OpenRoot(root)
if err != nil {
return "", err
}
defer base.Close()
info, err := base.Stat(rel)
if os.IsNotExist(err) && expected == "missing" {
if err := createWorkspaceFile(base, rel, content); err != nil {
return "", err
}
return WorkspaceContentSHA(content), nil
}
if err != nil {
return "", err
}
if !info.Mode().IsRegular() || info.Size() > 1<<20 {
return "", fmt.Errorf("不是可编辑文本文件")
}
previous, err := base.ReadFile(rel)
if err != nil {
return "", err
}
if expected == "" || WorkspaceContentSHA(string(previous)) != expected {
return "", fmt.Errorf("文件内容已变化,请重新读取后再保存")
}
if !utf8.Valid(previous) || strings.ContainsRune(string(previous), 0) {
return "", fmt.Errorf("二进制文件不可编辑")
}
if err := replaceWorkspaceFile(base, root, rel, content, info.Mode().Perm()); err != nil {
return "", err
}
return WorkspaceContentSHA(content), nil
}
// replaceWorkspaceFile atomically overwrites an existing file: content is
// written and synced to a temporary file beside rel with the given permissions,
// then renamed over rel inside base. The temporary file is always cleaned up.
func replaceWorkspaceFile(base *os.Root, root, rel, content string, perm os.FileMode) error {
f, err := os.CreateTemp(filepath.Join(root, filepath.Dir(rel)), ".agentflow-edit-*")
if err != nil {
return err
}
temp := f.Name()
defer os.Remove(temp)
if err = f.Chmod(perm); err == nil {
_, err = f.WriteString(content)
}
if err == nil {
err = f.Sync()
}
closeErr := f.Close()
if err == nil {
err = closeErr
}
if err != nil {
return err
}
tempRel, err := filepath.Rel(root, temp)
if err != nil {
return err
}
return base.Rename(tempRel, rel)
}
// resolveWorkspaceEditPath cleans path into a workspace-relative path and rejects
// absolute or escaping paths, hidden components, and any symlink component. With
// expected == "missing" only the final component may be absent.
func resolveWorkspaceEditPath(root, path, expected string) (string, error) {
rel := filepath.Clean(filepath.FromSlash(path))
if rel == "." || filepath.IsAbs(rel) || rel == ".." || strings.HasPrefix(rel, ".."+string(filepath.Separator)) {
return "", fmt.Errorf("invalid workspace path")
}
for _, part := range strings.Split(filepath.ToSlash(rel), "/") {
if strings.HasPrefix(part, ".") {
return "", fmt.Errorf("隐藏文件不可编辑")
}
}
for current := rel; current != "."; current = filepath.Dir(current) {
info, err := os.Lstat(filepath.Join(root, current))
if os.IsNotExist(err) && current == rel && expected == "missing" {
continue
}
if os.IsNotExist(err) && current == rel {
return "", fmt.Errorf("文件 %s 不存在:新建文件时 expectedSha256 传 \"missing\"", filepath.ToSlash(rel))
}
if os.IsNotExist(err) {
return "", fmt.Errorf("目录 %s 不存在:先在终端里 mkdir -p 创建目录,再新建文件", filepath.ToSlash(current))
}
if err != nil {
return "", err
}
if info.Mode()&os.ModeSymlink != 0 {
return "", fmt.Errorf("符号链接不可编辑")
}
}
return rel, nil
}
// createWorkspaceFile writes content to a new file that must not exist yet,
// removing the partial file when the write fails.
func createWorkspaceFile(base *os.Root, rel, content string) error {
f, err := base.OpenFile(rel, os.O_WRONLY|os.O_CREATE|os.O_EXCL, 0644)
if err != nil {
return err
}
_, err = f.WriteString(content)
if err == nil {
err = f.Sync()
}
closeErr := f.Close()
if err == nil {
err = closeErr
}
if err != nil {
base.Remove(rel)
return err
}
return nil
}