docs: cold architectural audit + publish workflow fix

[carlos-alm]

Summary

• Architecture audit (architecture.md): 18 unconstrained redesign proposals covering modularity, data access, pipeline design, scalability, and extensibility — prioritized by architectural impact
• Publish workflow fix: Pin checkout to ref: main so the publish job always checks out the correct branch
• Lockfile sync: Update native optional dep versions from 1.3.0 → 1.4.0 to match current release

Test plan

• Verify architecture.md renders correctly on GitHub
• Verify npm run lint passes
• Confirm publish workflow checkout change is correct

[greptile-apps]

Greptile Summary

Adds comprehensive architectural audit document and fixes publish workflow to correctly handle release events.

Major changes:

• New architecture.md with 18 unconstrained redesign proposals covering parser modularity, repository pattern, pipeline architecture, and API surface design
• Publish workflow now pins checkout to ref: main ensuring correct branch is used
• Publish workflow skips version bump when triggered by release event (prevents double-versioning)
• Push step now only runs on workflow_dispatch events, not release events
• Native optional dependency versions synced to 1.4.0 in lockfile

The workflow changes prevent version conflicts when publish is triggered by a release event that already contains the versioned code.

Confidence Score: 5/5

• This PR is safe to merge with minimal risk
• Changes are well-scoped: documentation addition, workflow logic fix with correct conditional logic, and lockfile version sync. No functional code changes to core library. Workflow changes fix a legitimate issue with release-triggered publishes.
• No files require special attention

Important Files Changed

Filename	Overview
.github/workflows/publish.yml	Pins checkout to ref: main and adds release event check to skip version bump when triggered by release
architecture.md	New architectural audit doc with 18 redesign proposals prioritized by impact
package-lock.json	Syncs native optional dependency versions from 1.3.0 → 1.4.0 to match current release

_{Last reviewed commit: 880194e}

[greptile-apps]

_{3 files reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}