clawpilot 0.1.1 → 0.2.0

package/docs/releases/v0.1.2.md

@@ -0,0 +1,57 @@
+# clawpilot v0.1.2
+
+Released: 2026-02-13
+
+## Highlights
+
+- Added installer non-interactive mode with `--yes`.
+- Added timezone override support with `--timezone <IANA>`.
+- Improved installer validation and error messaging for missing option values.
+- Improved productivity loop prompt structure (Morning / Midday / Evening flow).
+- Added troubleshooting guidance for npm publish `E403` (2FA/token setup).
+
+## What Changed
+
+### Installer UX
+
+- New CLI option: `--yes`
+  - Disables prompts and fails fast when required values are missing.
+- New CLI option: `--timezone <IANA>`
+  - Persists explicit timezone into OpenClaw config.
+- CLI help output now documents the new options.
+- Installer now prints a concise post-install next step message.
+
+### Reliability
+
+- Reinstall and config update behavior remain idempotent.
+- Existing custom fields under `skills.entries.clawpilot-productivity` are preserved.
+- `skills.load.extraDirs` remains deduplicated across repeated installs.
+
+### Prompt Template
+
+- Refined `templates/soul-injection.md` to enforce a clearer daily operating format:
+  - Morning: 3 measurable tasks
+  - Midday: status + unblock action
+  - Evening: review + tomorrow first action
+- Added explicit rescue sprint guardrail (max two per week).
+
+### Docs
+
+- Added Quick Start and local isolated install examples.
+- Added npm publish troubleshooting for `E403`.
+- Added 0.1.2 plan/design docs.
+
+## Verification
+
+- Test suite: `node --test` (7/7 passing)
+- Package dry run: `npm pack --dry-run`
+- Smoke flow validated:
+  - `node bin/cli.js install --home <temp> --yes --timezone UTC`
+  - `node bin/cli.js install --home <temp> --yes --timezone UTC --force`
+
+## Upgrade
+
+```bash
+npx -y clawpilot@latest --help
+npx -y clawpilot@latest install --yes --timezone UTC
+```

package/docs/releases/v0.2.0-draft.md

@@ -0,0 +1,24 @@
+# clawpilot v0.2.0 (Draft)
+
+## Highlights
+
+- Added runtime command execution via `clawpilot run`.
+- Added productivity workflow handlers: `morning`, `midday`, `evening`, `report`.
+- Added OpenClaw Gateway delivery adapter (`openclaw message send`).
+- Added fictional K-style role packs (`hana`, `minji`).
+- Added template rendering and runtime state persistence.
+- Added installer defaults for Telegram gateway delivery and role pack config.
+
+## Runtime Commands
+
+```bash
+clawpilot run --command morning --dry-run --timezone UTC --role-pack hana
+clawpilot run --command midday --dry-run --status done --status blocked --status deferred
+clawpilot run --command evening --dry-run
+clawpilot run --command report --dry-run
+```
+
+## Notes
+
+- This release does not include direct Telegram Bot API webhook integration.
+- Delivery is routed through OpenClaw Gateway.

package/docs/releases/v0.2.1-draft.md

@@ -0,0 +1,19 @@
+# clawpilot v0.2.1 (Draft)
+
+## Highlights
+
+- Added social recap formatting helpers for Telegram, X, and LinkedIn styles.
+- Added weekly report summarization with completion rate and blocker counts.
+- Added content templates for social output formats.
+- Improved docs coverage for runtime workflows and publishing checks.
+
+## New Content Paths
+
+- `templates/content/social-telegram.md`
+- `templates/content/social-x.md`
+- `templates/content/social-linkedin.md`
+
+## Notes
+
+- Focus remains execution-first productivity workflow.
+- Role identity remains fictional and non-celebrity.

package/docs/troubleshooting.md

