Skip to content

refactor(server): effectify project json route handlers#1029

Open
Astro-Han wants to merge 1 commit into
devfrom
codex/i936-project-route-effect
Open

refactor(server): effectify project json route handlers#1029
Astro-Han wants to merge 1 commit into
devfrom
codex/i936-project-route-effect

Conversation

@Astro-Han
Copy link
Copy Markdown
Owner

Summary

Migrate the project JSON route handlers to the existing AppRuntime.runPromise(Effect.gen(...)) route runtime pattern.

Why

This continues the #936 ordinary JSON route migration for the project route group without changing public route contracts or touching forbidden streaming, auth, workspace sync, v2, or SDK/OpenAPI source areas.

Related Issue

Refs #936

Human Review Status

Pending

Review Focus

Please check that project list/current/init/update still delegate to the same project/instance behavior while route service access moves through the Effect runtime.

Risk Notes

PATCH /project/:projectID is migrated through the same Project.Service.update path; the focused local route coverage exercises list/current/init because the simple fixture does not create an updateable project row without broadening into product setup.

Skipped conditional checklist items:

  • Visible UI/copy check: not applicable; server-only route refactor.
  • Platform/packaging check: not applicable; no platform or packaging surface touched.
  • Docs/release/dependency/local file check: not applicable; no docs, dependencies, generated content, credentials, or local-only files changed.

How To Verify

Focused route tests: bun test test/server/project-init-git.test.ts -> 3 pass, 0 fail
Diff check: git diff --cached --check -> passed before commit

Screenshots or Recordings

Not applicable; no visible UI changes.

Checklist

  • Type label — this PR carries exactly one of bug, enhancement, task, documentation. Type labels are author-added; the labeler bot does NOT assign them. Add the label in the GitHub UI, then tick this.
  • Routing labels — this PR carries at least one of app, ui, platform, harness, ci. The labeler bot assigns these on PR open based on changed paths. Confirm the bot's choice (or override if wrong), then tick this.
  • Priority label — this PR carries exactly one of P0, P1, P2, P3. The priority-triage bot suggests one on PR open. Confirm or override, then tick this.
  • Human Review Status above is set to Pending, Approved by @<reviewer>, or Not required: <reason> (default is Pending; "not required" is restricted to bot-authored low-risk PRs).
  • I linked the related issue, or stated in Summary why there is no issue.
  • I described the review focus and any meaningful risks.
  • I replaced the example block in How To Verify with the real verification steps and the key result for each.
  • I did not introduce unrelated refactors, dependencies, generated files, or file changes beyond the stated scope.
  • (conditional) I manually checked visible UI or copy changes when needed, with screenshots or recordings. Leave unticked only if no visible UI or copy changed.
  • (conditional) I considered macOS and Windows impact for platform, packaging, updater, signing, paths, shell, or permissions changes. Leave unticked only if no platform/packaging surface was touched.
  • (conditional) I called out docs, release notes, dependencies, permissions, credentials, deletion behavior, generated content, or local file changes when relevant. Leave unticked only if none of those surfaces was touched.
  • I reviewed the final diff for unrelated changes and suspicious dependency changes.
  • I am targeting dev, and my PR title and commit messages use Conventional Commits in English.

@Astro-Han Astro-Han added P2 Medium priority upstream Tracked upstream or vendor behavior harness Model harness, prompts, tool descriptions, and session mechanics task Narrow execution, audit, spike, migration, tracking, or upstream follow-up work tech-debt Supplemental cleanup, maintainability, architecture, test, or quality debt context labels May 31, 2026
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented May 31, 2026

Warning

Review limit reached

@Astro-Han, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 3 minutes and 46 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 8d8c81ea-356c-4ef7-a8ad-ed42a25689d6

📥 Commits

Reviewing files that changed from the base of the PR and between c019c11 and 79f96f9.

📒 Files selected for processing (2)
  • packages/opencode/src/server/instance/project.ts
  • packages/opencode/test/server/project-init-git.test.ts
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/i936-project-route-effect

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown

@github-actions github-actions Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested priority: P2 (includes non-doc, non-test paths outside the low-risk bucket).

P1/P0 are reserved for maintainer confirmation. Please relabel manually if this is a release blocker, security issue, data-loss risk, or updater/runtime failure.

Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request refactors the project routes in packages/opencode/src/server/instance/project.ts to use Effect and AppRuntime.runPromise for handling asynchronous operations, and adds corresponding integration tests. The review feedback suggests two improvements: using Effect.tryPromise instead of Effect.promise when calling Instance.reload to ensure potential failures are properly captured in the Effect failure channel, and removing the unnecessary AppRuntime.runPromise wrapper around the synchronous Instance.project getter to avoid overhead.

Comment on lines +88 to 106
const next = await AppRuntime.runPromise(
Effect.gen(function* () {
const service = yield* Project.Service
const project = yield* service.initGit({
directory: dir,
project: prev,
})
if (project.id === prev.id && project.vcs === prev.vcs && project.worktree === prev.worktree) return project
yield* Effect.promise(() =>
Instance.reload({
directory: dir,
worktree: dir,
project,
}),
)
return project
}),
)
return c.json(next)
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

high

When wrapping operations that can fail (such as database queries or filesystem operations like Instance.reload) in Effect, use Effect.tryPromise with a try/catch structure instead of Effect.promise so that failures are properly captured in the Effect failure channel rather than causing unrecoverable crashes. Ensure regression tests are added to verify that failures stay in the failure channel.

        yield* Effect.tryPromise({
          try: () => Instance.reload({
            directory: dir,
            worktree: dir,
            project: next,
          }),
          catch: (error) => new Error(String(error))
        })
References
  1. When wrapping operations that can fail (such as database queries or filesystem operations) in Effect, use Effect.tryPromise with a try/catch structure instead of Effect.promise so that failures are properly captured in the Effect failure channel rather than causing unrecoverable crashes. Ensure regression tests are added to verify that failures stay in the failure channel.

Comment on lines +60 to +65
const project = await AppRuntime.runPromise(
Effect.gen(function* () {
return Instance.project
}),
)
return c.json(project)
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

Wrapping Instance.project in AppRuntime.runPromise is unnecessary because it is a synchronous getter that does not use any Effect services. We can directly return c.json(Instance.project) to avoid the overhead of creating an Effect fiber.

        return c.json(Instance.project)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

harness Model harness, prompts, tool descriptions, and session mechanics P2 Medium priority task Narrow execution, audit, spike, migration, tracking, or upstream follow-up work tech-debt Supplemental cleanup, maintainability, architecture, test, or quality debt context upstream Tracked upstream or vendor behavior

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant