solar-client

name: solar-client description: > Solar Client workspace lifecycle: init, sync, update, upgrade, bundle, and client-only doctor. Use when operating manifest, IDE sync, portable bundle, or global install hygiene.

Solar Client

Purpose

Manage the relationship between SOLAR_WORKSPACE and SOLAR_ROOT:

• workspace manifest (.solar/manifest.json),
• IDE/agent sync (sync-clients),
• portable bundle (workspace-snapshot),
• global install update and self-update,
• client-only doctor (manifest, bundle, symlinks, ports).

Workspace content health (sun/, planets/) is solar-workspace — use solar workspace doctor.

Required MCP

None

Validation commands

python3 core/skills/solar-skill-creator/scripts/package_skill.py core/skills/solar-client /tmp
bash -n core/skills/solar-client/scripts/client_lib.sh
bash -n core/skills/solar-client/scripts/client_doctor.sh
bash -n core/skills/solar-client/scripts/resolve_solar_paths.sh
python3 -m py_compile core/skills/solar-client/scripts/solar_paths.py
bash core/tests/skills/solar-client/test_resolve_solar_paths.sh
bash core/tests/skills/solar-client/test_solar_paths_py.sh

CLI (via solar entrypoint)

Canonical entry: core/skills/solar-client/scripts/solar

Resolve paths first (resolve_solar_paths.sh + solar_paths.py in this skill):

solar client init
solar client update [--check|--repair|--tag|--bundle]
solar client upgrade [--check|--restructure]
solar client sync [--portable]
solar client bundle create|verify
solar client doctor [--strict]
solar client self-update
solar status
solar paths
solar app …                # delegates to solar-app

Validation:

bash -n core/skills/solar-client/scripts/solar
bash -n core/skills/solar-client/scripts/solar_status.sh
bash -n core/skills/solar-client/scripts/solar_paths.sh

Workspace modes (core_source)

Install

bash core/skills/solar-client/scripts/install_solar_client.sh
# or: curl -fsSL .../bootstrap_solar_client.sh | bash

Smoke: bash core/skills/solar-client/scripts/smoke-solar-client.sh ~/Solar/solar

Frontera