@topy-ai/maggie 0.2.7 → 0.2.9

package/README.md

@@ -57,6 +57,7 @@ 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
@@ -79,8 +80,8 @@ with `--confirm`, removes only known retired EmDash artifacts. It preserves
 Recommended upgrade sequence for the current release:
 
 ```bash
-npx @topy-ai/maggie@0.2.7 update --project . --force
-npx @topy-ai/maggie@0.2.7 cleanup --project .
+npx @topy-ai/maggie@0.2.9 update --project . --force
+npx @topy-ai/maggie@0.2.9 cleanup --project .
 ```
 
 ## MaggieDash lifecycle

package/bin/maggie.js

@@ -38,6 +38,12 @@ const SKILL_NAMES = [
 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",
@@ -45,6 +51,7 @@ const RETIRED_PATHS = [
   "tools/tests/test_maggie_emdash.py",
   "docs/ai-cmo-emdash",
 ];
+const RETIRED_REFERENCE_FILES = ["CLAUDE.md", ".claude/CLAUDE.md", ".agents/AGENTS.md", ".agents/README.md"];
 
 function usage() {
   console.log(`Maggie Skills installer
@@ -313,15 +320,21 @@ function cleanup(args) {
     .filter(({ target }) => existsSync(target));
   if (!existing.length) {
     console.log("Maggie cleanup: no retired artifacts found");
-    return;
+  } else {
+    for (const { relativePath, target } of existing) console.log(`${args.includes("--confirm") ? "removing" : "would remove"} ${relativePath}`);
+    if (args.includes("--confirm")) {
+      for (const { target } of existing) rmSync(target, { recursive: true, force: false });
+      console.log(`Maggie cleanup complete: removed ${existing.length} retired artifact(s)`);
+    } else {
+      console.log("Nothing was deleted. Rerun with --confirm to remove these retired artifacts.");
+    }
   }
-  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 relativePath of RETIRED_REFERENCE_FILES) {
+    const target = join(root, relativePath);
+    if (existsSync(target) && /emdash|em-dash|building-emdash-site|creating-plugins/i.test(readFileSync(target, "utf8"))) {
+      console.log(`review required ${relativePath}: contains a retired EmDash reference`);
+    }
   }
-  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.");
 }
 

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.7",
+  "version": "0.2.9",
   "description": "Install and manage Maggie Skills for AI coding agents",
   "license": "MIT",
   "type": "module",