English | 简体中文 | 한국어 | Español | Français | Deutsch | Português (Brasil) | Русский
DyroEngineeringFlow · dyro CLI는 여러 저장소를 사용하는 팀을 위한 로컬 우선 엔지니어링 자동화 및 배포 제어 플랫폼입니다. 개발 라인, Git worktree, Agent 실행, 작업 게이트, 독립 검토, 병합 감사를 버전 관리 가능한 워크스페이스 설정으로 통합합니다.
Dyro는 로컬 우선 멀티 저장소 전달 물리 엔진입니다. 무엇이 참이 될 수 있는지, 그 참이 언제 감쇠하는지, 누가 세계를 바꿀 수 있는지를 결정합니다.
dyro proof verify는 현재 워크스페이스를 다시 묶습니다. dyro proof verify-bundle은 이식 가능한 무결성만 검사합니다. 호출자는 고정된 객체가 있는 모든 --git-dir을 넘겨야 합니다(합집합 검색, repo 맵 아님). 객체가 없으면 inconclusive입니다. 무결성 live는 merge가 아닙니다.
작업에서 배포까지 엔지니어링이 계속 흐르게 합니다.
각 팀은 dyro.toml Profile에서 저장소, 레이아웃, Agent adapter, 배포 정책을 정의하며, 비즈니스 규칙·모델 비용·릴리스 관행은 Profile에 둡니다.
- 하나의 작업은 정확히 하나의 개발 라인에만 속하며 기능 버전과 Hotfix 워크스페이스를 혼합하지 않습니다.
- 모든 작업은
task/<id>브랜치의 독립된git worktree에서 실행됩니다. - 게이트는 오케스트레이터가 실행하며 Agent의 자체 보고만으로 성공을 판단하지 않습니다.
- 검토는 실행 receipt와 저장소별 정확한 작업 HEAD에 함께 연결되며 소스 변경 시 무효가 됩니다.
- 독립 검토를 통과한 작업만
done이 되며, 병합과 push는 기본적으로 명시적 확인이 필요합니다. - 완료된 의존성은 정확한 작업 HEAD가 소유 개발 라인에 통합된 뒤에야 하위 작업을 해제합니다.
- 실행 가능한 설정은 argv 배열입니다. 코어는 TOML에서 제공한 shell 문자열을 실행하지 않습니다.
아래 다이어그램은 GitHub에서 Mermaid로 직접 렌더링됩니다(이미지 링크 아님). 제어 평면은 팀 Profile과 Dyro Core를 분리하며 런타임 상태는 .dyro/에 있습니다. 다이어그램 라벨은 영어(CLI·설정 키와 동일)입니다.
flowchart TB
subgraph Profile["Project Profile (team-supplied)"]
P1["repositories / layout / bases"]
P2["Agent adapter argv"]
P3["gates / receipt templates / policy"]
end
subgraph Core["Dyro Core · dyro CLI (mechanism)"]
W["workspace<br/>anchors · lines · doctor"]
L["launch<br/>safe argv templates"]
D["dispatch<br/>DAG · claim · state machine"]
V["verify<br/>gates · ledger"]
M["merge<br/>preflight · recovery · push policy"]
end
subgraph Runtime["Workspace runtime .dyro/"]
R1["tasks / lines / changes"]
R2["evidence · review · ledger"]
end
Profile --> Core
Core --> Runtime
Human["Engineer / release owner"] --> Core
Agent["Local agent CLI"] --> L
Runner["Isolated runner (optional)"] -.->|"evidence ZIP"| D
flowchart TB
WS["workspace root<br/>dyro.toml"]
WS --> REPO["repositories/"]
WS --> DYRO[".dyro/"]
WS --> VER["versions/ or layout.lines"]
WS --> WT["worktrees/ or layout.tasks"]
REPO --> API["services/api · Git anchor"]
REPO --> WEB["services/web · Git anchor"]
DYRO --> LINES["lines/<id>.toml"]
DYRO --> TASKS["tasks/<id>/"]
DYRO --> CHG["changes/ · decisions · ledger"]
TASKS --> TT["task.toml · handoff.md"]
TASKS --> EV["evidence-imports/ · review.md"]
WT --> TAPI["task/API-101/services/api"]
WT --> TWEB["task/API-101/services/web"]
VER --> LAPI["release-…/services/api worktree"]
VER --> LWEB["release-…/services/web worktree"]
stateDiagram-v2
[*] --> backlog
backlog --> assigned: claim / next
assigned --> in_progress: run starts
in_progress --> waiting_answer: human answer needed
waiting_answer --> in_progress: task answer
in_progress --> review: gates pass · private evidence flow
in_progress --> failed: failure
failed --> assigned: re-claim
review --> review_pending_signoff: verified review · private flow
review --> done: independent review PASS · private flow
review_pending_signoff --> done: task signoff · private flow
done --> [*]: task merge into line
sequenceDiagram
actor Eng as Engineer
participant CLI as dyro CLI
participant FS as Workspace Git / .dyro
participant Agent as Agent adapter
Eng->>CLI: setup / doctor / line create
CLI->>FS: register line · create line worktrees
Eng->>CLI: task create · task next
CLI->>FS: write task.toml · allocate worktree
Eng->>CLI: task run / open --agent
CLI->>Agent: argv launch into task worktree
Agent-->>CLI: work finished (not gate evidence)
CLI->>CLI: run Profile gates
CLI->>FS: receipt · heads · attempt
Eng->>CLI: task review
CLI->>FS: receipt-bound review
Eng->>CLI: task merge --yes
CLI->>FS: merge into line · update ledger
sequenceDiagram
actor Ctrl as Control-plane operator
participant CLI as dyro control plane
participant Run as Isolated runner
participant Rev as Independent reviewer
Ctrl->>CLI: task claim --by runner-id
CLI-->>Run: claim active · conflict group held
Run->>Run: execute in isolation · declared gates
Run->>CLI: evidence build → ZIP
Ctrl->>CLI: evidence execution --bundle
CLI->>CLI: validate ZIP · heads · gates · signing policy
Rev->>CLI: evidence review / review-build
CLI->>CLI: bind receipt + task heads
opt require_external_signoff
Ctrl->>CLI: task signoff --by approver
end
Ctrl->>CLI: task merge --yes
flowchart LR
subgraph Nodes
T1["Task A"]
T2["Task B"]
T3["Task C"]
D1["Decision<br/>blocked_on"]
end
T1 -->|depends_on| T2
T2 -->|depends_on| T3
T3 --> D1
CG["conflict_group: db-migrate<br/>mutex within a wave"]
T1 -.-> CG
T2 -.-> CG
flowchart TB
Snap["Immutable schedule snapshot<br/>graph + state + claims"]
Ready["ready set<br/>deps integrated · decisions OK"]
Wave["current wave<br/>--parallel × conflict_group"]
Snap --> Ready --> Wave
flowchart LR
subgraph Actors
Dev["Developer"]
Lead["Release owner"]
Runner["Isolated runner"]
Reviewer["Independent reviewer"]
end
subgraph UC["Primary use cases"]
U1["Init workspace setup/init"]
U2["Create line / hotfix"]
U3["Create and schedule tasks"]
U4["Local run and gates"]
U5["Import external evidence"]
U6["Independent review and signoff"]
U7["Merge and Change Set verify"]
U8["Audit sync to Witness"]
end
Dev --> U1
Dev --> U3
Dev --> U4
Lead --> U2
Lead --> U7
Lead --> U8
Runner --> U5
Reviewer --> U6
Dev --> U6
flowchart TB
Host["Host agent<br/>current conversation"]
Disp["local_agent_dispatch<br/>contract · guards · leases"]
B1["Backend CLI A"]
B2["Backend CLI B"]
Board["Adversarial review board<br/>signed sections + final call"]
Dyro["Dyro control plane<br/>claim · gates · merge"]
Host -->|"TaskContract JSON"| Disp
Disp --> B1
Disp --> B2
B1 -->|"summary + evidence"| Host
B2 -->|"summary + evidence"| Host
Host --> Board
Board -.->|"advisory only"| Host
Host -->|"explicit dyro commands"| Dyro
dyro와 함께 제공됩니다(dyro dispatch …). Dispatch 결과는 권고이며 전달은 Dyro gates/merge를 따릅니다.
sequenceDiagram
participant H as Host agent
participant S as DispatchSupervisor
participant W as Worker or backend
participant P as Review board file
H->>S: run --wait TaskContract
S->>S: validate files · secret guard · take slot
S->>W: self-contained prompt + allowlisted context
W-->>S: ResultEnvelope
S->>S: mark locator verified
S-->>H: run_id · summary · evidence
H->>P: write own signed section
Note over H,P: Do not edit others sections - source is authority
H->>H: optional code change / PR after final call
Note over H: Delivery still uses dyro task merge
일상적인 CLI 사용에는 격리된 pipx 환경에서 PyPI의 dyro를 설치하세요. Python 3.11 이상이 필요합니다.
python3 -m pip install --user --upgrade pipx
python3 -m pipx ensurepath
# ensurepath 실행 후 새 터미널을 연 다음:
pipx install dyro
dyro --version업데이트할 때는 pipx upgrade dyro를 실행합니다. 팀에서 pip로 Python 패키지를 관리한다면 다음을 사용할 수 있습니다.
python3 -m pip install --user --upgrade dyro대화형 dyro setup에서 제어면 Skill을 설치할 수 있습니다. 패키지 업데이트 후에는
이미 관리 중인 Skill이 자동 동기화되며, 대화형 실행 시 outdated Skill도 자동 복구됩니다.
최초 설치는 setup에서 선택하거나 dyro integration install skill --yes(별칭: codex)로 합니다.
대화형 dyro, dyro home, dyro start 실행은 현지 날짜 기준 하루에 한 번만 공식 PyPI 엔드포인트를 확인합니다. 실패해도 작업 공간 진입을 막지 않으며 기본적으로 업데이트 전 확인을 요청합니다.
dyro update # 확인 후 설치 (dyro update now 와 동일)
dyro update check # 검사만
dyro update now # dyro update 별칭
dyro update auto on # 패치 버전 자동 업데이트 사용
dyro update auto off
dyro update disable
dyro update enable자동 업데이트는 마이너 또는 메이저 버전을 넘지 않고 editable 소스 설치를 덮어쓰지 않습니다. DYRO_NO_UPDATE_CHECK=1은 시작 검사를 건너뜁니다. 안전한 업데이트를 참고하세요.
Dyro 자체를 개발할 때는 저장소의 잠긴 도구 체인과 실제 테스트 진입점을 사용합니다. 아래의 프로젝트 gate 예시를 Dyro 테스트 명령으로 사용하지 마세요.
uv sync --locked --all-extras --dev
uv run python -m unittest discover -s tests -t . -v
uv run ruff check src tests experiments첫 실행에서는 저장소가 있는 디렉터리나 기존 Git 프로젝트에서 다음을 실행하세요.
dyro setup안내는 파일을 쓰기 전에 계획을 보여 줍니다. 현재 Git 프로젝트 루트에서 실행하면 같은 수준의 별도 Dyro workspace를 제안하고 origin에서 clone하므로 원 프로젝트에 제어 상태를 쓰지 않습니다. 일반적인 로컬 Agent 명령도 탐지하지만, Core argv 계약이 감사된 adapter만 등록합니다. n을 입력하거나 종료하면 아무것도 생성되지 않습니다. 완료 후에는 다음을 실행하세요.
dyro next스크립트와 CI에서는 명시적 옵션을 사용합니다.
dyro setup . --name my-workspace --line dev --yes --non-interactive안전한 미리보기는 다음 두 형태를 모두 지원합니다.
dyro --dry-run setup . --name my-workspace --no-line
dyro setup . --name my-workspace --no-line --dry-run나중에 저장소를 추가할 때도 dyro.toml을 열 필요가 없습니다.
dyro repo add repositories/services/payments
dyro repo list일반적인 배포 정책과 Agent adapter도 dyro.toml 없이 관리합니다.
dyro config set policy.execution_mode external
dyro config get policy.execution_mode
dyro agent add ci-runner --preset noop
dyro agent test ci-runnerProfile에 remote가 있으면 누락된 저장소 anchor를 안전하게 채울 수 있습니다.
dyro --dry-run bootstrap
dyro bootstrap --yes
dyro doctor설정 후 dyro next가 다음 안전한 작업을 안내합니다. 개발 라인과 구성된 Agent를 선택해 시작할 준비가 되면 다음을 실행하세요.
dyro start스크립트나 릴리스 리드시 명시적 명령을 사용합니다.
dyro doctor
dyro line create release-2026-10 --base origin/main --yes
# 필요한 저장소에만 검증된 기준을 덮어씁니다.
dyro line create release-2026-10 --base origin/main --repo-base web=v2026.10.0 --yes
dyro open release-2026-10 --agent codex
dyro task create API-101 --title "Implement API contract" --line release-2026-10 --repository api
dyro task graph check --line release-2026-10
dyro task graph --line release-2026-10 --format mermaid
dyro task explain API-101
dyro task next
dyro task next --run --yes
dyro task attempts API-101
dyro task binding API-101
dyro task review API-101
dyro task merge API-101 --yes
dyro changeset create release-2026-10-ready --line release-2026-10
dyro changeset verify release-2026-10-ready프로덕션 hotfix는 검증된 프로덕션 기준을 명시해야 하며, 기본 브랜치를 암시적으로 상속하지 않습니다.
dyro hotfix create incident-123 --base v2026.09.7 --repos api,web --yes실행과 승인이 별도의 신뢰 시스템에서 이뤄지는 Profile은 policy.execution_mode = "external" 과 policy.require_external_signoff = true 를 설정합니다. 로컬 Dyro는 계획만 허용하며, receipt와 정확한 작업 HEAD에 묶인 검토 후 명시적 signoff 로 done 이 됩니다.
dyro task claim API-101 --by isolated-runner-1 --key-id runner-2026 \
--output /secure-transfer/API-101.core-claim.json
# 장기 작업은 만료 전에 bounded claim을 갱신해야 합니다.
dyro task claim-renew API-101 --by isolated-runner-1 --lease-seconds 3600
# 격리 runner에서 선언된 gates를 실행하고 receipt·로그·정확한 HEAD를 패키징합니다.
dyro task evidence build API-101 --workspace /runner/workspace --receipt /runner/out/receipt.md --output /runner/out/API-101.zip
# 제어 평면에서 이식 가능한 패키지 하나를 검증·가져옵니다.
dyro task evidence execution API-101 --bundle /runner/out/API-101.zip
dyro task evidence review API-101 --file /review/out/review.md
dyro task signoff API-101 --by release-manager
# 포기한 할당은 명시적으로 해제할 수 있습니다.
dyro task claim-release API-101 --by isolated-runner-1새 증거 번들은 provenance.json을 포함해야 합니다. provenance 이전 레거시 번들 가져오기는 의도적 마이그레이션이며 ... --allow-legacy가 필요합니다. 외부 runner가 QUESTION을 반환하면 dyro task answer API-101 --text "..."로 기록합니다. 기존 claim은 유지되고 작업은 다음 증거 제출을 위해 assigned로 돌아갑니다.
불변 증거 세대를 검사하고 안전하게 유지합니다.
dyro task evidence generations API-101
dyro --dry-run task evidence generations API-101 --prune --older-than-days 30 --keep 10
dyro task evidence generations API-101 --prune --older-than-days 30 --keep 10 --yes암호학적 runner/승인자 신원: 워크스페이스 밖에서 키를 생성하고, 용도별 trust store에 공개키만 설치합니다.
dyro config set policy.execution_mode external
dyro config set policy.require_signed_execution true
dyro config set policy.require_signed_review true
dyro config set policy.require_external_signoff true
dyro config set policy.require_signed_signoff true
dyro key generate runner-2026 --private-key /secure/runner.pem --public-key /secure/runner.pub.pem
dyro key trust runner-2026 --purpose execution --public-key /secure/runner.pub.pem --not-after 2027-01-01T00:00:00+00:00
dyro task claim API-101 --by isolated-runner-1 --key-id runner-2026 \
--output /secure-transfer/API-101.core-claim.json
dyro task evidence build API-101 --workspace /runner/workspace --receipt /runner/out/receipt.md --output /runner/out/API-101.zip --claim /runner/in/claim.json --signing-key /secure/runner.pem --key-id runner-2026
dyro key generate reviewer-2026 --private-key /secure/reviewer.pem --public-key /secure/reviewer.pub.pem
dyro key trust reviewer-2026 --purpose review --public-key /secure/reviewer.pub.pem
dyro task evidence review-build API-101 --file /review/out/review.md --reviewer independent-reviewer --output /review/out/review.json --signing-key /secure/reviewer.pem --key-id reviewer-2026
dyro task evidence review API-101 --file /review/out/review.json
dyro key generate approver-2026 --private-key /secure/approver.pem --public-key /secure/approver.pub.pem
dyro key trust approver-2026 --purpose signoff --public-key /secure/approver.pub.pem
dyro task signoff API-101 --by release-manager --signing-key /secure/approver.pem --key-id approver-2026
dyro key list --purpose execution --show-status
dyro key revoke runner-2026 --purpose execution --reason "runner retired"
dyro key audit로컬 trust 감사 체인을 독립 Witness에 동기화합니다.
dyro key generate audit-client-2026 --private-key /secure/audit-client.pem --public-key /secure/audit-client.pub.pem
# 대역 외 보안 채널로 Witness에 audit-client.pub.pem을 설치합니다.
dyro key trust witness-2026 --purpose audit-receipt --public-key witness-2026.pub.pem
dyro key trust witness-recovery --purpose audit-recovery --public-key witness-recovery.pub.pem
DYRO_AUDIT_TOKEN=... dyro key audit-sync --witness primary --endpoint https://audit.example.com/v1/dyro/batches --signing-key /secure/audit-client.pem --key-id audit-client-2026 --witness-key-id witness-2026 --witness-recovery-key-id witness-recovery새 이벤트가 없어도 서명된 체크포인트를 보냅니다. 응답이 유실되면 이미 저장된 pending batch를 그대로 재전송합니다. Witness는 이벤트 체인을 독립 재계산하고, 시퀀스/체인 헤드 포크를 거부하며, 검증 가능한 receipt를 발급하고, 보존 잠금이 있는 불변 저장소에 batch와 receipt를 기록해야 합니다. 프로토콜·키 로테이션·배포 경계는 Audit Witness protocol을 참고하세요.
프로젝트는 배포 가능한 표준 라이브러리 Witness 서비스 dyro witness serve를 제공합니다. 기본적으로 bearer token과 TLS가 필요하며 records/<batch-sha256>.json 생성 후에만 체크포인트를 전진합니다. 크래시 복구는 미완료 레코드를 복원합니다. 프로덕션에서는 가변 체크포인트와 불변 records 아카이브를 분리하세요. 키 로테이션·컨테이너·S3 Object Lock은 Witness deployment guide를 참고하세요.
서명 강제는 policy.require_signed_execution, policy.require_signed_review, policy.require_signed_signoff로 명시 제어됩니다. 신뢰 키를 모두 삭제해도 켜진 정책은 비활성화되지 않습니다. 서명된 실행 claim은 claim_id, generation, runner, execution key ID를 묶습니다. 서명 메시지와 실행 계획 해시는 RFC 8785 JCS 바이트를 사용해 비 Python runner도 동일 페이로드를 재현할 수 있습니다. 독립 검토자는 dyro task evidence review-build로 서명 JSON 엔벨로프를 만듭니다. 로테이션은 무중단: 새 key ID를 먼저 신뢰하고, 겹치는 동안 옛 키를 유지한 뒤, 워크스페이스의 통제된 키 관리 절차로 폐기합니다.
최소 TypeScript 참조 서명기와 Python/Node 상호운용 벡터는 examples/typescript-runner/에 있으며, 제어 평면이 기대하는 정규 바이트·서명 도메인·Ed25519 호출·서명 엔벨로프를 보여 줍니다.
쓰기 가능한 모든 작업에는 계획 모드가 있습니다.
dyro --dry-run line create release-2026-10 --base origin/main
dyro --dry-run task run API-101| 명령 | 목적 |
|---|---|
setup / init --discover / init --wizard / repo add/list / bootstrap / start |
TOML 편집 없이 온보딩, anchor 관리, 라인·agent 선택. |
doctor / status |
제어 평면 상태 검증 및 표시. |
line create/list |
기능 개발 라인 생성·등록·조회. |
hotfix create |
명시적 프로덕션 기준으로 hotfix 라인 생성. |
changeset create/list/verify |
다중 저장소 배포를 구성하는 깨끗한 정확한 Git head 고정 및 검증. |
config get/set / agent list/add/test / open |
공통 정책·adapter 안전 관리, 실행 파일 검증, 올바른 개발 라인에서 agent 열기. |
task create/list/board/status/next/graph/explain/attempts/binding |
작업 매니페스트·상태, 그래프 컴파일/검증, 스케줄 설명, provenance, 정확한 검토 바인딩. |
task run/answer/gates/review/signoff |
작업 실행, 질문 해결, 게이트, 독립 검토, 필요 시 외부 sign-off. |
task claim --output / task evidence build/execution/review |
create-only 전달 파일을 쓰는 1회 claim, 이식 가능 실행 증거 빌드/가져오기, receipt 바인딩 검토 가져오기. |
task merge |
검토된 작업 분기를 소유 개발 라인에 병합. |
task loop/daemon/stats/decisions |
통제된 배치, 스케줄링, 원장 보고, 의사결정 게이트. |
dispatch |
선택적 로컬 멀티 에이전트 파견(L0–L4); 권고만 — gates/merge 대체 아님. |
구현 세부사항: architecture and Profile contract, diagram guide, migration guide, 유지자용 PyPI publishing.
이 README는 영어, 중국어 간체, 한국어, 스페인어, 프랑스어, 독일어, 브라질 포르투갈어, 러시아어로 유지됩니다. 명령·설정 키·디렉터리 이름·안전 규칙은 모든 번역에서 동일합니다. CLI 메시지와 확장 기술 가이드는 현재 주로 중국어이며, 다국어 README가 런타임 언어 전환을 의미하지는 않습니다.
DyroEngineeringFlow는 계획 모드 팀을 위한 완전한 로컬 워크플로와 정책 제어를 제공합니다. 원격 저장소를 만들거나 SaaS 자격 증명을 전달하거나 외부 runner를 프로비저닝하지 않으며, 외부 실행을 위한 이식 가능한 증거 패키지 계약은 유지합니다. 선택형 로컬 Agent dispatch는 experiments.local_agent_dispatch로 함께 배포되고 dyro dispatch …로 사용합니다. 이 결과는 참고용이며 gates, review, signoff, merge를 대체하지 않습니다. 로컬 다중 저장소 merge는 하나의 작업으로 사전 점검·복구되며, 원격 Git 서버는 원자적 다중 저장소 push를 제공하지 않아 부분 실패를 기록합니다. 자동 merge에는 task manifest와 로컬 policy의 권한이 모두 필요합니다. MIT License 및 PyPI dyro에서 제공합니다.