Skip to content

zrwangems/dsh-zrwang-plugin / ars/skills/sr-screener

sr-screener

Flagged

系统综述文献筛选:把方案或 PROSPERO 协议转成资格规则,双盲筛选标题摘要与全文,第三人裁决冲突,输出 PRISMA 2020 计数、EndNote/Zotero RIS 分组与可交付给论文技能的 literature_corpus。Triggers: systematic review screening, screen papers, PRISMA counts, pilot screening, adjudicate conflicts | 文献筛选, 系统综述筛选, PRISMA 计数, 筛选冲突裁决。

FileKindSize
SKILL.mdskill md33.1 KB
_shared/ARCHITECTURE.mdmarkdown51.7 KB
_shared/MODE_REGISTRY.mdmarkdown6.7 KB
_shared/agents/compliance_agent.mdmarkdown9.4 KB
_shared/artifact_reproducibility_pattern.mdmarkdown9.8 KB
_shared/benchmark_report.schema.jsonconfig2.7 KB
_shared/benchmark_report_pattern.mdmarkdown8.8 KB
_shared/bibliographic_integrity_signals.mdmarkdown8.1 KB
_shared/collaboration_depth_rubric.mdmarkdown11.5 KB
_shared/compliance_checkpoint_protocol.mdmarkdown8.9 KB
_shared/compliance_report.schema.jsonconfig8.1 KB
_shared/contracts/README.mdmarkdown54.7 KB
_shared/contracts/activity/adjudication_activity_input.schema.jsonconfig18.5 KB
_shared/contracts/activity/adjudication_activity_store.schema.jsonconfig18.7 KB
_shared/contracts/audit/audit_jsonl.schema.jsonconfig5.4 KB
_shared/contracts/audit/audit_sidecar.schema.jsonconfig8.4 KB
_shared/contracts/audit/audit_verdict.schema.jsonconfig5.4 KB
_shared/contracts/audit/cross_document_consistency_advisory.schema.jsonconfig20.4 KB
_shared/contracts/audit/cross_document_consistency_advisory_draft.schema.jsonconfig23.4 KB
_shared/contracts/audit/cross_document_source_manifest.schema.jsonconfig6.3 KB
_shared/contracts/audit/tortured_phrase_advisory.schema.jsonconfig30.9 KB
_shared/contracts/audit/tortured_phrase_snapshot.schema.jsonconfig4.9 KB
_shared/contracts/audit/tortured_phrase_snapshot_manifest.schema.jsonconfig7.3 KB
_shared/contracts/capability/stage_capability_matrix.jsonconfig23.5 KB
_shared/contracts/claim_standing/candidate_ledger.schema.jsonconfig23.1 KB
_shared/contracts/claim_standing/query_plan.schema.jsonconfig12.7 KB
_shared/contracts/claim_standing/query_plan_v1_1.schema.jsonconfig20.3 KB
_shared/contracts/claim_standing/retrieval_input.schema.jsonconfig14.4 KB
_shared/contracts/claim_standing/stance_record.schema.jsonconfig11.7 KB
_shared/contracts/claim_standing/transmission_ledger.schema.jsonconfig7.6 KB
_shared/contracts/cross_model/codex_citation_receipt.schema.jsonconfig4.7 KB
_shared/contracts/cross_model/codex_citation_request.schema.jsonconfig986 B
_shared/contracts/cross_model/promotion_bakeoff_sealed_commitment.schema.jsonconfig1.5 KB
_shared/contracts/cross_model/promotion_bakeoff_sealed_reveal.schema.jsonconfig1.5 KB
_shared/contracts/degradation_registry.jsonconfig42.5 KB
_shared/contracts/evaluator/full.jsonconfig6.3 KB
_shared/contracts/evidence/claim_registry.schema.jsonconfig2.3 KB
_shared/contracts/evidence/claim_registry_coverage_report.schema.jsonconfig4.8 KB
_shared/contracts/evidence/evidence_row.schema.jsonconfig14.3 KB
_shared/contracts/evidence/evidence_row_v1_1.schema.jsonconfig11.4 KB
_shared/contracts/evidence/evidence_row_v1_2.schema.jsonconfig21.8 KB
_shared/contracts/evidence/evidence_row_v1_3.schema.jsonconfig10.7 KB
_shared/contracts/human_subjects/authority_profile_registry.schema.jsonconfig16.7 KB
_shared/contracts/human_subjects/committee_correspondence.schema.jsonconfig9.9 KB
_shared/contracts/human_subjects/content_coverage_advisory.schema.jsonconfig19.9 KB
_shared/contracts/human_subjects/irb_context_record.schema.jsonconfig12.1 KB
_shared/contracts/human_subjects/resolved_authority_context.schema.jsonconfig11.8 KB
_shared/contracts/human_subjects/review_pathway_rule_trace.schema.jsonconfig9.5 KB
_shared/contracts/human_subjects/review_pathway_trace_request.schema.jsonconfig4.8 KB
_shared/contracts/human_subjects/submission_packet_inventory.schema.jsonconfig8.5 KB
_shared/contracts/human_subjects/submission_packet_manifest.schema.jsonconfig32.2 KB
_shared/contracts/passport/audit_artifact_entry.schema.jsonconfig10.8 KB
_shared/contracts/passport/bibliographic_integrity_signal.schema.jsonconfig48.9 KB
_shared/contracts/passport/citation_provenance.schema.jsonconfig4.8 KB
_shared/contracts/passport/citation_verification_summary.schema.jsonconfig8.2 KB
_shared/contracts/passport/claim_audit_result.schema.jsonconfig7.8 KB
_shared/contracts/passport/claim_drift.schema.jsonconfig3.8 KB
_shared/contracts/passport/claim_intent_manifest.schema.jsonconfig6.6 KB
_shared/contracts/passport/constraint_violation.schema.jsonconfig3.6 KB
_shared/contracts/passport/excluded_source_entry.schema.jsonconfig1.7 KB
_shared/contracts/passport/experiment_alignment_result.schema.jsonconfig4.8 KB
_shared/contracts/passport/experiment_provenance_entry.schema.jsonconfig10.0 KB
_shared/contracts/passport/human_read_log.schema.jsonconfig3.8 KB
_shared/contracts/passport/inquiry_ledger_ref.schema.jsonconfig881 B
_shared/contracts/passport/literature_corpus_entry.schema.jsonconfig30.3 KB
_shared/contracts/passport/preregistration_artifact.schema.jsonconfig4.3 KB
_shared/contracts/passport/rejection_log.schema.jsonconfig3.3 KB
_shared/contracts/passport/reset_ledger_entry.schema.jsonconfig7.1 KB
_shared/contracts/passport/run_ledger.schema.jsonconfig8.0 KB
_shared/contracts/passport/standing_constraint_entry.schema.jsonconfig2.6 KB
_shared/contracts/passport/temporal_audit_results.schema.jsonconfig8.8 KB
_shared/contracts/passport/terminal_policies.schema.jsonconfig8.1 KB
_shared/contracts/passport/timeline.schema.jsonconfig4.7 KB
_shared/contracts/passport/uncited_assertion.schema.jsonconfig3.3 KB
_shared/contracts/passport/uncited_audit_failure.schema.jsonconfig4.4 KB
_shared/contracts/passport/user_attested_read_resolution.schema.jsonconfig3.2 KB
_shared/contracts/passport/version_records.schema.jsonconfig4.9 KB
_shared/contracts/patch/block_manifest.schema.jsonconfig2.1 KB
_shared/contracts/patch/legacy/v1_0/revision_patch.schema.jsonconfig5.3 KB
_shared/contracts/patch/revision_patch.schema.jsonconfig8.9 KB
_shared/contracts/pdf/pdf_content_classifier_diagnostic.schema.jsonconfig1.2 KB
_shared/contracts/pdf/pdf_content_classifier_worker.schema.jsonconfig2.2 KB
_shared/contracts/pdf/pdf_read_preflight.schema.jsonconfig6.8 KB
_shared/contracts/re_review/input_manifest.schema.jsonconfig7.6 KB
_shared/contracts/re_review/legacy/v1_0/input_manifest.schema.jsonconfig6.2 KB
_shared/contracts/re_review/legacy/v1_0/precommitment.schema.jsonconfig8.9 KB
_shared/contracts/re_review/legacy/v1_0/traceability.schema.jsonconfig34.2 KB
_shared/contracts/re_review/legacy/v1_0/verdict_record.schema.jsonconfig10.5 KB
_shared/contracts/re_review/precommitment.schema.jsonconfig8.6 KB
_shared/contracts/re_review/traceability.schema.jsonconfig37.7 KB
_shared/contracts/re_review/verdict_record.schema.jsonconfig10.5 KB
_shared/contracts/research_workflow/inquiry_branch_ledger.schema.jsonconfig17.0 KB
_shared/contracts/research_workflow/research_workflow_profile.schema.jsonconfig7.2 KB
_shared/contracts/research_workflow/research_workflow_profile_selection_receipt.schema.jsonconfig3.9 KB
_shared/contracts/review_target/constructive_review_findings.schema.jsonconfig7.0 KB
_shared/contracts/review_target/criteria_registry.schema.jsonconfig4.0 KB
_shared/contracts/review_target/review_criteria_binding_manifest.schema.jsonconfig7.9 KB
_shared/contracts/review_target/review_criteria_source_receipt.schema.jsonconfig5.6 KB
_shared/contracts/review_target/review_target_context.schema.jsonconfig4.5 KB
_shared/contracts/review_target/review_target_declaration.schema.jsonconfig4.6 KB
_shared/contracts/reviewer/full.jsonconfig3.7 KB
_shared/contracts/reviewer/methodology_focus.jsonconfig2.2 KB
_shared/contracts/reviewer/review_panel_provenance.schema.jsonconfig7.8 KB
_shared/contracts/reviewer/review_panel_provenance_carrier.schema.jsonconfig4.1 KB
_shared/contracts/reviewer/review_panel_provenance_input.schema.jsonconfig3.5 KB
_shared/contracts/revision/author_adjudication.schema.jsonconfig7.8 KB
_shared/contracts/revision/author_adjudication_input.schema.jsonconfig1.2 KB
_shared/contracts/revision/claim_strength_drift_disposition.schema.jsonconfig3.6 KB
_shared/contracts/revision/claim_strength_drift_disposition_input.schema.jsonconfig3.1 KB
_shared/contracts/revision/claim_strength_drift_findings.schema.jsonconfig4.2 KB
_shared/contracts/revision/claim_surface_manifest.schema.jsonconfig3.3 KB
_shared/contracts/revision/integrity_correction_authorization.schema.jsonconfig4.3 KB
_shared/contracts/revision/integrity_correction_authorization_input.schema.jsonconfig1.5 KB
_shared/contracts/revision/integrity_correction_list.schema.jsonconfig1.8 KB
_shared/contracts/revision/integrity_pass_receipt.schema.jsonconfig809 B
_shared/contracts/revision/revision_evidence_bundle.schema.jsonconfig4.9 KB
_shared/contracts/revision/revision_roadmap.schema.jsonconfig11.2 KB
_shared/contracts/submission/format_profile.example.yamlconfig971 B
_shared/contracts/submission/format_profile.schema.jsonconfig4.6 KB
_shared/contracts/submission/submission_verification_report.schema.jsonconfig10.3 KB
_shared/contracts/submission/venue_profile.schema.jsonconfig4.1 KB
_shared/contracts/writer/full.jsonconfig3.6 KB
_shared/cross_model_verification.mdmarkdown83.3 KB
_shared/description-original.mdmarkdown1.1 KB
_shared/dsh-runtime.mdmarkdown1.5 KB
_shared/evals_lift_report.schema.jsonconfig5.0 KB
_shared/ground_truth_isolation_pattern.mdmarkdown16.0 KB
_shared/handoff_schemas.mdmarkdown96.9 KB
_shared/human_subjects_authority_registry.jsonconfig49.5 KB
_shared/mode_spectrum.mdmarkdown5.2 KB
_shared/model_tiering.mdmarkdown12.6 KB
_shared/output_language_pair.mdmarkdown7.7 KB
_shared/policy_data/nature_policy.mdmarkdown3.9 KB
_shared/prisma_trAIce_protocol.mdmarkdown10.2 KB
_shared/raise_framework.mdmarkdown7.5 KB
_shared/references/authority_content_coverage_advisory_protocol.mdmarkdown14.0 KB
_shared/references/claim_standing_candidate_ledger_protocol.mdmarkdown19.2 KB
_shared/references/claim_strength_ladder.mdmarkdown5.5 KB
_shared/references/cross_document_consistency_advisory_protocol.mdmarkdown13.5 KB
_shared/references/evidence_row_protocol.mdmarkdown14.4 KB
_shared/references/firm_rules.mdmarkdown11.0 KB
_shared/references/human_subjects_authority_protocol.mdmarkdown13.1 KB
_shared/references/intent_clarification_protocol.mdmarkdown11.9 KB
_shared/references/irb_terminology_glossary.mdmarkdown12.4 KB
_shared/references/per_source_method_weaknesses.mdmarkdown4.2 KB
_shared/references/protected_hedging_phrases.mdmarkdown8.9 KB
_shared/references/psychometric_terminology_glossary.mdmarkdown8.7 KB
_shared/references/review_criteria_consumer_protocol.mdmarkdown10.3 KB
_shared/references/review_form_note.mdmarkdown11.3 KB
_shared/references/review_pathway_rule_trace_protocol.mdmarkdown8.3 KB
_shared/references/routing_core.mdmarkdown5.7 KB
_shared/references/submission_packet_manifest_protocol.mdmarkdown13.6 KB
_shared/references/word_count_conventions.mdmarkdown9.0 KB
_shared/research_workflow_profiles/field_general.jsonconfig1.2 KB
_shared/review_criteria_registry.jsonconfig11.5 KB
_shared/review_criteria_sources/msr-2027-technical-papers.2026-08-24.jsonconfig2.0 KB
_shared/review_criteria_sources/sigsoft-empirical-standards.2026-08-24.jsonconfig1.4 KB
_shared/sprint_contract.schema.jsonconfig19.0 KB
_shared/style_calibration_protocol.mdmarkdown6.9 KB
_shared/templates/codex_audit_multifile_template.mdmarkdown16.7 KB
agents/protocol_architect_agent.mdmarkdown6.4 KB
agents/qc_auditor_agent.mdmarkdown5.2 KB
agents/reporter_agent.mdmarkdown3.7 KB
agents/screening_reviewer_agent.mdmarkdown5.4 KB
examples/example_config_dta.jsonconfig1.8 KB
examples/example_protocol_dta.mdmarkdown3.8 KB
examples/quick_screen_example.mdmarkdown3.0 KB
references/decision_rules.mdmarkdown6.7 KB
references/failure_paths.mdmarkdown4.1 KB
references/orchestration.mdmarkdown12.4 KB
references/protocol_template.mdmarkdown6.2 KB
references/quality_control.mdmarkdown6.0 KB
references/reporting_and_handoff.mdmarkdown5.8 KB
references/reviewer_roles.mdmarkdown4.0 KB
scripts/_claim_audit_constants.pyscript13.7 KB
scripts/_markdown_lint_util.pyscript9.0 KB
scripts/_next_verified_at_ms.pyscript6.5 KB
scripts/_skill_lint.pyscript13.6 KB
scripts/ars_cache_invalidate.pyscript1.3 KB
scripts/ars_mark_read.pyscript18.2 KB
scripts/ars_write_scope_guard.pyscript30.9 KB
scripts/audit_snapshot.pyscript23.5 KB
scripts/bibliographic_integrity_signals.pyscript32.2 KB
scripts/build_claim_standing_candidate_ledger.pyscript54.3 KB
scripts/build_claim_standing_query_plan.pyscript25.0 KB
scripts/build_content_coverage_advisory.pyscript45.1 KB
scripts/build_cross_document_consistency_advisory.pyscript77.9 KB
scripts/build_outputs.pyscript33.0 KB
scripts/build_review_pathway_rule_trace.pyscript34.2 KB
scripts/build_submission_packet_manifest.pyscript88.1 KB
scripts/build_workflow.pyscript20.0 KB
scripts/check_audit_artifact_consistency.pyscript103.9 KB
scripts/check_benchmark_report.pyscript2.4 KB
scripts/check_claim_audit_consistency.pyscript68.9 KB
scripts/check_claim_standing_freshness.pyscript9.7 KB
scripts/check_claim_standing_transmissions.pyscript17.9 KB
scripts/check_committee_correspondence.pyscript14.9 KB
scripts/check_corpus_consumer_protocol.pyscript13.7 KB
scripts/check_cross_model_handoff_contract.pyscript9.9 KB
scripts/check_data_access_level.pyscript5.2 KB

