llmsbrieftxt 1.8.2__tar.gz → 1.9.0__tar.gz

{llmsbrieftxt-1.8.2 → llmsbrieftxt-1.9.0}/.github/workflows/claude-cli-qa.yml

@@ -60,30 +60,7 @@ jobs:
         run: |
           uv sync --all-groups
 
-      # Cache Ollama models (most important - saves bandwidth and time)
-      - name: Cache Ollama models
-        id: cache-ollama-models
-        uses: actions/cache@v4
-        with:
-          path: ~/.ollama
-          key: ollama-models-${{ runner.os }}-${{ env.OLLAMA_MODEL }}-v1
-          restore-keys: |
-            ollama-models-${{ runner.os }}-
-
-      # Cache Ollama binary installation
-      - name: Cache Ollama binary
-        id: cache-ollama-binary
-        uses: actions/cache@v4
-        with:
-          path: |
-            /usr/local/bin/ollama
-            /usr/share/ollama
-          key: ollama-binary-${{ runner.os }}-v1
-          restore-keys: |
-            ollama-binary-${{ runner.os }}-
-
       - name: Install Ollama
-        if: steps.cache-ollama-binary.outputs.cache-hit != 'true'
         run: |
           echo "Installing Ollama for local LLM testing..."
           curl -fsSL https://ollama.com/install.sh | sh
@@ -104,7 +81,6 @@ jobs:
           echo "✓ Ollama service is running"
 
       - name: Pull Ollama model
-        if: steps.cache-ollama-models.outputs.cache-hit != 'true'
         run: |
           echo "Pulling ${{ env.OLLAMA_MODEL }} model for testing..."
           ollama pull ${{ env.OLLAMA_MODEL }}
@@ -133,15 +109,15 @@ jobs:
 
           case "$SCOPE" in
             quick)
-              echo "max_urls=3" >> $GITHUB_OUTPUT
+              echo "max_urls=2" >> $GITHUB_OUTPUT
               echo "depth=1" >> $GITHUB_OUTPUT
               ;;
             thorough)
-              echo "max_urls=20" >> $GITHUB_OUTPUT
-              echo "depth=2" >> $GITHUB_OUTPUT
+              echo "max_urls=5" >> $GITHUB_OUTPUT
+              echo "depth=1" >> $GITHUB_OUTPUT
               ;;
             *)
-              echo "max_urls=10" >> $GITHUB_OUTPUT
+              echo "max_urls=3" >> $GITHUB_OUTPUT
               echo "depth=1" >> $GITHUB_OUTPUT
               ;;
           esac
@@ -163,13 +139,16 @@ jobs:
           # Enable progress tracking for PR events only
           track_progress: ${{ github.event_name == 'pull_request' }}
 
+          # Show full output in workflow logs for debugging
+          show_full_output: true
+
           prompt: |
             You are the QA coordinator orchestrating comprehensive CLI tests for llmsbrieftxt.
 
             **Test Environment (Ready)**:
             - Python 3.11 with uv package manager
             - Ollama service running at http://localhost:11434
-            - Model: ${{ env.OLLAMA_MODEL }} (fast, efficient)
+            - Model: ${{ env.OLLAMA_MODEL }} (fast, lightweight)
             - CLI: Use `uv run llmtxt` to invoke the CLI
 
             **Environment Variables for Ollama**:
@@ -185,9 +164,9 @@ jobs:
 
             **Workflow**:
             1. Read docs/USER_JOURNEYS.md to understand test scenarios
-            2. For each test flow in scope, launch an individual sub-agent using the Task tool
-            3. Each sub-agent executes ONE test scenario and reports pass/fail with evidence
-            4. Collect results from all sub-agents
+            2. **IMPORTANT - Create ALL sub-agents IN PARALLEL**. Do not wait for one to complete before creating the next. Use the Task tool to create all sub-agents in a single message.
+            3. Each sub-agent executes ONE test scenario in isolation and reports pass/fail with evidence
+            4. Collect results from all sub-agents (they will complete asynchronously)
             5. Create aggregated summary with:
                - Total tests: count
                - Passed: count + list
@@ -211,9 +190,9 @@ jobs:
             - TS-011: Ollama Not Running (ALWAYS include)
             - TS-012: Invalid Model (thorough scope only)
 
-            For each test scenario, launch a sub-agent with clear test task:
+            For each test scenario, create a subagent with clear test task:
             ```
-            Use the Task tool to launch a specialized QA sub-agent:
+            Create a subagent from .claude/agents/qa-agent.md (haiku model configured):
 
             Prompt template (customize for each test):
             "Execute test scenario [TEST-ID] from docs/USER_JOURNEYS.md.
@@ -221,7 +200,15 @@ jobs:
             Test: [Test Name]
             Priority: [Priority Level]
 
+            **IMPORTANT - Directory Isolation**:
+            Since multiple tests run in parallel, use unique directories to avoid conflicts:
+            - Cache directory: /tmp/llmtxt-cache-[TEST-ID] (e.g., /tmp/llmtxt-cache-ts001)
+            - Output directory: /tmp/llmtxt-output-[TEST-ID] (e.g., /tmp/llmtxt-output-ts001)
+            - Use --cache-dir and --output flags in all CLI commands to specify these paths
+            - This prevents parallel tests from interfering with each other
+
             Read the detailed test steps and expected results from docs/USER_JOURNEYS.md.
+            Adapt the commands to use the isolated directories listed above.
             Execute all verification commands.
             Report:
             - Test Status: PASS or FAIL

{llmsbrieftxt-1.8.2 → llmsbrieftxt-1.9.0}/.github/workflows/claude-doc-review.yml

@@ -85,6 +85,10 @@ jobs:
           # Enable progress tracking
           track_progress: true
 
+          # Optional: Show full output in workflow logs for debugging
+          # Rerun in debug mode or enable `show_full_output: true` in your workflow file for full output.
+          # show_full_output: false
+
           prompt: |
             You are reviewing documentation accuracy for a pull request.
 

{llmsbrieftxt-1.8.2 → llmsbrieftxt-1.9.0}/.github/workflows/claude.yml

@@ -48,3 +48,7 @@ jobs:
           # or https://docs.claude.com/en/docs/claude-code/cli-reference for available options
           # claude_args: '--allowed-tools Bash(gh pr:*)'
 
+          # Optional: Show full output in workflow logs for debugging
+          # Rerun in debug mode or enable `show_full_output: true` in your workflow file for full output.
+          # show_full_output: false
+

{llmsbrieftxt-1.8.2 → llmsbrieftxt-1.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: llmsbrieftxt
-Version: 1.8.2
+Version: 1.9.0
 Summary: Generate llms-brief.txt files from documentation websites using AI
 Project-URL: Homepage, https://github.com/stevennevins/llmsbrief
 Project-URL: Repository, https://github.com/stevennevins/llmsbrief

{llmsbrieftxt-1.8.2 → llmsbrieftxt-1.9.0}/docs/USER_JOURNEYS.md

@@ -13,7 +13,7 @@ This document provides test scenarios for validating `llmtxt` CLI behavior acros
   export OPENAI_API_KEY="ollama-dummy-key"
   ```
 - Clean test environment with fresh cache
-- Test URLs should be stable documentation sites (typer.tiangolo.com is recommended - ~25 pages)
+- Test URLs should be stable documentation sites (example.com is recommended - simple, 1-2 pages, fast)
 - **Why Ollama**: Zero API costs, same code paths as production, fast local execution
 
 ## Test Scenario 1: Fresh Install - Default Behavior
@@ -34,13 +34,13 @@ This document provides test scenarios for validating `llmtxt` CLI behavior acros
 - `llmtxt` command is available in PATH
 
 **Test Steps**:
-1. Run: `llmtxt https://typer.tiangolo.com --model gemma3:270m --max-urls 10 --depth 1`
+1. Run: `llmtxt https://example.com --model gemma3:270m --max-urls 2 --depth 1`
 2. Observe console output for progress indicators
 3. Wait for completion
 
 **Expected Results**:
 - ✅ Command exits with status code 0
-- ✅ Output file created at `~/.claude/docs/typer.tiangolo.com.txt`
+- ✅ Output file created at `~/.claude/docs/example.com.txt`
 - ✅ Cache directory created at `.llmsbrieftxt_cache/`
 - ✅ Cache file `summaries.json` contains entries for processed URLs
 - ✅ Output file contains structured entries with "Title:", "Keywords:", "Summary:" format
@@ -53,22 +53,22 @@ This document provides test scenarios for validating `llmtxt` CLI behavior acros
 echo $?  # Should be 0
 
 # Verify output exists and has content
-test -f ~/.claude/docs/typer.tiangolo.com.txt && echo "PASS" || echo "FAIL"
-wc -l ~/.claude/docs/typer.tiangolo.com.txt  # Should have 40+ lines (4 lines per entry × ~10 entries)
+test -f ~/.claude/docs/example.com.txt && echo "PASS" || echo "FAIL"
+wc -l ~/.claude/docs/example.com.txt  # Should have 8+ lines (4 lines per entry × ~2 entries)
 
 # Verify cache exists
 test -f .llmsbrieftxt_cache/summaries.json && echo "PASS" || echo "FAIL"
-cat .llmsbrieftxt_cache/summaries.json | jq 'length'  # Should show ~10 cached entries
+cat .llmsbrieftxt_cache/summaries.json | jq 'length'  # Should show 1-2 cached entries
 
 # Verify output structure
-grep -c "^Title:" ~/.claude/docs/typer.tiangolo.com.txt  # Should be ~10 (number of URLs processed)
-grep -c "^Keywords:" ~/.claude/docs/typer.tiangolo.com.txt  # Should match Title count
-grep -c "^Summary:" ~/.claude/docs/typer.tiangolo.com.txt  # Should match Title count
+grep -c "^Title:" ~/.claude/docs/example.com.txt  # Should be 1-2 (number of URLs processed)
+grep -c "^Keywords:" ~/.claude/docs/example.com.txt  # Should match Title count
+grep -c "^Summary:" ~/.claude/docs/example.com.txt  # Should match Title count
 ```
 
 **Cleanup**:
 ```bash
-rm -rf ~/.claude/docs/typer.tiangolo.com.txt
+rm -rf ~/.claude/docs/example.com.txt
 rm -rf .llmsbrieftxt_cache/
 ```
 
@@ -85,7 +85,7 @@ rm -rf .llmsbrieftxt_cache/
 - `llmtxt` command is available
 
 **Test Steps**:
-1. Run: `llmtxt https://typer.tiangolo.com --show-urls --depth 1`
+1. Run: `llmtxt https://example.com --show-urls --depth 1`
 2. Observe console output
 3. Check that command completes quickly (< 10 seconds)
 
@@ -104,13 +104,13 @@ rm -rf .llmsbrieftxt_cache/
 echo $?  # Should be 0
 
 # Verify NO output file created
-test ! -f ~/.claude/docs/typer.tiangolo.com.txt && echo "PASS" || echo "FAIL"
+test ! -f ~/.claude/docs/example.com.txt && echo "PASS" || echo "FAIL"
 
 # Capture and verify output format
-llmtxt https://typer.tiangolo.com --show-urls --depth 1 2>&1 | tee output.txt
+llmtxt https://example.com --show-urls --depth 1 2>&1 | tee output.txt
 grep -q "Found [0-9]* URLs" output.txt && echo "PASS" || echo "FAIL"
 grep -q "Estimated cost:" output.txt && echo "PASS" || echo "FAIL"
-grep -q "https://typer.tiangolo.com" output.txt && echo "PASS" || echo "FAIL"
+grep -q "https://example.com" output.txt && echo "PASS" || echo "FAIL"
 ```
 
 **Cleanup**:
@@ -131,13 +131,13 @@ rm -f output.txt
 - Clean cache state
 
 **Test Steps**:
-1. Run: `llmtxt https://typer.tiangolo.com --model gemma3:270m --depth 1 --max-urls 8`
+1. Run: `llmtxt https://example.com --model gemma3:270m --depth 1 --max-urls 2`
 2. Wait for completion
 3. Verify constraints were respected
 
 **Expected Results**:
 - ✅ Command exits with status code 0
-- ✅ Output file created at `~/.claude/docs/typer.tiangolo.com.txt`
+- ✅ Output file created at `~/.claude/docs/example.com.txt`
 - ✅ Number of entries ≤ 8 (respects max-urls)
 - ✅ URLs are at most 1 link away from starting URL (respects depth)
 - ✅ Console shows processing status with correct counts
@@ -145,12 +145,12 @@ rm -f output.txt
 **Verification Commands**:
 ```bash
 # Count entries in output
-ENTRY_COUNT=$(grep -c "^Title:" ~/.claude/docs/typer.tiangolo.com.txt)
+ENTRY_COUNT=$(grep -c "^Title:" ~/.claude/docs/example.com.txt)
 test $ENTRY_COUNT -le 8 && echo "PASS: max-urls respected" || echo "FAIL: too many entries"
 
 # Verify depth constraint (URLs should not be deeply nested)
 # This is harder to verify programmatically, so inspect manually
-cat ~/.claude/docs/typer.tiangolo.com.txt | grep "^Title:"
+cat ~/.claude/docs/example.com.txt | grep "^Title:"
 
 # Check cache has correct number of entries
 CACHE_COUNT=$(cat .llmsbrieftxt_cache/summaries.json | jq 'length')
@@ -159,7 +159,7 @@ test $CACHE_COUNT -le 8 && echo "PASS" || echo "FAIL"
 
 **Cleanup**:
 ```bash
-rm -rf ~/.claude/docs/typer.tiangolo.com.txt
+rm -rf ~/.claude/docs/example.com.txt
 rm -rf .llmsbrieftxt_cache/
 ```
 
@@ -172,12 +172,12 @@ rm -rf .llmsbrieftxt_cache/
 **State**: Existing cache from previous run
 
 **Preconditions**:
-- Run initial generation: `llmtxt https://typer.tiangolo.com --model gemma3:270m --max-urls 10 --depth 1`
+- Run initial generation: `llmtxt https://example.com --model gemma3:270m --max-urls 2 --depth 1`
 - Cache exists at `.llmsbrieftxt_cache/summaries.json`
 - Note the cache entry count (should be ~10)
 
 **Test Steps**:
-1. Run: `llmtxt https://typer.tiangolo.com --use-cache-only --output /tmp/cached-output.txt`
+1. Run: `llmtxt https://example.com --use-cache-only --output /tmp/cached-output.txt`
 2. Observe completion time (should be very fast, < 5 seconds)
 3. Verify output was generated from cache only
 
@@ -195,7 +195,7 @@ rm -rf .llmsbrieftxt_cache/
 test -f /tmp/cached-output.txt && echo "PASS" || echo "FAIL"
 
 # Compare entry count
-ORIGINAL_COUNT=$(grep -c "^Title:" ~/.claude/docs/typer.tiangolo.com.txt)
+ORIGINAL_COUNT=$(grep -c "^Title:" ~/.claude/docs/example.com.txt)
 CACHED_COUNT=$(grep -c "^Title:" /tmp/cached-output.txt)
 test $ORIGINAL_COUNT -eq $CACHED_COUNT && echo "PASS: same entry count" || echo "FAIL"
 
@@ -222,13 +222,13 @@ rm -f /tmp/cached-output.txt
 - Note cache modification time
 
 **Test Steps**:
-1. Run: `llmtxt https://typer.tiangolo.com --model gemma3:270m --force-refresh --max-urls 10 --depth 1`
+1. Run: `llmtxt https://example.com --model gemma3:270m --force-refresh --max-urls 2 --depth 1`
 2. Wait for completion
 3. Verify cache was updated
 
 **Expected Results**:
 - ✅ Command exits with status code 0
-- ✅ Output file created/updated at `~/.claude/docs/typer.tiangolo.com.txt`
+- ✅ Output file created/updated at `~/.claude/docs/example.com.txt`
 - ✅ Console shows "Cached: 0 | New: X" (all new summaries)
 - ✅ Cache file timestamp is updated
 - ✅ Cache file contents are replaced with fresh data
@@ -245,7 +245,7 @@ cat .llmsbrieftxt_cache/summaries.json | jq '.[].timestamp' 2>/dev/null
 
 **Cleanup**:
 ```bash
-rm -rf ~/.claude/docs/typer.tiangolo.com.txt
+rm -rf ~/.claude/docs/example.com.txt
 rm -rf .llmsbrieftxt_cache/
 ```
 
@@ -262,7 +262,7 @@ rm -rf .llmsbrieftxt_cache/
 - Create test directory: `mkdir -p /tmp/test-llmtxt/{output,cache}`
 
 **Test Steps**:
-1. Run: `llmtxt https://typer.tiangolo.com --model gemma3:270m --output /tmp/test-llmtxt/output/custom.txt --cache-dir /tmp/test-llmtxt/cache --max-urls 8 --depth 1`
+1. Run: `llmtxt https://example.com --model gemma3:270m --output /tmp/test-llmtxt/output/custom.txt --cache-dir /tmp/test-llmtxt/cache --max-urls 2 --depth 1`
 2. Verify custom paths are used
 3. Verify default paths are NOT used
 
@@ -277,7 +277,7 @@ rm -rf .llmsbrieftxt_cache/
 ```bash
 # Verify custom output location
 test -f /tmp/test-llmtxt/output/custom.txt && echo "PASS: custom output" || echo "FAIL"
-test ! -f ~/.claude/docs/typer.tiangolo.com.txt && echo "PASS: no default output" || echo "FAIL"
+test ! -f ~/.claude/docs/example.com.txt && echo "PASS: no default output" || echo "FAIL"
 
 # Verify custom cache location
 test -f /tmp/test-llmtxt/cache/summaries.json && echo "PASS: custom cache" || echo "FAIL"
@@ -302,8 +302,8 @@ rm -rf /tmp/test-llmtxt/
 
 **Preconditions**:
 - Ollama environment configured
-- Run: `llmtxt https://typer.tiangolo.com --model gemma3:270m --max-urls 15 --depth 2`
-- Output file exists at `~/.claude/docs/typer.tiangolo.com.txt`
+- Run: `llmtxt https://example.com --model gemma3:270m --max-urls 3 --depth 2`
+- Output file exists at `~/.claude/docs/example.com.txt`
 
 **Test Steps**:
 1. Search for known terms in output file
@@ -320,7 +320,7 @@ rm -rf /tmp/test-llmtxt/
 
 **Verification Commands**:
 ```bash
-FILE=~/.claude/docs/typer.tiangolo.com.txt
+FILE=~/.claude/docs/example.com.txt
 
 # Test structured field searches
 grep "^Title:" $FILE | head -3
@@ -344,7 +344,7 @@ grep "^Title:.*https://" $FILE && echo "PASS: URLs in titles" || echo "FAIL"
 
 **Cleanup**:
 ```bash
-rm -rf ~/.claude/docs/typer.tiangolo.com.txt
+rm -rf ~/.claude/docs/example.com.txt
 rm -rf .llmsbrieftxt_cache/
 ```
 
@@ -361,7 +361,7 @@ rm -rf .llmsbrieftxt_cache/
 - Use a site known to have some broken links OR manually test with non-existent URLs
 
 **Test Steps**:
-1. Run: `llmtxt https://typer.tiangolo.com --model gemma3:270m --max-urls 20 --depth 2`
+1. Run: `llmtxt https://example.com --model gemma3:270m --max-urls 3 --depth 2`
    (Note: some URLs may fail during crawl or extraction)
 2. Wait for completion
 3. Check for failed_urls.txt file
@@ -377,7 +377,7 @@ rm -rf .llmsbrieftxt_cache/
 **Verification Commands**:
 ```bash
 # Verify output was generated despite failures
-test -f ~/.claude/docs/typer.tiangolo.com.txt && echo "PASS: output created" || echo "FAIL"
+test -f ~/.claude/docs/example.com.txt && echo "PASS: output created" || echo "FAIL"
 
 # Check for failed URLs file (may or may not exist)
 if [ -f ~/.claude/docs/failed_urls.txt ]; then
@@ -390,7 +390,7 @@ else
 fi
 
 # Verify successful URLs are in output
-ENTRY_COUNT=$(grep -c "^Title:" ~/.claude/docs/typer.tiangolo.com.txt)
+ENTRY_COUNT=$(grep -c "^Title:" ~/.claude/docs/example.com.txt)
 test $ENTRY_COUNT -gt 0 && echo "PASS: at least some URLs succeeded" || echo "FAIL: no entries"
 
 # Verify successful URLs are cached
@@ -400,7 +400,7 @@ test $CACHE_COUNT -gt 0 && echo "PASS: successful URLs cached" || echo "FAIL"
 
 **Cleanup**:
 ```bash
