pm-skill 1.1.0 → 1.1.2

package/dist/workflows.js

@@ -5,7 +5,7 @@ import { resolve, dirname } from "path";
 import { validateEnv, writeEnvFile, PKG_ROOT } from "./env.js";
 import { loadConfig, getTemplate, resolvePriority, resolveSeverity, validateDocType, validateLabel, } from "./config.js";
 import { getLinearClient, validateLinearKey, createIssue, getIssue, getIssueDetail, createRelation, createAttachment, createLabel, getTeams, getTeamStates, getTeamLabels, resolveLabels, } from "./linear.js";
-import { getNotionClient, createTemplatedPage, createDatabaseEntry, validateNotionKey, } from "./notion.js";
+import { getNotionClient, createTemplatedPage, createDatabaseEntry, validateNotionKey, searchPages, } from "./notion.js";
 // ── Init ──
 function copyBundledFile(srcName, destPath) {
     if (existsSync(destPath)) {
@@ -69,11 +69,33 @@ async function init(args) {
             throw new Error(`Team '${teamId}' not found. Run 'npx pm-skill init --linear-key <key>' to see available teams.`);
         }
     }
-    // 3. Validate Notion key (optional)
+    // 3. Validate Notion key + auto-detect root page
+    let selectedNotionPage = notionPage;
     if (notionKey) {
         console.log("\n[Notion] Validating API key...");
         const notionUser = await validateNotionKey(notionKey);
         console.log(`  Authenticated as: ${notionUser.name}`);
+        if (!selectedNotionPage) {
+            console.log("  Searching for accessible pages...");
+            const notionClient = getNotionClient(notionKey);
+            const pages = await searchPages(notionClient, "");
+            if (pages.length === 0) {
+                console.log("  ⚠️  No pages shared with this integration.");
+                console.log("  Share a page in Notion: page menu → Connections → add your integration");
+            }
+            else if (pages.length === 1) {
+                selectedNotionPage = pages[0].id;
+                console.log(`  Auto-selected root page: "${pages[0].title}" (${pages[0].id})`);
+            }
+            else {
+                console.log(`\n  Accessible pages (${pages.length}):`);
+                for (const page of pages) {
+                    console.log(`    ${page.title} | ${page.id}`);
+                }
+                selectedNotionPage = pages[0].id;
+                console.log(`  Using first page: "${pages[0].title}". Override with --notion-page <id>`);
+            }
+        }
     }
     // 4. Write .env
     console.log("\n[Config] Writing .env...");
@@ -85,8 +107,8 @@ async function init(args) {
         envEntries.LINEAR_DEFAULT_PROJECT_ID = projectId;
     if (notionKey)
         envEntries.NOTION_API_KEY = notionKey;
-    if (notionPage)
-        envEntries.NOTION_ROOT_PAGE_ID = notionPage;
+    if (selectedNotionPage)
+        envEntries.NOTION_ROOT_PAGE_ID = selectedNotionPage;
     const envPath = writeEnvFile(cwd, envEntries);
     console.log(`  Written: ${envPath}`);
     // 5. Copy config.yml, SKILL.md, AGENTS.md
@@ -192,7 +214,7 @@ async function setup(ctx, args) {
 async function startFeature(ctx, args) {
     const title = args._[0];
     if (!title) {
-        throw new Error("Usage: pm-skill start-feature <title>");
+        throw new Error("Usage: npx pm-skill start-feature <title>");
     }
     const tmpl = getTemplate(ctx.config, "feature");
     const teamLabels = await getTeamLabels(ctx.linear, ctx.env.LINEAR_DEFAULT_TEAM_ID);
@@ -222,7 +244,7 @@ async function startFeature(ctx, args) {
 async function reportBug(ctx, args) {
     const title = args._[0];
     if (!title) {
-        throw new Error("Usage: pm-skill report-bug <title> [--severity high]");
+        throw new Error("Usage: npx pm-skill report-bug <title> [--severity high]");
     }
     const severity = args.severity ?? "medium";
     const priority = resolveSeverity(ctx.config, severity);
@@ -267,7 +289,7 @@ async function addTask(ctx, args) {
     const parentIdentifier = args._[0];
     const title = args._[1];
     if (!parentIdentifier || !title) {
-        throw new Error("Usage: pm-skill add-task <parent-issue> <title>");
+        throw new Error("Usage: npx pm-skill add-task <parent-issue> <title>");
     }
     const parent = await getIssue(ctx.linear, parentIdentifier);
     const child = await createIssue(ctx.linear, {
@@ -282,7 +304,7 @@ async function relate(ctx, args) {
     const id1 = args._[0];
     const id2 = args._[1];
     if (!id1 || !id2) {
-        throw new Error("Usage: pm-skill relate <issue1> <issue2> [--type related]");
+        throw new Error("Usage: npx pm-skill relate <issue1> <issue2> [--type related]");
     }
     const type = args.type ?? "related";
     if (type !== "related" && type !== "similar") {
@@ -297,7 +319,7 @@ async function block(ctx, args) {
     const id1 = args._[0];
     const id2 = args._[1];
     if (!id1 || !id2) {
-        throw new Error("Usage: pm-skill block <blocker> <blocked>");
+        throw new Error("Usage: npx pm-skill block <blocker> <blocked>");
     }
     const issue1 = await getIssue(ctx.linear, id1);
     const issue2 = await getIssue(ctx.linear, id2);
@@ -310,7 +332,7 @@ async function attachDoc(ctx, args) {
     const title = args.title;
     const type = args.type;
     if (!identifier || !url || !title || !type) {
-        throw new Error('Usage: pm-skill attach-doc <issue> --url "URL" --title "Title" --type <type>');
+        throw new Error('Usage: npx pm-skill attach-doc <issue> --url "URL" --title "Title" --type <type>');
     }
     validateDocType(ctx.config, type);
     const issue = await getIssue(ctx.linear, identifier);
@@ -320,7 +342,7 @@ async function attachDoc(ctx, args) {
 async function get(ctx, args) {
     const identifier = args._[0];
     if (!identifier) {
-        throw new Error("Usage: pm-skill get <issue>");
+        throw new Error("Usage: npx pm-skill get <issue>");
     }
     const detail = await getIssueDetail(ctx.linear, identifier);
     const { issue, children, relations, attachments } = detail;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-skill",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Structured project management CLI — Linear + Notion integration for AI coding assistants (Claude Code, Codex)",
   "type": "module",
   "bin": {