holded-tt 1.0.0__tar.gz

holded_tt-1.0.0/.github/workflows/cd.yml

@@ -0,0 +1,88 @@
+name: CD
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Tag name to release (e.g. v0.1.0)"
+        required: true
+        type: string
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  ci:
+    name: CI gate
+    uses: ./.github/workflows/ci.yml
+
+  publish:
+    name: Build and publish to PyPI
+    runs-on: ubuntu-latest
+    needs: ci
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6.0.2
+
+      - name: Set up Python
+        uses: actions/setup-python@v6.2.0
+        with:
+          python-version: "3.14"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.0.0
+        with:
+          enable-cache: true
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@v1.12.4
+
+      - name: Upload dist artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  release:
+    name: Create GitHub release
+    runs-on: ubuntu-latest
+    needs: publish
+    permissions:
+      contents: write
+    steps:
+      - name: Resolve tag
+        id: meta
+        shell: bash
+        run: |
+          if [[ "${{ github.event_name }}" == "workflow_dispatch" ]]; then
+            echo "tag=${{ inputs.tag }}" >> "$GITHUB_OUTPUT"
+          else
+            echo "tag=${GITHUB_REF_NAME}" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Download dist artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Create GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG: ${{ steps.meta.outputs.tag }}
+        shell: bash
+        run: |
+          if gh release view "$TAG" >/dev/null 2>&1; then
+            gh release upload "$TAG" dist/* --clobber
+          else
+            gh release create "$TAG" dist/* --title "$TAG" --generate-notes
+          fi

holded_tt-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,212 @@
+name: CI
+
+on:
+  pull_request:
+    branches:
+      - main
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+  workflow_call:
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6.0.2
+
+      - name: Set up Python
+        uses: actions/setup-python@v6.2.0
+        with:
+          python-version: "3.14"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.0.0
+        with:
+          enable-cache: true
+
+      - name: Sync dependencies
+        run: uv sync --group dev --locked
+
+      - name: Ruff check
+        run: uv run ruff check .
+
+  test:
+    name: Tests (${{ matrix.os }}, Python ${{ matrix.python-version }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os:
+          - ubuntu-latest
+          - windows-latest
+          - macos-latest
+        python-version:
+          - "3.11"
+          - "3.12"
+          - "3.13"
+          - "3.14"
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6.0.2
+
+      - name: Set up Python
+        uses: actions/setup-python@v6.2.0
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.0.0
+        with:
+          enable-cache: true
+
+      - name: Sync dependencies
+        run: uv sync --group dev --locked
+
+      - name: Run tests
+        run: uv run python -m pytest
+
+  package:
+    name: Package smoke test
+    runs-on: ubuntu-latest
+    needs:
+      - lint
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6.0.2
+
+      - name: Set up Python
+        uses: actions/setup-python@v6.2.0
+        with:
+          python-version: "3.14"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.0.0
+        with:
+          enable-cache: true
+
+      - name: Build package
+        run: uv build
+
+      - name: Install built wheel in isolated venv
+        run: |
+          uv venv .package-venv
+          uv pip install --python .package-venv/bin/python dist/*.whl
+
+      - name: Smoke test installed CLI
+        run: |
+          .package-venv/bin/holded-tt --version
+          .package-venv/bin/holded-tt --help
+          .package-venv/bin/holded-tt track --help
+
+  coverage:
+    name: Coverage
+    runs-on: ubuntu-latest
+    needs:
+      - lint
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6.0.2
+
+      - name: Set up Python
+        uses: actions/setup-python@v6.2.0
+        with:
+          python-version: "3.14"
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v8.0.0
+        with:
+          enable-cache: true
+
+      - name: Sync dependencies
+        run: uv sync --group dev --locked
+
+      - name: Run tests with coverage
+        run: uv run python -m pytest --junitxml=pytest.xml --cov=holded_tt --cov-report=term-missing --cov-report=markdown:coverage.md
+
+      - name: Write coverage and test summary
+        if: always()
+        shell: bash
+        run: |
+          uv run python - <<'PY'
+          import os
+          import xml.etree.ElementTree as ET
+          from pathlib import Path
+
+          summary_path = Path(os.environ["GITHUB_STEP_SUMMARY"])
+          report_path = Path("pytest.xml")
+          coverage_path = Path("coverage.md")
+
+          with summary_path.open("a", encoding="utf-8") as fh:
+              fh.write("## Test summary\n\n")
+              if report_path.exists():
+                  root = ET.parse(report_path).getroot()
+                  suites = [root] if root.tag == "testsuite" else root.findall(".//testsuite")
+                  tests = sum(int(float(suite.attrib.get("tests", 0))) for suite in suites)
+                  failures = sum(int(float(suite.attrib.get("failures", 0))) for suite in suites)
+                  errors = sum(int(float(suite.attrib.get("errors", 0))) for suite in suites)
+                  skipped = sum(int(float(suite.attrib.get("skipped", 0))) for suite in suites)
+                  passed = tests - failures - errors - skipped
+
+                  fh.write(f"- ✅ Passed: **{passed}**\n")
+                  fh.write(f"- ❌ Failed: **{failures}**\n")
+                  fh.write(f"- 🚨 Errors: **{errors}**\n")
+                  fh.write(f"- ⏭️ Skipped: **{skipped}**\n")
+                  fh.write(f"- 🧪 Total: **{tests}**\n")
+              else:
+                  fh.write("❌ No `pytest.xml` report was generated.\n")
+
+              fh.write("\n## Coverage summary\n\n")
+              if coverage_path.exists():
+                  fh.write(coverage_path.read_text(encoding="utf-8"))
+              else:
+                  fh.write("❌ No coverage report was generated.\n")
+          PY
+
+  summary:
+    name: Workflow summary
+    runs-on: ubuntu-latest
+    if: always()
+    needs:
+      - lint
+      - test
+      - package
+      - coverage
+    steps:
+      - name: Write workflow summary
+        shell: bash
+        env:
+          LINT_RESULT: ${{ needs.lint.result }}
+          TEST_RESULT: ${{ needs.test.result }}
+          PACKAGE_RESULT: ${{ needs.package.result }}
+          COVERAGE_RESULT: ${{ needs.coverage.result }}
+        run: |
+          status_icon() {
+            case "$1" in
+              success) echo "✅" ;;
+              failure) echo "❌" ;;
+              cancelled) echo "⚪" ;;
+              skipped) echo "⏭️" ;;
+              *) echo "❔" ;;
+            esac
+          }
+
+          {
+            echo "## CI summary"
+            echo
+            echo "| Job | Result |"
+            echo "| --- | --- |"
+            echo "| Lint | $(status_icon "$LINT_RESULT") $LINT_RESULT |"
+            echo "| Test matrix | $(status_icon "$TEST_RESULT") $TEST_RESULT |"
+            echo "| Package smoke test | $(status_icon "$PACKAGE_RESULT") $PACKAGE_RESULT |"
+            echo "| Coverage | $(status_icon "$COVERAGE_RESULT") $COVERAGE_RESULT |"
+          } >> "$GITHUB_STEP_SUMMARY"

holded_tt-1.0.0/.gitignore

@@ -0,0 +1,50 @@
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.pyd
+.Python
+*.egg
+*.egg-info/
+dist/
+build/
+eggs/
+parts/
+var/
+sdist/
+wheels/
+*.egg-link
+.installed.cfg
+MANIFEST
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# uv
+.uv/
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Type checkers
+.mypy_cache/
+.ruff_cache/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Planning
+.planning/

holded_tt-1.0.0/AGENTS.md

@@ -0,0 +1,161 @@
+<!-- GSD:project-start source:PROJECT.md -->
+## Project
+
+**Holded TT CLI**
+
+A Python CLI tool (`holded-tt`) that automates time-tracking on [Holded](https://app.holded.com) — a Spanish HR SaaS. The primary use case is bulk-registering work days for a date range with a single command, skipping weekends and public holidays automatically. It handles the full authentication flow (email + 2FA) and persists session cookies for subsequent use.
+
+**Core Value:** `holded-tt track --from YYYY-MM-DD --to YYYY-MM-DD` registers all working days in a range without manual effort — weekends and holidays filtered automatically.
+
+### Constraints
+
+- **Tech Stack**: Python 3.11+, Typer, httpx (sync), tomllib (stdlib) / tomli-w, rich — no alternatives
+- **Platform**: Cross-platform (Linux, macOS, Windows); Unix file permissions best-effort
+- **Security**: `session.json` contains sensitive cookies — never logged, permissions 0600 best-effort
+- **API**: Holded internal API — no official SDK, no versioning guarantees; payloads must match browser behavior exactly
+- **Testing**: Unit tests for business logic (date filtering, config parsing, session handling) — no HTTP mocking required
+<!-- GSD:project-end -->
+
+<!-- GSD:stack-start source:research/STACK.md -->
+## Technology Stack
+
+## Already-Decided Stack (do not re-research)
+| Technology | Role |
+|------------|------|
+| Python 3.11+ | Runtime (stdlib `tomllib` requires 3.11) |
+| Typer | CLI framework |
+| httpx (sync) | HTTP client |
+| tomllib (stdlib) | TOML config reads |
+| tomli-w | TOML config writes |
+| rich | Terminal output |
+## Build Backend
+| Backend | When to use | Verdict |
+|---------|-------------|---------|
+| `uv_build` | uv-only workflows, fastest builds, new projects | Good for pure-uv shops |
+| `hatchling` | Any workflow (pip, pipx, uv), needs no special frontend, wider compatibility | Recommended here |
+## pyproject.toml Structure
+### Entry Point Declaration
+### Src Layout Directory Structure
+## Packaging for pipx / uv tool install
+# Local development
+# or
+# Install as isolated tool (end users)
+# Install from local directory (dev/testing)
+## Cross-Platform Config Directory
+| Platform | `user_config_dir("holded-tt-cli")` returns |
+|----------|-----------------------------------------|
+| Linux | `~/.config/holded-tt-cli` (respects `$XDG_CONFIG_HOME`) |
+| macOS | `~/Library/Application Support/holded-tt-cli` |
+| Windows | `C:\Users\<user>\AppData\Roaming\holded-tt-cli` |
+## Cross-Platform File Permissions (0600 Best-Effort)
+### Pattern
+## pytest Setup for Typer CLI Testing
+### Dependencies
+### Core Pattern
+# tests/conftest.py
+### Test Examples
+# tests/test_cli.py
+### Key CliRunner Behaviors to Know
+| Behavior | Default | How to change |
+|----------|---------|---------------|
+| stdout + stderr mixed | `True` | `CliRunner(mix_stderr=False)` |
+| Filesystem isolation | None | Pass `isolated_filesystem=True` or use `tmp_path` |
+| Exceptions swallowed | `True` | `runner.invoke(app, ..., catch_exceptions=False)` |
+| stdin | Empty | Pass `input="text\n"` string |
+### Testing with Env Vars
+## httpx Sync Patterns
+### Client Setup
+### Cookie Persistence Pattern
+### Redirect Handling
+# requests: follows redirects by default
+# httpx:    does NOT follow redirects by default
+# Wrong — will get 302 silently
+# Correct — always set explicitly when redirecting is expected
+### multipart/form-data for Auth
+### Timeout Configuration
+# Recommended: explicit timeout, never rely on default None (infinite wait)
+### Exception Handling
+## Typer + httpx Gotchas
+### Gotcha 1: Exception Swallowing in CliRunner
+### Gotcha 2: Typer Exit Codes
+- `raise typer.Exit(code=0)` — clean exit
+- `raise typer.Exit(code=1)` — error exit
+- `raise typer.Abort()` — "Aborted!" message, exit code 1
+- Unhandled exception — exit code 1, exception stored in `result.exception`
+### Gotcha 3: `invoke_without_command` Default is False
+### Gotcha 4: Rich + CliRunner Output Capture
+### Gotcha 5: httpx Redirects Are Off by Default
+### Gotcha 6: tomllib Opens Files in Binary Mode
+# CORRECT
+# WRONG — will raise TypeError
+## Dependency Versions (as of 2025)
+| Package | Minimum version | Notes |
+|---------|-----------------|-------|
+| typer | `>=0.12` | 0.12 added rich integration by default |
+| httpx | `>=0.28` | Stable API; 0.28 is current stable |
+| tomli-w | `>=1.1` | Stable; no breaking changes expected |
+| rich | `>=13.0` | Stable; 13.x is current major |
+| platformdirs | `>=4.2` | Current is 4.x; `user_config_path` available since 3.x |
+| hatchling | `>=1.24` | Build-time only; not in runtime deps |
+| pytest | `>=8.0` | Dev only |
+| pytest-cov | `>=5.0` | Dev only |
+## Installation Commands Reference
+# Initialize project with uv
+# Add runtime dependencies
+# Add dev dependencies
+# Local editable install (dev)
+# Build distribution
+# Install as tool (end users, isolated)
+# Run tests
+## Sources
+- uv build backend: https://docs.astral.sh/uv/concepts/build-backend/
+- uv project init: https://docs.astral.sh/uv/concepts/projects/init/
+- uv tools: https://docs.astral.sh/uv/concepts/tools/
+- PyPA pyproject.toml guide: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/
+- Typer testing: https://typer.tiangolo.com/tutorial/testing/
+- platformdirs: https://platformdirs.readthedocs.io/
+- httpx redirect behavior: https://www.python-httpx.org/compatibility/
+- httpx cookie persistence discussion: https://github.com/encode/httpx/discussions/2229
+- uv_build vs hatchling comparison: https://medium.com/@dynamicy/python-build-backends-in-2025-what-to-use-and-why-uv-build-vs-hatchling-vs-poetry-core-94dd6b92248f
+- thisdavej CLI packaging walkthrough: https://thisdavej.com/packaging-python-command-line-apps-the-modern-way-with-uv/
+<!-- GSD:stack-end -->
+
+<!-- GSD:conventions-start source:CONVENTIONS.md -->
+## Conventions
+
+Conventions not yet established. Will populate as patterns emerge during development.
+<!-- GSD:conventions-end -->
+
+<!-- GSD:architecture-start source:ARCHITECTURE.md -->
+## Architecture
+
+Architecture not yet mapped. Follow existing patterns found in the codebase.
+<!-- GSD:architecture-end -->
+
+<!-- GSD:skills-start source:skills/ -->
+## Project Skills
+
+No project skills found. Add skills to any of: `.claude/skills/`, `.agents/skills/`, `.cursor/skills/`, or `.github/skills/` with a `SKILL.md` index file.
+<!-- GSD:skills-end -->
+
+<!-- GSD:workflow-start source:GSD defaults -->
+## GSD Workflow Enforcement
+
+Before using Edit, Write, or other file-changing tools, start work through a GSD command so planning artifacts and execution context stay in sync.
+
+Use these entry points:
+- `/gsd-quick` for small fixes, doc updates, and ad-hoc tasks
+- `/gsd-debug` for investigation and bug fixing
+- `/gsd-execute-phase` for planned phase work
+
+Do not make direct repo edits outside a GSD workflow unless the user explicitly asks to bypass it.
+<!-- GSD:workflow-end -->
+
+
+
+<!-- GSD:profile-start -->
+## Developer Profile
+
+> Profile not yet configured. Run `/gsd-profile-user` to generate your developer profile.
+> This section is managed by `generate-claude-profile` -- do not edit manually.
+<!-- GSD:profile-end -->

holded_tt-1.0.0/CLAUDE.md

@@ -0,0 +1,161 @@
+<!-- GSD:project-start source:PROJECT.md -->
+## Project
+
+**Holded TT CLI**
+
+A Python CLI tool (`holded-tt`) that automates time-tracking on [Holded](https://app.holded.com) — a Spanish HR SaaS. The primary use case is bulk-registering work days for a date range with a single command, skipping weekends and public holidays automatically. It handles the full authentication flow (email + 2FA) and persists session cookies for subsequent use.
+
+**Core Value:** `holded-tt track --from YYYY-MM-DD --to YYYY-MM-DD` registers all working days in a range without manual effort — weekends and holidays filtered automatically.
+
+### Constraints
+
+- **Tech Stack**: Python 3.11+, Typer, httpx (sync), tomllib (stdlib) / tomli-w, rich — no alternatives
+- **Platform**: Cross-platform (Linux, macOS, Windows); Unix file permissions best-effort
+- **Security**: `session.json` contains sensitive cookies — never logged, permissions 0600 best-effort
+- **API**: Holded internal API — no official SDK, no versioning guarantees; payloads must match browser behavior exactly
+- **Testing**: Unit tests for business logic (date filtering, config parsing, session handling) — no HTTP mocking required
+<!-- GSD:project-end -->
+
+<!-- GSD:stack-start source:research/STACK.md -->
+## Technology Stack
+
+## Already-Decided Stack (do not re-research)
+| Technology | Role |
+|------------|------|
+| Python 3.11+ | Runtime (stdlib `tomllib` requires 3.11) |
+| Typer | CLI framework |
+| httpx (sync) | HTTP client |
+| tomllib (stdlib) | TOML config reads |
+| tomli-w | TOML config writes |
+| rich | Terminal output |
+## Build Backend
+| Backend | When to use | Verdict |
+|---------|-------------|---------|
+| `uv_build` | uv-only workflows, fastest builds, new projects | Good for pure-uv shops |
+| `hatchling` | Any workflow (pip, pipx, uv), needs no special frontend, wider compatibility | Recommended here |
+## pyproject.toml Structure
+### Entry Point Declaration
+### Src Layout Directory Structure
+## Packaging for pipx / uv tool install
+# Local development
+# or
+# Install as isolated tool (end users)
+# Install from local directory (dev/testing)
+## Cross-Platform Config Directory
+| Platform | `user_config_dir("holded-tt-cli")` returns |
+|----------|-----------------------------------------|
+| Linux | `~/.config/holded-tt-cli` (respects `$XDG_CONFIG_HOME`) |
+| macOS | `~/Library/Application Support/holded-tt-cli` |
+| Windows | `C:\Users\<user>\AppData\Roaming\holded-tt-cli` |
+## Cross-Platform File Permissions (0600 Best-Effort)
+### Pattern
+## pytest Setup for Typer CLI Testing
+### Dependencies
+### Core Pattern
+# tests/conftest.py
+### Test Examples
+# tests/test_cli.py
+### Key CliRunner Behaviors to Know
+| Behavior | Default | How to change |
+|----------|---------|---------------|
+| stdout + stderr mixed | `True` | `CliRunner(mix_stderr=False)` |
+| Filesystem isolation | None | Pass `isolated_filesystem=True` or use `tmp_path` |
+| Exceptions swallowed | `True` | `runner.invoke(app, ..., catch_exceptions=False)` |
+| stdin | Empty | Pass `input="text\n"` string |
+### Testing with Env Vars
+## httpx Sync Patterns
+### Client Setup
+### Cookie Persistence Pattern
+### Redirect Handling
+# requests: follows redirects by default
+# httpx:    does NOT follow redirects by default
+# Wrong — will get 302 silently
+# Correct — always set explicitly when redirecting is expected
+### multipart/form-data for Auth
+### Timeout Configuration
+# Recommended: explicit timeout, never rely on default None (infinite wait)
+### Exception Handling
+## Typer + httpx Gotchas
+### Gotcha 1: Exception Swallowing in CliRunner
+### Gotcha 2: Typer Exit Codes
+- `raise typer.Exit(code=0)` — clean exit
+- `raise typer.Exit(code=1)` — error exit
+- `raise typer.Abort()` — "Aborted!" message, exit code 1
+- Unhandled exception — exit code 1, exception stored in `result.exception`
+### Gotcha 3: `invoke_without_command` Default is False
+### Gotcha 4: Rich + CliRunner Output Capture
+### Gotcha 5: httpx Redirects Are Off by Default
+### Gotcha 6: tomllib Opens Files in Binary Mode
+# CORRECT
+# WRONG — will raise TypeError
+## Dependency Versions (as of 2025)
+| Package | Minimum version | Notes |
+|---------|-----------------|-------|
+| typer | `>=0.12` | 0.12 added rich integration by default |
+| httpx | `>=0.28` | Stable API; 0.28 is current stable |
+| tomli-w | `>=1.1` | Stable; no breaking changes expected |
+| rich | `>=13.0` | Stable; 13.x is current major |
+| platformdirs | `>=4.2` | Current is 4.x; `user_config_path` available since 3.x |
+| hatchling | `>=1.24` | Build-time only; not in runtime deps |
+| pytest | `>=8.0` | Dev only |
+| pytest-cov | `>=5.0` | Dev only |
+## Installation Commands Reference
+# Initialize project with uv
+# Add runtime dependencies
+# Add dev dependencies
+# Local editable install (dev)
+# Build distribution
+# Install as tool (end users, isolated)
+# Run tests
+## Sources
+- uv build backend: https://docs.astral.sh/uv/concepts/build-backend/
+- uv project init: https://docs.astral.sh/uv/concepts/projects/init/
+- uv tools: https://docs.astral.sh/uv/concepts/tools/
+- PyPA pyproject.toml guide: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/
+- Typer testing: https://typer.tiangolo.com/tutorial/testing/
+- platformdirs: https://platformdirs.readthedocs.io/
+- httpx redirect behavior: https://www.python-httpx.org/compatibility/
+- httpx cookie persistence discussion: https://github.com/encode/httpx/discussions/2229
+- uv_build vs hatchling comparison: https://medium.com/@dynamicy/python-build-backends-in-2025-what-to-use-and-why-uv-build-vs-hatchling-vs-poetry-core-94dd6b92248f
+- thisdavej CLI packaging walkthrough: https://thisdavej.com/packaging-python-command-line-apps-the-modern-way-with-uv/
+<!-- GSD:stack-end -->
+
+<!-- GSD:conventions-start source:CONVENTIONS.md -->
+## Conventions
+
+Conventions not yet established. Will populate as patterns emerge during development.
+<!-- GSD:conventions-end -->
+
+<!-- GSD:architecture-start source:ARCHITECTURE.md -->
+## Architecture
+
+Architecture not yet mapped. Follow existing patterns found in the codebase.
+<!-- GSD:architecture-end -->
+
+<!-- GSD:skills-start source:skills/ -->
+## Project Skills
+
+No project skills found. Add skills to any of: `.claude/skills/`, `.agents/skills/`, `.cursor/skills/`, or `.github/skills/` with a `SKILL.md` index file.
+<!-- GSD:skills-end -->
+
+<!-- GSD:workflow-start source:GSD defaults -->
+## GSD Workflow Enforcement
+
+Before using Edit, Write, or other file-changing tools, start work through a GSD command so planning artifacts and execution context stay in sync.
+
+Use these entry points:
+- `/gsd-quick` for small fixes, doc updates, and ad-hoc tasks
+- `/gsd-debug` for investigation and bug fixing
+- `/gsd-execute-phase` for planned phase work
+
+Do not make direct repo edits outside a GSD workflow unless the user explicitly asks to bypass it.
+<!-- GSD:workflow-end -->
+
+
+
+<!-- GSD:profile-start -->
+## Developer Profile
+
+> Profile not yet configured. Run `/gsd-profile-user` to generate your developer profile.
+> This section is managed by `generate-claude-profile` -- do not edit manually.
+<!-- GSD:profile-end -->

holded_tt-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Villoh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.