-rm -rf ~/.claude/docs/typer.tiangolo.com.txt
+rm -rf ~/.claude/docs/example.com.txt
 rm -rf ~/.claude/docs/failed_urls.txt
 rm -rf .llmsbrieftxt_cache/
 ```
@@ -419,40 +419,40 @@ rm -rf .llmsbrieftxt_cache/
 - Verify model available: `ollama list | grep phi3`
 
 **Test Steps**:
-1. Run: `llmtxt https://typer.tiangolo.com --model phi3:mini --max-urls 10 --depth 1`
+1. Run: `llmtxt https://example.com --model phi3:mini --max-urls 2 --depth 1`
 2. Verify generation completes successfully
-3. Compare output quality with gemma3:270m (optional)
+3. Compare output quality with gemma2:2b (optional)
 
 **Expected Results**:
 - ✅ Command exits with status code 0
-- ✅ Output file created at `~/.claude/docs/typer.tiangolo.com.txt`
+- ✅ Output file created at `~/.claude/docs/example.com.txt`
 - ✅ Summaries are generated with phi3 model
 - ✅ No API costs incurred
 - ✅ Cache is populated
 - ✅ Output has correct format (Title, Keywords, Summary)
-- ✅ Quality may be noticeably better than gemma3:270m
+- ✅ Quality may be different from default gemma3:270m
 
 **Verification Commands**:
 ```bash
 # Verify output exists
-test -f ~/.claude/docs/typer.tiangolo.com.txt && echo "PASS: output created" || echo "FAIL"
+test -f ~/.claude/docs/example.com.txt && echo "PASS: output created" || echo "FAIL"
 
 # Verify structure
-grep -q "^Title:" ~/.claude/docs/typer.tiangolo.com.txt && echo "PASS: has titles" || echo "FAIL"
-grep -q "^Keywords:" ~/.claude/docs/typer.tiangolo.com.txt && echo "PASS: has keywords" || echo "FAIL"
-grep -q "^Summary:" ~/.claude/docs/typer.tiangolo.com.txt && echo "PASS: has summaries" || echo "FAIL"
+grep -q "^Title:" ~/.claude/docs/example.com.txt && echo "PASS: has titles" || echo "FAIL"
+grep -q "^Keywords:" ~/.claude/docs/example.com.txt && echo "PASS: has keywords" || echo "FAIL"
+grep -q "^Summary:" ~/.claude/docs/example.com.txt && echo "PASS: has summaries" || echo "FAIL"
 
 # Count entries
-ENTRY_COUNT=$(grep -c "^Title:" ~/.claude/docs/typer.tiangolo.com.txt)
+ENTRY_COUNT=$(grep -c "^Title:" ~/.claude/docs/example.com.txt)
 test $ENTRY_COUNT -gt 0 && echo "PASS: $ENTRY_COUNT entries" || echo "FAIL"
 
 # Compare summary quality (manual inspection)
-head -30 ~/.claude/docs/typer.tiangolo.com.txt
+head -30 ~/.claude/docs/example.com.txt
 ```
 
 **Cleanup**:
 ```bash
-rm -rf ~/.claude/docs/typer.tiangolo.com.txt
+rm -rf ~/.claude/docs/example.com.txt
 rm -rf .llmsbrieftxt_cache/
 ```
 
@@ -469,10 +469,10 @@ rm -rf .llmsbrieftxt_cache/
 - Test with a site that has clear depth structure
 
 **Test Steps**:
-1. Run with depth 1: `llmtxt https://typer.tiangolo.com --depth 1 --show-urls`
-2. Run with depth 2: `llmtxt https://typer.tiangolo.com --depth 2 --show-urls`
+1. Run with depth 1: `llmtxt https://example.com --depth 1 --show-urls`
+2. Run with depth 2: `llmtxt https://example.com --depth 2 --show-urls`
 3. Compare URL counts - depth 2 should discover more URLs
-4. Generate with depth 1: `llmtxt https://typer.tiangolo.com --model gemma3:270m --depth 1 --max-urls 10`
+4. Generate with depth 1: `llmtxt https://example.com --model gemma3:270m --depth 1 --max-urls 2`
 5. Verify only shallow URLs are processed
 
 **Expected Results**:
@@ -486,8 +486,8 @@ rm -rf .llmsbrieftxt_cache/
 **Verification Commands**:
 ```bash
 # Preview and capture URL counts
-DEPTH1_COUNT=$(llmtxt https://typer.tiangolo.com --depth 1 --show-urls 2>&1 | grep "Found" | grep -oP '\d+')
-DEPTH2_COUNT=$(llmtxt https://typer.tiangolo.com --depth 2 --show-urls 2>&1 | grep "Found" | grep -oP '\d+')
+DEPTH1_COUNT=$(llmtxt https://example.com --depth 1 --show-urls 2>&1 | grep "Found" | grep -oP '\d+')
+DEPTH2_COUNT=$(llmtxt https://example.com --depth 2 --show-urls 2>&1 | grep "Found" | grep -oP '\d+')
 
 echo "Depth 1 URLs: $DEPTH1_COUNT"
 echo "Depth 2 URLs: $DEPTH2_COUNT"
@@ -496,15 +496,15 @@ echo "Depth 2 URLs: $DEPTH2_COUNT"
 test $DEPTH2_COUNT -gt $DEPTH1_COUNT && echo "PASS: depth increases URL count" || echo "FAIL"
 
 # Actually generate with depth 1
-llmtxt https://typer.tiangolo.com --model gemma3:270m --depth 1 --max-urls 5
+llmtxt https://example.com --model gemma2:2b --depth 1 --max-urls 2
 
 # Verify output
-test -f ~/.claude/docs/typer.tiangolo.com.txt && echo "PASS" || echo "FAIL"
+test -f ~/.claude/docs/example.com.txt && echo "PASS" || echo "FAIL"
 ```
 
 **Cleanup**:
 ```bash
-rm -rf ~/.claude/docs/typer.tiangolo.com.txt
+rm -rf ~/.claude/docs/example.com.txt
 rm -rf .llmsbrieftxt_cache/
 ```
 
@@ -518,12 +518,12 @@ rm -rf .llmsbrieftxt_cache/
 
 **Preconditions**:
 - Ollama environment configured
-- First run completed: `llmtxt https://typer.tiangolo.com --model gemma3:270m --max-urls 10 --depth 1`
+- First run completed: `llmtxt https://example.com --model gemma3:270m --max-urls 2 --depth 1`
 - Cache exists with ~10 entries
 - Note cache creation time
 
 **Test Steps**:
-1. Run again with higher max-urls: `llmtxt https://typer.tiangolo.com --model gemma3:270m --max-urls 20 --depth 1`
+1. Run again with higher max-urls: `llmtxt https://example.com --model gemma3:270m --max-urls 3 --depth 1`
 2. Observe that cached entries are reused
 3. Verify only new URLs are processed
 
@@ -540,7 +540,7 @@ rm -rf .llmsbrieftxt_cache/
 # Check cache size increased
 INITIAL_CACHE=$(cat .llmsbrieftxt_cache/summaries.json | jq 'length')
 # Run with more URLs
-llmtxt https://typer.tiangolo.com --model gemma3:270m --max-urls 20 --depth 1 2>&1 | tee output.log
+llmtxt https://example.com --model gemma2:2b --max-urls 3 --depth 1 2>&1 | tee output.log
 FINAL_CACHE=$(cat .llmsbrieftxt_cache/summaries.json | jq 'length')
 
 echo "Initial cache: $INITIAL_CACHE"
@@ -551,13 +551,13 @@ test $FINAL_CACHE -gt $INITIAL_CACHE && echo "PASS: cache grew" || echo "FAIL"
 grep -q "Cached:" output.log && echo "PASS: cache reuse reported" || echo "FAIL"
 
 # Verify output has more entries
-ENTRY_COUNT=$(grep -c "^Title:" ~/.claude/docs/typer.tiangolo.com.txt)
-test $ENTRY_COUNT -ge 10 && echo "PASS: has at least 10 entries" || echo "FAIL"
+ENTRY_COUNT=$(grep -c "^Title:" ~/.claude/docs/example.com.txt)
+test $ENTRY_COUNT -ge 1 && echo "PASS: has at least 1 entry" || echo "FAIL"
 ```
 
 **Cleanup**:
 ```bash