@@ -0,0 +1,44 @@
+# Troubleshooting
+
+Common runtime/install failures and how to fix them quickly.
+
+## Error Codes
+
+- `gateway_missing`: OpenClaw CLI is unavailable.  
+  Fix: install OpenClaw and verify with `openclaw --version`.
+- `openclaw_version_unsupported`: OpenClaw version is below minimum required version.  
+  Fix: upgrade OpenClaw to the minimum version reported by preflight.
+- `openclaw_version_unknown`: OpenClaw version string could not be parsed.  
+  Fix: verify `openclaw --version` outputs semantic version (`x.y.z`).
+- `gateway_unreachable`: Gateway process is offline or refused connection.  
+  Fix: start gateway and verify connectivity.
+- `auth_invalid`: Token or gateway auth is invalid.  
+  Fix: refresh auth token and retry.
+- `channel_not_found`: Target channel/chat is not found.  
+  Fix: verify `--channel` or `delivery.channel`.
+- `permission_denied`: OS/app permission blocked send.  
+  Fix: grant permissions and retry.
+- `network_timeout`: DNS/network timeout while sending.  
+  Fix: retry and verify network path.
+- `invalid_payload`: Message payload rejected (400).  
+  Fix: validate channel/message/media fields.
+- `rate_limited`: Gateway/provider is throttling requests.  
+  Fix: add backoff and reduce send frequency.
+- `channel_required`: Non-dry-run command has no channel value.  
+  Fix: pass `--channel <target>` or set `delivery.channel`.
+- `delivery_channel_missing`: Config check warning for missing default channel in gateway mode.  
+  Fix: set `delivery.channel` in `openclaw.json` or pass `--channel`.
+- `gateway_token_missing`: Config check warning for missing gateway token source.  
+  Fix: set `OPENCLAW_GATEWAY_TOKEN` env var or OpenClaw token config.
+
+## Useful Commands
+
+- JSON error output for automation:
+  - `node bin/cli.js run --command morning --json-errors`
+- Preflight summary before install:
+  - `node bin/cli.js install --preflight`
+  - `node bin/cli.js install --preflight --json-errors`
+- Safe validation without sending:
+  - `node bin/cli.js run --command morning --dry-run --timezone UTC`
+- Re-run install with existing policy:
+  - `node bin/cli.js install --on-existing update --yes --timezone UTC`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawpilot",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "OpenClaw productivity copilot installer and skill package.",
   "private": false,
   "bin": {

package/skill/SKILL.md

@@ -1,22 +1,33 @@
-# Clawpilot Productivity Skill
-
-You are a productivity copilot focused on helping the user ship meaningful work each day.
-
-## Core Loop
-
-1. Morning planning:
-   - Ask for the user's top 3 outcome-based tasks.
-   - Ensure each task is specific and verifiable.
-2. Midday check-in:
-   - Ask what is done, blocked, or deferred.
-   - Help remove one blocker.
-3. Evening review:
-   - Summarize completed work.
-   - Capture one improvement for tomorrow.
-
-## Tone and Constraints
-
-- Keep responses short and action-oriented.
-- Be supportive and direct.
-- Avoid guilt, shame, or perfectionist framing.
-- Prefer one next action when the user is stuck.
+# Clawpilot Productivity Skill
+
+You are a productivity copilot focused on helping the user ship meaningful work each day.
+
+## Runtime Commands
+
+- `/morning` - collect and lock top 3 measurable tasks.
+- `/midday` - update status (`done`, `blocked`, `deferred`) for each task.
+- `/evening` - review progress and define tomorrow's first action.
+- `/report` - produce concise summary for user updates.
+
+Delivery path:
+- Use OpenClaw Gateway command: `openclaw message send`.
+- Default target platform is Telegram from runtime config.
+
+## Core Loop
+
+1. Morning planning:
+   - Ask for the user's top 3 outcome-based tasks.
+   - Ensure each task is specific and verifiable.
+2. Midday check-in:
+   - Ask what is done, blocked, or deferred.
+   - Help remove one blocker.
+3. Evening review:
+   - Summarize completed work.
+   - Capture one improvement for tomorrow.
+
+## Tone and Constraints
+
+- Keep responses short and action-oriented.
+- Be supportive and direct.
+- Avoid guilt, shame, or perfectionist framing.
+- Prefer one next action when the user is stuck.

package/src/config/migrations.js

@@ -0,0 +1,68 @@
+const SKILL_ID = 'clawpilot-productivity';
+const CURRENT_CONFIG_SCHEMA_VERSION = 2;
+
+function asObject(value) {
+  return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+
+function migrateV1ToV2(inputConfig) {
+  const config = { ...asObject(inputConfig) };
+  const skills = { ...asObject(config.skills) };
+  const entries = { ...asObject(skills.entries) };
+  const existingEntry = asObject(entries[SKILL_ID]);
+
+  if (Object.keys(existingEntry).length > 0) {
+    const runtime = { ...asObject(existingEntry.runtime) };
+    const defaults = { ...asObject(runtime.defaults) };
+    const schedule = { ...asObject(runtime.schedule) };
+
+    if (existingEntry.timezone && defaults.timezone === undefined) {
+      defaults.timezone = existingEntry.timezone;
+    }
+    if (existingEntry.rolePack && defaults.rolePack === undefined) {
+      defaults.rolePack = existingEntry.rolePack;
+    }
+    if (Object.keys(schedule).length === 0 && existingEntry.schedule) {
+      Object.assign(schedule, asObject(existingEntry.schedule));
+    }
+
+    runtime.defaults = defaults;
+    runtime.schedule = schedule;
+    entries[SKILL_ID] = {
+      ...existingEntry,
+      runtime
+    };
+    skills.entries = entries;
+    config.skills = skills;
+  }
+
+  config.configSchemaVersion = 2;
+  return config;
+}
+
+function migrateConfig(sourceConfig = {}) {
+  let config = { ...asObject(sourceConfig) };
+  let version = Number.isInteger(config.configSchemaVersion)
+    ? config.configSchemaVersion
+    : 1;
+
+  while (version < CURRENT_CONFIG_SCHEMA_VERSION) {
+    if (version === 1) {
+      config = migrateV1ToV2(config);
+      version = 2;
+      continue;
+    }
+    break;
+  }
+
+  if (!Number.isInteger(config.configSchemaVersion)) {
+    config.configSchemaVersion = CURRENT_CONFIG_SCHEMA_VERSION;
+  }
+
+  return config;
+}
+
+module.exports = {
+  CURRENT_CONFIG_SCHEMA_VERSION,
+  migrateConfig
+};