Skip to content

Conversation

@thoroc
Copy link
Contributor

@thoroc thoroc commented Jan 16, 2026

Summary

  • Restructures repository to fix mirror-packages workflow by clearly separating internal libraries from distributable packages
  • Moves internal tools from apps/ to libs/ (workflows, docs-builder)
  • Moves distributable package (opencode-font) from apps/ to packages/
  • Creates Nx generators for future consistency

Changes

Directory Structure:

  • apps/workflowslibs/workflows (internal CI/CD library)
  • apps/docs-builderlibs/docs-builder (internal Astro doc builder)
  • apps/opencode-fontpackages/opencode-font (distributable package)
  • Removed empty apps/ directory

Configuration Updates:

  • Updated all project.json files with new paths
  • Changed projectType from "application" to "library"
  • Added appropriate tags for internal libs and packages
  • Updated README.md with comprehensive documentation
  • Added clarifying comments to mirror-packages workflow

New Generators:

  • library generator: Creates internal libraries in libs/ (not mirrored)
  • package generator: Creates distributable packages in packages/ (mirrored, requires mirrorRepo)

Why This Change?

The mirror-packages workflow expects all mirrored packages to be in packages/ directory. The previous structure had a confusing apps/ directory mixing internal tools with distributable packages, causing workflow issues.

Testing

All paths and configurations updated. Build verified locally (pre-existing lint issues in opencode-font are unrelated to this PR).

See .context/sessions/repository-restructure-2026-01-16.md for detailed session notes.

- Move apps/workflows to internal/workflows (internal library)
- Move apps/docs-builder to internal/docs-builder (internal library)
- Move apps/opencode-font to packages/opencode-font (distributable package)
- Remove empty apps/ directory

Benefits:
- Clear distinction between internal libs (internal/) and distributable packages (packages/)
- Mirror workflow now only looks in packages/ directory
- Fixes workflow failures for non-mirrored internal tools

Changes:
- Update project.json files with new paths and tags
- Update README.md to reflect new structure
- Add clarifying comments to mirror-packages.yml
- Create 'library' generator for internal packages
- Create 'package' generator for distributable non-plugin packages
- Register new generators in generators.json

Resolves workflow issue where mirror-packages.yml was trying to mirror internal tools.
@thoroc thoroc force-pushed the restructure-apps-directory branch from 7c5548b to a284f0f Compare January 16, 2026 01:23
@github-actions
Copy link

⚠️ Large PR Warning

This PR is quite large with:

  • 161 changed files
  • 3462 added lines
  • 128 deleted lines

Consider breaking it down into smaller, focused PRs for easier review.

@github-actions
Copy link

⚠️ Large PR Warning

This PR is quite large with:

  • 162 changed files
  • 3534 added lines
  • 1520 deleted lines

Consider breaking it down into smaller, focused PRs for easier review.

@thoroc thoroc merged commit 79aad9a into main Jan 16, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants