고객의 워크벤치에
VibePackr를 연결합니다.

하나의 연결, 분명한 역할.

확장을 연결하기 전에 최신 다운로드·호스트 안내·Tool MCP 검증 범위를 확인하세요. 추가 모델·상주 서비스·GPU 제어 연산·멀티 에이전트 스케줄러는 필요하지 않습니다.

PoC 패키지는 AWS·Azure·GCP 또는 자체 인프라의 호환 VM에 설치합니다. 클라우드 마켓플레이스 등록이나 구독은 필요하지 않습니다. 현재 서버 대상은 systemd를 사용하는 Debian 13 amd64/x86_64이며, 고객이 설치 권한·저장소·네트워크를 준비합니다. 다운로드 포털의 Google 로그인은 GCP 사용 조건이 아닙니다. 이는 배포 방식 안내이며 모든 클라우드 구성의 실검증을 뜻하지는 않습니다.

고객이 사용하는 워크벤치는 그대로 두고 VibePackr의 네이티브 기능을 연결합니다. CALF는 로컬 실행 기록과 파일 검수를 담당하는 예시이며, 다른 고객 앱도 같은 경계를 따라 연결할 수 있습니다.

실습은 네이티브 분석과 로컬 보고서 작업이라는 두 연결 단계로 실행되며 AI 에이전트가 필요하지 않습니다. 실제 제품 Work는 보고서 실습 이후 별도의 제품 Work 연결 절차를 따릅니다.

시작 전에 준비할 것.

PoC 공통 설치와 작업공간 준비를 마친 뒤 이 절부터 시작합니다. 연결 담당자가 아래 설치별 정보를 한 번 인계하면 사용자는 다운로드·연결·검수를 이어갑니다. 실제 값은 공개 가이드가 아닌 개인 PoC 인계 기록에 보관합니다.

integration-lab/
  VibePackr-Workbench-Examples/   # extracted companion
  CALF-SDK-0.2.6/                # separately downloaded SDK
  private/connection.json       # your verified native descriptor pins
  capture-01/                   # created by capture_analysis.py
  binding-01/                   # created by bind_report.py prepare
  records/                      # shared CALF records for this exercise

파일 관리자에서 integration-lab과 그 안의 private 폴더를 먼저 만듭니다. 본인만 접근할 수 있는 위치를 선택합니다. 예제가 capture·binding 출력 폴더를 생성하며 기존 폴더는 덮어쓰지 않습니다.

처음에는 새 기록 폴더로 실습합니다. 나중에 기존 작업을 보려면 해당 기록 위치를 정확히 선택합니다. history.html·계약·설정·보존 런타임은 유지하고, 앱 연결을 위해 내부 상태 파일을 복사하거나 편집하지 않습니다.

다운로드하고, 확인하고, 실행합니다.

https://www.vibepackr.com/poc/workbench/install.md 를 읽어줘.
내 실제 운영체제에서 이 PoC 참조 실습용 CALF 클라이언트(Workbench 1.9.9 또는 Harness 1.8.13, SDK 0.2.6)를 준비해줘.
기존 기록·계약·설정·runtimes는 보존하고 새 폴더에서 다운로드 검증·실제 버전·도움말·SDK import를 확인해줘.
실제 경로·결과와 누락된 준비 사항을 알려줘. 이번 첫 설치에 호스트 설정 변경·모델 호출·기존 작업 실행은 포함하지 마.

SDK 0.2.6, 릴리즈 SHA256SUMS, SDK-SHA256SUMS도 받으세요. 창 없이 사용한다면 Harness 1.8.13을 선택합니다.

1. 다운로드한 압축의 SHA-256을 공식 목록의 동일 파일명과 비교합니다. 원본 압축은 보관합니다.
2. Workbench와 SDK 전체를 각각 버전별 폴더에 풉니다. 아래 명령의 절대 경로는 모두 실제 설치 경로로 바꿉니다.

shasum -a 256 CALF-Workbench-1.9.9-macos-arm64.zip
shasum -a 256 CALF-SDK-0.2.6.zip
unzip CALF-Workbench-1.9.9-macos-arm64.zip
unzip CALF-SDK-0.2.6.zip
# Set actual absolute paths after extraction:
CALF="/absolute/CALF-Workbench-1.9.9-macos-arm64/CALF Workbench.app/Contents/MacOS/calf"
SDK="/absolute/CALF-SDK-0.2.6"
EXAMPLES="/absolute/VibePackr-Workbench-Examples"
LAB="/absolute/integration-lab"
export CALF_WORK_HOME="$LAB/records"
"$CALF" --version
# Start from this terminal so this window receives the same records home:
"/absolute/CALF-Workbench-1.9.9-macos-arm64/CALF Workbench.app/Contents/MacOS/calf-terminal"

Get-FileHash .\CALF-Workbench-1.9.9-windows-x86_64.zip -Algorithm SHA256
Get-FileHash .\CALF-SDK-0.2.6.zip -Algorithm SHA256
Expand-Archive .\CALF-Workbench-1.9.9-windows-x86_64.zip -DestinationPath .\workbench-199
Expand-Archive .\CALF-SDK-0.2.6.zip -DestinationPath .\sdk-026
# Set actual absolute paths after extraction:
$Calf = 'C:\absolute\CALF-Workbench-1.9.9-windows-x86_64\calf.exe'
$Sdk = 'C:\absolute\CALF-SDK-0.2.6'
$Examples = 'C:\absolute\VibePackr-Workbench-Examples'
$Lab = 'C:\absolute\integration-lab'
$env:CALF_WORK_HOME = Join-Path $Lab 'records'
& $Calf --version
& 'C:\absolute\CALF-Workbench-1.9.9-windows-x86_64\calf-terminal.exe'

sha256sum CALF-Workbench-1.9.9-linux-x86_64.tar.gz
sha256sum CALF-SDK-0.2.6.zip
tar -xzf CALF-Workbench-1.9.9-linux-x86_64.tar.gz
unzip CALF-SDK-0.2.6.zip
# Set actual absolute paths after extraction:
CALF="/absolute/CALF-Workbench-1.9.9-linux-x86_64/calf"
SDK="/absolute/CALF-SDK-0.2.6"
EXAMPLES="/absolute/VibePackr-Workbench-Examples"
LAB="/absolute/integration-lab"
export CALF_WORK_HOME="$LAB/records"
"$CALF" --version
"/absolute/CALF-Workbench-1.9.9-linux-x86_64/calf-terminal"

VibePackr 네이티브 연결을 확인합니다.

아래 예제를 받아 풉니다. 연결 Adapter는 Python 표준 라이브러리만 사용하며 필요할 때 네이티브 stdio 자식 프로세스 하나를 실행합니다. 실제 도구 목록을 확인하고 사용 후 종료하며 HTTP 포트나 상주 서비스를 만들지 않습니다.

1. 연결 담당자에게 생성된 mcp-server.json과 확인된 SHA-256, 동일 패키지의 packr-agent-mcp SHA-256을 받습니다. descriptor가 참조하는 등록 정보·카탈로그는 원래 개인 경로에 유지합니다.
2. connection.example.json을 private/connection.json으로 복사하고 아래 세 값을 채웁니다. 직접 계산한 해시는 파일 비교용이며 그 자체가 배포자 신뢰를 증명하지는 않습니다.
3. setup status를 한 번 실행하고 네이티브 응답과 실제 카탈로그를 확인한 뒤 진행합니다.

{
  "descriptor": "/absolute/private/vibepackr-setup/mcp-server.json",
  "descriptor_sha256": "REPLACE_WITH_VERIFIED_DESCRIPTOR_SHA256",
  "adapter_sha256": "REPLACE_WITH_VERIFIED_NATIVE_EXECUTABLE_SHA256"
}

python3 -B "$EXAMPLES/calf_vibepackr.py" \
  --connection "$LAB/private/connection.json" \
  --tool vibepackr.setup.status --operation-ref guide:setup-001 \
  --request "$EXAMPLES/empty-request.json"

py -3 -B "$Examples\calf_vibepackr.py" `
  --connection "$Lab\private\connection.json" `
  --tool vibepackr.setup.status --operation-ref guide:setup-001 `
  --request "$Examples\empty-request.json"

python3 -B "$EXAMPLES/calf_vibepackr.py" \
  --connection "$LAB/private/connection.json" \
  --tool vibepackr.setup.status --operation-ref guide:setup-001 \
  --request "$EXAMPLES/empty-request.json"

등록된 입력 하나를 분석합니다.

담당자가 제공한 입력 ID를 사용합니다. 완전한 등록 통합 요청에 vibepackr.sdk.analyze를 호출하는 예제입니다. 임의의 파일 경로·프롬프트·토큰을 보내지 않습니다. 원본 응답·호출 ID·연결 관측값을 UTF-8 파일로 저장합니다.

python3 -B "$EXAMPLES/capture_analysis.py" \
  --connection "$LAB/private/connection.json" \
  --input-id YOUR_REGISTERED_INPUT_ID \
  --operation-ref guide:analysis-001 --output "$LAB/capture-01"

py -3 -B "$Examples\capture_analysis.py" `
  --connection "$Lab\private\connection.json" `
  --input-id YOUR_REGISTERED_INPUT_ID `
  --operation-ref guide:analysis-001 --output "$Lab\capture-01"

