pm-skill 1.1.1 → 1.1.3

package/dist/linear.d.ts

@@ -34,6 +34,11 @@ export interface IssueDetail {
 }
 export declare function createIssue(client: LinearClient, opts: CreateIssueOpts): Promise<Issue>;
 export declare function updateIssue(client: LinearClient, id: string, input: Record<string, unknown>): Promise<void>;
+export declare function deleteIssue(client: LinearClient, id: string): Promise<void>;
+export declare function getTeamProjects(client: LinearClient, teamId: string): Promise<Array<{
+    id: string;
+    name: string;
+}>>;
 export declare function getIssue(client: LinearClient, identifier: string): Promise<Issue>;
 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>;

package/dist/linear.js

@@ -42,6 +42,14 @@ export async function createIssue(client, opts) {
 export async function updateIssue(client, id, input) {
     await client.updateIssue(id, input);
 }
+export async function deleteIssue(client, id) {
+    await client.deleteIssue(id);
+}
+export async function getTeamProjects(client, teamId) {
+    const team = await client.team(teamId);
+    const conn = await team.projects();
+    return conn.nodes.map((p) => ({ id: p.id, name: p.name }));
+}
 export async function getIssue(client, identifier) {
     try {
         return await client.issue(identifier);

package/dist/notion.d.ts

@@ -32,3 +32,19 @@ export declare function searchPages(client: Client, query: string): Promise<Arra
     id: string;
     title: string;
 }>>;
+/**
+ * Convert markdown to Notion blocks.
+ */
+export declare function mdToBlocks(markdown: string): BlockObjectRequest[];
+/**
+ * Create a Notion page from markdown content.
+ * Handles the 100-block-per-request API limit by chunking.
+ */
+export declare function createPageFromMarkdown(client: Client, parentPageId: string, title: string, markdown: string): Promise<{
+    id: string;
+    url: string;
+}>;
+/**
+ * Clear all blocks from a page, then append new markdown content.
+ */
+export declare function updatePageContent(client: Client, pageId: string, markdown: string): Promise<void>;

package/dist/notion.js

@@ -1,4 +1,5 @@
 import { Client } from "@notionhq/client";
+import { markdownToBlocks } from "@tryfabric/martian";
 // ── Client ──
 let _client = null;
 export function getNotionClient(apiKey) {
@@ -223,3 +224,57 @@ export async function searchPages(client, query) {
             "(untitled)",
     }));
 }
+// ── Markdown Upload ──
+/**
+ * Convert markdown to Notion blocks.
+ */
+export function mdToBlocks(markdown) {
+    return markdownToBlocks(markdown);
+}
+/**
+ * Create a Notion page from markdown content.
+ * Handles the 100-block-per-request API limit by chunking.
+ */
+export async function createPageFromMarkdown(client, parentPageId, title, markdown) {
+    const blocks = mdToBlocks(markdown);
+    // First batch goes with page creation (max 100)
+    const firstBatch = blocks.slice(0, 100);
+    const rest = blocks.slice(100);
+    const response = await client.pages.create({
+        parent: { page_id: parentPageId },
+        properties: {
+            title: { title: [{ text: { content: title } }] },
+        },
+        children: firstBatch,
+    });
+    const pageId = response.id;
+    // Append remaining blocks in chunks of 100
+    for (let i = 0; i < rest.length; i += 100) {
+        await client.blocks.children.append({
+            block_id: pageId,
+            children: rest.slice(i, i + 100),
+        });
+    }
+    return {
+        id: pageId,
+        url: `https://notion.so/${pageId.replace(/-/g, "")}`,
+    };
+}
+/**
+ * Clear all blocks from a page, then append new markdown content.
+ */
+export async function updatePageContent(client, pageId, markdown) {
+    // 1. Delete existing blocks
+    const existing = await client.blocks.children.list({ block_id: pageId });
+    for (const block of existing.results) {
+        await client.blocks.delete({ block_id: block.id });
+    }
+    // 2. Append new blocks
+    const blocks = mdToBlocks(markdown);
+    for (let i = 0; i < blocks.length; i += 100) {
+        await client.blocks.children.append({
+            block_id: pageId,
+            children: blocks.slice(i, i + 100),
+        });
+    }
+}

package/dist/workflows.js

@@ -4,8 +4,8 @@ import { existsSync, copyFileSync, mkdirSync, readFileSync } from "fs";
 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 { getLinearClient, validateLinearKey, createIssue, deleteIssue, getIssue, getIssueDetail, createRelation, createAttachment, createLabel, getTeams, getTeamStates, getTeamLabels, getTeamProjects, resolveLabels, } from "./linear.js";
+import { getNotionClient, createTemplatedPage, createDatabaseEntry, validateNotionKey, searchPages, createPageFromMarkdown, updatePageContent, } from "./notion.js";
 // ── Init ──
 function copyBundledFile(srcName, destPath) {
     if (existsSync(destPath)) {
@@ -69,11 +69,53 @@ 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. Auto-detect project
+    let selectedProjectId = projectId;
+    if (!selectedProjectId) {
+        const projects = await getTeamProjects(client, selectedTeamId);
+        if (projects.length === 0) {
+            console.log("  No projects found — skipping project assignment");
+        }
+        else if (projects.length === 1) {
+            selectedProjectId = projects[0].id;
+            console.log(`  Auto-selected project: "${projects[0].name}"`);
+        }
+        else {
+            console.log(`\n  Available projects (${projects.length}):`);
+            for (const proj of projects) {
+                console.log(`    ${proj.name} | ${proj.id}`);
+            }
+            selectedProjectId = projects[0].id;
+            console.log(`  Using first project: "${projects[0].name}". Override with --project-id <id>`);
+        }
+    }
+    // 4. 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...");
@@ -81,12 +123,12 @@ async function init(args) {
         LINEAR_API_KEY: linearKey,
         LINEAR_DEFAULT_TEAM_ID: selectedTeamId,
     };
-    if (projectId)
-        envEntries.LINEAR_DEFAULT_PROJECT_ID = projectId;
+    if (selectedProjectId)
+        envEntries.LINEAR_DEFAULT_PROJECT_ID = selectedProjectId;
     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
@@ -351,6 +393,76 @@ async function get(ctx, args) {
         }
     }
 }
+async function pushDoc(ctx, args) {
+    const identifier = args._[0];
+    const filePath = args._[1];
+    const content = args.content;
+    const title = args.title;
+    if (!identifier || (!filePath && !content)) {
+        throw new Error("Usage: npx pm-skill push-doc <issue> <file.md> [--title T]\n" +
+            "       npx pm-skill push-doc <issue> --title T --content \"# Markdown...\"");
+    }
+    if (!ctx.notion || !ctx.env.NOTION_ROOT_PAGE_ID) {
+        throw new Error("Notion is not configured. Run 'npx pm-skill init' with --notion-key.");
+    }
+    // Read markdown
+    let markdown;
+    if (filePath) {
+        if (!existsSync(filePath)) {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        markdown = readFileSync(filePath, "utf-8");
+    }
+    else {
+        markdown = content;
+    }
+    // Determine title
+    const docTitle = title ?? (filePath ? filePath.replace(/^.*[\\/]/, "").replace(/\.md$/, "") : "Untitled");
+    // Get Linear issue for linking
+    const issue = await getIssue(ctx.linear, identifier);
+    // Create Notion page
+    const page = await createPageFromMarkdown(ctx.notion, ctx.env.NOTION_ROOT_PAGE_ID, docTitle, markdown);
+    console.log(`[Notion] Page created: "${docTitle}" — ${page.url}`);
+    // Link to Linear issue
+    await createAttachment(ctx.linear, issue.id, page.url, docTitle, "source-of-truth");
+    console.log(`[Link] Attached to ${issue.identifier}`);
+    console.log(`\n✅ Document pushed: ${issue.identifier} | ${page.url}`);
+}
+async function updateDoc(ctx, args) {
+    const pageId = args._[0];
+    const filePath = args._[1];
+    const content = args.content;
+    if (!pageId || (!filePath && !content)) {
+        throw new Error("Usage: npx pm-skill update-doc <page-id> <file.md>\n" +
+            "       npx pm-skill update-doc <page-id> --content \"# Updated...\"");
+    }
+    if (!ctx.notion) {
+        throw new Error("Notion is not configured. Run 'npx pm-skill init' with --notion-key.");
+    }
+    let markdown;
+    if (filePath) {
+        if (!existsSync(filePath)) {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        markdown = readFileSync(filePath, "utf-8");
+    }
+    else {
+        markdown = content;
+    }
+    await updatePageContent(ctx.notion, pageId, markdown);
+    console.log(`✅ Page updated: ${pageId}`);
+}
+async function del(ctx, args) {
+    const identifiers = args._;
+    if (identifiers.length === 0) {
+        throw new Error("Usage: npx pm-skill delete <issue> [issue2 ...]");
+    }
+    for (const identifier of identifiers) {
+        const issue = await getIssue(ctx.linear, identifier);
+        await deleteIssue(ctx.linear, issue.id);
+        console.log(`✅ Deleted: ${issue.identifier} (${issue.title})`);
+    }
+}
 // ── Command Registry ──
 const COMMANDS = {
     setup: (ctx, args) => setup(ctx, args),
@@ -360,12 +472,15 @@ const COMMANDS = {
     relate,
     block,
     "attach-doc": attachDoc,
+    "push-doc": pushDoc,
+    "update-doc": updateDoc,
+    delete: del,
     get,
 };
 // ── Main ──
 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"],
+        string: ["severity", "type", "url", "title", "content", "linear-key", "notion-key", "team-id", "project-id", "notion-page"],
         boolean: ["sync", "version"],
         alias: { s: "severity", t: "type" },
     });
@@ -394,6 +509,14 @@ Commands:
   attach-doc <issue> --url U --title T --type Y
                                      Attach document (type: source-of-truth/issue-tracking/domain-knowledge)
   get <issue>                        Show issue details
+  push-doc <issue> <file.md> [--title T]
+                                     Upload markdown to Notion + link to issue
+  push-doc <issue> --title T --content "# md"
+                                     Push content directly (for AI agents)
+  update-doc <page-id> <file.md>     Replace Notion page content with markdown
+  update-doc <page-id> --content "# md"
+                                     Replace content directly
+  delete <issue> [issue2 ...]        Delete issue(s)
   help                               Show this help
   --version                          Show version
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-skill",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "description": "Structured project management CLI — Linear + Notion integration for AI coding assistants (Claude Code, Codex)",
   "type": "module",
   "bin": {
@@ -48,14 +48,15 @@
   "dependencies": {
     "@linear/sdk": "^80",
     "@notionhq/client": "^5",
+    "@tryfabric/martian": "^1.2.4",
     "js-yaml": "^4",
     "minimist": "^1"
   },
   "devDependencies": {
-    "typescript": "^5",
-    "tsx": "^4",
     "@types/js-yaml": "^4",
     "@types/minimist": "^1",
-    "@types/node": "^22"
+    "@types/node": "^22",
+    "tsx": "^4",
+    "typescript": "^5"
   }
 }