welchost 0.1.0__tar.gz

welchost-0.1.0/.commitlintrc.yml

@@ -0,0 +1,20 @@
+extends:
+  - conventional
+rules:
+  type-enum:
+    - 2
+    - always
+    - [feat, fix, chore, docs, test, refactor, perf, ci, build]
+  scope-empty:
+    - 0
+  subject-empty:
+    - 2
+    - never
+  subject-max-length:
+    - 2
+    - always
+    - 100
+  header-max-length:
+    - 2
+    - always
+    - 120

welchost-0.1.0/.cz.toml

@@ -0,0 +1,8 @@
+[tool.commitizen]
+name = "cz_conventional_commits"
+version = "0.1.0"
+version_files = [
+    "src/welchost/__init__.py:__version__",
+    "pyproject.toml:version",
+]
+tag_format = "v$version"

welchost-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,50 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint-commits:
+    name: Lint commit messages
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request'
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: wagoid/commitlint-github-action@v6
+        with:
+          configFile: .commitlintrc.yml
+
+  lint:
+    name: Lint
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - run: pip install ruff
+      - run: ruff check src/ tests/
+      - run: ruff format --check src/ tests/
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: macos-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: pip install -e ".[dev]"
+      - run: pytest --tb=short -q

welchost-0.1.0/.github/workflows/homebrew-test.yml

@@ -0,0 +1,18 @@
+name: Homebrew Formula Test
+
+on:
+  workflow_dispatch:
+  release:
+    types: [published]
+
+jobs:
+  test-brew:
+    name: Test Homebrew install
+    runs-on: macos-latest
+    steps:
+      - name: Test formula
+        run: |
+          brew tap scoobynko/welchost
+          brew install welchost
+          welchost version
+          welchost doctor

welchost-0.1.0/.github/workflows/pr-check.yml

@@ -0,0 +1,46 @@
+name: PR Check
+
+on:
+  pull_request:
+    branches: [main]
+    types: [opened, synchronize, reopened, edited]
+
+jobs:
+  commit-lint:
+    name: Validate commit messages
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: wagoid/commitlint-github-action@v6
+        with:
+          configFile: .commitlintrc.yml
+          failOnWarnings: false
+          helpURL: "https://www.conventionalcommits.org"
+
+  changeset-check:
+    name: Check release notes
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - name: Check conventional commit on PR title
+        env:
+          PR_TITLE: ${{ github.event.pull_request.title }}
+        run: |
+          python -c "
+          import re, os, sys
+          title = os.environ['PR_TITLE']
+          pattern = r'^(feat|fix|chore|docs|test|refactor|perf|ci|build)(\(.+\))?!?: .{1,100}$'
+          if not re.match(pattern, title):
+              print(f'PR title does not follow conventional commits: {title}')
+              print('Expected: type(scope): description')
+              print('Example:  feat(tui): add gradient preview')
+              sys.exit(1)
+          print(f'PR title OK: {title}')
+          "

welchost-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,67 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+
+jobs:
+  release:
+    name: Release
+    # Must be Linux: python-semantic-release is a Docker container action, which
+    # only runs on Linux runners. Wheel build + PyPI publish are platform-agnostic;
+    # the macOS-only `brew install` check lives in homebrew-test.yml.
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+    env:
+      # Surfaced at job level so steps can gate on its presence in `if:`.
+      HOMEBREW_TAP_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Lint
+        run: ruff check src/ tests/
+
+      - name: Test
+        run: pytest --tb=short -q
+
+      - name: Python Semantic Release
+        id: release
+        uses: python-semantic-release/python-semantic-release@v9
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Publish to PyPI
+        if: steps.release.outputs.released == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_TOKEN }}
+
+      - name: Update Homebrew tap
+        # Skips until the tap token is configured, so a PyPI-only release stays green.
+        if: steps.release.outputs.released == 'true' && env.HOMEBREW_TAP_TOKEN != ''
+        uses: mislav/bump-homebrew-formula-action@v3
+        with:
+          formula-name: welchost
+          formula-path: Formula/welchost.rb
+          homebrew-tap: scoobynko/homebrew-welchost
+          base-branch: main
+          download-url: https://files.pythonhosted.org/packages/source/w/welchost/welchost-${{ steps.release.outputs.version }}.tar.gz
+          commit-message: "chore: bump welchost to {{version}}"
+        env:
+          COMMITTER_TOKEN: ${{ secrets.HOMEBREW_TAP_TOKEN }}

welchost-0.1.0/.gitignore

@@ -0,0 +1,26 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.eggs/
+
+# Virtualenvs
+.venv/
+venv/
+
+# Welchost dev sandbox
+dev-home/
+*.welchost.bak*
+
+# Tooling
+.pytest_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+
+# OS / editor
+.DS_Store
+.idea/
+.vscode/

welchost-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,11 @@
+repos:
+  - repo: https://github.com/compilerla/conventional-pre-commit
+    rev: v3.4.0
+    hooks:
+      - id: conventional-pre-commit
+        stages: [commit-msg]
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.0
+    hooks:
+      - id: ruff
+      - id: ruff-format

welchost-0.1.0/CHANGELOG.md

@@ -0,0 +1,152 @@
+# CHANGELOG
+
+
+## v0.1.0 (2026-06-12)
+
+### Bug Fixes
+
+- **ci**: Run release on ubuntu (semantic-release needs a Linux runner)
+  ([`144618e`](https://github.com/scoobynko/welchost/commit/144618e2e8287d01162c2fcdb926530607b5144e))
+
+python-semantic-release is a Docker container action and fails with "Container action is only
+  supported on Linux" on macos-latest. The release job is platform-agnostic; the macOS brew check
+  stays in homebrew-test.yml.
+
+Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
+
+### Chores
+
+- Init project structure
+  ([`1bc53f8`](https://github.com/scoobynko/welchost/commit/1bc53f83b662b3bb90cee8ffac9215922c37adfe))
+
+Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
+
+### Continuous Integration
+
+- Skip Homebrew bump until the tap token is configured
+  ([`a7c101c`](https://github.com/scoobynko/welchost/commit/a7c101c8e433c78d20234d515d2528d1854f1dd1))
+
+Gate the formula-bump step on HOMEBREW_TAP_TOKEN so a PyPI-only release stays green; the step lights
+  up automatically once the tap secret exists.
+
+Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
+
+### Documentation
+
+- Add CHANGELOG for v0.1.0
+  ([`4b2c7a4`](https://github.com/scoobynko/welchost/commit/4b2c7a4dc539d07a36136da3573e077f16c1c20b))
+
+Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
+
+- Add CLAUDE.md project specification
+  ([`cdaf441`](https://github.com/scoobynko/welchost/commit/cdaf441fe467bab0dad0c880f47f0fb55c41d2f4))
+
+Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
+
+- Add first-time publishing & release-setup runbook
+  ([`c6e0dde`](https://github.com/scoobynko/welchost/commit/c6e0dded4cefc49f969336e51d2a479135529a44))
+
+Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
+
+- Update spec for alignment, gradients, ornaments, and shell-chain guards
+  ([`4ea99f9`](https://github.com/scoobynko/welchost/commit/4ea99f9a921d6244706d000f8376f26102042612))
+
+Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
+
+### Features
+
+- **core**: Banner alignment, directional gradients, ornaments + hardening
+  ([`403d85c`](https://github.com/scoobynko/welchost/commit/403d85c30c77f36d62a160b1ac28405dc1380580))
+
+Replace banner.size with banner.align (left/center/right) and add per-block directional gradients
+  (horizontal/vertical/diagonal) and predefined flanking ASCII ornaments (new ornaments.py).
+  render.py and the generated welcome_banner.py share identical block-gradient/flank/align logic so
+  the preview stays WYSIWYG.
+
+Security & robustness for public distribution: - clamp
+  align/color_mode/gradient.direction/border_style to their schema enums before baking into the
+  generated script (closes code-injection via a hand-edited/shared welchost.toml) - resolve_color
+  always returns a 3-tuple, falling back to gray on partial or malformed hex (no more unpack crash
+  in the live preview) - generated welcome.zsh only runs when python3 is present; the .zshrc line
+  also guards on the shim being readable, so a missing interpreter or shim can never spam errors on
+  every shell - load_config tolerates a corrupt welchost.toml (returns None) instead of crashing the
+  TUI/CLI on launch - memoize pyfiglet rendering; route the sentinel marker through one constant
+
+Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
+
+- **core**: Detect, config, themes, generator, cli + templates
+  ([`fba2455`](https://github.com/scoobynko/welchost/commit/fba24553f2fbb47d983d6640718f16800942d4d8))
+
+- detect.py: DEV-aware path resolution + Ghostty detection - config.py: WelchostConfig dataclass,
+  lossless TOML round-trip - themes.py: 12 built-in themes - generator.py: pyfiglet render,
+  self-contained banner script, idempotent .zshrc sentinel + backup, reset - cli.py: Typer app
+  (config/preview/reset/doctor/version) with --dev callback - templates: welcome.zsh.j2,
+  welcome_banner.py.j2 (pure-Python ANSI)
+
+Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
+
+- **tui**: Keyboard-only redesign — color picker, modals, logo, fixes
+  ([`1c127f5`](https://github.com/scoobynko/welchost/commit/1c127f5ee9590ad77b0b7fa69b722bdaf815a030))
+
+- ColorField widget: preset swatches + custom-hex dropdown, reused across the color and decoration
+  steps - ConfirmModal: keyboard-driven yes/no overlay; delete and create-new flows route through
+  one shared _Menu.confirm helper - unify reset/delete behind one confirm_reset (consistent wording,
+  removed paths surfaced); retire the divergent full-screen ResetScreen - centralize config
+  lifecycle on the app (adopt_config/clear_config/ new_draft) so the menu always reflects whether a
+  config exists - levitating logo: gentle 2-axis idle hover; wordmark render cached - wizard: sticky
+  nav (back left / next-save far right), step content height:auto so tall steps (e.g. gradient
+  direction) scroll fully, and each step resets to the top on switch - hide the border-color field
+  when border style is "none"; shared apply_visibility helper for conditional fields
+
+Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
+
+- **tui**: Pixel logo, list-based template picker, no emoji
+  ([`c39abed`](https://github.com/scoobynko/welchost/commit/c39abedee99ce49c2f1f19685246e4181f3d7886))
+
+- logo: pixel-art ghost + double_blocky wordmark (clear W, pixel edges) - replace all emojis with
+  accent block glyphs - template picker: vertical list + live preview (smaller, easy ↑/↓ nav) and
+  enter opens the wizard at step 1 so text/font stay editable - docs: update keyboard-nav section
+
+Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
+
+- **tui**: Redesign — 6 templates, logo, keyboard-only nav, fix save
+  ([`1ebdbf2`](https://github.com/scoobynko/welchost/commit/1ebdbf29eae9bf83152c99ae6fe3161bacae19f7))
+
+- themes: 12 -> 6 curated (claude/codex filled, ghost, matrix, sunset, mono), terracotta accent;
+  fixes invalid pyfiglet font names - generator: build_figlet falls back to standard on missing
+  font; write files atomically (render both before writing) so a bad font can't half-install - tui:
+  first-screen logo (pagga wordmark + ghost + prompt), more padding, minimalist; keyboard-only —
+  gallery arrows/hjkl, wizard ctrl+arrows + ctrl+s, color presets/mode as RadioSets (no click-only
+  buttons) - tests updated for 6 templates + font fallback/validity
+
+Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
+
+- **tui**: Textual app, theme gallery, 4-step wizard, live preview
+  ([`d43047b`](https://github.com/scoobynko/welchost/commit/d43047b3a193b95b82bdc99df239f8027c1fd000))
+
+- render.py: shared Rich banner rendering (CLI + TUI WYSIWYG); cli refactored to use it - app.py:
+  WelchostApp holding a live WelchostConfig model; refresh_preview - main_menu: MainMenu/EditMenu +
+  Doctor/Preview/Reset screens - theme_gallery: 3-col grid of 12 live theme previews, search,
+  enter/c - wizard: 4-step container with progress + shared live BannerPreview - steps:
+  text+font(571 searchable), color(solid/gradient+swatches), decoration+info toggles,
+  confirm+install - dev_watcher: watchdog hot reload (DEV only)
+
+Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
+
+### Testing
+
+- Cli, config, generator, detect, dev-mode, themes suites
+  ([`faabe76`](https://github.com/scoobynko/welchost/commit/faabe768faf4c608dec0f9ea6eef278be5d1b86d))
+
+63 tests: sentinel idempotency, DEV sandbox isolation, lossless config round-trip, all 12 theme
+  fonts valid, self-contained banner script.
+
+Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
+
+- Cover alignment, gradient direction, ornaments, and config tolerance
+  ([`de802ab`](https://github.com/scoobynko/welchost/commit/de802ab373352f9a05d656a12a7ca48afab88c25))
+
+Round-trip + defaults for align/direction/ornament, theme ornament-name validation (mirrors the font
+  check), gradient-direction baking, and that a legacy/removed key loads without crashing.
+
+Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>