-rm -rf ~/.claude/docs/typer.tiangolo.com.txt
+rm -rf ~/.claude/docs/example.com.txt
 rm -rf .llmsbrieftxt_cache/
 rm -f output.log
 ```
@@ -576,7 +576,7 @@ rm -f output.log
 - Environment variables still set (but service unavailable)
 
 **Test Steps**:
-1. Run: `llmtxt https://typer.tiangolo.com --model gemma3:270m --max-urls 8`
+1. Run: `llmtxt https://example.com --model gemma3:270m --max-urls 2`
 2. Observe error message about connection failure
 
 **Expected Results**:
@@ -593,14 +593,14 @@ pkill ollama 2>/dev/null || true
 sleep 2
 
 # Run and capture exit code
-llmtxt https://typer.tiangolo.com --model gemma3:270m --max-urls 8 2>&1 | tee error.log
+llmtxt https://example.com --model gemma2:2b --max-urls 2 2>&1 | tee error.log
 EXIT_CODE=$?
 
 test $EXIT_CODE -ne 0 && echo "PASS: non-zero exit" || echo "FAIL: should have failed"
 grep -qi "connection\|refused\|timeout\|11434" error.log && echo "PASS: connection error" || echo "FAIL"
 
 # Verify no output
-test ! -f ~/.claude/docs/typer.tiangolo.com.txt && echo "PASS: no output" || echo "FAIL"
+test ! -f ~/.claude/docs/example.com.txt && echo "PASS: no output" || echo "FAIL"
 ```
 
 **Cleanup**:
@@ -624,7 +624,7 @@ sleep 2
 - Model NOT pulled: `nonexistent-model-xyz`
 
 **Test Steps**:
-1. Run with non-existent model: `llmtxt https://typer.tiangolo.com --model nonexistent-model-xyz --max-urls 5 --depth 1`
+1. Run with non-existent model: `llmtxt https://example.com --model nonexistent-model-xyz --max-urls 2 --depth 1`
 2. Observe error about model not found
 
 **Expected Results**:
@@ -636,7 +636,7 @@ sleep 2
 **Verification Commands**:
 ```bash
 # Run with invalid model
-llmtxt https://typer.tiangolo.com --model nonexistent-model-xyz --max-urls 5 2>&1 | tee error.log
+llmtxt https://example.com --model nonexistent-model-xyz --max-urls 2 2>&1 | tee error.log
 EXIT_CODE=$?
 
 test $EXIT_CODE -ne 0 && echo "PASS: non-zero exit" || echo "FAIL: should have failed"
@@ -649,7 +649,7 @@ grep -qi "model\|not found\|available" error.log && echo "PASS: model error" ||
 **Cleanup**:
 ```bash
 rm -f error.log
-rm -rf ~/.claude/docs/typer.tiangolo.com.txt 2>/dev/null
+rm -rf ~/.claude/docs/example.com.txt 2>/dev/null
 rm -rf .llmsbrieftxt_cache/ 2>/dev/null
 ```
 
@@ -687,8 +687,8 @@ Run all scenarios above and mark results:
 5. Run integration tests (TS-008, TS-012) if those environments available
 
 **Test Environment**:
-- Use typer.tiangolo.com as the standard test URL (~25 pages, stable documentation)
-- Use `--max-urls 10 --depth 1` for faster test cycles
+- Use example.com as the standard test URL (1-2 pages, stable, fast)
+- Use `--max-urls 2 --depth 1` for faster test cycles
 - Always clean up between tests to ensure isolated state
 - Keep Ollama running in background: `ollama serve > /dev/null 2>&1 &`
 - Monitor Ollama logs if needed: `tail -f ~/.ollama/logs/server.log`

{llmsbrieftxt-1.8.2 → llmsbrieftxt-1.9.0}/pyproject.toml

@@ -7,7 +7,7 @@ packages = ["llmsbrieftxt"]
 
 [project]
 name = "llmsbrieftxt"
-version = "1.8.2"
+version = "1.9.0"
 description = "Generate llms-brief.txt files from documentation websites using AI"
 readme = "README.md"
 requires-python = ">=3.10"