SK-Intellix Source and Evidence Catalog
이 문서는 SK-Intellix 위키의 각 카테고리가 어떤 repository, source file, 설계 문서, test/evidence에 기대고 있는지 정리한다.
목적은 “문서가 잘 정리되어 있다”에서 끝내지 않고, 독자가 바로 다음 질문에 답할 수 있게 하는 것이다.
이 주장의 근거 source는 어디인가?
구현은 어느 repo에 있는가?
검증은 어떤 test 또는 artifact로 증명되는가?
아직 증거가 부족한 부분은 무엇인가?
1. 카테고리별 근거 요약
| 카테고리 | 대표 repo/source | 현재 evidence | 남은 공백 |
|---|---|---|---|
FRAMEWORK_SDK |
~/work/1.A1_SoC_new/SoC/a1-packages, <qssi-vendor-overlay>, <um-vendor-overlay>, Framework/SDK Hub |
A1 module inventory/service map, DeviceAgent Binder/API source, peer agent binding, QSSI/UM overlay, platform vendor HAL service source | 실제 SDK AAR skeleton, mock transport, sample app, Gradle test, 실기기 bind/HAL log |
A2A |
~/work/8.cloudLLM/backend-cloud-llm-lambda/gemini/a2a |
planner/runtime/tools source, dry-run/verifier tools, wiki build/lint | 최신 full benchmark artifact, 실기기 E2E |
REACTIVE_PROACTIVE |
lambda_function.py, src/objects.py, 관련 브랜치 proactive_planner의 gemini/a2a/proactive, gemini/a2a/runtime/proactive_* |
proactive request/feedback branch, proactive schema/assets, 관련 브랜치 source 확인 | proactive source 통합, fixture, false-positive benchmark, feedback writeback evidence |
ONDEVICE |
~/work/2.A1_LLM_Aent/skmagic_ondeviceai_agent |
bridge 설계 문서, bundle sample, ForegroundService.kt, DeviceCommunicator.kt |
실제 단말 callback/logcat evidence |
DEVICEAGENT |
~/work/1.A1_SoC_new/SoC/a1-packages/apps/DeviceAgent, SoC TaskManager Framework |
TaskManager source, unit/instrumented test source, 업체 구현용 framework 문서 | 업체 구현 diff, 실제 device task callback trace, MQTT/App/예약 ingress evidence |
COMETOME |
~/work/19.comToMe |
ComeToMe 설계 문서, speaker recognition scenario, diagram | 실제 comeToMe method/stage/reason 구현 |
MEMORY |
gemini/a2a/shared_context, gemini/a2a/runtime/memory_context.py |
shared_context source 확인 | migration, sync worker, privacy/delete E2E |
VENDOR |
wiki vendor package/checklist/templates | API acceptance/test evidence template | 업체 제출 산출물 수집 |
VALIDATION |
gemini/a2a/tools/*, DeviceAgent tests |
verifier/audit/logcat tools source | ADB 연결 후 artifact 수집 |
OPERATIONS |
~/.codex/AGENTS.md, ~/.bashrc, ~/.profile, llmwiki root |
전역 wiki root, env var, build/lint 검증 | 기존 Codex 창 재시작 여부 |
2. A2A Source Map
1.1 Framework / SDK Source Map
기준 repo:
/home/silogood/work/1.A1_SoC_new/SoC/a1-packages
현재 Framework/SDK 재구성 근거:
| 영역 | 파일 |
|---|---|
| A1 module inventory | docs/architecture/MODULE_INVENTORY.md |
| A1 service map | docs/architecture/SERVICE_MAP.md |
| TaskManager Framework SDK diagrams | docs/taskmanager-framework-sdk/diagrams/*.svg |
| QSSI package/overlay | ../<qssi-vendor-overlay>/vendor.mk, ../<qssi-vendor-overlay>/prebuilts/packages.mk |
| UM vendor overlay | ../<um-vendor-overlay>/vendor.mk, ../<um-vendor-overlay>/airbot/airbot.mk |
| QCS6490 split build | ../g13qcs6490/build_project.sh, ../sync_vendor_overlay.sh |
| Historical SDK proposal | docs/framework-sdk-transformation-2026-02-27/*, docs/framework-sdk-client-proposal-2026-06-17/* |
A1 DeviceAgent API/runtime으로 해석할 핵심 source:
| 영역 | 파일 |
|---|---|
| DeviceAgent Binder entry | apps/DeviceAgent/app/src/main/aidl/com/sk/airbot/devicecontrol/IDeviceControl.aidl |
| DeviceAgent service implementation | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/DeviceAgent.java |
| Main command routing | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/main/api/MainApi.java |
| Framework command bridge | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/framework/command/FrameworkCommandBridge.java |
| TaskManager runtime | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/TaskManager.java |
| Policy | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/policy/CmdPolicyManager.java, apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/framework/policy/PolicyEngine.java |
| State/Event | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/event/StateManager.java, apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/event/EventManager.java |
| Client Java API | apps/DeviceControlAPI/java/com/sk/airbot/devicecontrol/DeviceControlProxy.java |
| Peer agent binding | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/main/MainService.java, apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/device/item/amr/AMRService.java, apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/recognition/VisionAIManager.java |
| Peer agent manifests/AIDL | apps/AMRAgent/*, apps/IotAgent/*, apps/UpdateAgent/*, apps/PairingAgent/*, apps/VisionAgent/*, apps/LLMAgent/* |
| DeviceManager HAL | ../<qssi-vendor-overlay>/airbot/hardware/interfaces/device_manager/1.0/IDeviceManager.hal, ../<um-vendor-overlay>/airbot/external/device_manager/service |
| SoundFlow HAL | ../<qssi-vendor-overlay>/airbot/hardware/interfaces/soundflowservice/1.0/ISoundFlowService.hal, ../<um-vendor-overlay>/airbot/external/sndflow/service |
현재 판단:
a1-packages는 A1 DeviceAgent API/runtime source of truth다.- DeviceAgent는 Android OS
system_server가 아니지만 제품 기능 관점에서는 product-level SystemServer/service hub다. - DeviceAgent는 API gateway, command dispatcher, peer agent coordinator, policy/state/event owner, HAL bridge 역할을 동시에 수행한다.
- SDK는 구현 완료물이 아니라
DeviceControlAPIJavaLib와IDeviceControl위에 둘 수 있는 후보 artifact다. - 실제 SDK AAR skeleton과 mock transport는 아직 후속 구현 evidence가 필요하다.
2. A2A Source Map
기준 repo:
/home/silogood/work/8.cloudLLM/backend-cloud-llm-lambda
핵심 source:
| 영역 | 파일 |
|---|---|
| Planner API | gemini/a2a/planner/main_router_api.py |
| Planner prompt | gemini/a2a/planner/assets/main_router.system_prompt.txt |
| Planner schema | gemini/a2a/planner/assets/main_router.response_schema.json |
| Preclassifier | gemini/a2a/planner/preclassifier.py |
| Runtime orchestrator | gemini/a2a/runtime/orchestrator.py |
| Device task request 생성 | gemini/a2a/runtime/task_manager.py |
| Workflow event state | gemini/a2a/runtime/workflow_state.py |
| Device task mapper | gemini/a2a/runtime/device_task_mapper.py |
| Runtime contracts | gemini/a2a/runtime/contracts.py |
| Memory context | gemini/a2a/runtime/memory_context.py |
| Shared memory stores | gemini/a2a/shared_context/*.py |
| ODL bridge/contract | gemini/a2a/agents/odl/bridge_api.py, device_task_contract.py |
2.1 Reactive / Proactive Source Map
Reactive/proactive는 현재 브랜치별 source 상태를 분리해서 봐야 한다.
| 브랜치 | 확인된 상태 | 의미 |
|---|---|---|
feature_a2a_task_orchestration_cloud |
lambda_function.py, src/objects.py에 task_event, proactive, proactive_feedback request 분기가 있다. gemini/a2a/runtime/__init__.py에는 proactive runtime import fallback이 있다. |
Lambda entrypoint는 proactive를 받을 준비가 일부 되어 있다. |
feature_a2a_task_orchestration_cloud |
gemini/a2a/proactive, gemini/a2a/agents/proactive, gemini/a2a/runtime/proactive_orchestrator.py, proactive_feedback_handler.py 원본 source는 현재 브랜치에 없고 __pycache__ 흔적만 확인된다. |
현재 브랜치만으로는 proactive runtime을 제품 기능으로 판정하면 안 된다. |
proactive_planner |
proactive domain, mini planner, trigger gate, arbiter, dispatch composer, feedback handler, schema, tests가 존재한다. | proactive 구현의 실제 source of truth 후보이며 현재 작업 브랜치로 통합 대조가 필요하다. |
| 영역 | 파일 |
|---|---|
| Lambda request 분기 | lambda_function.py |
| Reactive voice request object | src/objects.py / CloudLLMRequest |
| Proactive signal request object | src/objects.py / ProactiveSignalRequest |
| Proactive feedback request object | src/objects.py / ProactiveFeedbackRequest |
| Proactive runtime entry | gemini/a2a/runtime/proactive_orchestrator.py |
| Proactive feedback handler | gemini/a2a/runtime/proactive_feedback_handler.py |
| Proactive agent wrapper | gemini/a2a/agents/proactive/ |
| Proactive domain | gemini/a2a/proactive/ |
| Proactive assets/schema | gemini/a2a/proactive/assets/ |
| Proactive risk/capability policy | gemini/a2a/registry/proactive_capability_policy.json |
| 관련 브랜치 | proactive_planner |
Proactive source를 현재 제품 브랜치에 반영할 때 최소 대조해야 하는 파일 묶음:
| 묶음 | 파일 | 대조 포인트 |
|---|---|---|
| Lambda entry | lambda_function.py, src/objects.py |
request_kind=proactive, signal_bundle, proactive_feedback 감지와 runtime 호출이 맞는지 확인 |
| Runtime | gemini/a2a/runtime/proactive_orchestrator.py, proactive_feedback_handler.py, runtime/__init__.py |
import fallback 없이 실제 handler가 로드되는지 확인 |
| Domain | gemini/a2a/proactive/*.py |
candidate/gate/planner/arbiter/dispatch 책임이 분리되어 있는지 확인 |
| Agent wrapper | gemini/a2a/agents/proactive/planner_api.py |
mini proactive planner prompt/schema 호출 경로 확인 |
| Assets/schema | gemini/a2a/proactive/assets/**/*.json, *.txt |
request/response/feedback/dispatch/shared_context schema가 Lambda payload와 일치하는지 확인 |
| Policy | gemini/a2a/registry/proactive_capability_policy.json |
family별 auto execute, confirmation, recommendation policy 확인 |
| Tests | test/test_proactive_*, test/test_lambda_proactive_handler.py, shared context tests |
false proactive, feedback, arbiter, Lambda branch 회귀 검증 |
검증/도구:
| 목적 | 파일 |
|---|---|
| device task dry-run | gemini/a2a/tools/device_task_dry_run.py |
| task event contract 검증 | gemini/a2a/tools/task_event_contract_verifier.py |
| E2E readiness | gemini/a2a/tools/device_e2e_readiness.py |
| E2E runner | gemini/a2a/tools/device_e2e_runner.py |
| artifact validator | gemini/a2a/tools/device_e2e_artifact_validator.py |
| logcat evidence | gemini/a2a/tools/device_logcat_evidence.py |
| task event simulator | gemini/a2a/tools/task_event_simulator.py |
3. On-device Bridge Source Map
기준 repo:
/home/silogood/work/2.A1_LLM_Aent/skmagic_ondeviceai_agent
현재 직접 확인된 source:
| 영역 | 파일 |
|---|---|
| Foreground service | app/src/main/java/com/skmagic/ondeviceai/agent/service/ForegroundService.kt |
| Device communication | app/src/main/java/com/skmagic/ondeviceai/agent/service/DeviceCommunicator.kt |
| API device communication | app/src/main/java/com/skmagic/ondeviceai/agent/service/api/DeviceCommunicator.kt |
설계/계약 근거:
docs/strategy/short-term/a2a-device-task-bridge-2026-06-18/
주요 문서:
| 문서 | 의미 |
|---|---|
README.md |
Cloud -> bridge -> DeviceAgent 전체 연결 개요 |
INTEGRATION_CHECKLIST.md |
연동 체크리스트 |
SAMPLE_BUNDLES.md |
submitTask, submitWorkflow, onTaskEvent bundle sample |
TASK_EVENT_REASON_CODE_SPEC.md |
task event와 reason code 규약 |
VENDOR_DEVICEAGENT_TASKMANAGER_SPEC.md |
업체 전달용 DeviceAgent TaskManager spec |
device-task-bridge-architecture.svg |
bridge 구조도 |
01-responsibility-boundary.svg |
Cloud/Bridge/DeviceAgent 책임 경계 |
02-api-sequence-and-bundles.svg |
API sequence와 bundle |
04-task-event-replan-gate.svg |
event/replan gate |
주의:
- 기존 wiki 일부에는
CloudIntentWorkflowRunner.kt,DeviceIntentExecutor.kt,DeviceCommandSink.kt,CloudDeviceTaskRequests.kt,ManagedDeviceTask.kt같은 후보 파일명이 언급되어 있다. - 현재 확인 명령 기준으로는 위 파일들이 직접 발견되지 않았다.
- 따라서 이 파일들은 “구현 후보/문서상 개념”으로 보되, 실제 source 근거는 위 확인된 파일과 strategy docs를 기준으로 삼는다.
4. DeviceAgent / SoC Source Map
기준 repo:
/home/silogood/work/1.A1_SoC_new/SoC/a1-packages
핵심 source:
| 영역 | 파일 |
|---|---|
| API gateway | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/main/api/MainApi.java |
| TaskManager | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/TaskManager.java |
| Event listener | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/TaskEventListener.java |
| Reason contract | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/TaskReasonContract.java |
| Planning context | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/DevicePlanningContextProvider.java |
| Ingress classifier | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/TaskIngressClassifier.java |
| Bundle validation | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/TaskBundleValidator.java |
| Policy registry | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/TaskPolicyRegistry.java |
| Executor registry | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/TaskExecutorRegistry.java |
| Movement executor | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/MovementTaskExecutor.java |
| Cleaning executor | apps/DeviceAgent/app/src/main/java/com/sk/airbot/deviceagent/task/CleaningAmpTaskExecutor.java |
테스트 source:
| 테스트 | 파일 |
|---|---|
| Unit | apps/DeviceAgent/app/src/test/java/com/sk/airbot/deviceagent/task/TaskManagerTest.java |
| Integration | apps/DeviceAgent/app/src/test/java/com/sk/airbot/deviceagent/task/TaskManagerIntegrationTest.java |
| Instrumented | apps/DeviceAgent/app/src/androidTest/java/com/sk/airbot/deviceagent/task/TaskManagerInstrumentedTest.java |
5. 19.comToMe Source Map
기준 repo:
/home/silogood/work/19.comToMe
근거 문서:
| 영역 | 파일 |
|---|---|
| System design | docs/strategy/short-term/com-to-me-system-design.md |
| Speaker recognition scenario | docs/strategy/short-term/com-to-me-speaker-recognition-service-scenario.md |
| Flow diagram | docs/diagrams/com-to-me-flow.mmd |
| Speaker recognition SVG | docs/diagrams/com-to-me-speaker-recognition-service.svg |
현재 상태:
- ComeToMe는 A2A 복합명령/DeviceAgent TaskManager 관점에서 중요한 예시다.
- 단, 실제
comeToMeTaskManager method, stage gate, reason payload는 업체/DeviceAgent 구현에서 확정되어야 한다.
6. Memory / Personalization Source Map
현재 확인된 Cloud source:
gemini/a2a/runtime/memory_context.py
gemini/a2a/shared_context/context_retriever.py
gemini/a2a/shared_context/short_term_store.py
gemini/a2a/shared_context/mid_term_pattern_store.py
gemini/a2a/shared_context/long_term_profile_store.py
gemini/a2a/shared_context/memory_promotion_gate.py
gemini/a2a/shared_context/preference_policy_store.py
현재 브랜치에서 직접 확인된 runtime 동작:
| 파일 | 확인 내용 |
|---|---|
gemini/a2a/runtime/memory_context.py |
normalize_memory_context, hydrate_memory_context, build_memory_update 구현 |
gemini/a2a/runtime/orchestrator.py |
turn 시작 시 hydrate_memory_context 호출, orchestration 응답에 memory_update 포함 |
gemini/a2a/planner/main_router_api.py |
planner input에 memory_context 전달 |
test/test_memory_context.py |
a2a-memory-context-v1, recent pair/daily summary/profile item limit, runtime 전달 검증 |
현재 구현과 설계의 차이:
| 항목 | 현재 구현 | 후속 필요 |
|---|---|---|
| Planner-safe memory context | 있음 | JSON schema와 더 많은 fixture |
| Runtime write candidate | 있음 | repository write 연결 |
| Pair/session DB | 설계 문서 수준 | migration/repository/test |
| Day/week summary | 설계 문서 수준 | summarizer worker/test |
| Long-term profile candidate | 구조 후보만 있음 | extractor/promotion gate |
| Sync cursor | field 수준 | duplicate/conflict/retry 구현 |
| Privacy/delete | 설계 문서 수준 | retention/delete/audit E2E |
남은 구현/evidence:
| 항목 | 필요한 증거 |
|---|---|
| DB schema | migration 파일, schema test |
| Sync cursor | Cloud/On-device sync fixture |
| 삭제 정책 | delete request -> local/cloud 삭제 trace |
| long-term promotion | candidate -> confirmed 정책 test |
| privacy | 민감정보 필터/보존기간 검증 |
7. Evidence Gate
| Gate | 의미 | 현재 상태 |
|---|---|---|
| G1 문서 연결 | 카테고리와 문서 링크가 연결됨 | 충족 |
| G2 source 연결 | repo/file 근거가 연결됨 | 대부분 충족 |
| G3 static 검증 | llmwiki build/lint 통과 |
충족 |
| G4 책자형 1차 컷 | 전체 장/카테고리/연결/후속 공백이 분리됨 | Book First-Cut Gate 기준 충족 |
| G5 dry-run/unit | Cloud/DeviceAgent test source와 일부 도구 존재 | 부분 충족 |
| G6 on-device 통합 | bridge -> DeviceAgent callback trace | 미충족 |
| G7 실기기 | ADB/logcat artifact | 미충족 |
| G8 업체 evidence | 업체 제출 산출물 | 미충족 |