chore(release): Update version to v1.4.300

Merge pull request #1732 from ksylvan/kayvan/docker-publishing
CI Infra: Changelog Generation Tool + Docker Image Pubishing
2026-01-11 07:18:03 -05:00 · 2025-08-28 06:41:30 +00:00 · 2025-08-27 23:39:04 -07:00 · 2025-08-27 23:35:44 -07:00 · 2025-08-27 18:07:33 +00:00 · 2025-08-27 11:05:04 -07:00
47 changed files with 1284 additions and 534 deletions
--- a/.github/workflows/docker-publish-on-tag.yml
+++ b/.github/workflows/docker-publish-on-tag.yml
@@ -0,0 +1,149 @@
+name: Release Docker image on tag (GHCR + Docker Hub)
+
+on:
+  push:
+    tags: ["v*"] # e.g., v1.4.300
+
+permissions:
+  contents: read
+  packages: write # needed for GHCR with GITHUB_TOKEN
+
+jobs:
+  build-and-push:
+    # Optional safety: only run from your fork
+    if: ${{ github.repository_owner == 'ksylvan' }}
+    runs-on: ubuntu-latest
+
+    outputs:
+      is_latest: ${{ steps.latest.outputs.is_latest }}
+      owner_lc: ${{ steps.vars.outputs.owner_lc }}
+      repo_lc: ${{ steps.vars.outputs.repo_lc }}
+      dockerhub_user_lc: ${{ steps.dh.outputs.user_lc }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # full history for tag comparisons
+
+      - name: Fetch all tags
+        run: git fetch --tags --force
+
+      # More reliable cross-builds
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      # Compute lowercase owner/repo for registry image names
+      - name: Compute image names
+        id: vars
+        run: |
+          OWNER="${GITHUB_REPOSITORY_OWNER}"
+          REPO="${GITHUB_REPOSITORY#*/}"
+          echo "owner_lc=${OWNER,,}" >> "$GITHUB_OUTPUT"
+          echo "repo_lc=${REPO,,}" >> "$GITHUB_OUTPUT"
+
+      # Lowercase Docker Hub username (belt & suspenders)
+      - name: Lowercase Docker Hub username
+        id: dh
+        run: echo "user_lc=${DOCKERHUB_USERNAME,,}" >> "$GITHUB_OUTPUT"
+        env:
+          DOCKERHUB_USERNAME: ${{ vars.DOCKERHUB_USERNAME }}
+
+      # Determine if the current tag is the highest vX.Y.Z (no pre-releases)
+      - name: Is this the latest semver tag?
+        id: latest
+        shell: bash
+        run: |
+          CTAG="${GITHUB_REF_NAME}"
+          LATEST="$(git tag -l 'v[0-9]*.[0-9]*.[0-9]*' --sort=-v:refname | head -n1)"
+          echo "current_tag=$CTAG" >> "$GITHUB_OUTPUT"
+          echo "latest_tag=$LATEST" >> "$GITHUB_OUTPUT"
+          if [[ "$CTAG" == "$LATEST" ]]; then
+            echo "is_latest=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "is_latest=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      # Login to GHCR (uses built-in GITHUB_TOKEN)
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      # Login to Docker Hub
+      - name: Log in to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ steps.dh.outputs.user_lc }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      # Generate versioned tags/labels for BOTH registries (no :latest here)
+      - name: Extract metadata (tags, labels)
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: |
+            ghcr.io/${{ steps.vars.outputs.owner_lc }}/${{ steps.vars.outputs.repo_lc }}
+            docker.io/${{ steps.dh.outputs.user_lc }}/${{ steps.vars.outputs.repo_lc }}
+          tags: |
+            type=ref,event=tag                        # v1.4.300
+            type=semver,pattern={{version}}           # 1.4.300 (optional)
+            type=semver,pattern={{major}}.{{minor}}   # 1.4 (optional)
+          labels: |
+            org.opencontainers.image.source=${{ github.server_url }}/${{ github.repository }}
+
+      - name: Build and push (multi-arch)
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          platforms: linux/amd64,linux/arm64
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+  # Separate job to (re)point :latest — serialized to avoid races
+  move-latest:
+    needs: build-and-push
+    if: ${{ needs.build-and-push.outputs.is_latest == 'true' }}
+    runs-on: ubuntu-latest
+
+    # Only one "latest" move at a time; newer runs cancel older in-progress ones
+    concurrency:
+      group: latest-${{ github.repository }}
+      cancel-in-progress: true
+
+    steps:
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Log in to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ vars.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Tag :latest on GHCR
+        run: |
+          SRC="ghcr.io/${{ needs.build-and-push.outputs.owner_lc }}/${{ needs.build-and-push.outputs.repo_lc }}:${{ github.ref_name }}"
+          DST="ghcr.io/${{ needs.build-and-push.outputs.owner_lc }}/${{ needs.build-and-push.outputs.repo_lc }}:latest"
+          docker buildx imagetools create -t "$DST" "$SRC"
+
+      - name: Tag :latest on Docker Hub
+        run: |
+          SRC="docker.io/${{ needs.build-and-push.outputs.dockerhub_user_lc }}/${{ needs.build-and-push.outputs.repo_lc }}:${{ github.ref_name }}"
+          DST="docker.io/${{ needs.build-and-push.outputs.dockerhub_user_lc }}/${{ needs.build-and-push.outputs.repo_lc }}:latest"
+          docker buildx imagetools create -t "$DST" "$SRC"
--- a/.github/workflows/patterns.yaml
+++ b/.github/workflows/patterns.yaml
@@ -16,17 +16,23 @@ jobs:
          fetch-depth: 0

      - name: Verify Changes in Patterns Folder
+        id: check-changes
        run: |
          git fetch origin
          if git diff --quiet HEAD~1 -- data/patterns; then
            echo "No changes detected in patterns folder."
-            exit 1
+            echo "changes=false" >> $GITHUB_OUTPUT
+          else
+            echo "Changes detected in patterns folder."
+            echo "changes=true" >> $GITHUB_OUTPUT
          fi

      - name: Zip the Patterns Folder
+        if: steps.check-changes.outputs.changes == 'true'
        run: zip -r patterns.zip data/patterns/

      - name: Upload Patterns Artifact
+        if: steps.check-changes.outputs.changes == 'true'
        uses: actions/upload-artifact@v4
        with:
          name: patterns
--- a/.vscode/settings.json
+++ b/.vscode/settings.json
@@ -13,6 +13,7 @@
 		"Behrens",
 		"blindspots",
 		"Bombal",
+		"Buildx",
 		"Callirhoe",
 		"Callirrhoe",
 		"Cerebras",
@@ -25,11 +26,13 @@
 		"danielmiessler",
 		"davidanson",
 		"Debugf",
+		"debuglog",
 		"dedup",
 		"deepseek",
 		"Despina",
 		"direnv",
 		"DMARC",
+		"DOCKERHUB",
 		"dryrun",
 		"dsrp",
 		"editability",
@@ -55,6 +58,7 @@
 		"godotenv",
 		"gofmt",
 		"goimports",
+		"golint",
 		"gomod",
 		"gonic",
 		"goopenai",
@@ -71,6 +75,7 @@
 		"Hormozi's",
 		"horts",
 		"HTMLURL",
+		"imagetools",
 		"jaredmontoya",
 		"jessevdk",
 		"Jina",
@@ -106,6 +111,7 @@
 		"ollamaapi",
 		"openaiapi",
 		"opencode",
+		"opencontainers",
 		"openrouter",
 		"Orus",
 		"osascript",
@@ -131,7 +137,9 @@
 		"seaborn",
 		"semgrep",
 		"sess",
+		"sgaunet",
 		"shellquote",
+		"SSEHTTP",
 		"storer",
 		"Streamlit",
 		"stretchr",
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,98 @@
 # Changelog

+## v1.4.300 (2025-08-28)
+
+### PR [#1732](https://github.com/danielmiessler/Fabric/pull/1732) by [ksylvan](https://github.com/ksylvan): CI Infra: Changelog Generation Tool + Docker Image Pubishing
+
+- Add GitHub Actions workflow to publish Docker images on tags
+- Build multi-arch images with Buildx and QEMU across amd64, arm64
+- Tag images using semver; push to GHCR and Docker Hub
+- Gate patterns workflow steps on detected changes instead of failing
+- Auto-detect GitHub owner and repo from git remote URL
+
+## v1.4.299 (2025-08-27)
+
+### PR [#1731](https://github.com/danielmiessler/Fabric/pull/1731) by [ksylvan](https://github.com/ksylvan): chore: upgrade ollama dependency from v0.9.0 to v0.11.7
+
+- Updated ollama package from version 0.9.0 to 0.11.7
+- Fixed 8 security vulnerabilities including 5 high-severity CVEs that could cause denial of service attacks
+- Patched Ollama server vulnerabilities related to division by zero errors and memory exhaustion
+- Resolved security flaws that allowed malicious GGUF model file uploads to crash the server
+- Enhanced system stability and security posture through comprehensive dependency upgrade
+
+## v1.4.298 (2025-08-27)
+
+### PR [#1730](https://github.com/danielmiessler/Fabric/pull/1730) by [ksylvan](https://github.com/ksylvan): Modernize Dockerfile with Best Practices Implementation
+
+- Remove docker-test framework and simplify production docker setup by eliminating complex testing infrastructure
+- Delete entire docker-test directory including test runner scripts and environment configuration files
+- Implement multi-stage build optimization in production Dockerfile to improve build efficiency
+- Remove docker-compose.yml and start-docker.sh helper scripts to streamline container workflow
+- Update README documentation with cleaner Docker usage instructions and reduced image size benefits
+
+## v1.4.297 (2025-08-26)
+
+### PR [#1729](https://github.com/danielmiessler/Fabric/pull/1729) by [ksylvan](https://github.com/ksylvan): Add GitHub Community Health Documents
+
+- Add CODE_OF_CONDUCT defining respectful, collaborative community behavior
+- Add CONTRIBUTING with setup, testing, PR, changelog requirements
+- Add SECURITY policy with reporting process and response timelines
+- Add SUPPORT guide for bugs, features, discussions, expectations
+- Add docs README indexing guides, quick starts, contributor essentials
+
+## v1.4.296 (2025-08-26)
+
+### PR [#1728](https://github.com/danielmiessler/Fabric/pull/1728) by [ksylvan](https://github.com/ksylvan): Refactor Logging System to Use Centralized Debug Logger
+
+- Replace fmt.Fprintf/os.Stderr with centralized debuglog.Log across CLI and add unconditional Log function for important messages
+- Improve OAuth flow messaging and token refresh diagnostics with better error handling
+- Update tests to capture debuglog output via SetOutput for better test coverage
+- Convert Perplexity streaming errors to unified debug logging and emit file write notifications through debuglog
+- Standardize extension registry warnings and announce large audio processing steps via centralized logger
+
+## v1.4.295 (2025-08-24)
+
+### PR [#1727](https://github.com/danielmiessler/Fabric/pull/1727) by [ksylvan](https://github.com/ksylvan): Standardize Anthropic Beta Failure Logging
+
+- Refactor: route Anthropic beta failure logs through internal debug logger
+- Replace fmt.Fprintf stderr with debuglog.Debug for beta failures
+- Import internal log package and remove os dependency
+- Standardize logging level to debuglog.Basic for beta errors
+- Preserve fallback stream behavior when beta features fail
+
+## v1.4.294 (2025-08-20)
+
+### PR [#1723](https://github.com/danielmiessler/Fabric/pull/1723) by [ksylvan](https://github.com/ksylvan): docs: update README with Venice AI provider and Windows install script
+
+- Add Venice AI provider configuration with API endpoint
+- Document Venice AI as privacy-first open-source provider
+- Include PowerShell installation script for Windows users
+- Add debug levels section to table of contents
+- Update recent major features with v1.4.294 release notes
+
+## v1.4.293 (2025-08-19)
+
+### PR [#1718](https://github.com/danielmiessler/Fabric/pull/1718) by [ksylvan](https://github.com/ksylvan): Implement Configurable Debug Logging Levels
+
+- Add --debug flag controlling runtime logging verbosity levels
+- Introduce internal/log package with Off, Basic, Detailed, Trace
+- Replace ad-hoc Debugf and globals with centralized debug logger
+- Wire debug level during early CLI argument parsing
+- Add bash, zsh, fish completions for --debug levels
+
+## v1.4.292 (2025-08-18)
+
+### PR [#1717](https://github.com/danielmiessler/Fabric/pull/1717) by [ksylvan](https://github.com/ksylvan): Highlight default vendor/model in model listing
+
+- Update PrintWithVendor signature to accept default vendor and model
+- Mark default vendor/model with asterisk in non-shell output
+- Compare vendor and model case-insensitively when marking
+- Pass registry defaults to PrintWithVendor from CLI
+- Add test ensuring default selection appears with asterisk
+### Direct commits
+
+- Docs: update version number in README updates section from v1.4.290 to v1.4.291
+
 ## v1.4.291 (2025-08-18)

 ### PR [#1715](https://github.com/danielmiessler/Fabric/pull/1715) by [ksylvan](https://github.com/ksylvan): feat: add speech-to-text via OpenAI with transcription flags and comp…
--- a/README.md
+++ b/README.md
@@ -57,7 +57,8 @@ Below are the **new features and capabilities** we've added (newest first):

 ### Recent Major Features

