dimagi-internal/ace / skills/sweep-live-set
sweep-live-set
VerifiedList every identifier still referenced by visible ACE opps in Drive: the keep-list every orphan sweep diffs against.
sweep-live-set
Build the cross-opp live-set that every per-system /ace:sweep consumes. The live-set is the safety mechanism: anything in a target system NOT in the live-set is a candidate orphan. This skill produces it; per-system skills consume it.
Inputs
ACE_DRIVE_ROOT_FOLDER_IDfrom.env— the Drive folder that contains every opp directory.
Products
ACE/_sweep/<YYYYMMDD-HHMMSS>/live-set.yaml— the mergedLiveSet(schema:lib/sweep-types.ts:LiveSet).- Echoes the timestamped path so the caller (the sweep procedure doc) can pass it to per-system sweep skills.
Process
- Compute the timestamp for this sweep run: UTC
YYYYMMDD-HHMMSS. - Ensure
ACE/_sweep/<timestamp>/exists viadrive_create_folderunderACE_DRIVE_ROOT_FOLDER_ID. If_sweep/does not yet exist as the parent, create it first. - List opps: call
drive_list_folderonACE_DRIVE_ROOT_FOLDER_ID. For each child folder, treat it as an opp if it contains anopp.yamlat the root OR aninputs/subfolder (matcheslib/doctor-drive-layout.ts:isOppFolder). Skip_sweep/and any other reserved/leading-underscore folder. - For each opp:
a.
drive_read_fileon<opp>/opp.yaml(if present; else empty string). b.drive_list_folderon<opp>/runs/(if present; else empty list). c. For each run folder,drive_read_fileon<opp>/runs/<run-id>/run_state.yaml(skip if absent). d. CallextractOppFragment(oppSlug, oppYaml, runStateYamls)fromlib/sweep-live-set.tsto get a fragment. - Merge fragments: call
mergeFragments(fragments, generatedAtIso)to produce the finalLiveSet. - Serialize as YAML and
drive_create_filetoACE/_sweep/<timestamp>/live-set.yaml. - Echo the Drive path and folder id of the live-set file to the caller.
Implementation notes for agents
- Use
npx tsxto invoke a one-shot script that importslib/sweep-live-set.tsif you need to run the merge from the terminal; or call the functions directly via the in-process TypeScript boundary if your harness allows it. Prefer one-shot script to keep the agent-side logic to MCP calls. - The script lives at
scripts/sweep-live-set.tsif/when an agent needs to execute it directly. (Not in scope for this PR — agents read YAMLs via MCP and call the lib functions inline.) - If any opp folder is missing
opp.yaml, that's a legacy/incomplete opp — still parse its runs but use''for the opp.yaml input; the fragment will simply omitconnectProgramIds.
Failure modes
- No opps under
ACE/— produce an empty live-set; downstream sweeps will flag everything as an orphan candidate. That's intentional. - Malformed YAML in an opp's files —
extractOppFragmentsilently treats unparseable input as{}. Surface a warning in the agent's chat output for each opp where this happens, but don't abort.
Related skills
sweep-driveconsumes this skill's output.- Per-system sweep skills
sweep-connect,sweep-ocs,sweep-hq,sweep-labs(added in PRs 2-5) will also consume it.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |