@warnyin/sdlc 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.2.2 (2026-08-20)
+
+- `init` (and `update`) now drop a `.gitkeep` in `sdlc/changes/archive/`, so the
+  directory survives a commit and is still there after a clone. 0.2.1 made
+  `archive` recover from the missing directory; this stops it going missing.
+  The marker is not payload-owned — prune never reclaims it and the installer
+  never warns about it.
+
+## 0.2.1 (2026-08-20)
+
+- **Fix**: `archive` failed with `ENOENT` on the first change a repo ever ships.
+  `init` scaffolds `sdlc/changes/archive/`, but git does not track empty
+  directories, so the folder is absent for everyone who clones before that first
+  ship. The rename is now preceded by a `mkdir -p` of the archive root.
+
+  The failure landed mid-phase-2, after the delta had been merged into the living
+  specs, evals promoted, `status: shipped` stamped and the ship event journalled —
+  a repo left half-shipped while the CLI reported total failure. The directory is
+  now prepared next to the other destination checks, before phase 1 computes a
+  single merge, so an unusable archive path aborts with the specs untouched.
+
 ## 0.2.0 (2026-08-20)
 
 `init` is now an installer you can actually see working — still zero dependencies.

package/bin/cli.mjs

@@ -189,6 +189,12 @@ function scaffoldSdlc(projectRoot, tools, ctx) {
     fs.mkdirSync(path.join(sdlcRoot, dir), { recursive: true });
   }
 
+  // git does not track empty directories, so changes/archive/ vanishes for
+  // anyone who clones before the first change ships. Not manifested: an empty
+  // marker is nothing for prune to reclaim or for the installer to warn about.
+  const gitkeep = path.join(sdlcRoot, 'changes', 'archive', '.gitkeep');
+  if (!fs.existsSync(gitkeep)) fs.writeFileSync(gitkeep, '');
+
   // Seeds are user-owned from birth: created once, never manifested/overwritten.
   const seed = (rel, templateName, transform = (s) => s) => {
     const dest = path.join(sdlcRoot, rel);
@@ -437,6 +443,11 @@ export function cmdArchive(projectRoot, changeId, { strict = true } = {}) {
   // while reporting failure.
   const date = new Date().toISOString().slice(0, 10);
   const destDir = path.join(sdlcRoot, 'changes', 'archive', `${date}-${changeId}`);
+  // `init` scaffolds changes/archive/, but git does not track empty directories:
+  // it is absent for anyone who cloned before the first change shipped. Prepare
+  // it here, with the other destination checks, so a bad archive path fails
+  // while the specs are still untouched instead of ENOENT-ing at the rename.
+  fs.mkdirSync(path.dirname(destDir), { recursive: true });
   if (fs.existsSync(destDir)) {
     throw new Error(`archive target already exists: ${toPosix(path.relative(projectRoot, destDir))} — nothing was merged`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warnyin/sdlc",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Spec-driven, AI-driven SDLC framework — token-lean specs, contract-first changes, autonomous pipeline with managed hooks. Operationalizes the Day-1 'New SDLC with Vibe Coding' work process.",
   "type": "module",
   "bin": {