@llodev/pm-tasks-asana 0.0.0-pr-22-9002a06

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@llodev/pm-tasks-asana",
+  "version": "0.0.0-pr-22-9002a06",
+  "description": "Asana adapter for the @llodev/pm-tasks-* family. Use when the user mentions Asana (create Asana task, publish to Asana, post to Asana, add comment in Asana, --publish-asana, close task, check subtask) or wants to publish a plan as Asana tasks with subtasks. Modes: paste-ready (no MCP needed), MCP publish (via claude.ai Asana MCP), autonomous (sentinel [autonomous] / --auto). Implements 6 CRUD verbs from @llodev/pm-tasks-core/references/contract.md mapped to Asana (parent task + subtasks, custom fields, sections, multi-assignee). REQUIRES: @llodev/pm-tasks-core installed (skillpm / Claude Code marketplace cascade auto; Vercel CLI users install manually).",
+  "license": "MIT",
+  "homepage": "https://github.com/llodev/skills/tree/main/pm-tasks/pm-tasks-asana",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/llodev/skills.git",
+    "directory": "pm-tasks/pm-tasks-asana"
+  },
+  "main": "./dist/bin/init.js",
+  "types": "./dist/bin/init.d.ts",
+  "files": [
+    "SKILL.md",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "docs",
+    "anti-patterns",
+    "references",
+    "i18n",
+    "schemas",
+    "manifest.json",
+    "dist"
+  ],
+  "keywords": [
+    "agent-skill",
+    "asana",
+    "plan-to-tasks",
+    "pm-tools",
+    "asana-mcp"
+  ],
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/bin/init.d.ts",
+      "import": "./dist/bin/init.js"
+    },
+    "./adapter": {
+      "types": "./dist/adapter.d.ts",
+      "import": "./dist/adapter.js"
+    },
+    "./i18n/*.json": "./i18n/*.json",
+    "./schemas/*.json": "./schemas/*.json",
+    "./manifest.json": "./manifest.json"
+  },
+  "bin": {
+    "pm-tasks-asana": "./dist/bin/init.js"
+  },
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "ajv-formats": "^3.0.1",
+    "@llodev/pm-tasks-core": "^0.0.0-pr-22-9002a06"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && chmod +x dist/bin/init.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "pnpm build && vitest run --passWithNoTests"
+  }
+}

package/references/operations.md

@@ -0,0 +1,62 @@
+# Asana CRUD operations (v1)
+
+Verb → MCP tool mapping for `@llodev/pm-tasks-asana`. All verbs return the core result envelope; see [`../../pm-tasks-core/references/contract.md`](../../pm-tasks-core/references/contract.md) § Result envelope.
+
+## Verb → MCP tool
+
+| Core verb           | Asana MCP tool (`mcp__claude_ai_Asana__*`)      | Notes                                                                                                                                                                |
+| ------------------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `task.create`       | `create_tasks`                                  | parent + subtasks; `memberships: [{ project, section }]` places card in the correct section at creation time.                                                        |
+| `task.move`         | `update_tasks`                                  | `memberships: [{ project: <projectGid>, section: <resolvedGid> }]`. See § `task.move` below for resolution rules. Idempotency: check current section before calling. |
+| `checklist.check`   | `update_tasks`                                  | `{ task: <subtaskGid>, completed: true }`. Subtask model emulates checklist items.                                                                                   |
+| `task.close`        | `update_tasks`                                  | `{ task: <parentGid>, completed: true }`. Visual section move is handled separately by `task.move(cardId, "done")` before calling `task.close`.                      |
+| `task.due-date.set` | `update_tasks`                                  | `{ task: <gid>, due_on: "YYYY-MM-DD" }`. Pass `null` to clear.                                                                                                       |
+| `task.assignee.add` | `update_tasks` + `update_tasks` (add_followers) | Primary assignee via `assignee` field; additional users become followers via `add_followers: [<gid>]`.                                                               |
+| `task.comment.add`  | `add_comment`                                   | Creates a comment story on the task. Apply attribution prefix per `config.locale` if `config.attribution` is enabled.                                                |
+
+## `task.move` — resolution rules
+
+Schema: `{ cardId: string, targetList: "open" | "wip" | "done" | string }`
+
+Resolution order for `targetList`:
+
+1. If `targetList` is `"wip"` → look up `defaults.wipSectionAlias` in `.asana.json`, find the matching entry in `sections[]` by alias, use its `id` as the section GID.
+2. If `targetList` is `"done"` → look up `defaults.doneSectionAlias` in `.asana.json`.
+3. If `targetList` is `"open"` → look up `defaults.openSectionAlias` in `.asana.json`.
+4. Otherwise → treat `targetList` as a raw Asana section GID and pass through directly.
+
+The resolved section GID MUST be in `autonomous.scope.sections` — otherwise the verb returns `{ ok: false, code: "OUT_OF_SCOPE" }`.
+
+Idempotency: fetch current task memberships before calling `update_tasks`. If the task is already in the target section, return `{ ok: true }` without an MCP write.
+
+## `<task-ref>` resolution for Asana
+
+Accept, in order:
+
+1. Full Asana permalink (`https://app.asana.com/0/<project>/<task>`).
+2. Bare GID (numeric string).
+3. Alias from `.asana.json` `taskAliases[]`.
+4. `clientToken` match in audit log (most recent).
+5. Name partial match in audit log scoped to `autonomous.scope`.
+6. Otherwise → `{ ok: false, code: "REF_NOT_RESOLVED", candidates: [...] }`.
+
+## Idempotency
+
+| Verb          | Idempotency rule                                                                                               |
+| ------------- | -------------------------------------------------------------------------------------------------------------- |
+| `task.create` | Before creating, search scope for task with matching `clientToken`. If found, return existing ref.             |
+| `task.move`   | Check current section before `update_tasks`. No-op if already in target.                                       |
+| `task.close`  | Natural — `completed: true` is a no-op if already completed.                                                   |
+| others        | Natural or `clientToken`-based; see [`crud-vocabulary.md`](../../pm-tasks-core/references/crud-vocabulary.md). |
+
+## Result envelope — Asana-specific `details`
+
+| Verb                | `details` fields                                                         |
+| ------------------- | ------------------------------------------------------------------------ |
+| `task.create`       | `{ parentGid, subtaskGids[], projectGid, sectionGid?, customFields[]? }` |
+| `task.move`         | `{ taskGid, sectionGid, targetList }`                                    |
+| `checklist.check`   | `{ subtaskGid, completed: true }`                                        |
+| `task.close`        | `{ parentGid, completed: true }`                                         |
+| `task.due-date.set` | `{ taskGid, due_on }`                                                    |
+| `task.assignee.add` | `{ taskGid, assignee, followers[]? }`                                    |
+| `task.comment.add`  | `{ taskGid, storyGid }`                                                  |

