@aipper/aiws 0.0.29 → 0.0.30

package/src/commands/update.js

@@ -1,145 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { loadTemplate } from "../spec.js";
-import { loadAiwsPackage } from "../aiws-package.js";
-import { resolveWorkspaceRoot } from "../workspace.js";
-import { readText, pathExists } from "../fs.js";
-import { UserError } from "../errors.js";
-import { normalizeNewlines } from "../hash.js";
-import { findManagedBlock } from "../managed-blocks.js";
-import { BackupSession } from "../backup.js";
-import { normalizeRel, joinRel } from "../path-utils.js";
-import { copyTemplateFileToWorkspace, applyManagedBlocksFromTemplate } from "../template.js";
-import { detectLegacyWorkspaceTemplateId, writeWorkspaceManifest } from "../manifest.js";
-
-/**
- * @param {{ targetPath: string }} options
- */
-export async function updateCommand(options) {
-  const workspaceRoot = await resolveWorkspaceRoot(options.targetPath, { create: false });
-  const aiws = await loadAiwsPackage();
-
-  const manifestPath = path.join(workspaceRoot, ".aiws", "manifest.json");
-  const hasManifest = await pathExists(manifestPath);
-  const legacyTemplateId = !hasManifest ? await detectLegacyWorkspaceTemplateId(workspaceRoot) : null;
-  const legacyMigration = !hasManifest && Boolean(legacyTemplateId);
-  if (!hasManifest && !legacyTemplateId) {
-    throw new UserError("Missing .aiws/manifest.json. Run `aiws init` first.");
-  }
-
-  const stored = hasManifest
-    ? JSON.parse(await readText(manifestPath))
-    : { template_id: legacyTemplateId, installed_at: "", tools: [], managed: [] };
-  const templateId = String(stored.template_id || legacyTemplateId || "workspace");
-  const tpl = await loadTemplate(templateId);
-  const storedManagedByPath = new Map(
-    (Array.isArray(stored.managed) ? stored.managed : [])
-      .filter((entry) => entry && typeof entry === "object")
-      .map((entry) => [normalizeRel(String(entry.path || "")), entry]),
-  );
-  const defaults = tpl.manifest.defaults || {};
-  const defaultTools = Array.isArray(defaults.tools) ? defaults.tools.map(String) : ["claude", "opencode", "codex"];
-  const allowedTools = new Set(defaultTools);
-
-  const update = tpl.manifest.update || {};
-  const replaceFiles = (update.replace_file || []).map(normalizeRel);
-  const managedBlocks = update.managed_blocks && typeof update.managed_blocks === "object" ? update.managed_blocks : {};
-
-  // Preflight: existing managed-block files must be intact.
-  // Missing files that were not previously managed are treated as newly introduced
-  // template surfaces and will be created during applyManagedBlocksFromTemplate.
-  for (const [fileRelRaw, blockIdsRaw] of Object.entries(managedBlocks)) {
-    const fileRel = normalizeRel(fileRelRaw);
-    const abs = joinRel(workspaceRoot, fileRel);
-    const hadManagedBefore = storedManagedByPath.has(fileRel);
-    if (!(await pathExists(abs))) {
-      if (hadManagedBefore) {
-        throw new UserError("Managed block file missing; run `aiws init` or restore the file.", { details: `Missing: ${fileRel}` });
-      }
-      continue;
-    }
-    const text = normalizeNewlines(await readText(abs));
-    const ids = Array.isArray(blockIdsRaw) ? blockIdsRaw.map(String) : [];
-    for (const id of ids) {
-      if (!findManagedBlock(text, id)) {
-        if (legacyMigration) {
-          continue;
-        }
-        throw new UserError("Managed block markers are missing or broken; refusing to update.", {
-          details: `File: ${fileRel}\nBlock: ${id}\nHint: re-run \`aiws init\` or repair markers manually.`,
-        });
-      }
-    }
-  }
-
-  const removeFiles = (update.remove || []).map(normalizeRel);
-
-  const backup = new BackupSession({ workspaceRoot, operation: "update" });
-  // Backup every file we might touch (including missing, for rollback deletions).
-  await backup.recordFile(".aiws/manifest.json", { recordMissing: true });
-  for (const f of replaceFiles) await backup.recordFile(f, { recordMissing: true });
-  for (const f of Object.keys(managedBlocks)) await backup.recordFile(f, { recordMissing: true });
-  for (const f of removeFiles) await backup.recordFile(f);
-  await backup.finalize({ extra: { template_id: tpl.templateId } });
-
-  // Remove deprecated files (backed up above; restorable via `aiws rollback`).
-  let removedCount = 0;
-  for (const rel of removeFiles) {
-    if (!rel) continue;
-    const abs = joinRel(workspaceRoot, rel);
-    if (await pathExists(abs)) {
-      await fs.rm(abs, { force: true });
-      removedCount++;
-      // Remove empty parent directory (safe: rmdir fails on non-empty).
-      try { await fs.rmdir(path.dirname(abs)); } catch { /* non-empty or gone */ }
-    }
-  }
-  if (removedCount > 0) {
-    console.log(`  removed ${removedCount} deprecated file(s)`);
-  }
-
-  // Replace files (except manifest, generated later).
-  for (const rel of replaceFiles) {
-    if (!rel || rel === ".aiws/manifest.json") continue;
-    await copyTemplateFileToWorkspace({
-      templateDir: tpl.templateDir,
-      workspaceRoot,
-      relPosix: rel,
-      chmod: rel.startsWith(".githooks/") ? 0o755 : undefined,
-    });
-  }
-
-  // Update managed blocks only (do not insert missing blocks).
-  for (const [fileRelRaw, blockIdsRaw] of Object.entries(managedBlocks)) {
-    const fileRel = normalizeRel(fileRelRaw);
-    const ids = Array.isArray(blockIdsRaw) ? blockIdsRaw.map(String) : [];
-    await applyManagedBlocksFromTemplate({
-      templateDir: tpl.templateDir,
-      workspaceRoot,
-      fileRel,
-      blockIds: ids,
-      insertIfMissing: legacyMigration,
-    });
-  }
-
-  const now = new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
-  const installedAt = String(stored.installed_at || now);
-  const storedTools = Array.isArray(stored.tools) ? stored.tools.map(String).filter((tool) => allowedTools.has(tool)) : [];
-  const tools = storedTools.length > 0 ? storedTools : defaultTools;
-
-  await writeWorkspaceManifest({
-    workspaceRoot,
-    templateId: tpl.templateId,
-    specVersion: tpl.specVersion,
-    aiwsVersion: aiws.version,
-    installedAt,
-    updatedAt: now,
-    tools,
-    templateManifest: tpl.manifest,
-  });
-
-  if (legacyMigration) {
-    console.log(`  migrated legacy AIWS workspace: generated .aiws/manifest.json for template=${legacyTemplateId}`);
-  }
-  console.log(`✓ aiws update: ${workspaceRoot}`);
-}

package/src/commands/validate.js

@@ -1,228 +0,0 @@
-import path from "node:path";
-import { loadTemplate } from "../spec.js";
-import { resolveWorkspaceRoot } from "../workspace.js";
-import { ensureDir, pathExists, readText, writeText } from "../fs.js";
-import { UserError } from "../errors.js";
-import { detectLegacyWorkspaceTemplateId, validateDrift } from "../manifest.js";
-import { runCommand } from "../exec.js";
-import { expandManifestEntries } from "../template.js";
-import { loadAiwsPackage } from "../aiws-package.js";
-
-/**
- * Enforce deterministic submodule branch policy:
- * - If `.gitmodules` exists and declares submodules, each submodule must declare `submodule.<name>.branch`.
- * - This avoids guessing which branch to attach/push for workflows like ws-pull/ws-finish.
- *
- * @param {string} workspaceRoot
- */
-async function validateSubmoduleBranchPolicy(workspaceRoot) {
-  const gitmodules = path.join(workspaceRoot, ".gitmodules");
-  if (!(await pathExists(gitmodules))) return;
-
-  const list = await runCommand("git", ["config", "--file", ".gitmodules", "--get-regexp", "^submodule\\..*\\.path$"], {
-    cwd: workspaceRoot,
-  });
-  if (list.code !== 0) {
-    // `.gitmodules` exists but no submodule path entries: treat as ok.
-    return;
-  }
-
-  /** @type {Array<{ name: string, path: string }>} */
-  const subs = [];
-  for (const line of String(list.stdout || "").split("\n")) {
-    const t = line.trim();
-    if (!t) continue;
-    const idx = t.indexOf(" ");
-    if (idx <= 0) continue;
-    const key = t.slice(0, idx).trim();
-    const subPath = t.slice(idx + 1).trim();
-    const m = key.match(/^submodule\.(.+)\.path$/);
-    if (!m) continue;
-    const name = m[1] || "";
-    if (!name || !subPath) continue;
-    subs.push({ name, path: subPath });
-  }
-  if (subs.length === 0) return;
-
-  /** @type {Array<{ name: string, path: string }>} */
-  const missing = [];
-  for (const s of subs) {
-    const br = await runCommand("git", ["config", "--file", ".gitmodules", "--get", `submodule.${s.name}.branch`], {
-      cwd: workspaceRoot,
-    });
-    if (br.code !== 0 || !String(br.stdout || "").trim()) {
-      missing.push(s);
-    }
-  }
-
-  if (missing.length > 0) {
-    const lines = missing.map((m) => `- ${m.name} (${m.path}): missing submodule.${m.name}.branch`);
-    const hints = missing
-      .slice(0, 8)
-      .map((m) => `git submodule set-branch --branch main ${m.path}`)
-      .join("\n");
-    throw new UserError("Submodule branch policy failed: missing `.gitmodules` branch config.", {
-      details:
-        `${lines.join("\n")}\n\n` +
-        "Fix:\n" +
-        "- Run `ws-submodule-setup` (recommended), or set per submodule:\n" +
-        `${hints}\n\n` +
-        "Then commit `.gitmodules` in the superproject.",
-    });
-  }
-}
-
-/**
- * @param {string | undefined} v
- */
-function envFlag(v) {
-  const s = String(v || "")
-    .trim()
-    .toLowerCase();
-  return s === "1" || s === "true" || s === "yes" || s === "y" || s === "on";
-}
-
-/**
- * @returns {string} e.g. 20260204-140026Z
- */
-function nowStampUtc() {
-  const d = new Date();
-  const y = String(d.getUTCFullYear());
-  const m = String(d.getUTCMonth() + 1).padStart(2, "0");
-  const day = String(d.getUTCDate()).padStart(2, "0");
-  const hh = String(d.getUTCHours()).padStart(2, "0");
-  const mm = String(d.getUTCMinutes()).padStart(2, "0");
-  const ss = String(d.getUTCSeconds()).padStart(2, "0");
-  const ms = String(d.getUTCMilliseconds()).padStart(3, "0");
-  return `${y}${m}${day}-${hh}${mm}${ss}${ms}Z`;
-}
-
-/**
- * @returns {string} e.g. 2026-01-28T14:00:26Z
- */
-function nowIsoUtc() {
-  return new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
-}
-
-/**
- * @param {any} error
- * @returns {{ name: string, message: string, details?: string } | null}
- */
-function serializeError(error) {
-  if (!error) return null;
-  if (error instanceof UserError) {
-    return { name: error.name, message: error.message, details: error.details };
-  }
-  if (error instanceof Error) {
-    return { name: error.name, message: error.message };
-  }
-  return { name: "Error", message: String(error) };
-}
-
-/**
- * @param {{ targetPath: string, stamp?: boolean }} options
- */
-export async function validateCommand(options) {
-  const stampEnabled = options.stamp === true || envFlag(process.env.AIWS_VALIDATE_STAMP);
-  const startedAt = nowIsoUtc();
-  const startedTs = Math.floor(Date.now() / 1000);
-  let workspaceRoot = "";
-  let templateId = "";
-  let specVersion = "";
-  let aiwsVersion = "";
-  let status = /** @type {"ok" | "error"} */ ("ok");
-  let exitCode = 0;
-  let err = null;
-  let stampPath = "";
-
-  try {
-    workspaceRoot = await resolveWorkspaceRoot(options.targetPath, { create: false });
-    const aiws = await loadAiwsPackage();
-    aiwsVersion = aiws.version;
-
-    const manifestPath = path.join(workspaceRoot, ".aiws", "manifest.json");
-    if (!(await pathExists(manifestPath))) {
-      const legacyTemplateId = await detectLegacyWorkspaceTemplateId(workspaceRoot);
-      if (legacyTemplateId) {
-        throw new UserError("Missing .aiws/manifest.json in a legacy AIWS workspace.", {
-          details: "This workspace looks like an older AIWS install. Run `aiws update .` once to generate the manifest, then rerun `aiws validate`.",
-        });
-      }
-      throw new UserError("Missing .aiws/manifest.json. Run `aiws init` first.");
-    }
-    const stored = JSON.parse(await readText(manifestPath));
-    templateId = String(stored.template_id || "workspace");
-    const tpl = await loadTemplate(templateId);
-    specVersion = tpl.specVersion;
-
-    // Required files/dirs.
-    const required = await expandManifestEntries(tpl.templateDir, tpl.manifest.required || []);
-    /** @type {string[]} */
-    const missing = [];
-    for (const rel of required) {
-      const abs = path.join(workspaceRoot, ...String(rel).split("/"));
-      if (!(await pathExists(abs))) missing.push(rel);
-    }
-    if (missing.length > 0) {
-      throw new UserError("Missing required files.", { details: missing.join("\n") });
-    }
-
-    // Drift detection.
-    await validateDrift({ workspaceRoot, storedManifest: stored, templateManifest: tpl.manifest });
-
-    // Submodule branch policy (deterministic workflow; avoids guessing target branches).
-    await validateSubmoduleBranchPolicy(workspaceRoot);
-
-    // python3 gate.
-    const py = await runCommand("python3", ["--version"], { cwd: workspaceRoot });
-    if (py.code !== 0) {
-      throw new UserError("python3 is required for validate.", { details: py.stderr || py.stdout });
-    }
-
-    // Required gate scripts.
-    const wsCheck = await runCommand("python3", ["tools/ws_change_check.py", "--strict"], { cwd: workspaceRoot });
-    if (wsCheck.code !== 0) {
-      throw new UserError("change gate failed.", { details: wsCheck.stderr || wsCheck.stdout });
-    }
-    const reqCheck = await runCommand("python3", ["tools/requirements_contract.py", "validate"], { cwd: workspaceRoot });
-    if (reqCheck.code !== 0) {
-      throw new UserError("requirements contract gate failed.", { details: reqCheck.stderr || reqCheck.stdout });
-    }
-
-    console.log(`✓ aiws validate: ${workspaceRoot}`);
-  } catch (error) {
-    status = "error";
-    err = serializeError(error);
-    if (error instanceof UserError) {
-      exitCode = error.exitCode;
-    } else {
-      exitCode = 1;
-    }
-    throw error;
-  } finally {
-    if (stampEnabled && workspaceRoot) {
-      try {
-        const stampDir = path.join(workspaceRoot, ".agentdocs", "tmp", "aiws-validate");
-        await ensureDir(stampDir);
-        stampPath = path.join(stampDir, `${nowStampUtc()}.json`);
-        const stamp = {
-          timestamp: startedTs,
-          ws_root: workspaceRoot,
-          template_id: templateId || null,
-          aiws_version: aiwsVersion || null,
-          spec_version: specVersion || null,
-          started_at: startedAt,
-          finished_at: nowIsoUtc(),
-          status,
-          exit_code: status === "ok" ? 0 : exitCode || 1,
-          error: err,
-          note: "aiws validate stamp; does not include full stdout/stderr; do not put secrets in validation output.",
-        };
-        await writeText(stampPath, JSON.stringify(stamp, null, 2) + "\n");
-        console.log(`stamp: ${path.relative(workspaceRoot, stampPath)}`);
-      } catch (e) {
-        console.error(`warn: failed to write validate stamp: ${e instanceof Error ? e.message : String(e)}`);
-      }
-    }
-  }
-}

package/src/commands/ws-commit.js

@@ -1,44 +0,0 @@
-import { execSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { UserError } from "../errors.js";
-
-/**
- * aiws commit — validate + commit
- * @param {{ cwd?: string, message?: string }} opts
- */
-export async function wsCommitCommand({ cwd = ".", message } = {}) {
-  checkClean(cwd);
-
-  // Check review artifacts
-  const reviewsExist = existsSync(`${cwd}/changes/*/review/spec-review.md`) ||
-    existsSync(`${cwd}/changes/*/review/quality-review.md`);
-  if (!reviewsExist) {
-    console.log("warn: no spec-review or quality-review found");
-  }
-
-  // Run validate
-  try {
-    execSync("npx -y @aipper/aiws validate . 2>/dev/null || aiws validate . 2>/dev/null || true", { cwd, stdio: "inherit" });
-  } catch { /* validate is advisory, not blocking */ }
-
-  // Get staged changes
-  const staged = execSync("git diff --cached --name-only", { cwd, encoding: "utf8" }).trim();
-  if (!staged) {
-    console.log("info: nothing staged. Use git add first.");
-  }
-
-  // Commit
-  if (!message) {
-    throw new UserError("commit requires --message (use -m or --message)", { exitCode: 2 });
-  }
-
-  execSync(`git commit -m "${message.replace(/"/g, '\\"')}"`, { cwd, stdio: "inherit" });
-  console.log("ok: commit created");
-}
-
-function checkClean(cwd) {
-  const out = execSync("git status --porcelain", { cwd, encoding: "utf8" }).trim();
-  if (!out) {
-    throw new UserError("Nothing to commit. Working tree clean.", { exitCode: 2 });
-  }
-}

package/src/commands/ws-deliver.js

@@ -1,67 +0,0 @@
-import { execSync } from "node:child_process";
-import { existsSync, readFileSync } from "node:fs";
-import { UserError } from "../errors.js";
-
-/**
- * aiws deliver — submodule + superproject commit, then finish
- * @param {{ cwd?: string, message?: string, changeId?: string }} opts
- */
-export async function wsDeliverCommand({ cwd = ".", message, changeId } = {}) {
-  if (!changeId) {
-    changeId = detectChangeBranch(cwd);
-  }
-  if (!changeId) {
-    throw new UserError("Could not detect change ID.", { exitCode: 2 });
-  }
-
-  if (!message) {
-    throw new UserError("deliver requires --message for the superproject commit", { exitCode: 2 });
-  }
-
-  console.log("info: starting delivery...");
-
-  // Commit submodules first
-  if (existsSync(`${cwd}/.gitmodules`)) {
-    const out = execSync("git config --file .gitmodules --get-regexp '^submodule\\..*\\.path$'", {
-      cwd, encoding: "utf8",
-    }).trim();
-
-    for (const line of out.split("\n")) {
-      const parts = line.trim().split(/\s+/);
-      if (parts.length < 2) continue;
-      const subPath = parts[1];
-
-      const status = execSync(`git -C "${subPath}" status --porcelain`, { cwd, encoding: "utf8" }).trim();
-      if (status) {
-        console.log(`info: submodule ${subPath} has changes. Committing...`);
-        execSync(`git -C "${subPath}" add -A`, { cwd, stdio: "inherit" });
-        execSync(`git -C "${subPath}" commit -m "${message}"`, { cwd, stdio: "inherit" });
-      } else {
-        console.log(`info: submodule ${subPath} has no changes, skipping`);
-      }
-    }
-  }
-
-  // Commit superproject
-  const superStatus = execSync("git status --porcelain", { cwd, encoding: "utf8" }).trim();
-  if (superStatus) {
-    console.log("info: committing superproject...");
-    execSync("git add -A", { cwd, stdio: "inherit" });
-    execSync(`git commit -m "${message}"`, { cwd, stdio: "inherit" });
-  } else {
-    console.log("info: superproject has no changes");
-  }
-
-  // Finish
-  await import("./ws-finish.js").then(m =>
-    m.wsFinishCommand({ cwd, changeId, push: true })
-  );
-
-  console.log("ok: deliver complete");
-}
-
-function detectChangeBranch(cwd) {
-  const branch = execSync("git branch --show-current", { cwd, encoding: "utf8" }).trim();
-  const match = branch.match(/^(?:change|changes|ws|ws-change)\/(.+)$/);
-  return match ? match[1] : null;
-}

package/src/commands/ws-finish.js

@@ -1,83 +0,0 @@
-import { execSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { UserError } from "../errors.js";
-
-/**
- * aiws finish — ff-merge + push + archive
- * @param {{ cwd?: string, changeId?: string, into?: string, push?: boolean, remote?: string }} opts
- */
-export async function wsFinishCommand({ cwd = ".", changeId, into, push = false, remote = "origin" } = {}) {
-  checkClean(cwd);
-
-  if (!changeId) {
-    changeId = detectChangeBranch(cwd);
-  }
-
-  if (!changeId) {
-    throw new UserError("Could not detect change ID. Provide as argument or be on a change branch.", { exitCode: 2 });
-  }
-
-  const targetBranch = into || "main";
-
-  // Validate before complete
-  try {
-    execSync(`npx -y @aipper/aiws change validate ${changeId} --strict 2>/dev/null`, { cwd, stdio: "inherit" });
-  } catch {
-    throw new UserError(`Validation failed for ${changeId}. Fix issues first.`, { exitCode: 1 });
-  }
-
-  // FF merge
-  const changeBranch = `change/${changeId}`;
-  const branchExists = execSync(`git branch --list '${changeBranch}'`, { cwd, encoding: "utf8" }).trim();
-  if (branchExists) {
-    console.log(`info: ff-merging ${changeBranch} → ${targetBranch}...`);
-    execSync(`git checkout ${targetBranch}`, { cwd, stdio: "inherit" });
-    execSync(`git merge --ff-only ${changeBranch}`, { cwd, stdio: "inherit" });
-  } else {
-    console.log("info: no change branch found, using current branch");
-  }
-
-  // Push
-  if (push) {
-    const currentBranch = execSync("git branch --show-current", { cwd, encoding: "utf8" }).trim();
-
-    // Push submodules first
-    if (existsSync(`${cwd}/.gitmodules`)) {
-      const targetsFile = `changes/${changeId}/submodules.targets`;
-      if (existsSync(targetsFile)) {
-        const content = execSync(`cat "${targetsFile}"`, { cwd, encoding: "utf8" });
-        for (const line of content.split("\n")) {
-          const t = line.trim();
-          if (!t || t.startsWith("#")) continue;
-          const [subPath, targetBranch] = t.split(/\s+/);
-          if (subPath && targetBranch) {
-            console.log(`info: pushing submodule ${subPath}...`);
-            execSync(`git push ${remote} ${targetBranch}`, { cwd: `${cwd}/${subPath}`, stdio: "inherit" });
-          }
-        }
-      }
-    }
-
-    execSync(`git push ${remote} ${currentBranch}`, { cwd, stdio: "inherit" });
-  }
-
-  // Archive
-  try {
-    execSync(`npx -y @aipper/aiws change archive ${changeId} --force 2>/dev/null || aiws change archive ${changeId} --force 2>/dev/null || true`, { cwd, stdio: "inherit" });
-  } catch { /* ignore archive failure — main flow done */ }
-
-  console.log(`ok: finish complete. ${push ? "Pushed and " : ""}Archived.`);
-}
-
-function checkClean(cwd) {
-  const out = execSync("git status --porcelain", { cwd, encoding: "utf8" }).trim();
-  if (out) {
-    throw new UserError("Working tree is not clean. Commit or stash first.", { exitCode: 2 });
-  }
-}
-
-function detectChangeBranch(cwd) {
-  const branch = execSync("git branch --show-current", { cwd, encoding: "utf8" }).trim();
-  const match = branch.match(/^(?:change|changes|ws|ws-change)\/(.+)$/);
-  return match ? match[1] : null;
-}

package/src/commands/ws-handoff.js

@@ -1,40 +0,0 @@
-import { existsSync, readFileSync, readdirSync } from "node:fs";
-
-/**
- * aiws handoff — read/display handoff documents
- * @param {{ cwd?: string }} opts
- */
-export async function wsHandoffCommand({ cwd = "." } = {}) {
-  const changesDir = `${cwd}/changes`;
-  if (!existsSync(changesDir)) {
-    console.log("info: no changes/ directory found");
-    return;
-  }
-
-  // Check archive handoffs first
-  const archiveDir = `${changesDir}/archive`;
-  if (existsSync(archiveDir)) {
-    const archives = readdirSync(archiveDir).filter(f => f !== ".DS_Store");
-    for (const a of archives) {
-      const hf = `${archiveDir}/${a}/handoff.md`;
-      if (existsSync(hf)) {
-        console.log(`=== ${a} ===`);
-        console.log(readFileSync(hf, "utf8"));
-      }
-    }
-  }
-
-  // Check active change handoffs
-  const changes = readdirSync(changesDir).filter(f =>
-    !f.startsWith(".") && f !== "templates" && f !== "archive" && f !== "README.md"
-  );
-  for (const c of changes) {
-    const hf = `${changesDir}/${c}/handoff.md`;
-    if (existsSync(hf)) {
-      console.log(`=== ${c} (active) ===`);
-      console.log(readFileSync(hf, "utf8"));
-    }
-  }
-
-  console.log("info: handoffs are generated by aiws change finish --push");
-}

package/src/commands/ws-migrate.js

@@ -1,41 +0,0 @@
-import { execSync } from "node:child_process";
-import { existsSync } from "node:fs";
-
-/**
- * aiws migrate — workspace migration (init or update)
- * @param {{ cwd?: string }} opts
- */
-export async function wsMigrateCommand({ cwd = "." } = {}) {
-  const localAiws = `${cwd}/node_modules/.bin/aiws`;
-
-  if (existsSync(`${cwd}/.aiws/manifest.json`)) {
-    console.log("info: workspace detected, running update...");
-    runAiws(localAiws, `update ${cwd}`);
-  } else {
-    console.log("info: no workspace detected, running init...");
-    runAiws(localAiws, `init ${cwd}`);
-  }
-
-  // Enable hooks
-  try {
-    execSync("git config core.hooksPath .githooks", { cwd, stdio: "inherit" });
-    console.log("info: hooks enabled (core.hooksPath=.githooks)");
-  } catch {
-    console.log("warn: could not set hooks (not a git repo?)");
-  }
-
-  console.log("ok: migrate complete");
-}
-
-function runAiws(localAiws, args) {
-  try {
-    if (existsSync(localAiws)) {
-      execSync(`${localAiws} ${args}`, { stdio: "inherit" });
-    } else {
-      execSync(`npx -y @aipper/aiws ${args}`, { stdio: "inherit" });
-    }
-  } catch (e) {
-    console.error(`error: aiws ${args} failed`);
-    throw e;
-  }
-}