@adia-ai/adia-ui-forge 0.1.2 → 0.8.0

package/skills/adia-ui-release/scripts/make-ledger.mjs

@@ -1,179 +0,0 @@
-#!/usr/bin/env node
-// make-ledger.mjs — author .brain/audit-history/YYYY-MM-DD-release-vX.Y.Z.json
-// from git state + cycle-specific notes.
-//
-// Reads:
-//   - the current git HEAD (release_commit + tag_commit if same)
-//   - the 10 tags for the given version (collected from `git tag`)
-//   - the recent gate-run output (passed via --verification-file or
-//     --verification-json or computed best-effort from `npm run check:lockstep`)
-//
-// Writes:
-//   - .brain/audit-history/YYYY-MM-DD-release-vX.Y.Z.json
-//
-// Usage:
-//   node make-ledger.mjs --version 0.6.22 --date 2026-05-22 \
-//     --summary "9-package lockstep PATCH cut. Substantive: ..." \
-//     --kind release-cut
-//   node make-ledger.mjs --version 0.6.22 --date 2026-05-22 --kind batch-push \
-//     --versions 0.6.21,0.6.22 --summary "..."
-//
-// Optional flags:
-//   --tag-commit <sha>       (default: HEAD)
-//   --release-commit <sha>   (default: tag-commit)
-//   --scope <key=value,...>  shorthand for the .scope.{key} block
-//   --note "<text>"          append to .notes array; repeatable
-//   --interactive            prompt for missing required fields
-//   --dry                    print to stdout without writing
-//
-// Phase 3 of the adia-ui-release skill. Mechanizes the per-cycle ledger
-// authoring used at Step 11 of cycle-happy-path.
-
-import fs from 'node:fs';
-import path from 'node:path';
-import { execSync } from 'node:child_process';
-import process from 'node:process';
-import { assertMonorepoRoot } from './assert-monorepo-root.mjs';
-
-function parseArgs(argv) {
-  const args = {
-    version: null,
-    date: null,
-    kind: 'release-cut',
-    summary: null,
-    versions: null,
-    tagCommit: null,
-    releaseCommit: null,
-    scope: {},
-    notes: [],
-    dry: false,
-    repo: process.cwd(),
-    repoSlug: '<org>/<repo>',
-  };
-  for (let i = 0; i < argv.length; i++) {
-    const k = argv[i];
-    if (k === '--version') args.version = argv[++i];
-    else if (k === '--date') args.date = argv[++i];
-    else if (k === '--kind') args.kind = argv[++i];
-    else if (k === '--summary') args.summary = argv[++i];
-    else if (k === '--versions') args.versions = argv[++i].split(',');
-    else if (k === '--tag-commit') args.tagCommit = argv[++i];
-    else if (k === '--release-commit') args.releaseCommit = argv[++i];
-    else if (k === '--scope') {
-      const pairs = argv[++i].split(',');
-      for (const p of pairs) {
-        const [key, ...val] = p.split('=');
-        args.scope[key] = val.join('=');
-      }
-    } else if (k === '--note') args.notes.push(argv[++i]);
-    else if (k === '--dry') args.dry = true;
-    else if (k === '--repo') args.repo = argv[++i];
-    else if (k === '--repo-slug') args.repoSlug = argv[++i];
-    else if (k === '-h' || k === '--help') {
-      console.log('Usage: node make-ledger.mjs --version X.Y.Z --date YYYY-MM-DD --summary "..." [--kind release-cut|batch-push|p1-hotfix] [--repo-slug <org>/<repo>] [--tag-commit <sha>] [--release-commit <sha>] [--scope key=val,...] [--note "..."] [--dry]');
-      process.exit(0);
-    }
-  }
-  if (!args.version || !args.date || !args.summary) {
-    console.error('error: --version, --date, --summary all required');
-    process.exit(2);
-  }
-  // Fail-fast guard: refuse to run git against a non-monorepo directory.
-  assertMonorepoRoot(args.repo);
-  if (!args.tagCommit) {
-    args.tagCommit = execSync(`git -C "${args.repo}" rev-parse HEAD`).toString().trim();
-  }
-  if (!args.releaseCommit) args.releaseCommit = args.tagCommit;
-  return args;
-}
-
-function collectTags(repo, version) {
-  const out = execSync(`git -C "${repo}" tag --list 'v${version}' '*-v${version}'`).toString().trim();
-  return out.split('\n').filter(Boolean).sort();
-}
-
-function buildLedger(args) {
-  const isBatch = args.kind === 'batch-push';
-  const allTags = isBatch && args.versions
-    ? args.versions.flatMap((v) => collectTags(args.repo, v))
-    : collectTags(args.repo, args.version);
-
-  const ledger = {
-    kind: args.kind,
-    audit_id: `${args.date}-${args.kind}-v${args.version}`,
-    repo: args.repoSlug,
-    released_at: args.date,
-    version: args.version,
-    release_type: 'PATCH',
-    summary: args.summary,
-  };
-
-  if (Object.keys(args.scope).length > 0) ledger.scope = args.scope;
-  if (isBatch && args.versions) {
-    ledger.versions = args.versions;
-    ledger.tag_commits = {};
-    for (const v of args.versions) {
-      const tag = `v${v}`;
-      try {
-        ledger.tag_commits[tag] = execSync(`git -C "${args.repo}" rev-parse ${tag}`).toString().trim();
-      } catch {
-        ledger.tag_commits[tag] = '<missing — tag not found>';
-      }
-    }
-  } else {
-    ledger.release_commit = args.releaseCommit;
-    ledger.tag_commit = args.tagCommit;
-  }
-
-  ledger.tags = allTags;
-  ledger.verification = {
-    note: 'TODO: paste gate-by-gate summary here. See ledger-discipline.md § canonical schema.',
-  };
-  ledger.publish_workflows = {
-    dispatched: '9/9 via gh workflow run --ref <pkg>-vX.Y.Z',
-    conclusions: '9/9 success',
-  };
-  ledger.notes = args.notes.length > 0 ? args.notes : ['TODO: at least one note per cycle.'];
-
-  return ledger;
-}
-
-function writeOrPrint(ledger, args) {
-  const filename = `${ledger.audit_id}.json`;
-  const target = path.join(args.repo, '.brain', 'audit-history', filename);
-  const content = JSON.stringify(ledger, null, 2) + '\n';
-
-  if (args.dry) {
-    console.log(`[dry] would write to: ${target}`);
-    console.log('---');
-    console.log(content);
-    return;
-  }
-
-  fs.mkdirSync(path.dirname(target), { recursive: true });
-  if (fs.existsSync(target)) {
-    console.error(`error: ${target} already exists. Use --dry to preview or remove it manually.`);
-    process.exit(1);
-  }
-  fs.writeFileSync(target, content);
-  console.log(`[make-ledger] wrote ${target}`);
-  console.log(`\n[next] verify the ledger:`);
-  console.log(`  cat ${target} | jq .`);
-  console.log(`\n[next] commit + push:`);
-  console.log(`  git add ${target}`);
-  console.log(`  git commit -m "chore(audit-history): v${ledger.version} release ledger"`);
-  console.log(`  git push origin main`);
-}
-
-function main() {
-  const args = parseArgs(process.argv.slice(2));
-  const ledger = buildLedger(args);
-  writeOrPrint(ledger, args);
-}
-
-try {
-  main();
-} catch (e) {
-  console.error(`error: ${e.message}`);
-  process.exit(1);
-}

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

@@ -1,75 +0,0 @@
-{
-  "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)"
-  ]
-}