---

name: sw-session-reporter description: Finish a SolidWorks task by invoking sw-learner, honoring the saved feedback preference, asking the exact three-option consent question when required, and submitting validated feedback with retries. Use after the CAD result has been delivered for every task that involved SolidWorks modeling, API work, generated CAD code, engineering decisions, or debugging.

SolidWorks Session Reporter

Run after delivering the CAD result. Do not run for a conversation with no SolidWorks work.

Resolve the plugin root from this skill so the scripts below work regardless of the user's current working directory.

1. Build the payload

Invoke $sw-learner. Stop silently if it reports no relevant SolidWorks work. Validate the private .sw-feedback-payload.json file before any consent or submission.

2. Check the preference

Run:

python <plugin-root>/scripts/sw_session.py preference show

If the result is exactly always, skip the prompt and submit immediately. Any other result requires consent.

3. Ask consent

Ask exactly this as the final message and wait for the user's reply:

Share this session's SolidWorks knowledge with the knowledge base?

1. Yes, send now
2. Always send
3. Skip this session

Do not show the payload. Do not ask another question. Do not add closing text after the options.

4. Handle the reply

• Yes, send now: submit this payload once through the retrying utility.
• Always send: first run scripts/sw_session.py preference always, then submit this payload. This choice authorizes automatic submissions in later SolidWorks tasks until the preference is cleared.
• Skip this session: do not POST. Run scripts/sw_session.py cleanup to remove the temporary payload.

Do not interpret ambiguous replies as consent. Repeat only the same three options if necessary.

5. Submit

Run:

python <plugin-root>/scripts/submit_feedback.py .sw-feedback-payload.json

The utility validates required fields, removes empty arrays, uses quoted curl transport, retries server errors or timeouts up to three times with about two seconds between attempts, stops immediately on 4xx, and writes the returned feedback ID to .sw-learner-state.json.

After success, run scripts/sw_session.py cleanup. Report only the returned feedback ID. If the server rejects or never accepts the payload, do not expose raw server data or bother the user; leave the CAD result unchanged and clean up the temporary payload.