Brendadeeznuts1111 Project R Score Tier1380 Commit Flow

Tier-1380 OMEGA Commit Governance Flow

Automated commit workflow ensuring perfect commits every time.

Flow Overview

flowchart TD
    BEGIN([START]) --> CHECK{Working<br/>Directory<br/>Clean?}
    CHECK -->|Yes| END1([Nothing to commit])
    CHECK -->|No| STAGE[Stage Changes]
    STAGE --> LINT[Run Biome Lint]
    LINT -->|Pass| TEST[Run Tests]
    LINT -->|Fail| FIX[Auto-fix Issues]
    FIX --> LINT
    TEST -->|Pass| TYPE[Type Check]
    TEST -->|Fail| END2([Fix Tests First])
    TYPE -->|Pass| MSG[Generate Commit Message]
    TYPE -->|Fail| END3([Fix Types First])
    MSG --> VALIDATE[Validate Message]
    VALIDATE -->|Pass| COMMIT[Create Commit]
    VALIDATE -->|Fail| EDIT[Edit Message]
    EDIT --> VALIDATE
    COMMIT --> PUSH{Push?}
    PUSH -->|Yes| REMOTE[Push to Origin]
    PUSH -->|No| END4([Done])
    REMOTE --> END5([Complete])

Quick Start

Option 0: Automated Setup (Easiest)

# Run the setup script
bun ~/.kimi/skills/tier1380-commit-flow/setup.ts

# This will:
# - Check prerequisites
# - Install all git hooks
# - Initialize configuration
# - Create shell alias (`tier1380`)

Option 1: Unified CLI (Recommended)

# Using the CLI
bun ~/.kimi/skills/tier1380-commit-flow/cli.ts <command>

# Or create a shortcut
alias tier1380="bun ~/.kimi/skills/tier1380-commit-flow/cli.ts"

# Then use:
tier1380 commit "[RUNTIME][CHROME][TIER:1380] Add entropy caching"
tier1380 generate-msg
tier1380 check --fix
tier1380 dashboard

Option 2: Individual Scripts

# Install Git Hooks
bun ~/.kimi/skills/tier1380-commit-flow/scripts/install-hooks.ts install

# Generate message
bun ~/.kimi/skills/tier1380-commit-flow/scripts/generate-message.ts

# Run checks
bun ~/.kimi/skills/tier1380-commit-flow/scripts/pre-commit-hook.ts

# View dashboard
bun ~/.kimi/skills/tier1380-commit-flow/scripts/governance-dashboard.ts

Git Hooks Installation

# Install all hooks
bun ~/.kimi/skills/tier1380-commit-flow/scripts/install-hooks.ts install

This installs:
- **pre-commit**: Runs lint, type check, secrets scan, Col-89 check
- **commit-msg**: Validates commit message format
- **post-commit**: Records commit to analytics history

Essential Commands

/commit - Perfect Commit

Complete commit workflow with validation:

/commit [message]

Without message: auto-generates based on changes. With message: validates and enhances provided message.

/governance - Run Governance Checks

Validates code against Tier-1380 standards:

/governance [scope]

Scopes: all, staged, file <path>, matrix, skills

/flow - Execute Flow Step

Execute specific flow step:

/flow [step]

Steps: lint, test, type-check, commit-msg, full

Commit Message Format

Standard Template

[DOMAIN][COMPONENT][TIER:XXXX] Brief description

Detailed explanation (optional):
- What changed
- Why it changed
- Impact assessment

Refs: #issue-number

Extended Template (Rich Metadata)

[DOMAIN][SCOPE][TYPE][META:{TIER:1380}][CLASS][FUNCTION] Brief description

