@llodev/pm-tasks-asana 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @llodev/pm-tasks-asana
 
+## 1.0.2
+
+### Patch Changes
+
+- Allow `defaults.escalateToAlias` (and `defaults.assigneeAlias` on Trello) in the config schemas. The v1.0.1 init scripts emit these keys, but the JSON Schemas still had `additionalProperties: false` rejecting them — making `npx @llodev/pm-tasks-{asana,trello} init` fail at the validate step with "must NOT have additional properties". Trello init also now emits `assigneeAlias: "me"` for parity with Asana.
+
+## 1.0.1
+
+### Patch Changes
+
+- Fix `npx @llodev/pm-tasks-asana init` silently doing nothing. Two bugs collapsed the init flow: (a) the `bin` entry was named `pm-tasks-asana-init` (not matching the package name), so npx never resolved the binary; (b) the script's `import.meta.url === file://${process.argv[1]}` guard failed under npx's symlinked bin shim, so even when invoked the `run()` entry-point was skipped. The bin is now `pm-tasks-asana` and the entry-point runs unconditionally.
+- Cross-platform global config path. The init prompt now honors `LLODEV_PM_TASKS_CONFIG_HOME` first, then `XDG_CONFIG_HOME` (macOS/Linux), then `%APPDATA%` (Windows), then `~/.config` as the last fallback. The prompt prints the absolute path before asking, so the destination is always visible.
+- Slug aliases are now Unicode-aware (via `@llodev/pm-tasks-core@1.0.1`): `"Em execução"` → `"em-execucao"`, `"Média"` → `"media"` (was `"em-execu-o"` / `"m-dia"`).
+- Drop the language-specific regex for inferring the "closed" section. The init now explicitly asks: "Which section is the default for newly-created tasks?" and "Which section means 'closed / done'?" with sensible defaults (first / last picked) and a skip option.
+- Add an explicit escalation prompt. After the member list is collected, the init asks: "Pick the escalation contact (will receive escalation comments + add_member on critical cards)" and stores it as `defaults.escalateToAlias`. The chosen member is re-aliased to `"owner"` if no other member already holds that alias.
+- Fallback for empty membership lists: if the PAT's scope didn't return any project members beyond `me`, the init now offers a manual entry (gid + name + alias) so single-collaborator projects can still wire an escalation contact.
+- `multiSelect`: empty input now means "select all" instead of "select none".
+- README clarifies the per-OS defaults and the env override.
+
 ## 1.0.0
 
 ### Major Changes

package/README.md

@@ -34,7 +34,15 @@ export LLODEV_PM_TASKS_ASANA_PAT=...
 npx @llodev/pm-tasks-asana init
 ```
 
-Walk through the prompts. Output: `.asana.json` (repo) or `~/.config/llodev/pm-tasks/asana.json` (global).
+Walk through the prompts. Pick where the config should live:
+
+- **local** → `./.asana.json` (recommended for project-scoped configs, can be committed).
+- **global** → a platform default, customizable. Defaults:
+  - macOS / Linux (XDG): `$XDG_CONFIG_HOME/llodev/pm-tasks/asana.json`, falling back to `~/.config/llodev/pm-tasks/asana.json`.
+  - Windows: `%APPDATA%\llodev\pm-tasks\asana.json`.
+  - Override on any OS with `LLODEV_PM_TASKS_CONFIG_HOME=/your/path` — the file lands at `$LLODEV_PM_TASKS_CONFIG_HOME/asana.json`.
+
+The `init` prompt prints the absolute path it will write to, so you always see exactly where the file goes.
 
 The PAT is **only** used by `init`. The MCP itself uses OAuth — never put tokens in the JSON.
 

package/SKILL.md

@@ -7,16 +7,15 @@ description: >-
   existing tasks (check subtask, close task, change due-date, assign person,
   comment); OR when invoked autonomously by another agent with [autonomous] /
   --auto sentinel. Asana hierarchy: workspace > project > section > parent task
-  > subtasks (one level), with custom fields and multi-assignee support.
-  Modes: paste-ready (no MCP needed), MCP publish (via claude.ai Asana MCP),
-  autonomous (write-through with allowlist). Implements 6 CRUD verbs
-  (task.create, checklist.check, task.close, task.due-date.set,
-  task.assignee.add, task.comment.add) from
-  pm-tasks/pm-tasks-core/references/contract.md. Requires @llodev/pm-tasks-core
-  installed.
+  > subtasks (one level), with custom fields and multi-assignee support. Modes:
+  paste-ready (no MCP needed), MCP publish (via claude.ai Asana MCP), autonomous
+  (write-through with allowlist). Implements 6 CRUD verbs (task.create,
+  checklist.check, task.close, task.due-date.set, task.assignee.add,
+  task.comment.add) from pm-tasks/pm-tasks-core/references/contract.md. Requires
+  @llodev/pm-tasks-core installed.
 license: MIT
 metadata:
-  version: 1.0.0
+  version: 1.0.2
   tags:
     - agent-skill
     - asana
@@ -41,11 +40,11 @@ Adapter for Asana within the `@llodev/pm-tasks-*` family. Use the core skill's e
 
 ## Routing
 
-| Mode        | Trigger                                                                                   | Path                                                                     |
-| ----------- | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
-| Paste-only  | "format as Asana task" without MCP intent                                                 | Phase 3 (core) → Phase 4 (this skill, format only) → output paste blocks |
-| MCP publish | "publish to Asana", "create on Asana", "--publish-asana"                                  | Phase 3 → Phase 4 → Phase 5 (publish via MCP)                            |
-| Autonomous  | `[autonomous]` or `--auto` in prompt OR `LLODEV_PM_TASKS_AUTONOMOUS=1`                    | Phase 3 → Phase 4 → Phase 5b (write-through, no preview)                 |
+| Mode        | Trigger                                                                                    | Path                                                                     |
+| ----------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------ |
+| Paste-only  | "format as Asana task" without MCP intent                                                  | Phase 3 (core) → Phase 4 (this skill, format only) → output paste blocks |
+| MCP publish | "publish to Asana", "create on Asana", "--publish-asana"                                   | Phase 3 → Phase 4 → Phase 5 (publish via MCP)                            |
+| Autonomous  | `[autonomous]` or `--auto` in prompt OR `LLODEV_PM_TASKS_AUTONOMOUS=1`                     | Phase 3 → Phase 4 → Phase 5b (write-through, no preview)                 |
 | CRUD ops    | "check subtask N on task X", "close task Y", "assign Alice to task Z", "comment on task X" | Phase 6 (operations, direct verb dispatch)                               |
 
 ## Asana model
@@ -119,7 +118,9 @@ Every verb returns the core contract shape (see [`../pm-tasks-core/references/co
   "verb": "task.create",
   "tool": "asana",
   "ref": { "id": "<gid>", "url": "https://app.asana.com/0/<project>/<gid>", "alias": "<optional>" },
-  "details": { /* Asana-specific (see table below) */ }
+  "details": {
+    /* Asana-specific (see table below) */
+  }
 }
 ```
 
@@ -142,7 +143,7 @@ See [`anti-patterns/asana.md`](anti-patterns/asana.md) — paste health, custom-
 
 ## Standalone fallback
 
-If `@llodev/pm-tasks-core` is not installed: ask the user for minimum input (title + subtask names) and produce a paste-ready Asana task body from this content alone. Quality is degraded — no scope/audience/fidelity inference. Print: *"Install `@llodev/pm-tasks-core` for the full flow."*
+If `@llodev/pm-tasks-core` is not installed: ask the user for minimum input (title + subtask names) and produce a paste-ready Asana task body from this content alone. Quality is degraded — no scope/audience/fidelity inference. Print: _"Install `@llodev/pm-tasks-core` for the full flow."_
 
 ## Config
 

package/anti-patterns/asana.md

@@ -6,8 +6,8 @@ Apply when Phase 4 / Phase 5 / Phase 5b target Asana. Authoritative formatting +
 
 ## Paste health and fallbacks
 
-| Healthy paste                                                                                                       | If it degrades → fallback                                                                            |
-| ------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
+| Healthy paste                                                                                                         | If it degrades → fallback                                                                                                   |
+| --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
 | Prefer `**Section**` in task descriptions when `##` headings are unreliable; **only one** nesting level for subtasks. | Swap heading hierarchy for bold labels; split deep trees into sibling tasks. See [`../SKILL.md`](../SKILL.md) §Asana model. |
 
 **Switching tools mid-thread:** re-load the new tool's adapter; do not carry Asana rules into Trello / Jira / Linear (see **Cross-tool** below).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llodev/pm-tasks-asana",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "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",
@@ -28,10 +28,10 @@
   ],
   "type": "module",
   "bin": {
-    "pm-tasks-asana-init": "./scripts/init.mjs"
+    "pm-tasks-asana": "./scripts/init.mjs"
   },
   "dependencies": {
-    "@llodev/pm-tasks-core": "^1.0.0"
+    "@llodev/pm-tasks-core": "^1.0.1"
   },
   "publishConfig": {
     "access": "public"

package/schemas/config.json

@@ -109,7 +109,8 @@
         "projectAlias": { "type": "string" },
         "sectionAlias": { "type": "string" },
         "closeSectionAlias": { "type": "string" },
-        "assigneeAlias": { "type": "string" }
+        "assigneeAlias": { "type": "string" },
+        "escalateToAlias": { "type": "string" }
       }
     },
     "taskAliases": {

package/scripts/init.mjs

@@ -7,6 +7,8 @@ import {
   promptScope,
   promptYesNo,
   multiSelect,
+  promptPick,
+  aliasOf,
   writeConfig,
   validateConfig,
   probeMCP,
@@ -39,8 +41,7 @@ async function asanaProbe() {
     getWorkspaces: () => j("/workspaces?opt_fields=name"),
     getProjects: (workspaceGid) =>
       j(`/projects?workspace=${workspaceGid}&opt_fields=name&limit=100`),
-    getSections: (projectGid) =>
-      j(`/projects/${projectGid}/sections?opt_fields=name&limit=100`),
+    getSections: (projectGid) => j(`/projects/${projectGid}/sections?opt_fields=name&limit=100`),
     getCustomFields: (projectGid) =>
       j(
         `/projects/${projectGid}/custom_field_settings?opt_fields=custom_field.name,custom_field.gid,custom_field.resource_subtype,custom_field.enum_options.name,custom_field.enum_options.gid&limit=100`,
@@ -50,11 +51,46 @@ async function asanaProbe() {
   };
 }
 
-function aliasOf(name) {
-  return name
-    .toLowerCase()
-    .replace(/[^a-z0-9]+/g, "-")
-    .replace(/^-|-$/g, "");
+async function promptManualMember() {
+  const { createInterface } = await import("node:readline/promises");
+  const { stdin: input, stdout: output } = await import("node:process");
+  const r = createInterface({ input, output });
+  try {
+    const gid = (await r.question("Escalation member gid (Asana user ID): ")).trim();
+    if (!gid) return null;
+    const name = (await r.question("Display name: ")).trim() || "owner";
+    const alias = (await r.question(`Alias (default "owner"): `)).trim() || "owner";
+    return { id: gid, name, alias };
+  } finally {
+    r.close();
+  }
+}
+
+async function collectEscalationMember(out) {
+  const candidates = out.members.filter((m) => m.alias !== "me");
+  if (candidates.length) {
+    const choices = candidates.map((m) => ({ label: `${m.name} (${m.alias})`, value: m }));
+    const picked = await promptPick(
+      "Pick the escalation contact (will receive escalation comments + add_member on critical cards):",
+      choices,
+      { defaultIndex: 0, allowSkip: true },
+    );
+    if (picked) {
+      if (picked.alias !== "owner") {
+        if (!out.members.find((m) => m.alias === "owner")) picked.alias = "owner";
+      }
+      out.defaults.escalateToAlias = picked.alias;
+    }
+    return;
+  }
+  const add = await promptYesNo(
+    "Project membership listing returned nothing (PAT scope or solo project). Add an escalation contact manually?",
+  );
+  if (!add) return;
+  const manual = await promptManualMember();
+  if (!manual) return;
+  out.members.push(manual);
+  out.defaults.escalateToAlias = manual.alias;
 }
 
 function mapResourceType(subtype) {
@@ -212,13 +248,28 @@ async function run() {
 
   if (out.projects.length === 1) {
     out.defaults.projectAlias = out.projects[0].alias;
-    const backlog = out.sections.find((s) => /backlog|todo|to.do|inbox/i.test(s.name));
-    const done = out.sections.find((s) => /done|completed|published|conclu/i.test(s.name));
-    if (backlog) out.defaults.sectionAlias = backlog.alias;
-    if (done) out.defaults.closeSectionAlias = done.alias;
     out.defaults.assigneeAlias = "me";
+    const sectionChoices = out.sections.map((s) => ({
+      label: `${s.name} (${s.alias})`,
+      value: s,
+    }));
+    if (sectionChoices.length) {
+      const open = await promptPick(
+        "Which section is the default for newly-created tasks?",
+        sectionChoices,
+        { defaultIndex: 0, allowSkip: true },
+      );
+      if (open) out.defaults.sectionAlias = open.alias;
+      const close = await promptPick("Which section means 'closed / done'?", sectionChoices, {
+        defaultIndex: sectionChoices.length - 1,
+        allowSkip: true,
+      });
+      if (close) out.defaults.closeSectionAlias = close.alias;
+    }
   }
 
+  await collectEscalationMember(out);
+
   if (inheritFieldIds.size) {
     out.subtaskDefaults = {
       inheritParentFields: [...inheritFieldIds],
@@ -262,9 +313,7 @@ async function run() {
   ]);
 }
 
-if (import.meta.url === `file://${process.argv[1]}`) {
-  run().catch((e) => {
-    console.error(e);
-    process.exit(1);
-  });
-}
+run().catch((e) => {
+  console.error(e);
+  process.exit(1);
+});