Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

šŸ¤– refactor: put the app config modules that agent-loop files import behind Effect services

Open
  • Is something wrong?
#7,240 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
35/100
Issue type
Refactor
Clarity
Clearly specified
Activity status
Active
Tech stack
typescript
Domain
backend

Research direction

Read the phase 5 plan v4, especially claim 3.5, then inspect the four listed modules: src/node/config/index.ts, src/node/multiProject/containerManager.ts, src/node/services/providerModelFactory.ts, and src/node/utils/extensionMetadata.ts. Use reach.mjs --phase2 and reachRefs.mjs to understand the reported host access and verify the phase 5 trigger has completed. Done means each moduleā€™s host access uses the named Effect services and Node and test layers, with behavior and persisted files unchanged.

Written by the indexing model from the issue text.

Description

Summary

Agent-loop files import these modules, and the modules still reach the host directly (fs, os, child_process, writeFileAtomic, a runtime class or a runtime builder). The local/no-host-imports rule checks only the agent-loop files themselves, so it does not see this host access. Phase 5 of the agent-loop refactor does not move these modules: its plan (claim 3.5, decision "reach") keeps one follow-up issue per group. This issue is the app config group: Config, providers, extension metadata and multi-project containers.

Modules

Module Host refs Host imports Imported by agent-loop files at
src/node/config/index.ts 37 fs:3 utils/writeFileAtomic:6 utils/fs:119 runtime/DockerRuntime:123 aiService.ts:53 tools/task_list.ts:20
src/node/multiProject/containerManager.ts 5 fs/promises:2 aiService.ts:59
src/node/services/providerModelFactory.ts 2 fs/promises:11 aiService.ts:113
src/node/utils/extensionMetadata.ts 2 fs:1 aiServiceEventGuards.ts:8

Total: 4 module(s), 46 uses of host bindings. Counts and lines come from reach.mjs --phase2 and reachRefs.mjs of the phase 5 plan, at ba9e451cab (phase 1 changed no file under src/).

Work

Move the host access of each module behind the Effect services that phase 5 adds (HostFiles, HostPaths, HostProcesses, RuntimeFactory, SessionFiles, SessionLocks), with a Node layer and a test layer, and no change in behavior or persisted files.

Trigger

After phase 5 ends (stacks 5a and 5b merged). Phase 5 end check 7 expects reach.mjs --phase2 to list only the 30 follow-up modules of these 8 issues and log.

Refs

  • Phase 5 plan v4 ("Host I/O Services for the Xum Agent Loop", artifact phase5-plan.html), claim 3.5.
  • Refs #7207 (the local/no-host-imports rule and its frozen pairs).

Generated with xum ā€¢ Model: anthropic:claude-opus-5-5 ā€¢ Thinking: high ā€¢ Cost: $31.10

Dominant language
TypeScript
Stars
2.1k
Forks
140
Avg merge
5h 8m
Merged PRs (30d)
952

Getting set up

  • Ships a Dockerfile or Docker Compose file
  • No pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up ā€” it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from coder/xum

All issues in coder/xum

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.