@cogineai/clawpacker 0.1.0 → 0.2.0

package/README.md

@@ -19,7 +19,7 @@ This is **template portability**, not full-instance backup.
 
 ## Status
 
-**Internal alpha.** The current CLI is usable for v1-style experiments, but the package format and UX should still be treated as early-stage.
+**Internal alpha.** The current CLI is usable for early experiments (package format v2), but the format and UX should still be treated as early-stage.
 
 Use it when you want to:
 
@@ -29,21 +29,19 @@ Use it when you want to:
 
 Do **not** treat it as a production-grade backup, archival, or disaster-recovery tool yet.
 
-## What Clawpacker does in v1
+## What Clawpacker does
 
 ### Included
 
-By default, Clawpacker exports the portable workspace files:
+Clawpacker uses a **blacklist model** — it includes all files in the workspace (including subdirectories) except those matching explicit exclusion rules.
 
-- `AGENTS.md`
-- `SOUL.md`
-- `IDENTITY.md`
-- `USER.md`
-- `TOOLS.md`
-- `MEMORY.md`
-- `HEARTBEAT.md` if present
+The following files are recognized as **bootstrap files** and flagged in the manifest:
 
-It also writes package metadata:
+`AGENTS.md`, `SOUL.md`, `IDENTITY.md`, `USER.md`, `TOOLS.md`, `MEMORY.md`, `HEARTBEAT.md`, `BOOTSTRAP.md`
+
+All other workspace files are included as well, preserving directory structure.
+
+The package also contains metadata:
 
 - `manifest.json`
 - `config/agent.json`
@@ -54,27 +52,38 @@ It also writes package metadata:
 
 ### Excluded
 
-Clawpacker intentionally excludes or avoids restoring:
+Clawpacker excludes the following subdirectories if they appear inside the workspace:
+
+- `.git`
+- `.openclaw`
+- `node_modules`
+
+And these file patterns:
 
 - `memory/*.md` daily logs
+
+These rules only apply to contents **within** the scanned workspace directory. The parent `~/.openclaw/` installation and its config files are not part of the workspace scan — OpenClaw config is read separately via `--config` or config discovery.
+
+Beyond file-level exclusions, Clawpacker never exports or restores:
+
 - secrets, auth state, cookies, API keys, credentials
 - session/runtime state
 - channel bindings / routing state
 - globally installed skills or extensions
 - machine-specific absolute-path behavior that is not portable
 
-### Skills model in v1
+### Skills model
 
 Skills are **manifest-only** right now.
 
-That means Clawpacker records detected skill references, but it does not bundle or install skill implementations for you.
+That means Clawpacker records detected skill references (using backtick-quoted references like `` `skill-name` ``), but it does not bundle or install skill implementations for you.
 
 ## Install
 
 ### Published package
 
 ```bash
-npm install -g clawpacker
+npm install -g @cogineai/clawpacker
 clawpacker --help
 ```
 
@@ -100,7 +109,7 @@ node dist/cli.js --help
 After building, the CLI exposes four commands:
 
 - `inspect` — analyze a workspace before packaging
-- `export` — write a `.ocpkg/` directory package
+- `export` — write a `.ocpkg/` directory or `.ocpkg.tar.gz` archive
 - `import` — restore a package into a target workspace
 - `validate` — verify an imported workspace target
 
@@ -143,10 +152,12 @@ What `inspect` tells you:
 - whether a portable agent definition could be derived
 - which fields are portable vs import-time inputs
 - which skills were detected
-- v1 warnings you should expect on export/import
+- warnings you should expect on export/import
 
 ### 2) Export a package
 
+Directory package:
+
 ```bash
 node dist/cli.js export \
   --workspace ./tests/fixtures/source-workspace \
@@ -155,7 +166,20 @@ node dist/cli.js export \
   --name supercoder-template
 ```
 
-Current output is JSON, for example:
+Single-file archive:
+
+```bash
+node dist/cli.js export \
+  --workspace ./tests/fixtures/source-workspace \
+  --config ./tests/fixtures/openclaw-config/source-config.jsonc \
+  --out ./tests/tmp/example-supercoder.ocpkg \
+  --name supercoder-template \
+  --archive
+```
+
+The `--archive` flag produces a `.ocpkg.tar.gz` file for easier transport.
+
+Output defaults to human-readable text. Add `--json` for machine-readable output:
 
 ```json
 {
@@ -168,6 +192,8 @@ Current output is JSON, for example:
 
 ### 3) Import a package
 
+Accepts both `.ocpkg/` directories and `.ocpkg.tar.gz` archives:
+
 ```bash
 node dist/cli.js import \
   ./tests/tmp/example-supercoder.ocpkg \
@@ -176,10 +202,21 @@ node dist/cli.js import \
   --config ./tests/tmp/target-openclaw-config.json
 ```
 
+Preview the import plan without writing anything:
+
+```bash
+node dist/cli.js import \
+  ./tests/tmp/example-supercoder.ocpkg \
+  --target-workspace ./tests/tmp/workspace-supercoder-imported \
+  --agent-id supercoder-imported \
+  --dry-run
+```
+
 Notes:
 
 - `--target-workspace` is required
 - `--agent-id` is strongly recommended and becomes required in practice for collision-safe import planning
+- `--dry-run` prints the import plan and exits without writing files
 - if the target workspace or target agent already exists, import blocks unless you pass `--force`
 - if no config is found, import can still restore workspace files, but config registration becomes limited
 
@@ -192,7 +229,7 @@ node dist/cli.js validate \
   --config ./tests/tmp/target-openclaw-config.json
 ```
 
-Current output is a JSON validation report with:
+Output defaults to human-readable text. Add `--json` for a structured report with:
 
 - `passed`
 - `warnings`
@@ -212,24 +249,23 @@ When you provide `--config`, or when import can discover a nearby OpenClaw confi
 
 ### Config discovery behavior
 
-If you do not pass `--config`, Clawpacker looks for a config in these places:
+Config is resolved in this order:
 
-- `./openclaw-config.json`
-- `./openclaw-config.jsonc`
-- `~/.openclaw/config.json`
-- `~/.openclaw/config.jsonc`
+1. explicit `--config` flag
+2. `OPENCLAW_CONFIG_PATH` environment variable
+3. `~/.openclaw/openclaw.json` (default)
 
 ### Portable config philosophy
 
 Clawpacker does **not** export raw OpenClaw config wholesale.
 
-Instead, it extracts a minimal, portable slice, such as:
+Instead, it extracts a portable slice of agent config, including:
 
-- suggested agent id
-- suggested display name
+- agent id and display name
 - workspace basename suggestion
 - identity name
 - default model, when present
+- tools, skills, heartbeat, sandbox, and runtime settings
 
 And it explicitly excludes things like:
 
@@ -243,8 +279,8 @@ Clawpacker is designed to be conservative.
 
 ### Export safety
 
-- only known portable workspace files are copied
-- daily memory logs are excluded by default
+- all workspace files are included except explicitly excluded directories and patterns
+- daily memory logs (`memory/*.md`) are excluded by default
 - package contents are declared in a manifest instead of hidden in opaque state
 - checksums are generated for integrity verification
 
@@ -267,7 +303,7 @@ Even after a successful import, you should still:
 
 ## Package structure
 
-A typical v1 package looks like this:
+A typical package looks like this:
 
 ```text
 supercoder-template.ocpkg/
@@ -280,6 +316,9 @@ supercoder-template.ocpkg/
     TOOLS.md
     MEMORY.md
     HEARTBEAT.md
+    custom-prompts/
+      review.md
+    ...                     # any other workspace files
   config/
     agent.json
     import-hints.json
@@ -289,34 +328,33 @@ supercoder-template.ocpkg/
     export-report.json
 ```
 
-## What is intentionally out of scope in v1
+The `workspace/` directory mirrors the source workspace structure. All non-excluded files are included, so the contents vary depending on what lives in the source workspace.
+
+Packages can also be distributed as single-file `.ocpkg.tar.gz` archives.
+
+## What is intentionally out of scope
 
 - full OpenClaw instance backup
 - secret migration
 - auth/session migration
 - channel binding export/import
 - packaging globally installed skill implementations
-- archive transport formats beyond the current directory package flow
 - zero-touch import across mismatched environments
 
 ## Roadmap / known limitations
 
 Near-term likely improvements:
 
-- publishable npm package + stable binary release
-- friendlier non-JSON output for `export`, `import`, and `validate`
-- optional archive packaging for transport
 - richer import guidance when models or skills are missing
 - optional packaging for workspace-local skill folders
 - better package compatibility/version negotiation
 
 Current limitations to be aware of:
 