scripts/check_committee_correspondence.py

View on GitHub
#!/usr/bin/env python3
"""Validate a #668 committee-correspondence bundle.

This checker proves byte transport, source-comment accounting, degraded/profile
semantics, and response-skeleton coverage. It does not make a human-subjects
determination or judge whether a response will satisfy a committee.
"""
from __future__ import annotations

import argparse
import hashlib
import json
import re
import sys
from pathlib import Path, PurePosixPath
from typing import Any

from jsonschema import Draft202012Validator, FormatChecker


REPO_ROOT = Path(__file__).resolve().parents[1]
DEFAULT_SCHEMA = (
    REPO_ROOT
    / "shared"
    / "contracts"
    / "human_subjects"
    / "committee_correspondence.schema.json"
)
SOURCE_NAME = "source_letter.txt"
TRACKER_NAME = "concern_tracker.json"
SKELETON_NAME = "response_skeleton.md"
STATUS_LINE = "Status: drafting aid — no concern is asserted resolved."
RESPONSE_PLACEHOLDER = "[AUTHOR RESPONSE REQUIRED — drafting aid; do not claim resolved]"
EVIDENCE_PLACEHOLDER = "[EVIDENCE OR ARTIFACT POINTER REQUIRED]"
BOUNDARY_LINE = (
    "> **Human-subjects boundary:** This output does not authorize recruitment, "
    "consent, access to identifiable data, intervention, or data collection."
)
MARKER = re.compile(r"<!-- concern:(CC-[0-9]{3}) -->")
RESOLUTION_CLAIM = re.compile(
    r"\b(?:resolved|addressed|approved|cleared|submission[- ]ready)\b", re.IGNORECASE
)


