Script Inventory Operator

Output Artifacts

• Script inventory report: every script with path, size, last-modified date, and inferred owner
• Cluster and duplication summary: scripts with identical or near-identical logic grouped by cluster
• Candidate consolidation list: scripts recommended for extraction to scripts/lib/ shared, with risk level (LOW/MEDIUM/HIGH)

Workflow

1. Glob all script files within the scope paths, excluding node_modules/, vendor/, and generated artifact directories.
2. For each script, record: path, size, last-modified date, and whether it is directly referenced in a plugin.json, agent, hook, or command file.
3. Run ownership inference: grep agent and hook files for script invocations; flag scripts with zero invocation references as candidates for removal review.
4. Detect duplication clusters: compare script content fingerprints to identify scripts with >80% overlap across plugins.
5. Generate the inventory report and consolidation candidate list with risk levels — HIGH risk if the script is invoked from more than 3 call sites.
6. Present the candidate list for human review; do not delete or move any scripts without explicit approval.

Safety Checks

• Exclude generated and vendor directories from all scans — never inventory auto-generated outputs
• Do not delete or move any script automatically — the inventory is advisory only
• Mark confidence level for inferred ownership: HIGH (direct reference found), MEDIUM (pattern match), LOW (no reference found)