Update Entry

Update Entry

Step 0: Language selection

Before proceeding with any other steps in this skill, ask the user which language to continue in using AskUserQuestion. Keep this initial prompt in English because the preferred language is not yet known.

• Question: Which language should I continue in?
• Options: English, 日本語 (Japanese)

Use the selected language for all subsequent user-facing messages and for every further AskUserQuestion prompt in this skill. Do not translate code, file paths, shell commands, or file contents.

Sync a single deploy/{ASSISTANT_NAME}/ entry file with its deploy/templates/ template. Preserves user customizations while incorporating new features.

Steps

1. Choose target

AskUserQuestion: Which entry point to update?

• Host — orchestrator config (deploy/{ASSISTANT_NAME}/host/entry.ts)
• Container — agent container config

2. If Container, choose agent

AskUserQuestion: Which agent?

• Claude Code — deploy/{ASSISTANT_NAME}/container/claude-code/entry.ts
• Open Code — deploy/{ASSISTANT_NAME}/container/open-code/entry.ts

3. Resolve paths

4. Check current state

test -f <local_path> && echo "EXISTS" || echo "MISSING"

If missing, create the directory and copy from template:

mkdir -p <local_dir>
cp <template_path> <local_path>

For container targets, also copy the type stub for IDE resolution:

cp deploy/templates/container/<agent>/index.d.ts deploy/{ASSISTANT_NAME}/container/<agent>/index.d.ts

If copied fresh, skip to verification.

5. Diff template vs local

Read both files. Compare and identify:

• New in template — new registrations, imports, config changes
• Custom in local — user-added plugins, custom config, extra logic
• Conflicts — same section modified differently

Host-specific items

• Channel plugin registrations (registry.register)
• MCP plugin registrations (registerMcpPlugin)
• Hooks plugin registration (registerHooksPlugin)
• Mount allowlist configuration (setMountAllowlist)

Container-specific items

• Container plugin imports (import(pluginPath))
• Plugin push blocks (plugins.push)
• Hook factory wiring (createHooks)

6. Merge changes

Apply new template additions to the local file while preserving user customizations:

• New plugins/registrations — add blocks that don't exist in local
• Updated imports — add missing imports
• Removed features — warn user but don't remove unless they confirm

7. Verify

# Host:
pnpm exec tsc --noEmit

# Claude Code container:
pnpm exec tsc --noEmit -p host/agent-runner-claudecode/tsconfig.json

# Open Code container:
pnpm exec tsc --noEmit -p host/agent-runner-opencode/tsconfig.json

TypeScript must compile without errors.

8. Summary

Show the user what changed:

• Added: list of new registrations/imports
• Preserved: list of user customizations kept
• Removed: list of anything removed (if any)

Rules

• Never overwrite user customizations without asking
• Never remove registrations the user added manually
• Always preserve custom env variable names, plugin configs, extra logic
• If unsure about a conflict, use AskUserQuestion to let the user decide
• After merging, always verify TypeScript compiles