npm - yadflow - Versions diffs - 1.4.0 → 2.0.1 - Mend

yadflow 1.4.0 → 2.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (77) hide show

package/bin/{sdlc.mjs → yad.mjs} RENAMED Viewed

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// `sdlc` — setup/maintenance + the PR-driven review gate + build helpers for the SDLC module.
+// `yad` — setup/maintenance + the PR-driven review gate + build helpers for the SDLC module.
 import { VERSION } from '../cli/manifest.mjs';
 import { c, log, closePrompts } from '../cli/lib.mjs';
 import { runSetup } from '../cli/setup.mjs';
@@ -10,28 +10,29 @@ import { runCommit } from '../cli/commit.mjs';
 import { runOpenPr } from '../cli/openpr.mjs';
 import { runRepo } from '../cli/repo.mjs';
-const HELP = `${c.bold('sdlc')} — setup, review-gate & build helpers for the SDLC Workflow module  ${c.dim('v' + VERSION)}
+const HELP = `${c.bold('yad')} — setup, review-gate & build helpers for the SDLC Workflow module  ${c.dim('v' + VERSION)}
 ${c.bold('Setup & maintenance')}
-  sdlc setup            Guided first-run setup (install module, connect & wire repos)
-  sdlc check            Report what is missing / drifted / stale (read-only)
-  sdlc check --fix      Reconcile: fill what is missing, update what changed
-  sdlc update           Apply drift only (alias for: check --fix --scope=changed)
+  yad setup            Guided first-run setup (install module, connect & wire repos)
+  yad check            Report what is missing / drifted / stale / legacy (read-only)
+  yad check --fix      Reconcile: fill what is missing, update what changed
+  yad update           Apply drift only (alias for: check --fix --scope=changed);
+                       also migrates pre-2.0 sdlc-* installs to the yad-* names
 ${c.bold('Review gate (front half)')}
-  sdlc gate open <epic> <artifact>      Open the review PR/MR; mark the step in_review
-  sdlc gate sync <epic> [artifact]      Pull PR state -> ledger; advance on approved+resolved+merged
-  sdlc gate comments <epic> [artifact]  Fetch unresolved review comments to address
-  sdlc gate status <epic>               Show each review step + approvals
-  sdlc gate ci [--branch <head>] [--pr <n>]
+  yad gate open <epic> <artifact>      Open the review PR/MR; mark the step in_review
+  yad gate sync <epic> [artifact]      Pull PR state -> ledger; advance on approved+resolved+merged
+  yad gate comments <epic> [artifact]  Fetch unresolved review comments to address
+  yad gate status <epic>               Show each review step + approvals
+  yad gate ci [--branch <head>] [--pr <n>]
                         CI entry (hub workflow): derive epic/artifact from the review branch,
                         sync, commit the ledger to the default branch (sweep all PRs if no --branch)
 ${c.bold('Build helpers')}
-  sdlc commit --type <t> -m <subject>   Commit by convention (trailers, atomic guard)
-  sdlc open-pr [--repo <name>]          Open a code-repo task PR/MR from the template
-  sdlc repo list                        Show connected repos (fresh / stale)
-  sdlc repo refresh [name]              Re-pack a stale repo (a human decision)
+  yad commit --type <t> -m <subject>   Commit by convention (trailers, atomic guard)
+  yad open-pr [--repo <name>]          Open a code-repo task PR/MR from the template
+  yad repo list                        Show connected repos (fresh / stale)
+  yad repo refresh [name]              Re-pack a stale repo (a human decision)
 ${c.bold('Options')}
   --dir <path>          Target project root (default: cwd)
@@ -99,7 +100,7 @@ async function main() {
       const [, action, epic, artifact] = o._;
       // `gate ci` takes no positionals — epic/artifact come from --branch (or a sweep of all PRs).
       if (action === 'ci') { await gateCi(o.dir, { branch: o.branch, pr: o.pr, push: !o.noPush, today }); break; }
-      if (!epic) { log(c.red('usage: sdlc gate <open|sync|comments|status|ci> <epic> [artifact]')); process.exitCode = 1; break; }
+      if (!epic) { log(c.red('usage: yad gate <open|sync|comments|status|ci> <epic> [artifact]')); process.exitCode = 1; break; }
       // The epic id becomes a path segment under epics/ — reject anything but EP-<slug> outright.
       if (!isValidEpicId(epic)) { log(c.red(`invalid epic id: ${epic} (expected EP-<slug>, [a-z0-9-] only)`)); process.exitCode = 1; break; }
       if (action === 'open') await gateOpen(o.dir, { epic, artifact, today });
@@ -129,7 +130,7 @@ async function main() {
 main()
   .catch((err) => {
-    log(c.red(`\nsdlc failed: ${err?.message || err}`));
+    log(c.red(`\nyad failed: ${err?.message || err}`));
     process.exitCode = 1;
   })
   .finally(closePrompts);

package/cli/commit.mjs CHANGED Viewed

@@ -1,4 +1,4 @@
-// `sdlc commit` — commit by the SDLC conventions (CONTRIBUTING.md / config.yaml build).
+// `yad commit` — commit by the SDLC conventions (CONTRIBUTING.md / config.yaml build).
 // Subject is Conventional Commits; trailers are emitted in the fixed order
 // Task -> Contract-Change -> Co-Authored-By. The human git author OWNS the commit; the AI is only a
 // co-author (flagged with --ai, or `none` for human-only). An atomic-commit guard keeps diffs small.
@@ -36,7 +36,7 @@ export function taskFromBranch(branch = '') {
 }
 export async function runCommit(root, opts = {}) {
-  log(c.bold('\nsdlc commit'));
+  log(c.bold('\nyad commit'));
   if (!exists(path.join(root, '.git'))) { fail('not a git repo'); process.exitCode = 1; return; }
   const staged = run('git', ['diff', '--cached', '--name-only'], { cwd: root }).stdout.split('\n').filter(Boolean);
@@ -70,7 +70,7 @@ export async function runCommit(root, opts = {}) {
   return { message };
 }
-// installed by sdlc-implement, but offer it here too for convenience.
+// installed by yad-implement, but offer it here too for convenience.
 export function ensureGitMessage(repoRoot, templateSrc) {
   const dest = path.join(repoRoot, '.gitmessage');
   if (exists(dest)) return false;

package/cli/epic-state.mjs CHANGED Viewed

@@ -55,7 +55,7 @@ export function upsertHubPr(hubPrs = [], rec) {
 }
 // SHA-256 of the contract surface block (architecture only). Mirrors
-// sdlc-author-architecture/references/contract-format.md (awk markers + sha256).
+// yad-architecture/references/contract-format.md (awk markers + sha256).
 // Line endings are normalized to LF so the same surface hashes identically across
 // platforms (a CRLF re-save must not revoke approvals). A BEGIN without an END is
 // malformed and yields null — never a silent hash of everything to end-of-file.
@@ -194,7 +194,7 @@ export function gatePredicate({
   };
 }
-// Advance the step in state.json once the predicate passes. Mirrors sdlc-review-gate Step 3:
+// Advance the step in state.json once the predicate passes. Mirrors yad-review-gate Step 3:
 // mark this review step done, unblock the next step, or set `ready-for-build` for the last one.
 export function advanceState(state, step) {
   const i = state.steps.findIndex((s) => s.id === step.id);

package/cli/gate.mjs CHANGED Viewed

@@ -1,4 +1,4 @@
-// `sdlc gate open|sync|comments|status` — the PR/MR-driven front-half review gate.
+// `yad gate open|sync|comments|status` — the PR/MR-driven front-half review gate.
 // The platform PR/MR is the review UI; this command syncs its state into the file ledger and, when
 // the gate passes (approvals satisfied + all comment threads resolved + PR merged), auto-advances the
 // step. The merge click is the human approval act, so front steps still never machine_advance.
@@ -159,7 +159,7 @@ export async function gateSync(root, { epic, artifact, today, reader = readPr }
   let { approvals, comments, hubPrs, state } = ledger;
   const targets = hubPrs.filter((p) => !artifact || p.artifact === artifact);
-  if (!targets.length) { warn(`no open review PR recorded for ${epic}${artifact ? ` / ${artifact}` : ''} (run \`sdlc gate open\` first)`); return { synced: 0 }; }
+  if (!targets.length) { warn(`no open review PR recorded for ${epic}${artifact ? ` / ${artifact}` : ''} (run \`yad gate open\` first)`); return { synced: 0 }; }
   let synced = 0;
   for (const pr of targets) {
@@ -212,7 +212,7 @@ export async function gateSync(root, { epic, artifact, today, reader = readPr }
   return { synced };
 }
-// `sdlc gate ci` — the self-sufficient entry point hub CI calls on platform events (review
+// `yad gate ci` — the self-sufficient entry point hub CI calls on platform events (review
 // submitted/dismissed, PR synchronize, PR merged) and on the GitLab schedule. Event mode derives
 // epic/artifact from the `review/EP-<slug>/<base>` head branch (so it works even when the author
 // never committed hub-prs.json); sweep mode (no --branch) re-syncs every open review PR. Either way
@@ -223,7 +223,7 @@ export async function gateCi(root, { branch, pr, today, push = true, reader = re
   if (!hub?.platform) { warn('no hub platform configured (.sdlc/hub.json) — nothing to sync'); return { synced: 0 }; }
   const git = (...args) => run('git', args, { cwd: root });
   // Push target: an explicit hub.default_branch wins; else the branch CI actually checked out (the
-  // workflow checks out the PR base / $CI_DEFAULT_BRANCH — hub.json from `sdlc setup` has no
+  // workflow checks out the PR base / $CI_DEFAULT_BRANCH — hub.json from `yad setup` has no
   // default_branch field, so the checkout is the truth); 'main' only as the last resort.
   const head = git('rev-parse', '--abbrev-ref', 'HEAD').stdout;
   const target = hub.default_branch || (head && head !== 'HEAD' ? head : 'main');
@@ -343,7 +343,7 @@ export async function gateCi(root, { branch, pr, today, push = true, reader = re
       if (!git('pull', '--rebase', 'origin', target).ok) git('rebase', '--abort'); // never leave a wedged rebase
     }
   }
-  fail(`could not push the ledger to origin/${target} — protected branch? allow the CI actor to push (see sdlc-hub-bridge references/bridge.md) or run \`sdlc gate sync\` locally`);
+  fail(`could not push the ledger to origin/${target} — protected branch? allow the CI actor to push (see yad-hub-bridge references/bridge.md) or run \`yad gate sync\` locally`);
   process.exitCode = 1;
   return { synced };
 }
@@ -354,7 +354,7 @@ export async function gateComments(root, { epic, artifact, today, reader = readP
   const epicDir = epicRoot(root, epic);
   const ledger = loadLedger(epicDir);
   const targets = (ledger.hubPrs || []).filter((p) => !artifact || p.artifact === artifact);
-  if (!targets.length) { warn('no review PR recorded — run `sdlc gate open` first'); return; }
+  if (!targets.length) { warn('no review PR recorded — run `yad gate open` first'); return; }
   for (const pr of targets) {
     const pull = reader(hub.platform, pr.number, { cwd: root });
     if (!pull.ok) { warn(`${pr.artifact}: ${pull.reason}`); continue; }
@@ -391,7 +391,7 @@ export async function gateOpen(root, { epic, artifact, today } = {}) {
   const epicDir = epicRoot(root, epic);
   const ledger = loadLedger(epicDir);
   if (!ledger.state) { fail(`no epic state at ${epicDir}`); process.exitCode = 1; return; }
-  if (!artifact) { fail('artifact is required: `sdlc gate open <epic> <artifact>`'); process.exitCode = 1; return; }
+  if (!artifact) { fail('artifact is required: `yad gate open <epic> <artifact>`'); process.exitCode = 1; return; }
   const step = findReviewStep(ledger.state, artifact);
   if (!step) { fail(`no review step for ${artifact}`); process.exitCode = 1; return; }
   const b = base(artifact);
@@ -416,7 +416,7 @@ export async function gateOpen(root, { epic, artifact, today } = {}) {
   ledger.hubPrs = upsertHubPr(ledger.hubPrs, { step: step.id, artifact, platform: hub.platform, number, url: r.url, branch, lastSyncedAt: null });
   writeJSON(ledger.files.hubPrs, ledger.hubPrs);
   ok(`opened ${r.url}`);
-  hand(`reviewers approve/comment there; then run \`sdlc gate sync ${epic} ${artifact}\``);
+  hand(`reviewers approve/comment there; then run \`yad gate sync ${epic} ${artifact}\``);
 }
 // ---- helpers ------------------------------------------------------------------------------------

package/cli/lib.mjs CHANGED Viewed

@@ -1,4 +1,4 @@
-// Shared helpers for the `sdlc` CLI. Node >=18 built-ins only — no dependencies.
+// Shared helpers for the `yad` CLI. Node >=18 built-ins only — no dependencies.
 import { createHash } from 'node:crypto';
 import { spawnSync } from 'node:child_process';
 import * as readline from 'node:readline/promises';

package/cli/manifest.mjs CHANGED Viewed

@@ -10,27 +10,68 @@ import { readFileSync } from 'node:fs';
 const { version } = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
 export const VERSION = version;
-// The 17 hand-authored sdlc-* skills (mirrors skills/sdlc/install.sh).
+// The 17 hand-authored yad-* skills (mirrors skills/sdlc/install.sh).
 export const SKILLS = [
-  'sdlc-author-analysis',
-  'sdlc-author-epic',
-  'sdlc-author-architecture',
-  'sdlc-author-ui',
-  'sdlc-author-stories',
-  'sdlc-connect-repos',
-  'sdlc-spec',
-  'sdlc-implement',
-  'sdlc-checks',
-  'sdlc-pr-template',
-  'sdlc-review-comments',
-  'sdlc-hub-bridge',
-  'sdlc-ship',
-  'sdlc-backfill',
-  'sdlc-run',
-  'sdlc-review-gate',
-  'sdlc-status',
+  'yad-analysis',
+  'yad-epic',
+  'yad-architecture',
+  'yad-ui',
+  'yad-stories',
+  'yad-connect-repos',
+  'yad-spec',
+  'yad-implement',
+  'yad-checks',
+  'yad-pr-template',
+  'yad-review-comments',
+  'yad-hub-bridge',
+  'yad-ship',
+  'yad-backfill',
+  'yad-run',
+  'yad-review-gate',
+  'yad-status',
 ];
+// Pre-2.0 skill names (the sdlc-* -> yad-* rename). `check`/`update` migrate any install
+// still carrying an old name: remove the old copy, install the renamed one.
+export const LEGACY_SKILLS = {
+  'yad-analysis': 'sdlc-author-analysis',
+  'yad-epic': 'sdlc-author-epic',
+  'yad-architecture': 'sdlc-author-architecture',
+  'yad-ui': 'sdlc-author-ui',
+  'yad-stories': 'sdlc-author-stories',
+  'yad-connect-repos': 'sdlc-connect-repos',
+  'yad-spec': 'sdlc-spec',
+  'yad-implement': 'sdlc-implement',
+  'yad-checks': 'sdlc-checks',
+  'yad-pr-template': 'sdlc-pr-template',
+  'yad-review-comments': 'sdlc-review-comments',
+  'yad-hub-bridge': 'sdlc-hub-bridge',
+  'yad-ship': 'sdlc-ship',
+  'yad-backfill': 'sdlc-backfill',
+  'yad-run': 'sdlc-run',
+  'yad-review-gate': 'sdlc-review-gate',
+  'yad-status': 'sdlc-status',
+};
+// Pre-2.0 wired-file dests replaced by renamed ones (old dest -> new dest, per platform).
+// An old file is removed ONLY when its first line carries the old ownership marker —
+// a same-named file the user authored themselves is never touched.
+export const LEGACY_MARKER = '# sdlc-managed';
+export const LEGACY_REPO_FILES = {
+  github: { '.github/workflows/sdlc-checks.yml': '.github/workflows/yad-checks.yml' },
+  gitlab: { '.gitlab/ci/sdlc-checks.yml': '.gitlab/ci/yad-checks.yml' },
+};
+export const LEGACY_HUB_FILES = {
+  github: {
+    '.github/workflows/sdlc-gate-sync.yml': '.github/workflows/yad-gate-sync.yml',
+    '.github/workflows/sdlc-verified-commits.yml': '.github/workflows/yad-verified-commits.yml',
+  },
+  gitlab: {
+    '.gitlab/ci/sdlc-gate-sync.yml': '.gitlab/ci/yad-gate-sync.yml',
+    '.gitlab/ci/sdlc-verified-commits.yml': '.gitlab/ci/yad-verified-commits.yml',
+  },
+};
 // IDE install targets (relative to the target project root).
 export const IDE_FOLDER_TARGETS = ['.claude', '.agents', '.zencoder']; // <ide>/skills/<skill>/ (folder copy)
 export const IDE_OPENCODE_DIR = '.opencode/commands'; // <skill>.md (flat SKILL.md copy)
@@ -45,7 +86,7 @@ export const PROJECT_FILES = {
   version: '.sdlc/cli-version.json',
 };
-// ---- `sdlc commit` conventions (mirror skills/sdlc/config.yaml `build`) ----
+// ---- `yad commit` conventions (mirror skills/sdlc/config.yaml `build`) ----
 // Conventional-commit types (config.yaml commit_subject_style).
 export const COMMIT_TYPES = ['feat', 'fix', 'docs', 'refactor', 'test', 'perf', 'build', 'ci', 'chore', 'revert'];
 // Per-commit AI co-author choices (config.yaml build.ai_coauthor.allowed). The human git author OWNS
@@ -77,21 +118,21 @@ export const epicFiles = (epicRoot) => ({
 // `common` always installs; the platform key installs by detected platform.
 export const REPO_WIRING = {
   common: [
-    { src: 'skills/sdlc-checks/templates/checks/spec-link.sh', dest: 'checks/spec-link.sh', exec: true },
-    { src: 'skills/sdlc-checks/templates/checks/contract-check.sh', dest: 'checks/contract-check.sh', exec: true },
-    { src: 'skills/sdlc-checks/templates/checks/build-test-lint.sh', dest: 'checks/build-test-lint.sh', exec: true },
-    { src: 'skills/sdlc-checks/templates/checks/verified-commits.sh', dest: 'checks/verified-commits.sh', exec: true },
-    { src: 'skills/sdlc-pr-template/templates/checks/risk-route.sh', dest: 'checks/risk-route.sh', exec: true },
+    { src: 'skills/yad-checks/templates/checks/spec-link.sh', dest: 'checks/spec-link.sh', exec: true },
+    { src: 'skills/yad-checks/templates/checks/contract-check.sh', dest: 'checks/contract-check.sh', exec: true },
+    { src: 'skills/yad-checks/templates/checks/build-test-lint.sh', dest: 'checks/build-test-lint.sh', exec: true },
+    { src: 'skills/yad-checks/templates/checks/verified-commits.sh', dest: 'checks/verified-commits.sh', exec: true },
+    { src: 'skills/yad-pr-template/templates/checks/risk-route.sh', dest: 'checks/risk-route.sh', exec: true },
   ],
   github: [
-    { src: 'skills/sdlc-checks/templates/github/sdlc-checks.yml', dest: '.github/workflows/sdlc-checks.yml' },
-    { src: 'skills/sdlc-pr-template/templates/github/pull_request_template.md', dest: '.github/pull_request_template.md' },
-    { src: 'skills/sdlc-review-comments/templates/github/REVIEW_COMMENTS.md', dest: '.github/REVIEW_COMMENTS.md' },
+    { src: 'skills/yad-checks/templates/github/yad-checks.yml', dest: '.github/workflows/yad-checks.yml' },
+    { src: 'skills/yad-pr-template/templates/github/pull_request_template.md', dest: '.github/pull_request_template.md' },
+    { src: 'skills/yad-review-comments/templates/github/REVIEW_COMMENTS.md', dest: '.github/REVIEW_COMMENTS.md' },
   ],
   gitlab: [
-    { src: 'skills/sdlc-checks/templates/gitlab/sdlc-checks.gitlab-ci.yml', dest: '.gitlab/ci/sdlc-checks.yml' },
-    { src: 'skills/sdlc-pr-template/templates/gitlab/merge_request_templates/Default.md', dest: '.gitlab/merge_request_templates/Default.md' },
-    { src: 'skills/sdlc-review-comments/templates/gitlab/REVIEW_COMMENTS.md', dest: '.gitlab/REVIEW_COMMENTS.md' },
+    { src: 'skills/yad-checks/templates/gitlab/yad-checks.gitlab-ci.yml', dest: '.gitlab/ci/yad-checks.yml' },
+    { src: 'skills/yad-pr-template/templates/gitlab/merge_request_templates/Default.md', dest: '.gitlab/merge_request_templates/Default.md' },
+    { src: 'skills/yad-review-comments/templates/gitlab/REVIEW_COMMENTS.md', dest: '.gitlab/REVIEW_COMMENTS.md' },
   ],
 };
@@ -102,18 +143,18 @@ export const wiringFor = (platform) => [
 // Hub wiring: CI installed on the PRODUCT HUB itself (dest is the project root — the hub IS the
 // root). Installed only when hub.json has a platform and the bridge is enabled. Carries the
-// event-driven gate sync (approvals/change requests/the merge trigger `sdlc gate ci`) and the
+// event-driven gate sync (approvals/change requests/the merge trigger `yad gate ci`) and the
 // verified-commits gate (no unverified commits from unverified users reach merge on the hub).
 export const HUB_WIRING = {
   common: [
-    { src: 'skills/sdlc-checks/templates/checks/verified-commits.sh', dest: 'checks/verified-commits.sh', exec: true },
+    { src: 'skills/yad-checks/templates/checks/verified-commits.sh', dest: 'checks/verified-commits.sh', exec: true },
   ],
   github: [
-    { src: 'skills/sdlc-hub-bridge/templates/github/sdlc-gate-sync.yml', dest: '.github/workflows/sdlc-gate-sync.yml' },
-    { src: 'skills/sdlc-checks/templates/github/sdlc-verified-commits.yml', dest: '.github/workflows/sdlc-verified-commits.yml' },
+    { src: 'skills/yad-hub-bridge/templates/github/yad-gate-sync.yml', dest: '.github/workflows/yad-gate-sync.yml' },
+    { src: 'skills/yad-checks/templates/github/yad-verified-commits.yml', dest: '.github/workflows/yad-verified-commits.yml' },
   ],
   gitlab: [
-    { src: 'skills/sdlc-hub-bridge/templates/gitlab/sdlc-gate-sync.gitlab-ci.yml', dest: '.gitlab/ci/sdlc-gate-sync.yml' },
-    { src: 'skills/sdlc-checks/templates/gitlab/sdlc-verified-commits.gitlab-ci.yml', dest: '.gitlab/ci/sdlc-verified-commits.yml' },
+    { src: 'skills/yad-hub-bridge/templates/gitlab/yad-gate-sync.gitlab-ci.yml', dest: '.gitlab/ci/yad-gate-sync.yml' },
+    { src: 'skills/yad-checks/templates/gitlab/yad-verified-commits.gitlab-ci.yml', dest: '.gitlab/ci/yad-verified-commits.yml' },
   ],
 };

package/cli/openpr.mjs CHANGED Viewed

@@ -1,6 +1,6 @@
-// `sdlc open-pr` — open a code-repo task PR/MR from the repo's platform template (build half).
+// `yad open-pr` — open a code-repo task PR/MR from the repo's platform template (build half).
 // Detects the platform, pushes the current branch, and creates the PR/MR with Summary / Story-task /
-// Impact & Risk prefilled. Distinct from `sdlc gate open`, which opens a front-half artifact-review PR
+// Impact & Risk prefilled. Distinct from `yad gate open`, which opens a front-half artifact-review PR
 // on the product hub.
 import path from 'node:path';
 import fs from 'node:fs';
@@ -33,7 +33,7 @@ function templateBody(repoRoot, platform, { task, risk, contract, domains }) {
 }
 export async function runOpenPr(root, opts = {}) {
-  log(c.bold('\nsdlc open-pr'));
+  log(c.bold('\nyad open-pr'));
   const { repoRoot, meta } = resolveRepo(root, opts);
   if (!exists(path.join(repoRoot, '.git'))) { fail(`not a git repo: ${repoRoot}`); process.exitCode = 1; return; }

package/cli/plan.mjs CHANGED Viewed

@@ -8,6 +8,7 @@ import {
 } from './lib.mjs';
 import {
   SKILLS, IDE_FOLDER_TARGETS, IDE_OPENCODE_DIR, MODULE_FILES, wiringFor, HUB_WIRING, PROJECT_FILES,
+  LEGACY_SKILLS, LEGACY_MARKER, LEGACY_REPO_FILES, LEGACY_HUB_FILES,
 } from './manifest.mjs';
 // status: 'ok' | 'missing' | 'outdated'
@@ -65,6 +66,92 @@ export function moduleActions(root, ideTargets = ideTargetsFor(root)) {
   return actions;
 }
+// Migration of a pre-2.0 install (the sdlc-* -> yad-* rename). Status is 'legacy' — unlike
+// 'missing' it is applied by `yad update` (--scope=changed) too, because the skill IS
+// installed, just under its old name. apply() removes the old copy AND installs the renamed
+// one, so a single update completes the rename even when the new copy would otherwise be
+// skipped as missing-scope.
+export function legacyModuleActions(root, ideTargets = ideTargetsFor(root)) {
+  const actions = [];
+  for (const ide of ideTargets) {
+    for (const [skill, old] of Object.entries(LEGACY_SKILLS)) {
+      if (ide === '.opencode') {
+        const oldDest = path.join(root, IDE_OPENCODE_DIR, `${old}.md`);
+        if (!exists(oldDest)) continue;
+        actions.push({
+          scope: ide,
+          item: `${old}.md → ${skill}.md`,
+          status: 'legacy',
+          apply: () => {
+            fs.rmSync(oldDest, { force: true });
+            copyFile(asset('skills', skill, 'SKILL.md'), path.join(root, IDE_OPENCODE_DIR, `${skill}.md`));
+          },
+        });
+      } else {
+        const oldDest = path.join(root, ide, 'skills', old);
+        if (!exists(oldDest)) continue;
+        actions.push({
+          scope: ide,
+          item: `${old} → ${skill}`,
+          status: 'legacy',
+          apply: () => {
+            fs.rmSync(oldDest, { recursive: true, force: true });
+            copyDir(asset('skills', skill), path.join(root, ide, 'skills', skill));
+          },
+        });
+      }
+    }
+  }
+  return actions;
+}
+// True only for a file WE installed pre-2.0: its first line carries the old ownership marker
+// (`# sdlc-managed:` / `# sdlc-managed-include:`). A same-named user-authored file is never ours.
+function ownedByOldInstall(p) {
+  try { return fs.readFileSync(p, 'utf8').startsWith(LEGACY_MARKER); } catch { return false; }
+}
+// old-dest -> new-dest migrations for wired CI files: remove the marker-owned old file and
+// install its renamed replacement from the current wiring. GitLab fragments are referenced by
+// path from the root `.gitlab-ci.yml` (`include: - local: ...`, written by the wire step), so
+// the migration must also rewrite that include — otherwise the pipeline hard-fails on a
+// `local file does not exist` the moment the old fragment is removed.
+function legacyFileActions(scope, baseRoot, fileMap, wiring) {
+  const actions = [];
+  for (const [oldDest, newDest] of Object.entries(fileMap || {})) {
+    const oldPath = path.join(baseRoot, oldDest);
+    if (!ownedByOldInstall(oldPath)) continue;
+    const w = wiring.find((x) => x.dest === newDest);
+    if (!w) continue; // never delete a working file without a replacement to install
+    actions.push({
+      scope,
+      item: `${oldDest} → ${newDest}`,
+      status: 'legacy',
+      apply: () => {
+        fs.rmSync(oldPath, { force: true });
+        copyFile(asset(w.src), path.join(baseRoot, newDest), { exec: !!w.exec });
+        const rootCi = path.join(baseRoot, '.gitlab-ci.yml');
+        try {
+          const txt = fs.readFileSync(rootCi, 'utf8');
+          if (txt.includes(oldDest)) fs.writeFileSync(rootCi, txt.split(oldDest).join(newDest));
+        } catch { /* no root .gitlab-ci.yml (github repo, or fragment-only gitlab) — nothing to rewrite */ }
+      },
+    });
+  }
+  return actions;
+}
+export function legacyRepoActions(root, repo) {
+  return legacyFileActions(repo.name, path.resolve(root, repo.path), LEGACY_REPO_FILES[repo.platform], wiringFor(repo.platform));
+}
+export function legacyHubActions(root) {
+  const hub = readJSON(path.join(root, PROJECT_FILES.hubConfig));
+  if (!hub?.platform || !(hub.bridge_enabled === true || hub.bridge === true)) return [];
+  const wiring = [...HUB_WIRING.common, ...(HUB_WIRING[hub.platform] || [])];
+  return legacyFileActions('hub', root, LEGACY_HUB_FILES[hub.platform], wiring);
+}
 // Per-repo wiring (gate scripts, CI, PR template, comment scaffold).
 export function repoActions(root, repo) {
   const repoRoot = path.resolve(root, repo.path);
@@ -107,7 +194,7 @@ export function authorsActions(root, repos = []) {
   const emails = verifiedAuthorEmails(hub);
   if (!emails.length) return [];
   const desired = [
-    '# Generated by `sdlc check --fix` from .sdlc/hub.json (roster emails + verified_authors).',
+    '# Generated by `yad check --fix` from .sdlc/hub.json (roster emails + verified_authors).',
     '# The verified-commits gate accepts only these author emails. Edit hub.json, not this file.',
     ...emails,
   ].join('\n') + '\n';

package/cli/platform.mjs CHANGED Viewed

@@ -1,5 +1,5 @@
 // Platform adapter — the ONLY place that shells out to gh/glab. Read recipes mirror
-// skills/sdlc-hub-bridge/references/bridge.md. Everything runs as the local user (gh/glab own auth);
+// skills/yad-hub-bridge/references/bridge.md. Everything runs as the local user (gh/glab own auth);
 // no tokens are stored. Pure mapping fns (resolveLogin/mapApprovers) are exported for unit tests;
 // readPr is injectable so the gate can be tested with a fake.
 import { run, has } from './lib.mjs';
@@ -23,7 +23,7 @@ export function platformReady(platform) {
   return !!cli && has(cli);
 }
-// ---- login -> sdlc identity (roster + derived domain-owner) -------------------------------------
+// ---- login -> yad identity (roster + derived domain-owner) -------------------------------------
 // Returns the records this login's APPROVED review contributes. A roster reviewer who owns a touched
 // repo's domain contributes BOTH a base record and a domain-owner record (bridge.md "Login -> role").
 export function resolveLogin(login, roster = [], repos = [], touchedDomains = []) {

package/cli/reconcile.mjs CHANGED Viewed

@@ -1,4 +1,4 @@
-// `sdlc check` (report) and `sdlc check --fix` (reconcile) — and `sdlc update`
+// `yad check` (report) and `yad check --fix` (reconcile) — and `yad update`
 // as a thin alias (--scope=changed). Inspects actual project state against the
 // manifest: missing setup, drifted files, stale code-context.
 import path from 'node:path';
@@ -6,10 +6,13 @@ import {
   c, log, ok, info, warn, hand, fail, readJSON, writeJSON, exists,
 } from './lib.mjs';
 import { VERSION, PROJECT_FILES } from './manifest.mjs';
-import { moduleActions, repoActions, hubActions, authorsActions } from './plan.mjs';
+import {
+  moduleActions, repoActions, hubActions, authorsActions,
+  legacyModuleActions, legacyRepoActions, legacyHubActions,
+} from './plan.mjs';
 import { gitHead, packRepo } from './setup.mjs';
-const MARK = { missing: c.red('missing'), outdated: c.yellow('outdated'), stale: c.yellow('stale'), ok: c.green('ok') };
+const MARK = { missing: c.red('missing'), outdated: c.yellow('outdated'), stale: c.yellow('stale'), legacy: c.yellow('legacy'), ok: c.green('ok') };
 export async function reconcile(root, { fix = false, scope = 'all', force = false } = {}) {
   log(c.bold(`\nSDLC reconcile  ${c.dim('v' + VERSION)}`));
@@ -22,9 +25,14 @@ export async function reconcile(root, { fix = false, scope = 'all', force = fals
   const registry = readJSON(path.join(root, PROJECT_FILES.reposRegistry), { repos: [] });
   if (!exists(path.join(root, PROJECT_FILES.reposRegistry))) gaps.push('no repos registered (.sdlc/repos.json absent)');
-  // --- deterministic file actions (module + hub CI + author allowlists + every registered repo) ---
-  const actions = [...moduleActions(root), ...hubActions(root), ...authorsActions(root, registry.repos)];
-  for (const repo of registry.repos) actions.push(...repoActions(root, repo));
+  // --- deterministic file actions (module + hub CI + author allowlists + every registered repo),
+  //     plus pre-2.0 sdlc-* -> yad-* migrations ('legacy': old name installed; rename in place) ---
+  const actions = [
+    ...moduleActions(root), ...legacyModuleActions(root),
+    ...hubActions(root), ...legacyHubActions(root),
+    ...authorsActions(root, registry.repos),
+  ];
+  for (const repo of registry.repos) actions.push(...repoActions(root, repo), ...legacyRepoActions(root, repo));
   // --- stale code-context (HEAD moved since last pack) ---
   const staleRepos = [];
@@ -42,7 +50,7 @@ export async function reconcile(root, { fix = false, scope = 'all', force = fals
     if (!byScope.has(a.scope)) byScope.set(a.scope, []);
     byScope.get(a.scope).push(a);
   }
-  const counts = { missing: 0, outdated: 0, stale: 0, ok: 0 };
+  const counts = { missing: 0, outdated: 0, stale: 0, legacy: 0, ok: 0 };
   for (const [scopeName, items] of byScope) {
     const notOk = items.filter((i) => i.status !== 'ok');
     items.forEach((i) => counts[i.status]++);
@@ -56,10 +64,10 @@ export async function reconcile(root, { fix = false, scope = 'all', force = fals
     a.status !== 'ok' && (scope === 'all' ? true : a.status !== 'missing'),
   );
   log('');
-  log(c.dim(`summary: ${counts.missing} missing, ${counts.outdated} outdated, ${counts.stale} stale, ${counts.ok} ok`));
+  log(c.dim(`summary: ${counts.missing} missing, ${counts.outdated} outdated, ${counts.stale} stale, ${counts.legacy} legacy, ${counts.ok} ok`));
   if (!fix) {
-    if (fixable.length || gaps.length) hand('run `sdlc check --fix` to reconcile (or `sdlc setup` for missing one-time setup).');
+    if (fixable.length || gaps.length) hand('run `yad check --fix` to reconcile (or `yad setup` for missing one-time setup).');
     return { counts, gaps, applied: 0 };
   }
@@ -78,6 +86,6 @@ export async function reconcile(root, { fix = false, scope = 'all', force = fals
   const rec = readJSON(path.join(root, PROJECT_FILES.version), {});
   writeJSON(path.join(root, PROJECT_FILES.version), { ...rec, version: VERSION });
   applied ? ok(`reconciled ${applied} item(s)`) : info('nothing to fix');
-  if (gaps.length) hand('one-time setup still missing — run `sdlc setup`.');
+  if (gaps.length) hand('one-time setup still missing — run `yad setup`.');
   return { counts, gaps, applied };
 }

package/cli/repo.mjs CHANGED Viewed

@@ -1,5 +1,5 @@
-// `sdlc repo list|refresh` — connected-repo staleness as an explicit HUMAN decision.
-// Skill steps no longer silently repack a stale repo; they flag it and point here. (`sdlc check --fix`
+// `yad repo list|refresh` — connected-repo staleness as an explicit HUMAN decision.
+// Skill steps no longer silently repack a stale repo; they flag it and point here. (`yad check --fix`
 // still refreshes too — it is also human-invoked.)
 import path from 'node:path';
 import { c, log, ok, info, warn, hand, fail, readJSON, writeJSON } from './lib.mjs';
@@ -20,7 +20,7 @@ function staleness(root, repo) {
 export async function runRepo(root, { action = 'list', name, today } = {}) {
   const { regPath, registry } = load(root);
-  if (!registry.repos.length) { warn('no repos registered (.sdlc/repos.json) — run `sdlc setup`'); return { repos: 0 }; }
+  if (!registry.repos.length) { warn('no repos registered (.sdlc/repos.json) — run `yad setup`'); return { repos: 0 }; }
   if (action === 'list') {
     log(c.bold('\nconnected repos'));
@@ -31,7 +31,7 @@ export async function runRepo(root, { action = 'list', name, today } = {}) {
       if (stale) { staleCount++; warn(`${repo.name} ${c.dim(`(${repo.path})`)} — ${c.yellow('stale')} (HEAD moved since last pack)`); }
       else ok(`${repo.name} ${c.dim('— fresh')}`);
     }
-    if (staleCount) hand(`refresh with \`sdlc repo refresh${registry.repos.length > 1 ? ' <name>' : ''}\` (or \`sdlc repo refresh\` for all)`);
+    if (staleCount) hand(`refresh with \`yad repo refresh${registry.repos.length > 1 ? ' <name>' : ''}\` (or \`yad repo refresh\` for all)`);
     return { repos: registry.repos.length, stale: staleCount };
   }
@@ -51,7 +51,7 @@ export async function runRepo(root, { action = 'list', name, today } = {}) {
     }
     writeJSON(regPath, registry);
     refreshed ? ok(`refreshed ${refreshed} repo(s)`) : info('nothing refreshed');
-    hand('regenerate the code-map in Claude Code (sdlc-connect-repos) — the pack is cached, the map is the AI step');
+    hand('regenerate the code-map in Claude Code (yad-connect-repos) — the pack is cached, the map is the AI step');
     return { refreshed };
   }