@cogineai/clawpacker 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cogine AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,373 @@
+# Clawpacker
+
+> Portable OpenClaw agent/workspace templates for sharing, cloning, and rehydrating on another instance.
+
+Clawpacker is a small TypeScript CLI for exporting the portable parts of an OpenClaw agent workspace into a declarative package, then importing that package into another OpenClaw setup.
+
+## Why this exists
+
+OpenClaw agents often live inside a workspace with persona files, conventions, and a bit of agent config glue. Recreating that setup by hand is annoying, error-prone, and easy to drift.
+
+Clawpacker focuses on the reusable part of that problem:
+
+- capture the workspace files that define an agent's behavior
+- extract a portable slice of agent config
+- restore that template somewhere else
+- clearly tell you what still needs manual setup
+
+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.
+
+Use it when you want to:
+
+- package an existing OpenClaw workspace as a reusable template
+- move a persona/operator setup between instances with minimal manual work
+- validate what was imported
+
+Do **not** treat it as a production-grade backup, archival, or disaster-recovery tool yet.
+
+## What Clawpacker does in v1
+
+### Included
+
+By default, Clawpacker exports the portable workspace files:
+
+- `AGENTS.md`
+- `SOUL.md`
+- `IDENTITY.md`
+- `USER.md`
+- `TOOLS.md`
+- `MEMORY.md`
+- `HEARTBEAT.md` if present
+
+It also writes package metadata:
+
+- `manifest.json`
+- `config/agent.json`
+- `config/import-hints.json`
+- `config/skills-manifest.json`
+- `meta/checksums.json`
+- `meta/export-report.json`
+
+### Excluded
+
+Clawpacker intentionally excludes or avoids restoring:
+
+- `memory/*.md` daily logs
+- 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 are **manifest-only** right now.
+
+That means Clawpacker records detected skill references, but it does not bundle or install skill implementations for you.
+
+## Install
+
+### Published package
+
+```bash
+npm install -g clawpacker
+clawpacker --help
+```
+
+### From source
+
+```bash
+npm install
+npm run build
+```
+
+Run the built CLI:
+
+```bash
+node dist/cli.js --help
+```
+
+### Node requirement
+
+- Node.js `>= 20`
+
+## Command overview
+
+After building, the CLI exposes four commands:
+
+- `inspect` — analyze a workspace before packaging
+- `export` — write a `.ocpkg/` directory package
+- `import` — restore a package into a target workspace
+- `validate` — verify an imported workspace target
+
+If you install the published package, the CLI command is:
+
+```bash
+clawpacker
+```
+
+For local source usage, you can still run:
+
+```bash
+node dist/cli.js
+```
+
+## Usage
+
+### 1) Inspect a source workspace
+
+Human-readable report:
+
+```bash
+node dist/cli.js inspect \
+  --workspace ./tests/fixtures/source-workspace
+```
+
+Machine-readable JSON report:
+
+```bash
+node dist/cli.js inspect \
+  --workspace ./tests/fixtures/source-workspace \
+  --config ./tests/fixtures/openclaw-config/source-config.jsonc \
+  --json
+```
+
+What `inspect` tells you:
+
+- which workspace files are included
+- which files are excluded or ignored
+- 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
+
+### 2) Export a package
+
+```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
+```
+
+Current output is JSON, for example:
+
+```json
+{
+  "status": "ok",
+  "packageRoot": ".../example-supercoder.ocpkg",
+  "manifestPath": ".../example-supercoder.ocpkg/manifest.json",
+  "fileCount": 12
+}
+```
+
+### 3) Import a package
+
+```bash
+node dist/cli.js import \
+  ./tests/tmp/example-supercoder.ocpkg \
+  --target-workspace ./tests/tmp/workspace-supercoder-imported \
+  --agent-id supercoder-imported \
+  --config ./tests/tmp/target-openclaw-config.json
+```
+
+Notes:
+
+- `--target-workspace` is required
+- `--agent-id` is strongly recommended and becomes required in practice for collision-safe import planning
+- 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
+
+### 4) Validate the imported result
+
+```bash
+node dist/cli.js validate \
+  --target-workspace ./tests/tmp/workspace-supercoder-imported \
+  --agent-id supercoder-imported \
+  --config ./tests/tmp/target-openclaw-config.json
+```
+
+Current output is a JSON validation report with:
+
+- `passed`
+- `warnings`
+- `failed`
+- `nextSteps`
+
+## OpenClaw config awareness
+
+Clawpacker is OpenClaw-aware, but intentionally narrow.
+
+When you provide `--config`, or when import can discover a nearby OpenClaw config, Clawpacker can:
+
+- derive a portable agent definition from an existing config entry
+- classify config fields as portable, excluded, or requiring import-time input
+- upsert the imported agent into the target OpenClaw config
+- validate that the imported workspace path matches the target config entry
+
+### Config discovery behavior
+
+If you do not pass `--config`, Clawpacker looks for a config in these places:
+
+- `./openclaw-config.json`
+- `./openclaw-config.jsonc`
+- `~/.openclaw/config.json`
+- `~/.openclaw/config.jsonc`
+
+### Portable config philosophy
+
+Clawpacker does **not** export raw OpenClaw config wholesale.
+
+Instead, it extracts a minimal, portable slice, such as:
+
+- suggested agent id
+- suggested display name
+- workspace basename suggestion
+- identity name
+- default model, when present
+
+And it explicitly excludes things like:
+
+- channel bindings
+- secrets
+- provider/account-specific runtime state
+
+## Safety model
+
+Clawpacker is designed to be conservative.
+
+### Export safety
+
+- only known portable workspace files are copied
+- daily memory logs are excluded by default
+- package contents are declared in a manifest instead of hidden in opaque state
+- checksums are generated for integrity verification
+
+### Import safety
+
+- import is planned before it executes
+- existing workspace collisions block by default
+- existing config agent collisions block by default
+- `--force` is required to overwrite existing targets
+- import writes local metadata so validation can confirm what happened later
+
+### Post-import safety expectations
+
+Even after a successful import, you should still:
+
+- review `USER.md`, `TOOLS.md`, and `MEMORY.md`
+- reinstall any required skills manually
+- recreate channel bindings manually
+- verify model/provider availability on the target instance
+
+## Package structure
+
+A typical v1 package looks like this:
+
+```text
+supercoder-template.ocpkg/
+  manifest.json
+  workspace/
+    AGENTS.md
+    SOUL.md
+    IDENTITY.md
+    USER.md
+    TOOLS.md
+    MEMORY.md
+    HEARTBEAT.md
+  config/
+    agent.json
+    import-hints.json
+    skills-manifest.json
+  meta/
+    checksums.json
+    export-report.json
+```
+
+## What is intentionally out of scope in v1
+
+- 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
+- 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
+
+Install dependencies:
+
+```bash
+npm install
+```
+
+Build:
+
+```bash
+npm run build
+```
+
+Run tests:
+
+```bash
+npm test
+```
+
+Run the CLI directly in dev:
+
+```bash
+npm run dev -- --help
+```
+
+## Verifying the examples locally
+
+A practical smoke path is:
+
+```bash
+npm run build
+node dist/cli.js inspect --workspace ./tests/fixtures/source-workspace --json
+node dist/cli.js export --workspace ./tests/fixtures/source-workspace --out ./tests/tmp/readme-demo.ocpkg
+node dist/cli.js import ./tests/tmp/readme-demo.ocpkg --target-workspace ./tests/tmp/readme-demo-target --agent-id readme-demo
+node dist/cli.js validate --target-workspace ./tests/tmp/readme-demo-target --agent-id readme-demo
+npm test
+```
+
+## Naming
+
+The npm package name is **`clawpacker`** while the GitHub repository remains **`cogine-ai/clawpack`**.
+
+Why this naming split:
+
+- short and memorable
+- feels native to the OpenClaw ecosystem
+- communicates portability/transport clearly
+- keeps the repository path stable while making the published package name explicit
+
+---
+
+If you are evaluating this repo for internal alpha use: treat it as a practical portability prototype with a conservative safety model, not as a finished backup product.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+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 program = new commander_1.Command();
+program
+    .name('clawpacker')
+    .description('Export, import, and validate portable OpenClaw agent/workspace templates.')
+    .version('0.1.0');
+(0, inspect_1.registerInspectCommand)(program.command('inspect'));
+(0, export_1.registerExportCommand)(program.command('export'));
+(0, import_1.registerImportCommand)(program.command('import'));
+(0, validate_1.registerValidateCommand)(program.command('validate'));
+program.parseAsync(process.argv).catch((error) => {
+    console.error(error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +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"}

package/dist/commands/export.d.ts

@@ -0,0 +1,11 @@
+import type { Command } from 'commander';
+interface ExportOptions {
+    workspace: string;
+    out: string;
+    name?: string;
+    config?: string;
+    agentId?: string;
+}
+export declare function runExport(options: ExportOptions): Promise<void>;
+export declare function registerExportCommand(command: Command): void;
+export {};

package/dist/commands/export.js

@@ -0,0 +1,48 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runExport = runExport;
+exports.registerExportCommand = registerExportCommand;
+const node_path_1 = __importDefault(require("node:path"));
+const agent_extract_1 = require("../core/agent-extract");
+const package_write_1 = require("../core/package-write");
+const skills_detect_1 = require("../core/skills-detect");
+const workspace_scan_1 = require("../core/workspace-scan");
+async function runExport(options) {
+    if (!options.workspace || !options.out) {
+        throw new Error('export requires --workspace <path> and --out <path>');
+    }
+    const scan = await (0, workspace_scan_1.scanWorkspace)(node_path_1.default.resolve(options.workspace));
+    const skills = await (0, skills_detect_1.detectSkills)(scan);
+    const agentDefinition = await (0, agent_extract_1.extractAgentDefinition)(scan.workspacePath, {
+        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)({
+        outputPath: node_path_1.default.resolve(options.out),
+        packageName,
+        scan,
+        skills,
+        agentDefinition,
+    });
+    console.log(JSON.stringify({
+        status: 'ok',
+        packageRoot: result.packageRoot,
+        manifestPath: result.manifestPath,
+        fileCount: result.fileCount,
+    }, null, 2));
+}
+function registerExportCommand(command) {
+    command
+        .description('Export a portable .ocpkg directory from a workspace.')
+        .requiredOption('--workspace <path>', 'Source workspace path')
+        .requiredOption('--out <path>', 'Output package directory path')
+        .option('--name <package-name>', 'Package name override')
+        .option('--config <path>', 'OpenClaw config path')
+        .option('--agent-id <id>', 'Source agent id override')
+        .action(runExport);
+}
+//# sourceMappingURL=export.js.map

package/dist/commands/export.js.map

@@ -0,0 +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"}

package/dist/commands/import.d.ts

@@ -0,0 +1,10 @@
+import type { Command } from 'commander';
+interface ImportOptions {
+    targetWorkspace: string;
+    agentId?: string;
+    config?: string;
+    force?: boolean;
+}
+export declare function runImport(packagePath: string, options: ImportOptions): Promise<void>;
+export declare function registerImportCommand(command: Command): void;
+export {};

package/dist/commands/import.js

@@ -0,0 +1,51 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runImport = runImport;
+exports.registerImportCommand = registerImportCommand;
+const node_path_1 = __importDefault(require("node:path"));
+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");
+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));
+}
+function registerImportCommand(command) {
+    command
+        .description('Import a portable .ocpkg directory into a target workspace.')
+        .argument('<package-path>', 'Portable package directory path')
+        .requiredOption('--target-workspace <path>', 'Target workspace path')
+        .option('--agent-id <id>', 'Target agent id override')
+        .option('--config <path>', 'Target OpenClaw config path')
+        .option('--force', 'Overwrite an existing target workspace')
+        .action(runImport);
+}
+//# sourceMappingURL=import.js.map

package/dist/commands/import.js.map

@@ -0,0 +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"}

package/dist/commands/inspect.d.ts

@@ -0,0 +1,10 @@
+import type { Command } from 'commander';
+interface InspectOptions {
+    workspace: string;
+    config?: string;
+    agentId?: string;
+    json?: boolean;
+}
+export declare function runInspect(options: InspectOptions): Promise<void>;
+export declare function registerInspectCommand(command: Command): void;
+export {};

package/dist/commands/inspect.js

@@ -0,0 +1,80 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInspect = runInspect;
+exports.registerInspectCommand = registerInspectCommand;
+const node_path_1 = __importDefault(require("node:path"));
+const agent_extract_1 = require("../core/agent-extract");
+const skills_detect_1 = require("../core/skills-detect");
+const workspace_scan_1 = require("../core/workspace-scan");
+async function runInspect(options) {
+    if (!options.workspace) {
+        throw new Error('inspect requires --workspace <path>');
+    }
+    const workspacePath = node_path_1.default.resolve(options.workspace);
+    const scan = await (0, workspace_scan_1.scanWorkspace)(workspacePath);
+    const skills = await (0, skills_detect_1.detectSkills)(scan);
+    const agentDefinition = await (0, agent_extract_1.extractAgentDefinition)(workspacePath, {
+        configPath: options.config,
+        agentId: options.agentId,
+    });
+    const warnings = [
+        'Channel bindings are not included in v1 packages.',
+        'Skills are manifest-only and may require manual installation.',
+    ];
+    const report = {
+        workspacePath,
+        includedFiles: scan.includedFiles.map((file) => file.relativePath),
+        excludedFiles: scan.excludedFiles,
+        ignoredFiles: scan.ignoredFiles,
+        missingOptionalFiles: scan.missingOptionalFiles,
+        portableConfig: {
+            found: !agentDefinition.notes.some((note) => note.includes('placeholder')),
+            agent: agentDefinition.agent,
+            fieldClassification: agentDefinition.fieldClassification,
+            notes: agentDefinition.notes,
+        },
+        skills,
+        warnings,
+        errors: [],
+    };
+    if (options.json) {
+        console.log(JSON.stringify(report, null, 2));
+        return;
+    }
+    const lines = [
+        `Workspace: ${report.workspacePath}`,
+        `Included files (${report.includedFiles.length}): ${report.includedFiles.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}`,
+        `  suggested name: ${report.portableConfig.agent.suggestedName}`,
+        `  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(', ')}`,
+        `Skills (workspace): ${skills.workspaceSkills.join(', ') || 'none'}`,
+        `Skills (referenced): ${skills.referencedSkills.join(', ') || 'none'}`,
+        `Skill notes: ${skills.notes.join(' | ') || 'none'}`,
+        `Warnings: ${warnings.join(' | ') || 'none'}`,
+    ];
+    if (report.portableConfig.notes.length > 0) {
+        lines.push(`Portable config notes: ${report.portableConfig.notes.join(' | ')}`);
+    }
+    console.log(lines.join('\n'));
+}
+function registerInspectCommand(command) {
+    command
+        .description('Inspect a workspace and report what is portable in v1.')
+        .requiredOption('--workspace <path>', 'Source workspace path')
+        .option('--config <path>', 'OpenClaw config path')
+        .option('--agent-id <id>', 'Source agent id override')
+        .option('--json', 'Emit the full machine-readable JSON report')
+        .action(runInspect);
+}
+//# sourceMappingURL=inspect.js.map

package/dist/commands/inspect.js.map

@@ -0,0 +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"}

package/dist/commands/validate.d.ts

@@ -0,0 +1,9 @@
+import type { Command } from 'commander';
+interface ValidateOptions {
+    targetWorkspace: string;
+    agentId?: string;
+    config?: string;
+}
+export declare function runValidate(options: ValidateOptions): Promise<void>;
+export declare function registerValidateCommand(command: Command): void;
+export {};