refactor(compilers)!: rename frontend→compiler and backend→emitter - #5
Merged
Conversation
Rename the spec→IR pipeline layer from "frontend" to "compilers" (with the verb "compile") and the IR→artifact layer from "backend" to "emitters", so the package names match the pipeline vocabulary used in the design docs (compilers → passes → emitters). - Move frontend/ to compilers/; Frontend.Parse becomes Compiler.Compile. - Rename the emitter contract identifiers (EmitterInput/EmitterOutput). - Rename the CLI subcommand from "parse" to "compile". - Sweep prose and docs, renaming docs/backend-design.md to docs/emitter-design.md and updating the architecture layering. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
The planning documents under docs/superpowers/plans/ are local session-development artifacts that should not live in version control. Add docs/superpowers/ to .gitignore and remove the previously committed plan files from the index (they remain on disk). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
OmarAlJarrah
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Aligns the package layout with the pipeline vocabulary used throughout the design docs: compilers → passes → emitters. Previously the spec→IR layer was named
frontendand the IR→artifact layerbackend, which didn't match the terms the docs, architecture, and CLI describe.frontend/→compilers/;Frontend.ParsebecomesCompiler.Compile(the verb is now "compile").BackendInput/Output→EmitterInput/EmitterOutput). No emitter code exists yet — this is a docs-only rename that keeps the future contract's vocabulary consistent.parse→compile(see Breaking below).docs/backend-design.md→docs/emitter-design.mdand the architecture layering tables.docs/superpowers/(added to.gitignore, removed from the index; files remain on disk).The IR is untouched: golden IR payloads are byte-identical (IDs derive from source pointers, not package names), so no library or IR behavior changes. The one observable change is the CLI subcommand name.
Breaking
The CLI subcommand is renamed
parse→compile.morphic parse <spec>now reportsunknown command "parse"; invokemorphic compile <spec>instead. Flags and output are unchanged. No released binary exists yet, so no published interface is affected.Test plan
gofmt -lclean on all first-party packagesgo vet ./...cleango test ./...— all packages pass🤖 Generated with Claude Code