Skip to content

matthewwong525/WongStack / .agents/plugins/loop/skills/ship

FileKindSize
SKILL.mdskill md5.8 KB
scripts/merge.shexecutablescript7.4 KB
scripts/number-release.mjsexecutablescript4.6 KB
scripts/ship.mjsscript32.8 KB

scripts/number-release.mjs

View on GitHub
#!/usr/bin/env node
// Number this branch's release from the default branch's version, right before /ship's checkpoint: its one
// `## Next (level) — <Title>` entry becomes `## X.Y.Z — <Title>`, and VERSION is bumped by that level.
import { execFileSync } from 'node:child_process';
import { existsSync, readFileSync, writeFileSync } from 'node:fs';
import { join } from 'node:path';
import { parseArgs } from 'node:util';

const USAGE = `usage: number-release.mjs [--base <ref>]
  Numbers this branch's CHANGELOG.md entry and VERSION from origin/<default branch>, or from --base (a local route).
  Prints release=none, release=X.Y.Z from=A.B.C, or behind=yes (exit 3).`;

const NEXT = /^## Next\b/;
const NEXT_PARTS = /^## Next \((patch|minor|major)\) — (.+)$/;
const NUMBERED = /^## (\d+)\.(\d+)\.(\d+) — (.+)$/;
const LEVELS = ['major', 'minor', 'patch'];

let values;
try {
  ({ values } = parseArgs({ options: { help: { type: 'boolean' }, base: { type: 'string' } }, strict: true }));
  if (values.help) { console.log(USAGE); process.exit(0); }
} catch (error) {
  console.error(`${error.message}\n${USAGE}`);
  process.exit(2);
}

const fail = message => { console.error(`number-release: ${message}`); process.exit(1); };
const gitOr = (fallback, ...args) => {
  try { return execFileSync('git', args, { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }).trim(); } catch { return fallback; }
};

const root = gitOr('', 'rev-parse', '--show-toplevel') || fail('not inside a git repository');
const changelogPath = join(root, 'CHANGELOG.md');
if (!existsSync(changelogPath)) { console.log('release=none'); process.exit(0); }

const base = values.base ?? gitOr('origin/main', 'symbolic-ref', '--quiet', '--short', 'refs/remotes/origin/HEAD');
if (!gitOr('', 'rev-parse', '--verify', '--quiet', `${base}^{commit}`)) fail(`no ${base}; fetch the default branch first`);

const lines = readFileSync(changelogPath, 'utf8').split('\n');
const baseHeadings = new Set(gitOr('', 'show', `${base}:CHANGELOG.md`).split('\n'));
const isEntry = line => NEXT.test(line) || NUMBERED.test(line);
const own = lines.flatMap((line, i) => (isEntry(line) && !baseHeadings.has(line) ? [i] : []));

if (own.length === 0) { console.log('release=none'); process.exit(0); }
if (own.length > 1) fail(`one entry per release, found ${own.length}: ${own.map(i => lines[i]).join(' | ')}`);
if (gitOr('no', 'merge-base', '--is-ancestor', base, 'HEAD') === 'no') { console.log('behind=yes'); process.exit(3); }

const at = own[0];
const heading = lines[at];
const semver = text => text.split('.').map(Number);
const compare = (a, b) => a[0] - b[0] || a[1] - b[1] || a[2] - b[2];

// The level: stated in a `## Next` heading, or the gap from a numbered entry to the newest lower version.
let level;
let title;
if (NEXT.test(heading)) {
  const parts = heading.match(NEXT_PARTS);
  if (!parts) fail(`unknown level in "${heading}"; write ## Next (patch|minor|major) — <Title>`);
  [, level, title] = parts;
} else {
  const [, major, minor, patch, name] = heading.match(NUMBERED);
  const version = [major, minor, patch].map(Number);
  const lower = lines
    .filter((line, i) => i !== at && NUMBERED.test(line))
    .map(line => line.match(NUMBERED).slice(1, 4).map(Number))
    .filter(other => compare(other, version) < 0)
    .sort(compare)
    .at(-1);
  if (!lower) fail(`no version below "${heading}" to read its level from; write ## Next (patch|minor|major) — ${name}`);
  level = LEVELS[version.findIndex((part, i) => part !== lower[i])];
  title = name;
}

const from = gitOr('', 'show', `${base}:VERSION`);
if (!/^\d+\.\d+\.\d+$/.test(from)) fail(`${base} has no VERSION to number from`);
const next = semver(from);
const bump = LEVELS.indexOf(level);
next[bump] += 1;
for (let i = bump + 1; i < 3; i++) next[i] = 0;
const release = next.join('.');

// Cut the entry out, renamed, and put it back above the newest entry.
const end = lines.findIndex((line, i) => i > at && line.startsWith('## '));
const block = lines.slice(at, end === -1 ? lines.length : end);
block[0] = `## ${release} — ${title}`;
const rest = [...lines.slice(0, at), ...(end === -1 ? [] : lines.slice(end))];
const top = rest.findIndex(isEntry);
rest.splice(top === -1 ? rest.length : top, 0, ...block);

// One blank line before every `## ` heading, and one newline at the end.
const out = [];
for (const line of rest) {
  if (line.startsWith('## ') && out.length) {
    while (out.at(-1) === '') out.pop();
    out.push('');
  }
  out.push(line);
}
while (out.at(-1) === '') out.pop();

writeFileSync(changelogPath, `${out.join('\n')}\n`);
writeFileSync(join(root, 'VERSION'), `${release}\n`);
console.log(`release=${release} from=${from}`);
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall