@buzzni/saycode-cli 0.3.3 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +14 -2
- package/index.mjs +1845 -345
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -116,15 +116,27 @@ Happy CLI 설치본은 동일한 agent 명령을 `happy agent` facade로 제공
|
|
|
116
116
|
먼저 `happy agent whoami`로 capability와 spawn 한도를 확인해야 합니다.
|
|
117
117
|
|
|
118
118
|
```bash
|
|
119
|
+
happy agent ls --status # 스코프 안 세션의 상태·대기 사유·마지막 응답·seq 커서
|
|
119
120
|
happy agent spawn --prompt "변경사항을 읽기 전용으로 리뷰해줘"
|
|
120
121
|
happy agent prompt <id> "리뷰 근거를 더 설명해줘"
|
|
122
|
+
happy agent wait --any <id1> <id2> --until turn-end # 여럿 중 하나라도 끝나면 반환
|
|
123
|
+
happy agent read <id> --since <seq> # 마지막으로 읽은 뒤의 변경분만
|
|
121
124
|
happy agent steer <id> <text> # 지금 생성 중인 응답의 방향만 수정
|
|
122
125
|
happy agent stop <id> # 사용자가 명시한 경우에만 현재 응답 중단
|
|
123
126
|
```
|
|
124
127
|
|
|
128
|
+
스코프(`whoami`의 `scope`)는 관리형 worktree 세션이면 프로젝트 루트 전체라 다른 worktree의 대화도 보이고
|
|
129
|
+
지시할 수 있습니다. `root`는 여전히 세션의 작업 디렉터리이며 `spawn`한 자식은 거기서 시작합니다(ADR-061).
|
|
130
|
+
|
|
125
131
|
`steer` 성공의 `accepted:true`는 세션 RPC가 요청을 받았다는 뜻이며 실제 transcript 전달 완료를
|
|
126
|
-
뜻하지 않습니다(`delivered:false`). 끝난 턴의 후속 작업에는 `prompt`를 사용합니다.
|
|
127
|
-
`
|
|
132
|
+
뜻하지 않습니다(`delivered:false`). 끝난 턴의 후속 작업에는 `prompt`를 사용합니다. 사람이 시작한 세션
|
|
133
|
+
(`depth` 0)은 스코프 안 모든 세션에 `steer`와 `stop`을 보낼 수 있고, spawn된 세션은 원장에 기록된 최대
|
|
134
|
+
2단계 자식만 허용하며, `stop`은 보관·삭제를 하지 않습니다. spawn 한도(`whoami`의 `maxSpawn`)는 세션이
|
|
135
|
+
도는 머신의 코어·메모리에서 산정하므로 머신마다 다르고, 최근 6시간 안의 spawn만 세는 롤링 윈도우라
|
|
136
|
+
소진돼도 시간이 지나면 회복됩니다(`budgetResetsAt`, ADR-063). 데몬이 확인하지 못한 시도도 같은
|
|
137
|
+
6시간을 차감합니다 — 응답만 유실됐을 뿐 세션은 만들어졌을 수 있기 때문입니다. 깊이 상한에는 이런
|
|
138
|
+
회복이 없고, 에이전트 세션 안에서는 `chat`으로 **새** 대화를 시작할 수 없습니다(기존 세션 attach는
|
|
139
|
+
가능). 예산과 계보를 적용하는 경로가 `agent spawn` 하나뿐이어야 하기 때문입니다. 이 원장 검사는
|
|
128
140
|
같은 OS 사용자 아래의 오조작을 줄이는 advisory 가드레일이며 보안 경계나 서버 측 권한 증명은 아닙니다.
|
|
129
141
|
같은 worktree에는 동시에 둘 이상의 쓰기 자식을 만들지 말고 격리가 필요하면 Desktop의 관리형
|
|
130
142
|
worktree 병렬 실행을 사용하세요.
|