@aipper/aiws 0.0.29 → 0.0.30

package/dist/commands/update.js

@@ -0,0 +1,212 @@
+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";
+import { deployClaudeHooks } from "../hooks/deploy-claude.js";
+import { DIR_MIGRATION_MAP, FILE_MIGRATION_MAP } from "../aiws-paths.js";
+/**
+ * Rename a file or directory, falling back to copy+delete when renaming
+ * across different filesystems (EXDEV).
+ */
+async function renameOrCopy(src, dst) {
+    try {
+        await fs.rename(src, dst);
+    }
+    catch (err) {
+        if (err.code === "EXDEV") {
+            await fs.cp(src, dst, { recursive: true, force: true });
+            await fs.rm(src, { recursive: true, force: true });
+        }
+        else {
+            throw err;
+        }
+    }
+}
+/**
+ * Move old root-level AIWS artifacts into `.aiws/`.
+ * Skips if source doesn't exist or target already exists.
+ * Returns the number of items moved.
+ */
+async function migrateOldLayout(workspaceRoot, backup) {
+    let count = 0;
+    for (const [srcRel, dstRel] of Object.entries(DIR_MIGRATION_MAP)) {
+        const src = path.join(workspaceRoot, srcRel);
+        const dst = path.join(workspaceRoot, dstRel);
+        if (!(await pathExists(src)))
+            continue;
+        if (await pathExists(dst)) {
+            console.log(`  skip ${srcRel} → ${dstRel} (target already exists)`);
+            continue;
+        }
+        await backup.recordFile(srcRel, { recordMissing: true });
+        await fs.mkdir(path.dirname(dst), { recursive: true });
+        await renameOrCopy(src, dst);
+        count++;
+    }
+    for (const [srcRel, dstRel] of Object.entries(FILE_MIGRATION_MAP)) {
+        const src = path.join(workspaceRoot, srcRel);
+        const dst = path.join(workspaceRoot, dstRel);
+        if (!(await pathExists(src)))
+            continue;
+        if (await pathExists(dst)) {
+            console.log(`  skip ${srcRel} → ${dstRel} (target already exists)`);
+            continue;
+        }
+        await backup.recordFile(srcRel, { recordMissing: true });
+        await fs.mkdir(path.dirname(dst), { recursive: true });
+        await renameOrCopy(src, dst);
+        count++;
+    }
+    return count;
+}
+/**
+ * @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, undefined);
+    await backup.finalize({ extra: { template_id: tpl.templateId } });
+    const migratedCount = await migrateOldLayout(workspaceRoot, backup);
+    if (migratedCount > 0) {
+        console.log(`  migrated ${migratedCount} old AIWS artifact(s) into .aiws/`);
+    }
+    // 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,
+    });
+    const pluginEntries = (tpl.manifest.required || [])
+        .filter((rel) => rel.startsWith(".opencode/plugins/") && rel.endsWith(".js"));
+    for (const rel of pluginEntries) {
+        await copyTemplateFileToWorkspace({
+            templateDir: tpl.templateDir,
+            workspaceRoot,
+            relPosix: rel,
+        });
+    }
+    if (tools.includes("claude")) {
+        await deployClaudeHooks({ force: true });
+    }
+    if (legacyMigration) {
+        console.log(`  migrated legacy AIWS workspace: generated .aiws/manifest.json for template=${legacyTemplateId}`);
+    }
+    console.log(`✓ aiws update: ${workspaceRoot}`);
+}
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,2BAA2B,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,+BAA+B,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACzF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEzE;;;GAGG;AACH,KAAK,UAAU,YAAY,CAAC,GAAW,EAAE,GAAW;IAClD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACzB,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,gBAAgB,CAAC,aAAqB,EAAE,MAAqB;IAC1E,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;YAAE,SAAS;QACvC,IAAI,MAAM,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,MAAM,MAAM,0BAA0B,CAAC,CAAC;YACpE,SAAS;QACX,CAAC;QACD,MAAM,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC7B,KAAK,EAAE,CAAC;IACV,CAAC;IACD,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAClE,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC;YAAE,SAAS;QACvC,IAAI,MAAM,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,MAAM,MAAM,0BAA0B,CAAC,CAAC;YACpE,SAAS;QACX,CAAC;QACD,MAAM,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC7B,KAAK,EAAE,CAAC;IACV,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAY;IAC9C,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IACxF,MAAM,IAAI,GAAG,MAAM,eAAe,EAAE,CAAC;IAErC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;IACxE,MAAM,WAAW,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,gBAAgB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,+BAA+B,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpG,MAAM,eAAe,GAAG,CAAC,WAAW,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClE,IAAI,CAAC,WAAW,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtC,MAAM,IAAI,SAAS,CAAC,qDAAqD,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,MAAM,GAAG,WAAW;QACxB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC1C,CAAC,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAChF,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,IAAI,gBAAgB,IAAI,WAAW,CAAC,CAAC;IACjF,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,mBAAmB,GAAG,IAAI,GAAG,CACjC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;SAClD,MAAM,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;SAC1D,GAAG,CAAC,CAAC,KAAU,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CACxE,CAAC;IACF,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;IAC7C,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IAClH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IAE3C,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;IACzC,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACnE,MAAM,aAAa,GAAG,MAAM,CAAC,cAAc,IAAI,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAEtH,0DAA0D;IAC1D,iFAAiF;IACjF,+EAA+E;IAC/E,KAAK,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACtE,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1D,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YAC7B,IAAI,gBAAgB,EAAE,CAAC;gBACrB,MAAM,IAAI,SAAS,CAAC,kEAAkE,EAAE,EAAE,OAAO,EAAE,YAAY,OAAO,EAAE,EAAE,CAAC,CAAC;YAC9H,CAAC;YACD,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QACpD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;gBAChC,IAAI,eAAe,EAAE,CAAC;oBACpB,SAAS;gBACX,CAAC;gBACD,MAAM,IAAI,SAAS,CAAC,kEAAkE,EAAE;oBACtF,OAAO,EAAE,SAAS,OAAO,YAAY,EAAE,0DAA0D;iBAClG,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAE5D,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;IACzE,gFAAgF;IAChF,MAAM,MAAM,CAAC,UAAU,CAAC,qBAAqB,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,KAAK,MAAM,CAAC,IAAI,YAAY;QAAE,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAClF,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;QAAE,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAChG,KAAK,MAAM,CAAC,IAAI,WAAW;QAAE,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IACnE,MAAM,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,GAAG,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAElE,MAAM,aAAa,GAAG,MAAM,gBAAgB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACpE,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,cAAc,aAAa,mCAAmC,CAAC,CAAC;IAC9E,CAAC;IAED,6EAA6E;IAC7E,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,MAAM,GAAG,GAAG,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;QACxC,IAAI,MAAM,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YAClC,YAAY,EAAE,CAAC;YACf,kEAAkE;YAClE,IAAI,CAAC;gBAAC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,uBAAuB,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IACD,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,aAAa,YAAY,qBAAqB,CAAC,CAAC;IAC9D,CAAC;IAED,oDAAoD;IACpD,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,qBAAqB;YAAE,SAAS;QACpD,MAAM,2BAA2B,CAAC;YAChC,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,aAAa;YACb,QAAQ,EAAE,GAAG;YACb,KAAK,EAAE,GAAG,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;SACxD,CAAC,CAAC;IACL,CAAC;IAED,6DAA6D;IAC7D,KAAK,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACtE,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,MAAM,8BAA8B,CAAC;YACnC,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,aAAa;YACb,OAAO;YACP,QAAQ,EAAE,GAAG;YACb,eAAe,EAAE,eAAe;SACjC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,IAAI,GAAG,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9H,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC;IAElE,MAAM,sBAAsB,CAAC;QAC3B,aAAa;QACb,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,WAAW,EAAE,IAAI,CAAC,OAAO;QACzB,WAAW;QACX,SAAS,EAAE,GAAG;QACd,KAAK;QACL,gBAAgB,EAAE,GAAG,CAAC,QAAQ;KAC/B,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC;SAChD,MAAM,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,oBAAoB,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACxF,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,MAAM,2BAA2B,CAAC;YAChC,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,aAAa;YACb,QAAQ,EAAE,GAAG;SACd,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,iBAAiB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,eAAe,EAAE,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,gFAAgF,gBAAgB,EAAE,CAAC,CAAC;IAClH,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,kBAAkB,aAAa,EAAE,CAAC,CAAC;AACjD,CAAC"}

package/dist/commands/validate.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @param {{ targetPath: string, stamp?: boolean }} options
+ */
+export declare function validateCommand(options: any): Promise<void>;

package/dist/commands/validate.js

@@ -0,0 +1,222 @@
+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", [".aiws/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", [".aiws/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, ".aiws", "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)}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"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"}

package/dist/commands/ws-commit.d.ts

@@ -0,0 +1,5 @@
+/**
+ * aiws commit — validate + commit
+ * @param {{ cwd?: string, message?: string }} opts
+ */
+export declare function wsCommitCommand({ cwd, message }?: any): Promise<void>;

package/dist/commands/ws-commit.js

@@ -0,0 +1,39 @@
+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}/.aiws/changes/*/review/spec-review.md`) ||
+        existsSync(`${cwd}/.aiws/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 });
+    }
+}
+//# sourceMappingURL=ws-commit.js.map

package/dist/commands/ws-commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-commit.js","sourceRoot":"","sources":["../../src/commands/ws-commit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EAAE,GAAG,GAAG,GAAG,EAAE,OAAO,KAAK,EAAS;IACtE,UAAU,CAAC,GAAG,CAAC,CAAC;IAEhB,yBAAyB;IACzB,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,GAAG,wCAAwC,CAAC;QAC7E,UAAU,CAAC,GAAG,GAAG,2CAA2C,CAAC,CAAC;IAChE,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;IAC9D,CAAC;IAED,eAAe;IACf,IAAI,CAAC;QACH,QAAQ,CAAC,mFAAmF,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC3H,CAAC;IAAC,MAAM,CAAC,CAAC,wCAAwC,CAAC,CAAC;IAEpD,qBAAqB;IACrB,MAAM,MAAM,GAAG,QAAQ,CAAC,+BAA+B,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3F,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC;IAC1D,CAAC;IAED,SAAS;IACT,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,SAAS,CAAC,iDAAiD,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,QAAQ,CAAC,kBAAkB,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IACvF,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,UAAU,CAAC,GAAQ;IAC1B,MAAM,GAAG,GAAG,QAAQ,CAAC,wBAAwB,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACjF,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,SAAS,CAAC,wCAAwC,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;IACjF,CAAC;AACH,CAAC"}

package/dist/commands/ws-deliver.d.ts

@@ -0,0 +1,5 @@
+/**
+ * aiws deliver — submodule + superproject commit, then finish
+ * @param {{ cwd?: string, message?: string, changeId?: string }} opts
+ */
+export declare function wsDeliverCommand({ cwd, message, changeId }?: any): Promise<void>;

package/dist/commands/ws-deliver.js

@@ -0,0 +1,59 @@
+import { execSync } from "node:child_process";
+import { existsSync } 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;
+}
+//# sourceMappingURL=ws-deliver.js.map

package/dist/commands/ws-deliver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-deliver.js","sourceRoot":"","sources":["../../src/commands/ws-deliver.ts"],"names":[],"mappings":"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"}

package/dist/commands/ws-finish.d.ts

@@ -0,0 +1,5 @@
+/**
+ * aiws finish — ff-merge + push + archive
+ * @param {{ cwd?: string, changeId?: string, into?: string, push?: boolean, remote?: string }} opts
+ */
+export declare function wsFinishCommand({ cwd, changeId, into, push, remote }?: any): Promise<void>;