ANS-1118: Add Semantic Optimization CLI commands

[jharris1679]

Summary

• add answerlayer optimize commands for starting, listing, inspecting, pausing, resuming, stopping, cloning, reviewing, and promoting Semantic Optimization Runs
• expose case selectors, all six semantic component types, proposal and search strategies, autonomy/review/promotion policies, phase-specific models, budgets, and objectives
• document the workflow and aliases

Verification

• npm test: 68 passed
• includes payload coverage for configurable run creation and explicit proposal approval

Companion change

• Core API and UI: https://github.com/AnswerLayer/answerlayer-core/pull/279

Linear: ANS-1118

[greptile-apps]

Greptile Summary

Adds Semantic Optimization CLI support across the complete run lifecycle.

• Introduces commands to create, list, inspect, control, clone, review, and promote optimization runs.
• Exposes case selectors, component types, policies, models, budgets, and objectives.
• Requires promotion callers to provide the frozen base hash for atomic compare-and-swap behavior.
• Validates the required evaluation and proposal models, including structured-data input.
• Documents the workflow and adds request-payload regression coverage.

Confidence Score: 5/5

The PR appears safe to merge; both previously reported contract defects are fully addressed and regression-tested.

Promotion now requires and sends expected_active_sha256, and structured model validation explicitly requires nonblank eval_execution and proposal values. No actionable new failure or repository-rule violation remains.

Important Files Changed

Filename	Overview
src/cli.js	Adds optimization routing, payload construction, lifecycle operations, explicit model validation, and base-hash-protected promotion.
test/cli.test.js	Covers configurable run creation, review decisions, promotion concurrency tokens, and rejection of empty structured model configuration.
README.md	Documents the optimization workflow and the frozen base hash required for promotion.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    Start[optimize start] --> Run[Optimization run]
    Run --> Inspect[ list / get ]
    Run --> Control[ pause / resume / stop ]
    Run --> Clone[clone]
    Run --> Review{Review decision}
    Review -->|approve| Approved[Approved proposal]
    Review -->|reject| Rejected[Rejected proposal]
    Approved --> Promote[promote with frozen base hash]
    Promote --> CAS{Active hash matches?}
    CAS -->|yes| Active[Promote semantic layer]
    CAS -->|no| Conflict[Reject stale promotion]

Loading

_{Reviews (2): Last reviewed commit: "fix: require safe optimization inputs" | Re-trigger Greptile}

[greptile-apps]

Promotion Omits Base Hash

promote is documented as using an optimistic base-hash check, but this branch sends only reason and provides no flag or request-data path for the expected hash. Callers therefore cannot supply the concurrency token needed to reject a promotion against a stale semantic layer, so promotion will either fail API validation or bypass the documented stale-base protection.

[jharris1679]

Resolved in f4f0304: optimize promote now requires a base-hash flag and sends it as expected_active_sha256. The README and a request-payload regression test cover the atomic compare-and-swap contract.

[greptile-apps]

Empty Models Pass Validation

Structured data shallowly replaces the default models object, while this check validates only the values that remain. Because Object.values({}).every(Boolean) is true, --data '{"models":{}}' bypasses the model requirement and sends a run with no phase models, leaving the API to reject or mishandle the request.

[jharris1679]

Resolved in f4f0304: validation now checks the explicit required keys eval_execution and proposal and rejects missing, non-string, or blank values. A regression test covers an empty structured models object.

[jharris1679]

@greptileai Please re-review the latest commit (f4f0304). Both findings from the previous review have been addressed and regression-tested.

[github-actions]

🎉 This PR is included in version 0.2.1 🎉

The release is available on:

• npm package (@latest dist-tag)
• GitHub release

Your semantic-release bot 📦🚀