mellea-skills-compiler: Command for Claude Code

Melleafy Step 2.5: Dependency Audit and Elicitation

Version: 4.2.0 | Prereq: inventory.json, element_mapping.json | Produces: dependency_plan.json, mellea_api_ref.json, mellea_doc_index.json

Schema: Output intermediate/dependency_plan.json MUST conform to .claude/schemas/dependency_plan.schema.json.

Step 2.5 is entirely deterministic — no LLM invocations. It reads element_mapping.json (where every TOOL_TEMPLATE entry has final_target_file: "pending_step_2.5"), assigns a disposition to every external dependency, elicits user input when the generation mode requires it, commits the plan, and amends element_mapping.json accordingly.

This step must not be skipped. Every external dependency must have an explicit disposition before Step 3 can emit skeletons.

---

Four sub-steps

2.5a: Dependency audit

Collect every element from inventory.json whose category is C1–C9. For each, look up the default disposition from the table below. Group by category. Also apply any aggregation hints from Step 1b's cross-element pass.

Aggregation during audit: when two elements have aggregation_hint pointing at each other, merge them into one dependency entry with a combined source_elements list and the disposition that covers both.

Output: intermediate/dependency_audit.json — one entry per dependency with entry_id, category, default_disposition, source_elements, and subtype (for C6: http, graphql, mcp, sdk, abstract).

2.5b: Elicitation (ask and config modes only)

If generation mode is auto or config:<path>: skip to 2.5c.

If generation mode is ask: display a terminal UI (using rich) for each dependency in the audit. Show: category, source elements, default disposition, available alternatives. Allow the user to accept the default or override.

If generation mode is config:<path>: read the JSON config file. The config format mirrors dependency_plan.json:plan[] — a list of {entry_id, disposition, override_rationale} objects. Apply overrides to the audit results.