Skip to content

[Preset]: Add Project Statistics Governance v0.1.0 #4670

Description

@hindermath

Preset ID

project-statistics-governance

Preset Name

Project Statistics Governance

Version

0.1.0

Description

Reproducible Git-bound project transparency with offline measurements, explicit write authority and opt-in reference estimates; no AI productivity claims.

Author

Thorsten Hindermann

Repository URL

https://github.com/hindermath/spec-kit-preset-project-statistics-governance

Download URL

https://github.com/hindermath/spec-kit-preset-project-statistics-governance/archive/refs/tags/v0.1.0.zip

Documentation URL

https://github.com/hindermath/spec-kit-preset-project-statistics-governance/blob/main/README.md

License

MIT

Required Spec Kit Version

=0.12.8

Required Extensions (optional)

None

Templates Provided

  • project-statistics-contract — portable measurement, provenance and authority contract.
  • constitution-template — append reproducible project-transparency governance.
  • plan-template — append reproducibility and explicit update-authority requirements.
  • tasks-template — append serialized statistics updates and evidence verification.

Commands Provided

  • speckit.statistics-init — initialize a separate statistics context with explicit permission.
  • speckit.statistics-status — inspect reproducibility and freshness without changes.
  • speckit.statistics-update — preview and explicitly update a statistics report.

Number of Scripts (optional)

2

Tags

project-statistics, reproducibility, governance, accessibility

Key Features

  • Reproducible text inventory, artifact mix and visible Git activity bound to source revision, configuration, methodology, renderer and cutoff.
  • Offline measurements; no account, Home Baseline hierarchy or companion governance preset required.
  • PowerShell 7 required on all platforms; Bash delegates to the same measurement engine. Git requires complete history.
  • Explicit permission, preview and clean-worktree checks before writes; status is read-only. No automatic fetch, tool installation, stash, commit, push or merge.
  • Separate contexts preserve existing project statistics and authored content. Reference estimates are disabled by default.
  • Accessible, text-first, bilingual documentation and reports.
  • No claims of measured AI productivity, individual performance, software quality, learning attainment, security acceptance or certification.

Testing Checklist

  • Preset installs successfully via specify preset add
  • Template resolution works correctly after installation
  • Documentation is complete and accurate
  • Tested on at least one real project

Submission Requirements

  • Valid preset.yml manifest included
  • Linked README (Documentation URL) explains how to use this preset and includes a valid specify preset add ... command (preferably specify preset add --from <download-url> using the exact download URL)
  • LICENSE file included
  • GitHub release created with version tag
  • Preset ID follows naming conventions (lowercase-with-hyphens)

Release and verification evidence

This is a new community-catalog entry, not an update to an existing preset.

  • Stable v0.1.0 release.
  • Download ZIP SHA-256: d8ad7d5eef920f50b629121b64ba8123c22ec4f6dadd14da5cd826d1c50f420a.
  • Release source commit: 7e824ca8de11212aefdc5b05d7d05637f5343dab.
  • Fresh macOS verification on 2026-09-22 with Spec Kit 0.12.8: exact tag-URL installation, contract resolution and preset info succeeded; installed package contents match the independently downloaded, hash-verified ZIP.
  • Isolated lifecycle test with priority 90 verifies generated command surfaces, template resolution, disable/enable, remove/reinstall and preservation of authored report data.
  • Native CI: macOS/Linux 67 assertions each, Windows 61, plus installed-preset lifecycle and PowerShell analysis. These are the recorded release proofs, not a claim of fresh native execution on all three platforms today.
  • Accepted field-test report, merged acceptance PR #3: Home Baseline, TinyCalc and absdd-image-sandbox; technical recommendation ReleaseAccepted and human acceptance Accepted.

The owner subsequently approved regular publication of the same package. Tag, source commit, ZIP and release-asset hashes are unchanged. The immutable tag ZIP retains its historical pre-release documentation; the linked current README, release notes and delivery guide explain the accepted field test and stable promotion. Installation itself starts neither measurement nor migration.

The manifest exposes four template entries and three commands. The script count above covers the two public entry points, Bash and PowerShell; the package also contains internal implementation helpers and tests.

Activity

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions