From 96e7f5ade994ffe828c9655ea4e0f8f5d8cc0c81 Mon Sep 17 00:00:00 2001 From: refinvest-contract-bot Date: Sat, 14 Nov 2026 14:17:46 +0000 Subject: [PATCH] chore(contract): sync Context 4686b2f1efc9 --- docs/AI_AGENT.md | 5 + docs/ARCHITECTURE.md | 5 + docs/DECISIONS.md | 8 ++ ...VIEW_REPROCESSING_CONSUMER_REVIEW_DRAFT.md | 8 ++ ...EVIEW_REPROCESSING_RECEIPT_POLICY_DRAFT.md | 8 ++ ...EW_REPROCESSING_SOURCE_PIN_POLICY_DRAFT.md | 115 ++++++++++++++++++ ...VIEW_WORKFLOW_CONTRACT_ACCEPTANCE_DRAFT.md | 8 ++ docs/TRADING_REVIEW_WORKFLOW_DTO_DRAFT.md | 8 ++ openapi/CONTEXT_REVISION | 2 +- 9 files changed, 166 insertions(+), 1 deletion(-) create mode 100644 docs/TRADING_REVIEW_REPROCESSING_SOURCE_PIN_POLICY_DRAFT.md diff --git a/docs/AI_AGENT.md b/docs/AI_AGENT.md index 621df2d..70d5839 100644 --- a/docs/AI_AGENT.md +++ b/docs/AI_AGENT.md @@ -124,3 +124,8 @@ Config 적용/default·기존 재처리 key 이력 유무를 명확히 한 채 후속 [③ 원 admission receipt 후보](docs/TRADING_REVIEW_REPROCESSING_RECEIPT_POLICY_DRAFT.md)는 최초 decision과 현재 Run/trace· key별 수렴 audit·기록410/422·UNKNOWN 원 fence·TTL/삭제 보존 경계를 구분한다. ①~③은 계속 미채택이다. 후속은 정확 채택 범위 확인과 ④ 불명 source pin 거절/기록 논의이며 schema/hash·보관 예외·업무 구현 전환이 아니다. + + +후속 [④ 정상 legacy source pin 후보](docs/TRADING_REVIEW_REPROCESSING_SOURCE_PIN_POLICY_DRAFT.md)는 기술 장애/손상·원 receipt 불명과 +정상 형식의 한계를 구분한다. 지원 source 제한·versioned No-Run 거절은 미채택 권장안이며 현재422/Run·hash/schema를 수정하지 않는다. +①~④의 통합 채택/보류/수정 결정과 variant/consumer·수명/삭제·실행 증적·업무 구현 전환은 별도다. diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index dcc74c6..b72831a 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -246,3 +246,8 @@ Config 적용/default·기존 재처리 key 이력 유무를 명확히 한 채 후속 [③ 원 admission receipt 후보](TRADING_REVIEW_REPROCESSING_RECEIPT_POLICY_DRAFT.md)는 최초 decision과 현재 Run/trace· key별 수렴 audit·기록410/422·UNKNOWN 원 fence·TTL/삭제 보존 경계를 구분한다. ①~③은 계속 미채택이다. 후속은 정확 채택 범위 확인과 ④ 불명 source pin 거절/기록 논의이며 schema/hash·보관 예외·업무 구현 전환이 아니다. + + +후속 [④ 정상 legacy source pin 후보](TRADING_REVIEW_REPROCESSING_SOURCE_PIN_POLICY_DRAFT.md)는 기술 장애/손상·원 receipt 불명과 +정상 형식의 한계를 구분한다. 지원 source 제한·versioned No-Run 거절은 미채택 권장안이며 현재422/Run·hash/schema를 수정하지 않는다. +①~④의 통합 채택/보류/수정 결정과 variant/consumer·수명/삭제·실행 증적·업무 구현 전환은 별도다. diff --git a/docs/DECISIONS.md b/docs/DECISIONS.md index 860a332..d3d5c7e 100644 --- a/docs/DECISIONS.md +++ b/docs/DECISIONS.md @@ -1501,3 +1501,11 @@ HTTP projection을 구분한다. 원202 뒤 실행FAILED를422로 바꾸지 않 다른 key의 수렴은 request별 binding/reason/시각·receipt를 구분하고 동일FAILED의 검증된 원 admission 종류 계승을 제안한다. 원 Tx/commit 확인·UNKNOWN 원 fence 복구·최소24h와 logical mapping/삭제 보존 경계를 명시한다. 무기한 body/새TTL 보관은 채택하지 않는다. ①~③·ADR-079는 미채택이다. schema/hash/vector/namespace·Compute/runtime을 수정하거나 No-Run/새422·구현 전환을 승인하지 않는다. + + +**순차 논의 ④ 후보**: [정상 legacy source pin 부족](TRADING_REVIEW_REPROCESSING_SOURCE_PIN_POLICY_DRAFT.md)을 +일시 장애·저장 손상·원 receipt/commit UNKNOWN과 구분했다. 지원 source 제한과 별도 versioned No-Run 영속 거절을 우선 제안한다. +현재422의 recorded FAILED Run 참조를 생략하거나 fake pin/logical key·최신 default·불변 source rewrite·영구503으로 우회하지 않는다. +Run 없는 원 request/거절 evidence·현재 Guard·같은 key 원 decision/UNKNOWN 복구·복구 후 새 key와 receipt 수명/삭제 조건을 정리했다. +정확 variant/code/schema·consumer/retention·복구/운영 수용은 미정이다. ①~④·ADR-079는 미채택이며 YAML/hash/vector/SQL/runtime을 변경하지 않는다. +후속은 채택/보류/수정 범위의 통합 결정표와 versioned 계약/전파 계획이며 업무 구현 전환은 별도다. diff --git a/docs/TRADING_REVIEW_REPROCESSING_CONSUMER_REVIEW_DRAFT.md b/docs/TRADING_REVIEW_REPROCESSING_CONSUMER_REVIEW_DRAFT.md index 606dc28..19ac427 100644 --- a/docs/TRADING_REVIEW_REPROCESSING_CONSUMER_REVIEW_DRAFT.md +++ b/docs/TRADING_REVIEW_REPROCESSING_CONSUMER_REVIEW_DRAFT.md @@ -156,3 +156,11 @@ Reprocessing snapshot 누락으로 exit1이었다. snapshot 적용·새 E2E는 이 새 문서도 Context merge 뒤 자동 snapshot PR의 최신 source SHA·변경 범위를 확인한다. 열린 PR이 최신 Context로 갱신될 수 있다. snapshot apply/merge·E2E를 대신 수행하지 않는다. E2E 전 sync, Web 포함 시 -IncludeWeb을 요구한다. 이번은 Markdown/source 리뷰다. source inventory·본문/링크 검사는 schema consumer round-trip·hash vector·HTTP/JWT·DB/장애·운영 수용 검증이 아니다. + + +## WCR-R03 후속 — 불명 pin의 versioned 거절 후보 + +[④ source pin 후보](TRADING_REVIEW_REPROCESSING_SOURCE_PIN_POLICY_DRAFT.md)는 위 계약 공백을 source/type/profile별 지원 제한과 +versioned No-Run 영속 거절로 다루는 우선안을 제시한다. 현재422의 Run 참조를 빼는 fallback이 아니며 schema/code를 아직 정하지 않는다. +정상 legacy 형식의 한계·일시 장애·저장 손상·원 receipt UNKNOWN을 구분하고 fake pin/원 source rewrite·무한503을 허용하지 않는다. +복구 후 새 key의 정상 admission과 원 거절 replay·현재 Guard/수명/삭제·legacy/consumer gate는 별도로 검증해야 한다. ①~④는 미채택이다. diff --git a/docs/TRADING_REVIEW_REPROCESSING_RECEIPT_POLICY_DRAFT.md b/docs/TRADING_REVIEW_REPROCESSING_RECEIPT_POLICY_DRAFT.md index 6ce623a..1135a80 100644 --- a/docs/TRADING_REVIEW_REPROCESSING_RECEIPT_POLICY_DRAFT.md +++ b/docs/TRADING_REVIEW_REPROCESSING_RECEIPT_POLICY_DRAFT.md @@ -122,3 +122,11 @@ receipt·audit의 구체 보관 범위/삭제 후 최소 marker·멤버/Book pur 새 schema·error literal·receipt digest/vector·SQL/HTTP/Worker 구현이나 semantic 실행 증거는 추가하지 않았다. ①~③의 정확 채택 범위를 확인하고 다음은 ④ 정상 legacy source의 pin 불명 처리와 안전한 거절/기록 계약을 논의한다. + + +## 후속 ④ 정상 legacy source pin 부족 + +[④ 후보](TRADING_REVIEW_REPROCESSING_SOURCE_PIN_POLICY_DRAFT.md)는 정상 source의 필요한 pin 부족과 기술 장애/손상·원 receipt 불명을 분리한다. +지원 source 제한과 versioned No-Run 영속 거절을 우선 검토하되 현재422·Run 모델을 바꾸지 않는다. +이 경우의 request binding/거절 evidence는 실행 가능한 logical key/pin이 아니며, Run 없는 receipt의 수명/삭제는 별도 조건이다. +원202/기록실패·UNKNOWN을 새 No-Run 거절에 재결속하지 않는다. ①~④는 미채택이며 정확 variant/code·consumer·retention은 후속이다. diff --git a/docs/TRADING_REVIEW_REPROCESSING_SOURCE_PIN_POLICY_DRAFT.md b/docs/TRADING_REVIEW_REPROCESSING_SOURCE_PIN_POLICY_DRAFT.md new file mode 100644 index 0000000..520440f --- /dev/null +++ b/docs/TRADING_REVIEW_REPROCESSING_SOURCE_PIN_POLICY_DRAFT.md @@ -0,0 +1,115 @@ +# Reprocessing 불명 source pin 처리 논의안 (DRAFT) + +상태: **순차 논의 ④ 권장 후보·미채택**, 2026-11-14. [① identity/hash](TRADING_REVIEW_REPROCESSING_IDENTITY_POLICY_DRAFT.md)· +[② binding](TRADING_REVIEW_REPROCESSING_BINDING_POLICY_DRAFT.md)·[③ receipt](TRADING_REVIEW_REPROCESSING_RECEIPT_POLICY_DRAFT.md)를 잇는다. +①~④·ADR-079/WP01~04는 계속 미채택이다. 기존 wire/422·hash/vector·Compute·DB/runtime은 변경하지 않는다. +이번은 분류·대안·활성화 조건이며 정상 source를 실제 조사하거나 새 No-Run 응답을 구현한 결과가 아니다. + +## 고정 source와 계약 공백 + +| Source | 현재 의미/공백 | +|---|---| +| [Consumer WCR-R03](https://github.com/refinvest-dev/context/blob/3a8a7dd5c5f95f2a9d088c8f303d4a2744e29450/docs/TRADING_REVIEW_REPROCESSING_CONSUMER_REVIEW_DRAFT.md) | 정상 legacy 형식의 pin 부족·일시 장애·손상을 구분. fake pin/미기록422 fallback 금지 | +| [WP02](https://github.com/refinvest-dev/context/blob/3a8a7dd5c5f95f2a9d088c8f303d4a2744e29450/docs/TRADING_REVIEW_WORKFLOW_CONTRACT_DRAFT.md) | 접근 가능한 source/target identity를 확정한 business failure만 FAILED Run·receipt 원자 기록 | +| [OpenAPI 후보](https://github.com/refinvest-dev/context/blob/3a8a7dd5c5f95f2a9d088c8f303d4a2744e29450/docs/TRADING_REVIEW_REPROCESSING_OPENAPI_DRAFT.md)·[DTO](https://github.com/refinvest-dev/context/blob/3a8a7dd5c5f95f2a9d088c8f303d4a2744e29450/docs/TRADING_REVIEW_WORKFLOW_DTO_DRAFT.md) | 접수422는 recorded FAILED Run 참조 필수. source/version/lineage를 모르는 Run은 완성할 수 없음 | +| [③ receipt](https://github.com/refinvest-dev/context/blob/3a8a7dd5c5f95f2a9d088c8f303d4a2744e29450/docs/TRADING_REVIEW_REPROCESSING_RECEIPT_POLICY_DRAFT.md) | 원 decision·현재 View/Guard·UNKNOWN 복구. 원 receipt 불명과 정상 source pin 부족은 별도 | +| [Versioning](https://github.com/refinvest-dev/context/blob/3a8a7dd5c5f95f2a9d088c8f303d4a2744e29450/docs/TRADING_VERSIONING.md)·[Lifecycle](https://github.com/refinvest-dev/context/blob/3a8a7dd5c5f95f2a9d088c8f303d4a2744e29450/docs/TRADING_DATA_LIFECYCLE.md) | immutable source/lineage·exact compatibility·삭제 우선. 새로운 조회/재처리가 raw TTL·삭제를 되돌리지 않음 | +| [Go admission](https://github.com/refinvest-dev/trading-review-api/blob/5146bded06b0be2314d278a8e70a60f020ef8289/docs/design/workflow-reprocessing-storage/admission-and-identities.md) | 원 receipt/Run·same actual Tx·pin 불명 시 임의 hash/default 금지 | + +정상 legacy source는 **당시 계약에서는 유효하게 보존됐지만 요청한 재처리에 필요한 pin을 표현하지 못하는 자료**다. +그 source의 정상 조회/보존이 가능하다는 사실과 특정 재처리 type/profile 지원은 다르다. +nullable가 '없음'을 의미하는 합법적인 optional 값까지 pin 부족으로 분류하지 않는다. exact source/result/version/hash/lineage 등 필요한 사실은 type/지원 profile별로 확인한다. + +## 먼저 구분할 원인 + +| 확인된 사실 | 처리 경계 | +|---|---| +| malformed request·미검증 caller·foreign/현재 접근 거절 | 기존 입력/인증/존재 숨김. pin 진단을 노출하지 않음; 새 Run 없음 | +| DB/registry/remote 일시 장애로 확인하지 못함 | 기술 오류/유한 재시도·복구. legacy 불가로 확정하지 않음 | +| 저장 decoding/무결성 불일치·원 필수 pin 손상 | 저장 이상/운영 복구. 정상 legacy 부족·사용자422로 숨기지 않음 | +| 정상 legacy 형식이 필요한 pin을 표현하지 못함 | 지원 source/profile 문제. 가짜 pin/무한503/Commit UNKNOWN으로 분류하지 않음 | +| 원 authoritative evidence로 lossless pin 확인 가능 | 지원 profile/근거·현재 Guard 아래 확정 가능 여부 검증. 최신 값 추론과 구분 | +| full pin은 확정됐고 raw 부재·확정 compatibility 실패 | 기존 WP02의 기록 FAILED Run·원410/422 후보를 검토. pin 부족의 No-Run 경로와 구분 | +| known key의 commit/원 receipt가 불명 | ③의 원 namespace/fence/effect 복구. 새 pin 부족 rejection으로 mapping을 덮지 않음 | + +현재 source version이 오래됐다는 이유만으로 손상이라고 하지 않는다. 반대로 hash 검증 실패/불일치 증거가 있는데 legacy 정상성으로 덮지 않는다. +행/객체가 없다는 조회 결과 하나는 정상 legacy 형식·실제 삭제 완료·접수 부재의 충분한 증거가 아니다. + +## 권장안과 대안 + +| 선택 | 장점/비용 | 이번 권고 | +|---|---|---| +| 검증 가능한 source/type/profile만 활성화 | 불변식과 기존 Run 모델 유지 / 제외 source에 대한 안전한 거절 계약도 필요 | **지원 범위의 기본 전제**로 권고. endpoint에서 schema-valid 제외 source가 들어오는 경우를 무시하지 않음 | +| versioned No-Run 영속 거절 | 불명 pin을 만들지 않고 같은 key의 원 거절을 재현 / receipt·응답·consumer·retention 계약 보강 필요 | **정상 pin 부족의 우선 후보**. 기존422에 몰래 적용하지 않음 | +| 원 evidence에 근거한 별도 복구/이관 | 일부 source를 지원 가능 / provenance·불변 source·검증·운영 비용 | 검증 가능한 경우만 조건부. request/GET에서 자동 repair하지 않음 | +| partial/unknown pin의 FAILED Run 허용 | 기존 Run 조회 경로를 사용 가능 / Run·logical key·lineage·모든 consumer 불변식 변경 | 우선 채택하지 않음. unknown을0/null로 채우는 우회 금지 | + +권고는 지원 source 제한과 별도 거절 계약을 함께 설계하는 것이다. UI에서 source를 감췄다는 이유로 서버의 거절 경계가 해결되지는 않는다. +새 계약/consumer가 준비되지 않은 source/profile은 admission을 활성화하지 않는다. 현재 후보의422를400/404/410으로 임의 치환하거나503으로 영구 반복하지 않는다. +이 문서는 기존 endpoint에 사용할 임시 fallback status/code를 정하지 않는다. 활성화 전에 정상 pin 부족의 명시적인 거절 계약을 채택해야 한다. + +## versioned No-Run 거절의 후보 범위 + +현재 access가 승인됐고 schema-valid 요청이며 정상 legacy 형식의 한계를 확정한 경우에 한한다. +영속화할 수 있는 것은 **원 request의 의미와 실행 전 거절 decision**이며, 존재하지 않는 Run/실행 pin을 만든 기록이 아니다. + +| 후보에 필요한 사실 | 보존/제한 | +|---|---| +| 원 public namespace·원 request/contract profile | 기존 owner+operation+key 유지. profile/Book을 namespace에 추가해 기존 key 충돌을 회피하지 않음 | +| source pointer·요청 type/outputs/publish·reason·명시 입력 의미 | 검증한 request 의미만 lossless 보존. body 전체/credential/raw row를 저장하라는 뜻이 아님 | +| 확인된 source/profile evidence·필요 pin을 확정할 수 없다는 근거 | 확인한 사실과 미확인 부분을 구분. fake source hash/version/lineage나 logical key를 만들지 않음 | +| 안전한 원 거절 의미·decision 시각·profile | 같은 key의 의미 비교·원 decision 복구. 현재 authority/trace/허용 detail은 별도 | +| Run/Dispatch·Compute/child | 생성하지 않음. Run ID0/null을 기존 RecordedFailure의 유효 참조로 보내지 않음 | + +논리 family를 확정할 수 없으므로 **완전한 execution binding/logical key가 존재한다고 요구하지 않는다**. +same-key 비교는 원 profile의 request binding과 확인된 사실/거절 근거로 수행하고, 이것을 실행 가능한 계산 identity로 승격하지 않는다. +request 대상 Target/Config도 실제 검증한 범위를 보존한다. registry 장애로 검증하지 못한 것을 'legacy pin 부족'으로 확정하는 경로는 없다. +필요 사실을 왜 확정할 수 없는지조차 알 수 없으면 이 영속 거절을 임의 기록하지 않고 원인별 복구/정책 판정을 따른다. + +응답은 safe business 거절로 표현하며 **422 계열의 versioned 별도 variant**를 우선 검토한다. +정확 code literal·schema/required/nullable·공개 receipt ID 여부·profile 이름은 아직 정하지 않았다. Run 연결은 제공하지 않는 안이다. +이 variant는 현재422의 recorded Run 필수 조건을 의도적으로 변경하는 계약 후보다. 기존 YAML의 Run ID 필드를 생략하는 것으로 구현할 수 없다. +기존 pin 확정 business 실패는 WP02 RecordedFailure 경로를 유지하며 모든422를 No-Run으로 바꾸지 않는다. +일시 장애/손상/권한 오류를 이 거절로 바꾸거나 safe detail에 내부 locator·미확인 source 내용을 넣지 않는다. + +## key·replay·재접수 + +- 기존 key의 원 receipt/commit을 먼저 복구한다. 원202/기록410/422를 현재 pin 부족을 이유로 새 거절에 재결속하지 않는다. +- 신규 No-Run decision을 기록한다면 request fence·현재 Member/owner/Guard·원 의미 비교와 decision/mapping은 같은 짧은 실제 Tx에서 확정한다. +- callback 임시 결과만으로 거절을 응답하지 않는다. commit UNKNOWN이면 원 key/fence로 복구하며 새 key/Run으로 덮지 않는다. +- 같은 key·같은 요청은 현재 접근 승인 뒤 원 거절 의미를 replay한다. source evidence가 나중에 확보돼도 자동 실행으로 바꾸지 않는다. +- 같은 key·다른 source/의도/profile 의미는 ②의 conflict 검토를 따른다. profile 변경은 namespace 분리·새 의미 덮어쓰기를 허용하지 않는다. +- 별도로 승인된 복구 후 실행을 요청하려면 새 key의 정상 admission을 검증한다. No-Run decision은 FAILED Run이 아니므로 retry parent로 쓰지 않는다. +- 새 key가 실행 가능해져 logical key를 확정했다면 기존 logical active/success·exact execution 관계도 검증한다. 과거 No-Run의 무효 hash 공간을 만들지 않는다. + +같은 legacy source에 새 key를 반복해도 부족한 pin이 생기거나 Compute 호출·retry attempt가 만들어지지는 않는다. +동일 Run 없는 요청들을 content hash로 합쳐 가상의 logical family를 만들 필요도 없다. 요청별 decision 보존과 자원/abuse budget은 별도 검토한다. +replay는 현재 Guard가 우선이다. raw-only·Book 삭제/Member 차단과 거절 receipt의 조회 권한/보존을 혼합하지 않는다. +③의 최소24h/삭제/backup·legacy 이력 규칙은 참고하되 **Run이 없는 receipt의 정확 수명/최소 marker는 별도 채택 조건**이다. +기존 'Aggregate가 남는 동안 logical mapping 보존' 규칙을 존재하지 않는 Run의 무기한 보존 근거로 적용하지 않는다. + +## lossless 확인·복구 경계 + +당시 profile과 immutable descriptor·manifest·source evidence·원 receipt가 필요한 사실을 lossless하게 증명할 때만 pin 확인을 검토한다. +현재 registry의 최신 version/default·sourceAnalysis의 최신 결과·0/빈 lineage로 채우거나 하위 hash를 부모 hash로 바꾸지 않는다. +source/profile마다 복구 가능한 field와 근거를 검증한다. 일부 hash 하나가 맞는다는 이유로 전체 provenance/tuple을 확정하지 않는다. +원 source를 수정해야 하는 이관은 별도의 명시 정책/검증 대상이다. immutable Revision을 제자리 수정하거나 synthetic Session/Run을 만들지 않는다. +삭제된 raw/backup 복원·TTL 연장·권한 재발급으로 pin을 채우는 우회는 없다. 새 upload/새 source는 별도 lineage다. +request Tx 안의 Compute/Storage I/O·자동 repair·status GET의 mutation은 금지한다. 외부 준비/검증과 짧은 원자 DB decision을 구분한다. +worker의 장기 준비·발행 시 pin/Generation/현재 권위를 다시 검증하는 기존 책임을 이 admission 분류로 대체하지 않는다. + +## 채택/활성화 전 조건과 검토 사례 + +이 후보는 기존 WR-G01/02/07/08·WR-DRAFT-01~14·WUC-05/WFP-P03/P11/P12에 연결한다. 새 수용 ID/실행 결과는 추가하지 않는다. + +1. source/type/profile별 필수 pin과 정상 legacy 한계·손상·일시 장애·원 receipt 불명을 실제 이력/consumer와 대조한다. +2. 같은 schema-valid 정상 pin 부족에서 가짜 Run/Compute 없이 안전한 versioned 거절을 commit/replay하고, 기존422 RecordedFailure와 구분한다. +3. 현재 Guard·다른 owner·raw-only/Book 삭제에서 존재/diagnostic 비노출과 정상 retained resource 보존을 검증한다. +4. 같은 key의 원202/기록실패/No-Run 거절 불변·different binding conflict·복구 후 새 key/정상 logical 수렴을 검증한다. +5. commit 실패/UNKNOWN·동시 요청·key 보관 경과/삭제/backup에서 decision 원자성·원 fence 복구·미확인 miss 비추정을 검증한다. +6. 손실 없는 evidence 확인은 현재 default/자동 repair와 구분하며 immutable 원 ID/hash/createdAt·삭제/TTL·lineage를 보존한다. + +정확 No-Run variant/거절 code·원 request comparison evidence·receipt 수명/삭제·legacy mapping·Core/Web 소비자·설정/운영 수용이 남아 있다. +이번은 **계약 후보 문서화**다. active/draft OpenAPI·정적 예제/검사기·hash/vector·SQL·Go/Python/HTTP/Worker는 수정하지 않았고 semantic 사례도 미실행이다. +후속은 ①~④의 채택/보류/수정 범위를 한 번에 정리한 결정표와 필요한 versioned schema/consumer 전파 계획이다. +일반적인 다음 작업이나 문서 merge/CI를 정책 동의·gate 완료·업무 구현 전환으로 확대하지 않는다. diff --git a/docs/TRADING_REVIEW_WORKFLOW_CONTRACT_ACCEPTANCE_DRAFT.md b/docs/TRADING_REVIEW_WORKFLOW_CONTRACT_ACCEPTANCE_DRAFT.md index 1772d71..58ef545 100644 --- a/docs/TRADING_REVIEW_WORKFLOW_CONTRACT_ACCEPTANCE_DRAFT.md +++ b/docs/TRADING_REVIEW_WORKFLOW_CONTRACT_ACCEPTANCE_DRAFT.md @@ -187,3 +187,11 @@ cross-key의 exact source/outputs/publish·reason audit·FAILED parent chain/단 명시 retry 부모 mapping 보존·commit/응답 유실/UNKNOWN·현재 Guard/삭제·TTL/원 profile 불명 사례를 기존 WR-G01/02/07/08· WR-DRAFT-01~14에 연결한다. 모두 semantic 미실행이며 새 test ID/실행 결과는 추가하지 않는다. 기존 Core resource_id는 원 receipt 전체의 증거가 아니다. ④ 불명 pin·receipt retention/legacy·actual authority/SQL/운영 인계는 열린다. + + +## 순차 source pin 수용 연결 + +[④ 후보](TRADING_REVIEW_REPROCESSING_SOURCE_PIN_POLICY_DRAFT.md)의 원인 분류·source/type/profile별 지원 범위·versioned No-Run 거절· +same-key 원 decision/UNKNOWN·복구 후 새 key·현재 Guard/삭제/TTL/legacy 사례를 기존 WR-G01/02/07/08·WR-DRAFT-01~14에 연결한다. +현재422의 recorded Run 필수 조건·hash/vector는 유지한다. 새 거절 variant/code·receipt 수명/삭제·consumer·운영 증적 전에는 활성화하지 않는다. +새 test ID/semantic 실행은 추가하지 않는다. 다음은 ①~④의 채택/보류/수정 결정표와 필요한 versioned 계약/전파 계획이다. diff --git a/docs/TRADING_REVIEW_WORKFLOW_DTO_DRAFT.md b/docs/TRADING_REVIEW_WORKFLOW_DTO_DRAFT.md index 05a3a30..9c01fcb 100644 --- a/docs/TRADING_REVIEW_WORKFLOW_DTO_DRAFT.md +++ b/docs/TRADING_REVIEW_WORKFLOW_DTO_DRAFT.md @@ -128,3 +128,11 @@ reason 차이 수렴·원 request audit·retry chain은 미채택 검토 사항 다른 key의 수렴에도 key별 request audit/receipt를 남기고 원 Run/기존 mapping을 덮지 않는 안이다. HTTP body 전체 bytes·현재 failure/headers까지 불변으로 저장하거나 현재FAILED에서 원410/422를 추정하지 않는다. 기존 오류 Run 연결 schema는 유지한다. 새 No-Run receipt·새422·조회 endpoint·HTTP 상태를 추가하지 않으며 ①~③은 미채택이다. + + +## ④ No-Run 거절은 별도 versioned 계약 후보 + +[④ 후보](TRADING_REVIEW_REPROCESSING_SOURCE_PIN_POLICY_DRAFT.md)는 정상 legacy pin 부족에 대한 Run 없는 영속 거절을 제안한다. +현재 접수422의 RecordedFailure/Run 참조 필수 조건은 유지한다. 이를 Run ID 생략/null/0·일반 ErrorResponse fallback으로 바꾸지 않는다. +새 variant의 code/required/nullable·profile·receipt 수명/consumer는 미정이며 이번 YAML/DTO/schema 예제에는 추가하지 않는다. +pin이 확정된 raw 부재/compatibility 실패의 WP02 경로를 전부 No-Run으로 바꾸지 않는다. ①~④는 미채택이다. diff --git a/openapi/CONTEXT_REVISION b/openapi/CONTEXT_REVISION index 343e853..783e24a 100644 --- a/openapi/CONTEXT_REVISION +++ b/openapi/CONTEXT_REVISION @@ -1 +1 @@ -3a8a7dd5c5f95f2a9d088c8f303d4a2744e29450 +4686b2f1efc9ffdcf6cebaad8b7d357ca730df4a