Commit Graph

17 Commits

Author SHA1 Message Date
Gandalf the Greybeard 7b5a9c5ceb docs: remove manual install sections from README
ArtifactHub plugin installer is the only supported installation method.
Remove manual tarball, sidecar, and build-from-source install options
to align documentation with company policy.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-03-17 12:15:44 +00:00
null-pointer-nancy[bot] 60d1d195af ci: retrigger after shared workflow fix (#10)
CI retrigger after shared workflow fix (.github PR#14)
2026-03-15 17:54:24 +00:00
DevContainer User 761f7cf242 fix: correct broken links, stale versions, and dead references in docs
- README: fix LICENSE link, remove dead doc links, update install
  instructions, remove hardcoded version/bundle size/LOC metrics
- artifacthub-pkg.yml: fix appVersion 0.2.18 → 0.2.20, fix README
  path, fix build-from-source cd path
- docs/README.md: trim to only reference files that actually exist
  (was 160 lines of aspirational links, now 47 lines of real ones)
- CLAUDE.md: correct "no MUI imports" claim — code uses @mui/material
- headlamp-plugin-developer agent: match corrected MUI convention

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-04 12:22:38 +00:00
DevContainer User af95c3795c chore: move source to repo root and standardize config
Phase 1 — Structural overhaul:
- Move all source from headlamp-sealed-secrets/ subdirectory to repo root
- Delete 23 AI-generated docs, 8 pre-built tarballs, release snapshots dir
- Remove all working-directory refs from CI/release workflows
- Update install-plugin.sh and typedoc.json paths

Phase 2 — Config standardization:
- Create .eslintrc.js and .prettierrc.js (standard Headlamp configs)
- Remove inline eslintConfig/prettier from package.json (drop jsx-a11y, prettier extends)
- Rewrite tsconfig.json (package name extend, add compilerOptions.types)
- Create vitest.config.mts and vitest.setup.ts (standard from polaris)
- Replace headlamp-plugin CLI scripts with direct tool invocation
- Rewrite .gitignore with standard baseline

Phase 3 — MCP & Claude settings:
- Create .mcp.json with github/kubernetes/flux/playwright servers
- Create .claude/settings.local.json
- Remove 7 specialized agents, keep 3 meta-orchestration agents

Phase 4 — Documentation:
- Rewrite CLAUDE.md (remove subdirectory refs, standard format)
- Add ArtifactHub badge, Architecture section, standardized install methods to README.md
- Create CONTRIBUTING.md and SECURITY.md
- Fix pre-existing test bugs in validators.test.ts (isValidNamespace returns boolean,
  not ValidationResult; error message string mismatches)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-03 21:31:12 +00:00
Chris Farhood 934e79c570 test: verify runner picks up jobs after minRunners=1 2026-02-12 14:34:48 -05:00
Chris Farhood 1822c5c148 test: verify ARC runner picks up jobs 2026-02-12 14:26:20 -05:00
Chris Farhood b44f118196 fix: update owner references from cpfarhood to privilegedescalation
- Updated artifacthub-repo.yml owner and email
- Updated all artifacthub-pkg.yml files (current and historical versions)
- Updated package.json author
- Updated README.md badge URLs
- Updated all version-specific metadata files

Part of organization migration from cpfarhood to privilegedescalation.
2026-02-12 11:55:25 -05:00
Chris Farhood 0c02a349ef docs: final cleanup - fix all remaining inconsistencies
Fixed:
- Badge URLs in README.md (cpfarhood → privilegedescalation)
- Repository references in docs/README.md
- Old version references in docs (v0.2.0 → v0.2.4)
- Tarball filenames in installation guides (0.2.0 → 0.2.4)
- Publishing documentation references
- Removed remaining emojis from README

All documentation now consistently references:
- Organization: privilegedescalation
- Version: 0.2.4
- No emojis or marketing fluff
- Correct tarball checksums

Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
2026-02-12 11:22:05 -05:00
Chris Farhood 8001e87088 docs: remove all marketing fluff and emojis from README
Removed:
- All emojis from section headers and content
- "Star History" section requesting stars
- "Made with ❤️" footer
- Time estimates ("2 minutes", "5 minutes")
- "Use Cases" marketing section
- "Real-World Examples" section
- "Coming Soon" teaser section
- Horizontal dividers
- Emoji bullets throughout

Added:
- Simple, factual Features section

Cleaned up:
- Fixed remaining badge URLs (cpfarhood → privilegedescalation)
- Fixed tarball filename (0.2.0 → 0.2.4)
- Removed marketing language throughout

Result: 108 lines removed, 47 lines added
README is now professional, factual, and focused on technical content.

Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
2026-02-12 11:17:29 -05:00
Chris Farhood 319d02f849 docs: remove marketing language and add Artifact Hub README
Removed marketing fluff:
- Replaced "Zero Trust Architecture" with factual "How It Works"
- Removed buzzwords and kept technical accuracy
- Simplified security explanation to be clear and honest

Added Artifact Hub README:
- Created README.md for v0.2.4 release directory
- Clean, professional documentation without marketing speak
- Focused on features, usage, and troubleshooting
- Will appear on Artifact Hub package page

Both READMEs now:
- Provide accurate technical information
- Avoid exaggerated claims
- Focus on what the plugin actually does
- Keep language straightforward and honest

Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
2026-02-12 11:15:48 -05:00
Chris Farhood 0199c8c330 docs: update all documentation for v0.2.4 release
Updated all documentation to reflect current state:

Version Updates:
- Updated root README.md from v0.2.0 to v0.2.4 in installation instructions
- Updated "Latest release" badge to v0.2.4
- Updated CHANGELOG.md with v0.2.1, 0.2.2, 0.2.3, and 0.2.4 entries
- Added version comparison links for all releases

URL Migrations:
- Fixed all GitHub badge URLs from cpfarhood to privilegedescalation org
- Updated plugin README.md repository URL placeholder
- Ensured all references use privilegedescalation/headlamp-sealed-secrets-plugin

Changelog Additions:
- v0.2.4: Icon loading fix (Material-UI → Iconify)
- v0.2.3: Superseded by v0.2.4 (checksum mismatch note)
- v0.2.2: SDK downgrade to fix React context errors
- v0.2.1: Removed invalid main field from package.json

All version numbers, checksums, and URLs are now consistent across:
- package.json: 0.2.4
- artifacthub-pkg.yml: 0.2.4
- README.md: 0.2.4
- CHANGELOG.md: 0.2.4
- GitHub releases: v0.2.4

Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
2026-02-12 11:09:44 -05:00
Chris Farhood 46d59b48b5 chore: migrate repository to privilegedescalation organization
Updated all GitHub URLs from cpfarhood to privilegedescalation organization:
- Repository URLs in package.json and Artifact Hub metadata
- Documentation links and references
- Git remote updated

No functional changes - this is purely an organizational migration.

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
2026-02-12 10:50:30 -05:00
Chris Farhood c5b20980da docs: remove zero trust security callout from README 2026-02-12 07:33:26 -05:00
Chris Farhood e670b688a1 docs: replace 'Built for Reliability' with 'Additional Features'
More straightforward section title without marketing fluff.

Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
2026-02-11 23:50:44 -05:00
Chris Farhood be7a135dd3 docs: remove 'production ready' marketing speak
Replaced with more straightforward language:
- 'production-ready features' → removed
- 'Production Ready' → 'Built for Reliability'

Removed from:
- README.md tagline and highlights section
- artifacthub-pkg.yml descriptions (both locations)

Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
2026-02-11 23:50:21 -05:00
Chris Farhood d2a032b34b docs: enhance README with comprehensive improvements
Enhanced README.md with:

**Visual Improvements**:
- Added test coverage and TypeScript badges
- Zero Trust Security callout banner
- Better structured sections with tables and diagrams
- Real-world code examples

**Features Section**:
- Reorganized into Security, Developer Experience, Accessibility, Production
- Clearer categorization of capabilities
- Highlighted unique features (client-side crypto, RBAC-aware UI)

**Quick Start**:
- Step-by-step installation with time estimates
- Code blocks for easy copy-paste
- Clear verification steps
- Link to detailed tutorial

**Documentation Navigation**:
- Categorized by Getting Started, User Guides, Tutorials, Reference
- Direct links to most important docs
- Complete documentation index link

**Use Cases**:
- Table format with guide links
- Real-world YAML and bash examples
- Practical scenarios (GitOps, CI/CD, multi-env)

**Security Section**:
- Visual architecture diagram showing zero-trust flow
- Security features table with implementation details
- Threat model matrix with mitigation status
- Links to ADR 003 and security hardening guide

**Technical Details**:
- Code quality metrics table
- Technology stack overview
- Architecture highlights with ADR links
- Emphasis on type safety and testing

**Contributing**:
- Quick start command block for contributors
- Contribution areas table with "good first issue" guidance
- Pre-submission checklist
- Links to workflow and testing guides

**Issues & Support**:
- Tiered support approach (docs → search → community → report)
- Common issues quick reference table
- Clear next steps for users

**Links Section**:
- Organized by Project Resources and External Resources
- Added Discussions and kubeseal CLI links
- Star History encouragement

Total changes: ~200 lines enhanced/reorganized

Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
2026-02-11 23:45:04 -05:00
Chris Farhood bdf19cd3bf docs: implement Phase 1 - documentation reorganization
Reorganize and consolidate documentation into structured `/docs` directory
for better navigation and maintainability.

New documentation structure:
- docs/README.md - Documentation hub with complete index
- docs/getting-started/ - Installation and quick start guides
- docs/development/ - Workflow and testing guides
- docs/archive/ - Archived PHASE_*.md completion summaries

Key changes:
- Created docs/ directory with 9 subdirectories
- Moved HEADLAMP_INSTALLATION.md → docs/getting-started/installation.md (streamlined)
- Created docs/getting-started/quick-start.md (5-minute tutorial)
- Moved DEVELOPMENT.md → docs/development/workflow.md
- Moved TESTING_GUIDE.md → docs/development/testing.md
- Archived 12 PHASE_*.md files to docs/archive/
- Updated CHANGELOG.md with v0.2.0 details
- Created main README.md with badges and links to docs

Benefits:
- Clear documentation hierarchy by user journey
- Easier navigation with centralized docs/README.md index
- Reduced clutter in repository root
- Improved cross-referencing between documents
- Better onboarding for new users and contributors

Phase 1 deliverables (1-2 days estimated, completed):
 Organized docs/ directory structure
 Consolidated installation guides
 Streamlined development documentation
 Updated CHANGELOG to v0.2.0
 Archived phase completion files
 Created documentation hub
 Updated main README with navigation
 Fixed cross-references

Next: Phase 2 - API documentation with TypeDoc

Generated with [Claude Code](https://claude.ai/code)
via [Happy](https://happy.engineering)

Co-Authored-By: Claude <noreply@anthropic.com>
Co-Authored-By: Happy <yesreply@happy.engineering>
2026-02-11 23:23:39 -05:00