feat(advisory): agy stdin 전달, 의회 병렬 실행, 세션 스코프 동의

[ictechgy]

원샷 wclass-advisory ask 표면의 사용성/노출 개선 4건. 코어 wclass 라우팅,
one-child 계약, 캠페인 기록·게이트·봉인 매니페스트는 바뀌지 않는다. 캠페인
dispatch 는 없었고 영속 기록도 쓰지 않았다.

변경

1. agy 태스크를 argv → stdin NDJSON (8292944)

agy 라우트는 --print 가 프롬프트를 인자로 요구한다는 이유로 태스크를 argv 로
넘겨 왔고, 그 노출을 문서화된 잔여로 안고 있었다. argv 에 실린 태스크는 같은
사용자의 모든 프로세스에서 ps 로 보인다.

agy 1.1.23 실측: --input-format stream-json 은 프롬프트를 stdin 의 NDJSON 한
줄에서 읽고, 같은 호출에 argv 프롬프트가 오면 CLI 가 스스로 거부한다
("a prompt given on the command line would be ignored"). --print 를 빼면 정상
동작한다. 즉 이 조합에는 태스크 자리가 존재하지 않는다 — 노출을 우리가 지우는
것이 아니라 CLI 가 닫는다.

_prepare_task_command 는 라우트가 NDJSON 입력을 선언했을 때만 stdin 을
감싼다. 실행 파일 이름이 아니라 선언된 형식으로, 토큰 위치로 판정한다. 출력
파싱은 이미 호환됐다(advice_text_extracted 가 마지막 NDJSON 줄부터 읽고,
_agy_usage 가 {"event":"result","result":{...}} 봉투를 이미 처리).

2. ask --council 순차 → 동시 실행 (8ec0e63)

구성원은 서로의 출력을 보지 않는 독립 프로세스인데 순차로 돌았다. 대가는
벽시계가 합이 되는 것과, 전체 데드라인이 뒤쪽 구성원만 굶기는 것이었다.

동시에 띄우면 합이 최댓값이 되고 남은 예산을 모두가 같은 조건으로 나눈다.
상한은 제출 시점에 한 번만 정하고(스레드 안에서 재면 같은 입력이 실행마다 다른
결과를 낸다), 반환은 언제나 입력 순서다. 실패한 피어는 취소하지 않는다 — 이미
과금된 작업만 버리게 된다. 작업 트리 비교는 구성원 사이가 아니라 의회 전체의
앞뒤로 옮겼다.

advisory_parallel.run_parallel 은 재사용하지 않았다. 그쪽은 명령 단위라
grok 의 {{task_file}} 익명 파이프 전달을 실을 수 없다.

3. 세션 스코프 송신 동의 + 읽을 수 있는 미리보기 (c6cfb80)

호출마다 터미널 확인을 다시 받는 것이 사용을 막고 있었다. 저장소·시각 단위
grant 는 AGENTS.md 가 advisory 상태에 저장소 경로와 시각을 금지하므로
선택지가 아니다. 그래서 동의를 셸 세션의 수명에만 둔다:
WCLASS_ADVISORY_EGRESS=session. 디스크에 쓰지 않고, 셸이 닫히면 사라지며,
권한 크기는 --confirm-task-egress 와 정확히 같다.

값을 정확히 session 으로 요구한다. 이름 존재만 보면 0 을 넣어 끄려던
사용자가 오히려 켜게 된다.

영수증에 task_egress_confirmation_source(flag/session_environment/
terminal)를, 미리보기에 session_egress_grant_active 를 추가했다.

--human 미리보기는 json.dumps(indent=2) 를 그대로 찍어 이스케이프된 JSON
스키마 전문이 화면을 채웠다 — 읽으라고 만든 출력이 읽을 수 없었다. 이제 문장
요약을 찍고, 120자를 넘는 인자만 길이와 sha256 앞자리로 줄인다(정확한 바이트는
--json 에 그대로).

4. Skill 을 onboarding 18 로 (8bcaaa9)

번들이 "agy receives the task in argv" 를 가르치고 있었고 이제 거짓이다.
의회 설명도 순차를 전제했다. 둘 다 고치고 세션 동의를 추가했다.
RELEASING.md 대로 정확히 발행된 0.29.0 번들 해시를
RELEASE_0290_BUNDLE_FILE_SHA256 으로 원장에 넣었다(작업 트리와 v0.29.0
태그에서 각각 계산해 일치 확인).

검증

• .weightclass/verify exit 0 — 1,593 tests, 35 skips
• Ruff check/format 251 files, strict mypy 206 source files, compileall,
  git diff --check 모두 통과
• verify_advisory_skill_ledger.py --previous-ref v0.29.0 통과
• 실측: 실제 agy CLI 로 ask --vendor agy --workflow review --context task
  가 task_delivery: "stdin" 과 유효한 schema-1 결과를 반환. 실제
  --council agy,codex 가 13.9초에 끝나고 부분 결과를 보존한 뒤 exit 3.
  codex 의 ask_executor_failed 는 단독 실행에서도 재현되는 로컬 CLI 조건이며
  diff 에 codex 라인은 0줄이다.

수정한 기존 테스트 2건

• tests/test_advisory_flexible_vendors.py: agy argv 단언 → stdin 계약.
  claude/codex 프로필 다이제스트와 grok {{task_file}} 전달은 불변.
• tests/test_advisory_quick.py: test_council_total_deadline_prevents_later_ member_start 는 순차 실행이 만들던 뒤쪽 구성원 굶김 자체를 계약으로
  굳힌 테스트였다. 남는 계약(제출 전 예산이 0 이하면 아무도 시작하지 않음)으로
  재작성하고, 동시성을 배리어로 증명하는 테스트와 피어 수거 테스트를 추가.

재고정한 검증기 1건

.weightclass/verify-review 시드 두 개가 speculative_run.py 에 58줄이
추가되면서 밀렸다. 4347→4405, 4443→4501. 두 시드 모두 이전과 같은 심볼을 같은
±8줄 창 안에 두므로 검증기가 수용/거부하는 집합은 바뀌지 않는다.

이 PR 이 다루지 않는 것

• 코어 wclass 의 네이티브 agy/grok 라우트는 여전히 argv 전달이며,
  AGENTS.md 의 예외 조항이 네이티브 라우팅에 대해 그대로 유효하다. 코어 agy 를
  stdin 으로 옮기면 모든 내장 agy 라우트 지문이 바뀌므로 별도 릴리스 처리가
  필요하다.
• 봉인된 agy 캠페인 인구가 있다면 다음 dispatch 전에 문서화된
  migrate-routes --vendor agy 가 필요하다(schema-1 agy argv 변경).
• 선행 문제: agy 자신의 --print-timeout 5분 기본값이 advisory 의 3,600초
  상한보다 먼저 자식을 끊는다. 이 배치 이전부터 있던 문제라 건드리지 않았다.

🤖 Generated with Claude Code

https://claude.ai/code/session_01P3dXGuZjrBWD669SgUuk65