@givolt/i3-composer-agent 3.0.0 → 3.2.1

package/references/enterprise-sop-resources/selection-handoff.md

@@ -1,55 +0,0 @@
-# 同主题规格改选与影响预览
-
-<!-- i3:zh-guide:start -->
-## 中文使用说明
-
-按下文完整工程步骤、检查项与验证条件执行。根据任务选择适用步骤，保留证据、风险和退出条件；正文示例中的英文标签在面向用户输出时译为中文。
-
-默认使用简体中文解释、追问及生成报告；用户明确要求其他语言时可切换。原方法正文、引用、阈值和审批条件完整保留。代码标识、路径、命令、工具参数、JSON 键/枚举与原文引用保持原样。
-<!-- i3:zh-guide:end -->
-
-本片补充单次受控入口的 selection-preview／selection-switch 操作，不新增顶级命令，不接管标准流程或企业 auto。只支持项目级 CodeBuddy CLI 内同一已选 capabilityId＋prdId 的 PRD、AD、已有 TestCase／原型路径组合。公共技术规约、共享契约、工程骨架、其他主题、scope／selected内人工内容、业务稿与 Plan 不由本操作改写；成功写入只保留三字段，旧candidates／delivery随原始清单留历史，其他未知顶层字段先明确用途。其他宿主、项目外来源或骨架目录仍可手动交接。
-
-## 先预览，再明确选择
-
-调用方按真实任务整理请求，不能让只读模型自行决定选用或生成授权。operation=selection-preview 时，先真实加载自有 SOP Skill，读取当前／目标主题与必要共享依赖、当前 Plan／任务和调用方明确补入的完成记录；外层核成功回执后，才将差异、配套证据、Plan 引用命中和任务文本观察保存到项目外 selection-preview.json。项目零写入。输入太大可按主题分段完成读取，不能以元数据裁剪替代业务正文。
-
-调用方在会话中展示原因、推荐与选项：保留当前选择／明确选择新组合／补齐配套或明确解除引用／本次手动交接／停止。无真实明确委托时结束；模型推荐、自动模式、已有候选和高版本号均不构成选择。
-
-确认准确预览后，调用方用相同的工作、主题、target、links、inputs 准备 operation=selection-switch，并用 preview 指向该项目外预览文件，再在真实委托范围内加 --switch-selection。仍运行一个新的只读会话，回读当前输入与旧预览所涉及来源；回执、来源或文件变化均不进入写入。通过后复用既有 handoff._store，最多一次受限更新本主题；保存旧清单并核完整差量。手动方式不依赖此辅助。请求和参数只能限制委托，不能认证人类身份或创造批准。
-
-## 请求与配套判据
-
-共同字段：schemaVersion=1；work、manifest、capabilityId、prdId、task 必须明确。target 必须含准确 prd 路径，只允许 prd／ad／testCase／prototype；未列项保持旧引用，显式 null 仅解除对应配套引用、保留实际文件。不要靠省略旧 AD 把它假配给新 PRD。
-
-links 是调用方从真实正文摘取的数组，每项为 role、upstreamRole、line、quote。AD 必须核直接 PRD；已有 TestCase 同时核直接 PRD 与 AD；已有原型核 PRD。line 为真实正文的一基行号，quote 为该行完整原文；原文需以行内代码或 Markdown 链接准确写出本次上游的项目根相对路径。程序核原文、准确路径及组合，不做业务语义批准。项目采用其他引用格式时，可补人工核对并继续手动方式，不能冒称本入口已自动识别。缺证据、旧上游、不存在的上游或矛盾配套列缺口，不能靠确认参数绕过。无 TestCase 或原型本身不阻断改选；缺 AD 时如实保留工程规划缺口，不能由选用推定可实施。
-
-inputs 为本次明确采用的额外正文路径；原／新主题和共享来源由选定清单补入。若 delivery 声明 plan／taskTarget，必须读取；当前存在的 tasks/plan.md、tasks/todo.md 也须读取。其他自定义任务／完成记录由调用方准确补入 inputs，不从任意文件或复选框推定完成或依赖。预览中的路径命中只是影响线索，不能证明未命中的任务无影响。
-
-```json
-{
-  "schemaVersion": 1,
-  "operation": "selection-preview",
-  "work": "本次实际工作",
-  "manifest": ".i3/sop/work/handoff.json",
-  "capabilityId": "PBC-ID",
-  "prdId": "THEME-ID",
-  "target": {"prd": "spec/能力/主题-PRD_v0.0.3.md", "ad": "spec/能力/主题-AD_v0.0.2.md", "testCase": null},
-  "links": [{"role": "ad", "upstreamRole": "prd", "line": 8, "quote": "直接产品依据：`spec/能力/主题-PRD_v0.0.3.md`"}],
-  "inputs": ["tasks/completed.md"],
-  "task": "核对这组准确路径的影响，先展示预览，不修改业务稿与Plan。"
-}
-```
-
-以上行号和路径是格式示意，必须从当前正文取得，不能照抄占位值。
-
-```text
-python3 <实际资料根>/controlled_handoff.py --project-root <实际项目根> --request <项目外预览请求.json> --evidence-dir <新项目外证据目录>
-python3 <实际资料根>/controlled_handoff.py --project-root <实际项目根> --request <绑定同一预览的切换请求.json> --evidence-dir <另一新证据目录> --switch-selection
-```
-
-## 并发、历史和后续原能力
-
-预览绑定本次实际输入和清单；摘要仅在项目外用作这次瞬时审计，不增加业务 JSON 的强制 hash 字段，不禁止后续人工修改。确认前发生人工修改、其他主题变化或并发写入时保留现状，重新预览。重复同一已完成切换且只有该次准确清单／历史差量时零写入；不把其他新增记录或新修改混入旧确认。基础锁与写前比对不构成跨编辑器事务，写后异常保留实际现场交人核对，不自动恢复业务稿或循环重试。
-
-清单切换不更新当前 Plan，也不迁移业务认可或工程开工许可。调用方须把新选 AD 及准确 PRD、公共规约、契约、工程骨架和必要代码显式交原 /i3-plan 核影响；仍由原方法写 tasks/plan.md／唯一任务目标，待人审认可后才按原 /i3-build 或 /i3-build auto 执行。完成任务及历史保留。共享技术定义或工程骨架本身需要修改时单独明确任务。候选登记／撤回已退出当前流程；撤销主题和跨主题完整差量仍按后续明确范围处理。

package/references/enterprise-sop-resources/selection_handoff.py

@@ -1,225 +0,0 @@
-"""One-topic path selection, used only after controlled readonly preflight.
-
-Business documents and Plan are never written. Source quotes bind paths, not
-business compatibility or approval. Existing handoff storage remains canonical.
-"""
-import copy
-import importlib.util
-import json
-from pathlib import Path
-import re
-import sys
-import uuid
-
-sys.dont_write_bytecode = True
-RESOURCES = Path(__file__).resolve().parent
-
-
-def _module(name, file):
-    spec = importlib.util.spec_from_file_location(name, file)
-    module = importlib.util.module_from_spec(spec); spec.loader.exec_module(module)
-    return module
-
-
-handoff = _module('selection_json', RESOURCES/'handoff.py')
-native = _module('selection_native', RESOURCES/'verification/check_native_execution.py')
-ROLES = {'prd', 'ad', 'testCase', 'prototype'}
-PAIRS = {('ad', 'prd'), ('testCase', 'prd'), ('testCase', 'ad'), ('prototype', 'prd')}
-
-
-def _file(root, raw):
-    if not isinstance(raw, str) or not raw.strip():
-        raise ValueError('selection requires an explicit file path')
-    path = (root/raw).resolve()
-    if not path.is_relative_to(root) or not path.is_file() or not path.read_text(encoding='utf-8').strip():
-        raise ValueError('selection source missing, empty or outside project: '+raw)
-    return str(path.relative_to(root))
-
-
-def plan(project_root, request):
-    root = Path(project_root).resolve()
-    fields = {'schemaVersion', 'operation', 'work', 'manifest', 'capabilityId', 'prdId', 'target', 'links', 'inputs', 'task', 'preview'}
-    if not isinstance(request, dict) or set(request)-fields or type(request.get('schemaVersion')) is not int or request['schemaVersion'] != 1:
-        raise ValueError('selection request contract differs')
-    if request.get('operation') not in ('selection-preview', 'selection-switch'):
-        raise ValueError('explicit selection operation required')
-    if not all(isinstance(request.get(k), str) and request[k].strip() for k in ('work', 'capabilityId', 'prdId', 'task')):
-        raise ValueError('explicit work and selected topic identity required')
-    mf = handoff._manifest_path(root, request.get('manifest'))
-    before_bytes = mf.read_bytes(); raw = before_bytes.decode('utf-8')
-    before = handoff._load(before_bytes)
-    if before['scope']['work'] != request['work']:
-        raise ValueError('selection manifest belongs to another work')
-    matches = [t for t in before['selected'].get('topics', []) if all(t[k] == request[k] for k in ('capabilityId', 'prdId'))]
-    if len(matches) != 1:
-        raise ValueError('explicit topic is not uniquely selected; no latest-version fallback')
-    old_topic = matches[0]; topic = copy.deepcopy(old_topic)
-    target = request.get('target')
-    if not isinstance(target, dict) or set(target)-ROLES or not isinstance(target.get('prd'), str):
-        raise ValueError('target must explicitly name PRD and only local companion roles')
-    for role, path in target.items():
-        if path is None and role != 'prd': topic.pop(role, None)
-        else: topic[role] = _file(root, path)
-    expected = handoff._selected_only(before)
-    expected['selected']['topics'][before['selected']['topics'].index(old_topic)] = topic
-    # The selected scope supplies shared dependencies; no unrelated topic is loaded.
-    selected = handoff._resolve(root, before, request['capabilityId'], request['prdId'], ())['references']
-    paths = [_file(root, item['path']) for item in selected]
-    paths += [_file(root, topic[role]) for role in sorted(ROLES) if role in topic]
-    inputs = request.get('inputs', [])
-    if not isinstance(inputs, list): raise ValueError('inputs must be explicit paths')
-    paths += [_file(root, p) for p in inputs]
-    delivery = before.get('delivery', {})
-    if not isinstance(delivery, dict): raise ValueError('delivery must remain an object')
-    plan_paths = [_file(root, delivery[k]) for k in ('plan', 'taskTarget') if k in delivery]
-    plan_paths += [_file(root, p) for p in ('tasks/plan.md', 'tasks/todo.md') if (root/p).exists()]
-    paths = list(dict.fromkeys(paths+plan_paths))
-    links = request.get('links', [])
-    if not isinstance(links, list): raise ValueError('links must be a caller supplied source-evidence array')
-    by_pair = {}
-    for link in links:
-        if not isinstance(link, dict) or set(link) != {'role', 'upstreamRole', 'line', 'quote'}:
-            raise ValueError('source evidence needs role/upstreamRole/line/quote')
-        pair = (link['role'], link['upstreamRole'])
-        if pair not in PAIRS or pair in by_pair: raise ValueError('ambiguous or unsupported companion source evidence')
-        by_pair[pair] = link
-    gaps = []; checks = []
-    for role, upstream_role in sorted(PAIRS):
-        if role not in topic: continue
-        link = by_pair.get((role, upstream_role)); upstream = topic.get(upstream_role)
-        lines = (root/topic[role]).read_text().splitlines(); passed = False
-        if link and upstream and type(link['line']) is int and 1 <= link['line'] <= len(lines):
-            quote = lines[link['line']-1]
-            tokens = re.findall(r'`([^`]+)`|\]\(([^)]+)\)', quote)
-            passed = quote == link['quote'] and any(upstream == token for pair in tokens for token in pair if token)
-        check = {'role': role, 'path': topic[role], 'upstreamRole': upstream_role, 'upstreamPath': upstream,
-                 'passed': passed, 'evidence': link, 'semanticCompatibility': 'requires-human-review'}
-        checks.append(check)
-        if not passed: gaps.append({'code': 'companion_source_unconfirmed', **check})
-    diff = [{'role': role, 'before': old_topic.get(role), 'after': topic.get(role)}
-            for role in sorted(ROLES) if old_topic.get(role) != topic.get(role)]
-    tasks = []; mentions = []
-    changed_paths = {x[k] for x in diff for k in ('before', 'after') if x[k]}
-    for path in list(dict.fromkeys(plan_paths+[p for p in paths if p.startswith('tasks/')])):
-        for n, line in enumerate((root/path).read_text().splitlines(), 1):
-            checkbox = re.match(r'^\s*[-*]\s+\[([ xX])\]\s+(.+)', line)
-            if checkbox:
-                tasks.append({'path': path, 'line': n, 'state': 'completed' if checkbox[1].lower() == 'x' else 'unfinished', 'text': checkbox[2]})
-            found = sorted(p for p in changed_paths if p in line)
-            if found: mentions.append({'path': path, 'line': n, 'text': line, 'references': found})
-    base_request = {'schemaVersion': 1, 'operation': 'manual', 'work': request['work'],
-        'manifest': str(mf.relative_to(root)), 'reference': {'role': 'prd', 'path': topic['prd'],
-            'capabilityId': request['capabilityId'], 'prdId': request['prdId']},
-        'inputs': paths, 'task': request['task']+' 仅只读改选预检；不得自行登记、改稿或调整Plan。'}
-    return {'projectRoot': str(root), 'manifest': str(mf.relative_to(root)), 'request': request,
-        'beforeText': raw, 'expected': expected, 'beforeTopic': old_topic, 'afterTopic': topic,
-        'diff': diff, 'sourceChecks': checks, 'gaps': gaps, 'preflightRequest': base_request,
-        'sharedReferences': [x for x in selected if x['role'] not in ROLES],
-        'planImpact': {'paths': list(dict.fromkeys(plan_paths)), 'tasks': tasks, 'mentions': mentions,
-            'automaticallyUpdated': False, 'completionEvidence': 'checkbox text only; not execution proof',
-            'nextAction': '将选定AD及准确来源显式交原Plan核影响；修改计划与开工认可另行处理。'},
-        'engineeringReady': False, 'businessApproved': False}
-
-
-def freeze(selection, files):
-    """Outside-project preview evidence, not an approval or business JSON field."""
-    return {'schemaVersion': 1, 'kind': 'i3-sop-selection-preview', 'id': str(uuid.uuid4()),
-            'plan': copy.deepcopy(selection), 'files': copy.deepcopy(files)}
-
-
-def _intent(selection):
-    request = selection['request']
-    return {'projectRoot': selection['projectRoot'], 'manifest': selection['manifest'],
-            **{k: request[k] for k in ('work', 'capabilityId', 'prdId', 'links', 'inputs') if k in request},
-            'target': {k: selection['afterTopic'].get(k) for k in request['target']}}
-
-
-def apply(project_root, selection, receipt, *, authorized=False, on_store=None):
-    if authorized is not True: raise ValueError('exact selection authorization required')
-    root = Path(project_root).resolve()
-    if (receipt.get('schemaVersion') != 1 or receipt.get('kind') != 'i3-sop-selection-preview'
-            or not isinstance(receipt.get('id'), str) or not isinstance(receipt.get('files'), dict)):
-        raise ValueError('valid saved selection preview required')
-    saved = receipt['plan']
-    if (_intent(saved) != _intent(selection) or saved['expected'] != selection['expected']
-            or saved['projectRoot'] != str(root)):
-        raise ValueError('preview does not name this exact selection')
-    if saved['gaps'] or selection['gaps']: raise ValueError('companion source evidence unresolved')
-    mf = handoff._manifest_path(root, selection['manifest'])
-    current = mf.read_bytes(); before_files = native.inventory(root)
-    delta = [p for p in set(before_files)|set(receipt['files']) if before_files.get(p) != receipt['files'].get(p)]
-    if delta:
-        # A repeated, already-applied exact switch is a no-op. No new business
-        # content or other topic change may ride along with the old preview.
-        history = [p for p in delta if p != selection['manifest']]
-        history_parent = mf.parent/'history'
-        repeated = (handoff._load(current) == saved['expected'] and len(history) == 1
-                    and selection['manifest'] in delta and history[0] not in receipt['files'])
-        if repeated:
-            hp = handoff._manifest_path(root, history[0])
-            repeated = (hp.parent == history_parent and hp.name.startswith(mf.stem+'-')
-                        and hp.suffix == '.json' and hp.read_bytes() == saved['beforeText'].encode('utf-8'))
-        if repeated: return {'ok': True, 'changed': False, 'readbackPassed': True, 'changedFiles': []}
-        raise ValueError('project changed since preview; re-read and create a new preview')
-    if current != saved['beforeText'].encode('utf-8'):
-        raise ValueError('manifest changed since preview')
-    if on_store: on_store()
-    result = handoff._store(root, mf, current, saved['expected'])
-    after_files = native.inventory(root)
-    changed = sorted(p for p in set(before_files)|set(after_files) if before_files.get(p) != after_files.get(p))
-    allowed = [selection['manifest'], result['history']] if result['changed'] else []
-    if (set(changed) != set(allowed) or handoff._load(mf.read_bytes()) != saved['expected']
-            or (result['changed'] and (root/result['history']).read_bytes() != current)):
-        raise ValueError('selection postcheck failed; retain actual files for human review, no automatic rollback')
-    return {**result, 'readbackPassed': True, 'changedFiles': changed}
-
-
-def finish(prepared, evidence, *, authorized, response):
-    """Called after real native receipts and current file boundaries pass."""
-    root = Path(prepared['root']); proposal = prepared['selection']; request = prepared['request']
-    summary = {k: proposal[k] for k in ('diff', 'sourceChecks', 'gaps', 'sharedReferences', 'planImpact', 'engineeringReady')}
-    out = response('needs_confirmation', 'selection_confirmation_required',
-                   '改选预检完成；请核配套及Plan影响，再明确选择该组路径。',
-                   recommendation='核对预览；配套未确认先补证据或明确解除引用，保留文档原件。')
-    out['selection'] = summary
-    out['options'] = [{'id': 'keep-selection', 'label': '保留当前选择'},
-                      {'id': 'prepare-companions', 'label': '补齐配套或明确解除引用后重新预览'},
-                      {'id': 'manual-handoff', 'label': '本次手动交接路径'},
-                      {'id': 'stop', 'label': '暂停并保留现场'}]
-    if request['operation'] == 'selection-preview':
-        preview = freeze(proposal, prepared['scope']['files'])
-        (evidence/'selection-preview.json').write_text(json.dumps(preview, ensure_ascii=False, indent=2)+'\n')
-        out['preview'] = {'id': preview['id'], 'path': str(evidence/'selection-preview.json')}
-    else:
-        preview = prepared['selectionReceipt']
-        if native.loads(Path(request['preview']).read_text()) != preview:
-            return response('blocked', 'selection_preview_changed', '预览证据已改变；保留现场并重新预览。')
-        out['preview'] = {'id': preview.get('id'), 'path': request['preview']}
-    if proposal['gaps']:
-        out['reason']['code'] = 'selection_companions_unconfirmed'
-        out['reason']['message'] = '现有配套或调用方原文证据不能绑定目标上游；本次不改选。'
-        out['recommendation']['id'] = 'prepare-companions'
-        return out
-    out['options'].insert(1, {'id': 'authorize-selection', 'label': '明确委托切换到此预览的准确组合'})
-    out['recommendation']['id'] = 'authorize-selection'
-    if request['operation'] != 'selection-switch' or not authorized:
-        return out
-    registration = {'attempted': False, 'attempts': 0, 'kind': 'direct-python-api',
-                    'entry': 'selection_handoff.apply -> handoff._store', 'shell': False, 'previewId': preview.get('id')}
-    def on_store():
-        registration.update(attempted=True, attempts=1)
-        (evidence/'selection-registration.json').write_text(json.dumps(registration, indent=2)+'\n')
-    try:
-        result = apply(root, proposal, preview, authorized=True, on_store=on_store)
-        registration['result'] = result
-        (evidence/'selection-readback.json').write_text(json.dumps(result, ensure_ascii=False, indent=2)+'\n')
-        out = response('selected' if result['changed'] else 'unchanged', 'selection_applied',
-                       '准确组合及差量已回读；业务稿、其他主题和原Plan保持，后续规划认可另行处理。')
-    except (OSError, ValueError, KeyError, TypeError) as exc:
-        registration['error'] = str(exc)
-        out = response('blocked', 'selection_not_applied', str(exc),
-                       recommendation='保留当前内容；核对变化或锁后用新预览处理，不自动重试或回滚。')
-    out['registration'] = registration
-    out['selection'] = summary
-    (evidence/'selection-registration.json').write_text(json.dumps(registration, ensure_ascii=False, indent=2)+'\n')
-    return out

