@topy-ai/maggie 0.2.6 → 0.2.8

package/README.md

@@ -1,5 +1,8 @@
 # @topy-ai/maggie
 
+[![npm version](https://img.shields.io/npm/v/@topy-ai/maggie)](https://www.npmjs.com/package/@topy-ai/maggie)
+[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/TOPY-AI-LTD/ai-cmo-skills/blob/main/LICENSE)
+
 Installable AI workflows for building, operating, and growing websites.
 
 Maggie gives Codex, Claude Code, and compatible coding agents a set of
@@ -51,8 +54,10 @@ The CLI provides the installer plus durable workflow commands:
 
 ```text
 maggie init | install | update | remove | list | doctor
+maggie cleanup --project . [--confirm]
 maggie bootstrap interview | phase ...
 maggie dash init | status | migrate
+maggie dash transition ...      # explicit content approval transition
 maggie clone ...                 # authorized homepage capture
 maggie design ...                # authorized interior-page design
 maggie clone-to-template ...     # URL → validated marketplace template
@@ -68,6 +73,17 @@ maggie api lifecycle | site-audit | ops audit
 Run `maggie --help` for the complete syntax. `maggie-emdash` is migration
 history only and is not an installable package skill.
 
+`update` never deletes files removed upstream. `cleanup` first previews and,
+with `--confirm`, removes only known retired EmDash artifacts. It preserves
+`docs/de-emdash-*` migration history and `.maggie` marketplace state.
+
+Recommended upgrade sequence for the current release:
+
+```bash
+npx @topy-ai/maggie@0.2.8 update --project . --force
+npx @topy-ai/maggie@0.2.8 cleanup --project .
+```
+
 ## MaggieDash lifecycle
 
 For a new project, establish the local content and approval foundation before

package/bin/maggie.js

@@ -35,6 +35,22 @@ const SKILL_NAMES = [
   "maggie-content-localization",
   "maggie-feedback",
 ];
+const RETIRED_PATHS = [
+  ".agents/skills/maggie-emdash",
+  ".claude/skills/maggie-emdash",
+  ".agents/skills/building-emdash-site",
+  ".claude/skills/building-emdash-site",
+  ".agents/skills/creating-plugins",
+  ".claude/skills/creating-plugins",
+  ".agents/skills/emdash-cli",
+  ".claude/skills/emdash-cli",
+  "contracts/emdash",
+  "templates/emdash",
+  "references/emdash-integration.md",
+  "tools/clis/maggie_emdash.py",
+  "tools/tests/test_maggie_emdash.py",
+  "docs/ai-cmo-emdash",
+];
 
 function usage() {
   console.log(`Maggie Skills installer
@@ -52,6 +68,7 @@ Usage:
   maggie content FILE --source PROVIDER --project PATH --confirm
   maggie bootstrap phase <start|pass|fail|status> <phase> [project]
   maggie remove [SKILL ...] [--project PATH] [--agent codex|claude|all]
+  maggie cleanup --project PATH [--confirm]
   maggie marketplace add <template-url> clone <preview-url> --rename <id>
   maggie marketplace list
   maggie marketplace suggest "premium London medical spa"
@@ -295,6 +312,25 @@ function remove(args) {
   }
 }
 
+function cleanup(args) {
+  const root = projectRoot(args);
+  const existing = RETIRED_PATHS
+    .map((relativePath) => ({ relativePath, target: join(root, relativePath) }))
+    .filter(({ target }) => existsSync(target));
+  if (!existing.length) {
+    console.log("Maggie cleanup: no retired artifacts found");
+    return;
+  }
+  for (const { relativePath, target } of existing) console.log(`${args.includes("--confirm") ? "removing" : "would remove"} ${relativePath}`);
+  if (!args.includes("--confirm")) {
+    console.log("Nothing was deleted. Rerun with --confirm to remove these retired artifacts.");
+    return;
+  }
+  for (const { target } of existing) rmSync(target, { recursive: true, force: false });
+  console.log(`Maggie cleanup complete: removed ${existing.length} retired artifact(s)`);
+  console.log("Migration history under docs/de-emdash-* and marketplace/.maggie were preserved.");
+}
+
 const [command = "help", ...args] = process.argv.slice(2);
 try {
   if (["help", "--help", "-h"].includes(command)) usage();
@@ -322,6 +358,7 @@ try {
   else if (command === "update") update(args);
   else if (command === "doctor") doctor(args);
   else if (command === "remove") remove(args);
+  else if (command === "cleanup") cleanup(args);
   else throw new Error(`unknown command: ${command}`);
 } catch (error) {
   console.error(`maggie: ${error.message}`);

package/bundled-skills/maggie-dash/SKILL.md

@@ -18,6 +18,21 @@ content operations.
 4. Keep content in `draft` until a named actor explicitly transitions it
    through review and approval.
 
+To move a document through the approval lifecycle, use the explicit
+transition command after checking its current status:
+
+```bash
+maggie dash status --project . --project-id local-project
+maggie dash transition --project . \
+  --project-id local-project --document-id <document-id> \
+  --status review --actor <actor-id> \
+  --reason "ready for factual review" --confirm
+```
+
+Valid transitions and statuses are owned by the MaggieDash storage contract;
+do not edit the database directly. A transition is an auditable state change,
+not a publish shortcut.
+
 All mutating commands require `--confirm`. The default development adapter is
 SQLite; production adapters must satisfy the same versioned contracts.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topy-ai/maggie",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "Install and manage Maggie Skills for AI coding agents",
   "license": "MIT",
   "type": "module",