pm-starter 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 0.1.0 - 2026-05-26
+
+### Other
+
+- Release readiness hardening for pm-starter ([pm-starter-d7yd](https://github.com/unbraind/pm-starter/blob/main/.agents/pm/tasks/pm-starter-d7yd.toon))

package/README.md

@@ -0,0 +1,82 @@
+# pm-starter
+
+Complete scaffold for [pm-cli](https://github.com/unbraind/pm-cli) extensions. Demonstrates all 8 capability types in one file.
+
+Use this as a starting template for building your own extensions.
+
+---
+
+## Installation
+
+```bash
+pm install github.com/unbraind/pm-starter --project
+```
+
+## Capabilities
+
+| # | Capability | What it does |
+|---|---|---|
+| 1 | **Commands** | `pm starter greet` and `pm starter summary` |
+| 2 | **Schema** | Title validation (required, ≤ 200 chars) |
+| 3 | **Hooks** | afterCreate, afterClose, beforeUpdate |
+| 4 | **Importers** | Demo `starter-demo` importer |
+| 5 | **Renderers** | `compact` (TSV) and `markdown-table` renderers |
+| 6 | **Search** | `starter-substring` case-insensitive search |
+| 7 | **Preflight** | `starter-preflight` workspace health check |
+| 8 | **Services** | `starter-health` health check service |
+
+## Commands
+
+### `pm starter greet`
+```bash
+pm starter greet
+pm starter greet --name Developer --emoji 🚀 --uppercase
+```
+
+### `pm starter summary`
+```bash
+pm starter summary
+pm starter summary --verbose
+```
+
+## Creating a New Extension
+
+```bash
+# 1. Clone this repo
+git clone https://github.com/unbraind/pm-starter.git my-extension
+cd my-extension
+
+# 2. Edit files
+#    - manifest.json: update name, description, capabilities
+#    - index.ts: keep only the capabilities you need, implement your logic
+#    - package.json: update name
+
+# 3. Build and test
+npm install
+npm run build
+
+# 4. Install locally
+pm install ./my-extension
+```
+
+## Architecture
+
+Each capability is in its own setup function for clarity:
+- `setupCommands(api)` — Register CLI commands with flags
+- `setupSchema(api)` — Register validation schemas
+- `setupHooks(api)` — Register lifecycle hooks
+- `setupImporters(api)` — Register data importers
+- `setupRenderers(api)` — Register output renderers
+- `setupSearch(api)` — Register search providers
+- `setupPreflight(api)` — Register pre-flight checks
+- `setupServices(api)` — Register background services
+
+Delete the capabilities you don't need and update `manifest.json` accordingly.
+
+## License
+
+MIT
+
+## Release Automation
+
+This package is release-ready for GitHub, npm, and Bun-compatible installs. CI runs type checking, build, production dependency audit, package packing, Bun install verification, and pm-changelog validation. The daily release workflow publishes only when commits exist after the latest release tag and uses pm-changelog to generate CHANGELOG.md and GitHub release notes.

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+declare const _default: {
+    name: string;
+    version: string;
+    activate(api: any): void;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;kBAuRgB,GAAG;;AAJnB,wBAmBG"}

package/dist/index.js

@@ -0,0 +1,258 @@
+// pm-starter — Complete scaffold for pm-cli extensions
+// Demonstrates all capability types. Copy this file to start a new extension.
+//
+// CAPABILITIES OVERVIEW:
+//   1. commands   — Add custom CLI commands
+//   2. schema     — Provide validation schemas
+//   3. hooks      — React to lifecycle events (before/after create, update, close)
+//   4. importers  — Programmatic data import
+//   5. renderers  — Custom output formatting
+//   6. search     — Custom search providers
+//   7. preflight  — Pre-flight checks before commands run
+//   8. services   — Background services and health checks
+//
+// To create a new extension from this scaffold:
+//   1. Copy this directory
+//   2. Update manifest.json name and capabilities
+//   3. Delete capabilities you don't need
+//   4. Implement your logic
+//   5. npm install && npm run build
+//   6. pm install ./your-extension
+const defineExtension = ((extension) => extension);
+// ---------------------------------------------------------------------------
+// CAPABILITY 1: COMMANDS
+// ---------------------------------------------------------------------------
+function setupCommands(api) {
+    // Example: a simple greeting command with flags
+    api.registerCommand({
+        name: "starter greet",
+        description: "A demo greeting command from the starter extension.",
+        intent: "demonstrate command registration",
+        examples: [
+            "pm starter greet",
+            "pm starter greet --name Developer",
+            "pm starter greet --name Dev --emoji 🚀",
+        ],
+        flags: [
+            { long: "--name", value_name: "name", description: "Name to greet (default: World)" },
+            { long: "--emoji", value_name: "emoji", description: "Emoji to include (default: 👋)" },
+            { long: "--uppercase", description: "Uppercase the output" },
+        ],
+        async run(ctx) {
+            const name = ctx.options["name"] || "World";
+            const emoji = ctx.options["emoji"] || "👋";
+            const upper = Boolean(ctx.options["uppercase"]);
+            let msg = `${emoji} Hello, ${name}!`;
+            if (upper)
+                msg = msg.toUpperCase();
+            console.error(msg);
+            return { message: msg };
+        },
+    });
+    // Example: a command that demonstrates pm interaction
+    api.registerCommand({
+        name: "starter summary",
+        description: "Show a quick workspace summary using pm stats.",
+        intent: "demonstrate calling pm from an extension",
+        examples: ["pm starter summary"],
+        flags: [
+            { long: "--verbose", description: "Include detailed breakdown" },
+        ],
+        async run(ctx) {
+            const { spawnSync } = await import("node:child_process");
+            const result = spawnSync("pm", ["--path", ctx.pm_root, "stats", "--json"], {
+                encoding: "utf-8",
+            });
+            if (result.status !== 0) {
+                console.error("Failed to get stats");
+                return { error: "pm stats failed" };
+            }
+            try {
+                const stats = JSON.parse(result.stdout);
+                const total = stats.totals?.items ?? 0;
+                const byStatus = stats.by_status ?? {};
+                console.error(`\n  Workspace Summary`);
+                console.error(`  ================`);
+                console.error(`  Total items: ${total}`);
+                for (const [status, count] of Object.entries(byStatus)) {
+                    if (count > 0) {
+                        console.error(`  ${status}: ${count}`);
+                    }
+                }
+                if (ctx.options["verbose"] && stats.by_type) {
+                    console.error(`\n  By type:`);
+                    for (const [type, count] of Object.entries(stats.by_type)) {
+                        if (count > 0) {
+                            console.error(`    ${type}: ${count}`);
+                        }
+                    }
+                }
+                return stats;
+            }
+            catch {
+                console.error("Could not parse stats output");
+                return { error: "parse failed" };
+            }
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// CAPABILITY 2: SCHEMA
+// ---------------------------------------------------------------------------
+function setupSchema(api) {
+    if (typeof api.registerSchema !== "function")
+        return;
+    api.registerSchema({
+        name: "starter-title-required",
+        description: "Ensures items have a non-empty title",
+        validate(item) {
+            const errors = [];
+            if (!item.title || item.title.trim().length === 0) {
+                errors.push("Title is required");
+            }
+            if (item.title && item.title.length > 200) {
+                errors.push("Title must be ≤ 200 characters");
+            }
+            return { valid: errors.length === 0, errors };
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// CAPABILITY 3: HOOKS
+// ---------------------------------------------------------------------------
+function setupHooks(api) {
+    if (typeof api.registerHook !== "function")
+        return;
+    // Hook: runs after any item is created
+    api.registerHook("afterCreate", (ctx) => {
+        const item = ctx.item;
+        if (item) {
+            console.error(`[starter] ✨ Item created: #${item.id} "${item.title}" (${item.type}/${item.status})`);
+        }
+    });
+    // Hook: runs after any item is closed
+    api.registerHook("afterClose", (ctx) => {
+        const item = ctx.item;
+        if (item) {
+            console.error(`[starter] ✅ Item closed: #${item.id} "${item.title}"`);
+        }
+    });
+    // Hook: runs before an item is updated
+    api.registerHook("beforeUpdate", (ctx) => {
+        // Could validate changes, log, or modify the update
+        // Return false to prevent the update
+    });
+}
+// ---------------------------------------------------------------------------
+// CAPABILITY 4: IMPORTERS
+// ---------------------------------------------------------------------------
+function setupImporters(api) {
+    if (typeof api.registerImporter !== "function")
+        return;
+    api.registerImporter("starter-demo", async (ctx) => {
+        console.error("[starter] Demo importer running with config:", JSON.stringify(ctx.options));
+        // Replace with real import logic:
+        // 1. Read data from ctx.options.file or ctx.options.url
+        // 2. Parse/transform
+        // 3. Call pm create for each item
+    });
+}
+// ---------------------------------------------------------------------------
+// CAPABILITY 5: RENDERERS
+// ---------------------------------------------------------------------------
+function setupRenderers(api) {
+    if (typeof api.registerRenderer !== "function")
+        return;
+    // Override the "json" format to add a compact table view
+    api.registerRenderer("json", (items) => {
+        return items
+            .map((item) => `${item.id}\t${item.type?.padEnd(8)}\t${item.status?.padEnd(12)}\t${item.title}`)
+            .join("\n");
+    });
+    // Override the "toon" format with a markdown table
+    api.registerRenderer("toon", (items) => {
+        const header = "| ID | Type | Status | Title |";
+        const sep = "|---|---|---|---|";
+        const rows = items.map((item) => `| ${item.id} | ${item.type || ""} | ${item.status || ""} | ${item.title} |`);
+        return [header, sep, ...rows].join("\n");
+    });
+}
+// ---------------------------------------------------------------------------
+// CAPABILITY 6: SEARCH
+// ---------------------------------------------------------------------------
+function setupSearch(api) {
+    if (typeof api.registerSearchProvider !== "function")
+        return;
+    // Simple substring search provider
+    api.registerSearchProvider({
+        name: "starter-substring",
+        async query(ctx) {
+            const query = ctx.query ?? "";
+            const { spawnSync } = await import("node:child_process");
+            const result = spawnSync("pm", ["--path", ctx.pm_root ?? ".", "list-all", "--json"], {
+                encoding: "utf-8",
+            });
+            if (result.status !== 0)
+                return { results: [] };
+            const data = JSON.parse(result.stdout);
+            const q = query.toLowerCase();
+            const items = (data.items || []).filter((item) => {
+                const title = (item.title || "").toLowerCase();
+                const desc = (item.description || "").toLowerCase();
+                return title.includes(q) || desc.includes(q);
+            });
+            return { results: items, query };
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// CAPABILITY 7: PREFLIGHT
+// ---------------------------------------------------------------------------
+function setupPreflight(api) {
+    if (typeof api.registerPreflight !== "function")
+        return;
+    // Preflight override — can modify preflight decisions before a command runs
+    api.registerPreflight(async (ctx) => {
+        console.error(`[starter] Preflight check for workspace: ${ctx.pm_root ?? "unknown"}`);
+        // Return the current decision unchanged (pass-through)
+        return {
+            enforce_item_format_gate: ctx.decision?.enforce_item_format_gate ?? true,
+            run_preflight_item_format_sync: ctx.decision?.run_preflight_item_format_sync ?? false,
+            run_extension_migrations: ctx.decision?.run_extension_migrations ?? true,
+            enforce_mandatory_migration_gate: ctx.decision?.enforce_mandatory_migration_gate ?? false,
+        };
+    });
+}
+// ---------------------------------------------------------------------------
+// CAPABILITY 8: SERVICES
+// ---------------------------------------------------------------------------
+function setupServices(api) {
+    if (typeof api.registerService !== "function")
+        return;
+    // Override the output_format service to add custom formatting
+    api.registerService("output_format", async (ctx) => {
+        console.error("[starter] output_format service override active");
+        return { format: "toon" };
+    });
+}
+// ---------------------------------------------------------------------------
+// EXTENSION ENTRY POINT
+// ---------------------------------------------------------------------------
+export default defineExtension({
+    name: "pm-starter",
+    version: "0.1.0",
+    activate(api) {
+        console.error("[pm-starter] Activating...");
+        setupCommands(api);
+        setupSchema(api);
+        setupHooks(api);
+        setupImporters(api);
+        setupRenderers(api);
+        setupSearch(api);
+        setupPreflight(api);
+        setupServices(api);
+        console.error("[pm-starter] All 8 capabilities registered.");
+        console.error("[pm-starter] Commands: pm starter greet, pm starter summary");
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/manifest.json

@@ -0,0 +1,21 @@
+{
+  "name": "pm-starter",
+  "version": "0.1.0",
+  "description": "Complete scaffold showing all 8 capability types: commands, schema, hooks, importers, renderers, preflight, search, services. Use as a starting template for new extensions.",
+  "author": "@unbraind",
+  "entry": "./dist/index.js",
+  "priority": 99,
+  "capabilities": [
+    "commands",
+    "schema",
+    "hooks",
+    "importers",
+    "renderers",
+    "preflight",
+    "search",
+    "services"
+  ],
+  "pm": {
+    "compatibility": "v2"
+  }
+}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "pm-starter",
+  "version": "0.1.0",
+  "description": "Complete starter/scaffold extension for pm-cli showing all capability types",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/unbraind/pm-starter.git"
+  },
+  "bugs": {
+    "url": "https://github.com/unbraind/pm-starter/issues"
+  },
+  "homepage": "https://github.com/unbraind/pm-starter#readme",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/",
+    "manifest.json",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepack": "npm run build",
+    "typecheck": "tsc --noEmit",
+    "check": "npm run typecheck",
+    "audit:prod": "npm audit --omit=dev",
+    "pack:dry-run": "npm pack --dry-run",
+    "changelog": "pm-changelog --pm-root .agents/pm --mode prepend --output CHANGELOG.md --release-version-from-package --since-previous-tag --until-release-tag --item-url-base https://github.com/unbraind/pm-starter/blob/main/.agents/pm",
+    "changelog:full": "pm-changelog --pm-root .agents/pm --mode replace --output CHANGELOG.md --all-release-tags --release-version-from-package --item-url-base https://github.com/unbraind/pm-starter/blob/main/.agents/pm",
+    "changelog:check": "pm-changelog --pm-root .agents/pm --mode replace --output CHANGELOG.md --all-release-tags --release-version-from-package --item-url-base https://github.com/unbraind/pm-starter/blob/main/.agents/pm --check",
+    "release:check": "npm run typecheck && npm run build && npm run audit:prod && npm run pack:dry-run && npm run changelog:check"
+  },
+  "peerDependencies": {
+    "@unbrained/pm-cli": ">=2026.5.24"
+  },
+  "devDependencies": {
+    "@unbrained/pm-cli": "^2026.5.24",
+    "typescript": "^6.0.3",
+    "pm-changelog": "^2026.5.25",
+    "@types/node": "^25.9.1"
+  },
+  "keywords": [
+    "extension",
+    "pm-cli",
+    "pm-extension",
+    "pm-package",
+    "scaffold",
+    "starter",
+    "template"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "author": "@unbraind",
+  "pm": {
+    "aliases": [
+      "starter"
+    ],
+    "extensions": [
+      "."
+    ],
+    "catalog": {
+      "display_name": "Starter Extension",
+      "category": "starter",
+      "summary": "Complete starter/scaffold extension for pm-cli showing all capability types",
+      "tags": [
+        "starter",
+        "sdk",
+        "example"
+      ],
+      "links": {
+        "docs": "https://github.com/unbraind/pm-starter#readme",
+        "npm": "https://www.npmjs.com/package/pm-starter",
+        "repository": "https://github.com/unbraind/pm-starter",
+        "report": "https://github.com/unbraind/pm-starter/issues"
+      }
+    },
+    "docs": [
+      "README.md",
+      "CHANGELOG.md"
+    ],
+    "examples": [
+      "README.md"
+    ]
+  }
+}