From 0b7088d0b7a3ffcddcd12d67052605f820c9b1ca Mon Sep 17 00:00:00 2001 From: Seongho Bae Date: Mon, 17 Aug 2026 18:55:02 +0900 Subject: [PATCH 1/3] feat(automation): run DiagramWeave hourly NVIDIA NIM review repair Add a thin minute-12 caller for ContextualWisdomLab/DiagramWeave on protected main. The caller maps only established scheduler credentials, grants job-scoped OIDC, and leaves NVIDIA_NIM_API_KEY on the reusable worker. --- .../diagramweave-hourly-review-repair.yml | 36 ++++ .../hourly-nvidia-nim-review-repair.yml | 7 + AGENTS.md | 1 + ARCHITECTURE.md | 5 + CHANGELOG.md | 1 + .../diagramweave-hourly-review-caller.md | 141 +++++++++++++++ .../test_diagramweave_hourly_review_caller.py | 165 ++++++++++++++++++ 7 files changed, 356 insertions(+) create mode 100644 .github/workflows/diagramweave-hourly-review-repair.yml create mode 100644 docs/doctoring/diagramweave-hourly-review-caller.md create mode 100644 tests/test_diagramweave_hourly_review_caller.py diff --git a/.github/workflows/diagramweave-hourly-review-repair.yml b/.github/workflows/diagramweave-hourly-review-repair.yml new file mode 100644 index 000000000..052f08424 --- /dev/null +++ b/.github/workflows/diagramweave-hourly-review-repair.yml @@ -0,0 +1,36 @@ +name: DiagramWeave Hourly Review Repair + +on: + schedule: + # Minute 12 avoids pg-llm-batch (1), aFIPC (2), kaefa (3), LineageWeave (4), + # codec-carver (5), life-os (6), Wardnet (7), mightyETL (8), + # psychometrics-commons (9), OriginWeave (10), naruon (11), + # pg-erd-cloud (13), orchestrator (17), noema (19), Clearfolio (23), + # Keyverse (29), Scopeweave (31), DiskSage (37), Appguardrail (41), + # newsdom-api (43), Inkspan (47), fast-mlsirm (49), BandScope (53), + # and semantic-data-portal (59). + - cron: "12 * * * *" + +concurrency: + group: diagramweave-hourly-review-repair + # A later heartbeat must not cancel an in-flight diagram-editor RCA. + cancel-in-progress: false + +permissions: + contents: read + +jobs: + dispatch-review-repair: + permissions: + contents: read + id-token: write + uses: ./.github/workflows/pr-review-fix-scheduler.yml + with: + target_repository: ContextualWisdomLab/DiagramWeave + base_branch: main + max_prs: "50" + max_dispatches: "1" + retry_hours: "2" + secrets: + PR_REVIEW_MERGE_TOKEN: ${{ secrets.PR_REVIEW_MERGE_TOKEN }} + OPENCODE_APPROVE_TOKEN: ${{ secrets.OPENCODE_APPROVE_TOKEN }} diff --git a/.github/workflows/hourly-nvidia-nim-review-repair.yml b/.github/workflows/hourly-nvidia-nim-review-repair.yml index 702942708..debd62ec6 100644 --- a/.github/workflows/hourly-nvidia-nim-review-repair.yml +++ b/.github/workflows/hourly-nvidia-nim-review-repair.yml @@ -16,6 +16,7 @@ on: - .github/workflows/nonnest2-hourly-review-repair.yml - .github/workflows/originweave-hourly-review-repair.yml - .github/workflows/quarantine-sandbox-hourly-review-repair.yml + - .github/workflows/diagramweave-hourly-review-repair.yml - scripts/ci/pr_review_conflict_scope.py - scripts/ci/pr_review_autofix_context.py - tests/test_bandscope_hourly_review_caller.py @@ -27,6 +28,7 @@ on: - tests/test_nonnest2_hourly_review_caller.py - tests/test_originweave_hourly_review_caller.py - tests/test_quarantine_sandbox_hourly_review_caller.py + - tests/test_diagramweave_hourly_review_caller.py - tests/test_hourly_autofix_context_quality_gate.py - tests/test_pr_review_conflict_scope.py - tests/test_pr_review_conflict_scope_control_files.py @@ -51,6 +53,7 @@ on: - docs/doctoring/nonnest2-hourly-review-caller.md - docs/doctoring/originweave-hourly-review-caller.md - docs/doctoring/quarantine-sandbox-hourly-review-caller.md + - docs/doctoring/diagramweave-hourly-review-caller.md push: paths: - .github/workflows/pr-review-fix-scheduler.yml @@ -66,6 +69,7 @@ on: - .github/workflows/nonnest2-hourly-review-repair.yml - .github/workflows/originweave-hourly-review-repair.yml - .github/workflows/quarantine-sandbox-hourly-review-repair.yml + - .github/workflows/diagramweave-hourly-review-repair.yml - scripts/ci/pr_review_conflict_scope.py - scripts/ci/pr_review_autofix_context.py - tests/test_bandscope_hourly_review_caller.py @@ -77,6 +81,7 @@ on: - tests/test_nonnest2_hourly_review_caller.py - tests/test_originweave_hourly_review_caller.py - tests/test_quarantine_sandbox_hourly_review_caller.py + - tests/test_diagramweave_hourly_review_caller.py - tests/test_hourly_autofix_context_quality_gate.py - tests/test_pr_review_conflict_scope.py - tests/test_pr_review_conflict_scope_control_files.py @@ -101,6 +106,7 @@ on: - docs/doctoring/nonnest2-hourly-review-caller.md - docs/doctoring/originweave-hourly-review-caller.md - docs/doctoring/quarantine-sandbox-hourly-review-caller.md + - docs/doctoring/diagramweave-hourly-review-caller.md permissions: contents: read @@ -157,6 +163,7 @@ jobs: tests/test_nonnest2_hourly_review_caller.py \ tests/test_originweave_hourly_review_caller.py \ tests/test_quarantine_sandbox_hourly_review_caller.py \ + tests/test_diagramweave_hourly_review_caller.py \ tests/test_pr_review_conflict_scope_control_files.py \ tests/test_hourly_autofix_context_quality_gate.py \ tests/test_pr_review_conflict_scope_git_executable.py \ diff --git a/AGENTS.md b/AGENTS.md index bd6a96a11..116595926 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -7,3 +7,4 @@ Materialize accepts only exact SHA-256 pins or a bounded relative `-r` include ( Conflict-scope roots fail closed when the immediate parent directory is a symbolic link. OriginWeave hourly NVIDIA NIM repair is a thin caller at minute 10. See [`docs/doctoring/originweave-hourly-review-caller.md`](docs/doctoring/originweave-hourly-review-caller.md). nonnest2 hourly NVIDIA NIM repair is a thin caller at minute 16. See [`docs/doctoring/nonnest2-hourly-review-caller.md`](docs/doctoring/nonnest2-hourly-review-caller.md). +DiagramWeave hourly NVIDIA NIM repair is a thin caller at minute 12. See [`docs/doctoring/diagramweave-hourly-review-caller.md`](docs/doctoring/diagramweave-hourly-review-caller.md). diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index 7d2bfb4a4..82f9d495f 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -36,6 +36,10 @@ only established scheduler credentials, and grants job-scoped `nonnest2-hourly-review-repair.yml` is a thin, read-only caller at minute 16. It names `ContextualWisdomLab/nonnest2` and protected `master`, maps +## DiagramWeave hourly caller + +`diagramweave-hourly-review-repair.yml` is a thin, read-only caller at minute +12. It names `ContextualWisdomLab/DiagramWeave` and protected `main`, maps only established scheduler credentials, and grants job-scoped `id-token: write`. The reusable engine stays product-neutral. @@ -111,6 +115,7 @@ CI installs Python tools only with `pip install --require-hashes`. Contract tests pin workflow structure and governance prose so drift fails closed. The trusted `uv` exporter is downloaded from the literal GitHub Releases URL for `uv` 0.12.1; `releases.astral.sh` is not the network sink. +tests pin workflow structure and governance prose so drift fails closed. ## Related durable documents diff --git a/CHANGELOG.md b/CHANGELOG.md index 7d2f9f24d..153b173b8 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,6 +12,7 @@ Semantic Versioning where the repository publishes a release. - Added a dedicated Quarantine Sandbox Runtime hourly caller at minute 14 that targets protected `develop`, dispatches at most one exact-head repair, applies a two-hour same-head retry floor, preserves non-cancelling single-flight execution, and maps only the established scheduler credentials with job-scoped OIDC. - Added a dedicated Quarantine Sandbox Runtime hourly caller at minute 14 that targets protected `develop`, dispatches at most one exact-head repair, applies a two-hour same-head retry floor, preserves non-cancelling single-flight execution, and maps only the established scheduler credentials with job-scoped OIDC. - Added a dedicated OriginWeave hourly caller that invokes the product-neutral central scheduler with the exact repository, protected `main` branch, one-dispatch budget, two-hour same-head retry floor, non-cancelling single-flight heartbeat, job-scoped OIDC, and only the established scheduler credentials. +- Added a dedicated DiagramWeave hourly caller that invokes the product-neutral central scheduler with the exact repository, protected `main` branch, one-dispatch budget, two-hour same-head retry floor, non-cancelling single-flight heartbeat, job-scoped OIDC, and only the established scheduler credentials. - Added a trusted pull-request comment router for `@cwl-noema-review` and review-only `@opencode-agent` dispatches, with an organization sweep, exact-head receipts, repository allowlisting, fixed runners, immutable checkout pins, and a permanent 100% statement/branch/docstring quality gate. - Added exact-base `uv.lock` materialization that reconstructs standalone nested projects with a checksum-pinned official `uv` exporter, isolated frozen/offline execution, strict exact-pin and SHA-256 output validation, and complete Python 3.10/3.14 quality evidence. - Added a permanent exact-head contract workflow for the hourly review-repair scheduler, immutable reusable-workflow source, NVIDIA NIM model boundary, credential isolation, and fail-closed unattended-agent permissions. diff --git a/docs/doctoring/diagramweave-hourly-review-caller.md b/docs/doctoring/diagramweave-hourly-review-caller.md new file mode 100644 index 000000000..7fa714a50 --- /dev/null +++ b/docs/doctoring/diagramweave-hourly-review-caller.md @@ -0,0 +1,141 @@ +# DiagramWeave hourly review-repair caller + +검토 기준일: **2026-08-17** + +## Decision + +ContextualWisdomLab operates one protected hourly caller for +`ContextualWisdomLab/DiagramWeave` (an AI-native source editor for diagrams +with adaptive orchestration, exact-head product CI, and fail-closed no-op +rejection). The caller runs at minute 12, delegates to the +product-neutral central review-fix scheduler, inspects at most 50 open +pull requests targeting protected `main`, and dispatches at most one +bounded repair per heartbeat. + +A paying buyer of an AI-native diagram editor would feel live DiagramWeave +pull requests stalling while hourly NVIDIA NIM repair scanned only +Clearfolio, DiskSage, and fast-mlsirm. Live heads such as +ContextualWisdomLab/DiagramWeave#31 (explicit adaptive orchestration), +ContextualWisdomLab/DiagramWeave#30 (adaptive orchestration for edit +proposals), and ContextualWisdomLab/DiagramWeave#26 (reject no-op hourly +product runs) target `main` and never enter those other callers. + +The caller does not implement review or mutation logic itself. +DiagramWeave remains standalone; naruon and contextual-orchestrator may +import its editor as a module without owning the diagram runtime. +Privileged automation stays in `ContextualWisdomLab/.github`. + +## Root-cause analysis and remediation feasibility + +The reusable worker performs exact-head root-cause analysis and tests +remediation feasibility before it edits. The reusable worker must: + +1. Refetch the exact live head, base, reviews, checks, changed paths, and + writer state. +2. Establish the causal chain rather than repeat the terminal symptom. +3. Enumerate materially distinct minimal remedies. +4. Reject remedies that lack writer authority, cross sealed paths, require + unavailable credentials or protected-setting changes, violate stack + order, cannot be verified, or do not alter the diagnosed cause. +5. Dispatch at most one feasible repair. Otherwise leave the tree + unchanged. + +A queued or pending check remains a merge blocker but is not itself a +code finding. The independent non-author approval remains an external +authorization gate and is never synthesized by the repair worker. The +worker cannot approve, merge, release, resolve review findings by +inference, change protection, or manufacture passing checks. + +## Cadence and concurrency + +The caller uses a single concurrency group and `cancel-in-progress: false`. +This preserves an in-flight bounded RCA instead of discarding diagram +editor evidence when the next hourly heartbeat arrives. The reusable +scheduler cancels only its own superseded short queue scan. + +The caller sets a **two-hour same-head retry floor**. Central OpenCode and +NVIDIA NIM work, plus adaptive-orchestration or no-op-fallback analysis, +can legitimately approach two hours. An hourly redispatch of the same +unchanged head would create duplicate writer pressure rather than faster +remediation. + +GitHub scheduled workflows can be delayed under load and execute only +from the default branch. The cron expression is a heartbeat, not a +real-time SLA. + +## Credential and model boundary + +The caller keeps workflow `GITHUB_TOKEN` at `contents: read` and grants +the reusable job `id-token: write` so the central scheduler can mint the +OpenCode GitHub App token from GitHub OIDC when the mapped PAT is absent +(GitHub, n.d.-c). It maps only `PR_REVIEW_MERGE_TOKEN` and +`OPENCODE_APPROVE_TOKEN`. It never uses `secrets: inherit`, receives +`NVIDIA_NIM_API_KEY`, or introduces `COPILOT_GITHUB_TOKEN`. CWE-250 +forbids executing the caller with write or model privileges it does not +need (MITRE, 2026). + +Model execution remains inside the central worker. The model credential +is the GitHub Secret `NVIDIA_NIM_API_KEY`; the caller does not receive or +forward it. + +Before protected-main activation, the repository variable +`OPENCODE_REPOSITORY_DISPATCH_TARGETS` must contain the exact +`ContextualWisdomLab/DiagramWeave` target. Missing or mismatched +configuration fails before mutation credential materialization. + +## Security, standalone operation, and modularity + +The caller adds no DiagramWeave runtime dependency, database object, +network endpoint, tenant authority, or product credential. DiagramWeave +continues to run as a standalone diagram source editor. Naruon, +contextual-orchestrator, and other CWL services may import it as a +module, but they cannot weaken its exact-head, approval, or security +gates. + +## Verification and rollback + +Machine-checkable contracts require the exact target/base, minute 12 +cadence, non-cancelling single-flight group, one dispatch, two-hour +retry floor, explicit secret mapping, read-only contents plus job-scoped +`id-token: write`, focused path-filter coverage, and absence of model or +Copilot credentials. Independent `pull_request`, `push`, and `compileall` +path blocks must each name the caller, doctoring, or contract they own. + +After source integration, closure requires a scheduled or manual +protected-main consumer run proving the exact DiagramWeave repository and +`main` base. Source checks alone are not protected-main operational acceptance. +Merge still requires zero unresolved valid findings and a +qualifying independent non-author approval. + +Rollback removes the DiagramWeave caller, its focused test, doctoring, and +central path-filter/documentation entries. It must not remove scheduler +dispatch validation or affect independent product callers. + +## APA 7th references + +GitHub, Inc. (n.d.-a). *Events that trigger workflows*. GitHub Docs. +Retrieved August 17, 2026, from +https://docs.github.com/en/actions/reference/workflows-and-actions/events-that-trigger-workflows#schedule + +GitHub, Inc. (n.d.-b). *Reuse workflows*. GitHub Docs. Retrieved August +17, 2026, from +https://docs.github.com/en/actions/how-tos/sharing-automations/reuse-workflows + +GitHub, Inc. (n.d.-c). *Automatic token authentication*. GitHub Docs. +Retrieved August 17, 2026, from +https://docs.github.com/en/actions/security-for-github-actions/security-guides/automatic-token-authentication#permissions-for-the-github_token + +MITRE. (2026). *CWE-250: Execution with unnecessary privileges*. +https://cwe.mitre.org/data/definitions/250.html + +National Institute of Standards and Technology. (2022). *Secure software +development framework (SSDF) version 1.1: Recommendations for mitigating +the risk of software vulnerabilities* (NIST Special Publication 800-218). +https://doi.org/10.6028/NIST.SP.800-218 + +NVIDIA. (n.d.). *NVIDIA NIM for large language models documentation*. +Retrieved August 17, 2026, from +https://docs.nvidia.com/nim/large-language-models/latest/ + +OpenCode. (n.d.). *OpenCode documentation*. Retrieved August 17, 2026, +from https://opencode.ai/docs/ diff --git a/tests/test_diagramweave_hourly_review_caller.py b/tests/test_diagramweave_hourly_review_caller.py new file mode 100644 index 000000000..6134300f0 --- /dev/null +++ b/tests/test_diagramweave_hourly_review_caller.py @@ -0,0 +1,165 @@ +"""Contract tests for DiagramWeave's bounded hourly review-repair caller.""" + +from pathlib import Path + + +CALLER = Path(".github/workflows/diagramweave-hourly-review-repair.yml") +DOCTORING = Path("docs/doctoring/diagramweave-hourly-review-caller.md") +QUALITY_WORKFLOW = Path(".github/workflows/hourly-nvidia-nim-review-repair.yml") +SCHEDULER = Path(".github/workflows/pr-review-fix-scheduler.yml") + + +def _read(path: Path) -> str: + """Return one repository contract file as UTF-8 text.""" + return path.read_text(encoding="utf-8") + + +def _yaml_path_entries(block: str) -> set[str]: + """Return dashed YAML path entries from one trigger or compileall block.""" + entries: set[str] = set() + for raw_line in block.splitlines(): + stripped = raw_line.strip() + if stripped.startswith("- "): + entries.add(stripped[2:].strip()) + elif stripped.startswith("tests/") or stripped.startswith("scripts/"): + entries.add(stripped.rstrip(" \\")) + return entries + + +def _trigger_path_block(quality: str, trigger: str) -> str: + """Return the dashed path list under one named workflow trigger.""" + marker = f" {trigger}:\n paths:\n" + start = quality.index(marker) + len(marker) + lines: list[str] = [] + for line in quality[start:].splitlines(): + if line.startswith(" - "): + lines.append(line) + continue + if line.strip() == "": + continue + break + return "\n".join(lines) + + +def _compileall_block(quality: str) -> str: + """Return the compileall argument list from the focused quality job.""" + marker = "python -m compileall -q \\" + start = quality.index(marker) + remainder = quality[start:] + end = remainder.find("\n git ") + return remainder if end < 0 else remainder[:end] + + +def test_diagramweave_caller_is_hourly_bounded_and_non_cancelling() -> None: + """DiagramWeave receives one realistic diagram-editor repair without cancellation.""" + caller = _read(CALLER) + + assert 'cron: "12 * * * *"' in caller + assert "group: diagramweave-hourly-review-repair" in caller + assert "cancel-in-progress: false" in caller + assert "uses: ./.github/workflows/pr-review-fix-scheduler.yml" in caller + assert "target_repository: ContextualWisdomLab/DiagramWeave" in caller + assert "base_branch: main" in caller + assert 'max_prs: "50"' in caller + assert 'max_dispatches: "1"' in caller + assert 'retry_hours: "2"' in caller + + +def test_diagramweave_caller_preserves_oidc_and_explicit_secret_scope() -> None: + """The queue scanner maps established credentials without model secrets.""" + caller = _read(CALLER) + workflow_scope, jobs_scope = caller.split("\njobs:\n", maxsplit=1) + + assert "\npermissions:\n contents: read\n" in workflow_scope + assert ( + "\n permissions:\n contents: read\n id-token: write\n" + in jobs_scope + ) + assert "PR_REVIEW_MERGE_TOKEN: ${{ secrets.PR_REVIEW_MERGE_TOKEN }}" in caller + assert "OPENCODE_APPROVE_TOKEN: ${{ secrets.OPENCODE_APPROVE_TOKEN }}" in caller + assert "secrets: inherit" not in caller + assert "NVIDIA_NIM_API_KEY" not in caller + assert "COPILOT_GITHUB_TOKEN" not in caller + for forbidden in ( + "actions: write", + "contents: write", + "issues: write", + "pull-requests: write", + "statuses: write", + ): + assert forbidden not in caller + + +def test_diagramweave_target_is_not_hard_coded_in_shared_scheduler() -> None: + """Product identity remains in the thin caller rather than the engine.""" + assert "ContextualWisdomLab/DiagramWeave" not in _read(SCHEDULER) + + +def test_diagramweave_doctoring_records_editor_activation_and_credentials() -> None: + """Operators retain target-allowlist, diagram editor, and approval prerequisites.""" + doctoring = _read(DOCTORING) + + for phrase in ( + "ContextualWisdomLab/DiagramWeave", + "OPENCODE_REPOSITORY_DISPATCH_TARGETS", + "independent non-author approval", + "NVIDIA_NIM_API_KEY", + "COPILOT_GITHUB_TOKEN", + "id-token: write", + "two-hour same-head retry floor", + "root-cause analysis", + "remediation feasibility", + "protected-main operational acceptance", + "APA 7th references", + "ContextualWisdomLab/DiagramWeave#31", + "ContextualWisdomLab/DiagramWeave#30", + "ContextualWisdomLab/DiagramWeave#26", + ): + assert phrase in doctoring + + +def test_path_block_helpers_keep_trigger_and_compileall_sets_disjoint() -> None: + """A path listed only under push or compileall must not satisfy pull_request.""" + quality = ( + "on:\n" + " pull_request:\n" + " paths:\n" + " - .github/workflows/diagramweave-hourly-review-repair.yml\n" + " push:\n" + " paths:\n" + " - docs/doctoring/diagramweave-hourly-review-caller.md\n" + " python -m compileall -q \\\n" + " tests/test_diagramweave_hourly_review_caller.py\n" + " git diff --check\n" + ) + + pull_request_paths = _yaml_path_entries(_trigger_path_block(quality, "pull_request")) + push_paths = _yaml_path_entries(_trigger_path_block(quality, "push")) + compileall_paths = _yaml_path_entries(_compileall_block(quality)) + + assert pull_request_paths == {".github/workflows/diagramweave-hourly-review-repair.yml"} + assert push_paths == {"docs/doctoring/diagramweave-hourly-review-caller.md"} + assert compileall_paths == {"tests/test_diagramweave_hourly_review_caller.py"} + assert "docs/doctoring/diagramweave-hourly-review-caller.md" not in pull_request_paths + assert ".github/workflows/diagramweave-hourly-review-repair.yml" not in compileall_paths + + +def test_focused_quality_workflow_tracks_diagramweave_contracts() -> None: + """Caller, test, and doctoring edits always rerun the focused gate.""" + quality = _read(QUALITY_WORKFLOW) + pull_request_paths = _yaml_path_entries(_trigger_path_block(quality, "pull_request")) + push_paths = _yaml_path_entries(_trigger_path_block(quality, "push")) + compileall_paths = _yaml_path_entries(_compileall_block(quality)) + caller = ".github/workflows/diagramweave-hourly-review-repair.yml" + doctoring = "docs/doctoring/diagramweave-hourly-review-caller.md" + contract = "tests/test_diagramweave_hourly_review_caller.py" + + assert caller in pull_request_paths + assert doctoring in pull_request_paths + assert contract in pull_request_paths + assert caller in push_paths + assert doctoring in push_paths + assert contract in push_paths + assert contract in compileall_paths + assert caller not in compileall_paths + assert doctoring not in compileall_paths From f594cdaec64ce9448c1d85bf3fd52d31a767a3e9 Mon Sep 17 00:00:00 2001 From: Seongho Bae Date: Thu, 20 Aug 2026 11:05:17 -0700 Subject: [PATCH 2/3] docs(diagramweave): restore durable caller contracts --- ARCHITECTURE.md | 6 +++-- .../diagramweave-hourly-review-caller.md | 6 ++--- .../test_diagramweave_hourly_review_caller.py | 24 +++++++++++++++++++ 3 files changed, 31 insertions(+), 5 deletions(-) diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index 82f9d495f..a9369a85e 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -36,6 +36,9 @@ only established scheduler credentials, and grants job-scoped `nonnest2-hourly-review-repair.yml` is a thin, read-only caller at minute 16. It names `ContextualWisdomLab/nonnest2` and protected `master`, maps +only established scheduler credentials, and grants job-scoped +`id-token: write`. The reusable engine stays product-neutral. + ## DiagramWeave hourly caller `diagramweave-hourly-review-repair.yml` is a thin, read-only caller at minute @@ -115,7 +118,6 @@ CI installs Python tools only with `pip install --require-hashes`. Contract tests pin workflow structure and governance prose so drift fails closed. The trusted `uv` exporter is downloaded from the literal GitHub Releases URL for `uv` 0.12.1; `releases.astral.sh` is not the network sink. -tests pin workflow structure and governance prose so drift fails closed. ## Related durable documents @@ -130,4 +132,4 @@ tests pin workflow structure and governance prose so drift fails closed. - [`docs/doctoring/hourly-nvidia-nim-autofix.md`](docs/doctoring/hourly-nvidia-nim-autofix.md) — current increment's repair-worker decision and APA 7th citations. - [`docs/doctoring/fast-mlsirm-hourly-review-caller.md`](docs/doctoring/fast-mlsirm-hourly-review-caller.md) - — product-specific psychometric repair heartbeat and scientific gates. \ No newline at end of file + — product-specific psychometric repair heartbeat and scientific gates. diff --git a/docs/doctoring/diagramweave-hourly-review-caller.md b/docs/doctoring/diagramweave-hourly-review-caller.md index 7fa714a50..981c011c7 100644 --- a/docs/doctoring/diagramweave-hourly-review-caller.md +++ b/docs/doctoring/diagramweave-hourly-review-caller.md @@ -70,9 +70,9 @@ the reusable job `id-token: write` so the central scheduler can mint the OpenCode GitHub App token from GitHub OIDC when the mapped PAT is absent (GitHub, n.d.-c). It maps only `PR_REVIEW_MERGE_TOKEN` and `OPENCODE_APPROVE_TOKEN`. It never uses `secrets: inherit`, receives -`NVIDIA_NIM_API_KEY`, or introduces `COPILOT_GITHUB_TOKEN`. CWE-250 -forbids executing the caller with write or model privileges it does not -need (MITRE, 2026). +`NVIDIA_NIM_API_KEY`, or introduces `COPILOT_GITHUB_TOKEN`. The caller applies +least privilege to prevent CWE-250 by excluding write and model privileges it +does not need (MITRE, 2026). Model execution remains inside the central worker. The model credential is the GitHub Secret `NVIDIA_NIM_API_KEY`; the caller does not receive or diff --git a/tests/test_diagramweave_hourly_review_caller.py b/tests/test_diagramweave_hourly_review_caller.py index 6134300f0..0e7434565 100644 --- a/tests/test_diagramweave_hourly_review_caller.py +++ b/tests/test_diagramweave_hourly_review_caller.py @@ -5,6 +5,7 @@ CALLER = Path(".github/workflows/diagramweave-hourly-review-repair.yml") DOCTORING = Path("docs/doctoring/diagramweave-hourly-review-caller.md") +ARCHITECTURE = Path("ARCHITECTURE.md") QUALITY_WORKFLOW = Path(".github/workflows/hourly-nvidia-nim-review-repair.yml") SCHEDULER = Path(".github/workflows/pr-review-fix-scheduler.yml") @@ -118,6 +119,29 @@ def test_diagramweave_doctoring_records_editor_activation_and_credentials() -> N assert phrase in doctoring +def test_diagramweave_docs_preserve_neighboring_architecture_and_least_privilege() -> None: + """Adding DiagramWeave must not truncate adjacent durable governance prose.""" + architecture = _read(ARCHITECTURE) + doctoring = _read(DOCTORING) + normalized_doctoring = " ".join(doctoring.split()) + nonnest2_contract = ( + "`nonnest2-hourly-review-repair.yml` is a thin, read-only caller at minute\n" + "16. It names `ContextualWisdomLab/nonnest2` and protected `master`, maps\n" + "only established scheduler credentials, and grants job-scoped\n" + "`id-token: write`. The reusable engine stays product-neutral." + ) + + assert nonnest2_contract in architecture + assert architecture.index(nonnest2_contract) < architecture.index( + "## DiagramWeave hourly caller" + ) + assert architecture.count( + "tests pin workflow structure and governance prose so drift fails closed." + ) == 1 + assert "The caller applies least privilege to prevent CWE-250" in normalized_doctoring + assert "CWE-250 forbids" not in doctoring + + def test_path_block_helpers_keep_trigger_and_compileall_sets_disjoint() -> None: """A path listed only under push or compileall must not satisfy pull_request.""" quality = ( From 455f2e76f15c5d0e7040777fc22ea4994d850925 Mon Sep 17 00:00:00 2001 From: Seongho Bae Date: Sat, 22 Aug 2026 04:19:29 +0900 Subject: [PATCH 3/3] ci: refresh pip audit runtime --- requirements-pip-audit-ci-hashes.txt | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/requirements-pip-audit-ci-hashes.txt b/requirements-pip-audit-ci-hashes.txt index ade197a49..0ae099d8f 100644 --- a/requirements-pip-audit-ci-hashes.txt +++ b/requirements-pip-audit-ci-hashes.txt @@ -213,9 +213,9 @@ packaging==26.2 \ # via # pip-audit # pip-requirements-parser -pip==26.1.2 \ - --hash=sha256:382ff9f685ee3bc25864f820aa50505825f10f5458ffff07e30a6d96e5715cab \ - --hash=sha256:f49cd134c61cf2fd75e0ce2676db03e4054504a5a4986d00f8299ae632dc4605 +pip==26.2.1 \ + --hash=sha256:71138adf1f4ca900cdb7d289c21b7494329f2332b6d85f0e1c42108c0384ed3e \ + --hash=sha256:f6ad667e89a1fe78046c8f13232b247200f5258d7828f3f7883d660878e0813f # via pip-api pip-api==0.0.34 \ --hash=sha256:8b2d7d7c37f2447373aa2cf8b1f60a2f2b27a84e1e9e0294a3f6ef10eb3ba6bb \