@aipper/aiws 0.0.28 → 0.0.30

package/README.md

@@ -12,7 +12,7 @@
 - `aiws change ...`：变更工件工作流
 - `aiws dashboard serve`：本地 change/dashboard API
 - `aiws hooks install/status`
-- `aiws opencode status`
+- `aiws opencode status/supervise`
 - `aiws codex install-skills/status-skills/uninstall-skills`
 
 支持工具：
@@ -55,6 +55,8 @@ AI 工具内：
 - simple/local 单点修复：`$ws-dev-lite`
 - 常规实现：`$ws-dev`
 - 中大型任务：`$ws-plan` → `$ws-plan-verify` → `$ws-dev`
+- OpenCode/oMo 自动 bootstrap：`/ws-auto`
+- OpenCode/oMo 自主协作实验：`/ws-autonomy`
 - 提交前：`$ws-review` / `$ws-commit`
 - 交付前：`$ws-deliver` / `$ws-finish`
 
@@ -75,7 +77,7 @@ aiws validate [path] [--stamp]
 aiws rollback [path] <timestamp|latest>
 
 aiws change new <change-id> [--no-design]
-aiws change start <change-id> [--switch|--no-switch|--worktree]
+aiws change start <change-id> [--switch|--no-switch]
 aiws change status [change-id]
 aiws change next [change-id]
 aiws change sync [change-id]
@@ -87,6 +89,8 @@ aiws dashboard serve [--host 127.0.0.1] [--port 3456]
 aiws hooks install [path]
 aiws hooks status [path]
 aiws opencode status [path]
+aiws opencode auto [path] [--session <name>] [--window <name>] [--once] [--poll-ms <ms>] [--no-update]
+aiws opencode supervise [path] [--session <name>] [--window <name>] [--once] [--poll-ms <ms>]
 aiws codex install-skills
 aiws codex status-skills
 aiws codex uninstall-skills
@@ -116,6 +120,18 @@ aiws codex uninstall-skills
 
 目标是统一 workflow 入口，不保证工具自动发现或自动加载。
 
+OpenCode/oMo 补充：
+- `.opencode/oh-my-opencode.json.example` 提供 autonomy 示例配置（`prompt_append` / `backgroundTasks` / `experimental.auto_resume`）
+- 同一份 oMo 示例配置还会声明 approval whitelist policy（只读命令 + evidence 写路径；宿主权限保持 `manual-only`）
+- `.claude/settings.json.example` 提供 hook 兼容层示例
+- `.opencode/helpers/approval-whitelist-check.sh` 把 whitelist policy 转成 `allow/deny/manual` 判定，并落审计日志
+- `.opencode/helpers/approval-whitelist-run.sh` 在 `allow` 时执行简单命令，并落执行摘要
+- `.opencode/helpers/approval-whitelist-watchdog.sh` 轮询队列并调用 runner，适合外部蜂群/守护进程接入
+- `/ws-auto` 会先触发 `aiws opencode auto .`：必要时刷新托管内容，再按条件确保 watchdog 已在 tmux 中运行
+- `aiws opencode auto .` 会在需要时自动执行 `aiws update .`；若 oMo 已启用且 tmux 可用，再继续启动 watchdog
+- `aiws opencode supervise .` 会显式确保 tmux 中已有一个 watchdog window；若当前不在 tmux，则会为该工作区起一个 detached session
+- `.opencode/helpers/tmux-swarm-scan.sh` / `tmux-swarm-rescue.sh` 提供可选的 tmux 巡检与安全救援 helper
+
 ## 运行要求
 
 - Node.js >= 20

package/bin/aiws.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { cliMain } from "../src/cli.js";
-import { UserError } from "../src/errors.js";
+import { cliMain } from "../dist/cli.js";
+import { UserError } from "../dist/errors.js";
 
 try {
   const exitCode = await cliMain(process.argv.slice(2));

package/dist/aiws-package.d.ts

@@ -0,0 +1,4 @@
+export declare function loadAiwsPackage(): Promise<{
+    rootDir: string;
+    version: string;
+}>;

package/dist/aiws-package.js

@@ -0,0 +1,11 @@
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { readText } from "./fs.js";
+export async function loadAiwsPackage() {
+    const here = fileURLToPath(import.meta.url);
+    const rootDir = path.resolve(path.dirname(here), "..");
+    const pkg = JSON.parse(await readText(path.join(rootDir, "package.json")));
+    const version = String(pkg.version || "").trim() || "0.0.0";
+    return { rootDir, version };
+}
+//# sourceMappingURL=aiws-package.js.map

package/dist/aiws-package.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiws-package.js","sourceRoot":"","sources":["../src/aiws-package.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IACvD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC;IAC5D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}

package/dist/aiws-paths.d.ts

@@ -0,0 +1,48 @@
+/** All AIWS-managed directories live under this subdirectory */
+export declare const AIWS_DIR = ".aiws";
+/** Changes directory: .aiws/changes/ */
+export declare function changesDir(root: string): string;
+/** Single change directory: .aiws/changes/{changeId}/ */
+export declare function changeDir(root: string, changeId: string): string;
+/** Changes archive: .aiws/changes/archive/ */
+export declare function changesArchiveDir(root: string): string;
+/** Changes templates: .aiws/changes/templates/ */
+export declare function changesTemplatesDir(root: string): string;
+/** Tools directory: .aiws/tools/ */
+export declare function toolsDir(root: string): string;
+/** Tmp directory: .aiws/tmp/ */
+export declare function tmpDir(root: string): string;
+/** Plan directory: .aiws/plan/ */
+export declare function planDir(root: string): string;
+/** Requirements directory: .aiws/requirements/ */
+export declare function requirementsDir(root: string): string;
+/** Issues directory: .aiws/issues/ */
+export declare function issuesDir(root: string): string;
+/** Memory-bank directory: .aiws/memory-bank/ */
+export declare function memoryBankDir(root: string): string;
+/** Secrets directory: .aiws/secrets/ */
+export declare function secretsDir(root: string): string;
+export declare const CHANGES_REL = ".aiws/changes";
+export declare const TOOLS_REL = ".aiws/tools";
+export declare const TMP_REL = ".aiws/tmp";
+export declare const PLAN_REL = ".aiws/plan";
+export declare const REQUIREMENTS_REL = ".aiws/requirements";
+export declare const ISSUES_REL = ".aiws/issues";
+export declare const MEMORY_BANK_REL = ".aiws/memory-bank";
+export declare const SECRETS_REL = ".aiws/secrets";
+export declare function validateStampDir(root: string): string;
+export declare function changeSyncStampDir(root: string): string;
+export declare function changeArchiveStampDir(root: string): string;
+export declare function tmpReviewDir(root: string): string;
+export declare function changeJournalDir(root: string, changeId: string): string;
+export declare function changeEvidenceDir(root: string, changeId: string): string;
+export declare function changeReviewDir(root: string, changeId: string): string;
+export declare function changeAnalysisDir(root: string, changeId: string): string;
+export declare function changeRelPrefix(changeId: string): string;
+export declare function changeEvidenceRelPrefix(changeId: string): string;
+export declare function changeReviewRelPrefix(changeId: string): string;
+export declare const REQUIRED_WRITE_ALLOW_PATHS: string[];
+export declare const REQUIRED_DENY_PATHS: string[];
+export declare const WORKSPACE_SIGNAL_REL: string[];
+export declare const DIR_MIGRATION_MAP: Record<string, string>;
+export declare const FILE_MIGRATION_MAP: Record<string, string>;

package/dist/aiws-paths.js

@@ -0,0 +1,129 @@
+import path from "node:path";
+// ── Base directories (all relative to gitRoot/workspaceRoot) ──
+/** All AIWS-managed directories live under this subdirectory */
+export const AIWS_DIR = ".aiws";
+/** Changes directory: .aiws/changes/ */
+export function changesDir(root) {
+    return path.join(root, AIWS_DIR, "changes");
+}
+/** Single change directory: .aiws/changes/{changeId}/ */
+export function changeDir(root, changeId) {
+    return path.join(root, AIWS_DIR, "changes", changeId);
+}
+/** Changes archive: .aiws/changes/archive/ */
+export function changesArchiveDir(root) {
+    return path.join(root, AIWS_DIR, "changes", "archive");
+}
+/** Changes templates: .aiws/changes/templates/ */
+export function changesTemplatesDir(root) {
+    return path.join(root, AIWS_DIR, "changes", "templates");
+}
+/** Tools directory: .aiws/tools/ */
+export function toolsDir(root) {
+    return path.join(root, AIWS_DIR, "tools");
+}
+/** Tmp directory: .aiws/tmp/ */
+export function tmpDir(root) {
+    return path.join(root, AIWS_DIR, "tmp");
+}
+/** Plan directory: .aiws/plan/ */
+export function planDir(root) {
+    return path.join(root, AIWS_DIR, "plan");
+}
+/** Requirements directory: .aiws/requirements/ */
+export function requirementsDir(root) {
+    return path.join(root, AIWS_DIR, "requirements");
+}
+/** Issues directory: .aiws/issues/ */
+export function issuesDir(root) {
+    return path.join(root, AIWS_DIR, "issues");
+}
+/** Memory-bank directory: .aiws/memory-bank/ */
+export function memoryBankDir(root) {
+    return path.join(root, AIWS_DIR, "memory-bank");
+}
+/** Secrets directory: .aiws/secrets/ */
+export function secretsDir(root) {
+    return path.join(root, AIWS_DIR, "secrets");
+}
+// ── Relative path segments (for string matching, manifest entries, etc.) ──
+export const CHANGES_REL = ".aiws/changes";
+export const TOOLS_REL = ".aiws/tools";
+export const TMP_REL = ".aiws/tmp";
+export const PLAN_REL = ".aiws/plan";
+export const REQUIREMENTS_REL = ".aiws/requirements";
+export const ISSUES_REL = ".aiws/issues";
+export const MEMORY_BANK_REL = ".aiws/memory-bank";
+export const SECRETS_REL = ".aiws/secrets";
+// ── Tmp sub-paths (for stamps etc.) ──
+export function validateStampDir(root) {
+    return path.join(root, AIWS_DIR, "tmp", "aiws-validate");
+}
+export function changeSyncStampDir(root) {
+    return path.join(root, AIWS_DIR, "tmp", "change-sync");
+}
+export function changeArchiveStampDir(root) {
+    return path.join(root, AIWS_DIR, "tmp", "change-archive");
+}
+export function tmpReviewDir(root) {
+    return path.join(root, AIWS_DIR, "tmp", "review");
+}
+// ── Convenience: single change subdir helpers ──
+export function changeJournalDir(root, changeId) {
+    return path.join(changeDir(root, changeId), "journal");
+}
+export function changeEvidenceDir(root, changeId) {
+    return path.join(changeDir(root, changeId), "evidence");
+}
+export function changeReviewDir(root, changeId) {
+    return path.join(changeDir(root, changeId), "review");
+}
+export function changeAnalysisDir(root, changeId) {
+    return path.join(changeDir(root, changeId), "analysis");
+}
+// ── Relative prefix strings for analyzeEvidencePaths ──
+export function changeRelPrefix(changeId) {
+    return `${CHANGES_REL}/${changeId}/`;
+}
+export function changeEvidenceRelPrefix(changeId) {
+    return `${CHANGES_REL}/${changeId}/evidence/`;
+}
+export function changeReviewRelPrefix(changeId) {
+    return `${CHANGES_REL}/${changeId}/review/`;
+}
+// ── OpenCode env path constants ──
+export const REQUIRED_WRITE_ALLOW_PATHS = [
+    ".aiws/tmp/",
+    ".aiws/changes/*/analysis/",
+    ".aiws/changes/*/review/",
+    ".aiws/changes/*/evidence/",
+];
+export const REQUIRED_DENY_PATHS = [
+    ".aiws/secrets/",
+    ".env*",
+];
+// ── Legacy detection signal paths (for manifest.ts detectLegacyWorkspaceTemplateId) ──
+// These check the NEW layout to detect if workspace is already migrated
+export const WORKSPACE_SIGNAL_REL = [
+    "AI_PROJECT.md",
+    "REQUIREMENTS.md",
+    "AI_WORKSPACE.md",
+    ".aiws/tools/ws_change_check.py",
+    ".aiws/tools/requirements_contract.py",
+];
+// ── Migration: old → new directory mapping ──
+export const DIR_MIGRATION_MAP = {
+    "changes": ".aiws/changes",
+    "tools": ".aiws/tools",
+    "requirements": ".aiws/requirements",
+    "issues": ".aiws/issues",
+    "memory-bank": ".aiws/memory-bank",
+    "secrets": ".aiws/secrets",
+    ".agentdocs": ".aiws",
+    "plan": ".aiws/plan",
+};
+// ── Single file migration ──
+export const FILE_MIGRATION_MAP = {
+    ".ws-change.json": ".aiws/ws-change.json",
+};
+//# sourceMappingURL=aiws-paths.js.map

package/dist/aiws-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiws-paths.js","sourceRoot":"","sources":["../src/aiws-paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,iEAAiE;AACjE,gEAAgE;AAChE,MAAM,CAAC,MAAM,QAAQ,GAAG,OAAO,CAAC;AAEhC,wCAAwC;AACxC,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAC9C,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,QAAgB;IACtD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACzD,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;AAC3D,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;AACnD,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;AAClD,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAC9C,CAAC;AAED,6EAA6E;AAC7E,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC;AAC3C,MAAM,CAAC,MAAM,SAAS,GAAG,aAAa,CAAC;AACvC,MAAM,CAAC,MAAM,OAAO,GAAG,WAAW,CAAC;AACnC,MAAM,CAAC,MAAM,QAAQ,GAAG,YAAY,CAAC;AACrC,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AACrD,MAAM,CAAC,MAAM,UAAU,GAAG,cAAc,CAAC;AACzC,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC;AAE3C,wCAAwC;AACxC,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;AACpD,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,QAAgB;IAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,QAAgB;IAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,QAAgB;IAC5D,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,QAAgB;IAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC;AAC1D,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,GAAG,WAAW,IAAI,QAAQ,GAAG,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,OAAO,GAAG,WAAW,IAAI,QAAQ,YAAY,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,OAAO,GAAG,WAAW,IAAI,QAAQ,UAAU,CAAC;AAC9C,CAAC;AAED,oCAAoC;AACpC,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,YAAY;IACZ,2BAA2B;IAC3B,yBAAyB;IACzB,2BAA2B;CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,gBAAgB;IAChB,OAAO;CACR,CAAC;AAEF,wFAAwF;AACxF,wEAAwE;AACxE,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,eAAe;IACf,iBAAiB;IACjB,iBAAiB;IACjB,gCAAgC;IAChC,sCAAsC;CACvC,CAAC;AAEF,+CAA+C;AAC/C,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD,SAAS,EAAE,eAAe;IAC1B,OAAO,EAAE,aAAa;IACtB,cAAc,EAAE,oBAAoB;IACpC,QAAQ,EAAE,cAAc;IACxB,aAAa,EAAE,mBAAmB;IAClC,SAAS,EAAE,eAAe;IAC1B,YAAY,EAAE,OAAO;IACrB,MAAM,EAAE,YAAY;CACrB,CAAC;AAEF,8BAA8B;AAC9B,MAAM,CAAC,MAAM,kBAAkB,GAA2B;IACxD,iBAAiB,EAAE,sBAAsB;CAC1C,CAAC"}

package/dist/backup.d.ts

@@ -0,0 +1,27 @@
+export declare function formatBackupTimestamp(d: Date): string;
+export interface BackupSessionOptions {
+    workspaceRoot: string;
+    operation: "init" | "update";
+}
+export interface BackupFileInfo {
+    existed: boolean;
+    mode: number | null;
+}
+export declare class BackupSession {
+    workspaceRoot: string;
+    operation: "init" | "update";
+    timestamp: string;
+    backupRoot: string;
+    files: Map<string, BackupFileInfo>;
+    protected _prepared: boolean;
+    constructor(options: BackupSessionOptions);
+    _prepare(): Promise<void>;
+    recordFile(relPosix: string, options?: {
+        recordMissing?: boolean;
+    }): Promise<void>;
+    finalize(options?: {
+        extra?: any;
+    }): Promise<string | null>;
+}
+export declare function resolveBackupRoot(workspaceRoot: string, stamp: string): Promise<string>;
+export declare function rollbackFromBackup(workspaceRoot: string, backupRoot: string): Promise<void>;

package/dist/backup.js

@@ -0,0 +1,125 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { ensureDir, pathExists } from "./fs.js";
+import { joinRel, normalizeRel } from "./path-utils.js";
+import { UserError } from "./errors.js";
+export function formatBackupTimestamp(d) {
+    return d.toISOString().replace(/\.\d{3}Z$/, "Z").replaceAll(":", "-");
+}
+export class BackupSession {
+    workspaceRoot;
+    operation;
+    timestamp;
+    backupRoot;
+    files;
+    _prepared;
+    constructor(options) {
+        this.workspaceRoot = options.workspaceRoot;
+        this.operation = options.operation;
+        this.timestamp = formatBackupTimestamp(new Date());
+        this.backupRoot = path.join(this.workspaceRoot, ".aiws", "backups", this.timestamp);
+        this.files = new Map();
+        this._prepared = false;
+    }
+    async _prepare() {
+        if (this._prepared)
+            return;
+        await ensureDir(this.backupRoot);
+        this._prepared = true;
+    }
+    async recordFile(relPosix, options) {
+        const rel = normalizeRel(relPosix);
+        if (this.files.has(rel))
+            return;
+        const abs = joinRel(this.workspaceRoot, rel);
+        const exists = await pathExists(abs);
+        if (!exists) {
+            if (options?.recordMissing) {
+                this.files.set(rel, { existed: false, mode: null });
+            }
+            return;
+        }
+        const st = await fs.stat(abs);
+        if (!st.isFile()) {
+            if (options?.recordMissing)
+                this.files.set(rel, { existed: false, mode: null });
+            return;
+        }
+        await this._prepare();
+        const dest = joinRel(this.backupRoot, rel);
+        await ensureDir(path.dirname(dest));
+        await fs.copyFile(abs, dest);
+        try {
+            await fs.chmod(dest, st.mode & 0o777);
+        }
+        catch {
+            // ignore chmod errors
+        }
+        this.files.set(rel, { existed: true, mode: st.mode & 0o777 });
+    }
+    async finalize(options) {
+        if (!this._prepared && this.files.size === 0)
+            return null;
+        await this._prepare();
+        const meta = {
+            operation: this.operation,
+            timestamp: this.timestamp,
+            created_at: new Date().toISOString(),
+            files: Array.from(this.files.entries()).map(([p, v]) => ({ path: p, existed: v.existed, mode: v.mode })),
+            extra: options?.extra ?? null,
+        };
+        await fs.writeFile(path.join(this.backupRoot, "backup.json"), JSON.stringify(meta, null, 2) + "\n", "utf8");
+        return this.backupRoot;
+    }
+}
+export async function resolveBackupRoot(workspaceRoot, stamp) {
+    const backupsRoot = path.join(workspaceRoot, ".aiws", "backups");
+    if (stamp === "latest") {
+        if (!(await pathExists(backupsRoot)))
+            throw new UserError("No backups found.");
+        const entries = await fs.readdir(backupsRoot, { withFileTypes: true });
+        const dirs = entries.filter((e) => e.isDirectory()).map((e) => e.name).sort();
+        const latest = dirs[dirs.length - 1];
+        if (!latest)
+            throw new UserError("No backups found.");
+        return path.join(backupsRoot, latest);
+    }
+    const target = path.join(backupsRoot, stamp);
+    if (!(await pathExists(target))) {
+        throw new UserError(`Backup not found: ${stamp}`, { details: `Missing: ${target}` });
+    }
+    return target;
+}
+export async function rollbackFromBackup(workspaceRoot, backupRoot) {
+    const metaPath = path.join(backupRoot, "backup.json");
+    if (!(await pathExists(metaPath))) {
+        throw new UserError("backup.json not found; cannot rollback safely.", { details: `Missing: ${metaPath}` });
+    }
+    const meta = JSON.parse(await fs.readFile(metaPath, "utf8"));
+    const files = Array.isArray(meta.files) ? meta.files : [];
+    for (const f of files) {
+        const rel = normalizeRel(String(f.path || ""));
+        if (!rel)
+            continue;
+        const dest = joinRel(workspaceRoot, rel);
+        if (f.existed) {
+            const src = joinRel(backupRoot, rel);
+            await ensureDir(path.dirname(dest));
+            await fs.copyFile(src, dest);
+            if (typeof f.mode === "number") {
+                try {
+                    await fs.chmod(dest, f.mode);
+                }
+                catch {
+                    // ignore chmod errors
+                }
+            }
+        }
+        else {
+            if (await pathExists(dest)) {
+                await fs.rm(dest, { force: true });
+            }
+        }
+    }
+}
+//# sourceMappingURL=backup.js.map

package/dist/backup.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1 @@
+export declare function cliMain(argv: string[]): Promise<number>;