pm-skill 1.0.0 → 1.0.2

package/dist/linear.d.ts

@@ -38,6 +38,13 @@ export declare function getIssue(client: LinearClient, identifier: string): Prom
 export declare function getIssueDetail(client: LinearClient, identifier: string): Promise<IssueDetail>;
 export declare function createRelation(client: LinearClient, issueId: string, relatedIssueId: string, type: "blocks" | "related" | "similar"): Promise<void>;
 export declare function createAttachment(client: LinearClient, issueId: string, url: string, title: string, subtitle?: string): Promise<void>;
+export declare function createLabel(client: LinearClient, teamId: string, name: string, opts?: {
+    description?: string;
+    color?: string;
+}): Promise<{
+    id: string;
+    name: string;
+}>;
 export declare function getTeams(client: LinearClient): Promise<Team[]>;
 export declare function getTeamStates(client: LinearClient, teamId: string): Promise<WorkflowState[]>;
 export declare function getTeamLabels(client: LinearClient, teamId: string): Promise<IssueLabel[]>;

package/dist/linear.js

@@ -102,6 +102,20 @@ export async function createAttachment(client, issueId, url, title, subtitle) {
         subtitle,
     });
 }
+// ── Label Creation ──
+export async function createLabel(client, teamId, name, opts) {
+    const payload = await client.createIssueLabel({
+        teamId,
+        name,
+        description: opts?.description,
+        color: opts?.color,
+    });
+    const label = await payload.issueLabel;
+    if (!label) {
+        throw new Error(`Failed to create label '${name}'.`);
+    }
+    return { id: label.id, name: label.name };
+}
 // ── Team / Labels / States ──
 export async function getTeams(client) {
     const conn = await client.teams();

package/dist/workflows.js

@@ -2,7 +2,7 @@
 import minimist from "minimist";
 import { validateEnv, writeEnvFile, GLOBAL_DIR } from "./env.js";
 import { loadConfig, getTemplate, resolvePriority, resolveSeverity, validateDocType, validateLabel, } from "./config.js";
-import { getLinearClient, validateLinearKey, createIssue, getIssue, getIssueDetail, createRelation, createAttachment, getTeams, getTeamStates, getTeamLabels, resolveLabels, } from "./linear.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";
 // ── Init (runs before context — no env/config validation needed) ──
 import { existsSync, copyFileSync, mkdirSync } from "fs";
@@ -115,51 +115,85 @@ async function init(args) {
     console.log(`  - Run 'pm-skill setup' to verify label matching`);
 }
 // ── Commands ──
-async function setup(ctx) {
-    console.log("=== PM Skill Setup ===\n");
+async function setup(ctx, args) {
+    const sync = !!args.sync;
+    console.log(`=== PM Skill Setup${sync ? " (--sync)" : ""} ===\n`);
     // 1. Teams
     const teams = await getTeams(ctx.linear);
-    console.log("📋 Linear 팀 목록:");
+    console.log("📋 Linear teams:");
     for (const team of teams) {
-        const marker = team.id === ctx.env.LINEAR_DEFAULT_TEAM_ID ? " ← 현재 설정" : "";
+        const marker = team.id === ctx.env.LINEAR_DEFAULT_TEAM_ID ? " ← current" : "";
         console.log(`  ${team.key} | ${team.name} | ${team.id}${marker}`);
     }
     // 2. States
     const teamId = ctx.env.LINEAR_DEFAULT_TEAM_ID;
-    console.log(`\n📊 팀 상태 목록 (${teamId}):`);
+    console.log(`\n📊 Workflow states (${teamId}):`);
     const states = await getTeamStates(ctx.linear, teamId);
     for (const state of states) {
         console.log(`  ${state.name} (${state.type}) | ${state.id}`);
     }
     // 3. Labels + matching
-    console.log("\n🏷️  Linear 라벨 목록:");
-    const teamLabels = await getTeamLabels(ctx.linear, teamId);
+    console.log("\n🏷️  Linear labels:");
+    let teamLabels = await getTeamLabels(ctx.linear, teamId);
     for (const label of teamLabels) {
         console.log(`  ${label.name} | ${label.id}`);
     }
-    // 4. Config label matching
-    console.log("\n🔗 Config ↔ Linear 라벨 매칭:");
+    // 4. Config label matching + sync
+    console.log("\n🔗 Config ↔ Linear label matching:");
     const linearLabelMap = new Map(teamLabels.map((l) => [l.name.toLowerCase(), l]));
+    const missingLabels = [];
     for (const configLabel of ctx.config.labels) {
         const match = linearLabelMap.get(configLabel.name.toLowerCase());
         if (match) {
             console.log(`  ✅ ${configLabel.id} (${configLabel.name}) → ${match.id}`);
         }
         else {
-            console.log(`  ⚠️  ${configLabel.id} (${configLabel.name}) → 매칭 없음! Linear에 '${configLabel.name}' 라벨을 생성하세요.`);
+            missingLabels.push(configLabel);
+            console.log(`  ⚠️  ${configLabel.id} (${configLabel.name}) → not found in Linear`);
         }
     }
-    // 5. .env guide
-    console.log("\n📝 .env 설정 안내:");
-    console.log("  LINEAR_API_KEY=<위에서 사용 중인 키>");
-    console.log(`  LINEAR_DEFAULT_TEAM_ID=${teamId}`);
-    if (ctx.env.LINEAR_DEFAULT_PROJECT_ID) {
-        console.log(`  LINEAR_DEFAULT_PROJECT_ID=${ctx.env.LINEAR_DEFAULT_PROJECT_ID}`);
+    // 5. Sync missing labels
+    if (missingLabels.length > 0 && sync) {
+        console.log(`\n🔄 Creating ${missingLabels.length} missing label(s) in Linear...`);
+        for (const configLabel of missingLabels) {
+            const created = await createLabel(ctx.linear, teamId, configLabel.name, {
+                description: configLabel.description,
+                color: configLabel.color,
+            });
+            console.log(`  ✅ Created: ${configLabel.name} → ${created.id}`);
+        }
+        console.log("\nLabels synced successfully.");
+    }
+    else if (missingLabels.length > 0) {
+        console.log(`\n💡 ${missingLabels.length} label(s) missing. Run 'pm-skill setup --sync' to create them.`);
     }
     else {
-        console.log("  LINEAR_DEFAULT_PROJECT_ID=<Linear 프로젝트 ID (선택)>");
+        console.log("\n✅ All config labels matched.");
+    }
+    // 6. Notion connection check
+    console.log("\n📓 Notion:");
+    if (ctx.env.NOTION_API_KEY) {
+        try {
+            const notionInfo = await validateNotionKey(ctx.env.NOTION_API_KEY);
+            console.log(`  ✅ Connected: ${notionInfo.name}`);
+            if (ctx.env.NOTION_ROOT_PAGE_ID) {
+                console.log(`  Root page: ${ctx.env.NOTION_ROOT_PAGE_ID}`);
+            }
+            else {
+                console.log(`  ⚠️  NOTION_ROOT_PAGE_ID not set — page creation will be skipped`);
+            }
+            if (ctx.env.NOTION_BUG_DB_ID) {
+                console.log(`  Bug DB: ${ctx.env.NOTION_BUG_DB_ID}`);
+            }
+        }
+        catch {
+            console.log("  ❌ Notion API key is invalid. Check https://www.notion.so/my-integrations");
+        }
+    }
+    else {
+        console.log("  ⚠️  NOTION_API_KEY not set — Notion features disabled");
+        console.log("  Set it via: pm-skill init --notion-key <key> --global");
     }
-    console.log("\nNotion 설정은 https://www.notion.so/my-integrations 에서 키를 발급하세요.");
 }
 async function startFeature(ctx, args) {
     const title = args._[0];
@@ -337,7 +371,7 @@ async function get(ctx, args) {
 }
 // ── Command Registry ──
 const COMMANDS = {
-    setup: (ctx) => setup(ctx),
+    setup: (ctx, args) => setup(ctx, args),
     "start-feature": startFeature,
     "report-bug": reportBug,
     "add-task": addTask,
@@ -350,9 +384,16 @@ const COMMANDS = {
 async function main() {
     const args = minimist(process.argv.slice(2), {
         string: ["severity", "type", "url", "title", "linear-key", "notion-key", "team-id", "project-id", "notion-page"],
-        boolean: ["global"],
+        boolean: ["global", "sync", "version"],
         alias: { s: "severity", t: "type" },
     });
+    // --version
+    if (args.version) {
+        const { readFileSync } = await import("fs");
+        const pkg = JSON.parse(readFileSync(resolve(PKG_ROOT, "package.json"), "utf-8"));
+        console.log(`pm-skill v${pkg.version}`);
+        return;
+    }
     const command = args._[0];
     args._ = args._.slice(1); // command 제거, 나머지가 positional args
     if (!command || command === "help") {
@@ -363,7 +404,7 @@ Usage: pm-skill <command> [args] [flags]
 Commands:
   init --linear-key K [--notion-key K] [--global]
                                      Initialize config & validate API keys
-  setup                              Verify Linear/Notion connection & show config
+  setup [--sync]                     Verify config & label matching (--sync creates missing labels)
   start-feature <title>              Start feature (Linear issue + Notion PRD)
   report-bug <title> [--severity S]  File bug report (severity: urgent/high/medium/low)
   add-task <parent> <title>          Add sub-task to an issue

package/package.json

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