[Extension]: Add Vurnix Honest Gate

[shiersa]

Extension ID

vurnix

Extension Name

Vurnix Honest Gate

Version

0.1.1

Description

Deterministic three-state honest gate for AI-written code: compile + phantom-import + honest test count, executed as code — not agent self-review. PASS/BLOCK/UNPROVEN by exit code.

Author

shiersa

Repository URL

https://github.com/shiersa/vurnix-spec-kit

Download URL

https://github.com/shiersa/vurnix-spec-kit/releases/download/v0.1.1/vurnix-0.1.1.zip

License

MIT

Homepage (optional)

https://vurnix.dev

Documentation URL (optional)

https://github.com/shiersa/vurnix-spec-kit#readme

Changelog URL (optional)

No response

Required Spec Kit Version

=0.16.2

Required Tools (optional)

• python3 (>=3.10) — required
• vurnix (PyPI, >=0.3.0) — required; pip install vurnix, zero runtime dependencies. If missing, the gate script exits 3 (UNPROVEN) rather than passing.
• bash — required (script runtime)

Number of Commands

1

Number of Hooks (optional)

1

Tags

deterministic, honest-gate, test-integrity, quality, fail-closed

Key Features

• One deterministic verdict over the implementation: compile check + phantom-import check + honest test count (only distinct, non-trivial tests count)
• Three-state exit contract: PASS (0) / BLOCK (1) / UNPROVEN (3) — a check that cannot run is not a check that passed
• Fail-dominant and fail-closed: missing toolchain, empty test suite, or missing vurnix install → UNPROVEN, never a silent OK
• Judgment lives in an executable script (provides.scripts), not in agent self-review; the agent relays the verdict verbatim
• after_implement hook offers the gate after every implementation phase

Testing Checklist

• Extension installs successfully via download URL
• All commands execute without errors
• Documentation is complete and accurate
• No security vulnerabilities identified
• Tested on at least one real project

Submission Requirements

• Valid extension.yml manifest included
• README.md with installation and usage instructions
• LICENSE file included
• GitHub release created with version tag
• All command files exist and are properly formatted
• Extension ID follows naming conventions (lowercase-with-hyphens)

Testing Details

Tested on: macOS (Darwin 25.5), Spec Kit main (2026-08-26) via uvx

Test project: fresh specify init --here --integration claude project

Test scenarios:

1. specify extension add vurnix --from <v0.1.1 release zip> → installed and Enabled (1 command, 1 hook); the engine also generated the .claude/skills/speckit-vurnix-gate skill
2. Installed script run against three fixtures: passing project → exit 0; syntax-error project → exit 1; zero-test project → exit 3 with RESULT: UNPROVEN
3. With vurnix absent from PATH the script exits 3, not 0
4. extension.yml validated against the provides.scripts rules from feat(extensions): accept provides.templates and provides.scripts in manifest #4012 (name pattern, relative paths, runtimes)

Example Usage

pip install vurnix
specify extension add vurnix --from https://github.com/shiersa/vurnix-spec-kit/releases/download/v0.1.1/vurnix-0.1.1.zip
/speckit.vurnix.gate                # or directly:
.specify/extensions/vurnix/scripts/bash/vurnix-gate.sh ./src --min-tests 5

Proposed Catalog Entry

{
  "vurnix": {
    "name": "Vurnix Honest Gate",
    "id": "vurnix",
    "description": "Deterministic three-state honest gate for AI-written code: compile + phantom-import + honest test count in one verdict, executed as code — not as agent self-review. PASS (exit 0) / BLOCK (exit 1) / UNPROVEN (exit 3): a check that cannot run is not a check that passed.",
    "author": "shiersa",
    "version": "0.1.1",
    "download_url": "https://github.com/shiersa/vurnix-spec-kit/releases/download/v0.1.1/vurnix-0.1.1.zip",
    "repository": "https://github.com/shiersa/vurnix-spec-kit",
    "homepage": "https://vurnix.dev",
    "documentation": "https://github.com/shiersa/vurnix-spec-kit#readme",
    "license": "MIT",
    "category": "process",
    "effect": "read-only",
    "requires": {
      "speckit_version": ">=0.16.2"
    },
    "provides": {
      "commands": 1,
      "hooks": 1
    },
    "tags": ["anti-weakening", "deterministic", "exit-code", "fail-closed", "honest-gate", "mutation-testing", "phantom-imports", "quality", "spec-kit", "spec-kit-extension", "test-integrity", "three-state", "unproven"],
    "verified": false,
    "downloads": 0,
    "stars": 0,
    "created_at": "2026-08-26T00:00:00Z",
    "updated_at": "2026-09-01T00:00:00Z"
  }
}

Additional Context

The underlying checkers are vurnix 0.3.0 on PyPI (stdlib-only). The gate script is read-only — it inspects and verdicts, never edits the project. Note: I previously submitted this as direct catalog PR #4329 before finding this template; closing note there pointed here. Apologies for the noise.

[github-actions]

cc @github/spec-kit-maintainers — new catalog submission for review.

[github-actions]

Pull request created: #4388

Generated by Add Community Extension from Issue Submission · 209 AIC · ⌖ 16.5 AIC · ⊞ 35.3K

[mnriem]

Thank you!