GitHub Core Repository

GitHub Core Repository Files

README.mdCHANGELOG.mdLICENSE.md

Below is the Github Core Repository Readme

GitHub Actions Collection

A collection of reusable GitHub Actions workflows and core actions for standardizing development processes across repositories.

Architecture

This repository follows a six-layer architecture based on Formal Conceptual Models (FCM) that maintains GitHub compatibility while achieving architectural purity:

Six-Layer Structure

Axioms (axioms/) - Foundational capabilities defined as FCM models
Logic (logic/) - Compositions and relationships between axioms
Patterns (patterns/) - Reusable workflow patterns
Mechanics (mechanics/) - Implementation templates and operational structures
Reflection (reflection/) - Self-awareness and analysis capabilities
Emergence (emergence/) - Discovered patterns and emergent capabilities

Bridge System

The repository uses a bridge architecture to maintain GitHub Actions compatibility:

Source Layer: FCM definitions in axioms/, logic/, patterns/
Interface Layer: GitHub-compatible actions in actions/
Bridge Layer: Automated generation via .bridge/ tools

Action Naming Convention

This repository uses a naming convention to indicate action source and maintenance:

Hyphen naming (branch-operations) - Generated from FCM definitions
Maintained by the FCM bridge system
Regenerated periodically from axioms/ definitions
Manual changes will be overwritten unless incorporated into the FCM
Underscore naming (branch_operations) - Manual implementations
Maintained by human developers
Changes made directly to action files
Developer responsible for updates and compatibility

Both types follow identical design patterns and functionality - the naming only indicates source and maintenance model.

Available Components

Core Actions

Atomic operations that can be combined to build custom workflows:

Version Calculator: Calculate version numbers based on git tags
Version Updater: Update version references in code and documentation
Branch Operations: Create, delete, checkout, list, and merge branches
Tag Operations: Create, delete, push, and list git tags
Commit Operations: Create, amend, list, cherry-pick and revert git commits

Composite Actions

Workflows that combine multiple operations for common tasks:

Git Operations: Handle git operations including branch and tag management
Release Notes: Generate release notes from PRs and commits
Update Changelog: Update changelog based on merged PRs
Release Operations: Combine tag, branch, and commit operations for comprehensive release management

Workflows

Ready-to-use GitHub workflows for common development processes:

1. Prepare Release Branch (`prep-release.yml`)

Creates a release branch and prepares the changelog for release.

Trigger:
Push the tag prep

Actions:

Creates a release branch
Moves Unreleased changelog items to a new version section
Removes the Unreleased section for release
Creates a PR for review

Usage:

git tag prep
git push origin prep

2. Update Changelog (`update-changelog.yml`)

Automatically updates the changelog when PRs are merged to develop.

Trigger:
PR merged to develop branch

Actions:

Adds PR to Unreleased section of changelog
Creates Unreleased section if it doesn't exist
Maintains changelog formatting

Usage: Automatic - no manual steps required. PR merges to develop trigger the workflow.

Changelog Format

The workflows maintain the following changelog format:

# Repository Changelog
*Note: the changes in this log are automatically generated and commited via github actions, modify only if you know what you are doing!*

## **MM/DD/YYYY - Unreleased**
- PR #{number}: {title}

## **[(MM/DD/YYYY) - {version}](https://github.com/{org}/{repo}/releases/tag/{version})**
- PR #{number}: {title}

Setup Instructions

Using Generated Actions

Copy the desired workflow files to your repository's .github/workflows/ directory
For core actions, reference them in your workflows using the uses syntax
No additional configuration needed - workflows use repository context for variables

Working with FCM Architecture

View capabilities: Browse axioms/ directories for available FCM definitions
Modify actions: Edit FCM files in axioms/, then regenerate using .bridge/generator.py
Validate consistency: Run .bridge/validator.py to ensure alignment
Never edit directly: Actions in actions/ are generated - changes will be overwritten

Bridge Commands

# Generate all actions from FCMs
./.bridge/generator.py --generate-all

# Generate specific action
./.bridge/generator.py axioms/git/tag-operations.fcm

# Validate bridge alignment
./.bridge/validator.py

Requirements

GitHub repository with develop branch
Permissions to push tags and create PRs
Changelog.md file in repository root (will be created if missing)

Contributing

Create a feature branch off develop
Make your changes
Create a PR to develop
Changelog will be automatically updated upon merge

Documentation

See the documentation site for detailed usage examples and API references for all actions and workflows.

License

MIT License - See LICENSE.md file for details

Below is the Github Core Repository Changelog

github.actions Repository Changelog

Note: the changes in this log are automatically generated and commited via github actions, modify only if you know what you are doing!

(06/22/2025) - v1.0.357

What's Changed

Merging Patch Updates @mattbuske (#208)
Lets Merge @mattbuske (#207)

Full Changelog: v1.0.333...v1.0.356

(06/16/2025) - v1.0.331

What's Changed

Bump mkdocs-git-authors-plugin from 0.9.4 to 0.10.0 @dependabot[bot] (#202)

Full Changelog: v1.0.326...v1.0.331

(06/07/2025) - v1.0.324

What's Changed

Enhances FCM-to-GitHub Actions bridge for production deployment @mattbuske (#195)
Enhances YAML handling and updates dependencies @mattbuske (#191)
Bump mkdocs-git-revision-date-localized-plugin from 1.4.5 to 1.4.7 @mattbuske (#190)
Bump mkdocs-git-revision-date-localized-plugin from 1.4.5 to 1.4.7 @dependabot[bot] (#170)
Bump mkdocs-material from 9.6.11 to 9.6.14 @mattbuske (#189)
Bump mkdocs-monorepo-plugin from 1.1.0 to 1.1.2 @mattbuske (#186)
Bump mkdocs-git-revision-date-localized-plugin from 1.4.5 to 1.4.7 @mattbuske (#187)
Bump mkdocs-material from 9.6.11 to 9.6.14 @mattbuske (#188)
Bump actions/setup-python from 4 to 5 @mattbuske (#184)
feat: Configure Dependabot to target staging branch @mattbuske (#183)
feat: Add cleanup step for test release branches and tags @mattbuske (#182)
Improves branch management in workflows @mattbuske (#181)
fix: Add current directory to safe directories in commit operations @mattbuske (#178)
fix: Add safe directory config to commit operations test workflow @mattbuske (#177)
Refines GitHub Action validation and test result reporting @mattbuske (#176)
Improves test infrastructure and updates workflow @mattbuske (#174)
FCM Updates @mattbuske (#172)

Full Changelog: v1.0.261...v1.0.324

(04/03/2025) - v1.0.261

What's Changed

Bump actions/setup-python from 4 to 5 @mattbuske (#162)
128 Modularize git ops @mattbuske (#160)

Full Changelog: v1.0.210...v1.0.260

(04/03/2025) - v1.0.210

What's Changed

129 Create Core Tag Operations Action @mattbuske (#156)
Bump mkdocs-git-authors-plugin from 0.9.3 to 0.9.4 @dependabot[bot] (#148)
Bump mkdocs-material from 9.6.8 to 9.6.11 @dependabot[bot] (#151)

Full Changelog: v1.0.194...v1.0.209

(04/03/2025) - v1.0.192

What's Changed

130 Create Core Branch Operations Action @mattbuske (#154)
132 Establish Standard Testing Framework for Actions @mattbuske (#153)
132 Establish Standard Testing Framework for Actions @mattbuske (#152)
Bump mkdocs-git-authors-plugin from 0.9.2 to 0.9.3 @dependabot[bot] (#146)
Bump mkdocs-material from 9.6.7 to 9.6.8 @dependabot[bot] (#145)
Bump mkdocs-git-revision-date-localized-plugin from 1.3.0 to 1.4.4 @dependabot[bot] (#144)
Bump mkdocs-material from 9.6.5 to 9.6.7 @dependabot[bot] (#142)
Bump mkdocs-material from 9.5.50 to 9.6.5 @dependabot[bot] (#141)
Bump docker/build-push-action from 5 to 6 @dependabot[bot] (#133)
Bump codecov/codecov-action from 4 to 5 @dependabot[bot] (#134)
Bump mkdocs-material from 9.5.49 to 9.5.50 @dependabot[bot] (#135)
Release v1.0.138 @github-actions[bot] (#127)
Version Updater @mattbuske (#126)
Version Calculator @mattbuske (#125)