Skip to content
Source
Sign inSign up

Fix a factory file error

Software factory / Custom agents

Fix an error in the factory file

A factory file has an error, so no custom agent runs. The built-in agents still run. Find the error, fix the file, and save it again.

2 min read

You need:

  • Admin access to the repository.

1. Find the error

Admins see the errors in these places:

  • Agents, Software factory, Custom agents: a red alert lists each error, with its file name.
  • src factory agents: it prints the errors on stderr, after the list of files, and exits 0.
  • REST and MCP: GET /repos/<owner>/<repo>/factory/agents/status, and the tool get_custom_agent_status.

Read the error. It starts with the file, for example factory/house.ts:.

2. Fix the file

Fix the file, and run it with Node.js, as in Check the file on your machine.

3. Save the file again

Save the file again, with the same name. For .source/factory.ts, push the fix to the default branch.

Done

The alert goes away, and the card lists the agents that loaded.

Who sees the errors on an item

The Factory panel of an issue or a pull request also says that the custom agents cannot run. Only people who can read the file see its errors there, because an error can quote the file:

  • The errors of .source/factory.ts show to people with write access.
  • The errors of files in the vault show to the admins of the repository. Other people with write access read that an admin can see the errors in the factory settings.
  • Everyone else reads that some custom agents cannot run now.