package/references/enterprise-sop-resources/stages.json

@@ -1,262 +0,0 @@
-{
-  "schemaVersion": 1,
-  "resourceId": "i3-enterprise-sop",
-  "resourceVersion": "0.16.2",
-  "status": "local-short-command-plan-candidate",
-  "activation": "explicit-enterprise-task-or-applicable-recorded-selection",
-  "ordinaryInstallEnablesEnterpriseWorkflow": false,
-  "sharedContract": "template-contracts.md",
-  "integrityManifest": "assets-manifest.json",
-  "stagePathBase": "this-index-directory",
-  "stageFilePathBase": "selected-stage-manifest-directory",
-  "stages": {
-    "brd": {
-      "documentType": "BRD",
-      "resourceRoot": "brd",
-      "manifest": "brd/assets-manifest.json",
-      "resourceVersion": "0.2.3",
-      "templateVersion": "v0.0.3",
-      "templateRole": "complete-document-template",
-      "actions": [
-        "generate",
-        "review",
-        "revise",
-        "recheck"
-      ]
-    },
-    "prd": {
-      "documentType": "PRD",
-      "resourceRoot": "prd",
-      "manifest": "prd/assets-manifest.json",
-      "resourceVersion": "0.3.3",
-      "templateVersion": "v0.0.4",
-      "templateRole": "complete-document-template",
-      "actions": [
-        "generate",
-        "review",
-        "revise",
-        "recheck"
-      ]
-    },
-    "ad": {
-      "documentType": "AD",
-      "resourceRoot": "ad",
-      "manifest": "ad/assets-manifest.json",
-      "resourceVersion": "0.3.3",
-      "templateVersion": "v0.0.4",
-      "templateRole": "complete-document-template",
-      "actions": [
-        "generate",
-        "review",
-        "revise",
-        "recheck"
-      ]
-    },
-    "testcase": {
-      "documentType": "TestCase",
-      "resourceRoot": "testcase",
-      "manifest": "testcase/assets-manifest.json",
-      "resourceVersion": "0.3.4",
-      "templateVersion": "v0.0.4",
-      "templateRole": "complete-document-template",
-      "actions": [
-        "generate",
-        "review",
-        "revise",
-        "recheck"
-      ]
-    }
-  },
-  "existingPrdSubtreePreserved": false,
-  "sopCommandImplemented": true,
-  "autoSupported": false,
-  "engineeringAssetsIncluded": false,
-  "projectModifiedCopiesPreserved": true,
-  "handoffContract": "handoff-contract.md",
-  "projectGuide": "codebuddy-project-guide.md",
-  "auxiliaryResources": {
-    "technical-baseline": {
-      "resourceRoot": "technical-baseline",
-      "manifest": "technical-baseline/assets-manifest.json",
-      "resourceVersion": "0.2.0",
-      "templateVersion": "v0.0.1",
-      "businessStage": false,
-      "role": "shared-engineering-guidance",
-      "baselineCatalog": "technical-baseline/assets-manifest.json",
-      "explicitAdoptionRequired": true
-    }
-  },
-  "manualHandoffSupported": true,
-  "jsonRegistrationImplemented": true,
-  "lifecycleContract": "lifecycle-contract.md",
-  "existingPrdTemplatePreserved": true,
-  "candidateRevision": "20261021-plan-gates-r4",
-  "readEvidenceChecker": {
-    "entry": "verification/README.md",
-    "script": "verification/check_reads.py",
-    "traceFormat": "codebuddy-stream-json",
-    "automaticActivation": false,
-    "writesProjectFiles": false,
-    "version": "0.3.1",
-    "reviewOutputContract": "verification/review-output.schema.json",
-    "roleBindings": "caller-verification-scope-only",
-    "schemaBuilder": {
-      "module": "verification/check_reads.py",
-      "function": "build_review_schema"
-    },
-    "reportContentChecker": "check_report"
-  },
-  "sopSkillImplemented": true,
-  "sopSkillScope": "explicit-single-stage-native-spec-or-planning-and-reference-handoff",
-  "handoffHelper": {
-    "script": "handoff.py",
-    "version": "0.2.0",
-    "operations": [
-      "init",
-      "select",
-      "resolve"
-    ],
-    "selection": "initial-or-same-only; exact same-topic replacement via controlled preview",
-    "manualSupported": true,
-    "python": "3.9+",
-    "semanticOrApprovalValidation": false,
-    "originalPlanBuildConsumptionVerified": false,
-    "manifestFields": [
-      "schemaVersion",
-      "scope",
-      "selected"
-    ]
-  },
-  "executionEvidenceChecker": {
-    "script": "verification/check_execution.py",
-    "version": "0.1.0",
-    "automaticActivation": false,
-    "writesProjectFiles": false,
-    "reportContract": "handoff-contract.md#9-真实调用与执行报告",
-    "profile": "CodeBuddy stream-json/direct-python3-helper",
-    "verdictDoesNotApproveBusiness": true
-  },
-  "generation": {
-    "requiredSkill": "i3-spec-driven-development",
-    "wrapperCommandUnchanged": true,
-    "nativeStopPreserved": true
-  },
-  "businessDocuments": {
-    "defaultRoot": "spec",
-    "layout": "one-capability-one-directory",
-    "existingAdoptedPathsPreserved": true,
-    "resourceRootUnchanged": true,
-    "engineeringEntry": "selected AD plus explicitly referenced selected sources",
-    "context": "selected topic and required shared dependencies"
-  },
-  "nativeHandoff": {
-    "plan": "SPEC.md or equivalent; original outputs and approval unchanged",
-    "build": "approved next task",
-    "buildAuto": "original spec, git, plan approval and per-task loop unchanged",
-    "manifestAutomaticallyConsumedByOriginalCommands": false,
-    "manualSupported": true,
-    "verification": "see current independent evidence; not inferred from index"
-  },
-  "nativeExecutionEvidenceChecker": {
-    "script": "verification/check_native_execution.py",
-    "version": "0.1.1",
-    "profiles": [
-      "generation",
-      "status",
-      "plan",
-      "auto-preflight",
-      "standard"
-    ],
-    "automaticActivation": false,
-    "writesProjectFiles": false,
-    "helperCheckerUnchanged": true,
-    "createsApproval": false,
-    "reportContract": "verification/README.md#原生方法与执行报告"
-  },
-  "recoveryContract": "recovery-contract.md",
-  "minimalRecovery": {
-    "implemented": "owned skill procedure reusing handoff.py",
-    "documentWrites": false,
-    "newHelperOperations": false,
-    "draftCompletionValidation": "caller actual task and final full read; not helper nonempty-path check",
-    "supports": [
-      "readonly-partial-draft-assessment",
-      "explicit-selected-reference-backfill",
-      "idempotent-registration",
-      "human-edit-protection"
-    ],
-    "selectionReplacementImplemented": true,
-    "crossEditorTransactionGuaranteed": false,
-    "selectionReplacementScope": "one-existing-topic PRD and explicit local companions; shared sources unchanged",
-    "topicCancellationImplemented": false
-  },
-  "controlledHandoff": {
-    "script": "controlled_handoff.py",
-    "contract": "controlled-handoff.md",
-    "version": "0.4.0",
-    "host": "codebuddy-cli-project",
-    "activation": "explicit-single-task",
-    "nativeReadOnlyPreflight": true,
-    "automaticHook": false,
-    "businessApproval": false,
-    "enterpriseAuto": false,
-    "selection": {
-      "module": "selection_handoff.py",
-      "contract": "selection-handoff.md",
-      "operations": [
-        "selection-preview",
-        "selection-switch"
-      ],
-      "exactPreviewRequired": true,
-      "topicScope": "one-existing-topic",
-      "changesSharedSources": false,
-      "writesBusinessDocumentsOrPlan": false,
-      "semanticCompatibility": "caller-source-quotes-and-human-review"
-    },
-    "auditBeforeSelectedWrite": true
-  },
-  "independentReview": {
-    "contract": "review-handoff.md",
-    "script": "verification/review_handoff.py",
-    "version": "0.2.0",
-    "host": "codebuddy-cli",
-    "activation": "explicit-single-review-or-recheck",
-    "freshSession": true,
-    "projectWrites": false,
-    "businessApproval": false,
-    "missingHost": "new-session-task",
-    "selectedOnlyRegistrationValidation": "pending-S10",
-    "contextProfile": "fixed-review-context-v1",
-    "modelReads": "full stage README, template, unique action, review contract and necessary actual project/business sources; full selected fallback for unknown/custom combinations",
-    "outerChecks": "metadata resolution and source snapshots retained; never model-read evidence"
-  },
-  "planHandoff": {
-    "contract": "plan-handoff.md",
-    "requiredSkill": "i3-planning-and-task-breakdown",
-    "originalCommandObligationsPreserved": true,
-    "defaultOutputs": [
-      "tasks/plan.md",
-      "tasks/todo.md"
-    ],
-    "writesBusinessJson": false,
-    "manualSupported": true,
-    "buildAutomaticallyInvoked": false,
-    "requiredResourceReads": [
-      "README.md",
-      "stages.json",
-      "template-contracts.md",
-      "handoff-contract.md",
-      "plan-handoff.md"
-    ],
-    "identityOrUpstreamConflict": "stop-before-native-planning-and-plan-todo-writes"
-  },
-  "operations": [
-    "brd",
-    "prd",
-    "ad",
-    "testcase",
-    "plan",
-    "review",
-    "status"
-  ]
-}