class DuplicateKeyError(ValueError):
    pass


def _object_pairs(pairs: list[tuple[str, Any]]) -> dict[str, Any]:
    result: dict[str, Any] = {}
    for key, value in pairs:
        if key in result:
            raise DuplicateKeyError(f"duplicate JSON key: {key}")
        result[key] = value
    return result


def _load_json(path: Path, errors: list[str]) -> dict[str, Any] | None:
    try:
        with path.open("r", encoding="utf-8") as handle:
            value = json.load(handle, object_pairs_hook=_object_pairs)
    except (OSError, json.JSONDecodeError, DuplicateKeyError) as exc:
        errors.append(f"{path}: cannot load JSON: {exc}")
        return None
    if not isinstance(value, dict):
        errors.append(f"{path}: top-level value must be an object")
        return None
    return value


def _sha256(value: bytes) -> str:
    return hashlib.sha256(value).hexdigest()


def _bundle_member(bundle_root: Path, relative: str, errors: list[str]) -> Path | None:
    if "\\" in relative:
        errors.append(f"bundle path must use POSIX separators: {relative!r}")
        return None
    pure = PurePosixPath(relative)
    if pure.is_absolute() or not pure.parts or any(part in ("", ".", "..") for part in pure.parts):
        errors.append(f"bundle path must be a normalized relative path: {relative!r}")
        return None
    candidate = bundle_root.joinpath(*pure.parts)
    current = bundle_root
    for part in pure.parts:
        current = current / part
        if current.is_symlink():
            errors.append(f"bundle member cannot traverse a symlink: {relative!r}")
            return None
    try:
        resolved_root = bundle_root.resolve(strict=True)
        resolved = candidate.resolve(strict=True)
        resolved.relative_to(resolved_root)
    except (OSError, ValueError) as exc:
        errors.append(f"bundle member is missing or outside bundle: {relative!r}: {exc}")
        return None
    if not resolved.is_file():
        errors.append(f"bundle member must be a regular file: {relative!r}")
        return None
    return resolved


def _schema_errors(
    tracker: dict[str, Any], schema_path: Path, errors: list[str]
) -> bool:
    schema = _load_json(schema_path, errors)
    if schema is None:
        return True
    try:
        Draft202012Validator.check_schema(schema)
    except Exception as exc:  # pragma: no cover - CLI failure path
        errors.append(f"{schema_path}: invalid schema: {exc}")
        return True
    validator = Draft202012Validator(schema, format_checker=FormatChecker())
    found = sorted(validator.iter_errors(tracker), key=lambda item: list(item.path))
    for item in found:
        location = ".".join(str(part) for part in item.path) or "<root>"
        errors.append(f"schema {location}: {item.message}")
    return bool(found)


def validate_bundle(tracker_path: Path, schema_path: Path = DEFAULT_SCHEMA) -> list[str]:
    errors: list[str] = []
    tracker_path = tracker_path.resolve()
    tracker = _load_json(tracker_path, errors)
    if tracker is None:
        return errors
    if _schema_errors(tracker, schema_path, errors):
        return errors

    bundle_root = tracker_path.parent
    source_meta = tracker["source_artifact"]
    source_path = _bundle_member(bundle_root, source_meta["path"], errors)
    skeleton_meta = tracker["response_skeleton"]
    skeleton_path = _bundle_member(bundle_root, skeleton_meta["path"], errors)
    if tracker_path.name != TRACKER_NAME:
        errors.append(f"tracker filename must be {TRACKER_NAME}")
    if source_meta["path"] != SOURCE_NAME:
        errors.append(f"source_artifact.path must be {SOURCE_NAME}")
    if skeleton_meta["path"] != SKELETON_NAME:
        errors.append(f"response_skeleton.path must be {SKELETON_NAME}")
    if source_path is None or skeleton_path is None:
        return errors

    try:
        source_bytes = source_path.read_bytes()
        source_text = source_bytes.decode("utf-8")
    except (OSError, UnicodeDecodeError) as exc:
        errors.append(f"source letter must be readable UTF-8: {exc}")
        return errors
    source_digest = _sha256(source_bytes)
    if source_meta["sha256"] != source_digest:
        errors.append("source_artifact.sha256 does not match source_letter.txt")
    if source_meta["byte_length"] != len(source_bytes):
        errors.append("source_artifact.byte_length does not match source_letter.txt")
    if tracker["tracker_id"] != f"committee-{source_digest[:12]}":
        errors.append("tracker_id must bind to the first 12 hex characters of source SHA-256")
    if bundle_root.name != source_digest[:12]:
        errors.append("bundle directory name must equal the first 12 hex characters of source SHA-256")

    segments = source_meta["segments"]
    segment_by_id: dict[str, dict[str, Any]] = {}
    cursor = 0
    expected_orders = list(range(1, len(segments) + 1))
    actual_orders = [segment["source_order"] for segment in segments]
    if actual_orders != expected_orders:
        errors.append("source segments must be stored in canonical source order 1..N")
    for segment in segments:
        segment_id = segment["segment_id"]
        if segment_id in segment_by_id:
            errors.append(f"duplicate source segment id: {segment_id}")
        segment_by_id[segment_id] = segment
        start = segment["byte_start"]
        end = segment["byte_end"]
        if start != cursor:
            errors.append(f"{segment_id}: byte range must start at previous segment end {cursor}")
        if end <= start or end > len(source_bytes):
            errors.append(f"{segment_id}: invalid byte range [{start}, {end})")
            chunk = b""
        else:
            chunk = source_bytes[start:end]
            cursor = end
        if _sha256(chunk) != segment["sha256"]:
            errors.append(f"{segment_id}: segment SHA-256 mismatch")
        try:
            chunk.decode("utf-8")
        except UnicodeDecodeError:
            errors.append(f"{segment_id}: segment boundary splits invalid UTF-8")
    if cursor != len(source_bytes):
        errors.append("source segments must cover source_letter.txt through EOF")
    if source_text == "":  # schema byte_length already rejects this; explicit semantic message
        errors.append("source letter cannot be empty")

    concerns = tracker["concerns"]
    concern_ids = [concern["concern_id"] for concern in concerns]
    if len(set(concern_ids)) != len(concern_ids):
        errors.append("concern ids must be unique")
    comment_segments = [segment for segment in segments if segment["kind"] == "comment"]
    expected_concern_ids = [f"CC-{index:03d}" for index in range(1, len(comment_segments) + 1)]
    if concern_ids != expected_concern_ids:
        errors.append("concerns must use stable sequential ids in canonical source-comment order")
    expected_comment_ids = [segment["segment_id"] for segment in comment_segments]
    actual_comment_ids = [concern["source_comment_id"] for concern in concerns]
    if actual_comment_ids != expected_comment_ids:
        errors.append("every comment segment must map exactly once in canonical source order")
    if len(set(actual_comment_ids)) != len(actual_comment_ids):
        errors.append("a source comment cannot map to more than one concern")

    concern_id_set = set(concern_ids)
    profile = tracker["profile_context"]
    profile_derived = False
    for concern in concerns:
        concern_id = concern["concern_id"]
        segment = segment_by_id.get(concern["source_comment_id"])
        if segment is None:
            errors.append(f"{concern_id}: source comment id does not resolve")
            continue
        if segment["kind"] != "comment":
            errors.append(f"{concern_id}: source locator must name a comment segment")
        locator_expected = {
            "segment_id": segment["segment_id"],
            "source_order": segment["source_order"],
            "byte_start": segment["byte_start"],
            "byte_end": segment["byte_end"],
            "sha256": segment["sha256"],
        }
        if concern["source_locator"] != locator_expected:
            errors.append(f"{concern_id}: source locator does not exactly match segment manifest")
        if concern["source_order"] != segment["source_order"]:
            errors.append(f"{concern_id}: source_order does not match source segment")
        chunk = source_bytes[segment["byte_start"] : segment["byte_end"]]
        try:
            verbatim = chunk.decode("utf-8")
        except UnicodeDecodeError:
            verbatim = ""
        if concern["verbatim_text"] != verbatim:
            errors.append(f"{concern_id}: verbatim_text is not the exact source bytes")
        basis = concern["authority_basis"]
        if basis["provenance"] == "committee_explicit" and basis["exact_text"] not in verbatim:
            errors.append(f"{concern_id}: committee authority basis must be exact source text")

        artifact_names: set[str] = set()
        for artifact in concern["affected_artifacts"]:
            normalized_name = " ".join(artifact["name"].casefold().split())
            if normalized_name in artifact_names:
                errors.append(f"{concern_id}: duplicate affected artifact name")
            artifact_names.add(normalized_name)
            if artifact["provenance"] == "profile_resolved":
                profile_derived = True
        if concern["profile_requirement_ids"]:
            profile_derived = True

        dependency_ids: set[str] = set()
        for dependency in concern["dependencies"]:
            dependency_id = dependency["concern_id"]
            if dependency_id == concern_id:
                errors.append(f"{concern_id}: concern cannot depend on itself")
            if dependency_id not in concern_id_set:
                errors.append(f"{concern_id}: dependency does not resolve: {dependency_id}")
            if dependency_id in dependency_ids:
                errors.append(f"{concern_id}: duplicate dependency: {dependency_id}")
            dependency_ids.add(dependency_id)

    if profile["state"] == "not_selected" and profile_derived:
        errors.append("profile-derived artifacts or requirement ids require a selected profile")
    if profile["artifact_resolution_state"] != "profile_enriched" and profile_derived:
        errors.append("profile-derived fields require artifact_resolution_state=profile_enriched")
    if profile["artifact_resolution_state"] == "profile_enriched" and not profile_derived:
        errors.append("profile_enriched state requires at least one profile-derived field")

    view_ids: set[str] = set()
    for view in tracker["working_views"]:
        if view["view_id"] in view_ids:
            errors.append(f"duplicate working view id: {view['view_id']}")
        view_ids.add(view["view_id"])
        if len(view["concern_ids"]) != len(concern_ids) or set(view["concern_ids"]) != concern_id_set:
            errors.append(f"working view {view['view_id']} must be a full concern-id permutation")

    status = tracker["human_subjects_status"]
    auth_source = status["authorization_source_comment_id"]
    if auth_source is not None:
        segment = segment_by_id.get(auth_source)
        if segment is None or segment["kind"] != "comment" or auth_source not in actual_comment_ids:
            errors.append("authorization source must resolve to an accounted comment segment")

    try:
        skeleton_bytes = skeleton_path.read_bytes()
        skeleton = skeleton_bytes.decode("utf-8")
    except (OSError, UnicodeDecodeError) as exc:
        errors.append(f"response skeleton must be readable UTF-8: {exc}")
        return errors
    if _sha256(skeleton_bytes) != skeleton_meta["sha256"]:
        errors.append("response_skeleton.sha256 does not match response_skeleton.md")
    if skeleton.count(STATUS_LINE) != 1:
        errors.append("response skeleton must carry the fixed drafting-aid status exactly once")
    if skeleton.count(BOUNDARY_LINE) != 1:
        errors.append("response skeleton must carry the fixed #665 boundary exactly once")
    markers = list(MARKER.finditer(skeleton))
    marker_ids = [match.group(1) for match in markers]
    if marker_ids != concern_ids:
        errors.append("response skeleton markers must cover every concern exactly once in source order")
    for index, match in enumerate(markers):
        concern_id = match.group(1)
        end = markers[index + 1].start() if index + 1 < len(markers) else len(skeleton)
        block = skeleton[match.start() : end]
        if block.count(f"### Concern {concern_id}") != 1:
            errors.append(f"response skeleton {concern_id}: missing unique concern heading")
        if block.count(RESPONSE_PLACEHOLDER) != 1:
            errors.append(f"response skeleton {concern_id}: response placeholder must appear once")
        if block.count(EVIDENCE_PLACEHOLDER) != 1:
            errors.append(f"response skeleton {concern_id}: evidence placeholder must appear once")
    claim_scan = skeleton.replace(STATUS_LINE, "").replace(RESPONSE_PLACEHOLDER, "")
    if RESOLUTION_CLAIM.search(claim_scan):
        errors.append("response skeleton contains a resolution/approval/readiness claim")
    return errors


def main(argv: list[str] | None = None) -> int:
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument("tracker", type=Path, help="path to concern_tracker.json")
    parser.add_argument("--schema", type=Path, default=DEFAULT_SCHEMA)
    args = parser.parse_args(argv)
    errors = validate_bundle(args.tracker, args.schema)
    if errors:
        for error in errors:
            print(f"ERROR: {error}", file=sys.stderr)
        return 1
    print("Committee correspondence bundle: ok")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall