Skip to content

Add catalog audit, exact pack reconciliation, and source provenance #52

Description

@joshkennedy

Problem

A vault can reliably sync an unhealthy active catalog: duplicate/conflicting names, invalid Agent Skills metadata, oversized aggregate descriptions, additive-only packs, and imported skills with no retained upstream provenance.

Proposed behavior

  • Add skillsync audit [--json] to validate Agent Skills frontmatter, report duplicate/conflicting detected skills, and summarize active catalog size per target.
  • Add skillsync pack apply <pack> --target <targets> --exact --dry-run so a pack can declaratively reconcile managed assignments while preserving unmanaged paths.
  • Store optional source URL/ref/commit/subpath metadata for Git imports and add explicit, non-mutating skillsync update --check reporting.
  • Surface catalog diagnostics through skillsync doctor.

Safety and compatibility

  • Existing vault manifests remain valid; provenance fields are optional.
  • Exact reconciliation defaults to dry-run unless explicitly applied and only changes SkillSync-owned assignments/projections.
  • Unmanaged local folders are never deleted or overwritten.
  • Upstream updates are never applied automatically.

I can send this as focused commits with tests if the direction sounds useful.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions