@adia-ai/adia-ui-forge 0.1.2

package/skills/adia-ui-release/scripts/tag-lockstep.mjs

@@ -0,0 +1,110 @@
+#!/usr/bin/env node
+// tag-lockstep.mjs — create 10 lockstep tags (umbrella vX.Y.Z + 9
+// per-package <pkg>-vX.Y.Z) at HEAD or at a specified SHA.
+//
+// Usage:
+//   node tag-lockstep.mjs --version 0.6.22
+//   node tag-lockstep.mjs --version 0.6.22 --at <sha>
+//   node tag-lockstep.mjs --version 0.6.22 --delete     # delete existing tags
+//   node tag-lockstep.mjs --version 0.6.22 --dry        # print commands without running
+//
+// Phase 2 of the adia-ui-release skill. Mechanizes the tag loop used
+// every cycle.
+
+import { execSync } from 'node:child_process';
+import process from 'node:process';
+import { assertMonorepoRoot } from './assert-monorepo-root.mjs';
+
+const PER_PACKAGE_NAMES = [
+  'web-components',
+  'web-modules',
+  'llm',
+  'a2ui-runtime',
+  'a2ui-compose',
+  'a2ui-corpus',
+  'a2ui-mcp',
+  'a2ui-retrieval',
+  'a2ui-validator',
+];
+
+function parseArgs(argv) {
+  const args = { version: null, at: null, deleteMode: false, dry: false, repo: process.cwd() };
+  for (let i = 0; i < argv.length; i++) {
+    const k = argv[i];
+    if (k === '--version') args.version = argv[++i];
+    else if (k === '--at') args.at = argv[++i];
+    else if (k === '--delete') args.deleteMode = true;
+    else if (k === '--dry') args.dry = true;
+    else if (k === '--repo') args.repo = argv[++i];
+    else if (k === '-h' || k === '--help') {
+      console.log('Usage: node tag-lockstep.mjs --version X.Y.Z [--at <sha>] [--delete] [--dry] [--repo <path>]');
+      process.exit(0);
+    }
+  }
+  if (!args.version) {
+    console.error('error: --version is required');
+    process.exit(2);
+  }
+  return args;
+}
+
+function buildTagList(version) {
+  return ['v' + version, ...PER_PACKAGE_NAMES.map((p) => `${p}-v${version}`)];
+}
+
+function run(cmd, repo, dry) {
+  if (dry) {
+    console.log(`  [dry] ${cmd}`);
+    return '';
+  }
+  return execSync(cmd, { cwd: repo, encoding: 'utf8' });
+}
+
+function main() {
+  const args = parseArgs(process.argv.slice(2));
+  // Fail-fast guard: refuse to run git against a non-monorepo directory.
+  assertMonorepoRoot(args.repo);
+  const tags = buildTagList(args.version);
+
+  if (args.deleteMode) {
+    console.log(`Deleting 10 tags for v${args.version}:`);
+    for (const t of tags) {
+      try {
+        run(`git tag -d ${t}`, args.repo, args.dry);
+        console.log(`  ${args.dry ? '[dry] ' : ''}deleted ${t}`);
+      } catch (e) {
+        console.error(`  WARN ${t} did not exist (no-op)`);
+      }
+    }
+    console.log(`\n[tag-lockstep] ${tags.length} tags deleted ${args.dry ? '(dry)' : ''}`);
+    return;
+  }
+
+  const targetSha = args.at || run('git rev-parse HEAD', args.repo, false).trim();
+  console.log(`Creating 10 tags for v${args.version} at ${targetSha.slice(0, 9)}:`);
+  for (const t of tags) {
+    try {
+      run(`git tag ${t} ${args.at || ''}`.trim(), args.repo, args.dry);
+      console.log(`  ${args.dry ? '[dry] ' : ''}created ${t}`);
+    } catch (e) {
+      console.error(`  ERROR ${t}: ${e.message}`);
+      process.exit(3);
+    }
+  }
+  console.log(`\n[tag-lockstep] ${tags.length} tags created at ${targetSha.slice(0, 9)} ${args.dry ? '(dry)' : ''}`);
+
+  if (!args.dry) {
+    console.log(`\n[next] run F-N1:`);
+    console.log(`  node scripts/release/check-release.mjs --all-pending`);
+    console.log(`\n[next] when F-N1 is 9/9 clean, push:`);
+    console.log(`  git push origin main`);
+    console.log(`  git push origin ${tags.join(' \\\n    ')}`);
+  }
+}
+
+try {
+  main();
+} catch (e) {
+  console.error(`error: ${e.message}`);
+  process.exit(1);
+}

package/skills/adia-ui-release/skill.json

