friday-sh 0.1.0__tar.gz

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

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  pull_request:
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          python-version: "3.13"
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --frozen --group dev --group test
+
+      - name: Check formatting
+        run: uv run ruff format --check .
+
+      - name: Run lint
+        run: uv run ruff check .
+
+      - name: Run markdown lint
+        run: uvx rumdl check .
+
+      - name: Run type check
+        run: uv run ty check --exclude 'tests/'
+
+      - name: Run tests
+        run: uv run pytest -v

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

@@ -0,0 +1,106 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - master
+  workflow_dispatch:
+
+concurrency:
+  group: release-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: false
+
+permissions:
+  contents: write
+  id-token: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/friday-sh
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
+        with:
+          python-version: "3.13"
+          enable-cache: true
+
+      - name: Install dependencies
+        run: uv sync --frozen --group dev --group test
+
+      - name: Run validation
+        run: |
+          uv run ruff format --check .
+          uv run ruff check .
+          uvx rumdl check .
+          uv run ty check --exclude 'tests/'
+          uv run pytest -v
+
+      - name: Read package version
+        id: version
+        run: |
+          VERSION=$(python - <<'PY'
+          from pathlib import Path
+          import tomllib
+
+          data = tomllib.loads(Path('pyproject.toml').read_text())
+          print(data['project']['version'])
+          PY
+          )
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "tag=v$VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Check release state
+        id: state
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          TAG="${{ steps.version.outputs.tag }}"
+          if git ls-remote --tags origin "refs/tags/$TAG" | grep -q "$TAG"; then
+            echo "tag_exists=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "tag_exists=false" >> "$GITHUB_OUTPUT"
+          fi
+
+          if gh release view "$TAG" >/dev/null 2>&1; then
+            echo "release_exists=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "release_exists=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Create release tag
+        if: steps.state.outputs.tag_exists != 'true'
+        run: |
+          TAG="${{ steps.version.outputs.tag }}"
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git tag -a "$TAG" -m "release: $TAG"
+          git push origin "$TAG"
+
+      - name: Build distribution artifacts
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist
+          skip-existing: true
+
+      - name: Create GitHub release
+        if: steps.state.outputs.release_exists != 'true'
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          TAG="${{ steps.version.outputs.tag }}"
+          gh release create "$TAG" \
+            --title "$TAG" \
+            --generate-notes \
+            --verify-tag

friday_sh-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Environment
+.env
+
+# Virtual environments
+.venv
+.*_cache
+.codex

friday_sh-0.1.0/.gitmodules

@@ -0,0 +1,3 @@
+[submodule ".claude"]
+	path = .claude
+	url = https://github.com/oornnery/.agents

friday_sh-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

friday_sh-0.1.0/.rumdl.toml

@@ -0,0 +1,73 @@
+# rumdl configuration file
+
+# Inherit settings from another config file (relative to this file's directory)
+# extends = "../base.rumdl.toml"
+
+# Global configuration options
+[global]
+# List of rules to disable (uncomment and modify as needed)
+# disable = ["MD013", "MD033"]
+
+# List of rules to enable exclusively (replaces defaults; only these rules will run)
+# enable = ["MD001", "MD003", "MD004"]
+
+# Additional rules to enable on top of defaults (additive, does not replace)
+# Use this to activate opt-in rules like MD060, MD063, MD072, MD073, MD074
+# extend-enable = ["MD060", "MD063"]
+
+# Additional rules to disable on top of the disable list (additive)
+# extend-disable = ["MD041"]
+
+# List of file/directory patterns to include for linting (if provided, only these will be linted)
+# include = [
+#    "docs/*.md",
+#    "src/**/*.md",
+#    "README.md"
+# ]
+
+# List of file/directory patterns to exclude from linting
+exclude = [
+    # Common directories to exclude
+    ".git",
+    ".github",
+    "node_modules",
+    "vendor",
+    "dist",
+    "build",
+
+    # Specific files or patterns
+    "CHANGELOG.md",
+    "LICENSE.md",
+]
+
+# Respect .gitignore files when scanning directories (default: true)
+respect-gitignore = true
+
+# Markdown flavor/dialect (uncomment to enable)
+# Options: standard (default), gfm, commonmark, mkdocs, mdx, quarto
+# flavor = "mkdocs"
+
+# Rule-specific configurations (uncomment and modify as needed)
+
+# [MD003]
+# style = "atx"  # Heading style (atx, atx_closed, setext)
+
+# [MD004]
+# style = "asterisk"  # Unordered list style (asterisk, plus, dash, consistent)
+
+# [MD007]
+# indent = 4  # Unordered list indentation
+
+[MD013]
+line-length = 0 # Line length
+# code-blocks = false  # Exclude code blocks from line length check
+# tables = false  # Exclude tables from line length check
+# headings = true  # Include headings in line length check
+
+# [MD044]
+# names = ["rumdl", "Markdown", "GitHub"]  # Proper names that should be capitalized correctly
+# code-blocks = false  # Check code blocks for proper names (default: false, skips code blocks)
+
+[MD060]
+enabled = true
+style = "aligned"

friday_sh-0.1.0/CLAUDE.md

@@ -0,0 +1,52 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Stack
+
+- **Language**: Python 3.13
+- **Package manager**: uv
+- **Agent framework**: pydantic-ai
+- **CLI**: typer + rich + prompt_toolkit
+- **Linter/Formatter**: ruff
+- **Test runner**: pytest
+- **Task runner**: taskipy
+
+## Commands
+
+```bash
+uv sync                          # Install deps
+uv run task fmt                  # Format (ruff format)
+uv run task lint                 # Lint (ruff check)
+uv run task fix                  # Lint + autofix
+uv run task test                 # Run tests
+uv run task check                # fmt + lint + test (full validation)
+uv run pytest -v tests/path.py::test_name  # Single test
+```
+
+## Architecture
+
+```text
+src/friday/
+├── domain/          # Enums, value objects, permissions (pure, no IO)
+├── agent/           # pydantic-ai agent, modes, context, prompts/
+├── tools/           # Tool implementations (filesystem, shell)
+├── infra/           # Config, sessions, MCP client (IO boundary)
+├── cli/             # Typer app, commands, rich output
+└── shell/           # ZSH plugin
+```
+
+- **Prompts** live in `agent/prompts/*.md` with YAML frontmatter (tools, max_steps)
+- **Modes** (code, reader, write, debug) are loaded from those .md files
+- **z.ai** is wired as an OpenAI-compatible provider via `zai:` prefix
+- **Config** merges: env vars (`FRIDAY_*`) > `.env` > `~/.config/friday/config.toml`
+
+## Conventions
+
+See `.claude/rules/python.md` for full Python conventions. Key points:
+
+- `pathlib` over `os.path`, f-strings only, type all public functions
+- `logging` for app logs, `rich` for CLI output — never `print`
+- IO at edges only — domain and services must be pure
+- Prefer early returns over deep nesting
+- `ruff check` must pass before any commit