- [v1.4.290](https://github.com/danielmiessler/fabric/releases/tag/v1.4.290) (Aug 18, 2025) — **Speech To Text**: Add OpenAI speech-to-text support with `--transcribe-file`, `--transcribe-model`, and `--split-media-file` flags.
+- [v1.4.294](https://github.com/danielmiessler/fabric/releases/tag/v1.4.294) (Aug 20, 2025) — **Venice AI Support**: Added the Venice AI provider. Venice is a Privacy-First, Open-Source AI provider. See their ["About Venice"](https://docs.venice.ai/overview/about-venice) page for details.
+- [v1.4.291](https://github.com/danielmiessler/fabric/releases/tag/v1.4.291) (Aug 18, 2025) — **Speech To Text**: Add OpenAI speech-to-text support with `--transcribe-file`, `--transcribe-model`, and `--split-media-file` flags.
 - [v1.4.287](https://github.com/danielmiessler/fabric/releases/tag/v1.4.287) (Aug 16, 2025) — **AI Reasoning**: Add Thinking to Gemini models and introduce `readme_updates` python script
 - [v1.4.286](https://github.com/danielmiessler/fabric/releases/tag/v1.4.286) (Aug 14, 2025) — **AI Reasoning**: Introduce Thinking Config Across Anthropic and OpenAI Providers
 - [v1.4.285](https://github.com/danielmiessler/fabric/releases/tag/v1.4.285) (Aug 13, 2025) — **Extended Context**: Enable One Million Token Context Beta Feature for Sonnet-4
@@ -139,6 +140,7 @@ Keep in mind that many of these were recorded when Fabric was Python-based, so r
      - [Bash Completion](#bash-completion)
      - [Fish Completion](#fish-completion)
  - [Usage](#usage)
+    - [Debug Levels](#debug-levels)
  - [Our approach to prompting](#our-approach-to-prompting)
  - [Examples](#examples)
  - [Just use the Patterns](#just-use-the-patterns)
@@ -209,6 +211,17 @@ To install Fabric, you can use the latest release binaries or install it from th

 `https://github.com/danielmiessler/fabric/releases/latest/download/fabric-windows-amd64.exe`

+Or via PowerShell, just copy and paste and run the following snippet to install the binary into `{HOME}\.local\bin`. Please make sure that directory is included in your `PATH`.
+
+```powershell
+$ErrorActionPreference = "Stop"
+$LATEST="https://github.com/danielmiessler/fabric/releases/latest/download/fabric-windows-amd64.exe"
+$DIR="${HOME}\.local\bin"
+New-Item -Path $DIR -ItemType Directory -Force
+Invoke-WebRequest -URI  "${LATEST}" -outfile "${DIR}\fabric.exe"
+& "${DIR}\fabric.exe" /version
+```
+
 #### macOS (arm64)

 `curl -L https://github.com/danielmiessler/fabric/releases/latest/download/fabric-darwin-arm64 > fabric && chmod +x fabric && ./fabric --version`
@@ -636,10 +649,20 @@ Application Options:
      --yt-dlp-args=                Additional arguments to pass to yt-dlp (e.g. '--cookies-from-browser brave')
      --thinking=                   Set reasoning/thinking level (e.g., off, low, medium, high, or
                                    numeric tokens for Anthropic or Google Gemini)
+      --debug=                     Set debug level (0: off, 1: basic, 2: detailed, 3: trace)
 Help Options:
  -h, --help                        Show this help message
 ```

+### Debug Levels
+
+Use the `--debug` flag to control runtime logging:
+
+- `0`: off (default)
+- `1`: basic debug info
+- `2`: detailed debugging
+- `3`: trace level
+
 ## Our approach to prompting

 Fabric _Patterns_ are different than most prompts you'll see.
--- a/cmd/fabric/version.go
+++ b/cmd/fabric/version.go
@@ -1,3 +1,3 @@
 package main

-var version = "v1.4.291"
+var version = "v1.4.300"
--- a/cmd/generate_changelog/changelog.db
+++ b/cmd/generate_changelog/changelog.db
--- a/cmd/generate_changelog/internal/release.go
+++ b/cmd/generate_changelog/internal/release.go
@@ -3,6 +3,9 @@ package internal
 import (
 	"context"
 	"fmt"
+	"os/exec"
+	"regexp"
+	"strings"

 	"github.com/danielmiessler/fabric/cmd/generate_changelog/internal/cache"
 	"github.com/danielmiessler/fabric/cmd/generate_changelog/internal/config"
@@ -17,17 +20,50 @@ type ReleaseManager struct {
 	repo        string
 }

+// getGitHubInfo extracts owner and repo from git remote origin URL
+func getGitHubInfo() (owner, repo string, err error) {
+	cmd := exec.Command("git", "remote", "get-url", "origin")
+	output, err := cmd.Output()
+	if err != nil {
+		return "", "", fmt.Errorf("failed to get git remote URL: %w", err)
+	}
+
+	url := strings.TrimSpace(string(output))
+
+	// Handle both SSH and HTTPS URLs
+	// SSH: git@github.com:owner/repo.git
+	// HTTPS: https://github.com/owner/repo.git
+	var re *regexp.Regexp
+	if strings.HasPrefix(url, "git@") {
+		re = regexp.MustCompile(`git@github\.com:([^/]+)/([^/.]+)(?:\.git)?`)
+	} else {
+		re = regexp.MustCompile(`https://github\.com/([^/]+)/([^/.]+)(?:\.git)?`)
+	}
+
+	matches := re.FindStringSubmatch(url)
+	if len(matches) < 3 {
+		return "", "", fmt.Errorf("invalid GitHub URL format: %s", url)
+	}
+
+	return matches[1], matches[2], nil
+}
+
 func NewReleaseManager(cfg *config.Config) (*ReleaseManager, error) {
 	cache, err := cache.New(cfg.CacheFile)
 	if err != nil {
 		return nil, fmt.Errorf("failed to create cache: %w", err)
 	}

+	owner, repo, err := getGitHubInfo()
+	if err != nil {
+		return nil, fmt.Errorf("failed to get GitHub repository info: %w", err)
+	}
+
 	return &ReleaseManager{
 		cache:       cache,
 		githubToken: cfg.GitHubToken,
-		owner:       "danielmiessler",
-		repo:        "fabric",
+		owner:       owner,
+		repo:        repo,
 	}, nil
 }

--- a/completions/_fabric
+++ b/completions/_fabric
@@ -145,6 +145,7 @@ _fabric() {
    '(--transcribe-file)--transcribe-file[Audio or video file to transcribe]:audio file:_files -g "*.mp3 *.mp4 *.mpeg *.mpga *.m4a *.wav *.webm"' \
    '(--transcribe-model)--transcribe-model[Model to use for transcription (separate from chat model)]:transcribe model:_fabric_transcription_models' \
    '(--split-media-file)--split-media-file[Split audio/video files larger than 25MB using ffmpeg]' \
+    '(--debug)--debug[Set debug level (0=off, 1=basic, 2=detailed, 3=trace)]:debug level:(0 1 2 3)' \
    '(--notification)--notification[Send desktop notification when command completes]' \
    '(--notification-command)--notification-command[Custom command to run for notifications]:notification command:' \
    '(-h --help)'{-h,--help}'[Show this help message]' \
--- a/completions/fabric.bash
+++ b/completions/fabric.bash
@@ -13,7 +13,7 @@ _fabric() {
  _get_comp_words_by_ref -n : cur prev words cword

  # Define all possible options/flags
-  local opts="--pattern -p --variable -v --context -C --session --attachment -a --setup -S --temperature -t --topp -T --stream -s --presencepenalty -P --raw -r --frequencypenalty -F --listpatterns -l --listmodels -L --listcontexts -x --listsessions -X --updatepatterns -U --copy -c --model -m --vendor -V --modelContextLength --output -o --output-session --latest -n --changeDefaultModel -d --youtube -y --playlist --transcript --transcript-with-timestamps --comments --metadata --yt-dlp-args --language -g --scrape_url -u --scrape_question -q --seed -e --thinking --wipecontext -w --wipesession -W --printcontext --printsession --readability --input-has-vars --no-variable-replacement --dry-run --serve --serveOllama --address --api-key --config --search --search-location --image-file --image-size --image-quality --image-compression --image-background --suppress-think --think-start-tag --think-end-tag --disable-responses-api --transcribe-file --transcribe-model --split-media-file --voice --list-gemini-voices --notification --notification-command --version --listextensions --addextension --rmextension --strategy --liststrategies --listvendors --shell-complete-list --help -h"
+  local opts="--pattern -p --variable -v --context -C --session --attachment -a --setup -S --temperature -t --topp -T --stream -s --presencepenalty -P --raw -r --frequencypenalty -F --listpatterns -l --listmodels -L --listcontexts -x --listsessions -X --updatepatterns -U --copy -c --model -m --vendor -V --modelContextLength --output -o --output-session --latest -n --changeDefaultModel -d --youtube -y --playlist --transcript --transcript-with-timestamps --comments --metadata --yt-dlp-args --language -g --scrape_url -u --scrape_question -q --seed -e --thinking --wipecontext -w --wipesession -W --printcontext --printsession --readability --input-has-vars --no-variable-replacement --dry-run --serve --serveOllama --address --api-key --config --search --search-location --image-file --image-size --image-quality --image-compression --image-background --suppress-think --think-start-tag --think-end-tag --disable-responses-api --transcribe-file --transcribe-model --split-media-file --voice --list-gemini-voices --notification --notification-command --debug --version --listextensions --addextension --rmextension --strategy --liststrategies --listvendors --shell-complete-list --help -h"

  # Helper function for dynamic completions
  _fabric_get_list() {
@@ -78,6 +78,10 @@ _fabric() {
    COMPREPLY=($(compgen -W "$(_fabric_get_list --list-transcription-models)" -- "${cur}"))
    return 0
    ;;
+  --debug)
+    COMPREPLY=($(compgen -W "0 1 2 3" -- "${cur}"))
+    return 0
+    ;;
  # Options requiring file/directory paths
  -a | --attachment | -o | --output | --config | --addextension | --image-file | --transcribe-file)
    _filedir
--- a/completions/fabric.fish
+++ b/completions/fabric.fish
@@ -99,6 +99,7 @@ function __fabric_register_completions
        complete -c $cmd -l voice -d "TTS voice name for supported models (e.g., Kore, Charon, Puck)" -a "(__fabric_get_gemini_voices)"
        complete -c $cmd -l transcribe-file -d "Audio or video file to transcribe" -r -a "*.mp3 *.mp4 *.mpeg *.mpga *.m4a *.wav *.webm"
        complete -c $cmd -l transcribe-model -d "Model to use for transcription (separate from chat model)" -a "(__fabric_get_transcription_models)"
+        complete -c $cmd -l debug -d "Set debug level (0=off, 1=basic, 2=detailed, 3=trace)" -a "0 1 2 3"
        complete -c $cmd -l notification-command -d "Custom command to run for notifications (overrides built-in notifications)"

        # Boolean flags (no arguments)
--- a/docs/CODE_OF_CONDUCT.md
+++ b/docs/CODE_OF_CONDUCT.md
@@ -0,0 +1,26 @@
+# Code of Conduct
+
+## Our Expectation
+
+We expect all contributors and community members to act with basic human decency and common sense.
+
+This project exists to help people augment their capabilities with AI, and we welcome contributions from anyone who shares this mission. We assume good faith and trust that everyone involved is here to build something valuable together.
+
+## Guidelines
+
+- **Be respectful**: Treat others as you'd want to be treated in a professional setting
+- **Be constructive**: Focus on the work and help make the project better
+- **Be collaborative**: We're all working toward the same goal - making Fabric more useful
+- **Use good judgment**: If you're not sure whether something is appropriate, it probably isn't
+
+## Reporting Issues
+
+If someone is being genuinely disruptive or harmful, please email the maintainers directly. We'll address legitimate concerns promptly and fairly.
+
+## Enforcement
+
+Maintainers reserve the right to remove content and restrict access for anyone who consistently acts in bad faith or disrupts the community.
+
+---
+
+*This project assumes contributors are adults who can work together professionally. If you can't do that, this isn't the right place for you.*
--- a/docs/CONTRIBUTING.md
+++ b/docs/CONTRIBUTING.md
@@ -0,0 +1,155 @@
+# Contributing to Fabric
+
+Thanks for contributing to Fabric! Here's what you need to know to get started quickly.
+
+## Quick Setup
+
+### Prerequisites
+
+- Go 1.24+ installed
+- Git configured with your details
+
+### Getting Started
+
+```bash
+# Clone and setup
+git clone https://github.com/danielmiessler/fabric.git
+cd fabric
+go build -o fabric ./cmd/fabric
+./fabric --setup
+
+# Run tests
+go test ./...
+```
+
+## Development Guidelines
+
+### Code Style
+
+- Follow standard Go conventions (`gofmt`, `golint`)
+- Use meaningful variable and function names
+- Write tests for new functionality
+- Keep functions focused and small
+
+### Commit Messages
+
+Use descriptive commit messages:
+
+```text
+feat: add new pattern for code analysis
+fix: resolve OAuth token refresh issue
+docs: update installation instructions
+```
+
+### Project Structure
+
+- `cmd/` - Executable commands
+- `internal/` - Private application code
+- `data/patterns/` - AI patterns
+- `docs/` - Documentation
+
+## Pull Request Process
+
+### Changelog Generation (REQUIRED)
+
+Before submitting your PR, generate a changelog entry:
+
+```bash
+cd cmd/generate_changelog
+go build -o generate_changelog .
+./generate_changelog --incoming-pr YOUR_PR_NUMBER
+```
+
+**Requirements:**
+
+- PR must be open and mergeable
+- Working directory must be clean
+- GitHub token available (GITHUB_TOKEN env var)
+
+**Optional flags:**
+
+- `--ai-summarize` - Enhanced AI-generated summaries
+- `--push` - Auto-push the changelog commit
+
+### PR Guidelines
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Write/update tests
+5. Generate changelog entry (see above)
+6. Submit PR with clear description
+
+### Review Process
+
+- PRs require maintainer review
+- Address feedback promptly
+- Keep PRs focused on single features/fixes
+- Update changelog if you make significant changes
+
+## Testing
+
+### Run Tests
+
+```bash
+# All tests
+go test ./...
+
+# Specific package
+go test ./internal/cli
+
+# With coverage
+go test -cover ./...
+```
+
+### Test Requirements
+
+- Unit tests for core functionality
+- Integration tests for external dependencies
+- Examples in documentation
+
+## Patterns
+
+### Creating Patterns
+
+Patterns go in `data/patterns/[pattern-name]/system.md`:
+
+```markdown
+# IDENTITY and PURPOSE
+You are an expert at...
+
+# STEPS
+- Step 1
+- Step 2
+
+# OUTPUT
+- Output format requirements
+
+# EXAMPLE
+Example output here
+```
+
+### Pattern Guidelines
+
+- Use clear, actionable language
+- Provide specific output formats
+- Include examples when helpful
+- Test with multiple AI providers
+
+## Documentation
+
+- Update README.md for new features
+- Add docs to `docs/` for complex features
+- Include usage examples
+- Keep documentation current
+
+## Getting Help
+
+- Check existing issues first
+- Ask questions in discussions
+- Tag maintainers for urgent issues
+- Be patient - maintainers are volunteers
+
+## License
+
+By contributing, you agree your contributions will be licensed under the MIT License.
--- a/docs/README.md
+++ b/docs/README.md
@@ -0,0 +1,88 @@
+# Fabric Documentation
+
+Welcome to the Fabric documentation! This directory contains detailed guides and technical documentation for various features and components of Fabric.
+
+## 📚 Available Documentation
+
+### Core Features
+
+**[Automated-Changelog-Usage.md](./Automated-Changelog-Usage.md)**
+Complete guide for developers on using the automated changelog system. Covers the workflow for generating PR changelog entries during development, including setup, validation, and CI/CD integration.
+
+**[YouTube-Processing.md](./YouTube-Processing.md)**
+Comprehensive guide for processing YouTube videos and playlists with Fabric. Covers transcript extraction, comment processing, metadata retrieval, and advanced yt-dlp configurations.
+
+**[Using-Speech-To-Text.md](./Using-Speech-To-Text.md)**
+Documentation for Fabric's speech-to-text capabilities using OpenAI's Whisper models. Learn how to transcribe audio and video files and process them through Fabric patterns.
+
+### User Interface & Experience
+
+**[Desktop-Notifications.md](./Desktop-Notifications.md)**
+Guide to setting up desktop notifications for Fabric commands. Useful for long-running tasks and multitasking scenarios with cross-platform notification support.
+
+**[Shell-Completions.md](./Shell-Completions.md)**
+Instructions for setting up intelligent tab completion for Fabric in Zsh, Bash, and Fish shells. Includes automated installation and manual setup options.
+
+**[Gemini-TTS.md](./Gemini-TTS.md)**
+Complete guide for using Google Gemini's text-to-speech features with Fabric. Covers voice selection, audio generation, and integration with Fabric patterns.
+
+### Development & Architecture
+
+**[Automated-ChangeLog.md](./Automated-ChangeLog.md)**
+Technical documentation outlining the automated CHANGELOG system architecture for CI/CD integration. Details the infrastructure and workflow for maintainers.
+
+**[Project-Restructured.md](./Project-Restructured.md)**
+Project restructuring plan and architectural decisions. Documents the transition to standard Go conventions and project organization improvements.
+
+**[NOTES.md](./NOTES.md)**
+Development notes on refactoring efforts, model management improvements, and architectural changes. Includes technical details on vendor and model abstraction.
+
+### Audio Resources
+
+**[voices/README.md](./voices/README.md)**
+Index of Gemini TTS voice samples demonstrating different AI voice characteristics available in Fabric.
+
+## 🗂️ Additional Resources
+
+### Configuration Files
+
+- `./notification-config.yaml` - Example notification configuration
+
+### Images
+
+- `images/` - Screenshots and visual documentation assets
+  - `fabric-logo-gif.gif` - Animated Fabric logo
+  - `fabric-summarize.png` - Screenshot of summarization feature
+  - `svelte-preview.png` - Web interface preview
+
+## 🚀 Quick Start
+
+New to Fabric? Start with these essential docs:
+
+1. **[../README.md](../README.md)** - Main project README with installation and basic usage
+2. **[Shell-Completions.md](./Shell-Completions.md)** - Set up tab completion for better CLI experience
+3. **[YouTube-Processing.md](./YouTube-Processing.md)** - Learn one of Fabric's most popular features
+4. **[Desktop-Notifications.md](./Desktop-Notifications.md)** - Get notified when long tasks complete
+
+## 🔧 For Contributors
+
+Contributing to Fabric? These docs are essential:
+
+1. **[./CONTRIBUTING.md](./CONTRIBUTING.md)** - Contribution guidelines and setup
+2. **[Automated-Changelog-Usage.md](./Automated-Changelog-Usage.md)** - Required workflow for PR submissions
+3. **[Project-Restructured.md](./Project-Restructured.md)** - Understanding project architecture
+4. **[NOTES.md](./NOTES.md)** - Current development priorities and patterns
+
+## 📝 Documentation Standards
+
+When adding new documentation:
+
+- Use clear, descriptive filenames
+- Include practical examples and use cases
+- Update this README index with your new docs
+- Follow the established markdown formatting conventions
+- Test all code examples before publication
+
+---
+
+*For general help and support, see [./SUPPORT.md](./SUPPORT.md)*
--- a/docs/SECURITY.md
+++ b/docs/SECURITY.md
@@ -0,0 +1,158 @@
+# Security Policy
+
+## Supported Versions
+
+We aim to provide security updates for the latest version of Fabric.
+
+We recommend always using the latest version of Fabric for security fixes and improvements.
+
+## Reporting Security Vulnerabilities
+
+**Please DO NOT report security vulnerabilities through public GitHub issues.**
+
+### Preferred Reporting Method
+
+Send security reports directly to: **<kayvan@sylvan.com>** and CC to the project maintainer at **<daniel@danielmiessler.com>**
+
+### What to Include
+
+Please provide the following information:
+
+1. **Vulnerability Type**: What kind of security issue (e.g., injection, authentication bypass, etc.)
+2. **Affected Components**: Which parts of Fabric are affected
+3. **Impact Assessment**: What could an attacker accomplish
+4. **Reproduction Steps**: Clear steps to reproduce the vulnerability
+5. **Proposed Fix**: If you have suggestions for remediation
+6. **Disclosure Timeline**: Your preferred timeline for public disclosure
+
+### Example Report Format
+
+```text
+Subject: [SECURITY] Brief description of vulnerability
+
+Vulnerability Type: SQL Injection
+Affected Component: Pattern database queries
+Impact: Potential data exposure
+Severity: High
+
+Reproduction Steps:
+1. Navigate to...
+2. Submit payload: ...
+3. Observe...
+
+Evidence:
+[Screenshots, logs, or proof of concept]
+
+Suggested Fix:
+Use parameterized queries instead of string concatenation...
+```
+
+## Security Considerations
+
+### API Keys and Secrets
+
+- Never commit API keys to the repository
+- Store secrets in environment variables or secure configuration
+- Use the built-in setup process for key management
+- Regularly rotate API keys
+
+### Input Validation
+
+- All user inputs are validated before processing
+- Special attention to pattern definitions and user content
+- URL validation for web scraping features
+
+### AI Provider Integration
+
+- Secure communication with AI providers (HTTPS/TLS)
+- Token handling follows provider best practices
+- No sensitive data logged or cached unencrypted
+
+### Network Security
+
+- Web server endpoints properly authenticated when required
+- CORS policies appropriately configured
+- Rate limiting implemented where necessary
+
+## Vulnerability Response Process
+
+1. **Report Received**: We'll acknowledge receipt within 24 hours
+2. **Initial Assessment**: We'll evaluate severity and impact within 72 hours
+3. **Investigation**: We'll investigate and develop fixes
+4. **Fix Development**: We'll create and test patches
+5. **Coordinated Disclosure**: We'll work with reporter on disclosure timeline
+6. **Release**: We'll release patched version with security advisory
+
+### Timeline Expectations
+
+- **Critical**: 1-7 days
+- **High**: 7-30 days
+- **Medium**: 30-90 days
+- **Low**: Next scheduled release
+
+## Bug Bounty
+
+We don't currently offer a formal bug bounty program, but we deeply appreciate security research and will:
+
+- Acknowledge contributors in release notes
+- Provide credit in security advisories
+- Consider swag or small rewards for significant findings
+
+## Security Best Practices for Users
+
+### Installation
+
+- Download Fabric only from official sources
+- Verify checksums when available
+- Keep installations up to date
+
+### Configuration
+
+- Use strong, unique API keys
+- Don't share configuration files containing secrets
+- Set appropriate file permissions on config directories
+
+### Usage
+
+- Be cautious with patterns that process sensitive data
+- Review AI provider terms for data handling
+- Consider using local models for sensitive content
+
+## Known Security Limitations
+
+### AI Provider Dependencies
+
+Fabric relies on external AI providers. Security depends partly on:
+
+- Provider security practices
+- Data transmission security
+- Provider data handling policies
+
+### Pattern Execution
+
+Custom patterns could potentially:
+
+- Process sensitive inputs inappropriately
+- Generate outputs containing sensitive information
+- Be used for adversarial prompt injection
+
+**Recommendation**: Review patterns carefully, especially those from untrusted sources.
+
+## Security Updates
+
+Security updates are distributed through:
+
+- GitHub Releases with security tags
+- Security advisories on GitHub
+- Project documentation updates
+
+Subscribe to the repository to receive notifications about security updates.
+
+## Contact
+
+For non-security issues, please use GitHub issues.
+For security concerns, email: **<kayvan@sylvan.com>** and CC to **<daniel@danielmiessler.com>**
+
+---
+
+*We take security seriously and appreciate the security research community's help in keeping Fabric secure.*
--- a/docs/SUPPORT.md
+++ b/docs/SUPPORT.md
@@ -0,0 +1,148 @@
+# Support
+
+## Getting Help with Fabric
+
+Need help with Fabric? Here are the best ways to get assistance:
+
+## 📖 Documentation First
+
+Before reaching out, check these resources:
+
+- **[README.md](../README.md)** - Installation, usage, and examples
+- **[docs/](./README.md)** - Detailed documentation
+- **[Patterns](../data/patterns/)** - Browse available AI patterns
+
+## 🐛 Bug Reports
+
+Found a bug? Please create an issue:
+
+**[Report a Bug](https://github.com/danielmiessler/fabric/issues/new?template=bug.yml)**
+
+Include:
+
+- Fabric version (`fabric --version`)
+- Operating system
+- Steps to reproduce
+- Expected vs actual behavior
+- Error messages/logs
+
+## 💡 Feature Requests
+
+Have an idea for Fabric? We'd love to hear it:
+
+**[Request a Feature](https://github.com/danielmiessler/fabric/issues/new)**
+
+Describe:
+
+- What you want to achieve
+- Why it would be useful
+- How you envision it working
+- Any alternatives you've considered
+
+## 🤔 Questions & Discussions
+
+For general questions, usage help, or community discussion:
+
+**[GitHub Discussions](https://github.com/danielmiessler/fabric/discussions)**
+
+Great for:
+
+- "How do I...?" questions
+- Sharing patterns you've created
+- Getting community advice
+- Feature brainstorming
+
+## 🏷️ Issue Labels
+
+When creating issues, maintainers will add appropriate labels:
+
+- `bug` - Something isn't working
+- `enhancement` - New feature request
+- `documentation` - Documentation improvements
+- `help wanted` - Community contributions welcome
+- `good first issue` - Great for new contributors
+- `question` - General questions
+- `pattern` - Related to AI patterns
+
+## 📋 Issue Templates
+
+We provide templates to help you create detailed reports:
+
+- **Bug Report** - Structured bug reporting
+- **Feature Request** - Detailed feature proposals
+- **Pattern Submission** - New pattern contributions
+
+## 🔒 Security Issues
+
+**DO NOT create public issues for security vulnerabilities.**
+
+See our [Security Policy](./SECURITY.md) for proper reporting procedures.
+
+## ⚡ Response Times
+
+We're a community-driven project with volunteer maintainers:
+
+- **Bugs**: We aim to acknowledge within 48 hours
+- **Features**: Response time varies based on complexity
+- **Questions**: Community often responds quickly
+- **Security**: See security policy for timelines
+
+## 🛠️ Self-Help Tips
+
+Before creating an issue, try:
+
+1. **Update Fabric**: `go install github.com/danielmiessler/fabric/cmd/fabric@latest`
+2. **Check existing issues**: Someone might have the same problem
+3. **Run setup**: `fabric --setup` can fix configuration issues
+4. **Test minimal example**: Isolate the problem
+
+## 🤝 Community Guidelines
+
+When asking for help:
+
+- Be specific and provide context
+- Include relevant details and error messages
+- Be patient - maintainers are volunteers
+- Help others when you can
+- Say thanks when someone helps you
+
+## 📞 Emergency Contact
+
+For urgent security issues only:
+
+- Email: <security@fabric.ai> (if available)
+- Maintainer: <daniel@danielmiessler.com>
+
+## 🎯 What We Can Help With
+
+✅ **We can help with:**
+
+- Installation and setup issues
+- Usage questions and examples
+- Bug reports and fixes
+- Feature discussions
+- Pattern creation guidance
+- Integration questions
+
+❌ **We cannot help with:**
+
+- Custom development for your specific use case
+- Troubleshooting your specific AI provider issues
+- General AI or programming tutorials
+- Commercial support agreements
+
+## 💪 Contributing Back
+
+The best way to get help is to help others:
+
+- Answer questions in discussions
+- Improve documentation
+- Share useful patterns
+- Report bugs clearly
+- Review pull requests
+
+See our [Contributing Guide](./CONTRIBUTING.md) for details.
+
+---
+
+*Remember: We're all here to make Fabric better. Be kind, be helpful, and let's build something amazing together!*
--- a/docs/Using-Speech-To-Text.md
+++ b/docs/Using-Speech-To-Text.md
@@ -0,0 +1,139 @@
+# Using Speech-To-Text (STT) with Fabric
+
+Fabric supports speech-to-text transcription of audio and video files using OpenAI's transcription models. This feature allows you to convert spoken content into text that can then be processed through Fabric's patterns.
+
+## Overview
+
+The STT feature integrates OpenAI's Whisper and GPT-4o transcription models to convert audio/video files into text. The transcribed text is automatically passed as input to your chosen pattern or chat session.
+
+## Requirements
+
+- OpenAI API key configured in Fabric
+- For files larger than 25MB: `ffmpeg` installed on your system
+- Supported audio/video formats: `.mp3`, `.mp4`, `.mpeg`, `.mpga`, `.m4a`, `.wav`, `.webm`
+
+## Basic Usage
+
+### Simple Transcription
+
+To transcribe an audio file and send the result to a pattern:
+
+```bash
+fabric --transcribe-file /path/to/audio.mp3 --transcribe-model whisper-1 --pattern summarize
+```
+
+### Transcription Only
+
+To just transcribe a file without applying a pattern:
+
+```bash
+fabric --transcribe-file /path/to/audio.mp3 --transcribe-model whisper-1
+```
+
+## Command Line Flags
+
+### Required Flags
+
+- `--transcribe-file`: Path to the audio or video file to transcribe
+- `--transcribe-model`: Model to use for transcription (required when using transcription)
+
+### Optional Flags
+
+- `--split-media-file`: Automatically split files larger than 25MB into chunks using ffmpeg
+
+## Available Models
+
+You can list all available transcription models with:
+
+```bash
+fabric --list-transcription-models
+```
+
+Currently supported models:
+
+- `whisper-1`: OpenAI's Whisper model
+- `gpt-4o-mini-transcribe`: GPT-4o Mini transcription model
+- `gpt-4o-transcribe`: GPT-4o transcription model
+
+## File Size Handling
+
+### Files Under 25MB
+
+Files under the 25MB limit are processed directly without any special handling.
+
+### Files Over 25MB
+
+For files exceeding OpenAI's 25MB limit, you have two options:
+
+1. **Manual handling**: The command will fail with an error message suggesting to use `--split-media-file`
+2. **Automatic splitting**: Use the `--split-media-file` flag to automatically split the file into chunks
+
+```bash
+fabric --transcribe-file large_recording.mp4 --transcribe-model whisper-1 --split-media-file --pattern summarize
+```
+
+When splitting is enabled:
+
+- Fabric uses `ffmpeg` to split the file into 10-minute segments initially
+- If segments are still too large, it reduces the segment time by half repeatedly
+- All segments are transcribed and the results are concatenated
+- Temporary files are automatically cleaned up after processing
+
+## Integration with Patterns
+
+The transcribed text is seamlessly integrated into Fabric's workflow:
+
+1. File is transcribed using the specified model
+2. Transcribed text becomes the input message
+3. Text is sent to the specified pattern or chat session
+
+### Example Workflows
+
+**Meeting transcription and summarization:**
+
+```bash
+fabric --transcribe-file meeting.mp4 --transcribe-model gpt-4o-transcribe --pattern summarize
+```
+
+**Interview analysis:**
+
+```bash
+fabric --transcribe-file interview.mp3 --transcribe-model whisper-1 --pattern extract_insights
+```
+
+**Large video file processing:**
+
+```bash
+fabric --transcribe-file presentation.mp4 --transcribe-model gpt-4o-transcribe --split-media-file --pattern create_summary
+```
+
+## Error Handling
+
+Common error scenarios:
+
+- **Unsupported format**: Only the listed audio/video formats are supported
+- **File too large**: Use `--split-media-file` for files over 25MB
+- **Missing ffmpeg**: Install ffmpeg for automatic file splitting
+- **Invalid model**: Use `--list-transcription-models` to see available models
+- **Missing model**: The `--transcribe-model` flag is required when using `--transcribe-file`
+
+## Technical Details
+
+### Implementation
+
+- Transcription is handled in `internal/cli/transcribe.go:14`
+- OpenAI-specific implementation in `internal/plugins/ai/openai/openai_audio.go:41`
+- File splitting uses ffmpeg with configurable segment duration
+- Supports any vendor that implements the `transcriber` interface
+
+### Processing Pipeline
+
+1. CLI validates file format and size
+2. If file > 25MB and splitting enabled, file is split using ffmpeg
+3. Each file/segment is sent to OpenAI's transcription API
+4. Results are concatenated with spaces between segments
+5. Transcribed text is passed as input to the main Fabric pipeline
+
+### Vendor Support
+
+Currently, only OpenAI is supported for transcription, but the interface allows for future expansion to other vendors that provide transcription capabilities.
--- a/go.mod
+++ b/go.mod
@@ -21,7 +21,7 @@ require (
 	github.com/joho/godotenv v1.5.1
 	github.com/kballard/go-shellquote v0.0.0-20180428030007-95032a82bc51
 	github.com/mattn/go-sqlite3 v1.14.28
-	github.com/ollama/ollama v0.9.0
+	github.com/ollama/ollama v0.11.7
 	github.com/openai/openai-go v1.8.2
 	github.com/otiai10/copy v1.14.1
 	github.com/pkg/errors v0.9.1
--- a/go.sum
+++ b/go.sum
@@ -180,8 +180,8 @@ github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w
 github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
 github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M=
 github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk=
-github.com/ollama/ollama v0.9.0 h1:GvdGhi8G/QMnFrY0TMLDy1bXua+Ify8KTkFe4ZY/OZs=
-github.com/ollama/ollama v0.9.0/go.mod h1:aio9yQ7nc4uwIbn6S0LkGEPgn8/9bNQLL1nHuH+OcD0=
+github.com/ollama/ollama v0.11.7 h1:CuYjaJ/YEnvLDpJocJbbVdpdVFyGA/OP6lKFyzZD4dI=
+github.com/ollama/ollama v0.11.7/go.mod h1:9+1//yWPsDE2u+l1a5mpaKrYw4VdnSsRU3ioq5BvMms=
 github.com/onsi/gomega v1.34.1 h1:EUMJIKUjM8sKjYbtxQI9A4z2o+rruxnzNvpknOXie6k=
 github.com/onsi/gomega v1.34.1/go.mod h1:kU1QgUvBDLXBJq618Xvm2LUX6rSAfRaFRTcdOeDLwwY=
 github.com/openai/openai-go v1.8.2 h1:UqSkJ1vCOPUpz9Ka5tS0324EJFEuOvMc+lA/EarJWP8=
--- a/internal/cli/chat.go
+++ b/internal/cli/chat.go
@@ -9,6 +9,7 @@ import (

 	"github.com/danielmiessler/fabric/internal/core"
 	"github.com/danielmiessler/fabric/internal/domain"
+	debuglog "github.com/danielmiessler/fabric/internal/log"
 	"github.com/danielmiessler/fabric/internal/plugins/db/fsdb"
 	"github.com/danielmiessler/fabric/internal/tools/notifications"
 )
@@ -135,7 +136,7 @@ func handleChatProcessing(currentFlags *Flags, registry *core.PluginRegistry, me
 	if chatOptions.Notification {
 		if err = sendNotification(chatOptions, chatReq.PatternName, result); err != nil {
 			// Log notification error but don't fail the main command
-			fmt.Fprintf(os.Stderr, "Failed to send notification: %v\n", err)
+			debuglog.Log("Failed to send notification: %v\n", err)
 		}
 	}

--- a/internal/cli/cli.go
+++ b/internal/cli/cli.go
@@ -3,10 +3,10 @@ package cli
 import (
 	"encoding/json"
 	"fmt"
-	"os"
 	"strings"

 	"github.com/danielmiessler/fabric/internal/core"
+	debuglog "github.com/danielmiessler/fabric/internal/log"
 	"github.com/danielmiessler/fabric/internal/plugins/ai/openai"
 	"github.com/danielmiessler/fabric/internal/tools/converter"
 	"github.com/danielmiessler/fabric/internal/tools/youtube"
@@ -34,7 +34,7 @@ func Cli(version string) (err error) {
 	var registry, err2 = initializeFabric()
 	if err2 != nil {
 		if !currentFlags.Setup {
-			fmt.Fprintln(os.Stderr, err2.Error())
+			debuglog.Log("%s\n", err2.Error())
 			currentFlags.Setup = true
 		}
 		// Return early if registry is nil to prevent panics in subsequent handlers
--- a/internal/cli/flags.go
+++ b/internal/cli/flags.go
@@ -13,6 +13,7 @@ import (

 	"github.com/danielmiessler/fabric/internal/chat"
 	"github.com/danielmiessler/fabric/internal/domain"
+	debuglog "github.com/danielmiessler/fabric/internal/log"
 	"github.com/danielmiessler/fabric/internal/util"
 	"github.com/jessevdk/go-flags"
 	"golang.org/x/text/language"
@@ -101,18 +102,12 @@ type Flags struct {
 	Notification                    bool                 `long:"notification" yaml:"notification" description:"Send desktop notification when command completes"`
 	NotificationCommand             string               `long:"notification-command" yaml:"notificationCommand" description:"Custom command to run for notifications (overrides built-in notifications)"`
 	Thinking                        domain.ThinkingLevel `long:"thinking" yaml:"thinking" description:"Set reasoning/thinking level (e.g., off, low, medium, high, or numeric tokens for Anthropic or Google Gemini)"`
-}
-
-var debug = false
-
-func Debugf(format string, a ...interface{}) {
-	if debug {
-		fmt.Printf("DEBUG: "+format, a...)
-	}
+	Debug                           int                  `long:"debug" description:"Set debug level (0=off, 1=basic, 2=detailed, 3=trace)" default:"0"`
 }

 // Init Initialize flags. returns a Flags struct and an error
 func Init() (ret *Flags, err error) {
+	debuglog.SetLevel(debuglog.LevelFromInt(parseDebugLevel(os.Args[1:])))
 	// Track which yaml-configured flags were set on CLI
 	usedFlags := make(map[string]bool)
 	yamlArgsScan := os.Args[1:]
@@ -128,11 +123,11 @@ func Init() (ret *Flags, err error) {
 			shortTag := field.Tag.Get("short")
 			if longTag != "" {
 				flagToYamlTag[longTag] = yamlTag
-				Debugf("Mapped long flag %s to yaml tag %s\n", longTag, yamlTag)
+				debuglog.Debug(debuglog.Detailed, "Mapped long flag %s to yaml tag %s\n", longTag, yamlTag)
 			}
 			if shortTag != "" {
 				flagToYamlTag[shortTag] = yamlTag
-				Debugf("Mapped short flag %s to yaml tag %s\n", shortTag, yamlTag)
+				debuglog.Debug(debuglog.Detailed, "Mapped short flag %s to yaml tag %s\n", shortTag, yamlTag)
 			}
 		}
 	}
@@ -144,7 +139,7 @@ func Init() (ret *Flags, err error) {
 		if flag != "" {
 			if yamlTag, exists := flagToYamlTag[flag]; exists {
 				usedFlags[yamlTag] = true
-				Debugf("CLI flag used: %s (yaml: %s)\n", flag, yamlTag)
+				debuglog.Debug(debuglog.Detailed, "CLI flag used: %s (yaml: %s)\n", flag, yamlTag)
 			}
 		}
 	}
@@ -156,6 +151,7 @@ func Init() (ret *Flags, err error) {
 	if args, err = parser.Parse(); err != nil {
 		return
 	}
+	debuglog.SetLevel(debuglog.LevelFromInt(ret.Debug))

 	// Check to see if a ~/.config/fabric/config.yaml config file exists (only when user didn't specify a config)
 	if ret.Config == "" {
@@ -163,7 +159,7 @@ func Init() (ret *Flags, err error) {
 		if defaultConfigPath, err := util.GetDefaultConfigPath(); err == nil && defaultConfigPath != "" {
 			ret.Config = defaultConfigPath
 		} else if err != nil {
-			Debugf("Could not determine default config path: %v\n", err)
+			debuglog.Debug(debuglog.Detailed, "Could not determine default config path: %v\n", err)
 		}
 	}

@@ -188,13 +184,13 @@ func Init() (ret *Flags, err error) {
 					if flagField.CanSet() {
 						if yamlField.Type() != flagField.Type() {
 							if err := assignWithConversion(flagField, yamlField); err != nil {
-								Debugf("Type conversion failed for %s: %v\n", yamlTag, err)
+								debuglog.Debug(debuglog.Detailed, "Type conversion failed for %s: %v\n", yamlTag, err)
 								continue
 							}
 						} else {
 							flagField.Set(yamlField)
 						}
-						Debugf("Applied YAML value for %s: %v\n", yamlTag, yamlField.Interface())
+						debuglog.Debug(debuglog.Detailed, "Applied YAML value for %s: %v\n", yamlTag, yamlField.Interface())
 					}
 				}
 			}
@@ -220,6 +216,22 @@ func Init() (ret *Flags, err error) {
 	return
 }

+func parseDebugLevel(args []string) int {
+	for i := 0; i < len(args); i++ {
+		arg := args[i]
+		if arg == "--debug" && i+1 < len(args) {
+			if lvl, err := strconv.Atoi(args[i+1]); err == nil {
+				return lvl
+			}
+		} else if strings.HasPrefix(arg, "--debug=") {
+			if lvl, err := strconv.Atoi(strings.TrimPrefix(arg, "--debug=")); err == nil {
+				return lvl
+			}
+		}
+	}
+	return 0
+}
+
 func extractFlag(arg string) string {
 	var flag string
 	if strings.HasPrefix(arg, "--") {
@@ -289,7 +301,7 @@ func loadYAMLConfig(configPath string) (*Flags, error) {
 		return nil, fmt.Errorf("error parsing config file: %w", err)
 	}

-	Debugf("Config: %v\n", config)
+	debuglog.Debug(debuglog.Detailed, "Config: %v\n", config)

 	return config, nil
 }
--- a/internal/cli/listing.go
+++ b/internal/cli/listing.go
@@ -41,7 +41,7 @@ func handleListingCommands(currentFlags *Flags, fabricDb *fsdb.Db, registry *cor
 		if currentFlags.ShellCompleteOutput {
 			models.Print(true)
 		} else {
-			models.PrintWithVendor(false)
+			models.PrintWithVendor(false, registry.Defaults.Vendor.Value, registry.Defaults.Model.Value)
 		}
 		return true, nil
 	}
--- a/internal/cli/output.go
+++ b/internal/cli/output.go
@@ -7,6 +7,7 @@ import (
 	"strings"

 	"github.com/atotto/clipboard"
+	debuglog "github.com/danielmiessler/fabric/internal/log"
 )

 func CopyToClipboard(message string) (err error) {
@@ -30,7 +31,7 @@ func CreateOutputFile(message string, fileName string) (err error) {
 	if _, err = file.WriteString(message); err != nil {
 		err = fmt.Errorf("error writing to file: %v", err)
 	} else {
-		fmt.Fprintf(os.Stderr, "\n\n[Output also written to %s]\n", fileName)
+		debuglog.Log("\n\n[Output also written to %s]\n", fileName)
 	}
 	return
 }
--- a/internal/core/plugin_registry.go
+++ b/internal/core/plugin_registry.go
@@ -10,6 +10,7 @@ import (
 	"strconv"
 	"strings"

+	debuglog "github.com/danielmiessler/fabric/internal/log"
 	"github.com/danielmiessler/fabric/internal/plugins/ai/anthropic"
 	"github.com/danielmiessler/fabric/internal/plugins/ai/azure"
 	"github.com/danielmiessler/fabric/internal/plugins/ai/bedrock"
@@ -20,7 +21,7 @@ import (
 	"github.com/danielmiessler/fabric/internal/plugins/ai/ollama"
 	"github.com/danielmiessler/fabric/internal/plugins/ai/openai"
 	"github.com/danielmiessler/fabric/internal/plugins/ai/openai_compatible"
-	"github.com/danielmiessler/fabric/internal/plugins/ai/perplexity" // Added Perplexity plugin
+	"github.com/danielmiessler/fabric/internal/plugins/ai/perplexity"
 	"github.com/danielmiessler/fabric/internal/plugins/strategy"

 	"github.com/samber/lo"
@@ -339,7 +340,7 @@ func (o *PluginRegistry) GetChatter(model string, modelContextLength int, vendor
 		} else {
 			availableVendors := models.FindGroupsByItem(model)
 			if len(availableVendors) > 1 {
-				fmt.Fprintf(os.Stderr, "Warning: multiple vendors provide model %s: %s. Using %s. Specify --vendor to select a vendor.\n", model, strings.Join(availableVendors, ", "), availableVendors[0])
+				debuglog.Log("Warning: multiple vendors provide model %s: %s. Using %s. Specify --vendor to select a vendor.\n", model, strings.Join(availableVendors, ", "), availableVendors[0])
 			}
 			ret.vendor = vendorManager.FindByName(models.FindGroupsByItemFirst(model))
 		}
--- a/internal/core/plugin_registry_test.go
+++ b/internal/core/plugin_registry_test.go
@@ -10,6 +10,7 @@ import (

 	"github.com/danielmiessler/fabric/internal/chat"
 	"github.com/danielmiessler/fabric/internal/domain"
+	debuglog "github.com/danielmiessler/fabric/internal/log"
 	"github.com/danielmiessler/fabric/internal/plugins"
 	"github.com/danielmiessler/fabric/internal/plugins/ai"
 	"github.com/danielmiessler/fabric/internal/plugins/db/fsdb"
@@ -72,7 +73,12 @@ func TestGetChatter_WarnsOnAmbiguousModel(t *testing.T) {
 	r, w, _ := os.Pipe()
 	oldStderr := os.Stderr
 	os.Stderr = w
-	defer func() { os.Stderr = oldStderr }()
+	// Redirect log output to our pipe to capture unconditional log messages
+	debuglog.SetOutput(w)
+	defer func() {
+		os.Stderr = oldStderr
+		debuglog.SetOutput(oldStderr)
+	}()

 	chatter, err := registry.GetChatter("shared-model", 0, "", "", false, false)
 	w.Close()
--- a/internal/log/log.go
+++ b/internal/log/log.go
@@ -0,0 +1,78 @@
+package log
+
+import (
+	"fmt"
+	"io"
+	"os"
+	"sync"
+)
+
+// Level represents the debug verbosity.
+type Level int
+
+const (
+	// Off disables all debug output.
+	Off Level = iota
+	// Basic provides minimal debugging information.
+	Basic
+	// Detailed provides more verbose debugging.
+	Detailed
+	// Trace is the most verbose level.
+	Trace
+)
+
+var (
+	mu     sync.RWMutex
+	level  Level     = Off
+	output io.Writer = os.Stderr
+)
+
+// SetLevel sets the global debug level.
+func SetLevel(l Level) {
+	mu.Lock()
+	level = l
+	mu.Unlock()
+}
+
+// LevelFromInt converts an int to a Level.
+func LevelFromInt(i int) Level {
+	switch {
+	case i <= 0:
+		return Off
+	case i == 1:
+		return Basic
+	case i == 2:
+		return Detailed
+	case i >= 3:
+		return Trace
+	default:
+		return Off
+	}
+}
+
+// Debug writes a debug message if the global level permits.
+func Debug(l Level, format string, a ...interface{}) {
+	mu.RLock()
+	current := level
+	w := output
+	mu.RUnlock()
+	if current >= l {
+		fmt.Fprintf(w, "DEBUG: "+format, a...)
+	}
+}
+
+// Log writes a message unconditionally to stderr.
+// This is for important messages that should always be shown regardless of debug level.
+func Log(format string, a ...interface{}) {
+	mu.RLock()
+	w := output
+	mu.RUnlock()
+	fmt.Fprintf(w, format, a...)
+}
+
+// SetOutput allows overriding the output destination for debug logs.
+func SetOutput(w io.Writer) {
+	mu.Lock()
+	output = w
+	mu.Unlock()
+}
--- a/internal/plugins/ai/anthropic/anthropic.go
+++ b/internal/plugins/ai/anthropic/anthropic.go
@@ -4,7 +4,6 @@ import (
 	"context"
 	"fmt"
 	"net/http"
-	"os"
 	"strconv"
 	"strings"

@@ -12,6 +11,7 @@ import (
 	"github.com/anthropics/anthropic-sdk-go/option"
 	"github.com/danielmiessler/fabric/internal/chat"
 	"github.com/danielmiessler/fabric/internal/domain"
+	debuglog "github.com/danielmiessler/fabric/internal/log"
 	"github.com/danielmiessler/fabric/internal/plugins"
 	"github.com/danielmiessler/fabric/internal/util"
 )
@@ -195,7 +195,7 @@ func (an *Client) SendStream(
 	}
 	stream := an.client.Messages.NewStreaming(ctx, params, reqOpts...)
 	if stream.Err() != nil && len(betas) > 0 {
-		fmt.Fprintf(os.Stderr, "Anthropic beta feature %s failed: %v\n", strings.Join(betas, ","), stream.Err())
+		debuglog.Debug(debuglog.Basic, "Anthropic beta feature %s failed: %v\n", strings.Join(betas, ","), stream.Err())
 		stream = an.client.Messages.NewStreaming(ctx, params)
 	}

@@ -289,7 +289,7 @@ func (an *Client) Send(ctx context.Context, msgs []*chat.ChatCompletionMessage,
 	}
 	if message, err = an.client.Messages.New(ctx, params, reqOpts...); err != nil {
 		if len(betas) > 0 {
-			fmt.Fprintf(os.Stderr, "Anthropic beta feature %s failed: %v\n", strings.Join(betas, ","), err)
+			debuglog.Debug(debuglog.Basic, "Anthropic beta feature %s failed: %v\n", strings.Join(betas, ","), err)
 			if message, err = an.client.Messages.New(ctx, params); err != nil {
 				return
 			}
--- a/internal/plugins/ai/anthropic/oauth.go
+++ b/internal/plugins/ai/anthropic/oauth.go
@@ -9,11 +9,11 @@ import (
 	"fmt"
 	"io"
 	"net/http"
-	"os"
 	"os/exec"
 	"strings"
 	"time"

+	debuglog "github.com/danielmiessler/fabric/internal/log"
 	"github.com/danielmiessler/fabric/internal/util"
 	"golang.org/x/oauth2"
 )
@@ -77,7 +77,7 @@ func (t *OAuthTransport) getValidToken(tokenIdentifier string) (string, error) {
 	}
 	// If no token exists, run OAuth flow
 	if token == nil {
-		fmt.Fprintln(os.Stderr, "No OAuth token found, initiating authentication...")
+		debuglog.Log("No OAuth token found, initiating authentication...\n")
 		newAccessToken, err := RunOAuthFlow(tokenIdentifier)
 		if err != nil {
 			return "", fmt.Errorf("failed to authenticate: %w", err)
@@ -87,11 +87,11 @@ func (t *OAuthTransport) getValidToken(tokenIdentifier string) (string, error) {

 	// Check if token needs refresh (5 minute buffer)
 	if token.IsExpired(5) {
-		fmt.Fprintln(os.Stderr, "OAuth token expired, refreshing...")
+		debuglog.Log("OAuth token expired, refreshing...\n")
 		newAccessToken, err := RefreshToken(tokenIdentifier)
 		if err != nil {
 			// If refresh fails, try re-authentication
-			fmt.Fprintln(os.Stderr, "Token refresh failed, re-authenticating...")
+			debuglog.Log("Token refresh failed, re-authenticating...\n")
 			newAccessToken, err = RunOAuthFlow(tokenIdentifier)
 			if err != nil {
 				return "", fmt.Errorf("failed to refresh or re-authenticate: %w", err)
@@ -143,13 +143,13 @@ func RunOAuthFlow(tokenIdentifier string) (token string, err error) {
 		if err == nil && existingToken != nil {
 			// If token exists but is expired, try refreshing first
 			if existingToken.IsExpired(5) {
-				fmt.Fprintln(os.Stderr, "Found expired OAuth token, attempting refresh...")
+				debuglog.Log("Found expired OAuth token, attempting refresh...\n")
 				refreshedToken, refreshErr := RefreshToken(tokenIdentifier)
 				if refreshErr == nil {
-					fmt.Fprintln(os.Stderr, "Token refresh successful")
+					debuglog.Log("Token refresh successful\n")
 					return refreshedToken, nil
 				}
-				fmt.Fprintf(os.Stderr, "Token refresh failed (%v), proceeding with full OAuth flow...\n", refreshErr)
+				debuglog.Log("Token refresh failed (%v), proceeding with full OAuth flow...\n", refreshErr)
 			} else {
 				// Token exists and is still valid
 				return existingToken.AccessToken, nil
@@ -176,10 +176,10 @@ func RunOAuthFlow(tokenIdentifier string) (token string, err error) {
 		oauth2.SetAuthURLParam("state", verifier),
 	)

-	fmt.Fprintln(os.Stderr, "Open the following URL in your browser. Fabric would like to authorize:")
-	fmt.Fprintln(os.Stderr, authURL)
+	debuglog.Log("Open the following URL in your browser. Fabric would like to authorize:\n")
+	debuglog.Log("%s\n", authURL)
 	openBrowser(authURL)
-	fmt.Fprint(os.Stderr, "Paste the authorization code here: ")
+	debuglog.Log("Paste the authorization code here: ")
 	var code string
 	fmt.Scanln(&code)
 	parts := strings.SplitN(code, "#", 2)
--- a/internal/plugins/ai/models.go
+++ b/internal/plugins/ai/models.go
@@ -18,7 +18,8 @@ type VendorsModels struct {

 // PrintWithVendor prints models including their vendor on each line.
 // When shellCompleteList is true, output is suitable for shell completion.
-func (o *VendorsModels) PrintWithVendor(shellCompleteList bool) {
+// Default vendor and model are highlighted with an asterisk.
+func (o *VendorsModels) PrintWithVendor(shellCompleteList bool, defaultVendor, defaultModel string) {
 	if !shellCompleteList {
 		fmt.Printf("\n%v:\n", o.SelectionLabel)
 	}
@@ -42,7 +43,11 @@ func (o *VendorsModels) PrintWithVendor(shellCompleteList bool) {
 			if shellCompleteList {
 				fmt.Printf("%s|%s\n", groupItems.Group, item)
 			} else {
-				fmt.Printf("\t[%d]\t%s|%s\n", currentItemIndex, groupItems.Group, item)
+				mark := "       "
+				if strings.EqualFold(groupItems.Group, defaultVendor) && strings.EqualFold(item, defaultModel) {
+					mark = "      *"
+				}
+				fmt.Printf("%s\t[%d]\t%s|%s\n", mark, currentItemIndex, groupItems.Group, item)
 			}
 		}
 	}
--- a/internal/plugins/ai/models_test.go
+++ b/internal/plugins/ai/models_test.go
@@ -1,6 +1,9 @@
 package ai

 import (
+	"io"
+	"os"
+	"strings"
 	"testing"
 )

@@ -31,3 +34,23 @@ func TestFindVendorsByModel(t *testing.T) {
 		t.Fatalf("FindVendorsByModel() = %v, want %v", foundVendors, []string{"vendor1"})
 	}
 }
+
+func TestPrintWithVendorMarksDefault(t *testing.T) {
+	vendors := NewVendorsModels()
+	vendors.AddGroupItems("vendor1", []string{"model1"}...)
+	vendors.AddGroupItems("vendor2", []string{"model2"}...)
+
+	r, w, _ := os.Pipe()
+	oldStdout := os.Stdout
+	os.Stdout = w
+
+	vendors.PrintWithVendor(false, "vendor2", "model2")
+
+	w.Close()
+	os.Stdout = oldStdout
+	out, _ := io.ReadAll(r)
+
+	if !strings.Contains(string(out), "      *\t[2]\tvendor2|model2") {
+		t.Fatalf("default model not marked: %s", out)
+	}
+}
--- a/internal/plugins/ai/openai/openai_audio.go
+++ b/internal/plugins/ai/openai/openai_audio.go
@@ -11,6 +11,8 @@ import (
 	"sort"
 	"strings"

+	debuglog "github.com/danielmiessler/fabric/internal/log"
+
 	openai "github.com/openai/openai-go"
 )

@@ -56,18 +58,14 @@ func (o *Client) TranscribeFile(ctx context.Context, filePath, model string, spl
 		return "", err
 	}

-	debug := os.Getenv("FABRIC_STT_DEBUG") != ""
-
 	var files []string
 	var cleanup func()
 	if info.Size() > MaxAudioFileSize {
 		if !split {
 			return "", fmt.Errorf("file %s exceeds 25MB limit; use --split-media-file to enable automatic splitting", filePath)
 		}
-		if debug {
-			fmt.Fprintf(os.Stderr, "File %s is larger than the size limit... breaking it up into chunks...\n", filePath)
-		}
-		if files, cleanup, err = splitAudioFile(filePath, ext, MaxAudioFileSize, debug); err != nil {
+		debuglog.Log("File %s is larger than the size limit... breaking it up into chunks...\n", filePath)
+		if files, cleanup, err = splitAudioFile(filePath, ext, MaxAudioFileSize); err != nil {
 			return "", err
 		}
 		defer cleanup()
@@ -77,9 +75,7 @@ func (o *Client) TranscribeFile(ctx context.Context, filePath, model string, spl

 	var builder strings.Builder
 	for i, f := range files {
-		if debug {
-			fmt.Fprintf(os.Stderr, "Using model %s to transcribe part %d (file name: %s)...\n", model, i+1, f)
-		}
+		debuglog.Log("Using model %s to transcribe part %d (file name: %s)...\n", model, i+1, f)
 		var chunk *os.File
 		if chunk, err = os.Open(f); err != nil {
 			return "", err
@@ -105,7 +101,7 @@ func (o *Client) TranscribeFile(ctx context.Context, filePath, model string, spl

 // splitAudioFile splits the source file into chunks smaller than maxSize using ffmpeg.
 // It returns the list of chunk file paths and a cleanup function.
-func splitAudioFile(src, ext string, maxSize int64, debug bool) (files []string, cleanup func(), err error) {
+func splitAudioFile(src, ext string, maxSize int64) (files []string, cleanup func(), err error) {
 	if _, err = exec.LookPath("ffmpeg"); err != nil {
 		return nil, nil, fmt.Errorf("ffmpeg not found: please install it")
 	}
@@ -119,9 +115,7 @@ func splitAudioFile(src, ext string, maxSize int64, debug bool) (files []string,
 	segmentTime := 600 // start with 10 minutes
 	for {
 		pattern := filepath.Join(dir, "chunk-%03d"+ext)
-		if debug {
-			fmt.Fprintf(os.Stderr, "Running ffmpeg to split audio into %d-second chunks...\n", segmentTime)
-		}
+		debuglog.Log("Running ffmpeg to split audio into %d-second chunks...\n", segmentTime)
 		cmd := exec.Command("ffmpeg", "-y", "-i", src, "-f", "segment", "-segment_time", fmt.Sprintf("%d", segmentTime), "-c", "copy", pattern)
 		var stderr bytes.Buffer
 		cmd.Stderr = &stderr
--- a/internal/plugins/ai/openai_compatible/providers_config.go
+++ b/internal/plugins/ai/openai_compatible/providers_config.go
@@ -102,6 +102,11 @@ var ProviderMap = map[string]ProviderConfig{
 		BaseURL:             "https://api.together.xyz/v1",
 		ImplementsResponses: false,
 	},
+	"Venice AI": {
+		Name:                "Venice AI",
+		BaseURL:             "https://api.venice.ai/api/v1",
+		ImplementsResponses: false,
+	},
 }

 // GetProviderByName returns the provider configuration for a given name with O(1) lookup
--- a/internal/plugins/ai/perplexity/perplexity.go
+++ b/internal/plugins/ai/perplexity/perplexity.go
@@ -4,9 +4,10 @@ import (
 	"context"
 	"fmt"
 	"os"
-	"sync" // Added sync package
+	"sync"

 	"github.com/danielmiessler/fabric/internal/domain"
+	debuglog "github.com/danielmiessler/fabric/internal/log"
 	"github.com/danielmiessler/fabric/internal/plugins"
 	perplexity "github.com/sgaunet/perplexity-go/v2"

@@ -171,7 +172,7 @@ func (c *Client) SendStream(msgs []*chat.ChatCompletionMessage, opts *domain.Cha
 		if err != nil {
 			// Log error, can't send to string channel directly.
 			// Consider a mechanism to propagate this error if needed.
-			fmt.Fprintf(os.Stderr, "perplexity streaming error: %v\\n", err) // Corrected capitalization
+			debuglog.Log("perplexity streaming error: %v\n", err)
 			// If the error occurs during stream setup, the channel might not have been closed by the receiver loop.
 			// However, closing it here might cause a panic if the receiver loop also tries to close it.
 			// close(channel) // Caution: Uncommenting this may cause panic, as channel is closed in the receiver goroutine.
--- a/internal/plugins/ai/vendors.go
+++ b/internal/plugins/ai/vendors.go
@@ -148,7 +148,6 @@ func (o *VendorsManager) setupVendorTo(vendor Vendor, configuredVendors map[stri
 		delete(configuredVendors, vendor.GetName())
 		fmt.Printf("[%v] skipped\n", vendor.GetName())
 	}
-	return
 }

 type modelResult struct {
--- a/internal/plugins/template/extension_registry.go
+++ b/internal/plugins/template/extension_registry.go
@@ -10,8 +10,9 @@ import (
 	"strings"
 	"time"

+	debuglog "github.com/danielmiessler/fabric/internal/log"
+
 	"gopkg.in/yaml.v3"
-	// Add this import
 )

 // ExtensionDefinition represents a single extension configuration
@@ -87,9 +88,7 @@ func NewExtensionRegistry(configDir string) *ExtensionRegistry {
 	r.ensureConfigDir()

 	if err := r.loadRegistry(); err != nil {
-		if Debug {
-			fmt.Printf("Warning: could not load extension registry: %v\n", err)
-		}
+		debuglog.Log("Warning: could not load extension registry: %v\n", err)
 	}

 	return r
--- a/internal/plugins/template/template.go
+++ b/internal/plugins/template/template.go
@@ -6,6 +6,8 @@ import (
 	"path/filepath"
 	"regexp"
 	"strings"
+
+	debuglog "github.com/danielmiessler/fabric/internal/log"
 )

 var (
@@ -14,7 +16,6 @@ var (
 	filePlugin     = &FilePlugin{}
 	fetchPlugin    = &FetchPlugin{}
 	sysPlugin      = &SysPlugin{}
-	Debug          = false // Debug flag
 )

 var extensionManager *ExtensionManager
@@ -33,9 +34,7 @@ var pluginPattern = regexp.MustCompile(`\{\{plugin:([^:]+):([^:]+)(?::([^}]+))?\
 var extensionPattern = regexp.MustCompile(`\{\{ext:([^:]+):([^:]+)(?::([^}]+))?\}\}`)

 func debugf(format string, a ...interface{}) {
-	if Debug {
-		fmt.Printf(format, a...)
-	}
+	debuglog.Debug(debuglog.Trace, format, a...)
 }

 func ApplyTemplate(content string, variables map[string]string, input string) (string, error) {
--- a/internal/tools/patterns_loader.go
+++ b/internal/tools/patterns_loader.go
@@ -7,6 +7,7 @@ import (
 	"sort"
 	"strings"

+	debuglog "github.com/danielmiessler/fabric/internal/log"
 	"github.com/danielmiessler/fabric/internal/plugins"
 	"github.com/danielmiessler/fabric/internal/plugins/db/fsdb"
 	"github.com/danielmiessler/fabric/internal/tools/githelper"
@@ -335,9 +336,9 @@ func (o *PatternsLoader) createUniquePatternsFile() (err error) {
 					patternNamesMap[entry.Name()] = true
 				}
 			}
-			fmt.Fprintf(os.Stderr, "📂 Also included patterns from custom directory: %s\n", o.Patterns.CustomPatternsDir)
+			debuglog.Log("📂 Also included patterns from custom directory: %s\n", o.Patterns.CustomPatternsDir)
 		} else {
-			fmt.Fprintf(os.Stderr, "Warning: Could not read custom patterns directory %s: %v\n", o.Patterns.CustomPatternsDir, customErr)
+			debuglog.Log("Warning: Could not read custom patterns directory %s: %v\n", o.Patterns.CustomPatternsDir, customErr)
 		}
 	}

--- a/nix/pkgs/fabric/gomod2nix.toml
+++ b/nix/pkgs/fabric/gomod2nix.toml
@@ -224,8 +224,8 @@ schema = 3
    version = "v1.0.2"
    hash = "sha256-+W9EIW7okXIXjWEgOaMh58eLvBZ7OshW2EhaIpNLSBU="
  [mod."github.com/ollama/ollama"]
-    version = "v0.9.0"
-    hash = "sha256-r2eU+kMG3tuJy2B43RXsfmeltzM9t05NEmNiJAW5qr4="
+    version = "v0.11.7"
+    hash = "sha256-3Wn1JWmil0aQQ2I/r398HbnUsi8ADoroqNyPziuxn/c="
  [mod."github.com/openai/openai-go"]
    version = "v1.8.2"
    hash = "sha256-O8aV3zEj6o8kIlzlkYaTW4RzvwR3qNUBYiN8SuTM1R0="
--- a/nix/pkgs/fabric/version.nix
+++ b/nix/pkgs/fabric/version.nix
@@ -1 +1 @@
-"1.4.291"
+"1.4.300"
--- a/scripts/docker-test/README.md
+++ b/scripts/docker-test/README.md
@@ -1,116 +0,0 @@
-# Docker Test Environment for API Configuration Fix
-
-This directory contains a Docker-based testing setup for fixing the issue where Fabric calls Ollama and Bedrock APIs even when not configured. This addresses the problem where unconfigured services show error messages during model listing.
-
-## Quick Start
-
-```bash
-# Run all tests
-./scripts/docker-test/test-runner.sh
-
-# Interactive mode - pick which test to run
-./scripts/docker-test/test-runner.sh -i
-
-# Run specific test case
-./scripts/docker-test/test-runner.sh gemini-only
-
-# Shell into test environment
-./scripts/docker-test/test-runner.sh -s gemini-only
-
-# Build image only (for development)
-./scripts/docker-test/test-runner.sh -b
-
-# Show help
-./scripts/docker-test/test-runner.sh -h
-```
-
-## Test Cases
-
-1. **no-config**: No APIs configured
-2. **gemini-only**: Only Gemini configured (reproduces original issue #1195)
-3. **openai-only**: Only OpenAI configured
-4. **ollama-only**: Only Ollama configured
-5. **bedrock-only**: Only Bedrock configured
-6. **mixed**: Multiple APIs configured (Gemini + OpenAI + Ollama)
-
-## Environment Files
-
-Each test case has a corresponding environment file in `scripts/docker-test/env/`:
-
- `env.no-config` - Empty configuration
- `env.gemini-only` - Only Gemini API key
- `env.openai-only` - Only OpenAI API key
- `env.ollama-only` - Only Ollama URL
- `env.bedrock-only` - Only Bedrock configuration
- `env.mixed` - Multiple API configurations
-
-These files are volume-mounted into the Docker container and persist changes made with `fabric -S`.
-
-## Interactive Mode & Shell Access
-
-The interactive mode (`-i`) provides several options:
-
-```text
-Available test cases:
-
-1) No APIs configured (no-config)
-2) Only Gemini configured (gemini-only)
-3) Only OpenAI configured (openai-only)
-4) Only Ollama configured (ollama-only)
-5) Only Bedrock configured (bedrock-only)
-6) Mixed configuration (mixed)
-7) Run all tests
-0) Exit
-
-Add '!' after number to shell into test environment (e.g., '1!' to shell into no-config)
-```
-
-### Shell Mode
-
- Use `1!`, `2!`, etc. to shell into any test environment
- Run `fabric -S` to configure APIs interactively
- Run `fabric --listmodels` or `fabric -L` to test model listing
- Changes persist in the environment files
- Type `exit` to return to test runner
-
-## Expected Results
-
-**Before Fix:**
-
- `no-config` and `gemini-only` tests show Ollama connection errors
- Tests show Bedrock authentication errors when BEDROCK_AWS_REGION not set
- Error: `Ollama Get "http://localhost:11434/api/tags": dial tcp...`
- Error: `Bedrock failed to list foundation models...`
-
-**After Fix:**
-
- Clean output with no error messages for unconfigured services
- Only configured services appear in model listings
- Ollama only initialized when `OLLAMA_API_URL` is set
- Bedrock only initialized when `BEDROCK_AWS_REGION` is set
-
-## Implementation Details
-
- **Volume-mounted configs**: Environment files are mounted to `/home/testuser/.config/fabric/.env`
- **Persistent state**: Configuration changes survive between test runs
- **Single Docker image**: Built once from `scripts/docker-test/base/Dockerfile`, reused for all tests
- **Isolated environments**: Each test uses its own environment file
- **Cross-platform**: Works on macOS, Linux, and Windows with Docker
-
-## Development Workflow
-
-1. Make code changes to fix API initialization logic
-2. Run `./scripts/docker-test/test-runner.sh no-config` to test the main issue
-3. Use `./scripts/docker-test/test-runner.sh -i` for interactive testing
-4. Shell into environments (`1!`, `2!`, etc.) to debug specific configurations
-5. Run all tests before submitting PR: `./scripts/docker-test/test-runner.sh`
-
-## Architecture
-
-The fix involves:
-
-1. **Ollama**: Override `IsConfigured()` method to check for `OLLAMA_API_URL` env var
-2. **Bedrock**: Modify `hasAWSCredentials()` to require `BEDROCK_AWS_REGION`
-3. **Plugin Registry**: Only initialize providers when properly configured
-
-This prevents unnecessary API calls and eliminates confusing error messages for users.
--- a/scripts/docker-test/base/Dockerfile
+++ b/scripts/docker-test/base/Dockerfile
@@ -1,30 +0,0 @@
-FROM golang:1.24-alpine AS builder
-
-WORKDIR /app
-COPY go.mod go.sum ./
-RUN go mod download
-
-COPY ./cmd/fabric ./cmd/fabric
-COPY ./internal ./internal
-RUN go build -o fabric ./cmd/fabric
-
-FROM alpine:latest
-RUN apk --no-cache add ca-certificates
-
-# Create a test user
-RUN adduser -D -s /bin/sh testuser
-
-# Switch to test user
-USER testuser
-WORKDIR /home/testuser
-
-# Set environment variables for the test user
-ENV HOME=/home/testuser
-ENV USER=testuser
-
-COPY --from=builder /app/fabric .
-
-# Create fabric config directory and empty .env file
-RUN mkdir -p .config/fabric && touch .config/fabric/.env
-
-ENTRYPOINT ["./fabric"]
--- a/scripts/docker-test/test-runner.sh
+++ b/scripts/docker-test/test-runner.sh
@@ -1,235 +0,0 @@
-#!/usr/bin/env bash
-
-set -e
-
-# Get the directory where this script is located
-top_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-base_name="$(basename "$top_dir")"
-cd "$top_dir"/../.. || exit 1
-
-# Check if bash version supports associative arrays
-if [[ ${BASH_VERSION%%.*} -lt 4 ]]; then
-    echo "This script requires bash 4.0 or later for associative arrays."
-    echo "Current version: $BASH_VERSION"
-    exit 1
-fi
-
-IMAGE_NAME="fabric-test-setup"
-ENV_DIR="scripts/${base_name}/env"
-
-# Test case descriptions
-declare -A test_descriptions=(
-    ["no-config"]="No APIs configured"
-    ["gemini-only"]="Only Gemini configured (reproduces original issue)"
-    ["openai-only"]="Only OpenAI configured"
-    ["ollama-only"]="Only Ollama configured"
-    ["bedrock-only"]="Only Bedrock configured"
-    ["mixed"]="Mixed configuration (Gemini + OpenAI + Ollama)"
-)
-
-# Test case order for consistent display
-test_order=("no-config" "gemini-only" "openai-only" "ollama-only" "bedrock-only" "mixed")
-
-build_image() {
-    echo "=== Building Docker image ==="
-    docker build -f "${top_dir}/base/Dockerfile" -t "$IMAGE_NAME" .
-    echo
-}
-
-check_env_file() {
-    local test_name="$1"
-    local env_file="$ENV_DIR/env.$test_name"
-
-    if [[ ! -f "$env_file" ]]; then
-        echo "Error: Environment file not found: $env_file"
-        exit 1
-    fi
-}
-
-run_test() {
-    local test_name="$1"
-    local description="${test_descriptions[$test_name]}"
-    local env_file="$ENV_DIR/env.$test_name"
-
-    check_env_file "$test_name"
-
-    echo "===================="
-    echo "Test: $description"
-    echo "Config: $test_name"
-    echo "Env file: $env_file"
-    echo "===================="
-
-    echo "Running test..."
-    if docker run --rm \
-        -e HOME=/home/testuser \
-        -e USER=testuser \
-        -v "$(pwd)/$env_file:/home/testuser/.config/fabric/.env:ro" \
-        "$IMAGE_NAME" --listmodels 2>&1; then
-        echo "✅ Test completed"
-    else
-        echo "❌ Test failed"
-    fi
-    echo
-}
-
-shell_into_env() {
-    local test_name="$1"
-    local description="${test_descriptions[$test_name]}"
-    local env_file="$ENV_DIR/env.$test_name"
-
-    check_env_file "$test_name"
-
-    echo "===================="
-    echo "Shelling into: $description"
-    echo "Config: $test_name"
-    echo "Env file: $env_file"
-    echo "===================="
-    echo "You can now run 'fabric -S' to configure, or 'fabric --listmodels' or 'fabric -L' to test."
-    echo "Changes to .env will persist in $env_file"
-    echo "Type 'exit' to return to the test runner."
-    echo
-
-    docker run -it --rm \
-        -e HOME=/home/testuser \
-        -e USER=testuser \
-        -v "$(pwd)/$env_file:/home/testuser/.config/fabric/.env" \
-        --entrypoint=/bin/sh \
-        "$IMAGE_NAME"
-}
-
-interactive_mode() {
-    echo "=== Interactive Mode ==="
-    echo "Available test cases:"
-    echo
-    local i=1
-    local cases=()
-    for test_name in "${test_order[@]}"; do
-        echo "$i) ${test_descriptions[$test_name]} ($test_name)"
-        cases[i]="$test_name"
-        ((i++))
-    done
-    echo "$i) Run all tests"
-    echo "0) Exit"
-    echo
-    echo "Add '!' after number to shell into test environment (e.g., '1!' to shell into no-config)"
-    echo
-
-    while true; do
-        read -r -p "Select test case (0-$i) [or 1!, etc. to shell into test environment]: " choice
-
-        # Check for shell mode (! suffix)
-        local shell_mode=false
-        if [[ "$choice" == *"!" ]]; then
-            shell_mode=true
-            choice="${choice%!}"  # Remove the ! suffix
-        fi
-
-        if [[ "$choice" == "0" ]]; then
-            if [[ "$shell_mode" == true ]]; then
-                echo "Cannot shell into exit option."
-                continue
-            fi
-            echo "Exiting..."
-            exit 0
-        elif [[ "$choice" == "$i" ]]; then
-            if [[ "$shell_mode" == true ]]; then
-                echo "Cannot shell into 'run all tests' option."
-                continue
-            fi
-            echo "Running all tests..."
-            run_all_tests
-            break
-        elif [[ "$choice" -ge 1 && "$choice" -lt "$i" ]]; then
-            local selected_test="${cases[$choice]}"
-            if [[ "$shell_mode" == true ]]; then
-                echo "Shelling into: ${test_descriptions[$selected_test]}"
-                shell_into_env "$selected_test"
-            else
-                echo "Running: ${test_descriptions[$selected_test]}"
-                run_test "$selected_test"
-            fi
-
-            read -r -p "Continue testing? (y/n): " again
-            if [[ "$again" != "y" && "$again" != "Y" ]]; then
-                break
-            fi
-            echo
-        else
-            echo "Invalid choice. Please select 0-$i (optionally with '!' for shell mode)."
-        fi
-    done
-}
-
-run_all_tests() {
-    echo "=== Testing PR #1645: Conditional API initialization ==="
-    echo
-
-    for test_name in "${test_order[@]}"; do
-        run_test "$test_name"
-    done
-
-    echo "=== Test run complete ==="
-    echo "Review the output above to check:"
-    echo "1. No Ollama connection errors when OLLAMA_URL not set"
-    echo "2. No Bedrock authentication errors when BEDROCK_AWS_REGION not set"
-    echo "3. Only configured services appear in model listings"
-}
-
-show_help() {
-    echo "Usage: $0 [OPTIONS] [TEST_CASE]"
-    echo
-    echo "Test PR #1645 conditional API initialization"
-    echo
-    echo "Options:"
-    echo "  -h, --help       Show this help message"
-    echo "  -i, --interactive Run in interactive mode"
-    echo "  -b, --build-only  Build image only, don't run tests"
-    echo "  -s, --shell TEST  Shell into test environment"
-    echo
-    echo "Test cases:"
-    for test_name in "${test_order[@]}"; do
-        echo "  $test_name: ${test_descriptions[$test_name]}"
-    done
-    echo
-    echo "Examples:"
-    echo "  $0                    # Run all tests"
-    echo "  $0 -i                 # Interactive mode"
-    echo "  $0 gemini-only        # Run specific test"
-    echo "  $0 -s gemini-only     # Shell into gemini-only environment"
-    echo "  $0 -b                 # Build image only"
-    echo
-    echo "Environment files are located in $ENV_DIR/ and can be edited directly."
-}
-
-# Parse command line arguments
-if [[ $# -eq 0 ]]; then
-    build_image
-    run_all_tests
-elif [[ "$1" == "-h" || "$1" == "--help" ]]; then
-    show_help
-elif [[ "$1" == "-i" || "$1" == "--interactive" ]]; then
-    build_image
-    interactive_mode
-elif [[ "$1" == "-b" || "$1" == "--build-only" ]]; then
-    build_image
-elif [[ "$1" == "-s" || "$1" == "--shell" ]]; then
-    if [[ -z "$2" ]]; then
-        echo "Error: -s/--shell requires a test case name"
-        echo "Use -h for help."
-        exit 1
-    fi
-    if [[ -z "${test_descriptions[$2]}" ]]; then
-        echo "Error: Unknown test case: $2"
-        echo "Use -h for help."
-        exit 1
-    fi
-    build_image
-    shell_into_env "$2"
-elif [[ -n "${test_descriptions[$1]}" ]]; then
-    build_image
-    run_test "$1"
-else
-    echo "Unknown test case or option: $1"
-    echo "Use -h for help."
-    exit 1
-fi
--- a/scripts/docker/Dockerfile
+++ b/scripts/docker/Dockerfile
@@ -1,41 +1,26 @@
-# Use official golang image as builder
-FROM golang:1.24.2-alpine AS builder
+# syntax=docker/dockerfile:1

-# Set working directory
-WORKDIR /app
+FROM golang:1.24-alpine AS builder
+
+WORKDIR /src
+
+# Install build dependencies
+RUN apk add --no-cache git

-# Copy go mod and sum files
 COPY go.mod go.sum ./
-
-# Download dependencies
 RUN go mod download

-# Copy source code
 COPY . .

-# Build the application
-RUN CGO_ENABLED=0 GOOS=linux go build -o fabric ./cmd/fabric
+RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-s -w" -o /fabric ./cmd/fabric

-# Use scratch as final base image
 FROM alpine:latest

-# Copy the binary from builder
-COPY --from=builder /app/fabric /fabric
+RUN apk add --no-cache ca-certificates \
+    && mkdir -p /root/.config/fabric

-# Copy patterns directory
-COPY patterns /patterns
+COPY --from=builder /fabric /usr/local/bin/fabric

-# Ensure clean config directory and copy ENV file
-RUN rm -rf /root/.config/fabric && \
-    mkdir -p /root/.config/fabric
-COPY ENV /root/.config/fabric/.env
-
-# Add debug commands
-RUN ls -la /root/.config/fabric/
-
-# Expose port 8080
 EXPOSE 8080

-# Run the binary with debug output
-ENTRYPOINT ["/fabric"]
-CMD ["--serve"] 
+ENTRYPOINT ["fabric"]
--- a/scripts/docker/README.md
+++ b/scripts/docker/README.md
@@ -1,40 +1,48 @@
-# Docker Deployment
+# Fabric Docker Image

-This directory contains Docker configuration files for running Fabric in containers.
+This directory provides a simple Docker setup for running the [Fabric](https://github.com/danielmiessler/fabric) CLI.

-## Files
+## Build

- `Dockerfile` - Main Docker build configuration
- `docker-compose.yml` - Docker Compose stack configuration  
- `start-docker.sh` - Helper script to start the stack
- `README.md` - This documentation
-
-## Quick Start
+Build the image from the repository root:

 ```bash
-# Start the Docker stack
-./start-docker.sh
-
-# Or manually with docker-compose
-docker-compose up -d
-
-# View logs
-docker-compose logs -f
-
-# Stop the stack
-docker-compose down
+docker build -t fabric -f scripts/docker/Dockerfile .
 ```

-## Building
+## Persisting configuration
+
+Fabric stores its configuration in `~/.config/fabric/.env`. Mount this path to keep your settings on the host.
+
+### Using a host directory

 ```bash
-# Build the Docker image
-docker build -t fabric .
-
-# Or use docker-compose
-docker-compose build
+mkdir -p $HOME/.fabric-config
+# Run setup to create the .env and download patterns
+ docker run --rm -it -v $HOME/.fabric-config:/root/.config/fabric fabric --setup
 ```

-## Configuration
+Subsequent runs can reuse the same directory:

-Make sure to configure your environment variables and API keys before running the Docker stack. See the main README.md for setup instructions.
+```bash
+docker run --rm -it -v $HOME/.fabric-config:/root/.config/fabric fabric -p your-pattern
+```
+
+### Mounting a single .env file
+
+If you only want to persist the `.env` file:
+
+```bash
+# assuming .env exists in the current directory
+docker run --rm -it -v $PWD/.env:/root/.config/fabric/.env fabric -p your-pattern
+```
+
+## Running the server
+
+Expose port 8080 to use Fabric's REST API:
+
+```bash
+docker run --rm -it -p 8080:8080 -v $HOME/.fabric-config:/root/.config/fabric fabric --serve
+```
+
+The API will be available at `http://localhost:8080`.
--- a/scripts/docker/docker-compose.yml
+++ b/scripts/docker/docker-compose.yml
@@ -1,11 +0,0 @@
-version: '3.8'
-
-services:
-  fabric-api:
-    build: .
-    ports:
-      - "8080:8080"
-    volumes:
-      - ./ENV:/root/.config/fabric/.env:ro
-    environment:
-      - GIN_MODE=release 
--- a/scripts/docker/start-docker.sh
+++ b/scripts/docker/start-docker.sh
@@ -1,11 +0,0 @@
-#!/bin/bash
-
-# Helper script to start the Fabric Docker stack
-
-echo "Starting Fabric Docker stack..."
-cd "$(dirname "$0")"
-docker-compose up -d
-
-echo "Fabric is now running!"
-echo "Check logs with: docker-compose logs -f"
-echo "Stop with: docker-compose down"
Author	SHA1	Message	Date
github-actions[bot]	0e85861a46	chore(release): Update version to v1.4.300	2025-08-28 06:41:30 +00:00
Kayvan Sylvan	7c5a040287	Merge pull request #1732 from ksylvan/kayvan/docker-publishing CI Infra: Changelog Generation Tool + Docker Image Pubishing	2025-08-27 23:39:04 -07:00
Kayvan Sylvan	08eb48c2e7	ci: add tag-based multi-arch Docker publish to GHCR and Docker Hub CHANGES - Add GitHub Actions workflow to publish Docker images on tags - Build multi-arch images with Buildx and QEMU across amd64, arm64 - Tag images using semver; push to GHCR and Docker Hub - Set :latest only for highest semver tag via imagetools - Gate patterns workflow steps on detected changes instead of failing - Auto-detect GitHub owner and repo from git remote URL - Remove hardcoded repository values in changelog release manager - Normalize image names to lowercase for registry compatibility - Enable GitHub Actions cache for faster Docker builds - Add VS Code dictionary entries for Docker-related terms	2025-08-27 23:35:44 -07:00
github-actions[bot]	e40d4e6623	chore(release): Update version to v1.4.299	2025-08-27 18:07:33 +00:00
Kayvan Sylvan	51bd1ebadf	Merge pull request #1731 from ksylvan/0827-update-ollama-library-for-cve-fixes chore: upgrade ollama dependency from v0.9.0 to v0.11.7	2025-08-27 11:05:04 -07:00
Kayvan Sylvan	d3de731967	chore: upgrade ollama dependency from v0.9.0 to v0.11.7 • Update ollama package to version 0.11.7 • Refresh go.sum with new dependency checksums - Link: [https://nvd.nist.gov/vuln/detail/CVE-2025-0317](https://nvd.nist.gov/vuln/detail/CVE-2025-0317) - CVSS Score: 7.5 (High) - Description: A vulnerability in ollama/ollama versions <=0.3.14 allows a malicious user to upload and create a customized GGUF model file on the Ollama server. This can lead to a division by zero error in the ggufPadding function, causing the server to crash and resulting in a Denial of Service (DoS) attack. - Affected: Ollama server versions ≤ 0.3.14 - Impact: Denial of Service through division by zero error - Link: [https://nvd.nist.gov/vuln/detail/CVE-2025-0315](https://nvd.nist.gov/vuln/detail/CVE-2025-0315) - CVSS Score: 7.5 (High) - Description: Vulnerability allows Denial of Service via customized GGUF model file upload on Ollama server. - Affected: Ollama/ollama versions ≤ 0.3.14 - Impact: Denial of Service through malicious GGUF model file uploads - Link: [https://nvd.nist.gov/vuln/detail/CVE-2024-12886](https://nvd.nist.gov/vuln/detail/CVE-2024-12886) - CVSS Score: 7.5 (High) - Description: An Out-Of-Memory (OOM) vulnerability exists in the ollama server version 0.3.14. This vulnerability can be triggered when a malicious API server responds with a gzip bomb HTTP response, leading to the ollama server crashing. - Affected: Ollama server version 0.3.14 - Impact: Denial of Service through memory exhaustion via gzip bomb attack - Link: [https://nvd.nist.gov/vuln/detail/CVE-2024-8063](https://nvd.nist.gov/vuln/detail/CVE-2024-8063) - CVSS Score: 7.5 (High) - Description: Security vulnerability with high severity rating - Impact: Requires patching for security compliance - Link: [https://nvd.nist.gov/vuln/detail/CVE-2024-12055](https://nvd.nist.gov/vuln/detail/CVE-2024-12055) - CVSS Score: 7.5 (High) - Description: High-severity security vulnerability requiring immediate attention - Impact: Critical security flaw needing remediation - Link: [https://nvd.nist.gov/vuln/detail/CVE-2025-51471](https://nvd.nist.gov/vuln/detail/CVE-2025-51471) - CVSS Score: 6.9 (Medium) - Description: Medium severity security vulnerability - Impact: Security risk requiring patching as part of comprehensive security updates - Link: [https://nvd.nist.gov/vuln/detail/CVE-2025-46394](https://nvd.nist.gov/vuln/detail/CVE-2025-46394) - CVSS Score: 3.2 (Low) - Description: Low-severity security issue - Impact: Minor security concern addressed as part of comprehensive security maintenance - Link: [https://nvd.nist.gov/vuln/detail/CVE-2024-58251](https://nvd.nist.gov/vuln/detail/CVE-2024-58251) - CVSS Score: 2.5 (Low) - Description: Low-severity security vulnerability - Impact: Minimal security risk addressed for comprehensive security posture This comprehensive security fix addresses 8 CVEs total: - 5 High Severity vulnerabilities (CVSS 7.5) - 1 Medium Severity vulnerability (CVSS 6.9) - 2 Low Severity vulnerabilities (CVSS 3.2 and 2.5) The majority of high-severity issues are related to Ollama server vulnerabilities that could lead to Denial of Service attacks through various vectors including division by zero errors, memory exhaustion, and malicious file uploads. These fixes ensure robust protection against these attack vectors and maintain system availability. Priority: The high-severity Ollama vulnerabilities should be considered critical for any systems running Ollama server components, as they can lead to service disruption and potential system crashes.	2025-08-27 10:53:31 -07:00
github-actions[bot]	458b0a5e1c	chore(release): Update version to v1.4.298	2025-08-27 14:11:48 +00:00
Kayvan Sylvan	b8f64bd554	Merge pull request #1730 from ksylvan/0827-simplify-docker Modernize Dockerfile with Best Practices Implementation	2025-08-27 07:09:12 -07:00
Kayvan Sylvan	1622a34331	chore: remove docker-test framework and simplify production docker setup - Remove entire docker-test directory and testing infrastructure - Delete complex test runner script and environment files - Simplify production Dockerfile with multi-stage build optimization - Remove docker-compose.yml and start-docker.sh helper scripts - Update README with cleaner Docker usage instructions - Streamline container build process and reduce image size	2025-08-27 07:00:52 -07:00
github-actions[bot]	6b9f4c1fb8	chore(release): Update version to v1.4.297	2025-08-26 15:11:22 +00:00
Kayvan Sylvan	4d2061a641	Merge pull request #1729 from ksylvan/0826-community-docs Add GitHub Community Health Documents	2025-08-26 08:08:52 -07:00
Kayvan Sylvan	713f6e46fe	docs: add contributing, security, support, and code-of-conduct docs; add docs index CHANGES - Add CODE_OF_CONDUCT defining respectful, collaborative community behavior - Add CONTRIBUTING with setup, testing, PR, changelog requirements - Add SECURITY policy with reporting process and response timelines - Add SUPPORT guide for bugs, features, discussions, expectations - Add docs README indexing guides, quick starts, contributor essentials	2025-08-26 07:10:08 -07:00
github-actions[bot]	efadc81974	chore(release): Update version to v1.4.296	2025-08-26 03:15:57 +00:00
Kayvan Sylvan	ea54f60dcc	Merge pull request #1728 from ksylvan/0825-debug-logging-cleanup Refactor Logging System to Use Centralized Debug Logger	2025-08-25 20:13:26 -07:00
Kayvan Sylvan	4008125e37	refactor: replace stderr prints with centralized debuglog.Log and improve auth messaging - Replace fmt.Fprintf/os.Stderr with centralized debuglog.Log across CLI - Add unconditional Log function to debuglog for important messages - Improve OAuth flow messaging and token refresh diagnostics - Update tests to capture debuglog output via SetOutput - Convert Perplexity streaming errors to unified debug logging - Emit file write notifications through debuglog instead of stderr - Warn on ambiguous model selection using centralized logger - Announce large audio processing steps via debuglog progress messages - Standardize extension registry and patterns warnings through debuglog	2025-08-25 20:09:55 -07:00
github-actions[bot]	da94411bf3	chore(release): Update version to v1.4.295	2025-08-24 20:22:53 +00:00
Kayvan Sylvan	ab7b37be10	Merge pull request #1727 from ksylvan/0824-anthropic-beta-logs Standardize Anthropic Beta Failure Logging	2025-08-24 13:20:19 -07:00
Kayvan Sylvan	772337bf0d	refactor: route Anthropic beta failure logs through internal debug logger CHANGES - Replace fmt.Fprintf stderr with debuglog.Debug for beta failures - Import internal log package and remove os dependency - Standardize logging level to debuglog.Basic for beta errors - Preserve fallback stream behavior when beta features fail - Maintain message send fallback when beta options fail	2025-08-24 13:10:57 -07:00
github-actions[bot]	1e30c4e136	chore(release): Update version to v1.4.294	2025-08-20 16:37:50 +00:00
Kayvan Sylvan	e12a40ad4f	Merge pull request #1723 from ksylvan/0820-venice-ai-provider docs: update README with Venice AI provider and Windows install script	2025-08-20 09:35:18 -07:00
Kayvan Sylvan	97beaecbeb	docs: update README with Venice AI provider and Windows install script - Add Venice AI provider configuration with API endpoint - Document Venice AI as privacy-first open-source provider - Include PowerShell installation script for Windows users - Add debug levels section to table of contents - Update recent major features with v1.4.294 release notes - Configure Venice AI base URL and response settings	2025-08-20 09:30:29 -07:00
github-actions[bot]	7af6817bac	chore(release): Update version to v1.4.293	2025-08-19 11:29:38 +00:00
Kayvan Sylvan	50ecc32d85	Merge pull request #1718 from ksylvan/0819-debug-log-levels Implement Configurable Debug Logging Levels	2025-08-19 04:27:08 -07:00
Kayvan Sylvan	ff1ef380a7	feat: add --debug flag with levels and centralized logging CHANGES - Add --debug flag controlling runtime logging verbosity levels - Introduce internal/log package with Off, Basic, Detailed, Trace - Replace ad-hoc Debugf and globals with centralized debug logger - Wire debug level during early CLI argument parsing - Add bash, zsh, fish completions for --debug levels - Document debug levels in README with usage examples - Add comprehensive STT guide covering models, flags, workflows - Simplify splitAudioFile signature and log ffmpeg chunking operations - Remove FABRIC_STT_DEBUG environment variable and related code - Clean minor code paths in vendors and template modules	2025-08-19 04:23:40 -07:00
github-actions[bot]	6a3a7e82d1	chore(release): Update version to v1.4.292	2025-08-19 00:55:22 +00:00
Kayvan Sylvan	34bc0b5e31	Merge pull request #1717 from ksylvan/0818-feature-default-model-indicator Highlight default vendor/model in model listing	2025-08-18 17:52:57 -07:00
Kayvan Sylvan	ce59999503	feat: highlight default vendor/model in listings, pass registry defaults CHANGES - Update PrintWithVendor signature to accept default vendor and model - Mark default vendor/model with asterisk in non-shell output - Compare vendor and model case-insensitively when marking - Pass registry defaults to PrintWithVendor from CLI - Add test ensuring default selection appears with asterisk - Keep shell completion output unchanged without default markers	2025-08-18 16:58:25 -07:00
Kayvan Sylvan	9bb4ccf740	docs: update version number in README updates section from v1.4.290 to v1.4.291	2025-08-18 08:13:55 -07:00