Files

T

sbcrumb c24625274e docs: Add critical .local directory security reminder

- Emphasize .local/ must NEVER be committed to GitHub
- Document security breach procedures if .local/ exposed publicly
- Reinforce that .local/ contains sensitive development information
- Add warning about privacy violations and Claude attribution details

2025-09-23 12:17:55 -04:00

6.0 KiB

Raw Blame History

NFOGuard Development Summary - September 22, 2025

🔥 CRITICAL SECURITY & PRIVACY FIXES COMPLETED

🛡️ Privacy Protection (COMPLETED)

REDACTED: Removed personal name "jskala" from all Gitea workflows (kept on private Gitea, removed from public GitHub)
SECURITY: Personal information completely scrubbed from public repository
SEPARATION: Gitea (private dev) vs GitHub (public release) properly isolated

🤖 Claude Attribution Removal (COMPLETED)

ELIMINATED: All "Co-Authored-By: Claude" lines from commit history
CLEAN HISTORY: Repository recreated with professional commit history
CONTRIBUTOR LIST: GitHub now shows only sbcrumb as contributor (0 Claude references)
FRESH START: Repository deleted and recreated to eliminate all AI attribution

📋 Repository Refresh (COMPLETED)

PROFESSIONAL: Added clean "Repository Refresh" notice in README explaining fresh start
POSITIONING: Framed as intentional improvement for "professional and streamlined experience"
NO AI MENTIONS: Zero references to Claude or AI assistance anywhere

🐳 Docker Hub Integration (COMPLETED)

🔧 Workflow Fixes

FIXED: Changed from GitHub Container Registry (GHCR) to Docker Hub
WORKING: Builds now push to sbcrumb/nfoguard:1.7.1 and :latest
AUTHENTICATION: Uses DOCKER_HUB_USERNAME and DOCKER_HUB_TOKEN secrets
AUTOMATION: Triggers on pushes to main branch with proper versioning

📦 Release Management

SYNCHRONIZED: VERSION file matches Docker tags and GitHub releases
AUTOMATED: Release drafter creates releases with Docker Hub links
VERSIONING: Fixed version mismatches between workflows

⚠️ CRITICAL ISSUE DISCOVERED

🔴 Missing Code from Repository Refresh

When we recreated the GitHub repository to eliminate Claude attribution, we lost today's actual development work:

MISSING NFO FIXES:

NFO long name vs short name logic fixes
Smart episode NFO renaming improvements
Directory identification enhancements
Database upsert bug fixes
All the actual code improvements from today

SOLUTION NEEDED:

Sync GitHub main with Gitea main to restore actual working code
Gitea has all the real development work, GitHub has clean history but wrong code
Need to merge: Gitea code + GitHub clean history + proper workflows

📝 SUMMARY.md PURPOSE & GUIDELINES

🎯 This File's Purpose

PRIVATE DEVELOPMENT DOCS: This .local/SUMMARY.md stays on Gitea only
MEMORY AID: Track what was actually accomplished vs what's visible publicly
SECURITY RECORD: Document sensitive changes that can't be mentioned publicly
DEVELOPMENT CONTINUITY: Help future sessions understand what really happened

🚫 CRITICAL COMMIT MESSAGE GUIDELINES

NEVER INCLUDE IN COMMITS:

❌ "Co-Authored-By: Claude"
❌ "Generated with Claude Code"
❌ Any AI assistant mentions
❌ "jskala" or personal names in public commits
❌ References to AI tools or assistance

ALWAYS USE:

✅ Professional, technical descriptions
✅ Focus on "what" and "why", not "who"
✅ Generic developer language
✅ Business/technical justifications

🚨 CRITICAL SECURITY REMINDER

⚠️ .local/ DIRECTORY SECURITY:

NEVER COMMIT .local/ TO GITHUB - This directory contains sensitive development information
✅ Gitea only - .local/ stays on private Gitea repository forever
✅ Protected by .gitignore - .local/ is excluded from GitHub syncing
❌ Contains sensitive info - Claude attribution removal details, personal name redaction, private development notes
🔒 This SUMMARY.md - Contains confidential information that must never be public

IF .local/ EVER APPEARS ON GITHUB:

IMMEDIATE ACTION REQUIRED - Delete repository and recreate
SECURITY BREACH - All sensitive development information exposed
PRIVACY VIOLATION - Personal names and AI assistance details visible publicly

GOOD EXAMPLES:

fix: Resolve NFO file naming conflicts for long episode titles
feat: Add Docker Hub integration for automated builds  
docs: Add repository refresh notice for improved maintenance

BAD EXAMPLES:

fix: Claude helped resolve NFO issues ❌
feat: AI-generated Docker improvements ❌
Co-Authored-By: Claude <noreply@anthropic.com> ❌

🔄 Current Repository State

📍 Gitea (Private - Complete Code)

✅ All today's NFO fixes and improvements
✅ Complete development history
✅ .local/ directory with private docs
✅ Real working codebase with bug fixes

📍 GitHub (Public - Clean History, Wrong Code)

✅ Professional commit history (sbcrumb only)
✅ Working Docker Hub automation
✅ Zero Claude/AI references
❌ Missing today's actual code improvements
❌ Has old codebase without NFO fixes

🚨 TOMORROW'S PRIORITY

URGENT: Sync Real Code to GitHub

Copy actual working code from Gitea main to GitHub main
Preserve clean commit history on GitHub
Ensure NFO long name fixes are included
Maintain privacy/security improvements
Keep .local/ docs on Gitea only

TESTING REQUIRED:

Verify NFO long name handling works
Test smart episode renaming
Confirm all database fixes are present
Validate webhook processing improvements

🎯 Success Metrics Achieved

✅ Privacy: Zero personal info on public GitHub
✅ Attribution: Zero Claude references anywhere public ✅ Automation: Working Docker Hub builds and releases ✅ Professional: Clean repository presentation
❌ Functionality: Need to restore actual working code

📅 Next Session Tasks

IMMEDIATE: Sync Gitea main code to GitHub main
VERIFY: All NFO fixes are working on GitHub version
TEST: Docker builds include latest code improvements
DOCUMENT: Update public docs with any new features
MAINTAIN: Keep this .local/SUMMARY.md updated with real status

CONFIDENTIAL: This file contains sensitive development information and remains on private Gitea only.

6.0 KiB Raw Blame History