toki/proto-socket
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

sync: agent-ops from agentic-framework v1.1.31

Browse source
This commit is contained in:
toki 2026-05-24 08:09:38 +09:00
parent d0784e9943
commit fd0c30bc36
11 changed files with 129 additions and 76 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
.aiexclude Normal file
View file

@ -0,0 +1,2 @@
agent-task/archive/**
agent-ops/roadmap/archive/**

2
.clineignore Normal file
View file

@ -0,0 +1,2 @@
agent-task/archive/**
agent-ops/roadmap/archive/**

2
.cursorignore Normal file
View file

@ -0,0 +1,2 @@
agent-task/archive/**
agent-ops/roadmap/archive/**

2
.geminiignore Normal file
View file

@ -0,0 +1,2 @@
agent-task/archive/**
agent-ops/roadmap/archive/**

2
agent-ops/.version
View file

@ -1 +1 @@
1.1.30
1.1.31

71
agent-ops/bin/ai-ignore.sh Executable file
View file

@ -0,0 +1,71 @@
#!/usr/bin/env bash
# Shared AI ignore / permission defaults for init and sync flows.
AGENT_OPS_TASK_ARCHIVE_IGNORE_PATTERN="agent-task/archive/**"
AGENT_OPS_ROADMAP_ARCHIVE_IGNORE_PATTERN="agent-ops/roadmap/archive/**"
AGENT_OPS_AI_IGNORE_FILES=(".geminiignore" ".aiexclude" ".cursorignore" ".clineignore")
AGENT_OPS_AI_PERMISSION_FILES=(".claude/settings.json" "opencode.json")
AGENT_OPS_AI_SYNC_FILES=("${AGENT_OPS_AI_IGNORE_FILES[@]}" "${AGENT_OPS_AI_PERMISSION_FILES[@]}")
agent_ops_append_unique_line() {
local file="$1"
local line="$2"
touch "$file"
if ! grep -qxF "$line" "$file"; then
printf "%s\n" "$line" >> "$file"
fi
}
ensure_agent_ops_ai_ignore_config() {
local target_dir="$1"
local ignore_file
for ignore_file in "${AGENT_OPS_AI_IGNORE_FILES[@]}"; do
agent_ops_append_unique_line "$target_dir/$ignore_file" "$AGENT_OPS_TASK_ARCHIVE_IGNORE_PATTERN"
agent_ops_append_unique_line "$target_dir/$ignore_file" "$AGENT_OPS_ROADMAP_ARCHIVE_IGNORE_PATTERN"
done
mkdir -p "$target_dir/.claude"
if [[ ! -f "$target_dir/.claude/settings.json" ]]; then
cat > "$target_dir/.claude/settings.json" <<'EOF'
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"permissions": {
"deny": [
"Read(./agent-task/archive/**)",
"Read(./agent-ops/roadmap/archive/**)"
]
}
}
EOF
elif ! grep -q "agent-task/archive" "$target_dir/.claude/settings.json" || ! grep -q "agent-ops/roadmap/archive" "$target_dir/.claude/settings.json"; then
echo "Note: .claude/settings.json exists; add Read(./agent-task/archive/**) and Read(./agent-ops/roadmap/archive/**) manually."
fi
if [[ ! -f "$target_dir/opencode.json" ]]; then
cat > "$target_dir/opencode.json" <<'EOF'
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"read": {
"agent-task/archive/**": "deny",
"agent-ops/roadmap/archive/**": "deny"
},
"glob": {
"agent-task/archive/**": "deny",
"agent-ops/roadmap/archive/**": "deny"
}
},
"watcher": {
"ignore": [
"agent-task/archive/**",
"agent-ops/roadmap/archive/**"
]
}
}
EOF
elif ! grep -q "agent-task/archive" "$target_dir/opencode.json" || ! grep -q "agent-ops/roadmap/archive" "$target_dir/opencode.json"; then
echo "Note: opencode.json exists; add agent-task/archive/** and agent-ops/roadmap/archive/** read/glob deny and watcher ignore manually."
fi
}

65
agent-ops/bin/init-agent-ops.sh
View file

@ -8,6 +8,7 @@ set -e
SCRIPT_DIR=$(realpath "$(dirname "$0")")
SOURCE_DIR=$(realpath "$SCRIPT_DIR/..")
source "$SCRIPT_DIR/entry-files.sh"
source "$SCRIPT_DIR/ai-ignore.sh"
if [ -z "$1" ]; then
echo "Usage: $0 <target_directory>"
@ -15,18 +16,6 @@ if [ -z "$1" ]; then
fi
TARGET_DIR=$(realpath "$1")
TASK_ARCHIVE_IGNORE_PATTERN="agent-task/archive/**"
ROADMAP_ARCHIVE_IGNORE_PATTERN="agent-ops/roadmap/archive/**"
append_unique_line() {
local file="$1"
local line="$2"
touch "$file"
if ! grep -qxF "$line" "$file"; then
printf "%s\n" "$line" >> "$file"
fi
}
create_project_agent_ops_dirs() {
local agent_ops_dir="$1"
@ -82,57 +71,7 @@ apply_agent_ops_entry_files "$COMMON_RULES" "$TARGET_DIR"
ensure_common_rules_file "$SOURCE_DIR" "$TARGET_DIR/agent-ops"
# 4. AI ignore / permission 설정
append_unique_line "$TARGET_DIR/.geminiignore" "$TASK_ARCHIVE_IGNORE_PATTERN"
append_unique_line "$TARGET_DIR/.geminiignore" "$ROADMAP_ARCHIVE_IGNORE_PATTERN"
append_unique_line "$TARGET_DIR/.aiexclude" "$TASK_ARCHIVE_IGNORE_PATTERN"
append_unique_line "$TARGET_DIR/.aiexclude" "$ROADMAP_ARCHIVE_IGNORE_PATTERN"
append_unique_line "$TARGET_DIR/.cursorignore" "$TASK_ARCHIVE_IGNORE_PATTERN"
append_unique_line "$TARGET_DIR/.cursorignore" "$ROADMAP_ARCHIVE_IGNORE_PATTERN"
append_unique_line "$TARGET_DIR/.clineignore" "$TASK_ARCHIVE_IGNORE_PATTERN"
append_unique_line "$TARGET_DIR/.clineignore" "$ROADMAP_ARCHIVE_IGNORE_PATTERN"
mkdir -p "$TARGET_DIR/.claude"
if [ ! -f "$TARGET_DIR/.claude/settings.json" ]; then
cat > "$TARGET_DIR/.claude/settings.json" <<'EOF'
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"permissions": {
"deny": [
"Read(./agent-task/archive/**)",
"Read(./agent-ops/roadmap/archive/**)"
]
}
}
EOF
elif ! grep -q "agent-task/archive" "$TARGET_DIR/.claude/settings.json" || ! grep -q "agent-ops/roadmap/archive" "$TARGET_DIR/.claude/settings.json"; then
echo "Note: .claude/settings.json exists; add Read(./agent-task/archive/**) and Read(./agent-ops/roadmap/archive/**) manually."
fi
if [ ! -f "$TARGET_DIR/opencode.json" ]; then
cat > "$TARGET_DIR/opencode.json" <<'EOF'
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"read": {
"agent-task/archive/**": "deny",
"agent-ops/roadmap/archive/**": "deny"
},
"glob": {
"agent-task/archive/**": "deny",
"agent-ops/roadmap/archive/**": "deny"
}
},
"watcher": {
"ignore": [
"agent-task/archive/**",
"agent-ops/roadmap/archive/**"
]
}
}
EOF
elif ! grep -q "agent-task/archive" "$TARGET_DIR/opencode.json" || ! grep -q "agent-ops/roadmap/archive" "$TARGET_DIR/opencode.json"; then
echo "Note: opencode.json exists; add agent-task/archive/** and agent-ops/roadmap/archive/** read/glob deny and watcher ignore manually."
fi
ensure_agent_ops_ai_ignore_config "$TARGET_DIR"
# 5. .gitignore 설정
TOUCH_GITIGNORE="$TARGET_DIR/.gitignore"

32
agent-ops/bin/sync.sh
View file

@ -11,6 +11,7 @@ RED='\033[0;31m'; YELLOW='\033[1;33m'; GREEN='\033[0;32m'; RESET='\033[0m'
# ── 진입 파일 공통 관리 ──────────────────────────────────────────────────────
source "$SCRIPT_DIR/entry-files.sh"
source "$SCRIPT_DIR/ai-ignore.sh"
# ── 대상 경로 해석 (폴더명 / 상대경로 / 절대경로) ────────────────────────────
resolve_target() {
@ -130,6 +131,11 @@ agent_ops_git_paths() {
printf '%s\n' "$f"
fi
done
for f in "${AGENT_OPS_AI_SYNC_FILES[@]}"; do
if [[ -e "$f" ]] || git ls-files --error-unmatch "$f" >/dev/null 2>&1; then
printf '%s\n' "$f"
fi
done
}
commit_and_push_agent_ops_scope() {
@ -179,6 +185,7 @@ sync_framework_to_target() {
cp "$SRC_AO/.version" "$dst_ao/.version"
apply_agent_ops_entry_files "$SRC_AO/rules/common/rules.md" "$target"
fi
ensure_agent_ops_ai_ignore_config "$target"
commit_and_push_agent_ops_scope "$target" "sync: agent-ops from $(basename "$PROJECT_ROOT") v$src_ver"
echo -e "${GREEN}✓ 완료 → $(basename "$target")${RESET}"
@ -234,11 +241,8 @@ if [[ "$PULL_MODE" == "1" ]]; then
sync_common "$DST_AO" "$SRC_AO"
cp "$DST_AO/.version" "$SRC_AO/.version"
apply_agent_ops_entry_files "$DST_AO/rules/common/rules.md" "$PROJECT_ROOT"
cd "$PROJECT_ROOT"
git add agent-ops/rules/common agent-ops/skills/common agent-ops/bin agent-ops/.version \
"${AGENT_OPS_ENTRY_FILES[@]}"
git commit -m "sync: pull from agentic-framework v$DST_VER"
git push
ensure_agent_ops_ai_ignore_config "$PROJECT_ROOT"
commit_and_push_agent_ops_scope "$PROJECT_ROOT" "sync: pull from agentic-framework v$DST_VER"
echo -e "${GREEN}✓ 완료 (pull v$DST_VER)${RESET}"
exit 0
fi
@ -293,18 +297,28 @@ SRC_VER="$(cat "$SRC_AO/.version" 2>/dev/null || echo "0.0.0")"
DST_VER="$(cat "$DST_AO/.version" 2>/dev/null || echo "0.0.0")"
echo " 현재 버전: $SRC_VER | framework 버전: $DST_VER"
COMMON_CHANGED="1"
if ! common_differs "$SRC_AO" "$DST_AO"; then
echo " 공통 파일 변경 없음: .version 차이는 무시하고 버전 갱신/커밋을 건너뜀"
echo -e "${GREEN}✓ 완료 (변경 없음)${RESET}"
exit 0
COMMON_CHANGED="0"
fi
if version_gt "$DST_VER" "$SRC_VER"; then
if [[ "$COMMON_CHANGED" == "1" ]] && version_gt "$DST_VER" "$SRC_VER"; then
echo -e "${RED}⚠ 버전 충돌: framework($DST_VER) > current($SRC_VER)${RESET}"
echo -e "${YELLOW} 먼저 sync-pull로 내려받은 뒤 재시도하세요.${RESET}"
exit 1
fi
ensure_agent_ops_ai_ignore_config "$PROJECT_ROOT"
ensure_agent_ops_ai_ignore_config "$TARGET"
if [[ "$COMMON_CHANGED" == "0" ]]; then
echo " 공통 파일 변경 없음: AI ignore / permission 설정만 보강"
commit_and_push_agent_ops_scope "$TARGET" "sync: ensure agent-ops AI ignore config"
commit_and_push_agent_ops_scope "$PROJECT_ROOT" "sync: ensure agent-ops AI ignore config"
echo -e "${GREEN}✓ 완료 (공통 변경 없음)${RESET}"
exit 0
fi
NEW_VER="$(bump_version "$SRC_VER")"
sync_common "$SRC_AO" "$DST_AO"
echo "$NEW_VER" > "$SRC_AO/.version"

1
agent-ops/skills/common/sync-pull/SKILL.md
View file

@ -30,6 +30,7 @@ agent-ops/bin/sync.sh --pull <target>
- [ ] sync.sh 가 오류 없이 완료됐는가
- [ ] 현재 프로젝트 버전이 framework 버전과 일치하는가
- [ ] `agent-ops/bin/entry-files.sh`의 모든 진입 파일이 갱신됐고, 내용이 framework의 `agent-ops/rules/common/rules.md`와 일치하는가
- [ ] `.geminiignore`, `.aiexclude`, `.cursorignore`, `.clineignore`에 `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`가 포함되어 있는가
## 금지 사항

7
agent-ops/skills/common/sync-push/SKILL.md
View file

@ -35,7 +35,7 @@ description: 현재 프로젝트의 agent-ops를 agentic-framework로 올리거
3. **명시되지 않은 경우**: `agent-ops/bin/sync.sh` 실행
4. target이 없으면 `sync.sh`가 현재 프로젝트 기준 상위 폴더(`../`)의 하위 디렉터리 중 `agent-ops/` 폴더가 있는 프로젝트를 모두 대상으로 삼는다
5. `sync.sh`는 현재 agentic-framework의 `agent-ops/rules/common/rules.md` 내용을 대상 프로젝트 루트의 진입 파일에 덮어쓴다
6. 적용 후 각 대상 repo에서 agent-ops 공통 관리 경로(`rules/common/rules.md` 포함)와 진입 파일만 stage 하여 commit/push 한다
6. 적용 후 각 대상 repo에서 agent-ops 공통 관리 경로(`rules/common/rules.md` 포함), 진입 파일, AI ignore / permission 파일을 stage 하여 commit/push 한다
덮어쓰기 대상은 `init-agent-ops` 초기 세팅과 동일하며, 실제 목록은 `agent-ops/bin/entry-files.sh`의 `AGENT_OPS_ENTRY_FILES`를 단일 기준으로 사용한다.
@ -53,7 +53,7 @@ description: 현재 프로젝트의 agent-ops를 agentic-framework로 올리거
agent-ops/bin/sync.sh [target]
```
푸시 대상 path는 항상 `agent-ops/.version`, `agent-ops/bin`, `agent-ops/rules/common`, `agent-ops/skills/common`과 `AGENT_OPS_ENTRY_FILES`의 진입 파일로 제한한다.
푸시 대상 path는 항상 `agent-ops/.version`, `agent-ops/bin`, `agent-ops/rules/common`, `agent-ops/skills/common`, `AGENT_OPS_ENTRY_FILES`의 진입 파일, `AGENT_OPS_AI_SYNC_FILES`의 AI ignore / permission 파일로 제한한다.
## 실행 결과 검증
@ -61,7 +61,8 @@ agent-ops/bin/sync.sh [target]
- [ ] 버전 충돌 경고가 없었는가 — 있었다면 사용자에게 수동 머지 필요함을 알린다
- [ ] 대상 repo의 `agent-ops/rules/common/rules.md`가 현재 agentic-framework의 `agent-ops/rules/common/rules.md`와 일치하는가
- [ ] agentic-framework에서 대상 프로젝트로 push한 경우, `agent-ops/bin/entry-files.sh`의 모든 진입 파일 내용이 현재 agentic-framework의 `agent-ops/rules/common/rules.md`와 일치하는가
- [ ] 대상 repo에 commit/push 된 path가 agent-ops 공통 관리 경로와 진입 파일로 제한되었는가
- [ ] `.geminiignore`, `.aiexclude`, `.cursorignore`, `.clineignore`에 `agent-task/archive/**`와 `agent-ops/roadmap/archive/**`가 포함되어 있는가
- [ ] 대상 repo에 commit/push 된 path가 agent-ops 공통 관리 경로, 진입 파일, AI ignore / permission 파일로 제한되었는가
## 금지 사항

19
opencode.json Normal file
View file

@ -0,0 +1,19 @@
{
"$schema": "https://opencode.ai/config.json",
"permission": {
"read": {
"agent-task/archive/**": "deny",
"agent-ops/roadmap/archive/**": "deny"
},
"glob": {
"agent-task/archive/**": "deny",
"agent-ops/roadmap/archive/**": "deny"
}
},
"watcher": {
"ignore": [
"agent-task/archive/**",
"agent-ops/roadmap/archive/**"
]
}
}