Skip to content

Add audit warning when CLAWSEC_VERIFY_CHECKSUM_MANIFEST is disabled#100

Open
davida-ps wants to merge 3 commits intomainfrom
auto-claude/009-add-audit-warning-when-clawsec-verify-checksum-man
Open

Add audit warning when CLAWSEC_VERIFY_CHECKSUM_MANIFEST is disabled#100
davida-ps wants to merge 3 commits intomainfrom
auto-claude/009-add-audit-warning-when-clawsec-verify-checksum-man

Conversation

@davida-ps
Copy link
Collaborator

@davida-ps davida-ps commented Mar 2, 2026

User description

Opener Type

  • Human
  • Agent (automated)

Summary

Add audit warnings when CLAWSEC_VERIFY_CHECKSUM_MANIFEST=0 is enabled to improve visibility of security-relevant configuration changes. The checksum manifest verification layer provides defense-in-depth beyond signature verification, and disabling it should be explicitly logged to prevent accidental long-term degradation of feed integrity verification.

Changes Made

  • Added audit warning in guarded_skill_install.mjs to stderr when checksum manifest verification is disabled
  • Added audit warning in handler.ts with once-only flag pattern to prevent repeated warnings during the command lifecycle
  • Updated CHANGELOG.md with new version 0.1.4 and security enhancements
  • Bumped skill.json version from 0.1.3 to 0.1.4

Related Issues


Type of Change

  • Bug fix (non-breaking change that fixes an issue)
  • New feature (non-breaking change that adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update
  • Security incident (please open a Security Incident Report issue instead of a PR)

Testing

Checklist

  • My code follows the project's style guidelines
  • I have performed a self-review of my changes
  • I have added tests that prove my fix/feature works
  • New and existing tests pass locally

Generated description

Below is a concise technical summary of the changes proposed in this PR:
Implements audit warnings to notify operators when CLAWSEC_VERIFY_CHECKSUM_MANIFEST is disabled, ensuring visibility into security-relevant configuration changes. Updates the suite version and changelog to reflect these security enhancements.

TopicDetails
Metadata & Docs Increments the version to 0.1.4 and documents the new security visibility features in the changelog.
Modified files (2)
  • skills/clawsec-suite/CHANGELOG.md
  • skills/clawsec-suite/skill.json
Latest Contributors(2)
UserCommitDate
david.a@prompt.securityExploitability-Context...March 01, 2026
aldo@osstek.comfix-portability-harden...February 25, 2026
Audit Warnings Adds logic to handler.ts and guarded_skill_install.mjs to emit warnings when checksum verification is bypassed, including a once-only flag to prevent log spam.
Modified files (2)
  • skills/clawsec-suite/hooks/clawsec-advisory-guardian/handler.ts
  • skills/clawsec-suite/scripts/guarded_skill_install.mjs
Latest Contributors(2)
UserCommitDate
aldo@osstek.comfix-portability-harden...February 25, 2026
david.a@prompt.securitySecurity-Audit-Suppres...February 16, 2026
This pull request is reviewed by Baz. Review like a pro on (Baz).

davida-ps and others added 3 commits February 27, 2026 20:31
…uested)

Fixes:
- Bumped version from 0.1.3 to 0.1.4 in skill.json
- Added 0.1.4 release entry to CHANGELOG.md documenting audit warning feature
- Already rebased on origin/main (382db82)

Changes document the new CLAWSEC_VERIFY_CHECKSUM_MANIFEST=0 audit warnings
for release pipeline compatibility.

Verified:
- All tests pass (8/8 guarded_install tests)
- ESLint clean with --max-warnings 0

QA Fix Session: 0

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Comment on lines +149 to +152
if (!verifyChecksumManifest) {
process.stderr.write(
"WARNING: CLAWSEC_VERIFY_CHECKSUM_MANIFEST=0 is enabled. Checksum verification for the advisory feed manifest is disabled. This reduces security guarantees.\n",
);
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The CLAWSEC_VERIFY_CHECKSUM_MANIFEST=0 bypass warning is implemented twice: the same env var check and warning text exist at lines 149‑152 here and at lines 163‑170 of hooks/clawsec-advisory-guardian/handler.ts. Can we extract a shared helper in skills/clawsec-suite (e.g. lib/env-warnings or similar) so both the hook and the install script reuse the same once-per-process guard and message instead of duplicating the logic?

Finding type: Code Dedup and Conventions


Want Baz to fix this for you? Activate Fixer

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant