Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions CONFIGURATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -312,6 +312,17 @@ Privacy note: the keyless floor sends the query (to DuckDuckGo / your SearXNG in

Visible quality difference between hosts with vs without native search or a configured backend. If your client setup produces thinner results than yours, this is usually why.

### YouTube degraded-run detection

When yt-dlp is stale it still returns search results but fails to fetch transcripts for every video. The engine detects this and surfaces a `DEGRADED RUN WARNING` in the output. The detection threshold is a ratio (fetched transcripts ÷ videos returned); the default `0.5` means two or more failures in a four-video result triggers the warning. Tune per-environment:

```bash
DEGRADED_TRANSCRIPT_THRESHOLD=0.3 # more tolerant: allow more misses before warning
DEGRADED_TRANSCRIPT_THRESHOLD=0.8 # stricter: warn even on a single miss in a small result
```

Set to `0` to disable the nudge entirely (not recommended — a stale yt-dlp silently produces weak briefs).

---

### `--hiring-signals` flag
Expand Down
1 change: 1 addition & 0 deletions skills/last30days/scripts/lib/env.py
Original file line number Diff line number Diff line change
Expand Up @@ -462,6 +462,7 @@ def get_config(policy: ConfigLoadPolicy | None = None) -> dict[str, Any]:
('EXCLUDE_SOURCES', ''),
('LAST30DAYS_DEFAULT_SEARCH', ''),
('LAST30DAYS_YOUTUBE_SSH_HOST', None),
('DEGRADED_TRANSCRIPT_THRESHOLD', None),

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 CONFIGURATION.md not updated

AGENTS.md says CONFIGURATION.md must be kept in sync with user-facing knobs. DEGRADED_TRANSCRIPT_THRESHOLD is explicitly called out in quality_nudge.py as operator-tunable ("Tunable via DEGRADED_TRANSCRIPT_THRESHOLD env var if operators need to adjust without code changes"), so it qualifies. Now that the key is actually loaded from .env, users who discover it in quality_nudge.py comments won't find any documentation in CONFIGURATION.md describing the expected range, units (ratio 0–1), or effect.

Context Used: AGENTS.md (source)

Note: If this suggestion doesn't match your team's coding style, reply to this and let me know. I'll remember it for next time!

Fix in Codex Fix in Claude Code Fix in Cursor Fix in Conductor

('LAST30DAYS_TRANSCRIPT_TIMEOUT', None),
(KEYCHAIN_ALIASES_ENV, None),
# Whisper transcription provider for caption-free audio/video. Groq's
Expand Down
Loading