fleet-updating-lockstep

Automates per-row lockstep.json drift resolution, bumping, validation, and commit via pnpm and git.

125|42|Updated May 19, 2025
One-click install
npx skills add https://github.com/SocketDev/socket-mcp --skill fleet-updating-lockstep
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fleet-updating-lockstep
Source: https://github.com/SocketDev/socket-mcp/tree/main/.agents/skills/fleet-updating-lockstep
Command: npx skills add https://github.com/SocketDev/socket-mcp --skill fleet-updating-lockstep

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the detection and resolution of drift in lockstep.json across repositories that carry the lockstep manifest. It reads drift data with pnpm run lockstep --json, then pipelines each mechanical version-pin row through a per-row workflow that resolves, bumps, validates, and commits independently. It surfaces advisory results for file-fork, feature-parity, spec-conformance, and lang-parity to guide human review and approvals.

Core Features & Use Cases

  • Automates per-row drift resolution: fetches upstream tags, selects stable targets, and performs atomic commits for each version-pin row.
  • Surface advisory results: reports non-version-pin drift (file-fork, feature-parity, spec-conformance, lang-parity) for human review.
  • Flexible usage: usable as part of the umbrella updating workflow or standalone to sync a specific repository's lockstep.json.

Quick Start

Run the fleet-updating-lockstep skill on a repository with lockstep.json to start automatic drift resolution and per-row bumps.

Frequently Asked Questions about fleet-updating-lockstep

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate lockstep.json drift resolution across multiple git submodules?

Automating lockstep.json drift resolution across submodules involves fetching upstream tags, selecting stable targets, and performing atomic commits for each version-pin row. This skill pipelines each row through a workflow to resolve, bump, validate, and commit changes independently.

What is atomic version bumping for pnpm fleet workflows?

Atomic version bumping for pnpm fleets updates lockstep manifests consistently across multi-repo environments. It applies per-row workflows using pnpm and git tooling to ensure consistent submodule annotations and safe, synchronized updates.

Can I use this lockstep workflow to handle non-version-pin drift like feature parity or file forks?

You cannot fully automate non-version-pin drift like file-fork, feature-parity, spec-conformance, or lang-parity with this workflow. It surfaces advisory results for these categories to guide human review and requires manual approval for non-automated actions.

Does the lockstep bumping workflow require specific dependencies to run?

The lockstep bumping workflow requires pnpm and git tooling to operate across multi-repo fleets. You need a repository containing a lockstep.json manifest and the ability to run pnpm run lockstep --json to fetch the initial drift data.

What is the best way to sync lockstep.json in a standalone repository?

The best way to sync lockstep.json in a standalone repository is running the fleet-updating-lockstep skill directly on the repo. It executes the per-row workflow to resolve, bump, validate, and commit version-pin changes independently without needing the umbrella workflow.