[INTERFACE] [BUN-NATIVE] [#REF:#123]

Detailed explanation:
- What changed
- Why it changed
- Impact assessment

Segment Reference

Examples

Standard:

[RUNTIME][COMPONENT:CHROME][TIER:1380] Add entropy caching for col_72

Extended:

[RUNTIME][AGENT][FEAT][META:{TIER:1380}][AgentWorkflow][enforceCol89] Add R2 integration

[Col89AuditEntry] [BUN-NATIVE] [#REF:#123]

- Upload Col-89 violations to R2 fw-audit-logs bucket
- Dynamic import of agent-r2-integration module
- Presigned URLs for audit report retrieval

Domains

Components

Examples

[RUNTIME][COMPONENT:CHROME][TIER:1380] Add entropy caching for col_72

- Implements 50% faster Buffer operations
- Adds LRU cache for repeated calculations
- Backwards compatible with existing API

Refs: #phase-3-9-apex

[PLATFORM][COMPONENT:MATRIX][TIER:1380] Update column 45 tension threshold

- Adjusts anomaly detection sensitivity
- Reduces false positives by 23%
- Validated against production data

[RUNTIME][COMPONENT:COLOR][TIER:1380] Add Tier1380Colors team palette generation

- Implements deterministic color variation per team member
- Uses Bun.color() for ANSI conversion
- Adds support for quantum, status, terminal, dashboard teams

Refs: #color-system

[PLATFORM][COMPONENT:ACCESSIBILITY][TIER:1380] Implement WCAG contrast validation

- Adds AA/AAA compliance checking
- Includes color blindness simulation
- Provides auto-fix suggestions for failing pairs

Refs: #a11y #wcag

CLI Reference

Unified CLI

The cli.ts provides a single entry point for all commands:

bun cli.ts <command> [options]

Shell Completion

# Add to .bashrc/.zshrc
eval "$(bun ~/.kimi/skills/tier1380-commit-flow/cli.ts --completions)"

Keyboard Shortcuts

Bun-Native Utilities

Located in lib/utils.ts:

Usage Example

import { assertCol89, Timer, colorize } from "./lib/utils";

// Col-89 check
if (!assertCol89(longText, "my-file.ts")) {
  console.log(colorize("Width violation!", "red"));
}

// Timing
const timer = new Timer();
await doWork();
console.log(`Done in ${timer.elapsed().toFixed(2)}ms`);

Scripts Reference

Core Scripts

Pre-Commit Checks

The pre-commit hook runs these checks in order:

1. Secrets Scan - Detects hardcoded passwords, API keys, tokens
2. Col-89 Compliance - Validates line width ≤ 89 characters
3. Biome Lint - Code style and formatting
4. TypeScript Check - Type validation
5. Tests - Runs relevant test files

# Run with auto-fix
bun ~/.kimi/skills/tier1380-commit-flow/scripts/pre-commit-hook.ts --fix

# Quick mode (skip tests/type check)
bun ~/.kimi/skills/tier1380-commit-flow/scripts/pre-commit-hook.ts --quick

Git Commit with Options

# Basic commit
bun ~/.kimi/skills/tier1380-commit-flow/scripts/git-commit.ts "[RUNTIME][CHROME][TIER:1380] Fix entropy"

# Signed commit (GPG)
bun ~/.kimi/skills/tier1380-commit-flow/scripts/git-commit.ts "[MSG]" --sign

# Amend last commit
bun ~/.kimi/skills/tier1380-commit-flow/scripts/git-commit.ts "[MSG]" --amend

# With co-author
bun ~/.kimi/skills/tier1380-commit-flow/scripts/git-commit.ts "[MSG]" --co-author "Name <email>"

Analytics & History

# Sync commits from git
bun ~/.kimi/skills/tier1380-commit-flow/scripts/commit-history.ts sync

# Show analytics
bun ~/.kimi/skills/tier1380-commit-flow/scripts/commit-history.ts analytics

# View recent history
bun ~/.kimi/skills/tier1380-commit-flow/scripts/commit-history.ts history

Slash Commands

Quick Actions

Governance

Commit Helpers

Dashboard

Pre-Commit Checklist

• Biome lint passes
• TypeScript type checks
• Tests pass
• Commit message follows format
• No secrets in code
• Skills compliance (Col 89-95)
• Col-89 line width validated

Advanced Features

SQLite Analytics

Commits and pre-commit checks are stored in ~/.matrix/commit-history.db:

-- View recent commits
SELECT * FROM commits ORDER BY date DESC LIMIT 10;

-- View compliance rate
SELECT AVG(valid_format) * 100 FROM commits;

-- View pre-commit check history
SELECT * FROM precommit_checks ORDER BY timestamp DESC LIMIT 10;

Dashboard Controls

When running the interactive dashboard:

• r - Refresh data
• s - Sync from git
• q - Quit

Hook Installation Options

# Install all hooks
bun ~/.kimi/skills/tier1380-commit-flow/scripts/install-hooks.ts install

# Install with auto-fix enabled
bun ~/.kimi/skills/tier1380-commit-flow/scripts/install-hooks.ts install --auto-fix

# Install only specific hooks
bun ~/.kimi/skills/tier1380-commit-flow/scripts/install-hooks.ts install --no-post-commit

# Check status
bun ~/.kimi/skills/tier1380-commit-flow/scripts/install-hooks.ts status

# Uninstall
bun ~/.kimi/skills/tier1380-commit-flow/scripts/install-hooks.ts uninstall

Flow Execution

Automatic Flow

/flow full

Executes complete workflow:

1. Stage changes
2. Run lint
3. Run type check
4. Run tests
5. Generate commit message
6. Create commit
7. Optional: Push

Manual Steps

/flow lint      # Just linting
/flow test      # Just tests
/flow type-check # Just type check
/flow commit-msg # Just generate message

References

• GOVERNANCE.md - Complete governance rules
• COMMIT_FORMAT.md - Commit message format spec
• SLASH_CMDS.md - All slash commands reference

Related Skills

Cross-Skill Commit Examples

# OpenClaw changes
/commit "[OPENCLAW][GATEWAY][TIER:1380] Add health monitoring endpoint"

# Omega deployment
/commit "[PLATFORM][OMEGA][DEPLOY][TIER:1380] Deploy to staging"

# Infrastructure updates
/commit "[INFRA][MONITORING][TIER:1380] Add Prometheus alerts"

# Full workflow
governance check openclaw && /commit "[OPENCLAW][HEALTH][TIER:1380] Fix status reporting"

Component Mapping

CI/CD Integration

GitHub Actions

A workflow is provided in .github/workflows/commit-governance.yml:

name: Tier-1380 OMEGA Commit Governance

on:
  push:
    branches: [main, master, develop]
  pull_request:
    branches: [main, master, develop]

jobs:
  commit-governance:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
      - uses: oven-sh/setup-bun@v1
      - run: bun ~/.kimi/skills/tier1380-commit-flow/scripts/validate-commits.ts origin/main HEAD
      - run: bun ~/.kimi/skills/tier1380-commit-flow/scripts/pre-commit-hook.ts
      - run: bun ~/.kimi/skills/tier1380-commit-flow/scripts/governance-check.ts all

Validate Commit Range

For CI/CD pipelines:

# Validate all commits in a PR
bun ~/.kimi/skills/tier1380-commit-flow/scripts/validate-commits.ts \
  origin/main HEAD

# Generate report
bun ~/.kimi/skills/tier1380-commit-flow/scripts/validate-commits.ts \
  ${{ github.event.pull_request.base.sha }} \
  ${{ github.event.pull_request.head.sha }}

VS Code Integration

Recommended Extensions

Install these extensions for best experience:

• Biome (biomejs.biome) - Formatting and linting
• Bun for VS Code (oven.bun-vscode) - Bun runtime support
• GitHub Actions (github.vscode-github-actions) - Workflow validation

Tasks

Available tasks (Ctrl+Shift+P → Run Task):

Settings

VS Code settings are configured in .vscode/settings.json:

• Auto-format on save with Biome
• Import organization
• File exclusions for cache directories

Migration Tools

From Conventional Commits

Migrate existing conventional commits to Tier-1380 format:

# Preview migration (dry run)
bun ~/.kimi/skills/tier1380-commit-flow/scripts/migrate-from-conventional.ts

# Apply migration (requires manual rebase)
bun ~/.kimi/skills/tier1380-commit-flow/scripts/migrate-from-conventional.ts --apply

Mapping:

Testing

Run the test suite:

cd ~/.kimi/skills/tier1380-commit-flow

# Run all tests
bun test

# Run specific test file
bun test __tests__/utils.test.ts
bun test __tests__/branch-validator.test.ts

# Run with coverage
bun test --coverage

Test Coverage

Adding Tests

import { describe, it, expect } from "bun:test";
import { myFunction } from "../lib/my-module";

describe("My feature", () => {
  it("should work correctly", () => {
    expect(myFunction()).toBe(expected);
  });
});

Troubleshooting

Pre-commit hook fails

# Run with auto-fix
bun ~/.kimi/skills/tier1380-commit-flow/scripts/pre-commit-hook.ts --fix

# Skip hooks for emergency commit
git commit -m "[URGENT] Fix production issue" --no-verify

Invalid commit message format

# Validate your message
bun ~/.kimi/skills/tier1380-commit-flow/scripts/validate-message.ts "[YOUR MESSAGE]"

# Generate a valid message
bun ~/.kimi/skills/tier1380-commit-flow/scripts/generate-message.ts

Dashboard not showing data

# Sync from git
bun ~/.kimi/skills/tier1380-commit-flow/scripts/commit-history.ts sync

# Check database
ls -la ~/.matrix/commit-history.db

Environment Variables

Converted and distributed by TomeVault — claim your Tome and manage your conversions.