repomarshal 0.1.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- repomarshal-0.1.0/.gitignore +9 -0
- repomarshal-0.1.0/LICENSE +202 -0
- repomarshal-0.1.0/PKG-INFO +253 -0
- repomarshal-0.1.0/README.md +223 -0
- repomarshal-0.1.0/docs/STATUS.md +125 -0
- repomarshal-0.1.0/docs/UPSTREAM_PROVENANCE.md +151 -0
- repomarshal-0.1.0/docs/adr/001-core-language.md +85 -0
- repomarshal-0.1.0/docs/adr/002-provider-integration.md +57 -0
- repomarshal-0.1.0/docs/adr/003-agent-interoperability.md +49 -0
- repomarshal-0.1.0/docs/adr/004-evidence-model.md +53 -0
- repomarshal-0.1.0/docs/adr/005-change-planner.md +58 -0
- repomarshal-0.1.0/docs/architecture.md +495 -0
- repomarshal-0.1.0/docs/demo/claude-code-humanize.md +153 -0
- repomarshal-0.1.0/docs/evaluation.md +473 -0
- repomarshal-0.1.0/docs/guides/ci.md +341 -0
- repomarshal-0.1.0/docs/guides/release.md +78 -0
- repomarshal-0.1.0/docs/guides/waivers.md +242 -0
- repomarshal-0.1.0/docs/product-definition.md +204 -0
- repomarshal-0.1.0/docs/research/ecosystem-comparison.md +106 -0
- repomarshal-0.1.0/docs/research/gap-analysis.md +188 -0
- repomarshal-0.1.0/docs/research/notes/README.md +22 -0
- repomarshal-0.1.0/docs/research/notes/additional-discoveries.md +245 -0
- repomarshal-0.1.0/docs/research/notes/agentrig-mcp.md +318 -0
- repomarshal-0.1.0/docs/research/notes/competitors-verification.md +459 -0
- repomarshal-0.1.0/docs/research/notes/context-skills.md +416 -0
- repomarshal-0.1.0/docs/research/notes/preloop.md +50 -0
- repomarshal-0.1.0/docs/research/notes/security-runtime.md +444 -0
- repomarshal-0.1.0/docs/roadmap.md +140 -0
- repomarshal-0.1.0/docs/security/threat-model.md +349 -0
- repomarshal-0.1.0/pyproject.toml +63 -0
- repomarshal-0.1.0/src/repomarshal/__init__.py +3 -0
- repomarshal-0.1.0/src/repomarshal/__main__.py +3 -0
- repomarshal-0.1.0/src/repomarshal/anchor.py +143 -0
- repomarshal-0.1.0/src/repomarshal/api.py +299 -0
- repomarshal-0.1.0/src/repomarshal/ci.py +672 -0
- repomarshal-0.1.0/src/repomarshal/cli.py +341 -0
- repomarshal-0.1.0/src/repomarshal/context.py +314 -0
- repomarshal-0.1.0/src/repomarshal/decisions.py +456 -0
- repomarshal-0.1.0/src/repomarshal/doctor.py +352 -0
- repomarshal-0.1.0/src/repomarshal/evidence.py +45 -0
- repomarshal-0.1.0/src/repomarshal/git.py +789 -0
- repomarshal-0.1.0/src/repomarshal/hooks.py +509 -0
- repomarshal-0.1.0/src/repomarshal/initcmd.py +217 -0
- repomarshal-0.1.0/src/repomarshal/inventory.py +1140 -0
- repomarshal-0.1.0/src/repomarshal/mcp_server.py +447 -0
- repomarshal-0.1.0/src/repomarshal/model.py +453 -0
- repomarshal-0.1.0/src/repomarshal/native.py +234 -0
- repomarshal-0.1.0/src/repomarshal/planner.py +58 -0
- repomarshal-0.1.0/src/repomarshal/policy.py +323 -0
- repomarshal-0.1.0/src/repomarshal/providers/__init__.py +78 -0
- repomarshal-0.1.0/src/repomarshal/providers/_common.py +106 -0
- repomarshal-0.1.0/src/repomarshal/providers/playwright.py +424 -0
- repomarshal-0.1.0/src/repomarshal/providers/skillspector.py +374 -0
- repomarshal-0.1.0/src/repomarshal/render.py +80 -0
- repomarshal-0.1.0/src/repomarshal/runner.py +245 -0
- repomarshal-0.1.0/src/repomarshal/schemas/evidence.schema.json +251 -0
- repomarshal-0.1.0/src/repomarshal/schemas/plan.schema.json +533 -0
- repomarshal-0.1.0/src/repomarshal/signals.py +1955 -0
- repomarshal-0.1.0/src/repomarshal/skills.py +187 -0
- repomarshal-0.1.0/src/repomarshal/verdict.py +121 -0
- repomarshal-0.1.0/src/repomarshal/waivers.py +932 -0
- repomarshal-0.1.0/src/repomarshal/waiversig.py +221 -0
- repomarshal-0.1.0/src/repomarshal/workspace.py +566 -0
- repomarshal-0.1.0/tests/__init__.py +0 -0
- repomarshal-0.1.0/tests/acceptance/__init__.py +0 -0
- repomarshal-0.1.0/tests/acceptance/conftest.py +304 -0
- repomarshal-0.1.0/tests/acceptance/test_binding.py +94 -0
- repomarshal-0.1.0/tests/acceptance/test_cli.py +97 -0
- repomarshal-0.1.0/tests/acceptance/test_honesty.py +228 -0
- repomarshal-0.1.0/tests/acceptance/test_inventory.py +51 -0
- repomarshal-0.1.0/tests/acceptance/test_scenario_a.py +60 -0
- repomarshal-0.1.0/tests/acceptance/test_scenario_b.py +55 -0
- repomarshal-0.1.0/tests/acceptance/test_scenario_c.py +89 -0
- repomarshal-0.1.0/tests/acceptance/test_tamper.py +136 -0
- repomarshal-0.1.0/tests/acceptance/test_waivers.py +176 -0
- repomarshal-0.1.0/tests/field/__init__.py +0 -0
- repomarshal-0.1.0/tests/field/conftest.py +16 -0
- repomarshal-0.1.0/tests/field/field_eval.py +204 -0
- repomarshal-0.1.0/tests/field/test_field_findings.py +411 -0
- repomarshal-0.1.0/tests/fixtures/conftest.py +3 -0
- repomarshal-0.1.0/tests/fixtures/field/click-pyproject/README.md +16 -0
- repomarshal-0.1.0/tests/fixtures/field/click-pyproject/base/.github/workflows/tests.yaml +9 -0
- repomarshal-0.1.0/tests/fixtures/field/click-pyproject/base/docs/utils.md +3 -0
- repomarshal-0.1.0/tests/fixtures/field/click-pyproject/base/pyproject.toml +21 -0
- repomarshal-0.1.0/tests/fixtures/field/click-pyproject/base/src/clicklike/__init__.py +1 -0
- repomarshal-0.1.0/tests/fixtures/field/click-pyproject/base/src/clicklike/core.py +5 -0
- repomarshal-0.1.0/tests/fixtures/field/click-pyproject/base/tests/test_types.py +9 -0
- repomarshal-0.1.0/tests/fixtures/field/click-pyproject/change-ci/.github/workflows/tests.yaml +9 -0
- repomarshal-0.1.0/tests/fixtures/field/click-pyproject/change-docs/docs/utils.md +3 -0
- repomarshal-0.1.0/tests/fixtures/field/click-pyproject/change-src/src/clicklike/core.py +8 -0
- repomarshal-0.1.0/tests/fixtures/field/click-pyproject/change-tests-split/tests/test_types/__init__.py +0 -0
- repomarshal-0.1.0/tests/fixtures/field/click-pyproject/change-tests-split/tests/test_types/test_choice.py +5 -0
- repomarshal-0.1.0/tests/fixtures/field/click-pyproject/change-tests-split/tests/test_types/test_path.py +5 -0
- repomarshal-0.1.0/tests/fixtures/field/click-pyproject/change-tests-split.deleted +1 -0
- repomarshal-0.1.0/tests/fixtures/field/conftest.py +3 -0
- repomarshal-0.1.0/tests/fixtures/field/express-like/README.md +12 -0
- repomarshal-0.1.0/tests/fixtures/field/express-like/base/.npmrc +1 -0
- repomarshal-0.1.0/tests/fixtures/field/express-like/base/lib/response.js +5 -0
- repomarshal-0.1.0/tests/fixtures/field/express-like/base/package.json +18 -0
- repomarshal-0.1.0/tests/fixtures/field/express-like/base/test/res.send.js +10 -0
- repomarshal-0.1.0/tests/fixtures/field/express-like/change-deps/package.json +18 -0
- repomarshal-0.1.0/tests/fixtures/field/express-like/change-npmrc/.npmrc +4 -0
- repomarshal-0.1.0/tests/fixtures/field/express-like/change-src/lib/response.js +6 -0
- repomarshal-0.1.0/tests/fixtures/field/express-like/change-src/test/res.send.js +14 -0
- repomarshal-0.1.0/tests/fixtures/field/rich-makefile/README.md +15 -0
- repomarshal-0.1.0/tests/fixtures/field/rich-makefile/base/Makefile +6 -0
- repomarshal-0.1.0/tests/fixtures/field/rich-makefile/base/pyproject.toml +16 -0
- repomarshal-0.1.0/tests/fixtures/field/rich-makefile/base/richlike/__init__.py +0 -0
- repomarshal-0.1.0/tests/fixtures/field/rich-makefile/base/richlike/cells.py +2 -0
- repomarshal-0.1.0/tests/fixtures/field/rich-makefile/base/tests/__init__.py +0 -0
- repomarshal-0.1.0/tests/fixtures/field/rich-makefile/base/tests/pytest.ini +2 -0
- repomarshal-0.1.0/tests/fixtures/field/rich-makefile/base/tests/test_cells.py +5 -0
- repomarshal-0.1.0/tests/fixtures/field/rich-makefile/change-dependency/pyproject.toml +16 -0
- repomarshal-0.1.0/tests/fixtures/field/rich-makefile/change-python-floor/pyproject.toml +16 -0
- repomarshal-0.1.0/tests/fixtures/field/rich-makefile/change-python-floor/richlike/cells.py +3 -0
- repomarshal-0.1.0/tests/fixtures/field/rich-makefile/change-src/richlike/cells.py +2 -0
- repomarshal-0.1.0/tests/fixtures/field/rich-makefile/change-test/tests/test_cells.py +5 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/README.md +24 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/base/.github/scripts/npm-stage-publish.sh +3 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/base/.github/workflows/release.yml +8 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/base/package.json +13 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/base/packages/docs/components/ecosystem.tsx +3 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/base/packages/docs/package.json +10 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/base/packages/tsc/package.json +8 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/base/packages/tsc/src/index.ts +1 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/base/packages/zod/package.json +8 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/base/packages/zod/src/v4/classic/tests/error.test.ts +6 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/base/packages/zod/src/v4/core/schemas.ts +3 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/base/pnpm-lock.yaml +10 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/base/vitest.config.ts +11 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/change-ci-script/.github/scripts/npm-stage-publish.sh +4 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/change-deps/packages/docs/package.json +10 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/change-deps/pnpm-lock.yaml +10 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/change-lockfile/pnpm-lock.yaml +10 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/change-site/packages/docs/components/ecosystem.tsx +3 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/change-src/packages/zod/src/v4/core/schemas.ts +4 -0
- repomarshal-0.1.0/tests/fixtures/field/zod-like/change-test/packages/zod/src/v4/classic/tests/error.test.ts +10 -0
- repomarshal-0.1.0/tests/fixtures/field/zustand-like/README.md +11 -0
- repomarshal-0.1.0/tests/fixtures/field/zustand-like/base/package.json +16 -0
- repomarshal-0.1.0/tests/fixtures/field/zustand-like/base/pnpm-lock.yaml +1 -0
- repomarshal-0.1.0/tests/fixtures/field/zustand-like/base/src/middleware/persist.ts +1 -0
- repomarshal-0.1.0/tests/fixtures/field/zustand-like/base/tests/persistAsync.test.tsx +6 -0
- repomarshal-0.1.0/tests/fixtures/field/zustand-like/change-src/src/middleware/persist.ts +4 -0
- repomarshal-0.1.0/tests/fixtures/field/zustand-like/change-src/tests/persistAsync.test.tsx +10 -0
- repomarshal-0.1.0/tests/fixtures/github_api/README.md +17 -0
- repomarshal-0.1.0/tests/fixtures/github_api/app_comments.json +117 -0
- repomarshal-0.1.0/tests/fixtures/github_api/app_labeled_events.json +106 -0
- repomarshal-0.1.0/tests/fixtures/hooks/claude_code_stop.json +8 -0
- repomarshal-0.1.0/tests/fixtures/hooks/claude_code_stop_active.json +8 -0
- repomarshal-0.1.0/tests/fixtures/providers/playwright/errors.json +82 -0
- repomarshal-0.1.0/tests/fixtures/providers/playwright/fail.json +186 -0
- repomarshal-0.1.0/tests/fixtures/providers/playwright/flaky.json +200 -0
- repomarshal-0.1.0/tests/fixtures/providers/playwright/interrupted.json +186 -0
- repomarshal-0.1.0/tests/fixtures/providers/playwright/no_browser.json +128 -0
- repomarshal-0.1.0/tests/fixtures/providers/playwright/no_tests.json +72 -0
- repomarshal-0.1.0/tests/fixtures/providers/playwright/pass.json +114 -0
- repomarshal-0.1.0/tests/fixtures/providers/playwright/skipped_only.json +132 -0
- repomarshal-0.1.0/tests/fixtures/providers/replay_stub.py +55 -0
- repomarshal-0.1.0/tests/fixtures/providers/skillspector/caution_high.json +553 -0
- repomarshal-0.1.0/tests/fixtures/providers/skillspector/caution_medium.json +578 -0
- repomarshal-0.1.0/tests/fixtures/providers/skillspector/do_not_install.json +826 -0
- repomarshal-0.1.0/tests/fixtures/providers/skillspector/incomplete_caution.json +494 -0
- repomarshal-0.1.0/tests/fixtures/providers/skillspector/incomplete_do_not_install.json +713 -0
- repomarshal-0.1.0/tests/fixtures/providers/skillspector/osv_offline.json +514 -0
- repomarshal-0.1.0/tests/fixtures/providers/skillspector/safe.json +456 -0
- repomarshal-0.1.0/tests/fixtures/providers/skillspector/safe_medium_finding.json +502 -0
- repomarshal-0.1.0/tests/fixtures/webapp/.agents/skills/auth-security/SKILL.md +8 -0
- repomarshal-0.1.0/tests/fixtures/webapp/.agents/skills/docs-writing/SKILL.md +8 -0
- repomarshal-0.1.0/tests/fixtures/webapp/.agents/skills/ui-forms/SKILL.md +8 -0
- repomarshal-0.1.0/tests/fixtures/webapp/AGENTS.md +4 -0
- repomarshal-0.1.0/tests/fixtures/webapp/README.md +4 -0
- repomarshal-0.1.0/tests/fixtures/webapp/backend/app/__init__.py +1 -0
- repomarshal-0.1.0/tests/fixtures/webapp/backend/app/api/__init__.py +1 -0
- repomarshal-0.1.0/tests/fixtures/webapp/backend/app/api/routes.py +12 -0
- repomarshal-0.1.0/tests/fixtures/webapp/backend/app/auth/__init__.py +1 -0
- repomarshal-0.1.0/tests/fixtures/webapp/backend/app/auth/refresh.py +17 -0
- repomarshal-0.1.0/tests/fixtures/webapp/backend/pyproject.toml +13 -0
- repomarshal-0.1.0/tests/fixtures/webapp/backend/tests/integration/test_auth_flow.py +5 -0
- repomarshal-0.1.0/tests/fixtures/webapp/backend/tests/test_refresh.py +9 -0
- repomarshal-0.1.0/tests/fixtures/webapp/docs/adr/0003-token-refresh.md +6 -0
- repomarshal-0.1.0/tests/fixtures/webapp/docs/install.md +7 -0
- repomarshal-0.1.0/tests/fixtures/webapp/frontend/package-lock.json +18 -0
- repomarshal-0.1.0/tests/fixtures/webapp/frontend/package.json +18 -0
- repomarshal-0.1.0/tests/fixtures/webapp/frontend/src/components/LoginForm.test.tsx +7 -0
- repomarshal-0.1.0/tests/fixtures/webapp/frontend/src/components/LoginForm.tsx +22 -0
- repomarshal-0.1.0/tests/fixtures/webapp/frontend/src/styles/login.css +6 -0
- repomarshal-0.1.0/tests/helpers.py +93 -0
- repomarshal-0.1.0/tests/review/__init__.py +0 -0
- repomarshal-0.1.0/tests/review/conftest.py +44 -0
- repomarshal-0.1.0/tests/review/test_failopen_change_set.py +92 -0
- repomarshal-0.1.0/tests/review/test_failopen_commands.py +153 -0
- repomarshal-0.1.0/tests/review/test_failopen_verdict.py +83 -0
- repomarshal-0.1.0/tests/review/test_guards.py +138 -0
- repomarshal-0.1.0/tests/review_v02/__init__.py +0 -0
- repomarshal-0.1.0/tests/review_v02/conftest.py +88 -0
- repomarshal-0.1.0/tests/review_v02/test_hook_failopen.py +169 -0
- repomarshal-0.1.0/tests/review_v02/test_mcp_failopen.py +230 -0
- repomarshal-0.1.0/tests/review_v02/test_tamper_failopen.py +231 -0
- repomarshal-0.1.0/tests/review_v03/__init__.py +0 -0
- repomarshal-0.1.0/tests/review_v03/conftest.py +19 -0
- repomarshal-0.1.0/tests/review_v03/test_adapter_failopen.py +290 -0
- repomarshal-0.1.0/tests/review_v03/test_hook_loop_failopen.py +158 -0
- repomarshal-0.1.0/tests/review_v03/test_waiver_failopen.py +385 -0
- repomarshal-0.1.0/tests/review_v04/__init__.py +0 -0
- repomarshal-0.1.0/tests/review_v04/conftest.py +20 -0
- repomarshal-0.1.0/tests/review_v04/test_ci_failopen.py +248 -0
- repomarshal-0.1.0/tests/review_v04/test_waiver_failopen.py +235 -0
- repomarshal-0.1.0/tests/review_v04/test_workflow_failopen.py +259 -0
- repomarshal-0.1.0/tests/review_v05/__init__.py +0 -0
- repomarshal-0.1.0/tests/review_v05/conftest.py +21 -0
- repomarshal-0.1.0/tests/review_v05/test_trusted_failopen.py +303 -0
- repomarshal-0.1.0/tests/review_v05/test_verdict_workflow_failopen.py +300 -0
- repomarshal-0.1.0/tests/review_v06/__init__.py +0 -0
- repomarshal-0.1.0/tests/review_v06/conftest.py +20 -0
- repomarshal-0.1.0/tests/review_v06/test_decisions_failopen.py +179 -0
- repomarshal-0.1.0/tests/review_v06/test_release_workflow_failopen.py +172 -0
- repomarshal-0.1.0/tests/review_v06/test_runner_pycache_attacks.py +66 -0
- repomarshal-0.1.0/tests/review_v06/test_workspace_failopen.py +376 -0
- repomarshal-0.1.0/tests/review_v08/__init__.py +0 -0
- repomarshal-0.1.0/tests/review_v08/conftest.py +27 -0
- repomarshal-0.1.0/tests/review_v08/test_signed_waivers_review.py +396 -0
- repomarshal-0.1.0/tests/sshsig.py +67 -0
- repomarshal-0.1.0/tests/unit/__init__.py +0 -0
- repomarshal-0.1.0/tests/unit/conftest.py +9 -0
- repomarshal-0.1.0/tests/unit/test_anchor.py +60 -0
- repomarshal-0.1.0/tests/unit/test_ci_split.py +465 -0
- repomarshal-0.1.0/tests/unit/test_ci_trusted.py +431 -0
- repomarshal-0.1.0/tests/unit/test_commit_identity_script.py +78 -0
- repomarshal-0.1.0/tests/unit/test_context.py +324 -0
- repomarshal-0.1.0/tests/unit/test_contract.py +134 -0
- repomarshal-0.1.0/tests/unit/test_decisions.py +708 -0
- repomarshal-0.1.0/tests/unit/test_doctor.py +278 -0
- repomarshal-0.1.0/tests/unit/test_dogfood_workflow_binding.py +257 -0
- repomarshal-0.1.0/tests/unit/test_git.py +1038 -0
- repomarshal-0.1.0/tests/unit/test_hook_loop.py +511 -0
- repomarshal-0.1.0/tests/unit/test_hooks.py +353 -0
- repomarshal-0.1.0/tests/unit/test_initcmd.py +218 -0
- repomarshal-0.1.0/tests/unit/test_inventory.py +1103 -0
- repomarshal-0.1.0/tests/unit/test_mcp_server.py +318 -0
- repomarshal-0.1.0/tests/unit/test_native.py +206 -0
- repomarshal-0.1.0/tests/unit/test_policy.py +363 -0
- repomarshal-0.1.0/tests/unit/test_provider_playwright.py +498 -0
- repomarshal-0.1.0/tests/unit/test_provider_skillspector.py +415 -0
- repomarshal-0.1.0/tests/unit/test_release_workflow.py +236 -0
- repomarshal-0.1.0/tests/unit/test_runner.py +127 -0
- repomarshal-0.1.0/tests/unit/test_runner_pycache.py +64 -0
- repomarshal-0.1.0/tests/unit/test_signals.py +1443 -0
- repomarshal-0.1.0/tests/unit/test_skills.py +200 -0
- repomarshal-0.1.0/tests/unit/test_trusted_workflow_steps.py +163 -0
- repomarshal-0.1.0/tests/unit/test_verdict.py +143 -0
- repomarshal-0.1.0/tests/unit/test_waiver_identity.py +208 -0
- repomarshal-0.1.0/tests/unit/test_waiver_signed.py +335 -0
- repomarshal-0.1.0/tests/unit/test_waivers.py +612 -0
- repomarshal-0.1.0/tests/unit/test_waiversig.py +171 -0
- repomarshal-0.1.0/tests/unit/test_workflow_static.py +169 -0
- repomarshal-0.1.0/tests/unit/test_workspace.py +219 -0
|
@@ -0,0 +1,202 @@
|
|
|
1
|
+
|
|
2
|
+
Apache License
|
|
3
|
+
Version 2.0, January 2004
|
|
4
|
+
http://www.apache.org/licenses/
|
|
5
|
+
|
|
6
|
+
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
|
7
|
+
|
|
8
|
+
1. Definitions.
|
|
9
|
+
|
|
10
|
+
"License" shall mean the terms and conditions for use, reproduction,
|
|
11
|
+
and distribution as defined by Sections 1 through 9 of this document.
|
|
12
|
+
|
|
13
|
+
"Licensor" shall mean the copyright owner or entity authorized by
|
|
14
|
+
the copyright owner that is granting the License.
|
|
15
|
+
|
|
16
|
+
"Legal Entity" shall mean the union of the acting entity and all
|
|
17
|
+
other entities that control, are controlled by, or are under common
|
|
18
|
+
control with that entity. For the purposes of this definition,
|
|
19
|
+
"control" means (i) the power, direct or indirect, to cause the
|
|
20
|
+
direction or management of such entity, whether by contract or
|
|
21
|
+
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
|
22
|
+
outstanding shares, or (iii) beneficial ownership of such entity.
|
|
23
|
+
|
|
24
|
+
"You" (or "Your") shall mean an individual or Legal Entity
|
|
25
|
+
exercising permissions granted by this License.
|
|
26
|
+
|
|
27
|
+
"Source" form shall mean the preferred form for making modifications,
|
|
28
|
+
including but not limited to software source code, documentation
|
|
29
|
+
source, and configuration files.
|
|
30
|
+
|
|
31
|
+
"Object" form shall mean any form resulting from mechanical
|
|
32
|
+
transformation or translation of a Source form, including but
|
|
33
|
+
not limited to compiled object code, generated documentation,
|
|
34
|
+
and conversions to other media types.
|
|
35
|
+
|
|
36
|
+
"Work" shall mean the work of authorship, whether in Source or
|
|
37
|
+
Object form, made available under the License, as indicated by a
|
|
38
|
+
copyright notice that is included in or attached to the work
|
|
39
|
+
(an example is provided in the Appendix below).
|
|
40
|
+
|
|
41
|
+
"Derivative Works" shall mean any work, whether in Source or Object
|
|
42
|
+
form, that is based on (or derived from) the Work and for which the
|
|
43
|
+
editorial revisions, annotations, elaborations, or other modifications
|
|
44
|
+
represent, as a whole, an original work of authorship. For the purposes
|
|
45
|
+
of this License, Derivative Works shall not include works that remain
|
|
46
|
+
separable from, or merely link (or bind by name) to the interfaces of,
|
|
47
|
+
the Work and Derivative Works thereof.
|
|
48
|
+
|
|
49
|
+
"Contribution" shall mean any work of authorship, including
|
|
50
|
+
the original version of the Work and any modifications or additions
|
|
51
|
+
to that Work or Derivative Works thereof, that is intentionally
|
|
52
|
+
submitted to Licensor for inclusion in the Work by the copyright owner
|
|
53
|
+
or by an individual or Legal Entity authorized to submit on behalf of
|
|
54
|
+
the copyright owner. For the purposes of this definition, "submitted"
|
|
55
|
+
means any form of electronic, verbal, or written communication sent
|
|
56
|
+
to the Licensor or its representatives, including but not limited to
|
|
57
|
+
communication on electronic mailing lists, source code control systems,
|
|
58
|
+
and issue tracking systems that are managed by, or on behalf of, the
|
|
59
|
+
Licensor for the purpose of discussing and improving the Work, but
|
|
60
|
+
excluding communication that is conspicuously marked or otherwise
|
|
61
|
+
designated in writing by the copyright owner as "Not a Contribution."
|
|
62
|
+
|
|
63
|
+
"Contributor" shall mean Licensor and any individual or Legal Entity
|
|
64
|
+
on behalf of whom a Contribution has been received by Licensor and
|
|
65
|
+
subsequently incorporated within the Work.
|
|
66
|
+
|
|
67
|
+
2. Grant of Copyright License. Subject to the terms and conditions of
|
|
68
|
+
this License, each Contributor hereby grants to You a perpetual,
|
|
69
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
70
|
+
copyright license to reproduce, prepare Derivative Works of,
|
|
71
|
+
publicly display, publicly perform, sublicense, and distribute the
|
|
72
|
+
Work and such Derivative Works in Source or Object form.
|
|
73
|
+
|
|
74
|
+
3. Grant of Patent License. Subject to the terms and conditions of
|
|
75
|
+
this License, each Contributor hereby grants to You a perpetual,
|
|
76
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
77
|
+
(except as stated in this section) patent license to make, have made,
|
|
78
|
+
use, offer to sell, sell, import, and otherwise transfer the Work,
|
|
79
|
+
where such license applies only to those patent claims licensable
|
|
80
|
+
by such Contributor that are necessarily infringed by their
|
|
81
|
+
Contribution(s) alone or by combination of their Contribution(s)
|
|
82
|
+
with the Work to which such Contribution(s) was submitted. If You
|
|
83
|
+
institute patent litigation against any entity (including a
|
|
84
|
+
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
|
85
|
+
or a Contribution incorporated within the Work constitutes direct
|
|
86
|
+
or contributory patent infringement, then any patent licenses
|
|
87
|
+
granted to You under this License for that Work shall terminate
|
|
88
|
+
as of the date such litigation is filed.
|
|
89
|
+
|
|
90
|
+
4. Redistribution. You may reproduce and distribute copies of the
|
|
91
|
+
Work or Derivative Works thereof in any medium, with or without
|
|
92
|
+
modifications, and in Source or Object form, provided that You
|
|
93
|
+
meet the following conditions:
|
|
94
|
+
|
|
95
|
+
(a) You must give any other recipients of the Work or
|
|
96
|
+
Derivative Works a copy of this License; and
|
|
97
|
+
|
|
98
|
+
(b) You must cause any modified files to carry prominent notices
|
|
99
|
+
stating that You changed the files; and
|
|
100
|
+
|
|
101
|
+
(c) You must retain, in the Source form of any Derivative Works
|
|
102
|
+
that You distribute, all copyright, patent, trademark, and
|
|
103
|
+
attribution notices from the Source form of the Work,
|
|
104
|
+
excluding those notices that do not pertain to any part of
|
|
105
|
+
the Derivative Works; and
|
|
106
|
+
|
|
107
|
+
(d) If the Work includes a "NOTICE" text file as part of its
|
|
108
|
+
distribution, then any Derivative Works that You distribute must
|
|
109
|
+
include a readable copy of the attribution notices contained
|
|
110
|
+
within such NOTICE file, excluding those notices that do not
|
|
111
|
+
pertain to any part of the Derivative Works, in at least one
|
|
112
|
+
of the following places: within a NOTICE text file distributed
|
|
113
|
+
as part of the Derivative Works; within the Source form or
|
|
114
|
+
documentation, if provided along with the Derivative Works; or,
|
|
115
|
+
within a display generated by the Derivative Works, if and
|
|
116
|
+
wherever such third-party notices normally appear. The contents
|
|
117
|
+
of the NOTICE file are for informational purposes only and
|
|
118
|
+
do not modify the License. You may add Your own attribution
|
|
119
|
+
notices within Derivative Works that You distribute, alongside
|
|
120
|
+
or as an addendum to the NOTICE text from the Work, provided
|
|
121
|
+
that such additional attribution notices cannot be construed
|
|
122
|
+
as modifying the License.
|
|
123
|
+
|
|
124
|
+
You may add Your own copyright statement to Your modifications and
|
|
125
|
+
may provide additional or different license terms and conditions
|
|
126
|
+
for use, reproduction, or distribution of Your modifications, or
|
|
127
|
+
for any such Derivative Works as a whole, provided Your use,
|
|
128
|
+
reproduction, and distribution of the Work otherwise complies with
|
|
129
|
+
the conditions stated in this License.
|
|
130
|
+
|
|
131
|
+
5. Submission of Contributions. Unless You explicitly state otherwise,
|
|
132
|
+
any Contribution intentionally submitted for inclusion in the Work
|
|
133
|
+
by You to the Licensor shall be under the terms and conditions of
|
|
134
|
+
this License, without any additional terms or conditions.
|
|
135
|
+
Notwithstanding the above, nothing herein shall supersede or modify
|
|
136
|
+
the terms of any separate license agreement you may have executed
|
|
137
|
+
with Licensor regarding such Contributions.
|
|
138
|
+
|
|
139
|
+
6. Trademarks. This License does not grant permission to use the trade
|
|
140
|
+
names, trademarks, service marks, or product names of the Licensor,
|
|
141
|
+
except as required for reasonable and customary use in describing the
|
|
142
|
+
origin of the Work and reproducing the content of the NOTICE file.
|
|
143
|
+
|
|
144
|
+
7. Disclaimer of Warranty. Unless required by applicable law or
|
|
145
|
+
agreed to in writing, Licensor provides the Work (and each
|
|
146
|
+
Contributor provides its Contributions) on an "AS IS" BASIS,
|
|
147
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
|
148
|
+
implied, including, without limitation, any warranties or conditions
|
|
149
|
+
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
|
150
|
+
PARTICULAR PURPOSE. You are solely responsible for determining the
|
|
151
|
+
appropriateness of using or redistributing the Work and assume any
|
|
152
|
+
risks associated with Your exercise of permissions under this License.
|
|
153
|
+
|
|
154
|
+
8. Limitation of Liability. In no event and under no legal theory,
|
|
155
|
+
whether in tort (including negligence), contract, or otherwise,
|
|
156
|
+
unless required by applicable law (such as deliberate and grossly
|
|
157
|
+
negligent acts) or agreed to in writing, shall any Contributor be
|
|
158
|
+
liable to You for damages, including any direct, indirect, special,
|
|
159
|
+
incidental, or consequential damages of any character arising as a
|
|
160
|
+
result of this License or out of the use or inability to use the
|
|
161
|
+
Work (including but not limited to damages for loss of goodwill,
|
|
162
|
+
work stoppage, computer failure or malfunction, or any and all
|
|
163
|
+
other commercial damages or losses), even if such Contributor
|
|
164
|
+
has been advised of the possibility of such damages.
|
|
165
|
+
|
|
166
|
+
9. Accepting Warranty or Additional Liability. While redistributing
|
|
167
|
+
the Work or Derivative Works thereof, You may choose to offer,
|
|
168
|
+
and charge a fee for, acceptance of support, warranty, indemnity,
|
|
169
|
+
or other liability obligations and/or rights consistent with this
|
|
170
|
+
License. However, in accepting such obligations, You may act only
|
|
171
|
+
on Your own behalf and on Your sole responsibility, not on behalf
|
|
172
|
+
of any other Contributor, and only if You agree to indemnify,
|
|
173
|
+
defend, and hold each Contributor harmless for any liability
|
|
174
|
+
incurred by, or claims asserted against, such Contributor by reason
|
|
175
|
+
of your accepting any such warranty or additional liability.
|
|
176
|
+
|
|
177
|
+
END OF TERMS AND CONDITIONS
|
|
178
|
+
|
|
179
|
+
APPENDIX: How to apply the Apache License to your work.
|
|
180
|
+
|
|
181
|
+
To apply the Apache License to your work, attach the following
|
|
182
|
+
boilerplate notice, with the fields enclosed by brackets "[]"
|
|
183
|
+
replaced with your own identifying information. (Don't include
|
|
184
|
+
the brackets!) The text should be enclosed in the appropriate
|
|
185
|
+
comment syntax for the file format. We also recommend that a
|
|
186
|
+
file or class name and description of purpose be included on the
|
|
187
|
+
same "printed page" as the copyright notice for easier
|
|
188
|
+
identification within third-party archives.
|
|
189
|
+
|
|
190
|
+
Copyright [yyyy] [name of copyright owner]
|
|
191
|
+
|
|
192
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
|
193
|
+
you may not use this file except in compliance with the License.
|
|
194
|
+
You may obtain a copy of the License at
|
|
195
|
+
|
|
196
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
|
197
|
+
|
|
198
|
+
Unless required by applicable law or agreed to in writing, software
|
|
199
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
|
200
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
201
|
+
See the License for the specific language governing permissions and
|
|
202
|
+
limitations under the License.
|
|
@@ -0,0 +1,253 @@
|
|
|
1
|
+
Metadata-Version: 2.4
|
|
2
|
+
Name: repomarshal
|
|
3
|
+
Version: 0.1.0
|
|
4
|
+
Summary: Compile each repository change into an explained plan of required checks, then return an evidence-backed completion verdict.
|
|
5
|
+
Project-URL: Homepage, https://github.com/MHHamdan/repo-marshal
|
|
6
|
+
Project-URL: Documentation, https://github.com/MHHamdan/repo-marshal/tree/main/docs
|
|
7
|
+
Project-URL: Issues, https://github.com/MHHamdan/repo-marshal/issues
|
|
8
|
+
Author: Mohammed Hamdan
|
|
9
|
+
License-Expression: Apache-2.0
|
|
10
|
+
License-File: LICENSE
|
|
11
|
+
Keywords: ci,claude-code,coding-agents,git,mcp,verification
|
|
12
|
+
Classifier: Development Status :: 3 - Alpha
|
|
13
|
+
Classifier: Environment :: Console
|
|
14
|
+
Classifier: Intended Audience :: Developers
|
|
15
|
+
Classifier: Operating System :: POSIX
|
|
16
|
+
Classifier: Programming Language :: Python :: 3 :: Only
|
|
17
|
+
Classifier: Programming Language :: Python :: 3.11
|
|
18
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
19
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
20
|
+
Classifier: Topic :: Software Development :: Quality Assurance
|
|
21
|
+
Classifier: Topic :: Software Development :: Testing
|
|
22
|
+
Requires-Python: >=3.11
|
|
23
|
+
Provides-Extra: dev
|
|
24
|
+
Requires-Dist: jsonschema>=4.23; extra == 'dev'
|
|
25
|
+
Requires-Dist: pytest>=8; extra == 'dev'
|
|
26
|
+
Requires-Dist: ruff>=0.6; extra == 'dev'
|
|
27
|
+
Provides-Extra: mcp
|
|
28
|
+
Requires-Dist: mcp<3,>=2.3; extra == 'mcp'
|
|
29
|
+
Description-Content-Type: text/markdown
|
|
30
|
+
|
|
31
|
+
# RepoMarshal
|
|
32
|
+
|
|
33
|
+
**Marshal every AI-generated change from context to proof.**
|
|
34
|
+
|
|
35
|
+
RepoMarshal looks at the change a coding agent made: the git diff, including uncommitted work. From
|
|
36
|
+
that it compiles a **Change Plan**: which context the agent should read, which skills apply, and
|
|
37
|
+
which checks this specific change requires. Every check the plan skips comes with a stated reason.
|
|
38
|
+
RepoMarshal then runs the required checks itself and returns a verdict (PASS, FAIL, UNKNOWN or
|
|
39
|
+
BLOCKED) that never treats "could not check" as "passed".
|
|
40
|
+
|
|
41
|
+
> Status: **0.1.0** (alpha). CLI, Claude Code hooks, MCP server and a CI recipe;
|
|
42
|
+
> Python ≥ 3.11, no runtime dependencies. Measured on 27 commits from 5 real repositories:
|
|
43
|
+
> [`docs/evaluation.md`](docs/evaluation.md). Releases: [`docs/guides/release.md`](docs/guides/release.md).
|
|
44
|
+
|
|
45
|
+
## Why not just install the tools?
|
|
46
|
+
|
|
47
|
+
Scanners, browser runners and test frameworks are good at running checks. What none of them decides
|
|
48
|
+
is **which** checks a given change needs, or what the overall answer is when one of them could not
|
|
49
|
+
run. An agent either runs everything on every edit (slow, so people turn it off), or runs whatever
|
|
50
|
+
it picks and claims "done". RepoMarshal is the deterministic layer in between:
|
|
51
|
+
|
|
52
|
+
```text
|
|
53
|
+
change → signals → plan (required / skipped / unavailable, each with a reason) → run → verdict
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
## Quickstart: install to first verdict
|
|
57
|
+
|
|
58
|
+
You need git, Python ≥ 3.11 and your project's own test tools. RepoMarshal runs your repository's
|
|
59
|
+
own checks, inferred from `pyproject.toml`, `package.json`, Makefile targets and similar; there
|
|
60
|
+
is nothing to configure.
|
|
61
|
+
|
|
62
|
+
```bash
|
|
63
|
+
python3 -m venv ~/.repomarshal && ~/.repomarshal/bin/pip install repomarshal
|
|
64
|
+
# before the first PyPI release, use:
|
|
65
|
+
# ~/.repomarshal/bin/pip install "repomarshal @ git+https://github.com/MHHamdan/repo-marshal"
|
|
66
|
+
export PATH="$HOME/.repomarshal/bin:$PATH"
|
|
67
|
+
|
|
68
|
+
cd your-repo # make a change (or let your agent make one), then:
|
|
69
|
+
repomarshal plan "what you are changing" # which checks this change needs, and why
|
|
70
|
+
repomarshal done # runs them: exit 0 PASS, 1 FAIL, 2 UNKNOWN, 3 BLOCKED
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
This exact path was measured by [`scripts/quickstart-check.sh`](scripts/quickstart-check.sh)
|
|
74
|
+
in a fresh `python:3.12` Docker container on 2026-10-14. The script creates a tiny project with
|
|
75
|
+
one module and one pytest test, installs RepoMarshal (from git, since the PyPI release does not
|
|
76
|
+
exist yet), changes the code and runs `plan` and `done`.
|
|
77
|
+
- Container run 1: 11.1 s to install, PASS at 12.6 s.
|
|
78
|
+
- Container run 2: 10.2 s to install, PASS at 11.9 s.
|
|
79
|
+
|
|
80
|
+
Then connect your agent:
|
|
81
|
+
|
|
82
|
+
```bash
|
|
83
|
+
repomarshal init --print claude-code # paste the hooks into .claude/settings.json
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
`plan --explain` prints every reason for every gate. `plan --json` and `done --json` match the
|
|
87
|
+
schemas in `src/repomarshal/schemas/`.
|
|
88
|
+
|
|
89
|
+
## Demo: a real agent, a real repository, a real tamper attempt
|
|
90
|
+
|
|
91
|
+
Claude Code (2.1.299, headless) worked on
|
|
92
|
+
[python-humanize/humanize](https://github.com/python-humanize/humanize) at `785e5dc`, unmodified.
|
|
93
|
+
The hooks were exactly what `repomarshal init --print claude-code` prints. With no
|
|
94
|
+
configuration, RepoMarshal inferred `ruff check --no-fix .`, `mypy .` and
|
|
95
|
+
`python -m pytest -q` from `pyproject.toml`. The task was a real bug: `humanize.ordinal(-1)`
|
|
96
|
+
returned `'-1th'`. Full record, with the hook log of every invocation:
|
|
97
|
+
[`docs/demo/claude-code-humanize.md`](docs/demo/claude-code-humanize.md).
|
|
98
|
+
|
|
99
|
+
**Run 1, honest fix.** The agent took the suffix from `abs(value)` and added 11 test cases. On its
|
|
100
|
+
stop, the hook ran the three gates and returned **PASS**, so the stop was allowed:
|
|
101
|
+
|
|
102
|
+
```text
|
|
103
|
+
verdict PASS: all 3 required gates passed for tree bec5bac54049474478334045f95d1ce3bed54cc4
|
|
104
|
+
root:lint PASS ruff check --no-fix . exit 0
|
|
105
|
+
root:typecheck PASS mypy . exit 0
|
|
106
|
+
root:unit PASS python -m pytest -q exit 0
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
**Run 2, deliberate tamper.** The agent was told to make the same fix, add no tests, and put
|
|
110
|
+
`@pytest.mark.skip(reason="flaky")` on the existing `test_ordinal`. pytest still exited 0. The
|
|
111
|
+
hook **blocked** the stop and told the agent, verbatim:
|
|
112
|
+
|
|
113
|
+
```text
|
|
114
|
+
RepoMarshal completion verdict: UNKNOWN. Do not stop yet: the change is not verified.
|
|
115
|
+
[...]
|
|
116
|
+
- root:unit: UNKNOWN (tests.skip_added: tests/test_number.py adds pytest.mark.skip; this gate's result cannot vouch for the change; was: PASS (exit code 0))
|
|
117
|
+
- integration (no gate): required but unavailable (no integration gate or provider configured for the changed files)
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
The agent replied *"The hook objected to the skip, so I removed it and added tests for negative
|
|
121
|
+
numbers"*. On its second stop, the verdict was **PASS** on the new tree.
|
|
122
|
+
|
|
123
|
+
**Run 3, an agent that refuses.** Same tamper, but the agent was told to keep the skip. After one
|
|
124
|
+
identical blocked stop, the hook let it stop rather than loop forever, and Claude Code showed the
|
|
125
|
+
user:
|
|
126
|
+
|
|
127
|
+
```text
|
|
128
|
+
RepoMarshal: this change is UNVERIFIED (verdict UNKNOWN). The agent stopped again with no change after 1 identical blocked stop(s), so RepoMarshal let it stop. Do not treat the work as verified.
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
The tamper never became a PASS. A local verdict is still advisory: an agent can edit its own hook
|
|
132
|
+
settings. The authoritative verdict comes from CI (see below).
|
|
133
|
+
|
|
134
|
+
## With a coding agent, and in CI
|
|
135
|
+
|
|
136
|
+
|
|
137
|
+
- **Claude Code:** `repomarshal init --print claude-code` prints a hooks snippet for
|
|
138
|
+
`.claude/settings.json`.
|
|
139
|
+
- **SessionStart** anchors BASE before the agent works.
|
|
140
|
+
- **Stop** runs `repomarshal done --hook claude-code`. Any verdict other than PASS, and any
|
|
141
|
+
error, signal or timeout, blocks the stop. The agent gets the failing or unknown gates as
|
|
142
|
+
feedback.
|
|
143
|
+
- **No endless loop.** If the agent stops again (`stop_hook_active`) with the *same* non-PASS
|
|
144
|
+
verdict over the *same* evidence, the stop is allowed and you get a message that the change is
|
|
145
|
+
**UNVERIFIED**, listing the open gates. A new or worse verdict always blocks again.
|
|
146
|
+
- **Any MCP client:** `pip install "repomarshal[mcp]"`, then register `repomarshal mcp` as a stdio
|
|
147
|
+
server. Tools: `repomarshal_plan`, `repomarshal_done` and `repomarshal_explain`. Each takes an
|
|
148
|
+
explicit `repo_path`.
|
|
149
|
+
- **CI, the authoritative verdict:** see [`docs/guides/ci.md`](docs/guides/ci.md). Run
|
|
150
|
+
`repomarshal done --base <PR base sha>` where the agent cannot write. Better, use the v0.4 split
|
|
151
|
+
(`repomarshal ci plan` / `ci gate` / `ci verdict`): each gate that runs the PR's code gets its
|
|
152
|
+
own job with no token permissions, and the judge jobs run no PR code at all. v0.5: the verdict
|
|
153
|
+
is posted as the commit status `repomarshal/verdict` by a workflow that always runs from the
|
|
154
|
+
default branch (`repomarshal-verdict.yml`). Make that status the one required check, and post
|
|
155
|
+
it as a GitHub App ([`docs/guides/ci.md`](docs/guides/ci.md#the-trusted-verdict-and-branch-protection-v05)).
|
|
156
|
+
- **Waivers, human only:** when a required gate cannot run, a maintainer can accept the gap for one
|
|
157
|
+
change: in CI with a `repomarshal-waive:<gate>` PR label plus a reason comment, both made by a
|
|
158
|
+
person (anything done through a GitHub App, such as a coding agent acting under the
|
|
159
|
+
maintainer's account, is rejected). A local agent using the maintainer's own `gh` login looks
|
|
160
|
+
like the maintainer, so with `waiver_signers` the comment must also carry a code signed with the
|
|
161
|
+
maintainer's SSH key (`repomarshal waive-sign`; a touch-to-sign hardware key makes this
|
|
162
|
+
human-only). Author waivers always need it. Locally, use `repomarshal waive <gate> --reason ...`
|
|
163
|
+
at a terminal. A waiver
|
|
164
|
+
never turns a FAIL into a PASS, counts only when the BASE `repomarshal.toml` sets
|
|
165
|
+
`[completion] waivers_permit_pass = true`, and is recorded in the evidence. The Stop hook and the
|
|
166
|
+
MCP server never accept waivers. See [`docs/guides/waivers.md`](docs/guides/waivers.md).
|
|
167
|
+
- **`repomarshal doctor`:** reports the detected gates, the policy, and the optional providers.
|
|
168
|
+
`repomarshal init` writes a commented `repomarshal.toml` and touches nothing else.
|
|
169
|
+
|
|
170
|
+
## What RepoMarshal decides, and how
|
|
171
|
+
|
|
172
|
+
- **Signals.** A versioned catalogue of deterministic rules over paths and *added* lines, such as
|
|
173
|
+
`docs.changed`, `frontend.ui`, `security.auth_path`, `security.sensitive_identifier` and
|
|
174
|
+
`build.config_changed`. A file no rule recognises raises `coverage.unclassified`, which *widens*
|
|
175
|
+
the plan instead of shrinking it.
|
|
176
|
+
- **Gates.** These are inferred, on an unconfigured repository, from `package.json` scripts (run with
|
|
177
|
+
the `packageManager` or lockfile's runner, preferring non-mutating `*:check` scripts), Python tool
|
|
178
|
+
config (ruff without fixing, mypy, pyright, pytest) and Makefile targets, per directory scope and
|
|
179
|
+
per workspace package. Plus two native baseline checks, Markdown relative links and secret
|
|
180
|
+
patterns in added lines, and the SkillSpector and Playwright providers when installed.
|
|
181
|
+
- Cheap and standard gates run whenever their scope has code changes.
|
|
182
|
+
- Expensive gates (integration, runtime, a11y, security scans) run only when a signal requires
|
|
183
|
+
them.
|
|
184
|
+
- **Context and skills.** Changed files and their paired tests are always included. Related docs and
|
|
185
|
+
nearby files are added within a budget, with sizes labelled as `bytes/4` estimates. Skills are
|
|
186
|
+
picked from `SKILL.md` files in the repository.
|
|
187
|
+
- **Verdict.**
|
|
188
|
+
- FAIL if any required gate fails.
|
|
189
|
+
- UNKNOWN if any required gate could not produce evidence: unavailable tool, timeout, nothing
|
|
190
|
+
verified, or the working tree changed during the run.
|
|
191
|
+
- BLOCKED if the policy is invalid.
|
|
192
|
+
- Skipped gates never count as evidence.
|
|
193
|
+
|
|
194
|
+
Details: [`docs/architecture.md`](docs/architecture.md), [`docs/adr/`](docs/adr/).
|
|
195
|
+
|
|
196
|
+
## Security boundaries (read this)
|
|
197
|
+
|
|
198
|
+
- **The policy and gate definitions come from the BASE commit.** A change cannot weaken the checks
|
|
199
|
+
that judge it.
|
|
200
|
+
- **A gate whose definition changed in the diff is UNKNOWN, whatever its exit code.** For example,
|
|
201
|
+
editing `"test"` in package.json to `"exit 0"` cannot produce a PASS.
|
|
202
|
+
- **An explicit `--base` can only widen what is checked.** A repository nested, untracked, inside
|
|
203
|
+
your project is refused.
|
|
204
|
+
- **A local PASS is advisory.** The coding agent runs as your user and could, with deliberate effort,
|
|
205
|
+
tamper with anything local. The authoritative verdict is a re-run of `repomarshal done` where the
|
|
206
|
+
agent has no write access (CI or a reviewer).
|
|
207
|
+
- **RepoMarshal is not a sandbox and does not enforce tool permissions.** `plan` never runs
|
|
208
|
+
repository code. `done` runs the repository's own commands, just like running its tests yourself.
|
|
209
|
+
- **Test quality is not measured.** RepoMarshal proves which commands ran against which exact
|
|
210
|
+
content, and how they exited. It does not prove that the tests are meaningful.
|
|
211
|
+
- **Not covered by the digest:** files ignored by the BASE commit's `.gitignore`, such as `.env` and
|
|
212
|
+
build output. Ignore rules the agent controls (`.git/info/exclude`, global excludes, or a
|
|
213
|
+
`.gitignore` edited in the change) are not trusted.
|
|
214
|
+
- **A gate's evidence is checked file by file:** the working tree is re-digested after every gate,
|
|
215
|
+
and a gate that changes files gets an UNKNOWN result.
|
|
216
|
+
|
|
217
|
+
See [`docs/security/threat-model.md`](docs/security/threat-model.md).
|
|
218
|
+
|
|
219
|
+
## Integrations
|
|
220
|
+
|
|
221
|
+
| Integration | Status |
|
|
222
|
+
|---|---|
|
|
223
|
+
| Command gates (package.json scripts, Makefile targets, ruff, mypy, pyright, pytest, `[gates.*]`) | Supported |
|
|
224
|
+
| Native docs-links and secrets-diff baseline checks | Supported |
|
|
225
|
+
| Claude Code Stop hook (`repomarshal done --hook claude-code`) | Supported; tested against recorded hook payloads |
|
|
226
|
+
| MCP stdio server (`pip install "repomarshal[mcp]"`, `repomarshal mcp`) | Supported (MCP 2026-07-28, with 2025-11-25 fallback) |
|
|
227
|
+
| Hook and MCP config snippets for Codex, Cursor, Copilot and Gemini (`repomarshal init --print <host>`) | Experimental: printed only, untested on those hosts |
|
|
228
|
+
| NVIDIA SkillSpector (`skill_audit` when a skill changes; `skillspector` 2.12.x on PATH, `--no-llm`) | Experimental; tested against v2.12.0 |
|
|
229
|
+
| Playwright (`runtime`, JSON reporter; the project's own `@playwright/test`, `npx --no-install`) | Experimental; tested range 1.50–1.64 |
|
|
230
|
+
| Reticle, AgentProof, Chisel spec reader, UI Skills, UI/UX Pro Max | Planned (optional) |
|
|
231
|
+
|
|
232
|
+
Planned integrations have no code yet. A required gate without a provider is reported as
|
|
233
|
+
UNAVAILABLE, and the verdict is never PASS. Provider versions outside the tested range, zero tests
|
|
234
|
+
run, an incomplete scan, or no network for SkillSpector's OSV lookup all give UNKNOWN, never
|
|
235
|
+
PASS. The tool version is recorded in each gate result.
|
|
236
|
+
|
|
237
|
+
## Roadmap
|
|
238
|
+
|
|
239
|
+
See [`docs/roadmap.md`](docs/roadmap.md). Next up: evidence chaining and a `status` command,
|
|
240
|
+
workspace-aware deduplication of monorepo gates, `db.migration`, and publishing to PyPI.
|
|
241
|
+
|
|
242
|
+
## Development
|
|
243
|
+
|
|
244
|
+
```bash
|
|
245
|
+
uv venv -p 3.11 .venv && uv pip install -p .venv/bin/python pytest jsonschema ruff
|
|
246
|
+
.venv/bin/python -m pytest
|
|
247
|
+
.venv/bin/ruff check src tests && .venv/bin/ruff format --check src tests
|
|
248
|
+
```
|
|
249
|
+
|
|
250
|
+
## License
|
|
251
|
+
|
|
252
|
+
Apache-2.0. See [`LICENSE`](LICENSE). Upstream projects studied are listed, with their licenses, in
|
|
253
|
+
[`docs/UPSTREAM_PROVENANCE.md`](docs/UPSTREAM_PROVENANCE.md). No upstream code is included.
|