-- package format should still be treated as alpha
+- package format should still be treated as early-stage (currently v2)
 - skills are detected, but not bundled
 - import assumes conservative file-level replacement semantics via `--force`
 - OpenClaw config support is minimal by design
-- examples currently assume local source usage, not a published global install
 
 ## Development
 
@@ -359,7 +397,7 @@ npm test
 
 ## Naming
 
-The npm package name is **`clawpacker`** while the GitHub repository remains **`cogine-ai/clawpack`**.
+The npm package name is **`@cogineai/clawpacker`** while the GitHub repository remains **`cogine-ai/clawpack`**.
 
 Why this naming split:
 

package/dist/cli.js

@@ -6,6 +6,7 @@ const export_1 = require("./commands/export");
 const import_1 = require("./commands/import");
 const inspect_1 = require("./commands/inspect");
 const validate_1 = require("./commands/validate");
+const renderable_cli_error_1 = require("./renderable-cli-error");
 const program = new commander_1.Command();
 program
     .name('clawpacker')
@@ -16,7 +17,15 @@ program
 (0, import_1.registerImportCommand)(program.command('import'));
 (0, validate_1.registerValidateCommand)(program.command('validate'));
 program.parseAsync(process.argv).catch((error) => {
-    console.error(error);
+    if ((0, renderable_cli_error_1.isRenderableCliError)(error)) {
+        console.error(error.render());
+    }
+    else if (error instanceof Error) {
+        console.error(error.message);
+    }
+    else {
+        console.error(String(error));
+    }
     process.exitCode = 1;
 });
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AACpC,8CAA0D;AAC1D,8CAA0D;AAC1D,gDAA4D;AAC5D,kDAA8D;AAE9D,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,2EAA2E,CAAC;KACxF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,IAAA,gCAAsB,EAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AACnD,IAAA,8BAAqB,EAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjD,IAAA,8BAAqB,EAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjD,IAAA,kCAAuB,EAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;AAErD,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AACpC,8CAA0D;AAC1D,8CAA0D;AAC1D,gDAA4D;AAC5D,kDAA8D;AAC9D,iEAA8D;AAE9D,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CAAC,2EAA2E,CAAC;KACxF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,IAAA,gCAAsB,EAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AACnD,IAAA,8BAAqB,EAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjD,IAAA,8BAAqB,EAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AACjD,IAAA,kCAAuB,EAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;AAErD,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IACxD,IAAI,IAAA,2CAAoB,EAAC,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAChC,CAAC;SAAM,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/commands/export.d.ts

@@ -5,6 +5,8 @@ interface ExportOptions {
     name?: string;
     config?: string;
     agentId?: string;
+    archive?: boolean;
+    json?: boolean;
 }
 export declare function runExport(options: ExportOptions): Promise<void>;
 export declare function registerExportCommand(command: Command): void;

package/dist/commands/export.js

@@ -7,6 +7,7 @@ exports.runExport = runExport;
 exports.registerExportCommand = registerExportCommand;
 const node_path_1 = __importDefault(require("node:path"));
 const agent_extract_1 = require("../core/agent-extract");
+const openclaw_config_1 = require("../core/openclaw-config");
 const package_write_1 = require("../core/package-write");
 const skills_detect_1 = require("../core/skills-detect");
 const workspace_scan_1 = require("../core/workspace-scan");
@@ -20,29 +21,49 @@ async function runExport(options) {
         configPath: options.config,
         agentId: options.agentId,
     });
-    const packageName = options.name ?? node_path_1.default.basename(options.out).replace(/\.ocpkg$/, '');
-    const result = await (0, package_write_1.writePackageDirectory)({
+    const openclawVersion = await (0, openclaw_config_1.detectOpenClawVersion)({
+        configPath: options.config,
+        cwd: scan.workspacePath,
+    });
+    const packageName = options.name ?? node_path_1.default.basename(options.out).replace(/\.ocpkg(\.tar\.gz)?$/, '');
+    const writeParams = {
         outputPath: node_path_1.default.resolve(options.out),
         packageName,
         scan,
         skills,
         agentDefinition,
-    });
-    console.log(JSON.stringify({
+        openclawVersion,
+    };
+    const result = options.archive
+        ? await (0, package_write_1.writePackageArchive)(writeParams)
+        : await (0, package_write_1.writePackageDirectory)(writeParams);
+    const report = {
         status: 'ok',
         packageRoot: result.packageRoot,
         manifestPath: result.manifestPath,
         fileCount: result.fileCount,
-    }, null, 2));
+    };
+    if (options.json) {
+        console.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    console.log([
+        'Export complete',
+        `  Package: ${report.packageRoot}`,
+        `  Manifest: ${report.manifestPath}`,
+        `  Files: ${report.fileCount}`,
+    ].join('\n'));
 }
 function registerExportCommand(command) {
     command
-        .description('Export a portable .ocpkg directory from a workspace.')
+        .description('Export a portable .ocpkg directory or .ocpkg.tar.gz archive from a workspace.')
         .requiredOption('--workspace <path>', 'Source workspace path')
-        .requiredOption('--out <path>', 'Output package directory path')
+        .requiredOption('--out <path>', 'Output package path')
         .option('--name <package-name>', 'Package name override')
         .option('--config <path>', 'OpenClaw config path')
         .option('--agent-id <id>', 'Source agent id override')
+        .option('--archive', 'Produce a .ocpkg.tar.gz single-file archive')
+        .option('--json', 'Emit the full machine-readable JSON report')
         .action(runExport);
 }
 //# sourceMappingURL=export.js.map

package/dist/commands/export.js.map

@@ -1 +1 @@
-{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":";;;;;AAeA,8BAiCC;AAED,sDASC;AA3DD,0DAA6B;AAE7B,yDAA+D;AAC/D,yDAA8D;AAC9D,yDAAqD;AACrD,2DAAuD;AAUhD,KAAK,UAAU,SAAS,CAAC,OAAsB;IACpD,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,IAAA,8BAAa,EAAC,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,IAAA,4BAAY,EAAC,IAAI,CAAC,CAAC;IACxC,MAAM,eAAe,GAAG,MAAM,IAAA,sCAAsB,EAAC,IAAI,CAAC,aAAa,EAAE;QACvE,UAAU,EAAE,OAAO,CAAC,MAAM;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC;IACH,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,IAAI,mBAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAEvF,MAAM,MAAM,GAAG,MAAM,IAAA,qCAAqB,EAAC;QACzC,UAAU,EAAE,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;QACrC,WAAW;QACX,IAAI;QACJ,MAAM;QACN,eAAe;KAChB,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;QACE,MAAM,EAAE,IAAI;QACZ,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;AACJ,CAAC;AAED,SAAgB,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,WAAW,CAAC,sDAAsD,CAAC;SACnE,cAAc,CAAC,oBAAoB,EAAE,uBAAuB,CAAC;SAC7D,cAAc,CAAC,cAAc,EAAE,+BAA+B,CAAC;SAC/D,MAAM,CAAC,uBAAuB,EAAE,uBAAuB,CAAC;SACxD,MAAM,CAAC,iBAAiB,EAAE,sBAAsB,CAAC;SACjD,MAAM,CAAC,iBAAiB,EAAE,0BAA0B,CAAC;SACrD,MAAM,CAAC,SAAS,CAAC,CAAC;AACvB,CAAC"}
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":";;;;;AAkBA,8BAmDC;AAED,sDAWC;AAlFD,0DAA6B;AAE7B,yDAA+D;AAC/D,6DAAgE;AAChE,yDAAmF;AACnF,yDAAqD;AACrD,2DAAuD;AAYhD,KAAK,UAAU,SAAS,CAAC,OAAsB;IACpD,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,IAAA,8BAAa,EAAC,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,IAAA,4BAAY,EAAC,IAAI,CAAC,CAAC;IACxC,MAAM,eAAe,GAAG,MAAM,IAAA,sCAAsB,EAAC,IAAI,CAAC,aAAa,EAAE;QACvE,UAAU,EAAE,OAAO,CAAC,MAAM;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC;IACH,MAAM,eAAe,GAAG,MAAM,IAAA,uCAAqB,EAAC;QAClD,UAAU,EAAE,OAAO,CAAC,MAAM;QAC1B,GAAG,EAAE,IAAI,CAAC,aAAa;KACxB,CAAC,CAAC;IACH,MAAM,WAAW,GACf,OAAO,CAAC,IAAI,IAAI,mBAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC,CAAC;IAEjF,MAAM,WAAW,GAAG;QAClB,UAAU,EAAE,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC;QACrC,WAAW;QACX,IAAI;QACJ,MAAM;QACN,eAAe;QACf,eAAe;KAChB,CAAC;IAEF,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO;QAC5B,CAAC,CAAC,MAAM,IAAA,mCAAmB,EAAC,WAAW,CAAC;QACxC,CAAC,CAAC,MAAM,IAAA,qCAAqB,EAAC,WAAW,CAAC,CAAC;IAE7C,MAAM,MAAM,GAAG;QACb,MAAM,EAAE,IAAa;QACrB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC;IAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CACT;QACE,iBAAiB;QACjB,cAAc,MAAM,CAAC,WAAW,EAAE;QAClC,eAAe,MAAM,CAAC,YAAY,EAAE;QACpC,YAAY,MAAM,CAAC,SAAS,EAAE;KAC/B,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;AACJ,CAAC;AAED,SAAgB,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,WAAW,CAAC,+EAA+E,CAAC;SAC5F,cAAc,CAAC,oBAAoB,EAAE,uBAAuB,CAAC;SAC7D,cAAc,CAAC,cAAc,EAAE,qBAAqB,CAAC;SACrD,MAAM,CAAC,uBAAuB,EAAE,uBAAuB,CAAC;SACxD,MAAM,CAAC,iBAAiB,EAAE,sBAAsB,CAAC;SACjD,MAAM,CAAC,iBAAiB,EAAE,0BAA0B,CAAC;SACrD,MAAM,CAAC,WAAW,EAAE,6CAA6C,CAAC;SAClE,MAAM,CAAC,QAAQ,EAAE,4CAA4C,CAAC;SAC9D,MAAM,CAAC,SAAS,CAAC,CAAC;AACvB,CAAC"}

package/dist/commands/import.d.ts

@@ -4,6 +4,8 @@ interface ImportOptions {
     agentId?: string;
     config?: string;
     force?: boolean;
+    json?: boolean;
+    dryRun?: boolean;
 }
 export declare function runImport(packagePath: string, options: ImportOptions): Promise<void>;
 export declare function registerImportCommand(command: Command): void;

package/dist/commands/import.js

@@ -10,33 +10,129 @@ const import_exec_1 = require("../core/import-exec");
 const openclaw_config_1 = require("../core/openclaw-config");
 const import_plan_1 = require("../core/import-plan");
 const package_read_1 = require("../core/package-read");
+const renderable_cli_error_1 = require("../renderable-cli-error");
+const output_1 = require("../utils/output");
+class ImportBlockedError extends Error {
+    report;
+    asJson;
+    [renderable_cli_error_1.renderableCliErrorBrand] = true;
+    constructor(report, asJson) {
+        super(formatBlockedImportReport(report));
+        this.report = report;
+        this.asJson = asJson;
+        this.name = 'ImportBlockedError';
+    }
+    render() {
+        return this.asJson
+            ? JSON.stringify(this.report, null, 2)
+            : this.message;
+    }
+}
+function formatRequiredInputKey(key) {
+    if (key === 'agentId') {
+        return '--agent-id';
+    }
+    if (key === 'targetWorkspacePath') {
+        return '--target-workspace';
+    }
+    return key;
+}
+function formatBlockedImportReport(report) {
+    const { summary } = report.writePlan;
+    const lines = ['Import blocked'];
+    (0, output_1.pushSection)(lines, 'Blocked by', report.failed);
+    (0, output_1.pushSection)(lines, 'Required inputs', report.requiredInputs.map((item) => `${formatRequiredInputKey(item.key)}: ${item.reason}`));
+    (0, output_1.pushSection)(lines, 'Warnings', report.warnings);
+    (0, output_1.pushSection)(lines, 'Next steps', report.nextSteps);
+    lines.push('', 'Planned import:', `- target workspace: ${report.writePlan.targetWorkspacePath}`, `- target agent id: ${report.writePlan.targetAgentId ?? 'not set'}`, `- workspace files: ${summary.fileCount}`);
+    if (report.writePlan.targetConfigPath) {
+        lines.push(`- target config: ${report.writePlan.targetConfigPath}`);
+    }
+    if (summary.existingWorkspaceDetected) {
+        lines.push('- existing workspace detected: yes');
+    }
+    if (summary.configAgentCollision) {
+        lines.push('- target config agent collision detected: yes');
+    }
+    return lines.join('\n');
+}
+function formatDryRunImportReport(report) {
+    const { summary } = report.writePlan;
+    const lines = ['Import dry run'];
+    (0, output_1.pushSection)(lines, 'Warnings', report.warnings);
+    (0, output_1.pushSection)(lines, 'Next steps', report.nextSteps);
+    lines.push('', 'Planned import:', `- target workspace: ${report.writePlan.targetWorkspacePath}`, `- target agent id: ${report.writePlan.targetAgentId ?? 'not set'}`, `- workspace files: ${summary.fileCount}`);
+    if (report.writePlan.targetConfigPath) {
+        lines.push(`- target config: ${report.writePlan.targetConfigPath}`);
+    }
+    if (summary.existingWorkspaceDetected) {
+        lines.push('- existing workspace detected: yes');
+    }
+    if (summary.configAgentCollision) {
+        lines.push('- target config agent collision detected: yes');
+    }
+    return lines.join('\n');
+}
 async function runImport(packagePath, options) {
     if (!packagePath || !options.targetWorkspace) {
         throw new Error('import requires <package-path> and --target-workspace <path>');
     }
-    const pkg = await (0, package_read_1.readPackageDirectory)(node_path_1.default.resolve(packagePath));
-    const configPath = options.config
-        ? node_path_1.default.resolve(options.config)
-        : (await (0, openclaw_config_1.discoverOpenClawConfig)({ cwd: node_path_1.default.resolve(options.targetWorkspace) }).catch(() => undefined))?.configPath;
-    const plan = await (0, import_plan_1.planImport)({
-        pkg,
-        targetWorkspacePath: node_path_1.default.resolve(options.targetWorkspace),
-        targetAgentId: options.agentId,
-        targetConfigPath: configPath,
-        force: options.force,
-    });
-    if (!plan.canProceed) {
-        throw new Error(JSON.stringify({
-            status: 'blocked',
-            failed: plan.failed,
-            requiredInputs: plan.requiredInputs,
-            warnings: plan.warnings,
-            nextSteps: plan.nextSteps,
-            writePlan: plan.writePlan,
-        }, null, 2));
-    }
-    const result = await (0, import_exec_1.executeImport)({ pkg, plan });
-    console.log(JSON.stringify(result, null, 2));
+    let tempDir;
+    try {
+        const pkg = await (0, package_read_1.readPackage)(node_path_1.default.resolve(packagePath), {
+            onTempDir(dir) { tempDir = dir; },
+        });
+        const configPath = options.config
+            ? node_path_1.default.resolve(options.config)
+            : (await (0, openclaw_config_1.discoverOpenClawConfig)({ cwd: node_path_1.default.resolve(options.targetWorkspace) }).catch(() => undefined))?.configPath;
+        const plan = await (0, import_plan_1.planImport)({
+            pkg,
+            targetWorkspacePath: node_path_1.default.resolve(options.targetWorkspace),
+            targetAgentId: options.agentId,
+            targetConfigPath: configPath,
+            force: options.force,
+        });
+        if (!plan.canProceed) {
+            throw new ImportBlockedError({
+                status: 'blocked',
+                failed: plan.failed,
+                requiredInputs: plan.requiredInputs,
+                warnings: plan.warnings,
+                nextSteps: plan.nextSteps,
+                writePlan: plan.writePlan,
+            }, options.json === true);
+        }
+        if (options.dryRun) {
+            const report = {
+                status: 'dry-run',
+                warnings: plan.warnings,
+                nextSteps: plan.nextSteps,
+                writePlan: plan.writePlan,
+            };
+            console.log(options.json ? JSON.stringify(report, null, 2) : formatDryRunImportReport(report));
+            return;
+        }
+        const result = await (0, import_exec_1.executeImport)({ pkg, plan });
+        if (options.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        const lines = [
+            'Import complete',
+            `  Workspace: ${result.targetWorkspacePath}`,
+            `  Agent id: ${result.agentId}`,
+            `  Imported files: ${result.importedFiles.length}`,
+            `  Metadata files: ${result.metadataFiles.length}`,
+        ];
+        (0, output_1.pushSection)(lines, 'Warnings', result.warnings);
+        (0, output_1.pushSection)(lines, 'Next steps', result.nextSteps);
+        console.log(lines.join('\n'));
+    }
+    finally {
+        if (tempDir) {
+            await (0, package_read_1.cleanupTempDir)(tempDir);
+        }
+    }
 }
 function registerImportCommand(command) {
     command
@@ -46,6 +142,8 @@ function registerImportCommand(command) {
         .option('--agent-id <id>', 'Target agent id override')
         .option('--config <path>', 'Target OpenClaw config path')
         .option('--force', 'Overwrite an existing target workspace')
+        .option('--dry-run', 'Print the import plan and exit without writing files')
+        .option('--json', 'Emit the full machine-readable JSON report')
         .action(runImport);
 }
 //# sourceMappingURL=import.js.map

package/dist/commands/import.js.map

@@ -1 +1 @@
-{"version":3,"file":"import.js","sourceRoot":"","sources":["../../src/commands/import.ts"],"names":[],"mappings":";;;;;AAcA,8BA+BC;AAED,sDASC;AAxDD,0DAA6B;AAE7B,qDAAoD;AACpD,6DAAiE;AACjE,qDAAiD;AACjD,uDAA4D;AASrD,KAAK,UAAU,SAAS,CAAC,WAAmB,EAAE,OAAsB;IACzE,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,IAAA,mCAAoB,EAAC,mBAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM;QAC/B,CAAC,CAAC,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;QAC9B,CAAC,CAAC,CAAC,MAAM,IAAA,wCAAsB,EAAC,EAAE,GAAG,EAAE,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC;IAEtH,MAAM,IAAI,GAAG,MAAM,IAAA,wBAAU,EAAC;QAC5B,GAAG;QACH,mBAAmB,EAAE,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,eAAe,CAAC;QAC1D,aAAa,EAAE,OAAO,CAAC,OAAO;QAC9B,gBAAgB,EAAE,UAAU;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;KACrB,CAAC,CAAC;IAEH,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;YAC7B,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,cAAc,EAAE,IAAI,CAAC,cAAc;YACnC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACf,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,IAAA,2BAAa,EAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,SAAgB,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,WAAW,CAAC,6DAA6D,CAAC;SAC1E,QAAQ,CAAC,gBAAgB,EAAE,iCAAiC,CAAC;SAC7D,cAAc,CAAC,2BAA2B,EAAE,uBAAuB,CAAC;SACpE,MAAM,CAAC,iBAAiB,EAAE,0BAA0B,CAAC;SACrD,MAAM,CAAC,iBAAiB,EAAE,6BAA6B,CAAC;SACxD,MAAM,CAAC,SAAS,EAAE,wCAAwC,CAAC;SAC3D,MAAM,CAAC,SAAS,CAAC,CAAC;AACvB,CAAC"}
+{"version":3,"file":"import.js","sourceRoot":"","sources":["../../src/commands/import.ts"],"names":[],"mappings":"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"}

package/dist/commands/inspect.js

@@ -21,15 +21,16 @@ async function runInspect(options) {
         agentId: options.agentId,
     });
     const warnings = [
-        'Channel bindings are not included in v1 packages.',
         'Skills are manifest-only and may require manual installation.',
     ];
+    const bootstrapFiles = scan.includedFiles
+        .filter((f) => f.isBootstrap)
+        .map((f) => f.relativePath);
     const report = {
         workspacePath,
         includedFiles: scan.includedFiles.map((file) => file.relativePath),
+        bootstrapFiles,
         excludedFiles: scan.excludedFiles,
-        ignoredFiles: scan.ignoredFiles,
-        missingOptionalFiles: scan.missingOptionalFiles,
         portableConfig: {
             found: !agentDefinition.notes.some((note) => note.includes('placeholder')),
             agent: agentDefinition.agent,
@@ -47,9 +48,8 @@ async function runInspect(options) {
     const lines = [
         `Workspace: ${report.workspacePath}`,
         `Included files (${report.includedFiles.length}): ${report.includedFiles.join(', ') || 'none'}`,
+        `Bootstrap files (${report.bootstrapFiles.length}): ${report.bootstrapFiles.join(', ') || 'none'}`,
         `Excluded files (${report.excludedFiles.length}): ${report.excludedFiles.map((entry) => `${entry.relativePath} [${entry.reason}]`).join(', ') || 'none'}`,
-        `Ignored files (${report.ignoredFiles.length}): ${report.ignoredFiles.join(', ') || 'none'}`,
-        `Missing optional files (${report.missingOptionalFiles.length}): ${report.missingOptionalFiles.join(', ') || 'none'}`,
         'Portable agent definition:',
         `  found: ${report.portableConfig.found ? 'yes' : 'no'}`,
         `  suggested id: ${report.portableConfig.agent.suggestedId}`,
@@ -57,7 +57,9 @@ async function runInspect(options) {
         `  workspace basename: ${report.portableConfig.agent.workspace.suggestedBasename}`,
         `  identity name: ${report.portableConfig.agent.identity.name}`,
         `  default model: ${report.portableConfig.agent.model?.default ?? 'not set'}`,
-        `  portable fields: ${Object.entries(report.portableConfig.fieldClassification).map(([key, value]) => `${key}=${value}`).join(', ')}`,
+        `  portable fields: ${Object.entries(report.portableConfig.fieldClassification)
+            .map(([key, value]) => `${key}=${value}`)
+            .join(', ')}`,
         `Skills (workspace): ${skills.workspaceSkills.join(', ') || 'none'}`,
         `Skills (referenced): ${skills.referencedSkills.join(', ') || 'none'}`,
         `Skill notes: ${skills.notes.join(' | ') || 'none'}`,
@@ -70,7 +72,7 @@ async function runInspect(options) {
 }
 function registerInspectCommand(command) {
     command
-        .description('Inspect a workspace and report what is portable in v1.')
+        .description('Inspect a workspace and report what is portable.')
         .requiredOption('--workspace <path>', 'Source workspace path')
         .option('--config <path>', 'OpenClaw config path')
         .option('--agent-id <id>', 'Source agent id override')

package/dist/commands/inspect.js.map

@@ -1 +1 @@
-{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../src/commands/inspect.ts"],"names":[],"mappings":";;;;;AAaA,gCAiEC;AAED,wDAQC;AAxFD,0DAA6B;AAE7B,yDAA+D;AAC/D,yDAAqD;AACrD,2DAAuD;AAShD,KAAK,UAAU,UAAU,CAAC,OAAuB;IACtD,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,MAAM,aAAa,GAAG,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,MAAM,IAAA,8BAAa,EAAC,aAAa,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,IAAA,4BAAY,EAAC,IAAI,CAAC,CAAC;IACxC,MAAM,eAAe,GAAG,MAAM,IAAA,sCAAsB,EAAC,aAAa,EAAE;QAClE,UAAU,EAAE,OAAO,CAAC,MAAM;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG;QACf,mDAAmD;QACnD,+DAA+D;KAChE,CAAC;IAEF,MAAM,MAAM,GAAG;QACb,aAAa;QACb,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC;QAClE,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;QAC/C,cAAc,EAAE;YACd,KAAK,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;YAC1E,KAAK,EAAE,eAAe,CAAC,KAAK;YAC5B,mBAAmB,EAAE,eAAe,CAAC,mBAAmB;YACxD,KAAK,EAAE,eAAe,CAAC,KAAK;SAC7B;QACD,MAAM;QACN,QAAQ;QACR,MAAM,EAAE,EAAE;KACX,CAAC;IAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,cAAc,MAAM,CAAC,aAAa,EAAE;QACpC,mBAAmB,MAAM,CAAC,aAAa,CAAC,MAAM,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE;QAC/F,mBAAmB,MAAM,CAAC,aAAa,CAAC,MAAM,MAAM,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,YAAY,KAAK,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE;QACzJ,kBAAkB,MAAM,CAAC,YAAY,CAAC,MAAM,MAAM,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE;QAC5F,2BAA2B,MAAM,CAAC,oBAAoB,CAAC,MAAM,MAAM,MAAM,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE;QACrH,4BAA4B;QAC5B,YAAY,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QACxD,mBAAmB,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,WAAW,EAAE;QAC5D,qBAAqB,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,aAAa,EAAE;QAChE,yBAAyB,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,iBAAiB,EAAE;QAClF,oBAAoB,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE;QAC/D,oBAAoB,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,IAAI,SAAS,EAAE;QAC7E,sBAAsB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACrI,uBAAuB,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE;QACpE,wBAAwB,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE;QACtE,gBAAgB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,EAAE;QACpD,aAAa,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,EAAE;KAC9C,CAAC;IAEF,IAAI,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,0BAA0B,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,SAAgB,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,WAAW,CAAC,wDAAwD,CAAC;SACrE,cAAc,CAAC,oBAAoB,EAAE,uBAAuB,CAAC;SAC7D,MAAM,CAAC,iBAAiB,EAAE,sBAAsB,CAAC;SACjD,MAAM,CAAC,iBAAiB,EAAE,0BAA0B,CAAC;SACrD,MAAM,CAAC,QAAQ,EAAE,4CAA4C,CAAC;SAC9D,MAAM,CAAC,UAAU,CAAC,CAAC;AACxB,CAAC"}
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../src/commands/inspect.ts"],"names":[],"mappings":"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"}