python3 -B "$EXAMPLES/capture_analysis.py" \
  --connection "$LAB/private/connection.json" \
  --input-id YOUR_REGISTERED_INPUT_ID \
  --operation-ref guide:analysis-001 --output "$LAB/capture-01"

결과를 검수된 파일 버전에 연결합니다.

다음은 별도의 CALF 보고서 작업입니다. 저장된 네이티브 응답을 입력으로 사용합니다. 런타임 Adapter는 VibePackr를 다시 호출하지 않고 native.json·report.json을 만듭니다. 코어의 7개 검사는 원본 바이트·정확한 보고서 필드·분석 성공·appliance Work 및 승인 주장 부재를 확인합니다.

python3 -B "$EXAMPLES/bind_report.py" --sdk "$SDK" \
  --calf "$CALF" --records "$CALF_WORK_HOME" prepare \
  --input "$LAB/capture-01/native-result.json" --output "$LAB/binding-01"

py -3 -B "$Examples\bind_report.py" --sdk "$Sdk" `
  --calf "$Calf" --records "$env:CALF_WORK_HOME" prepare `
  --input "$Lab\capture-01\native-result.json" --output "$Lab\binding-01"

python3 -B "$EXAMPLES/bind_report.py" --sdk "$SDK" \
  --calf "$CALF" --records "$CALF_WORK_HOME" prepare \
  --input "$LAB/capture-01/native-result.json" --output "$LAB/binding-01"

1. 준비: 고정된 인터프리터·스크립트를 등록하고 work-spec.json을 만듭니다. 아직 후보를 실행하지 않습니다.
2. 실행: 다음 절의 Workbench 또는 아래 SDK 명령 중 하나를 사용합니다. 두 경로를 별도 새 작업으로 중복 실행하지 않습니다.
3. 조회: verified: true·outcome: SATISFIED와 명세·검사 해시의 일치를 확인합니다. 작업 접수나 실행기 exit 0만으로 완료되지 않습니다.
4. 채택: 검사된 정확한 해시를 명시적으로 채택합니다. 로컬 파일 버전 선택이며 배포나 원본 덮어쓰기가 아닙니다.

python3 -B "$EXAMPLES/bind_report.py" --sdk "$SDK" \
  --calf "$CALF" --records "$CALF_WORK_HOME" run \
  --spec "$LAB/binding-01/work-spec.json" --result "$LAB/run-01.jsonl"

py -3 -B "$Examples\bind_report.py" --sdk "$Sdk" `
  --calf "$Calf" --records "$env:CALF_WORK_HOME" run `
  --spec "$Lab\binding-01\work-spec.json" --result "$Lab\run-01.jsonl"

python3 -B "$EXAMPLES/bind_report.py" --sdk "$SDK" \
  --calf "$CALF" --records "$CALF_WORK_HOME" run \
  --spec "$LAB/binding-01/work-spec.json" --result "$LAB/run-01.jsonl"

Workbench에서 같은 작업을 봅니다.

1. SDK와 동일한 CALF_WORK_HOME으로 Workbench를 열고 Runtime Work를 선택합니다.
2. 준비만 한 작업은 Import contract… → binding-01/work-spec.json → Add work 후 표시된 실행 동작을 선택합니다. SDK로 이미 실행했다면 Refresh 후 기존 작업을 선택합니다.
3. 진행 단계·두 산출물·7개 검사·Evidence JSON을 확인합니다. 보고서 범위와 정확한 해시를 확인한 뒤 Adopt checked version을 선택합니다.
4. 같은 기록 위치로 다시 열어 보존된 증거를 확인합니다. 작업 ID와 채택 해시가 같아야 합니다.

현재 CALF 한눈에 보기 · A4

11월 11일 배포 기능을 정리한 공개용 안내입니다. 터미널 그림은 이 연동 실습의 캡처가 아닌 설명용 구성도입니다. 원본 이미지를 열면 전체 크기로 읽을 수 있습니다.

이전 실제 Runtime Work 화면 · 1.9.2

채택 후에는 현재 outcome과 함께 adoptedValid를 확인합니다. 나중에 파일 변경으로 무효화되어도 adopted 객체에는 과거 선택 이력이 보존됩니다.

MCP 호스트에서 CALF를 조회합니다.

생성된 binding-01/work-mcp.json은 실행 descriptor입니다. 사용 중인 호스트의 MCP 설정 방식으로 이름 있는 항목을 추가합니다. 전체 설정 파일이 아니며 SDK가 자동 설치하지 않습니다. CALF Workbench 1.9.9는 임의 외부 MCP 서버 등록 화면을 제공하지 않습니다.

{
  "command": "/absolute/path/to/calf",
  "args": ["work-mcp", "/absolute/integration-lab/records"]
}

Windows에서는 calf.exe 절대 경로와 JSON의 이스케이프된 역슬래시를 사용합니다. 기록 위치는 하나로 맞춥니다. 호스트에 작업 접수·실행·취소·재시도·재검수·채택을 허용할 때만 args에 "--control"을 추가합니다. Adapter 등록은 로컬 API·SDK로 수행합니다.

고객 워크벤치를 직접 바인딩합니다.

MCP를 지원하는 워크벤치는 네이티브 descriptor를 사용합니다. 로컬 프로세스·API 확장이 가능한 워크벤치는 SDK를 사용합니다. 싱글 에이전트와 공유 기록 위치를 유지하며 별도 에이전트 스케줄러·벡터 DB·상주 모델은 필요하지 않습니다. 얇은 연결 계층은 화면과 ID를 다루고 판정은 각 네이티브 제품이 담당합니다.

Python · 채택 전 조회

import json
from pathlib import Path
from calf_sdk import CalfClient

# Run with the extracted CALF-SDK-0.2.6 on Python's module path.
client = CalfClient("/absolute/calf", "/absolute/records", timeout=35)
spec = json.loads(Path("work-spec.json").read_text(encoding="utf-8"))
accepted = client.work("submit", spec=spec)  # frozen; not executed
client.work("step", work=accepted["work"])
result = client.work("inspect", work=accepted["work"])
if result.get("verified") is True and result.get("outcome") == "SATISFIED":
    digest = result["manifest"]["digest"]
    print("Ready for explicit adoption:", accepted["work"], digest)
# After the user's explicit adoption action:
# client.work("adopt", work=accepted["work"], digest=digest)

Node.js · 같은 기록 조회

import {CalfClient} from './CALF-SDK-0.2.6/node/index.mjs';
const client = new CalfClient('/absolute/calf', '/absolute/records');
const result = await client.work('inspect', {work: 'work-<actual ID>'});
console.log(JSON.stringify({
  verified: result.verified,
  outcome: result.outcome,
  manifest: result.manifest,
  adopted: result.adopted,
  adoptedValid: result.adoptedValid
}, null, 2));
// A transport exception has unknown effects; do not auto-retry a mutation.

VibePackr 연결 바인딩

from calf_vibepackr import Connection

with Connection.from_config("/absolute/private/connection.json") as native:
    result = native.call("vibepackr.sdk.analyze", "analysis:stable-001",
                         {"input_id": "registered-input"})
    # Keep these separate in your application:
    transport = result["transport_status"]
    product = result["product_result"]
    reconciliation = result["reconciliation"]
    # Persist the complete result, including null and false values.
    # No automatic retry and no manufactured PASS/receipt.

다른 런타임은 등록된 argv 기반 Adapter에서 calf.runtime.v1을 구현합니다. 요청 파일 경로 하나를 받고 제한된 JSON 응답 하나를 반환합니다. 독립 검사가 수락 기준을 정의합니다. SDK에는 Python·Node·loopback HTTP 예제가 있으며 비동기 런타임은 제출 상태가 불확실할 때 원래 요청 ID를 조회해야 합니다.

검수된 보고서에서 실제 제품 Work로.

실습은 검수된 분석 보고서에서 끝납니다. 실제 VibePackr Work 실행에는 담당자가 지원되는 설치 연결·등록 런타임·정확한 계약 및 승인 경로를 제공해야 합니다. SDK가 만든 매핑 후보나 CALF에서 채택한 보고서가 이 조건을 대신하지 않습니다.

1. 실제 VibePackr 카탈로그를 탐색합니다. 업데이트 패키지는 수동 Work 단계를 제공할 수 있으며 이 문서가 이전 패키지에 도구를 추가하지는 않습니다.
2. 설치 패키지의 BOOTSTRAP.md·Work 가이드에서 입력 형식·런타임 바인딩·허용된 단계 진행을 확인합니다. 각 네이티브 reason·다음 동작을 보존합니다.
3. 고객 요청·CALF 작업 및 시도·VibePackr operation·원래 제품 Work reference를 연결합니다. 제품 영수증과 CALF 검사 영수증은 구분합니다.
4. 해당 네이티브 Work의 검증·복구 상태·필수 승인 및 영수증이 확인되어야 완료 처리합니다. 미확인·대기·거절 상태는 그대로 남깁니다.

