git:20260527.5b1cf19 to git:20260916.0fdac6b

10 added, 17 removed. Audit A to A.

---

name: metagit-config-refresh

- description: Refresh or bootstrap `.metagit.yml` using deterministic discovery and validation flows. Use when configuration is missing, stale, or incomplete for workspace operations.

+ description: Refresh or bootstrap `.metagit.yml` using deterministic init/validate. Use when configuration is missing, stale, or incomplete for workspace operations.

---

# Refreshing Project Config

- Use this skill to keep `.metagit.yml` accurate and operational.

+ Keep `.metagit.yml` accurate without dumping detect output into context.

## Workflow

- 1. Check workspace activation and config validity.

- 2. Run bootstrap plan mode first.

- 3. Review generated changes against expected workspace topology.

- 4. Apply config updates and validate schema before continuing.

- ## Command Wrapper

- - `./skills/metagit-bootstrap/scripts/bootstrap-config.sh [root_path] [mode] [seed_context]`

+ 1. `metagit config validate -c .metagit.yml` (or note that the file is missing).

+ 2. If missing: `metagit init --kind application --no-prompt` or `skills/metagit-bootstrap/scripts/bootstrap-config.sh .`

+ 3. Optional enrich: `metagit detect repository -p . -o summary`, or `--output-file .metagit/.detect/repository.json` for the full payload. Do not run `detect repo_map`.

+ 4. Patch with `metagit config patch` / catalog commands. Re-validate.

- ## Output Contract

+ ## Output contract

- Return:

- - config health state before/after

- - generated update summary

- - any manual follow-up needed

+ Return config health before/after, a short update summary, and any manual follow-up. Do not paste full YAML.

## Safety

- - Prefer plan/dry-run first for large config updates.

- - Keep changes bounded to target workspace intent.

+ - Prefer plan/dry-run for large updates.

+ - Never overwrite a valid umbrella workspace mapping without confirmation.