package/schemas/config.json

@@ -0,0 +1,173 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://llodev.github.io/skills/schemas/pm-tasks-asana.json",
+  "title": "pm-tasks-asana config",
+  "type": "object",
+  "required": ["version", "projects", "sections"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": { "type": "string" },
+    "version": { "const": "1" },
+    "locale": {
+      "type": "string",
+      "enum": ["en-US", "pt-BR", "es-ES"]
+    },
+    "workspace": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "id": { "type": "string", "minLength": 4 },
+        "name": { "type": "string" }
+      }
+    },
+    "projects": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "required": ["id", "alias"],
+        "additionalProperties": false,
+        "properties": {
+          "id": { "type": "string", "minLength": 4 },
+          "name": { "type": "string" },
+          "alias": { "type": "string", "pattern": "^[a-z0-9-]+$" },
+          "url": { "type": "string", "format": "uri" }
+        }
+      }
+    },
+    "sections": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["projectAlias", "id", "alias"],
+        "additionalProperties": false,
+        "properties": {
+          "projectAlias": { "type": "string" },
+          "id": { "type": "string", "minLength": 4 },
+          "name": { "type": "string" },
+          "alias": { "type": "string", "pattern": "^[a-z0-9-]+$" }
+        }
+      }
+    },
+    "customFields": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["projectAlias", "id", "name", "type", "alias"],
+        "additionalProperties": false,
+        "properties": {
+          "projectAlias": { "type": "string" },
+          "id": { "type": "string", "minLength": 4 },
+          "name": { "type": "string" },
+          "type": {
+            "type": "string",
+            "enum": ["text", "number", "enum", "multi_enum", "date", "people"]
+          },
+          "alias": { "type": "string", "pattern": "^[a-z0-9-]+$" },
+          "options": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["id", "name"],
+              "additionalProperties": false,
+              "properties": {
+                "id": { "type": "string", "minLength": 4 },
+                "name": { "type": "string" },
+                "alias": { "type": "string", "pattern": "^[a-z0-9-]+$" }
+              }
+            }
+          }
+        }
+      }
+    },
+    "subtaskDefaults": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "inheritParentFields": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 4 },
+          "description": "Custom field IDs whose values flow from parent to subtask at create time."
+        },
+        "inheritAssignee": { "type": "boolean" }
+      }
+    },
+    "members": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "alias"],
+        "additionalProperties": false,
+        "properties": {
+          "id": { "type": "string", "minLength": 4 },
+          "name": { "type": "string" },
+          "email": { "type": "string", "format": "email" },
+          "alias": { "type": "string", "pattern": "^[a-z0-9-]+$" }
+        }
+      }
+    },
+    "defaults": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "projectAlias": { "type": "string" },
+        "sectionAlias": { "type": "string" },
+        "closeSectionAlias": { "type": "string" },
+        "assigneeAlias": { "type": "string" },
+        "escalateToAlias": { "type": "string" }
+      }
+    },
+    "taskAliases": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["alias", "id"],
+        "additionalProperties": false,
+        "properties": {
+          "alias": { "type": "string", "pattern": "^[a-z0-9-]+$" },
+          "id": { "type": "string" },
+          "url": { "type": "string", "format": "uri" }
+        }
+      }
+    },
+    "attribution": { "$ref": "https://llodev.com/pm-tasks/attribution.schema.json" },
+    "autonomous": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "allow": {
+          "type": "array",
+          "items": {
+            "enum": [
+              "task.create",
+              "task.move",
+              "checklist.check",
+              "task.close",
+              "task.due-date.set",
+              "task.assignee.add",
+              "task.comment.add"
+            ]
+          }
+        },
+        "scope": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "projects": { "type": "array", "items": { "type": "string" } },
+            "sections": { "type": "array", "items": { "type": "string" } }
+          }
+        },
+        "rateLimit": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "writesPerMinute": { "type": "integer", "minimum": 1, "maximum": 600 },
+            "commentsPerMinute": { "type": "integer", "minimum": 1, "maximum": 600 }
+          }
+        },
+        "auditLog": { "type": "string" }
+      }
+    }
+  }
+}