다음 단계에서 막혔다면.

1. 네이티브 분석이 중단됐을 때

먼저 기존 capture 파일을 읽습니다. 아래 명령은 로컬 JSON만 표시하며 VibePackr를 호출하지 않습니다. 두 번째 명령은 error.json이 있을 때만 실행하며, 파일이 없다는 사실만으로 성공을 판단하지 않습니다. 설치 절과 동일한 터미널 변수를 사용합니다.

python3 -m json.tool "$LAB/capture-01/intent.json"
# Only if error.json exists:
python3 -m json.tool "$LAB/capture-01/error.json"

py -3 -m json.tool "$Lab\capture-01\intent.json"
# Only if error.json exists:
py -3 -m json.tool "$Lab\capture-01\error.json"

python3 -m json.tool "$LAB/capture-01/intent.json"
# Only if error.json exists:
python3 -m json.tool "$LAB/capture-01/error.json"

이 예제에는 범용 상태 조정 명령이 없습니다. 원래 operation ID·도구·입력 ID·보존 오류를 연결 담당자에게 전달합니다. 실제 제품 Work는 설치 카탈로그와 원래 product reference가 지원하는 조회만 사용합니다. 새 capture 폴더는 확인된 결과를 보관할 위치이며 재시도의 근거가 아닙니다.

2. CALF 보고서 작업이 접수된 뒤

run-01.jsonl 첫 줄의 accepted.work 또는 같은 기록 위치의 Workbench Runtime Work에서 기존 작업 ID를 찾습니다. 아래 WORK_ID를 바꾸세요. 실행 파일이 없거나 일부만 기록됐다면 먼저 기존 목록을 조회하며, 재제출하려고 파일을 삭제하지 않습니다.

python3 -B "$EXAMPLES/bind_report.py" --sdk "$SDK" \
  --calf "$CALF" --records "$CALF_WORK_HOME" inspect --work WORK_ID

py -3 -B "$Examples\bind_report.py" --sdk "$Sdk" `
  --calf "$Calf" --records "$env:CALF_WORK_HOME" inspect --work WORK_ID

python3 -B "$EXAMPLES/bind_report.py" --sdk "$SDK" \
  --calf "$CALF" --records "$CALF_WORK_HOME" inspect --work WORK_ID

조회는 보고서 Adapter를 다시 실행하지 않고 현재 기록·파일 신원을 확인합니다. 실행 중이거나 busy인 작업은 현재 상태가 확인될 때까지 미확정으로 둡니다. 증거가 오래됐으면 입력·Adapter·후보 변경 원인을 해결한 뒤 기존 작업에서 지원하는 Recheck를 사용하며 과거 통과 영수증으로 대신하지 않습니다. 현재 결과가 verified·SATISFIED이고 정확한 현재 해시가 일치할 때만 채택합니다. 이 보고서 계약은 시도 1회이며 무제한 재시도를 허용하지 않습니다.

버전·검증 범위·예제 파일.

2026년 11월 11일 macOS ARM64에서 배포된 Harness 1.8.13·SDK 0.2.6으로 클라이언트 호환성을 확인했습니다. 합성 분석 응답의 보고서가 7개 검사를 통과했고, Err 입력 거부·정확한 해시의 채택·Python·Node·읽기 전용 Work MCP 조회를 확인했습니다. 후보 변경 시 채택 이력을 유지하면서 UNKNOWN·adoptedValid=false를 반환했습니다. 새 VibePackr 네이티브 분석이나 AI·프로바이더 호출, 고객 어플라이언스 Work 실행을 한 시험은 아닙니다.

현재 CALF 코어와 SDK 배포판은 macOS ARM64·Windows x64·Linux x64에서 별도로 검증했습니다. 이것이 VibePackr 참조 연동까지 세 운영체제에서 검증됐다는 뜻은 아닙니다. 운영체제별 명령을 제공하므로 호환되는 네이티브 VibePackr 패키지로 실제 설치 환경을 확인하세요.

VibePackr는 제공된 MCP_SETUP.md·BOOTSTRAP.md·기존 CALF 로컬 Adapter 규약을 기준으로 작성했습니다. 고객 워크벤치를 연결하는 선택형 PoC 하위 매뉴얼입니다. 실제 고객 데이터·개인 연결 파일·비공개 코어 소스는 포함하지 않습니다.

과거 검증을 재현할 수 있도록 원래 예제 압축파일도 보존합니다. 이 안내에는 최신 버전별 예제를 사용하고 기존 예제 폴더에 합치지 마세요.이전 ZIP