@@ -0,0 +1,75 @@
+{
+  "name": "adia-ui-release",
+  "version": "0.1.0",
+  "description": "Release engineer for an @adia-ai-style lockstep monorepo. Cuts, tags, publishes, deploys, authors release notes + audit-history ledgers — AND authors the MIGRATION GUIDE when a cut breaks an API (the producer side of migrations, folded in from the former adia-ui-migration skill). Use whenever the user wants to CUT A RELEASE / SHIP A VERSION / PUBLISH PACKAGES / BATCH-PUSH ACCUMULATED RELEASES / RECOVER FROM A VERSION-SKIP / WRITE RELEASE NOTES / PROMOTE [UNRELEASED] CHANGELOG / AUTHOR A MIGRATION GUIDE FOR A BREAKING CUT. Triggers on \"cut vX.Y.Z\", \"initiate a release\", \"publish the npm packages\", \"tag this commit and push the release\", \"batch push\", \"F-N1 warned\", \"GitHub release notes\", \"promote unreleased\", \"version skip recovery\", \"verify pre-flight gates\", \"the cycle just shipped — write up what happened\", \"author a migration guide / write the migration recipe for this breaking change\". VERIFICATION is load-bearing: every cut verifies against reality (npm registry + production endpoint + GH release), not self-checks. Carries the portable release DISCIPLINE with the @adia-ai monorepo's 9-package lockstep + demo-site deploy as the clearly-labeled worked example. Does NOT trigger for: the CONSUMER side of migration (sweeping a downstream app — the separate consumer/app-author plugin), long-running VM ops (provision/restart/key rotation), authoring new code, or generation-pipeline work.",
+  "status": "stable",
+  "authors": [
+    "kim.granlund"
+  ],
+  "tags": [
+    "adia-ui",
+    "release",
+    "publish",
+    "lockstep",
+    "release-notes",
+    "migration-guide",
+    "producer-side"
+  ],
+  "environment": {
+    "portable": false,
+    "requires": [
+      "an @adia-ai-style lockstep monorepo: @adia-ai/* packages under packages/* that version + publish together, with per-package CHANGELOG.md, a release trip-wire, and a publish-workflow per package"
+    ],
+    "rationale": "The skill mutates a real monorepo (commits, tags, lockfiles) and triggers real package publishes; the gate roster, deploy target, and ledger paths are substrate-bound. The DISCIPLINE generalizes to any @adia-ai-style lockstep monorepo, but the worked example (9-package lockstep, ui-kit.exe.xyz deploy) is the @adia-ai monorepo specifically."
+  },
+  "files": [
+    "SKILL.md",
+    "skill.json",
+    "CHANGELOG.md",
+    "references/cycle-happy-path.md",
+    "references/multi-agent-baseline.md",
+    "references/gates-catalog.md",
+    "references/recovery-paths.md",
+    "references/changelog-discipline.md",
+    "references/notes-authoring.md",
+    "references/rollup-notes.md",
+    "references/exe-deploy.md",
+    "references/ledger-discipline.md",
+    "references/migration-guide-authoring.md",
+    "references/teach-protocol.md",
+    "scripts/bump.mjs",
+    "scripts/promote-unreleased.mjs",
+    "scripts/insert-stub.mjs",
+    "scripts/tag-lockstep.mjs",
+    "scripts/dispatch-publish.mjs",
+    "scripts/make-ledger.mjs",
+    "scripts/release-pack.mjs",
+    "scripts/audit-gate-roster.mjs",
+    "assets/templates/stub-changelog.template.md",
+    "assets/case-studies/2026-05-20-version-skip-correction-v0.6.12.md",
+    "assets/case-studies/2026-05-20-batch-push-v0.6.14-v0.6.15.md",
+    "assets/case-studies/2026-05-20-corpus-drift-remediation-v0.6.15.md",
+    "assets/case-studies/2026-05-21-author-from-scratch-v0.6.18.md",
+    "assets/case-studies/2026-05-21-fn1-enrichment-pass-v0.6.19.md",
+    "assets/case-studies/2026-05-21-stale-test-detection-v0.6.20.md",
+    "assets/case-studies/2026-05-21-feedback37-retraction-v0.6.21.md",
+    "assets/case-studies/2026-05-23-freshness-gate-recovery-v0.6.32.md",
+    "assets/case-studies/2026-05-26-catalog-drift-recurring-v0.6.40.md",
+    "evals/evals.json"
+  ],
+  "peer_skills": [
+    "adia-ui-authoring",
+    "adia-ui-a2ui",
+    "adia-ui-dogfood",
+    "ops-postmortem"
+  ],
+  "absorbs": [
+    "adia-ui-migration — DONE: producer side folded in as references/migration-guide-authoring.md + mode 11 (§MigrationGuideAuthoring). The consumer side stays in the separate consumer/app-author plugin.",
+    "release-publish / release-notes / verification-sweep — DONE in the source skill: consolidated into modes 1/3/4 (cut), 5/9 (notes), 6 (verify)."
+  ],
+  "references": [
+    "adia-ui-a2ui — corpus-freshness checks route there for remediation (verify:corpus / embeddings drift)",
+    "adia-ui-dogfood — the static-HTML probes (native-primitive-leak, shell-composition) whose findings fold into release notes",
+    "ops-postmortem — incident genre during post-publish recovery (mode 7)"
+  ]
+}