aisupervisor 0.1.0b1__tar.gz

aisupervisor-0.1.0b1/MANIFEST.in

@@ -0,0 +1,17 @@
+# 배포본에 무엇을 넣지 **않을지** 정한다.
+#
+# setuptools 의 sdist 는 기본으로 `tests/` 를 통째로 담는다. 그 안에는 이 제품과
+# 무관한 하네스·company 시험 65개가 들어 있고, 올리면 내부 구조가 그대로 공개된다
+# (실측: 638 KB sdist 안에 test_acp_*·test_company_* 가 전부 있었다).
+#
+# 제품은 `supervisor` 와 `registry` 두 패키지뿐이다. 그 밖은 담지 않는다.
+prune tests
+prune harness
+prune company
+prune projects
+prune evolution
+prune docs
+prune beta
+prune _workspace
+prune research
+exclude MEMORY.md CLAUDE.md

aisupervisor-0.1.0b1/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: aisupervisor
+Version: 0.1.0b1
+Summary: 목표만 주면 필요한 Agent 를 찾아 검증하고, 권한과 협업 순서까지 구성한다
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# AI Supervisor  — **Closed Beta (pre-release)**
+
+> **이 판은 0.1.0b1, Closed Beta 시험판입니다.** 정식판이 아닙니다.
+> 참가자 2명과 함께 「전문가 팀 방식이 값을 하는가」를 확인하는 중이고,
+> 그 답에 따라 구조가 바뀔 수 있습니다. 업무에 그대로 의존하지 마십시오.
+
+목표만 주면 **필요한 전문가 Agent 를 모아** 일을 시킵니다. Claude Code 를
+대체하지 않고 그 위에서 돕니다.
+
+```bash
+pip install aisupervisor
+
+cd ~/my-project     # 당신의 git 저장소
+supervisor
+```
+
+알아야 할 것은 위 두 줄뿐입니다. `init` 도, `--repo` 도, 작업 종류도 치지
+않습니다. Supervisor 가 목표를 읽고 **무슨 일인지 · 혼자 할지 팀을 부를지 ·
+누가 붙을지**를 정하고, 그 이유를 먼저 보여 줍니다.
+
+## 무엇이 다른가
+
+- **검증된 Agent 만 씁니다.** 처음 실행하면 이 기계의 격리된 임시 저장소에서
+  Agent 를 **실제로 돌려 보고**, 통과한 것만 일에 넣습니다. 다른 기계의 검증
+  결과를 그대로 믿지 않습니다.
+- **작업마다 권한이 다릅니다.** 기획·설계는 읽기만, 구현자는 쓰기까지,
+  시험은 실행까지. 선언하지 않은 도구를 쓰려 하면 막습니다.
+- **말이 아니라 증거로 판정합니다.** 바뀌었다는 파일이 정말 바뀌었는지,
+  통과했다는 시험이 **우리가 돌려도** 통과하는지 직접 확인합니다.
+- **뒤 Agent 가 앞 Agent 를 그냥 믿지 않습니다.** 어긋난 것을 발견하면 그
+  단계로 되감아 다시 만듭니다.
+
+## 지원 환경
+
+| | |
+|---|---|
+| Python | **3.10 이상** |
+| 함께 필요한 것 | `git`, [Claude Code CLI](https://docs.claude.com/en/docs/claude-code) (`claude` 명령) |
+| 실측한 OS | **Linux 만** |
+| **Windows** | **아직 실측하지 않았습니다.** 순수 파이썬 휠(`py3-none-any`)이고 배포 코드에 POSIX 전용 호출이 없어 설치는 될 구조지만, 저희가 돌려 본 적은 없습니다 |
+| macOS | 실측하지 않았습니다 (Linux 와 같은 조건으로 봅니다) |
+| 외부 의존성 | **0** — Python 표준 라이브러리만 씁니다 |
+
+Claude Code CLI 사용량은 **사용자 본인 계정에서** 나갑니다. 실측: 작은 수정
+30~60초·$0.2 안팎, 큰 기능 하나에 팀이 붙으면 **30~40분·$10 이상**.
+
+## 알려진 한계
+
+- **브라우저에서의 화면 동작 확인은 사람 몫입니다.** 서버가 준 HTML 은
+  확인하지만 클릭 이후는 자동 시험이 아닙니다
+- **자동 재작업(되감기)은 한 실행에 2회**까지입니다. 넘으면 남은 지적은
+  기록만 되고 반영되지 않습니다
+- **팀 방식은 느리고 비쌉니다.** 같은 앱을 혼자 344초·$1.86 에, 팀은
+  2562초·$10.86 에 만들었고 **둘 다 동작했습니다.** 작은 일은 알아서 혼자
+  처리하지만, 큰 일에 팀을 붙이는 판단이 늘 옳다고 보지 않습니다
+- 시험이 없는 저장소에서는 완료를 판정할 수 없습니다 (`--test-command` 로
+  알려 주시면 이어서 판정합니다)
+- 저장소 여러 개를 한 번에 다루지 못합니다
+
+## 이번 판에서 **하지 않는** 일
+
+- **운영 배포(`deploy.production`)**
+- **비밀값 접근(`secret.read`)**
+- **되돌리기 어려운 마이그레이션 · 파괴적 운영 작업**
+
+Agent 가 이런 권한을 요구하면 **실행 전에 멈추고** 사람에게 알립니다.
+승인해서 진행하는 경로는 이번 판에 없습니다.
+
+## 소스 코드와 기록
+
+- **코드는 당신의 기계를 떠나지 않습니다.** Supervisor 는 서버가 없고 계정도
+  로그인도 없습니다. 다만 Claude Code CLI 자체는 Anthropic API 와 통신하며,
+  그 범위는 평소 `claude` 를 쓰실 때와 **똑같습니다**
+- 실행 기록은 `~/.supervisor/` 안에만 쌓입니다
+- **기록에 소스 코드가 들어가지 않습니다** — 바뀐 파일의 **개수와 확장자만**
+  남고 경로도 내용도 남기지 않습니다. 목표 문장은 흔한 비밀값 모양
+  (토큰·비밀번호)을 지운 뒤 남습니다
+- 저희가 기록을 자동으로 가져가지 않습니다. **직접 보내 주실 때만** 봅니다
+  (`supervisor report --out 파일`)
+
+## 바뀐 코드는 커밋되지 않습니다
+
+`git diff` 로 직접 보고 판단하십시오. Supervisor 는 커밋하지 않습니다.

aisupervisor-0.1.0b1/PYPI.md

@@ -0,0 +1,83 @@
+# AI Supervisor  — **Closed Beta (pre-release)**
+
+> **이 판은 0.1.0b1, Closed Beta 시험판입니다.** 정식판이 아닙니다.
+> 참가자 2명과 함께 「전문가 팀 방식이 값을 하는가」를 확인하는 중이고,
+> 그 답에 따라 구조가 바뀔 수 있습니다. 업무에 그대로 의존하지 마십시오.
+
+목표만 주면 **필요한 전문가 Agent 를 모아** 일을 시킵니다. Claude Code 를
+대체하지 않고 그 위에서 돕니다.
+
+```bash
+pip install aisupervisor
+
+cd ~/my-project     # 당신의 git 저장소
+supervisor
+```
+
+알아야 할 것은 위 두 줄뿐입니다. `init` 도, `--repo` 도, 작업 종류도 치지
+않습니다. Supervisor 가 목표를 읽고 **무슨 일인지 · 혼자 할지 팀을 부를지 ·
+누가 붙을지**를 정하고, 그 이유를 먼저 보여 줍니다.
+
+## 무엇이 다른가
+
+- **검증된 Agent 만 씁니다.** 처음 실행하면 이 기계의 격리된 임시 저장소에서
+  Agent 를 **실제로 돌려 보고**, 통과한 것만 일에 넣습니다. 다른 기계의 검증
+  결과를 그대로 믿지 않습니다.
+- **작업마다 권한이 다릅니다.** 기획·설계는 읽기만, 구현자는 쓰기까지,
+  시험은 실행까지. 선언하지 않은 도구를 쓰려 하면 막습니다.
+- **말이 아니라 증거로 판정합니다.** 바뀌었다는 파일이 정말 바뀌었는지,
+  통과했다는 시험이 **우리가 돌려도** 통과하는지 직접 확인합니다.
+- **뒤 Agent 가 앞 Agent 를 그냥 믿지 않습니다.** 어긋난 것을 발견하면 그
+  단계로 되감아 다시 만듭니다.
+
+## 지원 환경
+
+| | |
+|---|---|
+| Python | **3.10 이상** |
+| 함께 필요한 것 | `git`, [Claude Code CLI](https://docs.claude.com/en/docs/claude-code) (`claude` 명령) |
+| 실측한 OS | **Linux 만** |
+| **Windows** | **아직 실측하지 않았습니다.** 순수 파이썬 휠(`py3-none-any`)이고 배포 코드에 POSIX 전용 호출이 없어 설치는 될 구조지만, 저희가 돌려 본 적은 없습니다 |
+| macOS | 실측하지 않았습니다 (Linux 와 같은 조건으로 봅니다) |
+| 외부 의존성 | **0** — Python 표준 라이브러리만 씁니다 |
+
+Claude Code CLI 사용량은 **사용자 본인 계정에서** 나갑니다. 실측: 작은 수정
+30~60초·$0.2 안팎, 큰 기능 하나에 팀이 붙으면 **30~40분·$10 이상**.
+
+## 알려진 한계
+
+- **브라우저에서의 화면 동작 확인은 사람 몫입니다.** 서버가 준 HTML 은
+  확인하지만 클릭 이후는 자동 시험이 아닙니다
+- **자동 재작업(되감기)은 한 실행에 2회**까지입니다. 넘으면 남은 지적은
+  기록만 되고 반영되지 않습니다
+- **팀 방식은 느리고 비쌉니다.** 같은 앱을 혼자 344초·$1.86 에, 팀은
+  2562초·$10.86 에 만들었고 **둘 다 동작했습니다.** 작은 일은 알아서 혼자
+  처리하지만, 큰 일에 팀을 붙이는 판단이 늘 옳다고 보지 않습니다
+- 시험이 없는 저장소에서는 완료를 판정할 수 없습니다 (`--test-command` 로
+  알려 주시면 이어서 판정합니다)
+- 저장소 여러 개를 한 번에 다루지 못합니다
+
+## 이번 판에서 **하지 않는** 일
+
+- **운영 배포(`deploy.production`)**
+- **비밀값 접근(`secret.read`)**
+- **되돌리기 어려운 마이그레이션 · 파괴적 운영 작업**
+
+Agent 가 이런 권한을 요구하면 **실행 전에 멈추고** 사람에게 알립니다.
+승인해서 진행하는 경로는 이번 판에 없습니다.
+
+## 소스 코드와 기록
+
+- **코드는 당신의 기계를 떠나지 않습니다.** Supervisor 는 서버가 없고 계정도
+  로그인도 없습니다. 다만 Claude Code CLI 자체는 Anthropic API 와 통신하며,
+  그 범위는 평소 `claude` 를 쓰실 때와 **똑같습니다**
+- 실행 기록은 `~/.supervisor/` 안에만 쌓입니다
+- **기록에 소스 코드가 들어가지 않습니다** — 바뀐 파일의 **개수와 확장자만**
+  남고 경로도 내용도 남기지 않습니다. 목표 문장은 흔한 비밀값 모양
+  (토큰·비밀번호)을 지운 뒤 남습니다
+- 저희가 기록을 자동으로 가져가지 않습니다. **직접 보내 주실 때만** 봅니다
+  (`supervisor report --out 파일`)
+
+## 바뀐 코드는 커밋되지 않습니다
+
+`git diff` 로 직접 보고 판단하십시오. Supervisor 는 커밋하지 않습니다.

aisupervisor-0.1.0b1/aisupervisor.egg-info/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: aisupervisor
+Version: 0.1.0b1
+Summary: 목표만 주면 필요한 Agent 를 찾아 검증하고, 권한과 협업 순서까지 구성한다
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# AI Supervisor  — **Closed Beta (pre-release)**
+
+> **이 판은 0.1.0b1, Closed Beta 시험판입니다.** 정식판이 아닙니다.
+> 참가자 2명과 함께 「전문가 팀 방식이 값을 하는가」를 확인하는 중이고,
+> 그 답에 따라 구조가 바뀔 수 있습니다. 업무에 그대로 의존하지 마십시오.
+
+목표만 주면 **필요한 전문가 Agent 를 모아** 일을 시킵니다. Claude Code 를
+대체하지 않고 그 위에서 돕니다.
+
+```bash
+pip install aisupervisor
+
+cd ~/my-project     # 당신의 git 저장소
+supervisor
+```
+
+알아야 할 것은 위 두 줄뿐입니다. `init` 도, `--repo` 도, 작업 종류도 치지
+않습니다. Supervisor 가 목표를 읽고 **무슨 일인지 · 혼자 할지 팀을 부를지 ·
+누가 붙을지**를 정하고, 그 이유를 먼저 보여 줍니다.
+
+## 무엇이 다른가
+
+- **검증된 Agent 만 씁니다.** 처음 실행하면 이 기계의 격리된 임시 저장소에서
+  Agent 를 **실제로 돌려 보고**, 통과한 것만 일에 넣습니다. 다른 기계의 검증
+  결과를 그대로 믿지 않습니다.
+- **작업마다 권한이 다릅니다.** 기획·설계는 읽기만, 구현자는 쓰기까지,
+  시험은 실행까지. 선언하지 않은 도구를 쓰려 하면 막습니다.
+- **말이 아니라 증거로 판정합니다.** 바뀌었다는 파일이 정말 바뀌었는지,
+  통과했다는 시험이 **우리가 돌려도** 통과하는지 직접 확인합니다.
+- **뒤 Agent 가 앞 Agent 를 그냥 믿지 않습니다.** 어긋난 것을 발견하면 그
+  단계로 되감아 다시 만듭니다.
+
+## 지원 환경
+
+| | |
+|---|---|
+| Python | **3.10 이상** |
+| 함께 필요한 것 | `git`, [Claude Code CLI](https://docs.claude.com/en/docs/claude-code) (`claude` 명령) |
+| 실측한 OS | **Linux 만** |
+| **Windows** | **아직 실측하지 않았습니다.** 순수 파이썬 휠(`py3-none-any`)이고 배포 코드에 POSIX 전용 호출이 없어 설치는 될 구조지만, 저희가 돌려 본 적은 없습니다 |
+| macOS | 실측하지 않았습니다 (Linux 와 같은 조건으로 봅니다) |
+| 외부 의존성 | **0** — Python 표준 라이브러리만 씁니다 |
+
+Claude Code CLI 사용량은 **사용자 본인 계정에서** 나갑니다. 실측: 작은 수정
+30~60초·$0.2 안팎, 큰 기능 하나에 팀이 붙으면 **30~40분·$10 이상**.
+
+## 알려진 한계
+
+- **브라우저에서의 화면 동작 확인은 사람 몫입니다.** 서버가 준 HTML 은
+  확인하지만 클릭 이후는 자동 시험이 아닙니다
+- **자동 재작업(되감기)은 한 실행에 2회**까지입니다. 넘으면 남은 지적은
+  기록만 되고 반영되지 않습니다
+- **팀 방식은 느리고 비쌉니다.** 같은 앱을 혼자 344초·$1.86 에, 팀은
+  2562초·$10.86 에 만들었고 **둘 다 동작했습니다.** 작은 일은 알아서 혼자
+  처리하지만, 큰 일에 팀을 붙이는 판단이 늘 옳다고 보지 않습니다
+- 시험이 없는 저장소에서는 완료를 판정할 수 없습니다 (`--test-command` 로
+  알려 주시면 이어서 판정합니다)
+- 저장소 여러 개를 한 번에 다루지 못합니다
+
+## 이번 판에서 **하지 않는** 일
+
+- **운영 배포(`deploy.production`)**
+- **비밀값 접근(`secret.read`)**
+- **되돌리기 어려운 마이그레이션 · 파괴적 운영 작업**
+
+Agent 가 이런 권한을 요구하면 **실행 전에 멈추고** 사람에게 알립니다.
+승인해서 진행하는 경로는 이번 판에 없습니다.
+
+## 소스 코드와 기록
+
+- **코드는 당신의 기계를 떠나지 않습니다.** Supervisor 는 서버가 없고 계정도
+  로그인도 없습니다. 다만 Claude Code CLI 자체는 Anthropic API 와 통신하며,
+  그 범위는 평소 `claude` 를 쓰실 때와 **똑같습니다**
+- 실행 기록은 `~/.supervisor/` 안에만 쌓입니다
+- **기록에 소스 코드가 들어가지 않습니다** — 바뀐 파일의 **개수와 확장자만**
+  남고 경로도 내용도 남기지 않습니다. 목표 문장은 흔한 비밀값 모양
+  (토큰·비밀번호)을 지운 뒤 남습니다
+- 저희가 기록을 자동으로 가져가지 않습니다. **직접 보내 주실 때만** 봅니다
+  (`supervisor report --out 파일`)
+
+## 바뀐 코드는 커밋되지 않습니다
+
+`git diff` 로 직접 보고 판단하십시오. Supervisor 는 커밋하지 않습니다.

aisupervisor-0.1.0b1/aisupervisor.egg-info/SOURCES.txt

@@ -0,0 +1,49 @@
+MANIFEST.in
+PYPI.md
+README.md
+pyproject.toml
+aisupervisor.egg-info/PKG-INFO
+aisupervisor.egg-info/SOURCES.txt
+aisupervisor.egg-info/dependency_links.txt
+aisupervisor.egg-info/entry_points.txt
+aisupervisor.egg-info/top_level.txt
+registry/__init__.py
+registry/__main__.py
+registry/cli.py
+registry/integrity.py
+registry/models.py
+registry/probes.py
+registry/server.py
+registry/store.py
+registry/verify.py
+registry/seed/backend-implementer.json
+registry/seed/code-reviewer.json
+registry/seed/frontend-implementer.json
+registry/seed/overreaching-reviewer.json
+registry/seed/product-planner.json
+registry/seed/repo-analyst.json
+registry/seed/security-reviewer.json
+registry/seed/test-runner.json
+registry/seed/ui-designer.json
+registry/seed/ux-designer.json
+registry/web/index.html
+supervisor/__init__.py
+supervisor/__main__.py
+supervisor/analyze.py
+supervisor/artifacts.py
+supervisor/capability.py
+supervisor/cli.py
+supervisor/decide.py
+supervisor/display.py
+supervisor/metrics.py
+supervisor/permission.py
+supervisor/pipeline.py
+supervisor/registry_client.py
+supervisor/runner.py
+supervisor/shell.py
+supervisor/team.py
+supervisor/telemetry.py
+supervisor/workspace.py
+supervisor/adapters/__init__.py
+supervisor/adapters/base.py
+supervisor/adapters/claude_code.py

aisupervisor-0.1.0b1/aisupervisor.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

aisupervisor-0.1.0b1/aisupervisor.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+agent-registry = registry.cli:main
+supervisor = supervisor.cli:main

aisupervisor-0.1.0b1/aisupervisor.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+registry
+supervisor

aisupervisor-0.1.0b1/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "aisupervisor"
+dynamic = ["version"]
+description = "목표만 주면 필요한 Agent 를 찾아 검증하고, 권한과 협업 순서까지 구성한다"
+readme = {file = "PYPI.md", content-type = "text/markdown"}
+requires-python = ">=3.10"
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Operating System :: POSIX :: Linux",
+  "Operating System :: MacOS",
+  "Topic :: Software Development :: Build Tools",
+  "Topic :: Software Development :: Quality Assurance",
+]
+# 외부 의존성 0 — stdlib 만 쓴다. 설치하는 사람이 치를 값이 없어야 한다.
+dependencies = []
+
+[project.scripts]
+supervisor = "supervisor.cli:main"
+agent-registry = "registry.cli:main"
+
+[tool.setuptools.dynamic]
+version = {attr = "supervisor.__version__"}
+
+[tool.setuptools]
+packages = ["supervisor", "supervisor.adapters", "registry"]
+
+[tool.setuptools.package-data]
+registry = ["seed/*.json", "web/*.html"]

aisupervisor-0.1.0b1/registry/__init__.py

@@ -0,0 +1 @@
+"""Verified Agent Registry — capability 와 permission 의 source of truth."""

aisupervisor-0.1.0b1/registry/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from .cli import main
+
+sys.exit(main())

aisupervisor-0.1.0b1/registry/cli.py

@@ -0,0 +1,121 @@
+"""Registry CLI — 등록·검증·조회."""
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+from supervisor.adapters.claude_code import ClaudeCodeAdapter
+
+from .models import REJECTED, REVIEW_REQUIRED, VERIFIED
+from .store import Store, StoreError
+from .verify import verify
+
+
+def cmd_list(args) -> int:
+    store = Store(args.home)
+    for agent in store.all():
+        v = agent.verification
+        mark = {VERIFIED: "✓", REVIEW_REQUIRED: "?", REJECTED: "✗"}.get(
+            v.status if v else "", "-")
+        status = v.status if v else "미검증"
+        print(f"  {mark} {agent.agent_id:24s} v{agent.version:8s} {status:16s} "
+              f"{','.join(agent.capabilities)}")
+    return 0
+
+
+def cmd_show(args) -> int:
+    store = Store(args.home)
+    agent = store.get(args.agent_id)
+    if agent is None:
+        print(f"[registry] 없는 agent: {args.agent_id}", file=sys.stderr)
+        return 1
+    print(json.dumps(agent.as_dict(), ensure_ascii=False, indent=2))
+    return 0
+
+
+def cmd_register(args) -> int:
+    store = Store(args.home)
+    raw = json.loads(Path(args.file).read_text(encoding="utf-8"))
+    try:
+        agent = store.register(raw)
+    except StoreError as exc:
+        print(f"[registry] {exc}", file=sys.stderr)
+        return 1
+    print(f"등록: {agent.agent_id} v{agent.version} (아직 미검증)")
+    return 0
+
+
+def cmd_verify(args) -> int:
+    store = Store(args.home)
+    adapter = ClaudeCodeAdapter()
+    targets = ([store.get(args.agent_id)] if args.agent_id else store.all())
+    if any(t is None for t in targets):
+        print(f"[registry] 없는 agent: {args.agent_id}", file=sys.stderr)
+        return 1
+    worst = 0
+    for agent in targets:
+        #: 건너뛰는 조건은 **지금 이 기계에서 쓸 수 있는 상태**여야 한다.
+        #:
+        #: 버전만 보고 건너뛰던 판이 있었다. 그래서 새 기계에서는 패키지에
+        #: 담겨 온 결과(서명이 이 기계 키와 맞지 않는다)를 "이미 검증됨" 으로
+        #: 보고 넘어갔고, `init` 이 "쓸 수 있는 Agent 0개" 로 끝났다.
+        #: 설치 직후 아무것도 못 쓰는 것은 설치 실패와 같다.
+        already = (agent.is_usable()
+                   or (agent.verification is not None
+                       and agent.verification.status == REJECTED
+                       and agent.verification.version == agent.version))
+        if already and not args.force:
+            print(f"  = {agent.agent_id}: 이미 확인됨 "
+                  f"({agent.verification.status})")
+            continue
+        result = verify(agent, adapter)
+        agent.verification = result
+        store.save(agent)
+        mark = {VERIFIED: "✓", REVIEW_REQUIRED: "?", REJECTED: "✗"}[result.status]
+        print(f"  {mark} {agent.agent_id}: {result.status}")
+        for name, ok in result.checks.items():
+            print(f"      {name:12s} {'통과' if ok else '탈락'} — "
+                  f"{result.evidence.get(name, '')[:96]}")
+        for why in result.reasons:
+            print(f"      ! {why}")
+        if result.status == REJECTED:
+            worst = max(worst, 1)
+    return worst
+
+
+def cmd_serve(args) -> int:
+    from .server import serve
+    srv = serve(args.host, args.port, args.home)
+    url = f"http://{args.host}:{args.port}/"
+    print(f"Verified Agent Catalog: {url}")
+    print(f"  GET {url}api/agents   GET {url}api/capabilities")
+    print("  Ctrl-C 로 멈춘다")
+    try:
+        srv.serve_forever()
+    except KeyboardInterrupt:
+        print("\n멈췄다")
+    return 0
+
+
+def main(argv=None) -> int:
+    parser = argparse.ArgumentParser(prog="python -m registry")
+    parser.add_argument("--home", help="Agent 저장 위치 (기본: registry/seed)")
+    sub = parser.add_subparsers(dest="cmd", required=True)
+    sub.add_parser("list").set_defaults(fn=cmd_list)
+    show = sub.add_parser("show"); show.add_argument("agent_id")
+    show.set_defaults(fn=cmd_show)
+    reg = sub.add_parser("register"); reg.add_argument("file")
+    reg.set_defaults(fn=cmd_register)
+    ver = sub.add_parser("verify")
+    ver.add_argument("agent_id", nargs="?")
+    ver.add_argument("--force", action="store_true",
+                     help="이미 검증된 버전도 다시 돌린다")
+    ver.set_defaults(fn=cmd_verify)
+    srv = sub.add_parser("serve", help="Registry REST + Web Catalog 를 띄운다")
+    srv.add_argument("--host", default="127.0.0.1")
+    srv.add_argument("--port", type=int, default=8787)
+    srv.set_defaults(fn=cmd_serve)
+    args = parser.parse_args(argv)
+    return args.fn(args)

aisupervisor-0.1.0b1/registry/integrity.py

@@ -0,0 +1,88 @@
+"""검증 결과가 **손으로 쓰여지지 않았는가.**
+
+## 왜 필요한가
+
+실측(독립 리뷰): `registry/seed/*.json` 은 평범한 JSON 파일이고, 거기에
+`"verification": {"status": "verified", ...}` 를 손으로 써 넣으면 Supervisor 가
+그 Agent 를 **자동으로 쓴다.** 검증을 안 거치고도 Verified 가 된다.
+
+Registry 가 "source of truth" 라고 말하려면 그 말이 참이어야 한다.
+
+## 어떻게
+
+검증기가 결과에 **서명**을 붙인다. 서명은 그 Agent 의 정체(id·version·
+capability·permission)와 검증 내용(상태·검사 결과)에 걸린다. 하나라도 손으로
+바꾸면 서명이 맞지 않고, `is_trusted()` 가 거짓이 된다.
+
+## 한계 — 정직하게
+
+키는 이 기계 안(`~/.supervisor/registry.key`)에 있다. **기계를 가진 사람은
+서명도 만들 수 있다.** 이것이 막는 것은 "파일을 고쳐 검증을 위조하는 일" 이지
+"기계를 장악한 상대" 가 아니다. 원격 Registry 가 생기면 서명 키는 서버로
+가야 하고, 그때 이 함수의 자리는 그대로 두고 키의 출처만 바뀐다.
+"""
+from __future__ import annotations
+
+import hashlib
+import hmac
+import json
+import os
+import secrets
+from pathlib import Path
+
+
+def key_path() -> Path:
+    override = os.environ.get("REGISTRY_KEY_FILE")
+    if override:
+        return Path(override)
+    home = os.environ.get("SUPERVISOR_HOME")
+    base = Path(home) if home else Path.home() / ".supervisor"
+    return base / "registry.key"
+
+
+def load_key() -> bytes:
+    """없으면 만든다. 키가 바뀌면 이전 서명은 전부 무효가 된다 — 그것이 맞다."""
+    path = key_path()
+    if path.is_file():
+        return path.read_bytes()
+    path.parent.mkdir(parents=True, exist_ok=True)
+    material = secrets.token_bytes(32)
+    path.write_bytes(material)
+    try:
+        path.chmod(0o600)
+    except OSError:
+        pass
+    return material
+
+
+def payload(agent) -> bytes:
+    """서명이 걸리는 내용.
+
+    **정체와 검증 결과 둘 다**에 건다. 정체만 걸면 검증 결과를 바꿔치기할 수
+    있고, 검증 결과만 걸면 다른 Agent 의 서명을 옮겨 붙일 수 있다.
+    """
+    v = agent.verification
+    body = {
+        "agent_id": agent.agent_id,
+        "version": agent.version,
+        "capabilities": sorted(agent.capabilities),
+        "permissions": sorted(agent.permissions),
+        "human_only": sorted(agent.human_only),
+        "status": v.status if v else None,
+        "verified_at": v.verified_at if v else None,
+        "checks": dict(sorted((v.checks or {}).items())) if v else None,
+        "verification_version": v.version if v else None,
+    }
+    return json.dumps(body, ensure_ascii=False, sort_keys=True).encode("utf-8")
+
+
+def sign(agent) -> str:
+    return hmac.new(load_key(), payload(agent), hashlib.sha256).hexdigest()
+
+
+def is_trusted(agent) -> bool:
+    """이 검증 결과가 우리 검증기에서 나온 것인가."""
+    v = agent.verification
+    if v is None or not getattr(v, "signature", ""):
+        return False
+    return hmac.compare_digest(v.signature, sign(agent))