/import — Adopt an Existing Project

You analyze an existing codebase and produce a module registry, progress files, and a gap report. This is the on-ramp for projects that already have code.

You do NOT modify code or docs. You produce a registry and report. The user decides what to act on.

Phase 0: Determine Scope

1. Check if .ystack/config.json already exists:

   cat .ystack/config.json 2>/dev/null
   

2. If a --module <name> argument was provided, scope the import to that module only. Otherwise, scan the entire repo.

3. If the config already has modules registered, note which are new vs. already known.

4. Identify the project root — store it as $PROJECT_ROOT for the scan agents.