{
  "id": "update",
  "version": "1.0.0",
  "title": "update",
  "status": "process.active",
  "goal": {
    "text": "Update claw-kit on the DSH host to the latest published CLI and adapter."
  },
  "requirements": {
    "summary": "Refresh the global claw CLI and the @veewo/dsh-claw-kit profile plugin as one update unit, then verify activation.",
    "openQuestions": [],
    "acceptanceCriteria": [
      "The installed claw CLI is the target version and accepts --host dsh.",
      "The DSH profile bundles @veewo/dsh-claw-kit at the target version.",
      "After the Host restart the claw_run tool and the bundled skills declared by the installed package are present."
    ]
  },
  "tasks": [
    {
      "id": 1,
      "title": "Detect the current and target versions",
      "detail": "Resolve the current authorized profile; ask if unknown and never default to web. Run claw --version and read the installed adapter version (plugin_manager list_bundles for the Electron-managed desktop profile; dsh --profile <name> --dump-config or the profile package.json for profiles that command accepts). Resolve the latest published @veewo/claw and @veewo/dsh-claw-kit versions from the npm registry.",
      "status": "pending"
    },
    {
      "id": 2,
      "title": "Update the global claw CLI",
      "detail": "npm install -g @veewo/claw@latest; confirm claw --version matches the target. After restarting DSH, verify host-scoped recovery through claw_run(operation: context, args: {}).",
      "status": "pending"
    },
    {
      "id": 3,
      "title": "Update the DSH adapter in the profile",
      "detail": "Non-Electron profile: dsh plugin --profile <name> add @veewo/dsh-claw-kit@<exact-version>. Electron-managed desktop profile: the global dsh refuses it with 'profile \"desktop\" is managed exclusively by the Electron application', so install through the profile's own plugin manager instead — plugin_manager(action: install_bundle, target: '<exact version, local tarball path, or package path>') — and never write profile files with a filesystem tool, script, or shell. Then confirm the profile bundles list carries @veewo/dsh-claw-kit at the target version. See references/desktop-profile-write-boundary.md.",
      "status": "pending"
    },
    {
      "id": 4,
      "title": "Restart the Host and verify activation",
      "detail": "Restart the authorized DSH profile only with separate explicit restart authorization; otherwise report on-disk installation and wait for the owner's restart. Then verify claw_run and the bundled skills declared by the installed package (including feature-architecture and knowledge-capture) in a real session; use claw_run context as the non-mutating recovery smoke check.",
      "status": "pending"
    }
  ],
  "rules": [
    "Never use unpublished workspace files as the update source.",
    "CLI and adapter are one validation unit; do not report success until both are verified.",
    "A new package version is not activation proof; require a real session with claw_run.",
    "Never mutate the Electron-managed desktop profile with filesystem tools, scripts, or a shell; use plugin_manager install_bundle (or the in-app plugin page) and never restart a running Host without separate explicit authorization."
  ],
  "references": [
    {
      "path": "references/desktop-profile-write-boundary.md",
      "why": "Owns the verified write path and verification steps for the Electron-managed desktop profile."
    }
  ]
}