required_canon_version: >=3.0.0

Skill: commit-manager

Version: 1.0.0

Status: Active

Purpose

Unified manager for commit-related operations including commit queue management, commit summary logging, and artifact escape hatch validation.

Trigger

Use when performing any commit-related operation:

• •Managing a queued commit workflow (enqueue/list/process)
• •Recording structured commit summaries
• •Generating governance-friendly commit message templates
• •Validating no artifacts have escaped allowed output roots

Operations

Inputs

input.json fields:

Common:

• •operation (string, required): One of queue, summarize, recover

For queue:

• •action (string): enqueue, list, or process
• •queue_id (string): Queue identifier (default: default)
• •entry (object): For enqueue - message, files, author, notes, created_at
• •max_items (int): For list - max entries to return
• •dry_run (bool): For process - skip actual staging

For summarize:

• •action (string): log or template
• •For log:
  • •mode (string): git or manual
  • •commit (string): Commit ref for git mode
  • •entry (object): Complete entry for manual mode
  • •append (bool): Append to log file
  • •include_body (bool): Include commit body
• •For template:
  • •type (string): feat/fix/docs/chore/refactor/test
  • •scope (string): Short scope identifier
  • •subject (string): Commit subject line

For recover:

• •check_type (string): Type of check (default: artifact-escape-hatch)
• •description (string): Description of the check

Outputs

Output varies by operation.

For queue:

• •ok (bool), queue_id, action, entries (for list), status, error

For summarize:

• •ok (bool), entry (for log), message and warnings (for template)

For recover:

• •escaped_artifacts (array), escape_check_passed (bool)

Constraints

• •Queue stored at CONTRACTS/_runs/commit_queue/<queue_id>.jsonl
• •Logs stored at CONTRACTS/_runs/commit_logs/
• •No automatic git commit (commits remain manual)
• •Artifact check scans untracked files only

Fixtures

• •fixtures/basic/ - Basic operation tests

required_canon_version: >=3.0.0