Skip to content

[Preset]: Update Intake Authoring Governance to v0.2.0 #3720

Description

@hindermath

Preset ID

intake-authoring-governance

Preset Name

Intake Authoring Governance

Version

0.2.0

Description

Governs traceable intake CRUD, bounded public HTTPS sources, and explicitly approved single or series authoring without granting execution authority.

Author

Thorsten Hindermann

Repository URL

https://github.com/hindermath/spec-kit-preset-intake-authoring-governance

Download URL

https://github.com/hindermath/spec-kit-preset-intake-authoring-governance/archive/refs/tags/v0.2.0.zip

Documentation URL

https://github.com/hindermath/spec-kit-preset-intake-authoring-governance/blob/v0.2.0/README.md

License

MIT

Required Spec Kit Version

=0.8.3

Required Extensions (optional)

None

Templates Provided

  • intake-authoring-policy-template - repository policy for target paths, profiles, language, update, URL, and split boundaries
  • intake-authoring-receipt-template - backward-compatible schema-2.0 lifecycle receipt with stable intake identity
  • intake-authoring-series-template - approved multi-intake coverage, order, DAG, and lineage manifest
  • intake-authoring-operation-template - transactional proposal, approval, validation, and publication journal
  • intake-authoring-tombstone-template - logical deletion and byte-identical archive evidence
  • intake-authoring-intake-template - portable Spec Kit-ready intake core with safe prompt markers
  • intake-authoring-profile-template - optional repository-specific structure and target-path contract
  • intake-authoring-runbook-template - create, clarify, read, update, delete, validate, and review-handoff workflow
  • intake-authoring-agent-guidance-addendum-template - agent-neutral authoring and authority guidance
  • intake-authoring-field-validation-summary - synthetic, composition, URL, lifecycle, and fleet evidence

Commands Provided

  • speckit.intake-create - creates one intake or one explicitly approved intake series
  • speckit.intake-read - summarizes one intake or series read-only in Summary, Detailed, or JSON form
  • speckit.intake-update - explicitly updates one intake or migrates one approved intake series
  • speckit.intake-delete - logically deletes active intake artifacts through archive and tombstone evidence
  • speckit.intake-create-status - checks source, target, receipt, series, tombstone, prompt, and authority freshness without writes

Number of Scripts (optional)

4

Tags

intake, authoring, governance, provenance, requirements

Key Features

Hi @mnriem, thank you again for your earlier review and for merging the v0.1.1 catalog update.

This is the compatible update to submission #3676 and catalog PR #3678.

  • Adds explicit, separate Create, Read, Update, Delete, and Create Status commands instead of overloading one authoring command.
  • Keeps Read and Status strictly non-mutating. Delete is logical and requires byte-identical archive evidence plus a tombstone; it never silently destroys history.
  • Adds stable intakeId, operation lineage, supersession, archive paths, and transaction evidence in receipt schema 2.0 while retaining schema 1.0 and 1.1 validation.
  • Accepts explicitly named public HTTPS text sources with bounded redirects, media type, size, UTF-8, normalized SHA-256, secret, and personal-data controls. Private or authenticated URL retrieval is outside v0.2.0.
  • Allows multiple generated intakes only through an explicitly approved series contract with complete source coverage, deterministic order, an acyclic dependency graph, and all-or-nothing publication.
  • Rejects silent truncation, inferred delivery authority, destructive overwrite, unresolved source conflicts, binary input, and invalid UTF-8.
  • Keeps ReadyForReview as a handoff state. Authoring does not automatically start Intake Review, Specify, Autonomous, Parallel Autonomous, commit, push, PR, or merge actions.
  • Remains opt-in at priority 64, directly before Intake Review at 65, Autonomous Run at 70, and Parallel Autonomous Run at 80. Existing default and review-only profiles remain compatible.
  • Provides ten templates, five commands, and four Bash/PowerShell validator scripts.
  • Passed positive and negative CRUD, URL, series, transaction, tombstone, normalization, drift, overwrite, and authority fixtures with Bash/PowerShell parity.
  • Passed exact v0.2.0 tag-ZIP installation, resolution, disable/enable, remove/reinstall, and command uniqueness with all ten stacked presets.
  • Was deployed optionally across all 33 managed Level-0/1/2 repositories, including 21 learning-series repositories in three families. All local package, matrix, statistics, diff, and secret checks passed; all 33 rollout PRs were merged; no learner Spec Kit run was started.
  • Remote evidence includes 119 successful exact-head checks. An additional 229 jobs were individually verified as GitHub Billing or Spending failures with zero executed steps and were not represented as technical passes. All rollout PRs had zero actionable review threads.
  • The versioned ZIP contains 61,216 bytes and has SHA-256 d4b4e5f614e3b2e2c92d6278f0802a48dc371f69fb2c25eb1392c3eb1fb52dc3.

Maintainer feedback on the CRUD boundaries, bounded public-URL contract, explicitly approved series transaction, metadata, and suitability of this v0.2.0 catalog update would be appreciated. The preset remains optional and grants no implicit execution, deletion, overwrite, network, provider, or remote-delivery authority.

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 explains how to use this preset and includes the exact versioned specify preset add --from ... install command
  • LICENSE file included
  • GitHub release created with version tag
  • Preset ID follows naming conventions

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions